从上学那会开始,老师就教导我们一定要在代码中加注释,一是为了写代码的时候有逻辑,二是为了维护代码时明白某一段代码的作用。
我相信大多数看我这篇文章的人都想见识一个这个所谓的史上最强代码注释是什么样的,那我们就开始吧……
以下引用自“外刊IT评论”
1.
// 亲爱的维护者: // 如果你尝试了对这段程序进行‘优化’, // 并认识到这种企图是大错特错,请增加 // 下面这个计数器的个数,用来对后来人进行警告: // 浪费在这里的总时间 = 39h |
2.
/** * 致终于来到这里的勇敢的人: 你是被上帝选中的人,英勇的、不辞劳苦的、不眠不修的来修改 我们这最棘手的代码的编程骑士。你,我们的救世主,人中之龙, 我要对你说:永远不要放弃,永远不要对自己失望,永远不要逃走,辜负了自己。 永远不要哭啼,永远不要说再见。永远不要说谎来伤害自己。 */ |
3.
Exception up = new Exception("Something is really wrong."); throw up; |
4.
// 一些修改1 - 2002/6/7 增加临时的跟踪登录界面 // 一些修改2 - 2007/5/22 我临时的犯傻 |
5.
#define TRUE FALSE //逗一逗调试程序的傻瓜们 |
6.
if (/*you*/ $_GET['action']) { //celebrate(恭喜) |
7.
// 如果这段代码好用,那它是Paul DiLascia写的。 //如果不好用,我不知道是谁写的。 |
8.
//写这段代码的时候,只有上帝和我知道它是干嘛的 //现在,只有上帝知道 |
9.
// 晕了,以后再修改 |
10.
// 神奇。勿动。 |
你有没有更绝的?
其实很多我也干过,只是没有写出来……哈哈