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