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


当前回答

我最喜欢的是已故的Paul DiLascia:

//作者:如果这段代码工作,它是由Paul DiLascia写的。如果不是,我就不知道是谁写的了。

其他回答

刚刚在一些Actionscript中发现了这个,我必须更新…

/*
* spaghetty code in this module.
* hardcoded variables for load paths for the content window.
* Needs (vast) improvement.
*/

..大:(

在1983年的COBOL中见过:

   C   I don't know what this next bit does so I'll jump around it
       GOTO DONE.
-- Beyond this point, there'll be dragons

我觉得更长的说法^^更能说明问题

aComment = 'this is not aComment' # this is aComment
class T(object):
    def f(this):
        this is not aComment

一个可怕的解码补丁(意大利语翻译):

/**
*@return the value 
*@param key: the id of the list of instruments
*@PS this function is a violation of all the laws of the 
*software engineering, 
*commons sense, highway code 
*and ONU decision about the coding.
That sh*t...
*/