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
To: cygwin AT cygwin DOT com
X-Injected-Via-Gmane: http://gmane.org/
Path: not-for-mail
From: Soren A <soren_andersen AT fastmail DOT fm>
Newsgroups: gmane.os.cygwin
Subject: Re: Updating dll info in the User's Guide
Date: Wed, 21 Aug 2002 17:36:56 +0000 (UTC)
Organization: Occasionally Sporadically
Lines: 35
Message-ID: <Xns92718AB657BD2soren1Gmane@80.91.224.249>
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>
NNTP-Posting-Host: ny-kenton2a-572.buf.adelphia.net
X-Trace: main.gmane.org 1029951416 12526 24.51.94.60 (21 Aug 2002 17:36:56 GMT)
X-Complaints-To: usenet AT main DOT gmane DOT org
NNTP-Posting-Date: Wed, 21 Aug 2002 17:36:56 +0000 (UTC)
User-Agent: Xnews/L5
X-Archive: encrypt

Christopher Faylor <cgf AT redhat DOT com> wrote around 21 Aug 2002
news:20020821162436 DOT GE21737 AT redhat DOT com about %s: 

> Not the same thing.  It's the standard bug reporting technique of
> assuming that the people reading the mail are mind readers who are
> clued into exact knowledge of a problem.

Not really, Chris. In this case, the reality is not that there was
anything inadaquate about my report/query, but rather the inadaquacy is
entirely on your part. You are the documentation maintainer and yet you
know nothing about aspects of the tools you use? HEY. 

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

It's really not a major issue. Users can write their own stylesheets,
and on a User Agent like Opera (and prob. Mozilla) they can configure
their UA to use them. The absence of the stylesheets (which REALLY
aren't that mysterious, Chris; they are by analogy just like a C header
but not a fatal error if they are missing...) doesn't impact the
documents in such a way as to render them unusable (which is precisely
the basic principle behind css to begin with). 

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

  Regards,
    Soren A




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