Building documentation on linux

Christopher Faylor cgf@redhat.com
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)
>sourceware.cygnus.com/pub/docbook-tools/docware/RPMS.  Maybe it's a
>bad mirror?

I found it at http://rpmfind.net/ .

>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?

1.64.

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

cgf



More information about the Cygwin-developers mailing list