你遇到过的源代码中最好的注释是什么?
当前回答
我曾经参与过Windows 3.0的源代码。(我赶紧补充一句，作为一名微软员工，不是!)在那里，我遇到了一个文件加载器，它可以多次重新输入，并且有一个讨厌的双关语的例子(只是为了显示作者有多聪明)。
这些乱七八糟的可重入代码是用Intel程序集jmp指令(在C代码中间)执行的，它的标签是“we_are_not_in_kansas_any_more_toto”。
其他回答
我刚刚完成了一个日志框架(使用Trace，为什么没有这样的存在我不知道)。我做了一个继承自TraceListener的方便基类。它覆盖了所有的TraceListener方法，并将它们路由到一个方法中——因此有很多文档注释:
// TODO: Need some codemonkey to doc comment this class.
// Sorry dirty code
$dnstime = time() + 60 * 60 * 24 * 7 * 2; //how long are you staying for vacation on mars? twooo weeeeeks. give dees people air
/*现在，让所有这些看 半得体的弱智步 哥哥 浏览器家族中的一员，互联网 该死的探险家*/
private int mousycounter = 0; //Not really a counter
