summaryrefslogtreecommitdiffstats
path: root/admin/doxygen.sh
diff options
context:
space:
mode:
Diffstat (limited to 'admin/doxygen.sh')
m---------admin0
-rw-r--r--admin/doxygen.sh883
2 files changed, 0 insertions, 883 deletions
diff --git a/admin b/admin
new file mode 160000
+Subproject 8c7e0d40de084fe5d54e173918756639e0d4d63
diff --git a/admin/doxygen.sh b/admin/doxygen.sh
deleted file mode 100644
index 3e233d7..0000000
--- a/admin/doxygen.sh
+++ /dev/null
@@ -1,883 +0,0 @@
-#! /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+[^/]*/+\&nbsp;\&nbsp;+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
-
generated by cgit v1.2.1 (git 2.18.0) at 2024-12-20 08:17:16 +0000