3 #**********************************************************************
4 # Copyright (C) 2021 - The Geeqie Team
8 # This program is free software; you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation; either version 2 of the License, or
11 # (at your option) any later version.
13 # This program is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
18 # You should have received a copy of the GNU General Public License along
19 # with this program; if not, write to the Free Software Foundation, Inc.,
20 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #**********************************************************************
23 ## @brief Facilitate the integration of the Doxygen html files
24 ## into a code editor.
26 ## doxygen-help.sh <parameter to be searched for>
28 ## The environment variable DOCDIR must be set to point to the
29 ## Doxygen html files location.
31 ## The environment variable PROJECT must be set to the value used
32 ## when creating the Doxygen files.
34 ## Set a hot key in the code editor to call this script with
35 ## the highlighted variable or function name as a parameter.
37 ## The file $DOCDIR/$PROJECT.tag contains an index of all documented
38 ## items and is scanned to locate the relevant html section.
40 ## xdg-open is used to call the html browser to display the document.
42 ## **********************************************************************
44 ## To generate the Doxygen html files set the following
45 ## environment variables:
46 ## DOCDIR (destination folder)
47 ## SRCDIR (must point to the level above the source code)
51 ## Then run 'doxygen doxygen.conf'
54 if [[ -z "${DOCDIR}" ]]
56 echo "Environment variable DOCDIR not set"
57 zenity --title="Geeqie" --width=200 --warning --text="Environment variable DOCDIR not set"
58 elif [[ -z "${PROJECT}" ]]
60 echo "Environment variable PROJECT not set"
61 zenity --title="Geeqie" --width=200 --warning --text="Environment variable PROJECT not set"
63 url_found=$(awk -v search_param="$1" -v docdir="$DOCDIR" '
65 if ($1 == "<name>_"search_param"</name>")
68 n=split($1, anchorfile, /[<>]/)
71 n=split($1, anchor, /[<>]/)
72 struct_result="file://"docdir"/html/" anchorfile[3] "#" anchor[3]
76 if ($1 == "<name>"search_param"</name>")
79 n=split($1, anchorfile, /[<>]/)
82 n=split($1, anchor, /[<>]/)
83 function_result="file://"docdir"/html/" anchorfile[3] "#" anchor[3]
88 if (struct_result != "")
92 else if (function_result != "")
97 ' "$DOCDIR"/"$PROJECT".tag)
99 if [[ -z $url_found ]]
103 xdg-open "$url_found"