Convert cygwin-api from using a sect2 element to using a refentry element for
each function. This makes it possible to generate manpage-style output for
those elements.
Note that the chunked html now generates a page for each function, rather than
one containing all functions.
Also:
Remove pointless and incorrect date
Move introductory paragraph from the first section to the start of the chapter
Add a funcsynopsisinfo element with the header file to be included to each
function prototype
Remove extern "C" which doesn't process into all formats successfully
2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
* cygwin-api.xml: Move introductory paragraph here.
* logon-funcs.xml: Convert from using a sect2 element to using a
refentry element for each function.
* misc-funcs.xml: Ditto.
* path.xml: 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.
cf1c6cd395