你遇到过的源代码中最好的注释是什么?


当前回答

/* This is O(scary), but seems quick enough in practice. */ 

后面是四个嵌套的for循环

其他回答

我刚刚完成了一个日志框架(使用Trace,为什么没有这样的存在我不知道)。我做了一个继承自TraceListener的方便基类。它覆盖了所有的TraceListener方法,并将它们路由到一个方法中——因此有很多文档注释:

// TODO: Need some codemonkey to doc comment this class.

在js代码中:

// hack for ie browser (assuming that ie is a browser)

这是在PHP代码中找到的

$s=2; // chicken and bacon wrap for lunch

多么有用,幸运的是$s是不言自明的

// TODO - Comment this function