clean this page up;

1 files changed, 30 insertions, 25 deletions

diff --git a/sbin/newfs_ext2fs/newfs_ext2fs.8 b/sbin/newfs_ext2fs/newfs_ext2fs.8
index 3f84c65cfb7..f88b6810d94 100644
--- a/sbin/newfs_ext2fs/newfs_ext2fs.8
+++ b/sbin/newfs_ext2fs/newfs_ext2fs.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: newfs_ext2fs.8,v 1.1 2010/02/16 08:28:11 otto Exp $
+.\"	$OpenBSD: newfs_ext2fs.8,v 1.2 2010/02/16 19:24:16 jmc Exp $
 .\"	$NetBSD: newfs_ext2fs.8,v 1.7 2009/12/01 08:47:25 pooka Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993, 1994
@@ -35,7 +35,7 @@
 .Os
 .Sh NAME
 .Nm newfs_ext2fs
-.Nd construct a new Ext2 file system
+.Nd construct a new ext2 file system
 .Sh SYNOPSIS
 .Nm
 .Bk -words
@@ -55,7 +55,7 @@
 .Ek
 .Sh DESCRIPTION
 .Nm
-is used to initialize and clear Ext2 file systems before first use.
+is used to initialize and clear ext2 file systems before first use.
 Before running
 .Nm
 the disk must be labeled using
@@ -81,16 +81,17 @@ the corresponding raw device is used.
 .Pp
 Options with numeric arguments may contain an optional (case-insensitive)
 suffix:
+.Pp
 .Bl -tag -width 3n -offset indent -compact
 .It b
 Bytes; causes no modification.
 (Default)
 .It k
-Kilo; multiply the argument by 1024
+Kilo; multiply the argument by 1024.
 .It m
-Mega; multiply the argument by 1048576
+Mega; multiply the argument by 1048576.
 .It g
-Giga; multiply the argument by 1073741824
+Giga; multiply the argument by 1073741824.
 .El
 .Pp
 The following options define the general layout policies.
@@ -104,12 +105,12 @@ The default size depends upon the size of the file system:
 .Bl -tag -width "file system size" -compact -offset indent
 .It Sy "file system size"
 .Ar block-size
-.It \*[Lt]= 512 MB
+.It \*(Lt= 512 MB
 1 KB
-.It \*[Gt] 512 MB
+.It \*(Gt 512 MB
 4 KB
 .El
-.It Fl D
+.It Fl D Ar inodesize
 Set the inode size.
 Defaults to 128, and can also be set to 256 for
 compatibility with ext4.
@@ -121,7 +122,8 @@ The file system size needs to be specified with
 No attempts to use or update the disk label will be made.
 .It Fl f Ar frag-size
 The fragment size of the file system in bytes.
-It must be the same with blocksize because current ext2fs
+It must be the same as the blocksize,
+because the current ext2fs
 implementation doesn't support fragmentation.
 .It Fl I
 Do not require that the file system type listed in the disk label is
@@ -149,19 +151,21 @@ takes precedence.
 The default number of inodes is calculated from a number of blocks in
 the file system.
 .It Fl O Ar filesystem-format
-Select the filesystem-format
+Select the filesystem-format.
+.Pp
 .Bl -tag -width 3n -offset indent -compact
 .It 0
 .Ql GOOD_OLD_REV ;
-This option is primarily used to build root file systems that can be
+this option is primarily used to build root file systems that can be
 understood by old or dumb firmwares for bootstrap.
 (default)
 .It 1
 .Ql DYNAMIC_REV ;
-Various extended (and sometimes incompatible) features are enabled
+various extended (and sometimes incompatible) features are enabled
 (though not all features are supported on
 .Ox ) .
 Currently only the following features are supported:
+.Pp
 .Bl -tag -width "SPARSESUPER" -offset indent -compact
 .It RESIZE
 Prepare some reserved structures which enable future file system resizing.
@@ -199,9 +203,10 @@ is negative the specified size is subtracted from the default size
 (reserving space at the end of the partition).
 .It Fl V Ar verbose
 This controls the amount of information written to stdout:
+.Pp
 .Bl -tag -width 3n -offset indent -compact
 .It 0
-No output
+No output.
 .It 1
 Overall size and cylinder group details.
 .It 2
@@ -212,10 +217,11 @@ progress bar.
 .It 4
 All the super-block backup sector numbers are displayed (no progress bar).
 .El
+.Pp
 The default is 4.
 If
 .Fl N
-is specifed
+is specified
 .Nm
 stops before outputting the progress bar.
 .It Fl v Ar volname
@@ -246,15 +252,15 @@ Defaults to 512.
 .El
 .Sh NOTES
 There is no option to specify the metadata byte order on the file system
-to be created because native Ext2 file system is always little endian
+to be created because the native ext2 file system is always little endian
 even on big endian hosts.
 .Pp
 The file system is created with
 .Sq random
 inode generation numbers to improve NFS security.
 .Pp
-The owner and group ids of the root node and reserved blocks of the new
-file system are set to the effective uid and gid of the user initializing
+The owner and group IDs of the root node and reserved blocks of the new
+file system are set to the effective UID and GID of the user initializing
 the file system.
 .Pp
 For the
@@ -270,9 +276,9 @@ or
 is used.
 .Pp
 The partition size is found using
-.Xr fstat 2
-not by inspecting the disklabel.
-The block size and fragment size will be written back to the disklabel
+.Xr fstat 2 ,
+not by inspecting the disk label.
+The block size and fragment size will be written back to the disk label
 only if the last character of
 .Ar special
 references the same partition as the minor device number.
@@ -286,7 +292,7 @@ references the same partition as the minor device number.
 .Xr fsck_ext2fs 8 ,
 .Xr mount 8 ,
 .Xr mount_ext2fs 8 ,
-.Xr newfs 8 ,
+.Xr newfs 8
 .Rs
 .%A Remy Card
 .%A Theodore Ts'o
@@ -320,7 +326,7 @@ The
 .Nm
 command doesn't support the bad block list accounted by the bad blocks inode.
 .Pp
-Many newer Ext2 file system features (especially journaling) are
+Many newer ext2 file system features (especially journaling) are
 not supported yet.
 .Pp
 Some features in file systems created by the
@@ -331,5 +337,4 @@ utility.
 .Pp
 There is no native tool in the
 .Ox
-distribution for resizing Ext2 file systems yet.
-
+distribution for resizing ext2 file systems yet.