Date: Thu, 4 Dec 2008 15:18:28 +0200 From: Kostik Belousov <kostikbel@gmail.com> To: Daniel Gerzo <danger@freebsd.org> Cc: svn-src-stable@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org, svn-src-stable-7@freebsd.org Subject: Re: svn commit: r185607 - stable/7/share/man/man5 Message-ID: <20081204131828.GF2038@deviant.kiev.zoral.com.ua> In-Reply-To: <1596632487.20081204140149@rulez.sk> References: <200812041222.mB4CMCgC020841@svn.freebsd.org> <20081204123058.GD2038@deviant.kiev.zoral.com.ua> <1596632487.20081204140149@rulez.sk>
next in thread | previous in thread | raw e-mail | index | archive | help
--cz6wLo+OExbGG7q/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Dec 04, 2008 at 02:01:49PM +0100, Daniel Gerzo wrote: > Hello Kostik, >=20 > Thursday, December 4, 2008, 1:30:58 PM, you wrote: >=20 > > 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 > >>=20 > >> Log: > >> - MFC the nullfs(5) manual page > >> =20 >=20 > > 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. >=20 > 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. >=20 > > What is the reason to have this man page at all ? >=20 > 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. >=20 > 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). >=20 > 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. --cz6wLo+OExbGG7q/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEARECAAYFAkk32KQACgkQC3+MBN1Mb4jMOQCfVy7LSd+1f1SSuaWfYk8A7iLj g+EAn2eHPYn/Ny8IjVHNmhzIWpmqG8d6 =zGqr -----END PGP SIGNATURE----- --cz6wLo+OExbGG7q/--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20081204131828.GF2038>