646745cbf3
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.