[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Improving QOM documentation [Was: Re: Making QEMU easier for managem
From: |
Paolo Bonzini |
Subject: |
Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications] |
Date: |
Fri, 31 Jan 2020 17:28:10 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.1.1 |
On 31/01/20 16:37, Christophe de Dinechin wrote:
>
>
>> On 31 Jan 2020, at 08:46, Paolo Bonzini <address@hidden> wrote:
>>
>> On 31/01/20 07:11, Markus Armbruster wrote:
>>> May I present you Armbru's Comment Trust Levels:
>>>
>>> ACTL2: The comment may be overly terse or incomplete, but the
>>> probability for it to be outright wrong is low.
>>>
>>> ACTL1: Treat as helpful guidance (with gratitude), but trust only the
>>> code.
>>>
>>> ACTL0: It is a tale Told by an idiot[**], full of sound and fury,
>>> Signifying nothing.
>>>
>>> Most comments in decently maintained code are at ACTL1.
>>>
>>> Around the time initial QOM development solidified, object.h's comments
>>> were ACTL2. The neglect that is now clearly visible there makes me
>>> downgrade to ACTL1.
>>>
>>> Paolo will have a more informed and possibly different opinion.
>>
>> I think around initial development it was ACTL3, now it's around 1.8.
>
> Interestingly, the initial doc suggested ACTL to be an whole value between
> 0 and 2. Now it’s fractional and value 3 has a meaning you can guess
> to be “above 2”…
I won't say if this was accidental or not. :
Paolo
> How fast this happened tells you everything you need to know about
> documentation/specifications and actual implementations :-)
- Re: Making QEMU easier for management tools and applications, (continued)
- Re: Making QEMU easier for management tools and applications, Christophe de Dinechin, 2020/01/14
- Re: Making QEMU easier for management tools and applications, Markus Armbruster, 2020/01/15
- Re: Making QEMU easier for management tools and applications, Christophe de Dinechin, 2020/01/15
- Re: Making QEMU easier for management tools and applications, Markus Armbruster, 2020/01/15
- Re: Making QEMU easier for management tools and applications, Daniel P . Berrangé, 2020/01/15
- Re: Making QEMU easier for management tools and applications, Markus Armbruster, 2020/01/15
- Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Kashyap Chamarthy, 2020/01/30
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Markus Armbruster, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Paolo Bonzini, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Christophe de Dinechin, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications],
Paolo Bonzini <=
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Kashyap Chamarthy, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Peter Maydell, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Paolo Bonzini, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Kashyap Chamarthy, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Markus Armbruster, 2020/01/31
- Re: Improving QOM documentation [Was: Re: Making QEMU easier for management tools and applications], Markus Armbruster, 2020/01/31
- Re: Making QEMU easier for management tools and applications, Stefan Hajnoczi, 2020/01/20
- Re: Making QEMU easier for management tools and applications, Markus Armbruster, 2020/01/21
- Re: Making QEMU easier for management tools and applications, Stefan Hajnoczi, 2020/01/21
- Re: Making QEMU easier for management tools and applications, Marc-André Lureau, 2020/01/21