From owner-cvs-all  Sun Jan  5  3:31:23 2003
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 3458737B401; Sun,  5 Jan 2003 03:31:22 -0800 (PST)
Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id BC8EB43EC5; Sun,  5 Jan 2003 03:31:20 -0800 (PST)
	(envelope-from bde@zeta.org.au)
Received: from katana.zip.com.au (katana.zip.com.au [61.8.7.246])
	by mailman.zeta.org.au (8.9.3/8.8.7) with ESMTP id WAA30656;
	Sun, 5 Jan 2003 22:31:10 +1100
Date: Sun, 5 Jan 2003 22:31:28 +1100 (EST)
From: Bruce Evans <bde@zeta.org.au>
X-X-Sender: bde@gamplex.bde.org
To: Alexey Dokuchaev <danfe@nsu.ru>
Cc: Tom Rhodes <trhodes@FreeBSD.org>, <cvs-committers@FreeBSD.org>,
	<cvs-all@FreeBSD.org>
Subject: Re: cvs commit: src/share/man/man5 Makefile msdos.5
In-Reply-To: <20030105082155.GA51107@regency.nsu.ru>
Message-ID: <20030105221437.F518-100000@gamplex.bde.org>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

On Sun, 5 Jan 2003, Alexey Dokuchaev wrote:

> On Sun, Dec 29, 2002 at 08:44:44PM -0800, Tom Rhodes wrote:
> > trhodes     2002/12/29 20:44:44 PST
> >
> >   Modified files:        (Branch: RELENG_4)
> >     share/man/man5       Makefile
> >   Added files:           (Branch: RELENG_4)
> >     share/man/man5       msdos.5
> >   Log:
> >   Add an msdos file system driver manual page to RELENG_4.
>
> Am I missing something, but I've always thought that section 5 of
> manpages was for various FreeBSD files formats.  Should not this go to
> section 4 (kernel interfaces) instead?

Not quite.  Section 4 is for devices and device drivers.  File systems
aren't devices or device drivers.  ffs.7 was originally in section 4,
but was moved to a less wrong place.  msdosfs.5 belongs with ffs.7.

Section 5 has the following other misplaced things related to file
systems:

devfs.5, fdescfs.5: like msdosfs.5 (?)

fs.5: actually does document a file format, namely the superblock format
      for 10-year old versions of ffs.  This belongs in an Attic.  The
      non-rotted version is in ffs/fs.h.

procfs.5: this is almost correctly placed, since it describes the format
          of procfs's dirctory tree and the format of some of procfs's
	  irregular regular files.

Bruce


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message