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
Date: Mon, 8 Oct 2001 22:40:19 -0400
To: cygwin AT cygwin DOT com
Subject: Re: /usr/man/man2 and /usr/man/man4 directories missing
Message-ID: <20011008224019.A863@mamet.westofhouse.net>
Mail-Followup-To: cygwin AT cygwin DOT com
References: <3BB936E7 DOT 6060900 AT ece DOT gatech DOT edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.20i
From: Christopher Currie <christopher AT currie DOT com>

There was supposedly a thread about docs recently, but I've had a hard time
tracking it down. I've also been frustrated in the past by the lack of
man pages for the Section 2 system calls, the stuff that's not covered by
the C standard library. Most of the Linux man pages are written by the Linux
kernel developers, and aren't "free" in the GNU sense of the word, so we
can't borrow from their work.

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.  I'm assuming some
of the low level system calls for Cygwin may end up being wrappers for Win32
api calls, but most will in the POSIX emulation provided by Cygwin. Am I wrong?
Can anyone think of any other research sources I could use while writing these
pages without getting into copyright issues?

On Mon, Oct 01, 2001 at 11:39:19PM -0400, Charles Wilson wrote:
> Err...it's not just those directories that are missing.  Setup 
> automatically creates the appropriate directories -- if there are files 
> that "want" to be put in them.  Conclusion: not one of the 40 or so 
> cygwin packages contains a single "foo.4" man page or "foo.2" man page.
> 
> e.g. We don't have documentation for "ANSI C functions such as fread, 
> fwrite, etc)".  If you can find a free (as in speech, as in beer) source 
> for them, please contribute.
> 
> --Chuck
> 
> Abhijit Patait wrote:
> 
> >Hi
> >
> >I recently installed cygwin. However, I do not know
> >why the installation program did not install all the
> >'man' pages. I checked in the /usr/man directory
> >(where 'man' looks for documentation by default when
> >MANPATH is empty - which is the case on my computer)
> >and found that the directories /usr/man/man2 and
> >/usr/man/man4 are missing (man1, man3, man4, man5,
> >man7, man8, man9 are there). The man pages that I was
> >looking for (those for ANSI C functions such as fread,
> >fwrite, etc) are probably supposed to be in those
> >directories and hence 'man' cannot find them.
> >
> >Could someone tell me how I do I install the man pages
> >for everything?
> >
> >Thanks in advance.
> >
> >-Abhijit
> >
> >
> >__________________________________________________
> >Do You Yahoo!?
> >Listen to your Yahoo! Mail messages from any phone.
> >http://phone.yahoo.com
> >
> >--
> >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/
> >
> >
> 
> 

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