Mailing-List:	contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Subscribe:	<mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive:	<http://sources.redhat.com/ml/cygwin/>
List-Post:	<mailto:cygwin AT cygwin DOT com>
List-Help:	<mailto:cygwin-help AT cygwin DOT com>, <http://sources.redhat.com/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:	<20020821190517.11415.qmail@web20008.mail.yahoo.com>
Date:	Wed, 21 Aug 2002 12:05:17 -0700 (PDT)
From:	Joshua Daniel Franklin <joshuadfranklin AT yahoo DOT com>
Subject:	Re: Updating dll info in the User's Guide
To:	cygwin AT cygwin DOT com
MIME-Version:	1.0

References: <Pine DOT CYG DOT 4 DOT 44 DOT 0208202127280 DOT 1336-100000 AT joshua DOT iocc DOT com>
<Xns927173B917AEDsoren1Gmane AT 80 DOT 91 DOT 224 DOT 249> <20020821154045 DOT GB21737 AT redhat DOT com>
<Xns9271790BEA4BDsoren1Gmane AT 80 DOT 91 DOT 224 DOT 249> <20020821162436 DOT GE21737 AT redhat DOT com>
<Xns92718AB657BD2soren1Gmane AT 80 DOT 91 DOT 224 DOT 249>

"Soren A" <soren_andersen AT fastmail DOT fm> wrote:
>
> There are a couple standard mechanisms for including CSS stylesheets into
> the HTML document. None seem to be in use here. The documentation seems to
> be auto-generated by 'DocBook' which is something I know nothing about; I
> suspect that this is where some answers lie, though.

DocBook FAQ:

http://www.dpawson.co.uk/docbook/

> > I should make it clear that I know nothing about stylesheets.  As you
> > noted, this is autogenerated code.  If you see a specific problem with
> > it then a specific suggestion is appropriate.
>
> Yes. My specific suggestion is that you learn your tools. It is not
> farfetched to suppose that somewhere in the user documentation that
> exists for DocBook there is info pertaining to generation and
> configuration of stylesheets to complement the application's HTML
> output.

I believe I'm actually the one who's supposed to be working on improving
the documentation. I have noticed that the HTML produced could be better
(especially that putting the ">" on the next line issue), but I don't (yet?)
know how to make it better. 

What I do know is that right now the HTML User's Guide looks decent in most
every browser, and I have heard about stylesheets that
Netscape 4.x does not support them very well. So I echo Chris':

> > If you have a specific suggestion, I'd like to hear it.

__________________________________________________
Do You Yahoo!?
HotJobs - Search Thousands of New Jobs
http://www.hotjobs.com

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Bug reporting:         http://cygwin.com/bugs.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/

- Raw text -