Wed Oct 16 22:15:42  2002 Joshua Daniel Franklin <joshuadfranklin@yahoo.com>

(cygwin-info)
BUILD REQUIREMENTS:

ash
cygwin
gzip
make
texinfo

BUILD INSTRUCTIONS:

Type 'make' or 'make all' to build.  To install, 'make install'.

The cygwin.texi file was written by hand to provide an entry point.
The other texi files were produced with docbook2X from the official
Cygwin SGML DocBook found in CVS. I have not been able to get a 
working docbook2X installation on Cygwin, so currently I convert
the files on a machine running Debian GNU/Linux 3.0. If you do not
need to create info files from the latest CVS, the texi files found
in this directory will work fine. Otherwise, read below.

INSTALLING docbook2X ON DEBIAN GNU/LINUX 3.0 AND CONVERTING CYGWIN SGML

1. Install the following packages (available via apt-get):

libwww-perl
libxml-parser-perl
libxml-writer-perl
libxml-catalog-perl
libxml-perl
libsgmls-perl
libxml-dom-perl
libxml-libxslt-perl
libxslt1-dev
docbook-xml

2. Download the latest docbook2X package from 
<http://docbook2x.sourceforge.net/> or download version 0.70 (which I use) from
<http://ns1.iocc.com/~joshua/cygwin/docbook/non-cygwin/docbook2X-0.7.0.tar.gz>
This is a source distribution (no binaries are available) so you need to
have a build environment installed (gcc, etc.). Unpack the docbook2X tarball
and run './configure' to find dependencies. Unfortunately due (I believe) 
to changes in the perl XML::Parser module since docbook2X was written the 
docbook2X documentation no longer builds cleanly, so in the top-level Makefile 
I replaced the SUBDIRS line: 

#SUBDIRS = . charmaps dtd patches xslt perl libxslt utf8trans doc testdocs
SUBDIRS = . charmaps dtd patches xslt perl libxslt utf8trans testdocs

After this change 'make' and 'make install' work correctly (other than the
resulting lack of documentation).

3. Create a directory in which to convert the files.  You need to copy the
latest CVS sgml to this directory, convert, and copy the resulting texi files
back. I use a samba-mounted network share in order to make moving files easier. 
I do this using the commands in the 'upgrade' section of the Makefile in this
directory and the following Makefile in the samba-mounted /h/convert directory
on the Debian GNU/Linux 3.0 machine (if you cut-and-paste, be sure to replace
the TABs properly):

## Begin /h/convert Makefile 
all:    api ug

api:
	perl -i -p -e 's/&copy;/(c)/' cygwin-api.sgml
	sgml2xml -x lower cygwin-api.sgml > cygwin-api.xml
	docbook2texixml cygwin-api.xml >cygwin-api.txml
	db2x_texixml cygwin-api.txml
#	makeinfo cygwin-api.texi

ug:
	perl -i -p -e 's/&copy;/(c)/' cygwin-ug-net.sgml
	sgml2xml -x lower cygwin-ug-net.sgml > cygwin-ug.xml
	docbook2texixml cygwin-ug.xml >cygwin-ug.txml
	db2x_texixml cygwin-ug.txml
#	makeinfo cygwin-ug.texi

clean:
	rm -f core *xml

## End /h/convert Makefile

Note that the SGML DocBook -> texi translation lists many many warnings.
