Patchwork [2/2] mke2fs: use binary units in the man page

login
register
mail settings
Submitter Lukas Czerner
Date Feb. 2, 2011, 10:43 a.m.
Message ID <1296643439-13908-2-git-send-email-lczerner@redhat.com>
Download mbox | patch
Permalink /patch/81440/
State Superseded
Headers show

Comments

Lukas Czerner - Feb. 2, 2011, 10:43 a.m.
Decimal units (kilobyte 10^3, megabyte 10^6 etc...) were used in
mke2fs manual page, however they was really meant to be binary units
(kibibyte 2^10, mebibyte 2^20 etc...), so change the man pages to
reflect that fact, even if it sounds weird.

Signed-off-by: Lukas Czerner <lczerner@redhat.com>
---
 misc/mke2fs.8.in |   14 +++++++-------
 1 files changed, 7 insertions(+), 7 deletions(-)
Theodore Ts'o - Feb. 7, 2011, 1:01 a.m.
On Wed, Feb 02, 2011 at 11:43:59AM +0100, Lukas Czerner wrote:
> Decimal units (kilobyte 10^3, megabyte 10^6 etc...) were used in
> mke2fs manual page, however they was really meant to be binary units
> (kibibyte 2^10, mebibyte 2^20 etc...), so change the man pages to
> reflect that fact, even if it sounds weird.

Ugh.  Even Don Knuth agrees that the names sound stupid.  (Of course,
his proposal of MMB and GGB haven't really gained much traction,
either.)

I guess I'm willing to tolerate MiB and GiB, but since most people
will ignore the 'i' and pronounce them as "Megabyte" in everyday
speech.  I really don't want to see "mebibyte or tibibytes" spelled
out explicitly anywhere, though.  :-(

And I think KiB is just wierd; I'm much rather see "1024 byte blocks"
than see "1 KiB blocks".

Personally I think the names are doomed.  Even the editors for IEEE
and ANSI journals aren't enforcing this in style guidelines; memory
manufacturers are ignoring the IEC names entirely, and certain most
humans never use those names in every day speech.

       	     	       	     	      	  - Ted
--
To unsubscribe from this list: send the line "unsubscribe linux-ext4" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Lukas Czerner - Feb. 7, 2011, 11:10 a.m.
On Sun, 6 Feb 2011, Ted Ts'o wrote:

> On Wed, Feb 02, 2011 at 11:43:59AM +0100, Lukas Czerner wrote:
> > Decimal units (kilobyte 10^3, megabyte 10^6 etc...) were used in
> > mke2fs manual page, however they was really meant to be binary units
> > (kibibyte 2^10, mebibyte 2^20 etc...), so change the man pages to
> > reflect that fact, even if it sounds weird.
> 
> Ugh.  Even Don Knuth agrees that the names sound stupid.  (Of course,
> his proposal of MMB and GGB haven't really gained much traction,
> either.)
> 
> I guess I'm willing to tolerate MiB and GiB, but since most people
> will ignore the 'i' and pronounce them as "Megabyte" in everyday
> speech.  I really don't want to see "mebibyte or tibibytes" spelled
> out explicitly anywhere, though.  :-(
> 
> And I think KiB is just wierd; I'm much rather see "1024 byte blocks"
> than see "1 KiB blocks".

Hi Ted,

Fail enough, I'll avoid spelling "mebibytes or tebibytes" and use the
abbreviations instead if you insist on it :)

> 
> Personally I think the names are doomed.  Even the editors for IEEE
> and ANSI journals aren't enforcing this in style guidelines; memory
> manufacturers are ignoring the IEC names entirely, and certain most
> humans never use those names in every day speech.
> 
>        	     	       	     	      	  - Ted

-Lukas
--
To unsubscribe from this list: send the line "unsubscribe linux-ext4" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Patch

diff --git a/misc/mke2fs.8.in b/misc/mke2fs.8.in
index b85b9e5..7d8a687 100644
--- a/misc/mke2fs.8.in
+++ b/misc/mke2fs.8.in
@@ -354,9 +354,9 @@  The following journal options are supported:
 .BI size= journal-size
 Create an internal journal (i.e., stored inside the filesystem) of size
 .I journal-size
-megabytes.
+mebibytes.
 The size of the journal must be at least 1024 filesystem blocks
-(i.e., 1MB if using 1k blocks, 4MB if using 4k blocks, etc.)
+(i.e., 1MiB if using 1KiB blocks, 4MiB if using 4KiB blocks, etc.)
 and may be no more than 102,400 filesystem blocks.
 @JDEV@.TP
 @JDEV@.BI device= external-journal
@@ -633,21 +633,21 @@  using a comma separated list.
 If this option is is not specified,
 .B mke2fs
 will pick a single default usage type based on the size of the filesystem to
-be created.  If the filesystem size is less than or equal to 3 megabytes,
+be created.  If the filesystem size is less than or equal to 3 mebibytes,
 .B mke2fs
 will use the filesystem type
 .IR floppy .
 If the filesystem size is greater than 3 but less than or equal to
-512 megabytes,
+512 mebibytes,
 .BR mke2fs (8)
 will use the filesystem type
 .IR small .
-If the filesystem size is greater than or equal to 4 terabytes but less than
-16 terabytes,
+If the filesystem size is greater than or equal to 4 tebibytes but less than
+16 tebibytes,
 .BR mke2fs (8)
 will use the filesystem type
 .IR big .
-If the filesystem size is greater than or equal to 16 terabytes,
+If the filesystem size is greater than or equal to 16 tebibytes,
 .BR mke2fs (8)
 will use the filesystem type
 .IR huge .