blob: dce3072101fb14a5017bcf521a90b667b0ed5418 (
plain)
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
|
#!/bin/sh
set -e
usage() {
echo "Usage: run_docs.sh [--nonfatal]"
echo "Generate the manual for gd!"
if [ $# -ne 0 ] ; then
printf 'ERROR: %b\n' "$*"
exit 1
else
exit 0
fi
}
nd() {
# Figure out the name of this tool.
if which naturaldocs 2>/dev/null ; then
return
elif which NaturalDocs 2>/dev/null ; then
return
else
return 1
fi
}
cd "$(dirname "$0")"
if [ $# -eq 1 ] ; then
case $1 in
--nonfatal)
if ! nd >/dev/null ; then
echo "skipping doc generation -- please install naturaldoc!"
exit 0
fi
;;
-h|--help)
usage
;;
*)
usage "unknown option: $1"
;;
esac
elif [ $# -ne 0 ] ; then
usage "unknown options: $*"
fi
# Version number
VERSION=`(cd ../../; perl config/getver.pl)`
# Clear away old docs and ensure the doc dir. is present.
rm -rf html
mkdir html
# Create a lightly-processed copy of the source to use as input. This
# file skips all non-C code in src/ and removes the BGD_DECLARE()
# macro from definitions so they don't show up in the docs.
rm -rf tmp
mkdir tmp
perl nobgd.pl ../../src/ tmp/
# Add the external docs.
echo "Title: License" | cat - ../../COPYING > tmp/license.txt
sed -e "s/@VERSION@/$VERSION/g" preamble.txt > tmp/preamble.txt
# ^^^ hack to get the version number in the docs.
# Run naturaldocs to create the manual.
$(nd) --rebuild --rebuild-output --documented-only \
-i tmp/ \
-img images/ \
-o html html \
--project project/ \
-s Default libgd
# And cleanup the temp files.
rm -rf Data tmp
|
