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