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


当前回答

所有bug由David S. Miller添加

其他回答

我没有亲身经历过这种情况,但这是一个很好的故事(详见我的评论中的解释):

#define MSGTAG_B33R     0x723 /* RIPLVB */
public boolean isDirty() {
    //Why do you always go out and
    return dirty;
}
// This condition can't happen. Call the police or something.
/**
 * If you don't understand this code, you should be flipping burgers instead.
 */

从2004年的Windows泄露事件来看,

__inline BOOL
SearchOneDirectory(
                  IN  LPSTR Directory,
                  IN  LPSTR FileToFind,
                  IN  LPSTR SourceFullName,
                  IN  LPSTR SourceFilePart,
                  OUT PBOOL FoundInTree
                  )
{
    //
    // This was way too slow. Just say we didn't find the file.
    //
    *FoundInTree = FALSE;
    return(TRUE);
}