Convert utils.xml from using a sect2 element to using a refentry element for
each utility program. This makes it possible to generate manpage-style output
for those elements.
Note that the chunked html now generates a page for each utility, rather than
one containing all utilities.
A small customization to TOC generation for HTML and PDF is needed to ensure
that it appears as before, containing an entry for each utility command.
Future work: synopsis and options sections could use more detailed markup than
just wrapping the whole thing in <screen>
2015-06-12 Jon Turney <jon.turney@dronecode.org.uk>
* utils.xml : Convert from using a sect2 element to using a
refentry element for each utility program.
* cygwin.xsl: Customize autotoc to include refentries.
* fo.xsl: Ditto.
Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
The cygwin-doc source files are kept in CVS. Please see
https://cygwin.com/cvs.html for more information.
BUILD REQUIREMENTS:
bash
bzip2
coreutils
cygwin
dblatex
docbook-xml45
docbook-xsl
gzip
make
texinfo
perl
xmlto
OTHER NOTES:
You may use docbook2X to convert the DocBook files into info pages.
I have not been able to get a working docbook2X installation on Cygwin,
so currently I convert the files on a machine running GNU/Linux.
A few handmade files (cygwin.texi, intro.3, etc.) are found in the
cygwin-doc-x.y-z-src.tar.bz2 package. It also contains the utilities for
building the cygwin-doc-x.y-z "binary" package--simply run each step in
the cygwin-doc-x.y-z.sh script.
646745cbf3