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

当前回答

在20世纪80年代早期的某个时候，我们在PL/I中为公用事业编写财务建模代码。接到一个客户的电话，说代码在评论之后就爆炸了

/* Honest this works */

这家伙用了我们的标准金融方程花了大约15页的代数把一堆代码组合成一个方程。在三里岛事件后，当公用事业公司不得不以巨大的代价注销他们的核电站时，这个方程失败了，因为FIXED BIN 15(整数)溢出，如果代数没有发生，就不会发生这种溢出。

其他回答

// This condition can't happen. Call the police or something.

//I am not sure why this works but it fixes the problem.

这是之前的一组代码，技术上确实解决了问题，它的意思是，但打破了其他3个东西....

来自一个显然在看巨蟒剧团的小伙子:

> //现在，for something完全 > // different: 类theLarch {

在一个名为“Bar”的类中(这是一个不具有描述性名称的UI控件)，类头文件:

/// <summary>I pity the "foo".</summary>

Remove()方法:

/// <summary>A "foo" and his money are soon parted.</summary>

更糟糕的是，业务合作伙伴从生成的文档中指出了这一点。更糟糕的是，这些可能是我们从那家伙那里得到的最接近有用文件的东西。

  mov si, pCard      ; captain?

推荐文章