Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm List-Subscribe: List-Archive: List-Post: List-Help: , Sender: cygwin-owner@cygwin.com Mail-Followup-To: cygwin@cygwin.com Delivered-To: mailing list cygwin@cygwin.com Message-ID: Date: Thu, 4 Aug 2005 16:11:06 -0700 From: Joshua Daniel Franklin Reply-To: Joshua Daniel Franklin To: cygwin@cygwin.com Subject: Re: Proposed FAQ in DocBook (Attn: tetex maintainer) In-Reply-To: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Disposition: inline References: 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/