On Tue, Mar 19, 2013 at 3:41 PM, Paul Menzel <span dir="ltr"><<a href="mailto:paulepanter@users.sourceforge.net" target="_blank">paulepanter@users.sourceforge.net</a>></span> wrote:<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

Dear coreboot folks,<br>
<br>
<br>
following up on Ron’s comment to Gerrit item(?) 2695 [1]<br>
<br>
        We can't break out each and every vendor TLA (Three Letter<br>
        Acronym) or we'll be here for years. I understand the possible<br>
        confusion, but at the same time, there are terms of the art that<br>
        we just use, ULT, PCI, DMA, HT, PNP, I2C, being some of them.<br>
        It's a dreadful learning curve, but we all get to climb it :-)<br>
<br>
I propose the following rule (suggestion, guideline) for usage of<br>
abbreviations in commit messages and code.<br></blockquote><div><br></div><div>Programming at the low-level in firmware and drivers often means turning datasheets into functional code, so it is important to use acronyms, mnemonics, and other terminology consistent with vendor-provided documentation. Otherwise searching for a particular value, register name, etc. can be very frustrating.</div>

<div><br></div><div>PDF readers are a few years behind Google in terms of contextual search ;-)</div></div>