<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Hi Joe,<div><br><div><div>On Mar 9, 2013, at 10:17 PM, Joe Armstrong <<a href="mailto:erlang@gmail.com">erlang@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><span style="font-family: Helvetica; font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; display: inline !important; float: none; ">I try to use very short variable names. In my mind variable names carry [N]o meaning. I'm very very fussy about extremely accurate function names. If a function says do_this_and_that it should do exactly this_and_that and not something else. </span></blockquote></div><br><div>yes, the obligatory complement to the Short Variable Names Church are speaking function names!</div><div><br></div><div>But in my experience, sadly, they do not render unnecessary the comment explanations for the variables. I wish.</div><div><br></div><div>(Not that Joe said anything remotely like that.)</div><div><br></div><div><div>> Comments should be repaired with the same lova and care as code. Without</div><div>> spelling and punctuation errors. If I see a typo in a comment []</div></div><div><br></div><div>I'll add block justification. I like my comments justified. Really freaks some serious people out though.</div><div><br></div><div>But the reality is that most code will not get to that point.</div><div><br></div><div>What I am looking for on the practical side is a standardized, fast-to-read way to explain the one-letter variables, across repeat variants of functions and useful for edocs.</div><div><br></div><div>Henning</div><div><br></div></div></body></html>