Building documentation on linux

Christopher Faylor
Tue May 29 17:55:00 GMT 2001

On Wed, May 30, 2001 at 01:47:44AM +0100, David Starks-Browning wrote:
>On Tuesday 29 May 01, Christopher Faylor writes:
>> I haven't been able to build the doc directory in winsup for some time,
>> after upgrading to a newer Red Hat Linux.  I finally figured out that I
>> needed this package:
>> docbook-dtd30-sgml-1.0-10.noarch.rpm
>> to build the cygwin documentation on linux.
>Where can I find this rpm?  I looked on (a mirror of)
>  Maybe it's a
>bad mirror?

I found it at .

>I must admit I've never attempted to build the sgml-based docs.
>> This enabled me to do almost everything but I had to change a label in
>> cygwin/path.sgml because it was too long.  In the doc directory, I had
>> to add a space after the '-I' in some of the programs that took include
>> options, and I had to mess with the creation of faq.html a little.
>We must have different versions of texi2html, because my texi2html
>1.56k (as shipped with RH-7.0) doesn't like your changes to its
>options.  What version do you have now, after upgrading?


>> Please let me know if I screwed up anything for any other platforms and
>> I'll try to fix it now that I have a tentative grasp on how this stuff
>> works.
>I suspect this bit breaks 'make faq.hmtl' for me:

Which bit is that?  texi2html?

The only thing that I did was add a space after the -I.  According to my
1.56 documentation, that should be acceptable.  The source code seems to
bear this out, too.  I don't have a version of cygwin on the system with
1.56, though so I can't check it.


More information about the Cygwin-developers mailing list