Return-Path: owner-linux-activists@Niksula.hut.fi
Return-Path: <owner-linux-activists@Niksula.hut.fi>
Received: from joker.cs.hut.fi by hydra.Helsinki.FI (4.1/SMI-4.1/39)
	id AA03515; Thu, 1 Apr 93 22:31:03 +0300
Received: from joker.cs.hut.fi by niksula.hut.fi id <61620-11>; Thu, 1 Apr 1993 22:29:31 +0300
From: "Linux Activists" <linux-activists@Niksula.hut.fi>
To: "Linux-Activists" <linux-activists@Niksula.hut.fi>
Reply-To: "Linux-Activists" <linux-activists@Niksula.hut.fi>
X-Note1: Remember to put 'X-Mn-Key: DOC' to your mail body or header
Subject: Linux-Activists - DOC Channel digest. 93-3-1-15:35
X-Mn-Key: DOC
Sender: owner-linux-activists@Niksula.hut.fi
Message-Id: <93Apr1.222931eet_dst.61620-11@niksula.hut.fi>
Date: Thu, 1 Apr 1993 22:29:27 +0300
Status: RO
X-Status: 


Topics:
	 New section 2 man pages available


----------------------------------------------------------------------

From: Rik Faith <faith@cs.unc.edu>
Subject: New section 2 man pages available
Date: Thu, 1 Apr 1993 16:33:57 +0300


Ian Jackson has provided the following man pages:

            _exit.2   access.2  alarm.2   read.2    write.2

These are based on Drew Eckhardt's man pages from last year.  More new
section 2 man pages will be released over the next few weeks.

You can ftp these man pages from:

            ftp.cs.unc.edu:/pub/faith/linux/man.linux/man2



Here is the README file for the MAN PAGE PROJECT:


Tue Mar  9 13:05:50 1993

This document describes ftp.cs.unc.edu:/pub/faith/linux/man.{bsd,linux}

NOTE: This project deals *ONLY* with section 2, 3, 4, 5, 7, and 9.
      Do *NOT* send me man pages for other sections.
      Do *NOT* send me info pages.
      Do *NOT* start a man page vs. info page flame war.
      The point is to *WRITE* initial documentation, not to fight about it.

Section 2 = system calls
Section 3 = libc calls
Section 4 = devices (e.g., hd, sd)
Section 5 = file formats (e.g., /etc/wtmp, /etc/passwd)
Section 7 = macro packages, etc. (e.g., nroff, ascii)
Section 9 = internal kernel routines (for kernel hackers)



The man.bsd directory contains man pages from the 4.3bsd-reno distribution,
as found on wuarchive.wustl.edu:/mirrors/4.3bsd-reno.
These man pages can provide a starting point for starting work on the Linux
man pages.  The idea is that you would pick up a man page that you want to
work on.  Work on it.  And then send it back.

man.bsd.DATE.tar.z is this complete tree in gzip tar format.



The man.linux directory contains man pages which have been specifically
modified for Linux.  This usually means that someone actually read the man
page and checked out the current Linux source (kernel or library).  Most of
the man pages present were written by Michael Haardt
(u31b3hs@pool.informatik.rwth-aachen.de).  I encourage other people to
email me new Linux-specific man pages.

man.linux.DATE.tar.z is this complete tree in gzip tar format.



STANDARDS:

1) Whenever you modify a man page, add a timestamp and your name.
2) Change the date: for BSD man pages, this is the .Dd macro.
                    for normal man pages, this is part of the .TH macro.
3) Change the OS: for BSD man pages, for example, put "Linux 0.99" after .Os
                  for normal man pages, this is part of the .TH macro.
4) See man(7) for more details on how to write man pages from scratch.
5) Please keep the introductory parts (.TH, NAME, SYNOPSIS, etc.) *very*
   standard -- these parts are used by makewhatis to make the whatis
   database. 
6) If you are not sure of some behavior, state that: the initial man pages
   don't need to be complete, they just need to be correct.
7) Send new man pages (one at a time)  and corrections to faith@cs.unc.edu
8) If you have dozens of man pages, please send uuencoded, gzip'd tar files.





------------------------------

End of DOC Digest
*****************
-------
