|
Packit |
dd8086 |
#!/bin/sh
|
|
Packit |
dd8086 |
# $Id: run_doxygen,v 1.1 2003/11/09 14:11:02 rocky Exp $
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
# Runs doxygen and massages the output files.
|
|
Packit |
dd8086 |
# Copyright (C) 2001, 2002, 2003 Free Software Foundation, Inc.
|
|
Packit |
dd8086 |
#
|
|
Packit |
dd8086 |
# Synopsis: run_doxygen --mode=[user|maint|man] v3srcdir v3builddir
|
|
Packit |
dd8086 |
#
|
|
Packit |
dd8086 |
# Originally hacked together by Phil Edwards <pme@gcc.gnu.org>
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
# We can check now that the version of doxygen is >= this variable.
|
|
Packit |
dd8086 |
DOXYVER=1.2.15
|
|
Packit |
dd8086 |
doxygen=
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
find_doxygen() {
|
|
Packit |
dd8086 |
v_required=`echo $DOXYVER | \
|
|
Packit |
dd8086 |
awk -F. '{if(NF<3)$3=0;print ($1*100+$2)*100+$3}'`
|
|
Packit |
dd8086 |
testing_version=
|
|
Packit |
dd8086 |
# thank you goat book
|
|
Packit |
dd8086 |
set `IFS=:; X="$PATH:/usr/local/bin:/bin:/usr/bin"; echo $X`
|
|
Packit |
dd8086 |
for dir
|
|
Packit |
dd8086 |
do
|
|
Packit |
dd8086 |
# AC_EXEEXT could come in useful here
|
|
Packit |
dd8086 |
maybedoxy="$dir/doxygen"
|
|
Packit |
dd8086 |
test -f "$maybedoxy" && testing_version=`$maybedoxy --version`
|
|
Packit |
dd8086 |
if test -n "$testing_version"; then
|
|
Packit |
dd8086 |
v_found=`echo $testing_version | \
|
|
Packit |
dd8086 |
awk -F. '{if(NF<3)$3=0;print ($1*100+$2)*100+$3}'`
|
|
Packit |
dd8086 |
if test $v_found -ge $v_required; then
|
|
Packit |
dd8086 |
doxygen="$maybedoxy"
|
|
Packit |
dd8086 |
break
|
|
Packit |
dd8086 |
fi
|
|
Packit |
dd8086 |
fi
|
|
Packit |
dd8086 |
done
|
|
Packit |
dd8086 |
if test -z "$doxygen"; then
|
|
Packit |
dd8086 |
echo run_doxygen error: Could not find Doxygen $DOXYVER in path. 1>&2
|
|
Packit |
dd8086 |
print_usage
|
|
Packit |
dd8086 |
fi
|
|
Packit |
dd8086 |
}
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
print_usage() {
|
|
Packit |
dd8086 |
cat 1>&2 <
|
|
Packit |
dd8086 |
Usage: run_doxygen --mode=MODE [<options>] <v3-src-dir> <v3-build-dir>
|
|
Packit |
dd8086 |
MODE is one of:
|
|
Packit |
dd8086 |
user Generate user-level HTML library documentation.
|
|
Packit |
dd8086 |
maint Generate maintainers' HTML documentation (lots more;
|
|
Packit |
dd8086 |
exposes non-public members, etc).
|
|
Packit |
dd8086 |
man Generate user-level man pages.
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
more options when i think of them
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
Note: Requires Doxygen ${DOXYVER} or later; get it at
|
|
Packit |
dd8086 |
ftp://ftp.stack.nl/pub/users/dimitri/doxygen-${DOXYVER}.src.tar.gz
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
EOF
|
|
Packit |
dd8086 |
exit 1
|
|
Packit |
dd8086 |
}
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
parse_options() {
|
|
Packit |
dd8086 |
for o
|
|
Packit |
dd8086 |
do
|
|
Packit |
dd8086 |
# Blatantly ripped from autoconf, er, I mean, "gratefully standing
|
|
Packit |
dd8086 |
# on the shoulders of those giants who have gone before us."
|
|
Packit |
dd8086 |
case "$o" in
|
|
Packit |
dd8086 |
-*=*) arg=`echo "$o" | sed 's/[-_a-zA-Z0-9]*=//'` ;;
|
|
Packit |
dd8086 |
*) arg= ;;
|
|
Packit |
dd8086 |
esac
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
case "$o" in
|
|
Packit |
dd8086 |
--mode=*)
|
|
Packit |
dd8086 |
mode=$arg ;;
|
|
Packit |
dd8086 |
--mode | --help | -h)
|
|
Packit |
dd8086 |
print_usage ;;
|
|
Packit |
dd8086 |
*)
|
|
Packit |
dd8086 |
# this turned out to be a mess, maybe change to --srcdir=, etc
|
|
Packit |
dd8086 |
if test $srcdir = unset; then
|
|
Packit |
dd8086 |
srcdir=$o
|
|
Packit |
dd8086 |
elif test $outdir = unset; then
|
|
Packit |
dd8086 |
builddir=${o}
|
|
Packit |
dd8086 |
outdir=${o}/doc/doxygen
|
|
Packit |
dd8086 |
else
|
|
Packit |
dd8086 |
echo run_doxygen error: Too many arguments 1>&2
|
|
Packit |
dd8086 |
exit 1
|
|
Packit |
dd8086 |
fi
|
|
Packit |
dd8086 |
;;
|
|
Packit |
dd8086 |
esac
|
|
Packit |
dd8086 |
done
|
|
Packit |
dd8086 |
}
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
# script begins here
|
|
Packit |
dd8086 |
mode=unset
|
|
Packit |
dd8086 |
srcdir=unset
|
|
Packit |
dd8086 |
outdir=unset
|
|
Packit |
dd8086 |
do_html=no
|
|
Packit |
dd8086 |
do_man=no
|
|
Packit |
dd8086 |
enabled_sections=
|
|
Packit |
dd8086 |
DATEtext=`date '+%Y-%m-%d'`
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
parse_options $*
|
|
Packit |
dd8086 |
find_doxygen
|
|
Packit |
dd8086 |
$doxygen ./Doxyfile
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
exit 0
|
|
Packit |
dd8086 |
|
|
Packit |
dd8086 |
# vim:ts=4:et:
|