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: Wed, 30 May 2001 01:47:44 +0100
Message-ID: <500-Wed30May2001014745+0100-starksb@ebi.ac.uk>
X-Mailer: 21.1 (patch 12) "Channel Islands" XEmacs Lucid (via feedmail 9-beta-7 I);
	VM 6.92 under 21.1 (patch 12) "Channel Islands" XEmacs Lucid
From: David Starks-Browning <starksb AT ebi DOT ac DOT uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
To: cygwin-developers AT cygwin DOT com
Subject: Building documentation on linux
In-Reply-To: <20010529163019.A11484@redhat.com>
References: <20010529163019 DOT A11484 AT redhat DOT com>

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

> I
> also had to remove sites.texinfo from readme.texinfo (is this still used
> for anything?).

Oops, sorry.  I got rid of sites.texinfo long ago.  I don't think I
have made readme.txt nor readme.html for a very long time, obviously.

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

-       $(TEXI2HTML) -split_chapter  -v ./faq.texinfo; \
+       $(TEXI2HTML) --split -v ./faq.texinfo; \

(texi2html 1.56k reminds me of its options and --split isn't one of
them) but maybe I can just update texi2html to what you have.

Cheers,
David