Chinaunix首页 | 论坛 | 博客
  • 博客访问: 36003
  • 博文数量: 16
  • 博客积分: 520
  • 博客等级: 中士
  • 技术积分: 170
  • 用 户 组: 普通用户
  • 注册时间: 2009-11-01 08:58
文章分类

全部博文(16)

文章存档

2012年(1)

2011年(4)

2010年(8)

2009年(3)

我的朋友

分类: C/C++

2010-03-24 09:44:59

取自google C++ 代码风格

7.8. TODO 注释

对那些临时的, 短期的解决方案, 或已经够好但仍不完美的代码使用 TODO 注释.

TODO 注释要使用全大写的字符串 TODO, 在随后的圆括号里写上你的大名, 邮件地址, 或其它身份标识. 冒号是可选的. 主要目的是让添加注释的人 (也是可以请求提供更多细节的人) 可根据规范的 TODO 格式进行查找. 添加 TODO 注释并不意味着你要自己来修正.

// TODO(kl@gmail.com): Use a "*" here for concatenation operator.
// TODO(Zeke) change this to use relations

如果加 TODO 是为了在 “将来某一天做某事”, 可以附上一个非常明确的时间 “Fix by November 2005”), 或者一个明确的事项 (“Remove this code when all clients can handle XML responses.”).


阅读(461) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~