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

[George Dunlap <George.Dunlap@xxxxxxxxxxxxx>]

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. :-)

 -George

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