From owner-freebsd-doc@FreeBSD.ORG Mon May 29 01:39:14 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3882016A793; Mon, 29 May 2006 01:39:14 +0000 (UTC) (envelope-from rodrigc@crodrigues.org) Received: from sccrmhc13.comcast.net (sccrmhc13.comcast.net [204.127.200.83]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9DC9243D48; Mon, 29 May 2006 01:39:13 +0000 (GMT) (envelope-from rodrigc@crodrigues.org) Received: from c-24-147-19-128.hsd1.ma.comcast.net (c-71-233-168-2.hsd1.ma.comcast.net[71.233.168.2](misconfigured sender)) by comcast.net (sccrmhc13) with ESMTP id <200605290139120130081d7oe>; Mon, 29 May 2006 01:39:12 +0000 Received: from c-24-147-19-128.hsd1.ma.comcast.net (localhost [127.0.0.1]) by c-24-147-19-128.hsd1.ma.comcast.net (8.13.6/8.13.1) with ESMTP id k4T1dCpR017504; Sun, 28 May 2006 21:39:12 -0400 (EDT) (envelope-from rodrigc@c-24-147-19-128.hsd1.ma.comcast.net) Received: (from rodrigc@localhost) by c-24-147-19-128.hsd1.ma.comcast.net (8.13.6/8.13.1/Submit) id k4T1dBmd017503; Sun, 28 May 2006 21:39:11 -0400 (EDT) (envelope-from rodrigc) Date: Sun, 28 May 2006 21:39:11 -0400 From: Craig Rodrigues To: Joseph Koshy Message-ID: <20060529013911.GA17351@crodrigues.org> References: <20060528215447.GA6955@crodrigues.org> <84dead720605281821k6fdc20dcve69c5b5b325c5c9@mail.gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <84dead720605281821k6fdc20dcve69c5b5b325c5c9@mail.gmail.com> User-Agent: Mutt/1.4.2.1i Cc: freebsd-doc@freebsd.org, ru@freebsd.org Subject: Re: Where would a nullfs man page go? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 May 2006 01:39:14 -0000 On Mon, May 29, 2006 at 06:51:48AM +0530, Joseph Koshy wrote: > Section 5 is supposed to be about file formats, but > manual pages for devfs, ext2fs, fdescfs, linprocfs, > linsysfs, procfs, msdosfs, mqueuefs and reiserfs are > present in it. Most of these manual pages appear > to fit elsewhere since they do not talk about file format, > perhaps section 4 (drivers & kernel modules). ffs is > documented in section 7 (miscellaneous). pseudofs resides > in section 9. This should also be in section 4, like > miibus(4). Now that you mention it, I think that devfs, ext2fs, fdescfs, linprocfs, linsysfs, procfs, msdosfs, mqueuefs, and reiserfs all belong in section 4 (drivers & kernel modules). None of those man pages talk about the actual file format of any of those filesystems. I think a nullfs man page belongs in section 4. I think ffs(7) belongs in section 4 as well, since more or less it talks about the driver used for the FFS/UFS filesystem. I am to blame for putting devfs and ext2fs in section 5, because I just followed the convention that previous people followed. -- Craig Rodrigues rodrigc@crodrigues.org