Mailing-List:	contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Subscribe:	<mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive:	<http://sourceware.org/ml/cygwin/>
List-Post:	<mailto:cygwin AT cygwin DOT com>
List-Help:	<mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender:	cygwin-owner AT cygwin DOT com
Mail-Followup-To:	cygwin AT cygwin DOT com
Delivered-To:	mailing list cygwin AT cygwin DOT com
Message-ID:	<cb51e2e0508041611dfb64c@mail.gmail.com>
Date:	Thu, 4 Aug 2005 16:11:06 -0700
From:	Joshua Daniel Franklin <joshuadfranklin AT gmail DOT com>
Reply-To:	Joshua Daniel Franklin <joshuadfranklin AT gmail DOT com>
To:	cygwin AT cygwin DOT com
Subject:	Re: Proposed FAQ in DocBook (Attn: tetex maintainer)
In-Reply-To:	<Pine.GSO.4.61.0508041110060.3695@slinky.cs.nyu.edu>
Mime-Version:	1.0
References:	<cb51e2e050803221558317848 AT mail DOT gmail DOT com> <Pine DOT GSO DOT 4 DOT 61 DOT 0508041110060 DOT 3695 AT slinky DOT cs DOT nyu DOT edu>
X-IsSubscribed:	yes
X-MIME-Autoconverted:	from quoted-printable to 8bit by delorie.com id j74NCT0B000723

On 8/4/05, Igor Pechtchanski  wrote:
> I like the way the new FAQ looks.  One question, however: is DocBook
> easily installable on Cygwin?  Can the FAQ be built with the default
> settings of Cygwin's DocBook package?  If so, this package should be
> listed as a prerequisite for building the Cygwin documentation.

Yes, I believe if you just select "xmlto" in setup.exe it pulls in all the
necessary files except the FAQ source and XSL customizations, which 
will be in CVS. Plus, as I mentioned earlier the User's Guide is already
DocBook (has been from the start) so it's not like this is a totally new
format. In fact it's easier to use than the current FAQ, see below.
 
> Incidentally, tetex-3.0.0 seems to be missing the texi2html executable (it
> was present in tetex-2.0.2).  Jan, any comments?

It's even worse than that. The htdocs/faq/update script that creates the FAQ 
relies on the specific output format of texi2html 1.56k. I don't remember 
exactly what newer versions do differently but they don't work. We could easily 
put 1.56k in CVS--I would actually probably put it in htdocs/faq/ to get 
everything in one place, after all there's already an "update" script there.

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/

- Raw text -