Many files:

  badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
  fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
  tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
  	format (bold option flags and italicized variables), as suggested by
  	Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
  e2fsck.8.in: Update man page to use a more standard format (bold
  	option flags and italicized variables), as suggested by Andreas Dilger
  	(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
  uuid_generate.8.in: Update man page to use a more standard format
  	(bold option flags and italicized variables), as suggested by Andreas
  	Dilger (adilger@enel.ucalgary.ca)

15 files changed, 262 insertions, 198 deletions

diff --git a/e2fsck/ChangeLog b/e2fsck/ChangeLog
index 0fc1540e..91a73fc3 100644
--- a/e2fsck/ChangeLog
+++ b/e2fsck/ChangeLog
@@ -1,5 +1,9 @@
 1999-10-21    <tytso@valinux.com>
 
+	* e2fsck.8.in: Update man page to use a more standard format (bold
+		option flags and italicized variables), as suggested by
+		Andreas Dilger (adilger@enel.ucalgary.ca)
+
 	* pass4.c (e2fsck_pass4): If an inode is set in the
 		inode_imagic_map bitmap, don't check to see if it is
 		disconnected from the inode tree (because it almost
diff --git a/e2fsck/e2fsck.8.in b/e2fsck/e2fsck.8.in
index df4e6da6..385bd290 100644
--- a/e2fsck/e2fsck.8.in
+++ b/e2fsck/e2fsck.8.in
@@ -19,7 +19,7 @@ e2fsck \- check a Linux second extended file system
 .I blocksize
 ]
 [
-.B \-l|-L
+.BR \-l | \-L
 .I bad_blocks_file
 ]
 [
@@ -32,28 +32,30 @@ e2fsck \- check a Linux second extended file system
 is used to check a Linux second extended file system.
 .TP
 .I device
-is the special file corresponding to the device (e.g /dev/hdXX).
+is the special file corresponding to the device (e.g
+.IR /dev/hdc1 ).
 .SH OPTIONS
 .TP
-.I -a 
+.B \-a 
 This option does the same thing as the 
-.I -p
+.B \-p
 option.  It is provided for backwards compatibility only; it is
 suggested that people use 
-.I -p 
+.B \-p 
 option whenever possible.
 .TP
-.I -b superblock
+.BI \-b " superblock"
 Instead of using the normal superblock, use an alternative superblock
 specified by 
-.IR superblock .  This option is normally used when the primary superblock 
-has been corrupted; most filesystems have primary superblocks located at 
+.IR superblock .
+This option is normally used when the primary superblock has been
+corrupted; most filesystems have primary superblocks located at 
 blocks 8193, 16385, etc.  If an alternative superblock is specified and 
 the filesystem is not opened read-only, e2fsck will make sure that the
 primary superblock is updated appropriately upon completion of the 
 filesystem check.
 .TP
-.I -B blocksize
+.BI \-B " blocksize"
 Normally, 
 .B e2fsck
 will search for the superblock at various different
@@ -65,7 +67,7 @@ If the superblock is not found,
 .B e2fsck 
 will terminate with a fatal error.
 .TP
-.I -c
+.B \-c
 This option causes 
 .B e2fsck 
 to run the 
@@ -73,7 +75,7 @@ to run the
 program to find any blocks which are bad on the filesystem, 
 and then marks them as bad by adding them to the bad block inode.
 .TP
-.I -C
+.B \-C
 This option causes
 .B e2fsck
 to write completion information to the specified file descriptor 
@@ -86,20 +88,20 @@ If the file descriptor specified is 0,
 will print a completion bar as it goes about its business.  This requires
 that e2fsck is running on a video console or terminal.
 .TP
-.I -d
+.B \-d
 Print debugging output (useless unless you are debugging
 .BR e2fsck ).
 .TP
-.I -f
+.B \-f
 Force checking even if the file system seems clean.
 .TP
-.I -F
+.B \-F
 Flush the filesystem device's buffer caches before beginning.  Only
 really useful for doing 
 .B e2fsck 
 time trials.
 .TP
-.I -l filename
+.BI \-l " filename"
 Add the blocks listed in the file specified by 
 .I filename
 to the list of bad blocks.  The format of this file is the same as the
@@ -107,61 +109,61 @@ one generated by the
 .BR badblocks (8)
 program.
 .TP
-.I -L filename
+.BI \-L " filename"
 Set the bad blocks list to be the list of blocks specified by 
 .IR filename .
 (This option is the same as the 
-.I -l
+.B \-l
 option, except the bad blocks list is cleared before the blocks listed
 in the file are added to the bad blocks list.)
 .TP
-.I -n
-Open the filesystem read-only, and assume an answer of ``no'' to all
+.B \-n
+Open the filesystem read-only, and assume an answer of `no' to all
 questions.  Allows
 .B e2fsck
 to be used non-interactively.  (Note: if the 
-.IR -c ,
-.IR -l ,
+.BR \-c ,
+.BR \-l ,
 or
-.I -L
+.B \-L
 options are specified in addition to the 
-.I -n
+.B \-n
 option, then the filesystem will be opened read-write, to permit the
 bad-blocks list to be updated.  However, no other changes will be made
 to the filesystem.)
 .TP
-.I -p
+.B \-p
 Automatically repair ("preen") the file system without any questions.
 .TP
-.I -r
+.B \-r
 This option does nothing at all; it is provided only for backwards
 compatibility.
 .TP 
-.I -s
+.B \-s
 This option will byte-swap the filesystem so that it is using the normalized, 
 standard byte-order (which is i386 or little endian).  If the filesystem is
 already in the standard byte-order, 
 .B e2fsck 
 will take no action.
 .TP
-.I -S
+.B \-S
 This option will byte-swap the filesystem, regardless of its current 
 byte-order.
 .TP
-.I -t
+.B \-t
 Print timing statistics for
 .BR e2fsck .
 If this option is used twice, additional timing statistics are printed
 on a pass by pass basis.
 .TP
-.I -v
+.B \-v
 Verbose mode.
 .TP
-.I -V
+.B \-V
 Print version information and exit.
 .TP
-.I -y
-Assume an answer of ``yes'' to all questions; allows 
+.B \-y
+Assume an answer of `yes' to all questions; allows 
 .B e2fsck
 to be used non-interactively.
 .SH EXIT CODE
@@ -193,7 +195,7 @@ The following signals have the following effect when sent to
 This signal causes
 .B e2fsck
 to start displaying a completion bar.  (See discussion of the 
-.I -C
+.B \-C
 option.)
 .TP
 .B SIGUSR2
diff --git a/lib/uuid/ChangeLog b/lib/uuid/ChangeLog
index b5536e1f..d7d83790 100644
--- a/lib/uuid/ChangeLog
+++ b/lib/uuid/ChangeLog
@@ -1,3 +1,9 @@
+1999-10-21    <tytso@valinux.com>
+
+	* uuid_generate.8.in: Update man page to use a more standard
+		format (bold option flags and italicized variables), as
+		suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
+
 1999-09-24    <tytso@valinux.com>
 
 	* gen_uuid_nt.c: New file which creates a UUID under Windows NT.
diff --git a/lib/uuid/uuid_generate.3.in b/lib/uuid/uuid_generate.3.in
index 07764f98..cbfdb1a0 100644
--- a/lib/uuid/uuid_generate.3.in
+++ b/lib/uuid/uuid_generate.3.in
@@ -7,7 +7,7 @@
 .\" Created  Wed Mar 10 17:42:12 1999, Andreas Dilger
 .TH UUID_GENERATE 3 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
 .SH NAME
-uuid_generate \- create a new unique UUID value
+uuid_generate, uuid_generate_random, uuid_generate_time \- create a new unique UUID value
 .SH SYNOPSIS
 .nf
 .B #include <uuid/uuid.h>
diff --git a/misc/ChangeLog b/misc/ChangeLog
index a715a596..78cd6f64 100644
--- a/misc/ChangeLog
+++ b/misc/ChangeLog
@@ -1,3 +1,11 @@
+1999-10-21    <tytso@valinux.com>
+
+	* badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
+	  fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
+	  tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
+		format (bold option flags and italicized variables), as
+		suggested by Andreas Dilger (adilger@enel.ucalgary.ca)
+
 1999-10-14    <tytso@valinux.com>
 
 	* tune2fs.c (main): Fix typo (double spaces) in messages regarding
diff --git a/misc/badblocks.8.in b/misc/badblocks.8.in
index 3692ed87..e743ecbf 100644
--- a/misc/badblocks.8.in
+++ b/misc/badblocks.8.in
@@ -6,11 +6,11 @@ badblocks \- search a device for bad blocks
 .B badblocks
 [
 .B \-b
-block-size
+.I block-size
 ]
 [
 .B \-o
-output_file
+.I output_file
 ]
 [
 .B \-s
@@ -21,45 +21,48 @@ output_file
 [
 .B \-w
 ]
-device
-blocks-count [ start-block ]
+.I device
+.IR blocks-count [ start-block ]
 .SH DESCRIPTION
 .B badblocks
 is used to search for bad blocks on a device (usually a disk partition).
-.br
 .I device
-is the special file corresponding to the device (e.g /dev/hdXX).
-.br
+is the special file corresponding to the device (e.g
+.IR /dev/hdc1 ).
 .I blocks-count
 is the number of blocks on the device.
 .SH OPTIONS
 .TP
-.I -b block-size
+.BI \-b " block-size"
 Specify the size of blocks in bytes.
 .TP
-.I -o output_file
+.BI \-o " output_file"
 Write the list of bad blocks to the specified file. Without this option,
 .B badblocks
 displays the list on its standard output.  The format of this file is suitable
-for use by the -l option in 
+for use by the
+.B \-l
+option in 
 .BR e2fsck (8)
 or
 .BR mke2fs (8).
 .TP
-.I -s
+.B \-s
 Show the progress of the scan by writing out the block numbers as they
 are checked.
 .TP
-.I -v
+.B \-v
 Verbose mode.
 .TP
-.I -w
+.B \-w
 Use write-mode test. With this option,
 .B badblocks
 scans for bad blocks by writing some patterns (0xaa, 0x55, 0xff, 0x00) on
 every block of the device, reading every block and comparing the contents.
 .SH WARNING
-Never use the `-w' option on an device containing an existing file system.
+Never use the
+.B \-w
+option on an device containing an existing file system.
 This option erases data!
 .SH AUTHOR
 .B badblocks
diff --git a/misc/chattr.1.in b/misc/chattr.1.in
index 5200cda7..90e58aba 100644
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -8,11 +8,11 @@ chattr \- change file attributes on a Linux second extended file system
 .B \-RV
 ]
 [
-.B -v
-version
+.B \-v
+.I version
 ]
 [
-mode
+.I mode
 ]
 .I files...
 .SH DESCRIPTION
@@ -31,16 +31,16 @@ compressed (c), immutable (i), no dump (d),
 secure deletion (s), and undeletable (u).
 .SH OPTIONS
 .TP
-.I -R
+.B \-R
 Recursively change attributes of directories and their contents.
 Symbolic links encountered during recursive directory traversals are
 ignored.
 .TP
-.I -V
+.B \-V
 Be verbose with chattr's output and print the program version.
 .TP
-.I -v version
-Set the files version.
+.BI \-v " version"
+Set the filesystem version.
 .SH ATTRIBUTES
 When a file with the 'A' attribute set is modified, its atime record is
 not modified.  This avoids a certain amount of disk I/O for laptop
diff --git a/misc/dumpe2fs.8.in b/misc/dumpe2fs.8.in
index 1dac7e3c..848a33a1 100644
--- a/misc/dumpe2fs.8.in
+++ b/misc/dumpe2fs.8.in
@@ -8,50 +8,56 @@ dumpe2fs \- dump filesystem information
 .SH SYNOPSIS
 .B dumpe2fs
 [
-.B -bfhV
+.B \-bfhV
 ]
 [
-.B -ob superblock
+.B \-ob 
+.I superblock
 ]
 [
-.B -oB blocksize
+.B \-oB
+.I blocksize
 ]
-device
+.I device
 .SH DESCRIPTION
-.BI dumpe2fs
+.B dumpe2fs
 prints the super block and blocks group information for the filesystem
 present on
 .I device.
 .PP
-.BI dumpe2fs
+.B dumpe2fs
 is similar to Berkeley's
-.BI dumpfs
+.B dumpfs
 program for the BSD Fast File System.
 .SH OPTIONS
 .TP
-.I -b
+.B \-b
 print the blocks which are reserved as bad in the filesystem.
 .TP
-.I -ob superblock
-use the superblock specifed on the command line when examining the filesystem.
+.BI \-ob " superblock"
+use the block
+.I superblock
+when examining the filesystem.
 This option is not usually needed except by a filesystem wizard who 
 is examining the remains of a very badly corupted filesystem.
 .TP
-.I -oB blocksize
-use the blocksize specified on the command line when examining the filesystem.
+.BI \-oB " blocksize"
+use blocks of
+.I blocksize
+bytes when examining the filesystem.
 This option is not usually needed except by a filesystem wizard who 
 is examining the remains of a very badly corupted filesystem.
 .TP
-.I -f
+.B \-f
 force dumpe2fs to display a filesystem even though it may have some 
 filesystem feature flags which dumpe2fs may not understand (and which
 can cause some of dumpe2fs's display to be suspect).
 .TP 
-.I -h
+.B \-h
 only display the superblock information and not any of the block
 group descriptor detail information.
 .TP
-.I -V
+.B \-V
 print the version number of 
 .B dumpe2fs
 and exit.
diff --git a/misc/e2label.8.in b/misc/e2label.8.in
index fecb8882..2153b338 100644
--- a/misc/e2label.8.in
+++ b/misc/e2label.8.in
@@ -7,12 +7,12 @@
 e2label \- Change the label on an ext2 filesystem
 .SH SYNOPSIS
 .B e2label
-device
+.I device
 [
-new-label
+.I new-label
 ]
 .SH DESCRIPTION
-.BI e2label
+.B e2label
 will display or change the filesystem label on the ext2 filesystem located on
 .I device.  
 .PP
@@ -35,7 +35,7 @@ is longer than 16 characters,
 will truncate it and print a warning message.  
 .PP
 It is also possible to set the filesystem label using the
-.I -L
+.B \-L
 option of 
 .BR tune2fs (8).
 .PP
diff --git a/misc/fsck.8.in b/misc/fsck.8.in
index c487365b..bef29f21 100644
--- a/misc/fsck.8.in
+++ b/misc/fsck.8.in
@@ -21,9 +21,12 @@ fsck \- check and repair a Linux file system
 .B fsck
 is used to check and optionally repair a one or more Linux file systems.  
 .I filesys
-can be a device name (e.g. /dev/hda1, /dev/sdb2), a
-mount point (e.g. /, /usr, /home), or an ext2 label or UUID specifier 
-(e.g., UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd or LABEL=root).  
+can be a device name (e.g.
+.IR /dev/hdc1 ", " /dev/sdb2 ),
+a mount point (e.g.
+.IR / ", " /usr ", " /home ),
+or an ext2 label or UUID specifier (e.g.
+UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd or LABEL=root).  
 The 
 .B fsck 
 program will try to run filesystems on different physical disk drives 
@@ -48,7 +51,7 @@ is the sum of the following conditions:
 \	128\	\-\ Shared library error
 .br
 The exit code returned when all file systems are checked using the
-.B -A
+.B \-A
 option is the bit-wise OR of the exit codes for each
 file system that is checked.
 .PP
@@ -56,13 +59,18 @@ In actuality,
 .B fsck
 is simply a front-end for the various file system checkers
 (\fBfsck\fR.\fIfstype\fR) available under Linux.  The file
-system-specific checker is searched for in /sbin first, then in /etc/fs
-and /etc, and finally in the directories listed in the PATH environment
+system-specific checker is searched for in
+.I /sbin
+first, then in
+.I /etc/fs
+and
+.IR /etc ,
+and finally in the directories listed in the PATH environment
 variable.  Please see the file system-specific checker manual pages for
 further details.
 .SH OPTIONS
 .TP
-.B -s
+.B \-s
 Serialize 
 .B fsck 
 operations.  This is a good idea if you checking multiple
@@ -71,15 +79,14 @@ filesystems and the checkers are in an interactive mode.  (Note:
 runs in an interactive mode by default.  To make 
 .BR e2fsck (8)
 run in a non-interactive mode, you must either specify the
-.B -p
+.B \-p
 or
-.B -a
-option, if you wish for errors to be corrected automatically, or
-the 
-.B -n
+.B \-a
+option, if you wish for errors to be corrected automatically, or the 
+.B \-n
 option if you do not.)
 .TP
-.BI -t \ fstype
+.BI \-t " fstype"
 Specifies the type of file system to be checked.  When the
 .B \-A 
 flag is specified, only filesystems that match 
@@ -87,7 +94,7 @@ flag is specified, only filesystems that match
 are checked.  If 
 .I fstype
 is prefixed with 
-.B no
+.I no
 then only filesystems whose type does not match
 .I fstype
 are checked.
@@ -104,7 +111,7 @@ will use the type specified by the
 option if it specifies a unique filesystem type.  If this type is not
 available, then the default file system type (currently ext2) is used. 
 .TP
-.B -A
+.B \-A
 Walk through the
 .I /etc/fstab
 file and try to check all file systems in one run.  This option is
@@ -114,7 +121,7 @@ system initalization file, instead of multiple commands for checking
 a single file system.
 .sp
 The root filesystem will be checked first unless the
-.B -P
+.B \-P
 option is specified (see below).  After that, 
 filesystems will be checked in the order specified by the 
 .I fs_passno 
@@ -139,17 +146,17 @@ checks running in parallel for some reason --- for example, if the
 machine in question is short on memory so that
 excessive paging is a concern.
 .TP
-.B -C
+.B \-C
 Display completion/progress bars for those filesystems checkers (currently
 only for ext2) which support them.   Fsck will manage the filesystem checkers
 so that only one of them will display a progress bar at a time.
 .TP
-.B -N
+.B \-N
 Don't execute, just show what would be done.
 .TP
-.B -P
+.B \-P
 When the 
-.B -A
+.B \-A
 flag is set, check the root filesystem in parallel with the other filesystems.
 This is not the safest thing in the world to do,
 since if the root filesystem is in doubt things like the 
@@ -158,15 +165,15 @@ executable might be corrupted!  This option is mainly provided
 for those sysadmins who don't want to repartition the root
 filesystem to be small and compact (which is really the right solution).
 .TP
-.B -R
+.B \-R
 When checking all file systems with the
 .B \-A
 flag, skip the root file system (in case it's already mounted read-write).
 .TP
-.B -T
+.B \-T
 Don't show the title on startup.
 .TP
-.B -V
+.B \-V
 Produce verbose output, including all file system-specific commands
 that are executed.
 .TP
@@ -174,7 +181,7 @@ that are executed.
 Any options which are not understood by 
 .BR fsck ,
 or which follow the
-.B --
+.B \-\-
 option are treated as file system-specific options to be passed to the
 file system-specific checker.
 .PP
@@ -182,20 +189,20 @@ Currently, standardized file system-specific options are somewhat in
 flux.  Although not guaranteed, the following options are supported
 by most file system checkers:
 .TP
-.B -a
+.B \-a
 Automatically repair the file system without any questions (use
 this option with caution).  Note that 
 .BR e2fsck (8)
 supports 
-.B -a
+.B \-a
 for backwards compatibility only.  This option is mapped to 
 .BR e2fsck 's
-.B -p
+.B \-p
 option which is safe to use, unlike the 
-.B -a 
+.B \-a 
 option that most file system checkers support.
 .TP
-.B -r
+.B \-r
 Interactively repair the filesystem (ask for confirmations).  Note: It
 is generally a bad idea to use this option if multiple fsck's are being
 run in parallel.  Also note that this is 
diff --git a/misc/lsattr.1.in b/misc/lsattr.1.in
index f5b683a8..97f0ab90 100644
--- a/misc/lsattr.1.in
+++ b/misc/lsattr.1.in
@@ -8,26 +8,26 @@ lsattr \- list file attributes on a Linux second extended file system
 .B \-RVadv
 ]
 [
-files...
+.I files...
 ]
 .SH DESCRIPTION
 .B lsattr
 lists the file attributes on a second extended file system.
 .SH OPTIONS
 .TP
-.I -R
+.B \-R
 Recursively list attributes of directories and their contents.
 .TP
-.I -V
+.B \-V
 Display the program version.
 .TP
-.I -a
+.B \-a
 List all files in directories, including files that start with `.'.
 .TP
-.I -d
+.B \-d
 List directories like other files, rather than listing their contents.
 .TP
-.I -v
+.B \-v
 List the files version.
 .SH AUTHOR
 .B lsattr
diff --git a/misc/mke2fs.8.in b/misc/mke2fs.8.in
index 62725e47..07d88615 100644
--- a/misc/mke2fs.8.in
+++ b/misc/mke2fs.8.in
@@ -11,7 +11,7 @@ mke2fs \- create a Linux second extended file system
 .B \-c
 | 
 .\" .B \-t
-.\" test
+.\" .I test
 .\" |
 .B \-l
 .I filename
@@ -47,13 +47,16 @@ mke2fs \- create a Linux second extended file system
 .B \-q
 ]
 [
-.B \-r fs-revision-level
+.B \-r
+.I fs-revision-level
 ]
 [
-.B -R raid_options
+.B \-R
+.I raid_options
 ]
 [
-.B -s sparse-super-flag
+.B \-s
+.I sparse-super-flag
 ]
 [
 .B \-v
@@ -87,78 +90,84 @@ mke2fs \- create a Linux second extended file system
 .B mke2fs
 is used to create a Linux second extended file system on a device (usually
 a disk partition).
-.br
 .I device
-is the special file corresponding to the device (e.g /dev/hdXX).
-.br
+is the special file corresponding to the device (e.g 
+.IR /dev/hdXX ).
 .I blocks-count
 is the number of blocks on the device.  If omitted,
 .B mke2fs
 automagically figures the file system size.
 .SH OPTIONS
 .TP
-.I -b block-size
+.BI \-b " block-size"
 Specify the size of blocks in bytes.  Valid block size vales are 1024, 
 2048 and 4096 bytes per block.
 .TP
-.I -c
+.B \-c
 Check the device for bad blocks before creating the file system, using a
 fast read-only test.
 .TP
-.I -f fragment-size
+.BI \-f " fragment-size"
 Specify the size of fragments in bytes.
 .TP
-.I -i bytes-per-inode
+.BI \-i " bytes-per-inode"
 Specify the bytes/inode ratio. 
 .B mke2fs
 creates an inode for every
 .I bytes-per-inode
 bytes of space on the disk.  
-The larger the bytes-per-inode ratio, the fewer inodes will be created.
+The larger the 
+.I bytes-per-inode
+ratio, the fewer inodes will be created.
 This value generally shouldn't be smaller than
 the blocksize of the filesystem, since then too many inodes will be made.  
 Be warned that is not possible to expand the number of inodes on a 
 filesystem after it is created, so be careful decided the correct
 value for this parameter. 
 .TP
-.I -n
+.B \-n
 causes mke2fs to not actually create a filesystem, but display what it 
 would do if it were to create a filesystem.
 .TP
-.I -N number-of-inodes
+.BI \-N " number-of-inodes"
 overrides the default calculation of the number of inodes that should be 
 reserved for the filesystem (which is based on the number of blocks and 
-the bytes-per-inode ratio).  This allows the user to specify the number 
+the 
+.I bytes-per-inode
+ratio).  This allows the user to specify the number 
 of desired inodes directly.
 .TP
-.I -l filename
+.BI \-l " filename"
 Read the bad blocks list from
 .I filename.
 \.
 .TP
-.I -m reserved-blocks-percentage
+.BI -m " reserved-blocks-percentage"
 Specify the percentage of reserved blocks for the super-user.  This value
 defaults to 5%.
 .\" .TP
-.\" .I -t test
+.\" .BI \-t " test"
 .\" Check the device for bad blocks before creating the file system
 .\" using the specified test.
 .TP
-.I -o
+.B \-o
 Manually override the default value of the "creator os" field of the 
 filesystem.  Normally the creator field is set by default to the native OS
 of the
 .B mke2fs
 executable.
 .TP
-.I -q
+.B \-q
 Quiet execution.  Useful if 
 .B mke2fs
 is run in a script.
 .TP
-.I -s sparse-super-flag
-If sparse-super-flag is 1, then turn on the sparse superblock flag.  
-If 0, then turn off the sparse superblock flag.  (Currently, the sparse 
+.BI \-s " sparse-super-flag"
+If 
+.I sparse-super-flag
+is 1, then turn on the sparse superblock flag in the superblock.  
+If 0, then turn off the sparse superblock flag in the superblock.  
+(Currently, the sparse 
 superblock flag is off by default if the kernel version is less than 
 2.2; otherwise it defaults to on.)  
 .B Warning:
@@ -167,35 +176,35 @@ support sparse superblocks.  Filesystems that may need to mounted
 on pre-2.2 kernels should not be created with the sparse superblocks 
 feature.
 .TP
-.I -v
+.B \-v
 Verbose execution.
 .TP
-.I -F
+.B \-F
 Force 
 .B mke2fs
 to run, even if the specified device is not a 
 block special device, or appears to be mounted.
 .TP
-.I -L
+.B \-L
 Set the volume label for the filesystem.
 .TP
-.I -M
+.B \-M
 Set the last mounted directory for the filesystem.  This might be useful 
 for the sake of utilities that key off of the last mounted directory to 
 determine where the filesytem should be mounted.
 .TP
-.I -r revision
+.BI -r " revision"
 Set the filesystem revision for the new filesystem.  Note that 1.2
 kernels only support revision 0 filesystems.
 .TP
-.I -R raid_options
+.BI \-R " raid_options"
 Set raid-related options for the filesystem.  Raid options are comma
 separated, and may take an argument using the equals ('=')  sign.
 Currently the only supported argument is 
 .I stride
 which takes as its argument the number of blocks in a RAID stripe.
 .TP
-.I -S
+.B \-S
 Write superblock and group descriptors only.  This is useful if all of
 the superblock and backup superblocks are corrupted, and a last-ditch
 recovery method is desired.  It causes 
@@ -207,12 +216,12 @@ and the block and inode bitmaps.  The
 program should be run immediately after this option is used, and there
 is no guarantee that any data will be salvageable.
 .TP
-.I -T fs-type
+.BI \-T " fs-type"
 Specify how the filesystem is going to be used, so that mke2fs can 
 automatically determine the optimal filesystem parameters.  The only
 filesystem type which is currently supported is "news".
 .TP
-.I -V
+.B \-V
 Print the version number of 
 .B mke2fs
 and exit.
@@ -222,7 +231,9 @@ This version of
 has been written by Theodore Ts'o <tytso@mit.edu>.
 .SH BUGS
 .B mke2fs
-accepts the -f option but currently ignores it because the second
+accepts the
+.B \-f
+option but currently ignores it because the second
 extended file system does not support fragments yet.
 .br
 There may be some other ones.  Please, report them to the author.
diff --git a/misc/mklost+found.8.in b/misc/mklost+found.8.in
index 3c6b3b4d..2cf1be25 100644
--- a/misc/mklost+found.8.in
+++ b/misc/mklost+found.8.in
@@ -10,12 +10,22 @@ second extended file system
 .B mklost+found
 .SH DESCRIPTION
 .B mklost+found
-is used to create a lost+found directory in the current working directory
-on a Linux second extended file system.
-.br
+is used to create a
+.I lost+found
+directory in the current working directory on a Linux second extended
+file system.  There is normally a
+.I lost+found
+directory in the root directory of each filesystem.
+.PP
 .B mklost+found
-pre-allocates disk blocks to the directory to make it usable by
+pre-allocates disk blocks to the
+.I lost+found
+directory so that when
+.BR e2fsck (8)
+is being run to recover a filesystem, it does not need to allocate blocks in
+the filesystem to store a large number of unlinked files.  This ensures that
 .B e2fsck
+will not have to allocate data blocks in the filesystem during recovery.
 .SH OPTIONS
 There are none.
 .SH AUTHOR
diff --git a/misc/tune2fs.8.in b/misc/tune2fs.8.in
index 73d16fca..bbac87bb 100644
--- a/misc/tune2fs.8.in
+++ b/misc/tune2fs.8.in
@@ -8,99 +8,102 @@ tune2fs \- adjust tunable filesystem parameters on second extended filesystems
 .SH SYNOPSIS
 .B tune2fs
 [
-.B -l
+.B \-l
 ]
 [
-.B -c
+.B \-c
 .I max-mount-counts
 ]
 [
-.B -e
+.B \-e
 .I errors-behavior
 ]
 [
-.B -i
+.B \-i
 .I interval-between-checks
 ]
 [
-.B -m
+.B \-m
 .I reserved-blocks-percentage
 ]
 [
-.B -r
+.B \-r
 .I reserved-blocks-count
 ]
 [
-.B -s sparse-super-flag
+.B \-s
+.I sparse-super-flag
 ]
 [
-.B -u
+.B \-u
 .I user
 ]
 [
-.B -g
+.B \-g
 .I group
 ]
 [
-.B -C
+.B \-C
 .I mount-count
 ]
 [
-.B -L
+.B \-L
 .I volume-name
 ]
 [
-.B -M
+.B \-M
 .I last-mounted-directory
 ]
 [
-.B -U
+.B \-U
 .I UUID
 ]
 device
 .SH DESCRIPTION
 .BI tune2fs
 adjusts tunable filesystem parameters on a Linux second extended filesystem.
-.PP
-.B Never use tune2fs to change parameters of a read/write mounted filesystem! 
-.PP
 .SH OPTIONS
 .TP
-.I -c max-mount-counts
+.BI \-c " max-mount-counts"
 adjust the maximal mounts count between two filesystem checks.
 .TP
-.I -e error-behavior
+.BI \-e " error-behavior"
 change the behavior of the kernel code when errors are detected.
 .I error-behavior
 can be one of the following:
 .br
 \	continue\	\	Continue normal execution.
 .br
-\	remount-ro\	Remount the filesystem read-only.
+\	remount-ro\	Remount filesystem read-only.
 .br
 \	panic\	\	Cause a kernel panic.
 .TP
-.I -g group
+.BI \-g " group"
 set the user group which can benefit from the reserved blocks.
 .br
 .I group
 can be a numerical gid or a group name.
 .TP
-.I -i interval-between-checks[d|m|w]
+.BI \-i " interval-between-checks\fR[\fBd\fR|\fBm\fR|\fBw\fR]"
 adjust the maximal time between two filesystem checks. 
-No postfix or `d' result in days, `m' in months, and `w' in weeks.
-A value of zero will disable the timedependent checking.
+No postfix or
+.B d
+result in days,
+.B m
+in months, and
+.B w
+in weeks.  A value of zero will disable the timedependent checking.
 .TP
-.I -l
+.B \-l
 list the contents of the filesystem superblock.
 .TP
-.I -m reserved-blocks-percentage
+.BI \-m " reserved-blocks-percentage"
 adjust the reserved blocks percentage on the given device.
 .TP
-.I -r reserved-blocks-count
+.BI \-r " reserved-blocks-count"
 adjust the reserved blocks count on the given device.
 .TP
-.I -s sparse_super_flag
+.BI \-s " sparse_super_flag"
 set or reset the sparse_superblock flag.  The sparse_superblock feature
 saves space on really big filesystems.
 .B Warning:
@@ -108,15 +111,15 @@ The Linux 2.0 kernel does not properly support this feature.  Neither do
 all Linux 2.1 kernels; please don't use this unless you know what you're
 doing!
 .TP
-.I -u user
+.BI \-u " user"
 set the user who can benefit from the reserved blocks.
 .I user
 can be a numerical uid or a user name.
 .TP
-.I -C mount-count
+.BI \-C " mount-count"
 set the number of times the filesystem has been mounted.
 .TP
-.I -L volume-label
+.BI \-L " volume-label"
 set the volume label of the filesystem.  
 Ext2 filesystem labels can be at most 16 characters long; if
 .I volume-label 
@@ -124,30 +127,30 @@ is longer than 16 characters,
 .B tune2fs
 will truncate it and print a warning message.  
 .TP
-.I -M last-mounted-directory
+.BI \-M " last-mounted-directory"
 set the last-mounted directory for the filesystem.
 .TP
-.I -U UUID
+.BI \-U " UUID"
 set the UUID of the filesystem.  A sample UUID looks like this: 
-"c1b9d5a2-f162-11cf-9ece-0020afc76f16".  The uuid may also be "null", 
-which will set the filesystem UUID to the null UUID.  The uuid may also 
-be "random", which will generate a new random UUID for the filesystem.
-.PP
+"c1b9d5a2-f162-11cf-9ece-0020afc76f16".  The uuid may also be
+.IR null ,
+which will set the filesystem UUID to the null UUID.  The uuid may also be
+.IR random ,
+which will generate a new random UUID for the filesystem.
 .SH BUGS
 We haven't found any bugs yet. Perhaps there are bugs but it's unlikely.
-.PP
 .SH WARNING
-.B Use this utility at your own risk. You're modifying a filesystem!
+Never use tune2fs to change parameters of a read/write mounted filesystem!
+.B Use this utility
+.B at your own risk.
+You're modifying a filesystem!
 .SH AUTHOR
 .B tune2fs 
 was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
 of the ext2 fs.
-.br
 .B tune2fs
 uses the ext2fs library written by Theodore Ts'o <tytso@mit.edu>.
-.br
 This manual page was written by Christian Kuhtz <chk@data-hh.Hanse.DE>.
-.br
 Timedependent checking was added by Uwe Ohse <uwe@tirka.gun.de>.
 .SH AVAILABILITY
 .B tune2fs
diff --git a/misc/uuidgen.1.in b/misc/uuidgen.1.in
index 9c0e4f1a..c521a89d 100644
--- a/misc/uuidgen.1.in
+++ b/misc/uuidgen.1.in
@@ -11,9 +11,9 @@ uuidgen \- command\-line utility to create a new UUID value
 .SH SYNOPSIS
 .B uuidgen 
 [
-.B -r
-] [
-.B -t
+.B \-r
+|
+.B \-t
 ]
 .SH DESCRIPTION
 The
@@ -30,25 +30,29 @@ There are two types of UUID's which
 can generate: time-based UUID's and random-based UUID's.  By 
 default 
 .B uuidgen
-will generatea random-based UUID if a high-quality random number
+will generate a random-based UUID if a high-quality random number
 generator is present.  Otherwise, it will chose a time-based UUID.  It 
 is possible to force the generation of one of these two 
 UUID types by using the
-.IR -r " or " -t " options."
-.SH "OPTIONS"
+.B \-r
+or
+.B \-t
+options.
+.SH OPTIONS
 .TP
-.I -r
+.B \-r
 Generate a random-based UUID.  This method creates a UUID consisting mostly
 of random bits.  It requires that the operating system have a high
-quality random number generator, such as /dev/random.
+quality random number generator, such as
+.IR /dev/random .
 .TP
-.I -t
+.B \-t
 Generate a time-based UUID.  This method creates a UUID based on the system 
 clock plus the system's ethernet hardware address, if present.
 .SH RETURN VALUE
-The UUID of the form 1b4e28ba\-2fa1\-11d2\-883f\-b9a761bde3fb (in
+The UUID of the form 1b4e28ba-2fa1-11d2-883f-b9a761bde3fb (in
 .BR printf (3)
-format "%08x\-%04x\-%04x\-%04x\-%012x") is output to the standard output.
+format "%08x-%04x-%04x-%04x-%012x") is output to the standard output.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR