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


当前回答

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

其他回答

我个人最喜欢的是打油诗形式的文档:

        Subclassing made Zope and TR
        much harder to work with by far.
            So before you inherit,
            be sure to declare it
        Adapter, not PyObject*

这可能会破坏这个笑话,但由于它有点晦涩,我将解释:

这里的TR指的是“扭曲的现实”。Zope 2和最初的扭曲。Reality包大量而不幸地使用了多重继承,这可能会使您在看到方法调用时难以理解发生了什么。Zope 3,扭曲自己,扭曲。现实的后继者(包括最近的假想)通常更倾向于组件组合。

我在遗留代码中注意到的修改日志

05/17/99 d琼斯评论出来 血腥的auzies代码(02/19/99) k罗宾逊该死的德克萨斯人 不能正确拼写aussie(没有代码 改变-只是一个评论)

摘自UNIX版本6源代码,大约1975年:

/* You are not expected to understand this. */

我没有这个来源的副本,但我一直记得它:

//如果你想不明白,就不要读这篇文章

// this error could never happen

然后,客户打电话说他看到一条错误消息说"这个错误永远不会发生"