gtkdoc-mkhtml.in

   1 #!/bin/sh
   2 #
   3
   4 usage() {
   5 cat <<EOF
   6 gtkdoc-mkhtml version @VERSION@ - generate documentation in html format
   7
   8 --verbose               Print extra output while processing
   9 --path=SEARCH_PATH      Extra source directories
  10 MODULE                  Name of the doc module being parsed
  11 DRIVER_FILE             File containing the toplevel DocBook file.
  12 --version               Print the version of this program
  13 --help                  Print this help
  14 EOF
  15 }
  16
  17 # echo "args $*\n";
  18
  19 # parse options, ignore unknown options for future extensions
  20
  21 verbose="0"
  22 searchpath=
  23 uninstalled=no
  24 while true; do
  25     case "X$1" in
  26         X--version) echo "@VERSION@"; exit 0;;
  27         X--help) usage; exit 0;;
  28         X--uninstalled) uninstalled=yes; shift;;
  29         X--verbose) verbose="1"; shift;;
  30         X--path=*) searchpath=`echo "$1" | sed s/.*=//`; shift;;
  31         X--*) shift;;
  32         X*) break;;
  33     esac
  34 done
  35
  36 if test $# -lt 2; then
  37     usage 1>&2
  38     exit 1
  39 fi
  40
  41 module="$1"
  42 shift
  43 document="$1"
  44 shift
  45
  46 quiet="1"
  47 if test $verbose = "1"; then
  48     quiet="0"
  49 fi
  50
  51 if test $uninstalled = yes; then
  52     # this does not work from buiddir!=srcdir
  53     gtkdocdir=`dirname $0`
  54           # traditional Bourne shells may not support -e here, use -f
  55     if test ! -f $gtkdocdir/gtk-doc.xsl; then
  56         # try to src dir (set from makefiles) too
  57         if test -f $ABS_TOP_SRCDIR/gtk-doc.xsl; then
  58             gtkdocdir=$ABS_TOP_SRCDIR
  59         fi
  60     fi
  61     styledir=$gtkdocdir/style
  62     #echo "uninstalled, gtkdocdir=$gtkdocdir, cwd=$PWD"
  63 else
  64     # the first two are needed to resolve datadir
  65     prefix=@prefix@
  66     datarootdir=@datarootdir@
  67     gtkdocdir=@datadir@/gtk-doc/data
  68     styledir=$gtkdocdir
  69 fi
  70
  71 # we could do "$path_option $PWD "
  72 # to avoid needing rewriting entities that are copied from the header
  73 # into docs under xml
  74 if test "X$searchpath" = "X"; then
  75     path_arg=
  76 else
  77     path_arg="--path $searchpath"
  78 fi
  79
  80 # profiling
  81 profile_args=""
  82 if test "$GTKDOC_PROFILE" != ""; then
  83   profile_args="--profile"
  84 fi
  85
  86 #echo @XSLTPROC@ $path_arg --nonet --xinclude \
  87 #    --stringparam gtkdoc.bookname $module \
  88 #    --stringparam gtkdoc.version "@VERSION@" \
  89 #    "$@" $gtkdocdir/gtk-doc.xsl "$document"
  90 @XSLTPROC@ 2>profile.txt $profile_args $path_arg --nonet --xinclude \
  91     --stringparam gtkdoc.bookname $module \
  92     --stringparam gtkdoc.version "@VERSION@" \
  93     --stringparam chunk.quietly $quiet \
  94     --stringparam chunker.output.quiet $quiet \
  95     "$@" $gtkdocdir/gtk-doc.xsl "$document" || exit $?
  96
  97 # profiling
  98 if test "$GTKDOC_PROFILE" != ""; then
  99   cat profile.txt | gprof2dot.py -e 0.01 -n 0.01 | dot -Tpng -o profile.png
 100 else
 101   rm profile.txt
 102 fi
 103
 104 # copy navigation images and stylesheets to html directory ...
 105 cp -f $styledir/*.png $styledir/*.css ./
 106
 107
 108 echo "timestamp" > ../html.stamp
 109