Messages in this thread | | | Date | Tue, 26 Feb 2013 08:27:59 -0800 | Subject | Re: [GIT PULL] ACPI and power management fixes for v3.9-rc1 | From | Linus Torvalds <> |
| |
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
| |