Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 6 Jan 2003 18:12:27 -0500
From:      Tom Rhodes <trhodes@FreeBSD.org>
To:        Tony Finch <dot@dotat.at>
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>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 6 Jan 2003 23:05:42 +0000
Tony Finch <dot@dotat.at> 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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030106181227.680b6b15.trhodes>