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
Content-Type: text/plain; charset=ISO-8859-1
Content-Disposition: inline
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
Content-Transfer-Encoding: 8bit
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/