“这永远不会发生”。

朋友，这是我的临终遗言……

大概30页的xslt的中间部分

<!-- Here be dragons  -->

#ifdef TRACE
#undef TRACE     /* All your trace are belong to us. */
#endif
#define TRACE ....

// Empty constructor to satisfy the stupid compiler
 Public ServletHandlerClass () { } 

// If I from the future read this I'll back in time and kill myself. 

我刚刚完成了一个日志框架(使用Trace，为什么没有这样的存在我不知道)。我做了一个继承自TraceListener的方便基类。它覆盖了所有的TraceListener方法，并将它们路由到一个方法中——因此有很多文档注释:

// TODO: Need some codemonkey to doc comment this class.