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


当前回答

从泄露的Win2K源代码:

//这次黑客入侵的规模堪比国家债务的规模。

其他回答

i++; // increment variable i
// TODO - Comment this function

在头文件的顶部:

/* Project : XYZ (Please somebody shoot me!)
 *
 * File : $Id: defs.h,v 1.1 $
 *
 * Purpose : Create havoc rather than peace among many nations
 *
 * History : Back-ported changes that were not in CVS.  Please somebody,
 *  shoot us and put us all out of our misery.
 */

“XYZ项目”(已改名)是一个长达七年的折磨。最后这句话是由一个从头到尾都参与其中的坚定的灵魂写的。

在被迫为贫血域对象编写单元测试时,这些对象不过是getter和setter的包(我也是被迫写的):

// zzzzZZZZzzzz....

简单但有效的注释,在一些不太安全的c++代码之前

// yikes