From: Theodore Ts'o <tytso@mit.edu>
Date: Fri, 11 Apr 2003 18:00:53 +0000 (-0400)
Subject: mke2fs.8.in: Document the -g option.  (Addresses Debian bug #188318)
X-Git-Tag: android-x86-6.0-r1~26^2~2501
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=5e05541ad0df4506eec324d98262c25d2e4e0d8d;p=android-x86%2Fexternal-e2fsprogs.git

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

diff --git a/debian/changelog b/debian/changelog
index c8566518..7f9bee2a 100644
--- 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 38372d47..462d94ff 100644
--- 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 67ef56e3..ea167a48 100644
--- 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