Re: [Xen-devel] [PATCH DOCDAY] improve documentation of Xen command line paramters

[George Dunlap <George.Dunlap@xxxxxxxxxxxxx>]

On Tue, Jul 31, 2012 at 10:26 AM, George Dunlap
<George.Dunlap@xxxxxxxxxxxxx> wrote:
> On Mon, Jul 30, 2012 at 8:06 PM, Matt Wilson <msw@xxxxxxxxxx> wrote:
>> This change improves documentation for several Xen command line
>> parameters. Some of the Itanium-specific options are now removed. A
>> more thorough check should be performed to remove any other remnants.
>>
>> I've reformatted some of the entries to fit in 80 column terminals.
>>
>> Options that are yet undocumented but accept standard boolean /
>> integer values are now annotated as such.
>>
>> The size suffixes have been corrected to use the binary prefixes
>> instead of decimal prefixes.
>>
>> Signed-off-by: Matt Wilson <msw@xxxxxxxxxx>
>>
>> diff -r bf922651da96 -r c3a6e679bdfa docs/misc/xen-command-line.markdown
>> --- a/docs/misc/xen-command-line.markdown       Sat Jul 28 17:27:30 2012 
>> +0000
>> +++ b/docs/misc/xen-command-line.markdown       Mon Jul 30 19:04:59 2012 
>> +0000
>> @@ -46,9 +46,9 @@ if a leading `0` is present.
>>
>>  A size parameter may be any integer, with a size suffix
>>
>> -* `G` or `g`: Giga (2^30)
>> -* `M` or `m`: Mega (2^20)
>> -* `K` or `k`: Kilo (2^10)
>> +* `G` or `g`: Gibi (2^30)
>> +* `M` or `m`: Mibi (2^20)
>> +* `K` or `k`: Kibi (2^10)
>>  * `B` or `b`: Bytes
>
> Can I strongly object to this part of the patch? I realize that the
> "bi" is an international standard; however, it's a completely stupid
> one, and the people who came up with it are completely brain-dead.
> All of them sound silly; and "mebibyte" has three bilabial consontants
> in a row and is completely unpronouncable.
>
> When standards organizations try to make standards that are worse than
> useless, I think we have a duty to ignore them. :-)

I would be happy with GiB, MiB, and KiB, instead of Gibi, Mibi, and
Kibi.  Making the distinction between powers of 2 and powers of 10
makes sense; it's just the particular pronunciation that I object to.
:-)

 -George

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel