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)
diff --git a/e2fsck/ChangeLog b/e2fsck/ChangeLog
index 0fc1540..91a73fc 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 df4e6da..385bd29 100644
--- a/e2fsck/e2fsck.8.in
+++ b/e2fsck/e2fsck.8.in
@@ -19,7 +19,7 @@
.I blocksize
]
[
-.B \-l|-L
+.BR \-l | \-L
.I bad_blocks_file
]
[
@@ -32,28 +32,30 @@
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 @@
.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 @@
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 @@
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 @@
.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 @@
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 b5536e1..d7d8379 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 07764f9..cbfdb1a 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 a715a59..78cd6f6 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 3692ed8..e743ecb 100644
--- a/misc/badblocks.8.in
+++ b/misc/badblocks.8.in
@@ -6,11 +6,11 @@
.B badblocks
[
.B \-b
-block-size
+.I block-size
]
[
.B \-o
-output_file
+.I output_file
]
[
.B \-s
@@ -21,45 +21,48 @@
[
.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 5200cda..90e58ab 100644
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -8,11 +8,11 @@
.B \-RV
]
[
-.B -v
-version
+.B \-v
+.I version
]
[
-mode
+.I mode
]
.I files...
.SH DESCRIPTION
@@ -31,16 +31,16 @@
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 1dac7e3..848a33a 100644
--- a/misc/dumpe2fs.8.in
+++ b/misc/dumpe2fs.8.in
@@ -8,50 +8,56 @@
.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 fecb888..2153b33 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 @@
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 c487365..bef29f2 100644
--- a/misc/fsck.8.in
+++ b/misc/fsck.8.in
@@ -21,9 +21,12 @@
.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 @@
\ 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 @@
.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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 f5b683a..97f0ab9 100644
--- a/misc/lsattr.1.in
+++ b/misc/lsattr.1.in
@@ -8,26 +8,26 @@
.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 62725e4..07d8861 100644
--- a/misc/mke2fs.8.in
+++ b/misc/mke2fs.8.in
@@ -11,7 +11,7 @@
.B \-c
|
.\" .B \-t
-.\" test
+.\" .I test
.\" |
.B \-l
.I filename
@@ -47,13 +47,16 @@
.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 @@
.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 @@
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 @@
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 @@
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 3c6b3b4..2cf1be2 100644
--- a/misc/mklost+found.8.in
+++ b/misc/mklost+found.8.in
@@ -10,12 +10,22 @@
.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 73d16fc..bbac87b 100644
--- a/misc/tune2fs.8.in
+++ b/misc/tune2fs.8.in
@@ -8,99 +8,102 @@
.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 @@
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 @@
.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 9c0e4f1..c521a89 100644
--- a/misc/uuidgen.1.in
+++ b/misc/uuidgen.1.in
@@ -11,9 +11,9 @@
.SH SYNOPSIS
.B uuidgen
[
-.B -r
-] [
-.B -t
+.B \-r
+|
+.B \-t
]
.SH DESCRIPTION
The
@@ -30,25 +30,29 @@
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