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
Date: Wed, 3 Apr 2002 23:35:26 -0500
From: Christopher Faylor <cgf AT redhat DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: cygwin-man
Message-ID: <20020404043526.GA21964@redhat.com>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <20020404043137 DOT 56440 DOT qmail AT web20007 DOT mail DOT yahoo DOT com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20020404043137.56440.qmail@web20007.mail.yahoo.com>
User-Agent: Mutt/1.3.23.1i

On Wed, Apr 03, 2002 at 08:31:37PM -0800, Joshua Daniel Franklin wrote:
>I was thinking about (end-user) documentation. It seems like there are quite
>a few questions that come up about "What kind of UNIX is Cygwin?" and more
>than once there have been questions about a "man intro" page.
>I know a little groff and I'm thinking of making a collection of
>cygwin-specific
>manpages. Since the full documentation is on the web the manpages could point
>that direction (like the GNU manpages point to info).
>I might start out with a "man intro" page and manpages for the cygwin utils
>and cygwin_foo() functions, as already documented on the website. What I'm 
>looking for is feedback on the intro.1 page, which might include:
>
>--URL of the User's Guide
>--the description from the website about "A DLL (cygwin1.dll) that acts as a 
>  UNIX emulation layer..."
>--emphasis on GNU tools which make the cygwin environment more similar to 
>  GNU/Linux or GNU/Hurd than, say, Solaris
>--that cygwin is NOT any one UNIX and the importance of the SUSv2 (with URL)
>--SEE ALSO: cygcheck, cygpath, etc.
>--???
>
>Obviously this is not real writing but just points to make on the page. I'll 
>post a draft here also.

I think this is a wonderful idea.  Can I sign you up to improve the
documentation, too?  I'm sure that a lot of it is out of date or needs
more details.

It would be nice if most of it was available in info format, too.

However, I keep asking for volunteers for this so I know I can't be
choosy.  If you're willing to provide man pages, they would be much
appreciated.

I wonder if we should nuke the newlib man pages in the process and just
make one cygwin-man package containing everything.

cgf

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