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

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/

- Raw text -