你遇到过的源代码中最好的注释是什么?
当前回答
在LKM中:
/*
* Dear Richard Stallman,
*
* This one's for you.
*
* Sincerely,
* Me
*
*/
MODULE_LICENSE( "GPL" );
其他回答
这是我们团队微观管理效果的一个活生生的例子:
// I am not responsible of this code.
// They made me write it, against my will.
．.． 我们敬爱的技术总监很喜欢把代码和编码指南都硬塞到开发人员的喉咙里(*)。
当然，当项目负责人寻找bug的原因时，发现它在“非最佳代码”中，他就不那么高兴了……
(*)当然，我指的是强大的VB国王……如果你想评估强大的VB国王的全部力量，你可以阅读下面的SO帖子:你被迫遵循的最奇怪的编码标准规则是什么?.．.
catch (Domain.ConcurrencyException)
{
// somebody changed it between the time we loaded it and now.
// weird, huh?
}
// Oh crap, i think i'm gonna yack
随后不久又有:
// TODO: end this lunacy
/* Hammer Time! */
我不知道为什么，也不知道他在写代码时是否穿着防撕裂尼龙降落伞裤
这个我在Python 2.5的“twisted”包中找到的(文件是tcp.py在第371行)
# Limit length of buffer to try to send, because some OSes are too
# stupid to do so themselves (ahem windows)
return self.socket.send(buffer(data, 0, self.SEND_LIMIT))
