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


当前回答

来自usenet的经典:

Teradyne硬件建模器代码的深层是一个例程 一大堆十六进制数字到SYS$QIO调用中。唯一的评论是 “这里发生了奇怪的魔法”。

其他回答

Control + A,重写

这是在以前的项目中作为签入注释添加到源代码控制中的注释。

// TODO: Implement this function!
'""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
'
'  NOTE: DON'T SCREW WITH THIS CODE UNLESS YOU REALLY UNDERSTAND IT!
'
'""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

大概30页的xslt的中间部分

<!-- Here be dragons  -->
using namespace std;            // So sue me