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


当前回答

Tweet tweet = (Tweet) tweets.get(i); // Poetic.

其他回答

// TODO - Comment this function

消毒:

//Forward declarations:

class X {}; // TODO: Remove {}  ! When we get X defined....
// For the sins I am about to commit, may James Gosling forgive me

在为一家芬兰移动网络设备制造商工作期间,我深入研究了硬件抽象层,发现芬兰语单词“puukko”出现了100多次。

“puukko”是一种万能刀,每个芬兰人的工具箱里或家里都有。它被用于从剥土豆到电脑维修(我的观察)的所有事情。我相信在这个语境中,它相当于芬兰语中的“Hack”。

我的芬兰同事否认了这一点,并说这更像是“外科手术/干预”……我差点就相信了,直到我看到下面的评论:

/* Perkele ISO Puukko! */ -> Fucking Big Hack!

下面是一个必须声明的局部变量,只是为了将一个常量传递给库函数:

// This only exists because Scott doesn't know how to use const correctly