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
Date: Thu, 4 Aug 2005 11:18:53 -0400 (EDT)
From: Igor Pechtchanski <pechtcha AT cs DOT nyu DOT edu>
Reply-To: cygwin AT cygwin DOT com
To: Joshua Daniel Franklin <joshuadfranklin AT gmail DOT com>
cc: cygwin AT cygwin DOT com
Subject: Re: Proposed FAQ in DocBook (Attn: tetex maintainer)
In-Reply-To: <cb51e2e050803221558317848@mail.gmail.com>
Message-ID: <Pine.GSO.4.61.0508041110060.3695@slinky.cs.nyu.edu>
References: <cb51e2e050803221558317848 AT mail DOT gmail DOT com>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII

On Wed, 3 Aug 2005, Joshua Daniel Franklin wrote:

> I'm tired of tip-toeing around the texinfo source for the FAQ just to make
> sure links to the numbered questions work

FYI, "makeinfo --html" will have named anchors (with names being section
headers), and so will "texi2html --node-files" (I also usually use
"--split node").

> so I've converted the source to DocBook and put up preliminary versions:
>
> Several files: http://staff.washington.edu/joshuadf/cygwin/faq.html
>
> One file:  http://staff.washington.edu/joshuadf/cygwin/new-faq.html
>
> You can link to named sections, for example
> http://staff.washington.edu/joshuadf/cygwin/new-faq.html#faq.install.disk-space
>
> I haven't done all the stylesheet customizations to make it feel more like
> the old FAQ but I thought I'd put this out for any feedback or comments.

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.

Incidentally, tetex-3.0.0 seems to be missing the texi2html executable (it
was present in tetex-2.0.2).  Jan, any comments?
	Igor
-- 
				http://cs.nyu.edu/~pechtcha/
      |\      _,,,---,,_		pechtcha AT cs DOT nyu DOT edu
ZZZzz /,`.-'`'    -.  ;-;;,_		igor AT watson DOT ibm DOT com
     |,4-  ) )-,_. ,\ (  `'-'		Igor Pechtchanski, Ph.D.
    '---''(_/--'  `-'\_) fL	a.k.a JaguaR-R-R-r-r-r-.-.-.  Meow!

If there's any real truth it's that the entire multidimensional infinity
of the Universe is almost certainly being run by a bunch of maniacs. /DA

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