1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
#!/bin/sh
#
usage() {
cat <<EOF
gtkdoc-mkman version @VERSION@ - generate documentation in man format
--verbose Print extra output while processing
--path=SEARCH_PATH Extra source directories
MODULE Name of the doc module being parsed
DRIVER_FILE File containing the toplevel DocBook file.
--version Print the version of this program
--help Print this help
EOF
}
# parse options, ignore unknown options for future extensions
verbose=0
searchpath=
uninstalled=no
while true; do
case "X$1" in
X--version) echo "@VERSION@"; exit 0;;
X--help) usage; exit 0;;
X--uninstalled) uninstalled=yes; shift;;
X--verbose) verbose="1"; shift;;
X--path=*) searchpath=`echo $1 | sed s/.*=//`; shift;;
X--*) shift;;
X*) break;;
esac
done
if test $# -ne 2; then
usage 1>&2
exit 1
fi
module=$1
shift
document=$1
shift
quiet="1"
if test $verbose = "1"; then
quiet="0"
fi
if test $uninstalled = yes; then
# this does not work from buiddir!=srcdir
gtkdocdir=`dirname $0`
#echo "uninstalled, gtkdocdir=$gtkdocdir"
else
# the first two are needed to resolve datadir
prefix=@prefix@
datarootdir=@datarootdir@
gtkdocdir=@datadir@/gtk-doc/data
fi
if head -n 1 $document | grep "<?xml" > /dev/null; then
is_xml=true
path_option='--path'
else
is_xml=false
path_option='--directory'
fi
# we could do "$path_option $PWD "
# to avoid needing rewriting entities that are copied from the header
# into docs under xml
if test "X$searchpath" = "X"; then
path_arg=
else
path_arg="$path_option $searchpath"
fi
# would it make sens to create man pages only for certain refentries
# e.g. for tools
if $is_xml; then
# see http://bugzilla.gnome.org/show_bug.cgi?id=467488
@XSLTPROC@ $path_arg --nonet --xinclude \
--stringparam gtkdoc.bookname $module \
--stringparam gtkdoc.version "@VERSION@" \
--stringparam chunk.quietly $quiet \
--stringparam chunker.output.quiet $quiet \
manpages/docbook.xsl $document || exit $?
else
for i in `cd sgml;ls *.sgml`; do
j=`echo $i | sed 's/.sgml/.man/'`
echo ": converting " $i $j
docbook-to-man sgml/$i > man/$j 2> man/$j.log
done
fi
|
