Mailing-List: contact cygwin-help@sourceware.cygnus.com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/cygwin/>
List-Post: <mailto:cygwin@sources.redhat.com>
List-Help: <mailto:cygwin-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-owner@sources.redhat.com
Delivered-To: mailing list cygwin@sources.redhat.com
Message-Id: <5.1.0.14.2.20011008204408.02016ab8@pop3.cris.com>
X-Sender: rrschulz@pop3.cris.com
X-Mailer: QUALCOMM Windows Eudora Version 5.1
Date: Mon, 08 Oct 2001 20:55:37 -0700
To: Christopher Currie <christopher@currie.com>, cygwin@cygwin.com
From: Randall R Schulz <rrschulz@cris.com>
Subject: Re: /usr/man/man2 and /usr/man/man4 directories missing
In-Reply-To: <20011008224019.A863@mamet.westofhouse.net>
References: <3BB936E7.6060900@ece.gatech.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; format=flowed

Christopher C.,

This is a bit of a pet peeve for me, so I just have to chime in, even if 
Christopher F.'s replies make it moot in this context.

Please, PLEASE don't use source code as an input to or as a specificational 
/ definitional source of information for producing written documentation. 
That is, by definition, putting the cart before the horse.

I won't go on, but that's such a pervasive misconception (that an 
implementation defines a specification) and it happens to be one that 
bothers me supremely, so I just had to say my piece.

Thank you for listening.

Randall Schulz
Mountain View, CA USA


At 19:40 2001-10-08, Christopher Currie wrote:
>There was supposedly a thread about docs recently, but I've had a hard time
>tracking it down...
>
>Therefore, I'd like to take a stab at writing the man pages for these calls.
>The best references are going to be the actual source code...


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

