What is the best comment in source code you have ever encountered?
stackoverflow.com
stackoverflow.com
>"Do not purchase this card, even as a joke."
https://elixir.bootlin.com/linux/v3.1/source/drivers/net/3c5...
* You are not expected to understand this.
I find the ultimately misplaced confidence [1] of the comment quietly inspiring, in the context of who wrote it. Even the titans of yesteryear fallaciously convince themselves that, hey, the code works fine, let's get going, and consequently have to bash their heads against some weird quirk they're unintentionally exploiting (and then just rewrite the whole thing).[0] http://catb.org/~esr/jargon/html/Y/You-are-not-expected-to-u...
[1] https://archive.is/eeYMW <- this is the dead hyperlink "explained this in detail" in the Hacker's Dictionary link above
[2] https://en.wikipedia.org/wiki/Lions%27_Commentary_on_UNIX_6t...
> Robert Virding, who developed Erlang with me, was famed for his comment... I think he only... Singular... The entire stuff he wrote had one comment. In the middle of a pattern-matching compiler was a single line that said "And now for the tricky bit"
//When I wrote this, only God and I understood what I was doing //Now, God only knows
/* =========================================
THE BOUNDARY OF SANITY
Behold, stranger!
========================================= *//* DO NOT remove the following line of code */
..followed by a seemingly innocuous line of code, which if removed all hell breaks loose.