mirror of
git://gcc.gnu.org/git/gcc.git
synced 2024-12-22 20:49:49 +08:00
669f7a035a
2001-07-11 Phil Edwards <pme@sources.redhat.com> * docs/doxygen/run_doxygen: Don't keep output from previous run. * docs/doxygen/user.cfg.in: Tweaks. * include/bits/c++config: Documentation comments for Doxygen. * include/bits/char_traits.h: Likewise. * include/bits/limits_generic.h: Likewise. * include/bits/std_stdexcept.h: Likewise. * include/bits/stl_pair.h: Likewise. * libsupc++/exception: Likewise. * libsupc++/new: Likewise. * libsupc++/typeinfo: Likewise. * libmath/Makefile.am: Update and correct copyright. From-SVN: r43948
144 lines
3.5 KiB
Bash
144 lines
3.5 KiB
Bash
#!/bin/sh
|
|
|
|
# Runs doxygen. Possibly will massage the output files.
|
|
#
|
|
# Synopsis: run_doxygen --mode=[user|maint] v3srcdir v3builddir
|
|
#
|
|
# Originally hacked together by Phil Edwards <pme@sources.redhat.com>
|
|
# $Id: run_doxygen,v 1.5 2001/06/11 13:04:07 pme Exp $
|
|
|
|
|
|
# We can check now that the version of doxygen is >= this variable.
|
|
DOXYVER=1.2.6
|
|
doxygen=
|
|
|
|
find_doxygen() {
|
|
v_required=`echo $DOXYVER | \
|
|
awk -F. '{if(NF<3)$3=0;print ($1*100+$2)*100+$3}'`
|
|
testing_version=
|
|
# thank you goat book
|
|
set `IFS=:; X="$PATH:/usr/local/bin:/bin:/usr/bin"; echo $X`
|
|
for dir
|
|
do
|
|
# AC_EXEEXT could come in useful here
|
|
maybedoxy="$dir/doxygen"
|
|
test -f "$maybedoxy" && testing_version=`$maybedoxy --version`
|
|
if test -n "$testing_version"; then
|
|
v_found=`echo $testing_version | \
|
|
awk -F. '{if(NF<3)$3=0;print ($1*100+$2)*100+$3}'`
|
|
if test $v_found -ge $v_required; then
|
|
doxygen="$maybedoxy"
|
|
break
|
|
fi
|
|
fi
|
|
done
|
|
if test -z "$doxygen"; then
|
|
echo run_doxygen error: Could not find Doxygen $DOXYVER in path. 1>&2
|
|
print_usage
|
|
fi
|
|
}
|
|
|
|
print_usage() {
|
|
cat 1>&2 <<EOF
|
|
Usage: run_doxygen --mode=MODE [<options>] <src-dir> <output-dir>
|
|
MODE is one of:
|
|
maint Generate maintainers' documentation (lots more;
|
|
exposes non-public members, etc).
|
|
user Generate user-level library documentation.
|
|
|
|
more options when i think of them
|
|
|
|
Note: Requires Doxygen ${DOXYVER} or later; get it at
|
|
ftp://ftp.stack.nl/pub/users/dimitri/doxygen-${DOXYVER}.src.tar.gz
|
|
|
|
EOF
|
|
exit 1
|
|
}
|
|
|
|
parse_options() {
|
|
for o
|
|
do
|
|
# Blatantly ripped from autoconf, er, I mean, "gratefully standing
|
|
# on the shoulders of those giants who have gone before us."
|
|
case "$o" in
|
|
-*=*) arg=`echo "$o" | sed 's/[-_a-zA-Z0-9]*=//'` ;;
|
|
*) arg= ;;
|
|
esac
|
|
|
|
case "$o" in
|
|
--mode=*)
|
|
mode=$arg ;;
|
|
--mode | --help | -h)
|
|
print_usage ;;
|
|
--version | -v)
|
|
# Aw, that's so cuuuute... don't ask, I needed it.
|
|
blank=
|
|
Id=is
|
|
echo You expect this dinky script to track a version? Okay, here
|
|
echo it $Id: run_doxygen,v 1.5 2001/06/11 13:04:07 pme Exp $blank
|
|
exit 0
|
|
;;
|
|
*)
|
|
# this turned out to be a mess, maybe change to --srcdir=, etc
|
|
if test $srcdir = unset; then
|
|
srcdir=$o
|
|
elif test $outdir = unset; then
|
|
outdir=${o}/docs/doxygen
|
|
else
|
|
echo run_doxygen error: Too many arguments 1>&2
|
|
exit 1
|
|
fi
|
|
;;
|
|
esac
|
|
done
|
|
}
|
|
|
|
|
|
# script begins here
|
|
mode=unset
|
|
srcdir=unset
|
|
outdir=unset
|
|
|
|
parse_options $*
|
|
find_doxygen
|
|
|
|
if test $srcdir = unset || test $outdir = unset || test $mode = unset; then
|
|
# this could be better
|
|
echo run_doxygen error: You have not given enough information...! 1>&2
|
|
print_usage
|
|
fi
|
|
|
|
case x"$mode" in
|
|
xuser | xmaint) ;; # ochen khorosho
|
|
*)
|
|
echo run_doxygen error: $mode is an invalid mode 1>&2
|
|
exit 1 ;;
|
|
esac
|
|
|
|
rm -rf $outdir
|
|
mkdir -p $outdir
|
|
chmod u+w $outdir
|
|
(
|
|
set -e
|
|
cd $srcdir
|
|
sed -e "s=@outdir@=${outdir}=" \
|
|
-e "s=@srcdir@=${srcdir}=" \
|
|
docs/doxygen/${mode}.cfg.in > ${outdir}/${mode}.cfg
|
|
echo :: NOTE that this may take some time...
|
|
echo $doxygen ${outdir}/${mode}.cfg
|
|
$doxygen ${outdir}/${mode}.cfg
|
|
echo :: Finished, exit code was $?
|
|
)
|
|
|
|
# mess with output files here?
|
|
|
|
echo ::
|
|
echo :: Doxygen output begins with
|
|
echo :: ${outdir}/html_${mode}/index.html
|
|
echo ::
|
|
|
|
exit 0
|
|
|
|
# vim:ts=4:et:
|
|
|