From owner-cvs-all  Tue Jan  7  4:27:37 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 8B7B037B401; Tue,  7 Jan 2003 04:27:36 -0800 (PST)
Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 160E143E4A; Tue,  7 Jan 2003 04:27:35 -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 XAA31026;
	Tue, 7 Jan 2003 23:24:10 +1100
Date: Tue, 7 Jan 2003 23:24:39 +1100 (EST)
From: Bruce Evans <bde@zeta.org.au>
X-X-Sender: bde@gamplex.bde.org
To: Tony Finch <dot@dotat.at>
Cc: Alexey Dokuchaev <danfe@nsu.ru>,
	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: <20030106230542.B30454@chiark.greenend.org.uk>
Message-ID: <20030107231058.W8096-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 Mon, 6 Jan 2003, Tony Finch wrote:

> On Sun, Jan 05, 2003 at 10:31:28PM +1100, Bruce Evans wrote:
> >
> > 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.
>
> The documented place for finding filesystem documentation is in the
> appropriate mount_foofs manual page. The mount(2) manual says:
>
>                                           By convention filesystem manual
>      pages are named by prefixing ``mount_'' to the name of the filesystem as
>      returned by lsvfs(1).  Thus the NFS filesystem is described by the
>      mount_nfs(8) manual page.

This doesn't seem to be good, or even correct for one example give
(mount_nfs(8)).  mount_nfs(8) only has user interface details like it
should.  It has nothing about the args struct, which what the above
is initially about.  nfs_args is referenced just once in /usr/share/man
(in mount.2) but not described.

Bruce


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