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: <cb51e2e050804081361144cf3@mail.gmail.com>
Date: Thu, 4 Aug 2005 08:13:25 -0700
From: Joshua Daniel Franklin <joshuadfranklin AT gmail DOT com>
Reply-To: Joshua Daniel Franklin <joshuadfranklin AT gmail DOT com>
To: Cygwin List <cygwin AT cygwin DOT com>
Subject: Re: Proposed FAQ in DocBook
In-Reply-To: <6.2.1.2.0.20050804082614.03d31bd0@pop.prospeed.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Disposition: inline
References: <cb51e2e050803221558317848 AT mail DOT gmail DOT com> 	 <6 DOT 2 DOT 1 DOT 2 DOT 0 DOT 20050804082614 DOT 03d31bd0 AT pop DOT prospeed DOT net>
X-IsSubscribed: yes
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id j74FDdjw018418

On 8/4/05, Larry Hall  wrote:
> At 01:15 AM 8/4/2005, you wrote:
> >You can link to named sections, for example
> >http://staff.washington.edu/joshuadf/cygwin/new-faq.html#faq.install.disk-space
> >
> Just one question.  How does one determine what the names are for the
> named sections?  I assume each question has one but I'm not familiar
> enough with how DocBook works to know how to determine these names.

Yes, as noted they're in the HTML in <a name="..."> tags..., converted from
DocBook's id="..." There will of course be a Table of Contents with links so 
you don't have to look at the HTML to determine this.
 
> Assuming this new style FAQ replaces the old, I'd recommend putting this
> one in a new spot and keeping the old, at least for a while, so that
> references to the old in the archive still work.

No problem, the old files are things like faq1.html, these will be
faq.using.html
and the like.

And, as someone else noted, it will be relatively easy to get .info files using
docbook2x (that's already done for the User's Guide).

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