Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/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
From: "Siegfried Heintze" <siegfried AT heintze DOT com>
To: <cygwin AT cygwin DOT com>
Subject: RE: Documentation on functions
Date: Thu, 15 Sep 2005 10:22:42 -0600
MIME-Version: 1.0
Content-Type: text/plain; 	charset="us-ascii"
Content-Transfer-Encoding: 7bit
In-Reply-To: <091420051431.19746.432834510009D11000004D2222058864420A050E040D0C079D0A@comcast.net>
Message-ID: <26617704.1126801364351.JavaMail.SYSTEM@CCC-NOVA1>
X-IsSubscribed: yes

Is there "documentation on the documentation"?

In other words, is the process of submitting documentation documented? Does
one use the GNU texi or SGML docbook or some other format? I've been curious
about these tools for years but have never used them.

Are there any functions documented (and I just had the bad luck of picking
the only three that were not documented) or do they all need to be
documented? (Yikes! That could be a big job)!

Is it a simple matter of cutting and pasting from linux (e.g. fedora) man
pages or does one have to go to the source code and extract the copious
comments there and just reformat them into man pages?

Siegfried


--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/