doxygen: Added option to compile specific directories

The doc/Doxygen/Allwmake script can now be given directories as
arguments, which will be built instead of the usual src/ and
applications/ directories. This allows testing the documentation of a
limited set of files without building everything.

The outer doc/Allwmake script has also been deleted.
This commit is contained in:
Will Bainbridge
2017-09-20 15:55:01 +01:00
parent 24e336eac7
commit 843d831172
2 changed files with 10 additions and 12 deletions

View File

@ -1,9 +0,0 @@
#!/bin/sh
cd ${0%/*} || exit 1 # Run from this directory
# fix permissions (NB: '+X' and not '+x'!)
chmod a+rX $WM_PROJECT_DIR $WM_PROJECT_DIR/doc Doxygen
Doxygen/Allwmake
#------------------------------------------------------------------------------

View File

@ -13,7 +13,7 @@ usage() {
while [ "$#" -ge 1 ]; do echo "$1"; shift; done
cat<<USAGE
usage: ${0##*/} [OPTION]
usage: ${0##*/} [OPTION] <path-1> <path-2> ...
options:
-online use the links to the Github repositories instead of the local source code
-help
@ -54,9 +54,13 @@ do
defineURL
shift
;;
*)
-*)
usage "unknown option/argument: '$*'"
;;
*)
inputDirs+=("$1")
shift
;;
esac
done
@ -68,9 +72,12 @@ rm -rf latex man
mv html html-stagedRemove$$ 2> /dev/null
rm -rf html-stagedRemove$$ >/dev/null 2>&1 &
# format the input directories
[ ${#inputDirs[@]} -ne 0 ] && inputDirs=("INPUT=" "${inputDirs[@]}")
# ensure that created files are readable by everyone
umask 22
doxygen
( cat Doxyfile ; echo "${inputDirs[@]}" ) | doxygen -
# fix permissions (NB: '+X' and not '+x'!)
chmod -R a+rX html latex man 2>/dev/null