better wording and cleanup from jmc@

1 files changed, 22 insertions, 19 deletions

diff --git a/sbin/tunefs/tunefs.8 b/sbin/tunefs/tunefs.8
index 351787054ce..9a18eb1674d 100644
--- a/sbin/tunefs/tunefs.8
+++ b/sbin/tunefs/tunefs.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tunefs.8,v 1.23 2007/05/02 14:39:12 otto Exp $	
+.\"	$OpenBSD: tunefs.8,v 1.24 2007/05/02 14:40:28 otto Exp $
 .\"	$NetBSD: tunefs.8,v 1.36 2004/12/20 10:28:47 hubertf Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -38,23 +38,22 @@
 .Nd tune up an existing file system
 .Sh SYNOPSIS
 .Nm
+.Bk -words
 .Op Fl AFN
 .Op Fl e Ar maxbpg
 .Op Fl g Ar avgfilesize
 .Op Fl h Ar avgfpdir
 .Op Fl m Ar minfree
-.Bk -words
 .\" .Op Fl n Ar soft_dependency_enabling
 .Op Fl o Ar optimize_preference
+.Ar special | filesys
 .Ek
-.Ar special | Ar filesys
 .Sh DESCRIPTION
 .Nm
 is designed to change the dynamic parameters of a file system
 which affect the layout policies.
 .Pp
-The following options are supported by
-.Nm :
+The options are as follows:
 .Bl -tag -width Ds
 .It Fl A
 Cause the values to be updated in all the alternate
@@ -68,17 +67,6 @@ will lose anything changed by
 is ignored when
 .Fl N
 is specified.
-.It Fl F
-Indicates that
-.Ar special
-is a file system image, rather than a device name or file system mount point.
-.Ar special
-will be accessed
-.Sq as-is .
-.It Fl N
-Display all the settable options
-(after any changes from the tuning options)
-but do not cause any of them to be changed.
 .It Fl e Ar maxbpg
 This indicates the maximum number of blocks any single file can
 allocate out of a cylinder group before it is forced to begin
@@ -94,6 +82,13 @@ more frequently than if they were allowed to allocate all the blocks
 in a cylinder group before seeking elsewhere.
 For file systems with exclusively large files,
 this parameter should be set higher.
+.It Fl F
+Indicates that
+.Ar special
+is a file system image, rather than a device name or file system mount point.
+.Ar special
+will be accessed
+.Sq as-is .
 .It Fl g Ar avgfilesize
 This specifies the expected average file size.
 .It Fl h Ar avgfpdir
@@ -101,7 +96,7 @@ This specifies the expected number of files per directory.
 .It Fl m Ar minfree
 This value specifies the percentage of space held back
 from normal users; the minimum free space threshold.
-The default value is set during creation of the filesystem, see
+The default value is set during creation of the filesystem; see
 .Xr newfs 8 .
 This value can be set to zero, however up to a factor of three
 in throughput will be lost over the performance obtained at a 5%
@@ -109,14 +104,22 @@ threshold.
 Note that if the value is raised above the current usage level,
 users will be unable to allocate files until enough files have
 been deleted to get under the higher threshold.
+.It Fl N
+Display all the settable options
+(after any changes from the tuning options)
+but do not cause any of them to be changed.
 .It Fl o Ar optimize_preference
 The file system can either try to minimize the time spent
 allocating blocks, or it can attempt to minimize the space
 fragmentation on the disk.
-If the value of minfree (see above) is less than 5%,
+If the value of
+.Ar minfree
+(see above) is less than 5%,
 then the file system should optimize for space to avoid
 running out of full sized blocks.
-For values of minfree greater than or equal to 5%,
+For values of
+.Ar minfree
+greater than or equal to 5%,
 fragmentation is unlikely to be problematical, and
 the file system can be optimized for time.
 .Pp