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     #echo "uninstalled, gtkdocdir=$gtkdocdir, cwd=$PWD"
  62 else
  63     # the first two are needed to resolve datadir
  64     prefix=@prefix@
  65     datarootdir=@datarootdir@
  66     gtkdocdir=@datadir@/gtk-doc/data
  67 fi
  68
  69 if head -n 1 $document | grep "<?xml" > /dev/null; then
  70     is_xml=true
  71     path_option='--path'
  72 else
  73     is_xml=false
  74     path_option='--directory'
  75 fi
  76
  77 # we could do "$path_option $PWD "
  78 # to avoid needing rewriting entities that are copied from the header
  79 # into docs under xml
  80 if test "X$searchpath" = "X"; then
  81     path_arg=
  82 else
  83     path_arg="$path_option $searchpath"
  84 fi
  85
  86 # Delete the old index.sgml file, if it exists.
  87 if test -f index.sgml; then
  88   rm -f index.sgml
  89 fi
  90
  91 if $is_xml; then
  92     #echo @XSLTPROC@ $path_arg --nonet --xinclude \
  93     #    --stringparam gtkdoc.bookname $module \
  94     #    --stringparam gtkdoc.version "@VERSION@" \
  95     #    "$@" $gtkdocdir/gtk-doc.xsl $document
  96     @XSLTPROC@ $path_arg --nonet --xinclude \
  97         --stringparam gtkdoc.bookname $module \
  98         --stringparam gtkdoc.version "@VERSION@" \
  99         --stringparam chunk.quietly $quiet \
 100         --stringparam chunker.output.quiet $quiet \
 101         "$@" $gtkdocdir/gtk-doc.xsl $document || exit $?
 102 else
 103     @JADE@ $path_arg -t @SGML_FORMAT_TYPE@ -w no-idref -d $gtkdocdir/gtk-doc.dsl \
 104         -V "gtkdoc-bookname=$module" -V "gtkdoc-version=@VERSION@" \
 105         "$@" $gtkdocdir/gtk-doc.dcl $document || exit $?
 106 fi
 107
 108 # copy navigation images and stylesheets to html directory ...
 109 cp -f $gtkdocdir/*.png ./
 110 cp -f $gtkdocdir/*.css ./
 111
 112
 113 echo "timestamp" > ../html.stamp
 114