svn commit: r185607 - stable/7/share/man/man5

[Kostik Belousov]

On Thu, Dec 04, 2008 at 02:01:49PM +0100, Daniel Gerzo wrote:
> Hello Kostik,
> 
> Thursday, December 4, 2008, 1:30:58 PM, you wrote:
> 
> > On Thu, Dec 04, 2008 at 12:22:12PM +0000, Daniel Gerzo wrote:
> >> Author: danger (doc committer)
> >> Date: Thu Dec  4 12:22:11 2008
> >> New Revision: 185607
> >> URL: http://svn.freebsd.org/changeset/base/185607
> >> 
> >> Log:
> >>   - MFC the nullfs(5) manual page
> >>   
> 
> > I think there were objections against HEAD commit. The manpage is mostly
> > content-free, and our usual practice of documenting specific filesystem
> > quirks in mount_<fstype>(8) served us good enough for long time.
> 
> Could you please point me at the thread which provides more information
> about these objections? I don't remember hearing anything and
> http://lists.freebsd.org/pipermail/cvs-all/2008-October/thread.html
> doesn't contain anything too.
Yes, sorry. I am unable to find a trail too.

> 
> > What is the reason to have this man page at all ?
> 
> The main reason is that mount_nullfs(8) doesn't inform about how to
> get a nullfs support in the kernel. That is not the right place where
Filesystem is either compiled into the kernel, or module is loaded
automatically on the first mount attempt. This is a difference against
the drivers, that usually need explicit module load or be compiled
into the kernel to attach to device.

> to document it. Also when I type on a system man nullfs, I would
> really like to get some information. As I noted, this is only an
> initial version of manual page and I would really like to see it
> someone to expand it a bit.
> 
> We are also missing other *fs manual pages that might be worth to add.
> This has been actually raised on #bsddocs a while ago and that was the
> main reason I have added nullfs(5).
> 
> However if the general consensus here is that nullfs(5) is useless I
> don't have problems to back-out my commits...

I do not think it is worth a hassle to back out it, but man page ought
to contain some useful information.

In fact, there is information about nullfs implementation in the
mount_nullfs(5) that probably better be updated and moved to nullfs(5),
now that we have this page.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 195 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/svn-src-stable/attachments/20081204/3ba690a9/attachment.pgp