The best comment I ever saw was in a body-corporate-management suite I maintained for a short while.<p>The comment was at the beginning of a 200 000 line pascal program. It was the only comment in the file.<p>It advised anyone being approached to maintain it to at least double their quote, as the code used 1 and 2 letter names for variables, constants, functions and procedures. It also advised that the same variables were used for multiple purposes, and that maintaining it was a total nightmare.<p>The comment was correct. The only variable name that made any sense was l (el, not one), which always held the current line the cursor was on. I was thrilled when I worked out what l (el) did.<p>-- added clarification due to fonts that make l look like I or 1
Th best code comment story was told by Joe Armstrong " Robert Virding, who developed Erlang with me, was famed for his comment. Singular. The entire stuff he wrote had one comment: in the middle of the pattern-match compiler there was a single line saying ‘and now for the tricky bit".
Two comments which have stuck in my head for decades<p>1. “May the fleas of a 1024 camels infest the armpits of anyone who overflows this buffer.”<p>2. “TODO: this function needs to be spanked.”
The video only shows some cursing comments from the source code. Did anybody find any real discussions of the internals of gtav after the leak that are interessting? Any new modding projects?