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


当前回答

我经常看到这种情况:

// TODO make this work

其他回答

几年前我在。h文件里看到的。

// It may be a hack, but it works.
Case 1:
   ...
   break;
   ...
//I don't want do do this but [my coworker] says it's part of the code standard
default:
   break;
if(m_measures =/*=*/ --index)
{
    ....
// The following array may contain either TexturedObjects or ColoredObjects.
// I know, it sucks.

我在重用我很久以前写的一个PHP类时发现了这一点。我仍然不记得那里有什么,我仍然发现它没有任何用处……我甚至不记得我写过那篇评论;所以当我找到它的时候,我真的笑出声来了。

try
{               
    // Some database logic
}
catch (Exception $ex)
{
    // sure, it looks silly and I honestly cant remember what code used to go here... but i swear i will
    // find a use for this code.... eventually....
    throw $ex;
}