你遇到过的源代码中最好的注释是什么?
当前回答
我一直很喜欢Paul DiLascia在他的文件头中写的:
// If this code works, it was written by Paul DiLascia. If not, I don't know
// who wrote it
其他回答
// This is a walkaround for bug #7812
是我们的一个中国程序员写的,他的第一语言不是英语。
我真的很喜欢这个。我碰巧认为“walkaround”几乎比“workaround”更好。
/**---------START-----------**/
// IMPLEMENTATION GOES HERE
/**---------END-----------**/
但没有代码;)
// For the sins I am about to commit, may James Gosling forgive me
sqlite源文件顶部:
/*
** The author disclaims copyright to this source code. In place of
** a legal notice, here is a blessing:
**
** May you do good and not evil.
** May you find forgiveness for yourself and forgive others.
** May you share freely, never taking more than you give.
*/
/////////////////////////////////////// this is a well commented line