>Number:         16193
>Category:       misc
>Synopsis:       MFS Examples: newfs(8) v.s. mount(8)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Apr 03 22:48:00 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Brian A. Seklecki
>Release:        NetBSD 1.5.3_RC1
>Organization:
>Environment:
System: NetBSD hurt 1.5.3_RC1 NetBSD 1.5.3_RC1 (HURT) #0: Thu Mar 28 16:56:48 EST 2002 root@hurt:/usr/src/sys/sys/arch/sparc/compile/HURT sparc
Architecture: sparc
Machine: sparc
>Description:
	The man page for mount_mfs (which is actually newfs(8)) doesn't have an example
	section.  Mount(8) has one, but the example is wrong and isn't in the example section. 
>How-To-Repeat:
	Decide to MFS mount /tmp for the first time
	Examine the newfs/mount_mfs man page
	Wonder why there isn't an 'example' section (MFS has been around since 4.4BSD)
	Revert to examples from Google/NetBSD mailing list archives
	Realize later that mount(8) has an example but the 'special' device doesn't exist
>Fix:
	Patch for:
	./basesrc/sbin/mount/mount.8:

	--- mount.8.orig	Thu Apr  4 01:15:13 2002
	+++ mount.8	Thu Apr  4 01:31:12 2002
	@@ -220,14 +220,14 @@
	 Options that take a value are specified using the syntax -option=value.
	 For example, the mount command:
	 .Bd -literal -offset indent
	-mount -t mfs -o nosuid,-N,-s=4000 /dev/dk0b /tmp
	+mount -t mfs -o nosuid,-N,-s=32m /dev/rsd0a /tmp
	 .Ed
	 .Pp
	 causes
	 .Nm
	 to execute the equivalent of:
	 .Bd -literal -offset indent
	-/sbin/mount_mfs -o nosuid -N -s 4000 /dev/dk0b /tmp
	+/sbin/mount_mfs -o nosuid -N -s 32m /dev/rsd0a /tmp
	 .Ed
	 .It Fl r
	 The file system is to be mounted read-only.
	@@ -332,6 +332,9 @@
	 .It Tn NFS
	 .br
	 mount nfs-server-host:/directory/path /mount-point
	+.It Tn MFS (32 megabyte)
	+.br
	+mount -t mfs -o nosuid,-N,-s=32m /dev/rsd0a /tmp
	 .El
	 .Pp
	 The "noauto" directive in

	Patch for:
	./basesrc/sbin/newfs/newfs.8:

	--- newfs.8.orig        Thu Apr  4 01:35:09 2002
	+++ newfs.8     Thu Apr  4 01:32:56 2002
	@@ -291,6 +291,9 @@
	 .Xr mount 8
	 man page for possible options and their meanings.
	 .El
	+.Sh EXAMPLES
	+See mount(8) for examples on how to use 
	+.Nm mount_mfs.
	 .Sh NOTES
	 If the file system will be exported over NFS, the
	 .Xr fsirand 8

>Release-Note:
>Audit-Trail:
>Unformatted: