Update gnulib files.
[gnutls:gnutls.git] / build-aux / gendocs.sh
1 #!/bin/sh
2 # gendocs.sh -- generate a GNU manual in many formats.  This script is
3 #   mentioned in maintain.texi.  See the help message below for usage details.
4
5 scriptversion=2008-01-13.10
6
7 # Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008
8 # Free Software Foundation, Inc.
9 #
10 # This program is free software; you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation; either version 3 of the License,
13 # or (at your option) any later version.
14 #
15 # This program is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 # GNU General Public License for more details.
19 #
20 # You should have received a copy of the GNU General Public License
21 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
22
23 # Original author: Mohit Agarwal.
24 # Send bug reports and any other correspondence to bug-texinfo@gnu.org.
25
26 prog=`basename "$0"`
27 srcdir=`pwd`
28
29 scripturl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs.sh"
30 templateurl="http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/texinfo/texinfo/util/gendocs_template"
31
32 : ${SETLANG="env LANG= LC_MESSAGES= LC_ALL= LANGUAGE="}
33 : ${MAKEINFO="makeinfo"}
34 : ${TEXI2DVI="texi2dvi -t @finalout"}
35 : ${DVIPS="dvips"}
36 : ${DOCBOOK2HTML="docbook2html"}
37 : ${DOCBOOK2PDF="docbook2pdf"}
38 : ${DOCBOOK2PS="docbook2ps"}
39 : ${DOCBOOK2TXT="docbook2txt"}
40 : ${GENDOCS_TEMPLATE_DIR="."}
41 : ${TEXI2HTML="texi2html"}
42 unset CDPATH
43 unset use_texi2html
44
45 version="gendocs.sh $scriptversion
46
47 Copyright (C) 2007 Free Software Foundation, Inc.
48 There is NO warranty.  You may redistribute this software
49 under the terms of the GNU General Public License.
50 For more information about these matters, see the files named COPYING."
51
52 usage="Usage: $prog [OPTION]... PACKAGE MANUAL-TITLE
53
54 Generate various output formats from PACKAGE.texinfo (or .texi or .txi) source.
55 See the GNU Maintainers document for a more extensive discussion:
56   http://www.gnu.org/prep/maintain_toc.html
57
58 Options:
59   -o OUTDIR   write files into OUTDIR, instead of manual/.
60   --docbook   convert to DocBook too (xml, txt, html, pdf and ps).
61   --html ARG  pass indicated ARG to makeinfo or texi2html for HTML targets.
62   --texi2html use texi2html to generate HTML targets.
63   --help      display this help and exit successfully.
64   --version   display version information and exit successfully.
65
66 Simple example: $prog emacs \"GNU Emacs Manual\"
67
68 Typical sequence:
69   cd YOURPACKAGESOURCE/doc
70   wget \"$scripturl\"
71   wget \"$templateurl\"
72   $prog YOURMANUAL \"GNU YOURMANUAL - One-line description\"
73
74 Output will be in a new subdirectory \"manual\" (by default, use -o OUTDIR
75 to override).  Move all the new files into your web CVS tree, as
76 explained in the Web Pages node of maintain.texi.
77
78 MANUAL-TITLE is included as part of the HTML <title> of the overall
79 manual/index.html file.  It should include the name of the package being
80 documented.  manual/index.html is created by substitution from the file
81 $GENDOCS_TEMPLATE_DIR/gendocs_template.  (Feel free to modify the
82 generic template for your own purposes.)
83
84 If you have several manuals, you'll need to run this script several
85 times with different YOURMANUAL values, specifying a different output
86 directory with -o each time.  Then write (by hand) an overall index.html
87 with links to them all.
88
89 If a manual's texinfo sources are spread across several directories,
90 first copy or symlink all Texinfo sources into a single directory.
91 (Part of the script's work is to make a tar.gz of the sources.)
92
93 You can set the environment variables MAKEINFO, TEXI2DVI, and DVIPS to
94 control the programs that get executed, and GENDOCS_TEMPLATE_DIR to
95 control where the gendocs_template file is looked for.  (With --docbook,
96 the environment variables DOCBOOK2HTML, DOCBOOK2PDF, DOCBOOK2PS, and
97 DOCBOOK2TXT are also respected.) 
98
99 By default, makeinfo is run in the default (English) locale, since
100 that's the language of most Texinfo manuals.  If you happen to have a
101 non-English manual and non-English web site, check the SETLANG setting
102 in the source.
103
104 Email bug reports or enhancement requests to bug-texinfo@gnu.org.
105 "
106
107 calcsize()
108 {
109   size=`ls -ksl $1 | awk '{print $1}'`
110   echo $size
111 }
112
113 outdir=manual
114 html=
115 PACKAGE=
116 MANUAL_TITLE=
117
118 while test $# -gt 0; do
119   case $1 in
120     --help) echo "$usage"; exit 0;;
121     --version) echo "$version"; exit 0;;
122     -o) shift; outdir=$1;;
123     --docbook) docbook=yes;;
124     --html) shift; html=$1;;
125     --texi2html) use_texi2html=1
126                  html="$html --node-files";;
127     -*)
128       echo "$0: Unknown or ambiguous option \`$1'." >&2
129       echo "$0: Try \`--help' for more information." >&2
130       exit 1;;
131     *)
132       if test -z "$PACKAGE"; then
133         PACKAGE=$1
134       elif test -z "$MANUAL_TITLE"; then
135         MANUAL_TITLE=$1
136       else
137         echo "$0: extra non-option argument \`$1'." >&2
138         exit 1
139       fi;;
140   esac
141   shift
142 done
143
144 if test -s "$srcdir/$PACKAGE.texinfo"; then
145   srcfile=$srcdir/$PACKAGE.texinfo
146 elif test -s "$srcdir/$PACKAGE.texi"; then
147   srcfile=$srcdir/$PACKAGE.texi
148 elif test -s "$srcdir/$PACKAGE.txi"; then
149   srcfile=$srcdir/$PACKAGE.txi
150 else
151   echo "$0: cannot find .texinfo or .texi or .txi for $PACKAGE in $srcdir." >&2
152   exit 1
153 fi
154
155 if test ! -r $GENDOCS_TEMPLATE_DIR/gendocs_template; then
156   echo "$0: cannot read $GENDOCS_TEMPLATE_DIR/gendocs_template." >&2
157   echo "$0: it is available from $templateurl." >&2
158   exit 1
159 fi
160
161 echo Generating output formats for $srcfile
162
163 cmd="$SETLANG $MAKEINFO -o $PACKAGE.info \"$srcfile\""
164 echo "Generating info files... ($cmd)"
165 eval "$cmd"
166 mkdir -p $outdir/
167 tar czf $outdir/$PACKAGE.info.tar.gz $PACKAGE.info*
168 info_tgz_size=`calcsize $outdir/$PACKAGE.info.tar.gz`
169 # do not mv the info files, there's no point in having them available
170 # separately on the web.
171
172 cmd="${TEXI2DVI} \"$srcfile\""
173 echo "Generating dvi ... ($cmd)"
174 eval "$cmd"
175
176 # now, before we compress dvi:
177 echo Generating postscript...
178 ${DVIPS} $PACKAGE -o
179 gzip -f -9 $PACKAGE.ps
180 ps_gz_size=`calcsize $PACKAGE.ps.gz`
181 mv $PACKAGE.ps.gz $outdir/
182
183 # compress/finish dvi:
184 gzip -f -9 $PACKAGE.dvi
185 dvi_gz_size=`calcsize $PACKAGE.dvi.gz`
186 mv $PACKAGE.dvi.gz $outdir/
187
188 cmd="${TEXI2DVI} --pdf \"$srcfile\""
189 echo "Generating pdf ... ($cmd)"
190 eval "$cmd"
191 pdf_size=`calcsize $PACKAGE.pdf`
192 mv $PACKAGE.pdf $outdir/
193
194 cmd="$SETLANG $MAKEINFO -o $PACKAGE.txt --no-split --no-headers \"$srcfile\""
195 echo "Generating ASCII... ($cmd)"
196 eval "$cmd"
197 ascii_size=`calcsize $PACKAGE.txt`
198 gzip -f -9 -c $PACKAGE.txt >$outdir/$PACKAGE.txt.gz
199 ascii_gz_size=`calcsize $outdir/$PACKAGE.txt.gz`
200 mv $PACKAGE.txt $outdir/
201
202 html_split() {
203   cmd="$SETLANG $TEXI2HTML --output $PACKAGE.html --split=$1 $html \"$srcfile\""
204   echo "Generating html by $1... ($cmd)"
205   eval "$cmd"
206   split_html_dir=$PACKAGE.html
207   (
208     cd ${split_html_dir} || exit 1
209     ln -sf ${PACKAGE}.html index.html
210     tar -czf ../$outdir/${PACKAGE}.html_$1.tar.gz -- *.html
211   )
212   eval html_$1_tgz_size=`calcsize $outdir/${PACKAGE}.html_$1.tar.gz`
213   rm -f $outdir/html_$1/*.html
214   mkdir -p $outdir/html_$1/
215   mv ${split_html_dir}/*.html $outdir/html_$1/
216   rmdir ${split_html_dir}
217 }
218
219 if test -z "$use_texi2html"; then
220   cmd="$SETLANG $MAKEINFO --no-split --html -o $PACKAGE.html $html \"$srcfile\""
221   echo "Generating monolithic html... ($cmd)"
222   rm -rf $PACKAGE.html  # in case a directory is left over
223   eval "$cmd"
224   html_mono_size=`calcsize $PACKAGE.html`
225   gzip -f -9 -c $PACKAGE.html >$outdir/$PACKAGE.html.gz
226   html_mono_gz_size=`calcsize $outdir/$PACKAGE.html.gz`
227   mv $PACKAGE.html $outdir/
228
229   cmd="$SETLANG $MAKEINFO --html -o $PACKAGE.html $html \"$srcfile\""
230   echo "Generating html by node... ($cmd)"
231   eval "$cmd"
232   split_html_dir=$PACKAGE.html
233   (
234    cd ${split_html_dir} || exit 1
235    tar -czf ../$outdir/${PACKAGE}.html_node.tar.gz -- *.html
236   )
237   html_node_tgz_size=`calcsize $outdir/${PACKAGE}.html_node.tar.gz` 
238   rm -f $outdir/html_node/*.html
239   mkdir -p $outdir/html_node/
240   mv ${split_html_dir}/*.html $outdir/html_node/
241   rmdir ${split_html_dir}
242 else
243   cmd="$SETLANG $TEXI2HTML --output $PACKAGE.html $html \"$srcfile\"" 
244   echo "Generating monolithic html... ($cmd)"
245   rm -rf $PACKAGE.html  # in case a directory is left over
246   eval "$cmd"
247   html_mono_size=`calcsize $PACKAGE.html`
248   gzip -f -9 -c $PACKAGE.html >$outdir/$PACKAGE.html.gz
249   html_mono_gz_size=`calcsize $outdir/$PACKAGE.html.gz`
250   mv $PACKAGE.html $outdir/
251
252   html_split node
253   html_split chapter
254   html_split section
255 fi
256
257 echo Making .tar.gz for sources...
258 srcfiles=`ls *.texinfo *.texi *.txi *.eps 2>/dev/null`
259 tar cvzfh $outdir/$PACKAGE.texi.tar.gz $srcfiles
260 texi_tgz_size=`calcsize $outdir/$PACKAGE.texi.tar.gz`
261
262 if test -n "$docbook"; then
263   cmd="$SETLANG $MAKEINFO -o - --docbook \"$srcfile\" > ${srcdir}/$PACKAGE-db.xml"
264   echo "Generating docbook XML... $(cmd)"
265   eval "$cmd"
266   docbook_xml_size=`calcsize $PACKAGE-db.xml`
267   gzip -f -9 -c $PACKAGE-db.xml >$outdir/$PACKAGE-db.xml.gz
268   docbook_xml_gz_size=`calcsize $outdir/$PACKAGE-db.xml.gz`
269   mv $PACKAGE-db.xml $outdir/
270
271   cmd="${DOCBOOK2HTML} -o $split_html_db_dir ${outdir}/$PACKAGE-db.xml"
272   echo "Generating docbook HTML... ($cmd)"
273   eval "$cmd"
274   split_html_db_dir=html_node_db
275   (
276     cd ${split_html_db_dir} || exit 1
277     tar -czf ../$outdir/${PACKAGE}.html_node_db.tar.gz -- *.html
278   )
279   html_node_db_tgz_size=`calcsize $outdir/${PACKAGE}.html_node_db.tar.gz`
280   rm -f $outdir/html_node_db/*.html
281   mkdir -p $outdir/html_node_db
282   mv ${split_html_db_dir}/*.html $outdir/html_node_db/
283   rmdir ${split_html_db_dir}
284
285   cmd="${DOCBOOK2TXT} ${outdir}/$PACKAGE-db.xml"
286   echo "Generating docbook ASCII... ($cmd)"
287   eval "$cmd"
288   docbook_ascii_size=`calcsize $PACKAGE-db.txt`
289   mv $PACKAGE-db.txt $outdir/
290
291   cmd="${DOCBOOK2PS} ${outdir}/$PACKAGE-db.xml"
292   echo "Generating docbook PS... $(cmd)"
293   eval "$cmd"
294   gzip -f -9 -c $PACKAGE-db.ps >$outdir/$PACKAGE-db.ps.gz
295   docbook_ps_gz_size=`calcsize $outdir/$PACKAGE-db.ps.gz`
296   mv $PACKAGE-db.ps $outdir/
297
298   cmd="${DOCBOOK2PDF} ${outdir}/$PACKAGE-db.xml"
299   echo "Generating docbook PDF... ($cmd)"
300   eval "$cmd"
301   docbook_pdf_size=`calcsize $PACKAGE-db.pdf`
302   mv $PACKAGE-db.pdf $outdir/
303 fi
304
305 echo Writing index file...
306 if test -z "$use_texi2html"; then
307    CONDS="/%%IF  *HTML_SECTION%%/,/%%ENDIF  *HTML_SECTION%%/d;\
308           /%%IF  *HTML_CHAPTER%%/,/%%ENDIF  *HTML_CHAPTER%%/d"
309 else
310    CONDS="/%%ENDIF.*%%/d;/%%IF  *HTML_SECTION%%/d;/%%IF  *HTML_CHAPTER%%/d"
311 fi
312 curdate=`$SETLANG date '+%B %d, %Y'`
313 sed \
314    -e "s!%%TITLE%%!$MANUAL_TITLE!g" \
315    -e "s!%%DATE%%!$curdate!g" \
316    -e "s!%%PACKAGE%%!$PACKAGE!g" \
317    -e "s!%%HTML_MONO_SIZE%%!$html_mono_size!g" \
318    -e "s!%%HTML_MONO_GZ_SIZE%%!$html_mono_gz_size!g" \
319    -e "s!%%HTML_NODE_TGZ_SIZE%%!$html_node_tgz_size!g" \
320    -e "s!%%HTML_SECTION_TGZ_SIZE%%!$html_section_tgz_size!g" \
321    -e "s!%%HTML_CHAPTER_TGZ_SIZE%%!$html_chapter_tgz_size!g" \
322    -e "s!%%INFO_TGZ_SIZE%%!$info_tgz_size!g" \
323    -e "s!%%DVI_GZ_SIZE%%!$dvi_gz_size!g" \
324    -e "s!%%PDF_SIZE%%!$pdf_size!g" \
325    -e "s!%%PS_GZ_SIZE%%!$ps_gz_size!g" \
326    -e "s!%%ASCII_SIZE%%!$ascii_size!g" \
327    -e "s!%%ASCII_GZ_SIZE%%!$ascii_gz_size!g" \
328    -e "s!%%TEXI_TGZ_SIZE%%!$texi_tgz_size!g" \
329    -e "s!%%DOCBOOK_HTML_NODE_TGZ_SIZE%%!$html_node_db_tgz_size!g" \
330    -e "s!%%DOCBOOK_ASCII_SIZE%%!$docbook_ascii_size!g" \
331    -e "s!%%DOCBOOK_PS_GZ_SIZE%%!$docbook_ps_gz_size!g" \
332    -e "s!%%DOCBOOK_PDF_SIZE%%!$docbook_pdf_size!g" \
333    -e "s!%%DOCBOOK_XML_SIZE%%!$docbook_xml_size!g" \
334    -e "s!%%DOCBOOK_XML_GZ_SIZE%%!$docbook_xml_gz_size!g" \
335    -e "s,%%SCRIPTURL%%,$scripturl,g" \
336    -e "s!%%SCRIPTNAME%%!$prog!g" \
337    -e "$CONDS" \
338 $GENDOCS_TEMPLATE_DIR/gendocs_template >$outdir/index.html
339
340 echo "Done!  See $outdir/ subdirectory for new files."
341
342 # Local variables:
343 # eval: (add-hook 'write-file-hooks 'time-stamp)
344 # time-stamp-start: "scriptversion="
345 # time-stamp-format: "%:y-%02m-%02d.%02H"
346 # time-stamp-end: "$"
347 # End: