Re: [Qemu-devel] [RFC PATCH 01/36] qapi: generalize documentation of streaming commands

[Kevin Wolf]

Am 12.07.2012 22:41, schrieb Blue Swirl:
> On Thu, Jul 12, 2012 at 8:07 AM, Kevin Wolf <address@hidden> wrote:
>> Am 11.07.2012 18:00, schrieb Paolo Bonzini:
>>> Il 15/06/2012 18:45, Eric Blake ha scritto:
>>>> Pre-existing, but do we have any policy on US (canceled) vs. UK
>>>> (cancelled) spelling?  Obviously, our API spelling is locked into UK
>>>> spelling, but if the docs generally prefer US spelling, do we need to
>>>> adjust things here?  But any such adjustments should be separate
>>>> commits, so no impact to my reviewed-by.
>>>
>>> I had no idea that it was UK vs. US spelling.  I just assumed canceled
>>> was wrong. :)  I would use UK spelling consistently for this word.
>>
>> Both UK and US spellings are widely used within qemu and the advantages
>> of a standardisation on one of them are probably not worth discussions
>> about which one is "better". Whoever writes the code, decides what
>> spelling he uses.
> 
> The code should be written in clear English, but let's standardize the
> variant only after there are no other spelling or grammar errors :).
> 
> But the user visible interface should use only either UK or US
> spelling consistently, the other one should be handled by UI
> localization. Though there probably is no interest to l10n, I can't
> remember anyone ever asking.

Anthony's GTK frontend patches had some localisation (I asked because
otherwise I got mixed German/English menu entries - the standard ones
were translated, the qemu specific ones were English). Not sure what
happened with them, probably not an interesting toy any more.

We may need more localisation if we want the management tools to display
the QMP error descriptions directly to the user.

Kevin