From owner-cvs-all Mon Jan 6 15:15:14 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 A878037B401; Mon, 6 Jan 2003 15:15:12 -0800 (PST) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id EC9B343ED4; Mon, 6 Jan 2003 15:15:11 -0800 (PST) (envelope-from trhodes@FreeBSD.org) Received: from moble.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.6/8.12.6) with SMTP id h06NC3Ap020325; Mon, 6 Jan 2003 18:12:03 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Mon, 6 Jan 2003 18:12:27 -0500 From: Tom Rhodes To: Tony Finch Cc: bde@zeta.org.au, danfe@nsu.ru, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man5 Makefile msdos.5 Message-Id: <20030106181227.680b6b15.trhodes@FreeBSD.org> In-Reply-To: <20030106230542.B30454@chiark.greenend.org.uk> References: <20030105082155.GA51107@regency.nsu.ru> <20030105221437.F518-100000@gamplex.bde.org> <20030106230542.B30454@chiark.greenend.org.uk> X-Mailer: Sylpheed version 0.8.8claws (GTK+ 1.2.10; i386-portbld-freebsd5.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Mon, 6 Jan 2003 23:05:42 +0000 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. > > Since there is already a mount_msdosfs(8) manual page the msdosfs(5) > page should be deleted. FreeBSD is doubly buggy w.r.t. ffs since there > isn't a mount_ffs program to go with the correctly-named manual page. > I dislike this for several reasons: 1: Currently the mount_msdosfs(8) manual page has nothing about kernel configuration. 2: I feel strongly that modules (such as msdosfs.ko) should have a manual page with information relating to it. 3: How many NEW users know about the existance of mount_msdosfs(8) at all? Its alot easier on the newbie to man msdos or man msdosfs for information. I'll move it over to section 4, in fact thats where I was originally going to put it. If thats the general desire then I'll do so later. -- Tom Rhodes To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message