#如你所见:我注释了代码!

在大学的一次家庭作业中，一位老师特别坚决地要求我们注释代码:

//I wonder if she actually reads these.

当作业被返回时，在注释“是的，我愿意”旁边用红笔写着

//说明:!!待办事项

从2004年的Windows泄露事件来看，

__inline BOOL
SearchOneDirectory(
                  IN  LPSTR Directory,
                  IN  LPSTR FileToFind,
                  IN  LPSTR SourceFullName,
                  IN  LPSTR SourceFilePart,
                  OUT PBOOL FoundInTree
                  )
{
    //
    // This was way too slow. Just say we didn't find the file.
    //
    *FoundInTree = FALSE;
    return(TRUE);
}

// TODO: Drive an ashen stake through the foul heart of this function.

这是一个糟糕的函数。直到今天我还在做噩梦。

// Singleton object. Leave $me alone.
private static $me;