Jon TURNEY cf1c6cd395 winsup/doc: Convert cygwin-api function documentation to refentry elements
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>
2015-06-18 11:32:03 +01:00
..
2015-03-09 21:40:26 +01:00
2006-05-24 16:59:03 +00:00
2015-03-10 14:19:42 +01:00
2013-07-25 09:09:14 +00:00
2015-06-17 11:11:02 +02:00
2015-04-29 12:55:03 -05:00
2015-06-17 11:22:14 +02:00
2015-03-10 16:07:07 +01:00
2015-03-10 14:19:42 +01:00
.
2013-05-23 19:03:19 +00:00

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.