Various improvements; mostly mention arguments of flags by name to

simplify the description and improve lists.

sbin/fsck_ffs/fsck_ffs.8

@@ -1,4 +1,4 @@
-.\"	$NetBSD: fsck_ffs.8,v 1.36 2004/01/09 23:42:11 wiz Exp $
+.\"	$NetBSD: fsck_ffs.8,v 1.37 2004/05/05 14:30:59 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1989, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"	@(#)fsck.8	8.3 (Berkeley) 11/29/94
 .\"
-.Dd January 9, 2004
+.Dd May 5, 2004
 .Dt FSCK_FFS 8
 .Os
 .Sh NAME
@@ -38,8 +38,8 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl adFfpq
-.Op Fl B Ar byte order
-.Op Fl b Ar block#
+.Op Fl B Ar byteorder
+.Op Fl b Ar block
 .Op Fl c Ar level
 .Op Fl m Ar mode
 .Op Fl y | n
@@ -55,7 +55,7 @@ The kernel takes care that only a restricted class of innocuous file system
 inconsistencies can happen unless hardware or software failures intervene.
 These are limited to the following:
 .Pp
-.Bl -item -compact
+.Bl -item -compact -offset indent
 .It
 Unreferenced inodes
 .It
@@ -70,7 +70,8 @@ Counts in the super-block wrong
 .Pp
 These are the only inconsistencies that
 .Nm
-in ``preen''
+in
+.Dq preen
 mode (with the
 .Fl p
 option) will correct; if it encounters other inconsistencies, it exits
@@ -137,13 +138,18 @@ combined.
 .Pp
 The following flags are interpreted by
 .Nm .
-.Bl -tag -width indent
+.Bl -tag -width XBXbyteorderXX -offset indent
 .It Fl a
 Interpret the filesystem as an Apple UFS filesystem, even if
 there is no Apple UFS volume label present.
-.It Fl B
-Convert the file system metadata to the specified byte order if needed.
-Valid byte order are `be' and `le'.
+.It Fl B Ar byteorder
+Convert the file system metadata to
+.Ar byteorder
+byte order if needed.
+Valid byte orders are
+.Dq be
+and
+.Dq le .
 If
 .Nm
 is interrupted while swapping the metadata byte order, the file system cannot
@@ -151,21 +157,23 @@ be recovered.
 .Nm
 will print a message in interactive mode if the file system is not in host
 byte order.
-.It Fl b
-Use the block specified immediately after the flag as
-the super block for the file system.
+.It Fl b Ar block
+Use the block number
+.Ar block
+as the super block for the file system.
 Block 32 is usually an alternative super block.
-.It Fl c
-Convert the file system to the specified level.
+.It Fl c Ar level
+Convert the file system to the level
+.Ar level .
 Note that the level of a file system can only be raised.
-.Bl -tag -width indent
 There are currently four levels defined:
+.Bl -tag -width 3n -offset indent
 .It 0
 The file system is in the old (static table) format.
 .It 1
 The file system is in the new (dynamic table) format.
 .It 2
-The file system supports 32-bit uid's and gid's,
+The file system supports 32-bit UIDs and GIDs,
 short symbolic links are stored in the inode,
 and directories have an added field showing the file type.
 .It 3
@@ -212,9 +220,10 @@ will not check the file system.
 This option forces
 .Nm
 to check the file system, regardless of the state of the clean flag.
-.It Fl m
-Use the mode specified in octal immediately after the flag as the
-permission bits to use when creating the
+.It Fl m Ar mode
+Use the octal value
+.Ar mode
+as the permission bits to use when creating the
 .Pa lost+found
 directory rather than the default 1700.
 In particular, systems that do not wish to have lost files accessible
@@ -228,7 +237,9 @@ except for
 which is assumed to be affirmative;
 do not open the file system for writing.
 .It Fl p
-Specify ``preen'' mode, described above.
+Specify
+.Dq preen
+mode, described above.
 .It Fl q
 Quiet mode, do not output any messages for clean filesystems.
 .It Fl y
@@ -238,8 +249,8 @@ this should be used with great caution as this is a free license
 to continue after essentially unlimited trouble has been encountered.
 .El
 .Pp
-.Bl -enum -offset indent -compact
 Inconsistencies checked are as follows:
+.Bl -enum -offset indent -compact
 .It
 Blocks claimed by more than one inode or the free map.
 .It