[src/trunk]: src/usr.sbin/makefs Remove unnecessary keeps (Bk/Ek). Sort optio...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/04e79850c245
branches:  trunk
changeset: 584141:04e79850c245
user:      wiz <wiz%NetBSD.org@localhost>
date:      Fri Sep 09 22:23:49 2005 +0000

description:
Remove unnecessary keeps (Bk/Ek). Sort options. Various minor fixes.
Bump date.

diffstat:

 usr.sbin/makefs/makefs.8 |  223 ++++++++++++++++++++++------------------------
 1 files changed, 106 insertions(+), 117 deletions(-)

diffs (truncated from 356 to 300 lines):

diff -r 2460a9030deb -r 04e79850c245 usr.sbin/makefs/makefs.8
--- a/usr.sbin/makefs/makefs.8  Fri Sep 09 22:04:09 2005 +0000
+++ b/usr.sbin/makefs/makefs.8  Fri Sep 09 22:23:49 2005 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: makefs.8,v 1.16 2005/08/13 02:03:48 fvdl Exp $
+.\"    $NetBSD: makefs.8,v 1.17 2005/09/09 22:23:49 wiz Exp $
 .\"
 .\" Copyright (c) 2001-2003 Wasabi Systems, Inc.
 .\" All rights reserved.
@@ -33,7 +33,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 11, 2005
+.Dd September 9, 2005
 .Dt MAKEFS 8
 .Os
 .Sh NAME
@@ -41,43 +41,19 @@
 .Nd create a file system image from a directory tree
 .Sh SYNOPSIS
 .Nm
-.Bk -words
-.Op Fl t Ar fs-type
-.Ek
-.Bk -words
-.Op Fl o Ar fs-options
-.Ek
-.Bk -words
+.Op Fl x
+.Op Fl B Ar byte-order
+.Op Fl b Ar free-blocks
 .Op Fl d Ar debug-mask
-.Ek
-.Bk -words
-.Op Fl B Ar byte-order
-.Ek
-.Bk -words
-.Op Fl S Ar sector-size
-.Ek
-.Bk -words
+.Op Fl F Ar specfile
+.Op Fl f Ar free-files
 .Op Fl M Ar minimum-size
-.Ek
-.Bk -words
 .Op Fl m Ar maximum-size
-.Ek
-.Bk -words
+.Op Fl N Ar userdb-dir
+.Op Fl o Ar fs-options
+.Op Fl S Ar sector-size
 .Op Fl s Ar image-size
-.Ek
-.Bk -words
-.Op Fl b Ar free-blocks
-.Ek
-.Bk -words
-.Op Fl f Ar free-files
-.Ek
-.Bk -words
-.Op Fl F Ar specfile
-.Ek
-.Op Fl x
-.Bk -words
-.Op Fl N Ar userdb-dir
-.Ek
+.Op Fl t Ar fs-type
 .Ar image-file
 .Ar directory
 .Sh DESCRIPTION
@@ -91,58 +67,22 @@
 .Pp
 The options are as follows:
 .Bl -tag -width flag
-.It Fl t Ar fs-type
-Create an
-.Ar fs-type
-file system image.
-The following file system types are supported:
-.Bl -tag -width cd9660 -offset indent
-.It Sy ffs
-BSD fast file system (default).
-.It Sy cd9660
-ISO 9660 file system.
-.El
-.It Fl o Ar fs-options
-Set file system specific options.
-.Ar fs-options
-is a comma separated list of options.
-Valid file system specific options are detailed below.
-.It Fl d Ar debug-mask
-Enable various levels of debugging, depending upon which bits are set
-in
-.Ar debug-mask .
-XXX: document these
 .It Fl B Ar byte-order
 Set the byte order of the image to
 .Ar byte-order .
 Valid byte orders are
 .Ql 4321 ,
-.Ql big
+.Ql big ,
 or
 .Ql be
 for big endian, and
 .Ql 1234 ,
-.Ql little
+.Ql little ,
 or
 .Ql le
 for little endian.
 Some file systems may have a fixed byte order; in those cases this
 argument will be ignored.
-.It Fl S Ar sector-size
-Set the file system sector size to
-.Ar sector-size .
-Defaults to 512.
-.It Fl M Ar minimum-size
-Set the minimum size of the file system image to
-.Ar minimum-size .
-.It Fl m Ar maximum-size
-Set the maximum size of the file system image to
-.Ar maximum-size .
-An error will be raised if the target file system needs to be larger
-than this to accommodate the provided directory tree.
-.It Fl s Ar image-size
-Set the size of the file system image to
-.Ar image-size .
 .It Fl b Ar free-blocks
 Ensure that a minimum of
 .Ar free-blocks
@@ -152,15 +92,11 @@
 suffix may be provided to indicate that
 .Ar free-blocks
 indicates a percentage of the calculated image size.
-.It Fl f Ar free-files
-Ensure that a minimum of
-.Ar free-files
-free files (inodes) exist in the image.
-An optional
-.Ql %
-suffix may be provided to indicate that
-.Ar free-files
-indicates a percentage of the calculated image size.
+.It Fl d Ar debug-mask
+Enable various levels of debugging, depending upon which bits are
+set in
+.Ar debug-mask .
+XXX: document these
 .It Fl F Ar specfile
 Use
 .Ar specfile
