你遇到过的源代码中最好的注释是什么?
当前回答
这一点对其他人来说很有趣,但对我来说就不那么有趣了。我从一个开发人员那里继承了代码(ASP),而他自己也继承了它。第一个程序员编写了一些很难理解的代码。第二个开发者添加了如下评论(为了保护不那么无辜的人,名字被隐藏了):
'This code was written by **************.
'I haven't a clue what it does. He hasn't a clue what it does.
'Nobody else has a clue what it does or how it does it.
'It is something to do with data but **** knows what.
'The ******* still works so please do not change this code,
'even though it is a complete pile of ****.
那我为什么不觉得有趣呢?嗯,这是一个客户内部网的ASP代码。
...正是那位顾客向我强调了这条评论。
:-(
其他回答
<cftry>
...code...
<cfcatch>
<!--- Gobble --->
</cfcatch>
<cftry>
我公司的代码库里到处都是。它是ColdFusion,它会忽略错误。
好吧,这是我刚刚提到的一个问题:
/* Every time I re-visit this function, I feel like
* I need to take a shower.
*
* Don't get too used to this function, its days are
* numbered.
*/
有人可以创建像greatcodecomments.com这样的网站,然后赚点钱。然而,那个人不是我。
/* Please work */
#ifdef TRACE
#undef TRACE /* All your trace are belong to us. */
#endif
#define TRACE ....
所有bug由David S. Miller添加