diff options
Diffstat (limited to 'admin/doxygen.sh')
| -rw-r--r-- | admin/doxygen.sh | 883 |
1 files changed, 883 insertions, 0 deletions
diff --git a/admin/doxygen.sh b/admin/doxygen.sh new file mode 100644 index 0000000..3e233d7 --- /dev/null +++ b/admin/doxygen.sh @@ -0,0 +1,883 @@ +#! /bin/sh +# +# doxygen.sh Copyright (C) 2005 by Adriaan de Groot +# Based on some code from Doxyfile.am, among other things. +# License: GPL version 2. +# See file COPYING in kdelibs for details. + +echo "*** doxygen.sh" + +# Recurse handling is a little complicated, since normally +# subdir (given on the command-line) processing doesn't recurse +# but you can force it to do so. +recurse=1 +recurse_given=NO +use_modulename=1 +cleanup=YES + +while test -n "$1" ; do +case "x$1" in +"x--no-cleanup" ) + cleanup=NO + ;; +"x--no-recurse" ) + recurse=0 + recurse_given=YES + ;; +"x--recurse" ) + recurse=1 + recurse_given=YES + ;; +"x--no-modulename" ) + use_modulename=0 + ;; +"x--modulename" ) + use_modulename=1 + ;; +"x--help" ) + echo "doxygen.sh usage:" + echo "doxygen.sh [--no-recurse] [--no-modulename] <srcdir> [<subdir>]" + exit 2 + ;; +x--doxdatadir=* ) + DOXDATA=`echo $1 | sed -e 's+--doxdatadir=++'` + ;; +x--installdir=*) + PREFIX=`echo $1 | sed -e 's+--installdir=++'` + ;; +x--* ) + echo "Unknown option: $1" + exit 1 + ;; +* ) + top_srcdir="$1" + break + ;; +esac +shift +done + + +### Sanity check the mandatory "top srcdir" argument. +if test -z "$top_srcdir" ; then + echo "Usage: doxygen.sh <top_srcdir>" + exit 1 +fi +if test ! -d "$top_srcdir" ; then + echo "top_srcdir ($top_srcdir) is not a directory." + exit 1 +fi + +### Normalize top_srcdir so it is an absolute path. +if expr "x$top_srcdir" : "x/" > /dev/null ; then + # top_srcdir is absolute already + : +else + top_srcdir=`cd "$top_srcdir" 2> /dev/null && pwd` + if test ! -d "$top_srcdir" ; then + echo "top_srcdir ($top_srcdir) is not a directory." + exit 1 + fi +fi + + + +### Sanity check and guess QTDOCDIR. +if test -z "$QTDOCDIR" ; then + if test -z "$QTDIR" ; then + for i in /usr/X11R6/share/doc/qt/html + do + QTDOCDIR="$i" + test -d "$QTDOCDIR" && break + done + else + for i in share/doc/qt/html doc/html + do + QTDOCDIR="$QTDIR/$i" + test -d "$QTDOCDIR" && break + done + fi +fi +if test -z "$QTDOCDIR" || test ! -d "$QTDOCDIR" ; then + if test -z "$QTDOCDIR" ; then + echo "* QTDOCDIR could not be guessed." + else + echo "* QTDOCDIR does not name a directory." + fi + if test -z "$QTDOCTAG" ; then + echo "* QTDOCDIR set to \"\"" + QTDOCDIR="" + else + echo "* But I'll use $QTDOCDIR anyway because of QTDOCTAG." + fi +fi + +### Get the "top srcdir", also its name, and handle the case that subdir "." +### is given (which would be top_srcdir then, so it's equal to none-given +### but no recursion either). +### +# top_srcdir="$1" # Already set by options processing +module_name=`basename "$top_srcdir"` +subdir="$2" +if test "x." = "x$subdir" ; then + subdir="" + if test "x$recurse_given" = "xNO" ; then + recurse=0 + fi +fi +if test "x" != "x$subdir" ; then + # If no recurse option given explicitly, default to + # no recurse when processing subdirs given on the command-line. + if test "x$recurse_given" = "xNO" ; then + recurse=0 + fi +fi + +if test -z "$DOXDATA" || test ! -d "$DOXDATA" ; then + if test -n "$DOXDATA" ; then + echo "* \$DOXDATA is '$DOXDATA' which does not name a directory" + fi + DOXDATA="$top_srcdir/doc/common" +fi + +if test ! -d "$DOXDATA" ; then + echo "* \$DOXDATA does not name a directory ( or is unset ), tried \"$DOXDATA\"" + exit 1 +fi + +if test -n "$PREFIX" && test ! -d "$PREFIX" ; then + echo "* \$PREFIX does not name a directory, tried \"$PREFIX\"" + echo "* \$PREFIX is disabled." + PREFIX="" +fi + +### We need some values from top-level files, which +### are not preserved between invocations of this +### script, so factor it out for easy use. +create_doxyfile_in() +{ + eval `grep 'VERSION="' "$top_srcdir/admin/cvs.sh"` + echo "PROJECT_NUMBER = $VERSION" > Doxyfile.in + grep '^KDE_INIT_DOXYGEN' "$top_srcdir/configure.in.in" | \ + sed -e 's+[^[]*\[\([^]]*\)+PROJECT_NAME = "\1"+' \ + -e 's+].*++' >> Doxyfile.in +} + +apidoxdir="$module_name"-apidocs +test "x$use_modulename" = "x0" && apidoxdir="apidocs" + +### If we're making the top subdir, create the structure +### for the apidox and initialize it. Otherwise, just use the +### structure assumed to be there. +if test -z "$subdir" ; then + if test ! -d "$apidoxdir" ; then + mkdir "$apidoxdir" > /dev/null 2>&1 + fi + cd "$apidoxdir" > /dev/null 2>&1 || { + echo "Cannot create and cd into $apidoxdir" + exit 1 + } + + test -f "Doxyfile.in" || create_doxyfile_in + + # Copy in logos and the like + for i in "favicon.ico" "kde_gear_64.png" + do + cp "$DOXDATA/$i" . > /dev/null 2> /dev/null + done + for i in "$top_srcdir/doc/api/Dox-"*.png + do + T=`basename "$i" | sed -e 's+Dox-++'` + test -f "$i" && cp "$i" "./$T" > /dev/null 2> /dev/null + done + + top_builddir="." + srcdir="$1" + subdir="." +else + cd "$apidoxdir" > /dev/null 2>&1 || { + echo "Cannot cd into $apidoxdir -- maybe you need to" + echo "build the top-level dox first." + exit 1 + } + + if test "x1" = "x$recurse" ; then + # OK, so --recurse was requested + if test ! -f "subdirs.top" ; then + echo "* No subdirs.top available in the $apidoxdir." + echo "* The --recurse option will be ignored." + recurse=0 + fi + fi +fi + +### Read a single line (TODO: support \ continuations) from the Makefile.am. +### Used to extract variable assignments from it. +extract_line() +{ + file="$2" ; test -z "$file" && file="$srcdir/Makefile.am" + pattern=`echo "$1" | tr + .` + grep "^$1" "$file" | \ + sed -e "s+$pattern.*=\s*++" +} + +### Handle the COMPILE_{FIRST,LAST,BEFORE,AFTER} part of Makefile.am +### in the toplevel. Copied from admin/cvs.sh. Licence presumed LGPL). +create_subdirs() +{ +echo "* Sorting top-level subdirs" +dirs= +idirs= +if test -f "$top_srcdir/inst-apps"; then + idirs=`cat "$top_srcdir/"inst-apps` +else + idirs=`cd "$top_srcdir" && ls -1 | sort` +fi + +compilefirst="" +compilelast="" +if test -f "$top_srcdir/"Makefile.am.in ; then + compilefirst=`sed -ne 's#^COMPILE_FIRST[ ]*=[ ]*##p' "$top_srcdir/"Makefile.am.in | head -n 1` + compilelast=`sed -ne 's#^COMPILE_LAST[ ]*=[ ]*##p' "$top_srcdir/"Makefile.am.in | head -n 1` +fi +for i in $idirs; do + if test -f "$top_srcdir/$i"/Makefile.am; then + case " $compilefirst $compilelast " in + *" $i "*) ;; + *) dirs="$dirs $i" + esac + fi +done + +: > ./_SUBDIRS + +for d in $compilefirst; do + echo $d >> ./_SUBDIRS +done + +(for d in $dirs; do + list="" + if test -f "$top_srcdir/"Makefile.am.in ; then + list=`sed -ne "s#^COMPILE_BEFORE_$d""[ ]*=[ ]*##p" "$top_srcdir/"Makefile.am.in | head -n 1` + fi + for s in $list; do + echo $s $d + done + list="" + if test -f "$top_srcdir/"Makefile.am.in ; then + list=`sed -ne "s#^COMPILE_AFTER_$d""[ ]*=[ ]*##p" "$top_srcdir/"Makefile.am.in | head -n 1` + fi + for s in $list; do + echo $d $s + done + echo $d $d +done ) | tsort >> ./_SUBDIRS + +for d in $compilelast; do + echo $d >> ./_SUBDIRS +done + +test -r _SUBDIRS && mv _SUBDIRS subdirs.top || true +} + + +### Add HTML header, footer, CSS tags to Doxyfile. +### Assumes $subdir is set. Argument is a string +### to stick in front of the file if needed. +apidox_htmlfiles() +{ + dox_header="$top_srcdir/doc/api/$1header.html" + dox_footer="$top_srcdir/doc/api/$1footer.html" + dox_css="$top_srcdir/doc/api/doxygen.css" + test -f "$dox_header" || dox_header="$DOXDATA/$1header.html" + test -f "$dox_footer" || dox_footer="$DOXDATA/$1footer.html" + test -f "$dox_css" || dox_css="$DOXDATA/doxygen.css" + + echo "HTML_HEADER = $dox_header" >> "$subdir/Doxyfile" ; \ + echo "HTML_FOOTER = $dox_footer" >> "$subdir/Doxyfile" ; \ + echo "HTML_STYLESHEET = $dox_css" >> "$subdir/Doxyfile" +} + +apidox_specials() +{ + line=`extract_line DOXYGEN_PROJECTNAME "$1"` + test -n "$line" && echo "PROJECT_NAME = \"$line\"" >> "$2" +} + +apidox_local() +{ + for i in "$top_srcdir/doc/api/Doxyfile.local" + do + if test -f "$i" ; then + cat "$i" >> "$subdir/Doxyfile" + break + fi + done +} + +### Post-process HTML files by substituting in the menu files +# +# In non-top directories, both <!-- menu --> and <!-- gmenu --> +# are calculated and replaced. Top directories get an empty <!-- menu --> +# if any. +doxyndex() +{ + # Special case top-level to have an empty MENU. + if test "x$subdir" = "x." ; then + MENU="" + htmldir="." + htmltop="$top_builddir" # Just ., presumably + echo "* Post-processing top-level files" + else + MENU="<ul>" + htmldir="$subdir/html" + htmltop="$top_builddir.." # top_builddir ends with / + echo "* Post-processing files in $htmldir" + + # Build a little PHP file that maps class names to file + # names, for the quick-class-picker functionality. + # (The quick-class-picker is disabled due to styling + # problems in IE & FF). + ( + echo "<?php \$map = array("; \ + for htmlfile in `find $htmldir/ -type f -name "class[A-Z]*.html" | grep -v "\-members.html$"`; do + classname=`echo $htmlfile | sed -e "s,.*/class\\(.*\\).html,\1," -e "s,_1_1,::,g" -e "s,_01, ,g" -e "s,_4,>,g" -e "s+_00+,+g" -e "s+_3+<+g" | tr "[A-Z]" "[a-z]"` + echo " \"$classname\" => \"$htmlfile\"," + done | sort ; \ + echo ") ?>" + ) > "$subdir/classmap.inc" + + # This is a list of pairs, with / separators so we can use + # basename and dirname (a crude shell hack) to split them + # into parts. For each, if the file part exists (as a html + # file) tack it onto the MENU variable as a <li> with link. + for i in "Main Page/index" \ + "Modules/modules" \ + "Namespace List/namespaces" \ + "Class Hierarchy/hierarchy" \ + "Alphabetical List/classes" \ + "Class List/annotated" \ + "File List/files" \ + "Directories/dirs" \ + "Namespace Members/namespacemembers" \ + "Class Members/functions" \ + "Related Pages/pages" + do + NAME=`dirname "$i"` + FILE=`basename "$i"` + test -f "$htmldir/$FILE.html" && MENU="$MENU<li><a href=\"$FILE.html\">$NAME</a></li>" + done + + MENU="$MENU</ul>" + fi + + + # Get the list of global Menu entries. + GMENU=`cat subdirs | tr -d '\n'` + + PMENU=`grep '<!-- pmenu' "$htmldir/index.html" | sed -e 's+.*pmenu *++' -e 's+ *-->++' | awk '{ c=split($0,a,"/"); for (j=1; j<=c; j++) { printf " / <a href=\""; if (j==c) { printf("."); } for (k=j; k<c; k++) { printf "../"; } if (j<c) { printf("../html/index.html"); } printf "\">%s</a>\n" , a[j]; } }' | tr -d '\n'` + + # Map the PHP file into HTML options so that + # it can be substituted in for the quick-class-picker. + CMENU="" + # For now, leave the CMENU disabled + CMENUBEGIN="<!--" + CMENUEND="-->" + + if test "x$subdir" = "x." ; then + # Disable CMENU on toplevel anyway + CMENUBEGIN="<!--" + CMENUEND="-->" + else + test -f "$subdir/classmap.inc" && \ + CMENU=`grep '=>' "$subdir/classmap.inc" | sed -e 's+"\([^"]*\)" => "'"$subdir/html/"'\([^"]*\)"+<option value="\2">\1<\/option>+' | tr -d '\n'` + + if test -f "$subdir/classmap.inc" && grep "=>" "$subdir/classmap.inc" > /dev/null 2>&1 ; then + # Keep the menu, it's useful + : + else + CMENUBEGIN="<!--" + CMENUEND="-->" + fi + fi + + # Now substitute in the MENU in every file. This depends + # on HTML_HEADER (ie. header.html) containing the + # <!-- menu --> comment. + for i in "$htmldir"/*.html + do + if test -f "$i" ; then + sed -e "s+<!-- menu -->+$MENU+" \ + -e "s+<!-- gmenu -->+$GMENU+" \ + -e "s+<!-- pmenu.*-->+$PMENU+" \ + -e "s+<!-- cmenu.begin -->+$CMENUBEGIN+" \ + -e "s+<!-- cmenu.end -->+$CMENUEND+" \ + < "$i" | sed -e "s+@topdir@+$htmltop+g" > "$i.new" && mv "$i.new" "$i" + sed -e "s+<!-- cmenu -->+$CMENU+" < "$i" > "$i.new" + test -s "$i.new" && mv "$i.new" "$i" + fi + done +} + + + + + + +### Handle the Doxygen processing of a toplevel directory. +apidox_toplevel() +{ + echo "" + echo "*** Creating API documentation main page for $module_name" + echo "*" + rm -f "Doxyfile" + for i in "$top_srcdir/doc/api/Doxyfile.global" \ + "$top_srcdir/admin/Doxyfile.global" \ + "$DOXDATA/Doxyfile.global" + do + if test -f "$i" ; then + cp "$i" Doxyfile + break + fi + done + + if test ! -f "Doxyfile" ; then + echo "* Cannot create Doxyfile." + exit 1 + fi + + cat "$top_builddir/Doxyfile.in" >> Doxyfile + + + echo "INPUT = $top_srcdir" >> Doxyfile + echo "OUTPUT_DIRECTORY = $top_builddir" >> Doxyfile ; \ + echo "FILE_PATTERNS = *.dox" >> Doxyfile ; \ + echo "RECURSIVE = NO" >> Doxyfile ; \ + echo "ALPHABETICAL_INDEX = NO" >> Doxyfile ; \ + echo "HTML_OUTPUT = ." >> Doxyfile ; \ + apidox_htmlfiles "main" + + # KDevelop has a top-level Makefile.am with settings. + for i in "$top_srcdir/Makefile.am.in" "$top_srcdir/Makefile.am" + do + if test -f "$i" ; then + grep '^DOXYGEN_SET_' "$i" | \ + sed -e 's+DOXYGEN_SET_++' -e "s+@topdir@+$top_srcdir+" >> Doxyfile + apidox_specials "$srcdir/Makefile.am" "$subdir/Doxyfile" + + break + fi + done + + apidox_local + + doxygen Doxyfile + + ( cd "$top_srcdir" && grep -l '^include.*Doxyfile.am' `find . -name Makefile.am` ) | sed -e 's+/Makefile.am$++' -e 's+^\./++' | sort > subdirs.in + for i in `cat subdirs.in` + do + test "x." = "x$i" && continue; + + dir=`dirname "$i"` + file=`basename "$i"` + if test "x." = "x$dir" ; then + dir="" + else + dir="$dir/" + fi + indent=`echo "$dir" | sed -e 's+[^/]*/+\ \ +g' | sed -e 's+&+\\\&+g'` + entryname=`extract_line DOXYGEN_SET_PROJECT_NAME "$top_srcdir/$dir/$file/Makefile.am"` + test -z "$entryname" && entryname="$file" + + if grep DOXYGEN_EMPTY "$top_srcdir/$dir/$file/Makefile.am" > /dev/null 2>&1 ; then + echo "<li>$indent$file</li>" + else + echo "<li>$indent<a href=\"@topdir@/$dir$file/html/index.html\">$entryname</a></li>" + fi + done > subdirs + + doxyndex +} + +### Handle the Doxygen processing of a non-toplevel directory. +apidox_subdir() +{ + echo "" + echo "*** Creating apidox in $subdir" + echo "*" + rm -f "$subdir/Doxyfile" + if test ! -d "$top_srcdir/$subdir" ; then + echo "* No source (sub)directory $subdir" + return + fi + for i in "$top_srcdir/doc/api/Doxyfile.global" \ + "$top_srcdir/admin/Doxyfile.global" \ + "$DOXDATA/Doxyfile.global" + do + if test -f "$i" ; then + cp "$i" "$subdir/Doxyfile" + break + fi + done + + + test -f "Doxyfile.in" || create_doxyfile_in + cat "Doxyfile.in" >> "$subdir/Doxyfile" + + echo "PROJECT_NAME = \"$subdir\"" >> "$subdir/Doxyfile" + echo "INPUT = $srcdir" >> "$subdir/Doxyfile" + echo "OUTPUT_DIRECTORY = ." >> "$subdir/Doxyfile" + if grep -l "$subdir/" subdirs.in > /dev/null 2>&1 ; then + echo "RECURSIVE = NO" >> "$subdir/Doxyfile" + fi + echo "HTML_OUTPUT = $subdir/html" >> "$subdir/Doxyfile" + echo "GENERATE_TAGFILE = $subdir/$subdirname.tag" >> "$subdir/Doxyfile" + test -d "$top_srcdir/doc/api" && \ + echo "IMAGE_PATH = $top_srcdir/doc/api" >> "$subdir/Doxyfile" + + apidox_htmlfiles "" + + # Makefile.ams may contain overrides to our settings, + # so copy them in. + grep '^DOXYGEN_SET_' "$srcdir/Makefile.am" | \ + sed -e 's+DOXYGEN_SET_++' >> "$subdir/Doxyfile" + apidox_specials "$srcdir/Makefile.am" "$subdir/Doxyfile" + + excludes=`extract_line DOXYGEN_EXCLUDE` + if test -n "$excludes"; then + patterns="" + dirs="" + for item in `echo "$excludes"`; do + if test -d "$top_srcdir/$subdir/$item"; then + dirs="$dirs $top_srcdir/$subdir/$item/" + else + patterns="$patterns $item" + fi + done + echo "EXCLUDE_PATTERNS += $patterns" >> "$subdir/Doxyfile" + echo "EXCLUDE += $dirs" >> "$subdir/Doxyfile" + fi + + echo "TAGFILES = \\" >> "$subdir/Doxyfile" + ## For now, don't support \ continued references lines + tags=`extract_line DOXYGEN_REFERENCES` + for i in $tags qt ; do + tagsubdir=`dirname $i` ; tag=`basename $i` + tagpath="" + not_found="" + + if test "x$tagsubdir" = "x." ; then + tagsubdir="" + else + tagsubdir="$tagsubdir/" + fi + + # Find location of tag file + if test -f "$tagsubdir$tag/$tag.tag" ; then + file="$tagsubdir$tag/$tag.tag" + loc="$tagsubdir$tag/html" + else + # This checks for dox built with_out_ --no-modulename + # in the same build dir as this dox run was started in. + file=`ls -1 ../*-apidocs/"$tagsubdir$tag/$tag.tag" 2> /dev/null` + + if test -n "$file" ; then + loc=`echo "$file" | sed -e "s/$tag.tag\$/html/"` + else + # If the tag file doesn't exist yet, but should + # because we have the right dirs here, queue + # this directory for re-processing later. + if test -d "$top_srcdir/$tagsubdir$tag" ; then + echo "* Need to re-process $subdir for tag $i" + echo "$subdir" >> "subdirs.later" + else + # Re-check in $PREFIX if needed. + test -n "$PREFIX" && \ + file=`cd "$PREFIX" && \ + ls -1 *-apidocs/"$tagsubdir$tag/$tag.tag" 2> /dev/null` + + # If something is found, patch it up. The location must be + # relative to the installed location of the dox and the + # file must be absolute. + if test -n "$file" ; then + loc=`echo "../$file" | sed -e "s/$tag.tag\$/html/"` + file="$PREFIX/$file" + echo "* Tags for $tagsubdir$tag will only work when installed." + not_found="YES" + fi + fi + fi + fi + if test "$tag" = "qt" ; then + if test -z "$QTDOCDIR" ; then + echo " $file" >> "$subdir/Doxyfile" + else + if test -z "$file" ; then + # Really no Qt tags + echo "" >> "$subdir/Doxyfile" + else + echo " $file=$QTDOCDIR" >> "$subdir/Doxyfile" + fi + fi + else + if test -n "$file" ; then + test -z "$not_found" && echo "* Found tag $file" + echo " $file=../$top_builddir$loc \\" >> "$subdir/Doxyfile" + fi + fi + done + + apidox_local + + if grep '^DOXYGEN_EMPTY' "$srcdir/Makefile.am" > /dev/null 2>&1 ; then + # This directory is empty, so don't process it, but + # *do* handle subdirs that might have dox. + : + else + # Regular processing + doxygen "$subdir/Doxyfile" + doxyndex + fi +} + +### Run a given subdir by setting up global variables first. +do_subdir() +{ + subdir=`echo "$1" | sed -e 's+/$++'` + srcdir="$top_srcdir/$subdir" + subdirname=`basename "$subdir"` + mkdir -p "$subdir" 2> /dev/null + if test ! -d "$subdir" ; then + echo "Can't create dox subdirectory $subdir" + return + fi + top_builddir=`echo "/$subdir" | sed -e 's+/[^/]*+../+g'` + apidox_subdir +} + + +### Create installdox-slow in the toplevel +create_installdox() +{ +# Fix up the installdox script so it accepts empty args +# +# This code is copied from the installdox generated by Doxygen, +# copyright by Dimitri van Heesch and released under the GPL. +# This does a _slow_ update of the dox, because it loops +# over the given substitutions instead of assuming all the +# needed ones are given. +# +cat <<\EOF +#! /usr/bin/env perl + +%subst = () ; +$quiet = 0; + +if (open(F,"search.cfg")) +{ + $_=<F> ; s/[ \t\n]*$//g ; $subst{"_doc"} = $_; + $_=<F> ; s/[ \t\n]*$//g ; $subst{"_cgi"} = $_; +} + +while ( @ARGV ) { + $_ = shift @ARGV; + if ( s/^-// ) { + if ( /^l(.*)/ ) { + $v = ($1 eq "") ? shift @ARGV : $1; + ($v =~ /\/$/) || ($v .= "/"); + $_ = $v; + if ( /(.+)\@(.+)/ ) { + $subst{$1} = $2; + } else { + print STDERR "Argument $_ is invalid for option -l\n"; + &usage(); + } + } + elsif ( /^q/ ) { + $quiet = 1; + } + elsif ( /^\?|^h/ ) { + &usage(); + } + else { + print STDERR "Illegal option -$_\n"; + &usage(); + } + } + else { + push (@files, $_ ); + } +} + + +if ( ! @files ) { + if (opendir(D,".")) { + foreach $file ( readdir(D) ) { + $match = ".html"; + next if ( $file =~ /^\.\.?$/ ); + ($file =~ /$match/) && (push @files, $file); + ($file =~ "tree.js") && (push @files, $file); + } + closedir(D); + } +} + +if ( ! @files ) { + print STDERR "Warning: No input files given and none found!\n"; +} + +foreach $f (@files) +{ + if ( ! $quiet ) { + print "Editing: $f...\n"; + } + $oldf = $f; + $f .= ".bak"; + unless (rename $oldf,$f) { + print STDERR "Error: cannot rename file $oldf\n"; + exit 1; + } + if (open(F,"<$f")) { + unless (open(G,">$oldf")) { + print STDERR "Error: opening file $oldf for writing\n"; + exit 1; + } + if ($oldf ne "tree.js") { + while (<F>) { + foreach $sub (keys %subst) { + s/doxygen\=\"$sub\:([^ \"\t\>\<]*)\" (href|src)=\"\1/doxygen\=\"$sub:$subst{$sub}\" \2=\"$subst{$sub}/g; + print G "$_"; + } + } + } + else { + while (<F>) { + foreach $sub (keys %subst) { + s/\"$sub\:([^ \"\t\>\<]*)\", \"\1/\"$sub:$subst{$sub}\" ,\"$subst{$sub}/g; + print G "$_"; + } + } + } + } + else { + print STDERR "Warning file $f does not exist\n"; + } + unlink $f; +} + +sub usage { + print STDERR "Usage: installdox [options] [html-file [html-file ...]]\n"; + print STDERR "Options:\n"; + print STDERR " -l tagfile\@linkName tag file + URL or directory \n"; + print STDERR " -q Quiet mode\n\n"; + exit 1; +} +EOF +} + +# Do only the subdirs that match the RE passed in as $1 +do_subdirs_re() +{ + RE=`echo "$1" | sed -e 's+/$++'` + + # Here's a queue of dirs to re-process later when + # all the rest have been done already. + > subdirs.later + + # subdirs.top lists _all_ subdirs of top in the order they + # should be handled; subdirs.in lists those dirs that contain + # dox. So the intersection of the two is the ordered list + # of top-level subdirs that contain dox. + # + # subdirs.top also doesn't contain ".", so that special + # case can be ignored in the loop. + + + ( + for i in `grep "^$RE" subdirs.top` + do + if test "x$i" = "x." ; then + continue + fi + # Calculate intersection of this element and the + # set of dox dirs. + if grep "^$i\$" subdirs.in > /dev/null 2>&1 ; then + echo "$i" + mkdir -p "$i" 2> /dev/null + + # Handle the subdirs of this one + for j in `grep "$i/" subdirs.in` + do + echo "$j" + mkdir -p "$j" 2> /dev/null + done + fi + done + + # Now we still need to handle whatever is left + for i in `cat subdirs.in` + do + test -d "$i" || echo "$i" + mkdir -p "$i" 2> /dev/null + done + ) > subdirs.sort + for i in `cat subdirs.sort` + do + do_subdir "$i" + done + + if test -s "subdirs.later" ; then + sort subdirs.later | uniq > subdirs.sort + for i in `cat subdirs.sort` + do + : > subdirs.later + echo "*** Reprocessing $i" + do_subdir "$i" + test -s "subdirs.later" && echo "* Some tag files were still not found." + done + fi +} + +if test "x." = "x$top_builddir" ; then + apidox_toplevel + create_subdirs + create_installdox > installdox-slow + if test "x$recurse" = "x1" ; then + if test "x$module_name" = "xkdelibs" ; then + if test -z "$QTDOCTAG" && test -d "$QTDOCDIR" && \ + test ! -f "qt/qt.tag" ; then + # Special case: create a qt tag file. + echo "*** Creating a tag file for the Qt library:" + mkdir qt + doxytag -t qt/qt.tag "$QTDOCDIR" > /dev/null 2>&1 + fi + fi + if test -n "$QTDOCTAG" && test -r "$QTDOCTAG" ; then + echo "*** Copying tag file for the Qt library:" + mkdir qt + cp "$QTDOCTAG" qt/qt.tag + fi + + do_subdirs_re "." + + fi +else + if test "x$recurse" = "x1" ; then + do_subdirs_re "$subdir" + else + do_subdir "$subdir" + fi +fi + + +# At the end of a run, clean up stuff. +if test "YES" = "$cleanup" ; then + rm -f subdirs.in subdirs.later subdirs.sort subdirs.top Doxyfile.in + rm -f `find . -name Doxyfile` + rm -f qt/qt.tag + rmdir qt > /dev/null 2>&1 +fi + + +exit 0 + |