@@ -169,23 +105,23 @@
 .Sq specfile
 specification.
 .Pp
-If a specfile entry exists in the underlying file system, its permissions and
-modification time will be used unless specifically overridden by the specfile.
-An error will be raised if the type of entry in the specfile conflicts
-with that of an existing entry.
+If a specfile entry exists in the underlying file system, its
+permissions and modification time will be used unless specifically
+overridden by the specfile.
+An error will be raised if the type of entry in the specfile
+conflicts with that of an existing entry.
 .Pp
-In the opposite case
-(where a specfile entry does not have an entry in the underlying file system)
-the following occurs:
+In the opposite case (where a specfile entry does not have an entry
+in the underlying file system) the following occurs:
 If the specfile entry is marked
 .Sy optional ,
 the specfile entry is ignored.
-Otherwise, the entry will be created in the image,
-and it is necessary to specify at least the following parameters
-in the specfile:
+Otherwise, the entry will be created in the image, and it is
+necessary to specify at least the following parameters in the
+specfile:
 .Sy type ,
 .Sy mode ,
-.Sy gname
+.Sy gname ,
 or
 .Sy gid ,
 and
@@ -203,8 +139,23 @@
 .Sy flags
 isn't provided, the current file flags will be used.
 Missing regular file entries will be created as zero-length files.
-.It Fl x
-Exclude file system nodes not explcitly listed in the specfile.
+.It Fl f Ar free-files
+Ensure that a minimum of
+.Ar free-files
+free files (inodes) exist in the image.
+An optional
+.Ql %
+suffix may be provided to indicate that
+.Ar free-files
+indicates a percentage of the calculated image size.
+.It Fl M Ar minimum-size
+Set the minimum size of the file system image to
+.Ar minimum-size .
+.It Fl m Ar maximum-size
+Set the maximum size of the file system image to
+.Ar maximum-size .
+An error will be raised if the target file system needs to be larger
+than this to accommodate the provided directory tree.
 .It Fl N Ar dbdir
 Use the user database text file
 .Pa master.passwd
@@ -217,6 +168,32 @@
 and
 .Xr getgrnam 3
 (and related) library calls.
+.It Fl o Ar fs-options
+Set file system specific options.
+.Ar fs-options
+is a comma separated list of options.
+Valid file system specific options are detailed below.
+.It Fl S Ar sector-size
+Set the file system sector size to
+.Ar sector-size .
+.\" XXX: next line also true for cd9660?
+Defaults to 512.
+.It Fl s Ar image-size
+Set the size of the file system image to
+.Ar image-size .
+.It Fl t Ar fs-type
+Create an
+.Ar fs-type
+file system image.
+The following file system types are supported:
+.Bl -tag -width cd9660 -offset indent
+.It Sy ffs
+BSD fast file system (default).
+.It Sy cd9660
+ISO 9660 file system.
+.El
+.It Fl x
+Exclude file system nodes not explcitly listed in the specfile.
 .El
 .Pp
 Where sizes are specified, a decimal number of bytes is expected.
@@ -243,7 +220,7 @@
 .Ss FFS-specific options
 .Sy ffs
 images have ffs-specific optional parameters that may be provided.
-Each of the options consists of a keyword, an equals sign
+Each of the options consists of a keyword, an equal sign
 .Pq Ql = ,
 and a value.
 The following keywords are supported:
@@ -277,60 +254,67 @@
 .El
 .Ss CD9660-specific options
 .Sy cd9660
-images have ISO9660-specific optional parameters that may be provided.
-The arguments consist of a keyword and, optionally, an equals sign
+images have ISO9660-specific optional parameters that may be
+provided.
+The arguments consist of a keyword and, optionally, an equal sign
 .Pq Ql = ,
 and a value.
 The following keywords are supported:
 .Pp
 .Bl -tag -width omit-trailing-period -offset indent -compact
 .It Sy allow-deep-trees
-Allow the directory structure to exceed the maximum specified in the spec.
+Allow the directory structure to exceed the maximum specified in
+the spec.
 .\" .It Sy allow-illegal-chars
 .\" Unknown
 .\" .It Sy allow-lowercase
 .\" Unknown
 .It Sy allow-max-name
-Allow 37 instead of 33 characters for filenames by omitting the version id.
+Allow 37 instead of 33 characters for filenames by omitting the
+version id.
 .It Sy allow-multidot
 Allow multiple dots in a filename.
 .It Sy applicationid
-Application ID of the image
+Application ID of the image.
 .It Sy boot-load-segment
 Set load segment for the boot image.
 .It Sy boot-load-size
-Set numbers of load sectors for the booot image.
+Set numbers of load sectors for the boot image.
 .It Sy bootimage
-Filename of a boot image in the format sysid;filename, where sysid is one
-of
-.Ql x86
-,
-.Ql mac
+Filename of a boot image in the format
+.Dq sysid;filename ,