Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 4 Dec 2008 14:01:49 +0100
From:      Daniel Gerzo <danger@FreeBSD.org>
To:        Kostik Belousov <kostikbel@gmail.com>
Cc:        svn-src-stable@freebsd.org, Daniel Gerzo <danger@freebsd.org>, src-committers@freebsd.org, svn-src-stable-7@freebsd.org, svn-src-all@freebsd.org
Subject:   Re[2]: svn commit: r185607 - stable/7/share/man/man5
Message-ID:  <1596632487.20081204140149@rulez.sk>
In-Reply-To: <20081204123058.GD2038@deviant.kiev.zoral.com.ua>
References:  <200812041222.mB4CMCgC020841@svn.freebsd.org> <20081204123058.GD2038@deviant.kiev.zoral.com.ua>

next in thread | previous in thread | raw e-mail | index | archive | help
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.

> 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
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...

-- 
Best regards,
 Daniel                            mailto:danger@FreeBSD.org




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