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

[Kostik Belousov]

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
>   
>   Approved by:	re@ (blackend)
> 
> 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
> 
> Modified: stable/7/share/man/man5/Makefile
> ==============================================================================
> --- 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=	acct.5 \
>  	networks.5 \
>  	nsmb.conf.5 \
>  	nsswitch.conf.5 \
> +	nullfs.5 \
>  	passwd.5 \
>  	pbm.5 \
>  	periodic.conf.5 \
> 
> Copied: stable/7/share/man/man5/nullfs.5 (from r183631, head/share/man/man5/nullfs.5)
> ==============================================================================
> --- /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, copy 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 the
> +.\"    documentation and/or other materials provided with the distribution.
> +.\"
> +.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
> +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
> +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
> +.\" 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 USE 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="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 at 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 ?
-------------- 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-all/attachments/20081204/a56be18f/attachment.pgp