Re: [GIT PULL] ACPI and power management fixes for v3.9-rc1

Linus Torvalds
2013-02-26T16:28:58Z

Ugh. Forgot to actually add the ODD people to the list...

Linus

On Tue, Feb 26, 2013 at 8:27 AM, Linus Torvalds
<torvalds@linux-foundation.org> wrote:
> On Tue, Feb 26, 2013 at 8:10 AM, Nishanth Menon <nm@ti.com> wrote:
>> On 16:55-20130226, Rafael J. Wysocki wrote:
>>>
>>> It says that in "Introduction", but it would be clearer if the title of the
>>> doc was something like "Operating Performance Points (OPP) Library". Nishanth?
>>
>> Yes indeed. Will the following help? I can post it as an official patch
>> if the direction is proper
>
> Yes, this will definitely help. I didn't even find it in the
> introduction (Rafael is correct that it is indeed there), because it's
> hard to see when you don't know what to scan for and it's in a big
> block of text.
>
> I am also happy to note that it is in the Kconfig help and single-line
> description. Which wasn't true for the new SATA_ZPODD ("Zero Power
> ODD" - what the heck is ODD?) which was another new entry I wondered
> about.
>
> It turns out that ODD is an odd TLA for "Optical Disk Drive". I'm sure
> it makes perfect sense if you are a SATA person, but it sure doesn't
> for any normal human being, even otherwise highly technical ones.
>
> Aaron, Tejun, Jeff, can I ask you to also not use specialized TLA's
> without explaining them? Especially in help text and "documentation",
> it's very unhelpful to have TLA's that aren't common.
>
> We don't have to explain *all* TLA's, since there's a lot that really
> are rather widespread. But there's a big difference between something
> like CPU or TLB that have been in generic literature for decades, wrt
> OPP and ODD that are specialized terms used inside a very particular
> group and haven't been around for very long either.
>
> Linus