我最喜欢的评论是:

//the XML returned from this request is *mind-bogglingly* bad. Terrifyingly bad.
//a completed batch looks like this:
//<Batch>batchid=363777811 status=Done dateandtime=09/18/2007 09:53:10 PDT activateditems=335 numberofwarnings=0 itemsnotacivated=17 </Batch>
//and an incomplete batch like:
//<Batch>batchid=363778361 status=In Progress </Batch>
//so we'll just parse each item as a regex. Thanks Amazon.

Amazon实际上是这样返回XML的。

/// <summary>
/// The possible outcomes of an update operation (save or delete)
/// </summary>
public enum UpdateResult
{

    /// <summary>
    /// Updated successfully
    /// </summary>
    Success = 0,

    /// <summary>
    /// Updated successfully
    /// </summary>
    Failed = 1
}

这个注释位于一个包含接口的单元中，这些接口用于绑定主应用程序和各种第三方驱动程序之间的通信。

//**************************************
// Dear code maintainer:
//
// This source contains COM interfaces, not to be confused with interfaces 
// of any other sort, please do not just willy-nilly add additional methods 
// to these interfaces as they are truely immutable, unlike the interfaces 
// that other software vendors like Microsoft maintain.  IF you need to add 
// new functionality, then go thru the trouble of creating a NEW interface 
// and implement this functionality on only the objects you need.  
//
// While the money is good for fixing all of the problems caused by not 
// following the rules, I would rather work on things which actually have
// an impact on the future of the product rather than curse and yell 
// obsenities at the screen because someone didn't bother to understand the
// true meaning of IMMUTABLE.  
//**************************************

有一次，我问一个同事如何用我们的内部框架做一些事情(忘了具体是什么，一些晦涩的技术调用)。 他说“简单，看这里”，然后在他的编辑器中打开一个。java文件，在几页代码中间给我看了这个注释:

// HERE

我刚刚检查了一下，注释仍然在这个文件中:)

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

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

这是一个旧的IOCCC获奖条目，我不得不下载整个获奖档案——一个巨大的1.4 M——和grep的几个短语，我记得错了才找到它。

从语法上看，这可能不是注释。或许是这样。我还没想明白。它肯定没有注释分隔符，但也没有字符串分隔符。

C="Lint says "argument Manual isn't used."  What's that
mean?";

没有价格来猜测棉绒的产量。

对于好奇的人来说，这个条目在这里。