mke2fs.8.in: Document the -g option. (Addresses Debian bug #188318)

diff --git a/debian/changelog b/debian/changelog
index c856651..7f9bee2 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -7,10 +7,11 @@ e2fsprogs (1.32+1.33-WIP-2003.03.30-3) unstable; urgency=low
   * Add libblkid1-udeb package for the Debian Installer.
   * Use the SS_READLINE_PATH environment variable to control the search
     for a suitable readine library.
-  * Fix bug in mke2fs, which was was incorrectly checking the argument 
+  * Fix bug in mke2fs, which was was incorrectly checking the argument
     to the -g option if the default block size is used.  (Closes: #188319)
+  * Update man pages.  (Addresses Debian bug #188318)
 
- -- Theodore Y. Ts'o <tytso@mit.edu>  Fri, 11 Apr 2003 13:45:18 -0400
+ -- Theodore Y. Ts'o <tytso@mit.edu>  Fri, 11 Apr 2003 13:59:08 -0400
 
 e2fsprogs (1.32+1.33-WIP-2003.03.30-2) unstable; urgency=low
 

diff --git a/misc/ChangeLog b/misc/ChangeLog
index 38372d4..462d94f 100644 (file)
--- a/misc/ChangeLog
+++ b/misc/ChangeLog
@@ -1,5 +1,7 @@
 2003-04-11  Theodore Ts'o  <tytso@mit.edu>
 
+       * mke2fs.8.in: Document the -g option.  (Addresses Debian bug #188318)
+
        * mke2fs.c (PRS): Fix bug where mke2fs was incorrectly checking
                the argument to the -g option, if the default block size
                is used.  (Addresses Debian bug #188319)

diff --git a/misc/mke2fs.8.in b/misc/mke2fs.8.in
index 67ef56e..ea167a4 100644 (file)
--- a/misc/mke2fs.8.in
+++ b/misc/mke2fs.8.in
@@ -22,6 +22,10 @@ mke2fs \- create an ext2/3 filesystem
 .I fragment-size
 ]
 [
+.B \-g
+.I blocks-per-group
+]
+[
 .B \-i
 .I bytes-per-inode
 ]
@@ -157,6 +161,18 @@ Force
 to run, even if the specified device is not a 
 block special device, or appears to be mounted.
 .TP
+.BI \-g " blocks-per-group"
+Specify the number of blocks in a block group.  There is generally no
+reason the user to ever set this parameter, as the default is optimal
+for the filesystem.  (For administrators who are creating
+filesystems on RAID arrays, it is preferable to use the
+.I stride
+RAID parameter as part of the
+.B \-R
+option rather than manipulating the number of blocks per group.)  
+This option is generally used by developers who
+are developing test cases.  
+.TP
 .BI \-i " bytes-per-inode"
 Specify the bytes/inode ratio. 
 .B mke2fs