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


当前回答

从C #

#region Hack - Shield Eyes Before Expanding

/// <summary>
/// A single uint with all of the bits set to represent the different tracing
/// </summary>
/// <remarks>
/// Ugly I know, so if you can think of a better way, feel free to rewrite.
/// </remarks>
[Browsable(false)]
public uint TraceBitfield
{
    // Snip
}

#endregion

其他回答

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

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

我所见过的最好的评论是

/* 
  There is no accounting for pointers 
*/
/* Jeez, this is an ugly mess */

...comment from the X11R6 internals source code circa 1991.
// Empty constructor to satisfy the stupid compiler
 Public ServletHandlerClass () { } 
/*
* Wirzenius wrote this portably, Torvalds fucked it up :-)
*/