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


当前回答

  rescue
    # silently, we fail
    # many validations fade
    # like tear drops in rain
  end

这只是众多案例中的一个……

其他回答

<!-- Here it is -->

没有其他评论了。直到今天我都不知道“它”是什么。

消毒:

//Forward declarations:

class X {}; // TODO: Remove {}  ! When we get X defined....

我看到有人对代码的评论:

// This comment is self explanatory.

我猜他是想说“可变的”,但这个错误造成了一个有趣的评论……想想这里的循环逻辑,以及写它的徒劳。

这似乎阻止了白痴搞砸我的代码…

// Autogenerated, do not edit. All changes will be undone.

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

/* Honest this works */

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