Mailing-List: contact cygwin-developers-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-developers-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-developers/>
List-Post: <mailto:cygwin-developers AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-developers-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-developers-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin-developers AT sources DOT redhat DOT com
Date: Tue, 29 May 2001 20:55:41 -0400
From: Christopher Faylor <cgf AT redhat DOT com>
To: cygwin-developers AT cygwin DOT com
Subject: Re: Building documentation on linux
Message-ID: <20010529205541.A14166@redhat.com>
Reply-To: cygwin-developers AT cygwin DOT com
Mail-Followup-To: cygwin-developers AT cygwin DOT com
References: <20010529163019 DOT A11484 AT redhat DOT com> <500-Wed30May2001014745+0100-starksb AT ebi DOT ac DOT uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.11i
In-Reply-To: <500-Wed30May2001014745+0100-starksb@ebi.ac.uk>; from starksb@ebi.ac.uk on Wed, May 30, 2001 at 01:47:44AM +0100

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