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

[Daniel Gerzo]

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 at FreeBSD.org