Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 4 Dec 2008 14:30:58 +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:  <20081204123058.GD2038@deviant.kiev.zoral.com.ua>
In-Reply-To: <200812041222.mB4CMCgC020841@svn.freebsd.org>
References:  <200812041222.mB4CMCgC020841@svn.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--pQhZXvAqiZgbeUkD
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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
>   Approved by:	re@ (blackend)
>=20
> Added:
>   stable/7/share/man/man5/nullfs.5
>      - copied unchanged from r183631, head/share/man/man5/nullfs.5
> Modified:
>   stable/7/share/man/man5/   (props changed)
>   stable/7/share/man/man5/Makefile
>=20
> Modified: stable/7/share/man/man5/Makefile
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D
> --- stable/7/share/man/man5/Makefile	Thu Dec  4 08:17:34 2008	(r185606)
> +++ stable/7/share/man/man5/Makefile	Thu Dec  4 12:22:11 2008	(r185607)
> @@ -46,6 +46,7 @@ MAN=3D	acct.5 \
>  	networks.5 \
>  	nsmb.conf.5 \
>  	nsswitch.conf.5 \
> +	nullfs.5 \
>  	passwd.5 \
>  	pbm.5 \
>  	periodic.conf.5 \
>=20
> Copied: stable/7/share/man/man5/nullfs.5 (from r183631, head/share/man/ma=
n5/nullfs.5)
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D
> --- /dev/null	00:00:00 1970	(empty, because file is newly added)
> +++ stable/7/share/man/man5/nullfs.5	Thu Dec  4 12:22:11 2008	(r185607, c=
opy of r183631, head/share/man/man5/nullfs.5)
> @@ -0,0 +1,75 @@
> +.\"
> +.\" Copyright (c) 2008 Daniel Gerzo
> +.\" All rights reserved.
> +.\"
> +.\" Redistribution and use in source and binary forms, with or without
> +.\" modification, are permitted provided that the following conditions
> +.\" are met:
> +.\" 1. Redistributions of source code must retain the above copyright
> +.\"    notice, this list of conditions and the following disclaimer.
> +.\" 2. Redistributions in binary form must reproduce the above copyright
> +.\"    notice, this list of conditions and the following disclaimer in t=
he
> +.\"    documentation and/or other materials provided with the distributi=
on.
> +.\"
> +.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRE=
SS OR
> +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRA=
NTIES
> +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIM=
ED.
> +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
> +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,=
 BUT
> +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF=
 USE,
> +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
> +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
> +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE US=
E OF
> +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
> +.\"
> +.\" $FreeBSD$
> +.\"
> +.Dd October 5, 2008
> +.Dt NULLFS 5
> +.Os
> +.Sh NAME
> +.Nm nullfs
> +.Nd "null file system"
> +.Sh SYNOPSIS
> +To enable support for
> +.Nm ,
> +place the following line in the kernel configuration file:
> +.Bd -ragged -offset indent
> +.Cd "options NULLFS"
> +.Ed
> +.Pp
> +Alternatively, to load the driver as a
> +module at boot time, place the following line in
> +.Xr loader.conf 5 :
> +.Bd -literal -offset indent
> +nullfs_load=3D"YES"
> +.Ed
> +.Sh DESCRIPTION
> +The
> +.Nm
> +driver will permit the
> +.Fx
> +kernel to mount a loopback file system sub-tree.
> +.Sh EXAMPLES
> +To mount a
> +.Nm
> +file system:
> +.Pp
> +.Dl "mount_nullfs /usr/ports /home/devel/ports"
> +.Sh SEE ALSO
> +.Xr fstab 5 ,
> +.Xr mount_nullfs 8
> +.Sh HISTORY
> +The
> +.Nm
> +layer first appeared in
> +.Bx 4.4 .
> +.Sh AUTHORS
> +.An -nosplit
> +The
> +.Nm
> +kernel implementation was written by
> +.An John Heideman .
> +.Pp
> +This manual page was written by
> +.An Daniel Gerzo Aq danger@FreeBSD.org .

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.

What is the reason to have this man page at all ?

--pQhZXvAqiZgbeUkD
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (FreeBSD)

iEYEARECAAYFAkk3zYIACgkQC3+MBN1Mb4hC2ACfTpksGvCyk+Gs9XsM0s2palFQ
y3MAoO18MO8OJSW516v6rOTMO5MCvhPH
=NsY7
-----END PGP SIGNATURE-----

--pQhZXvAqiZgbeUkD--



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