2009年6月5日

还有何时需要注释？

摘要： 在上篇文章中，我强调了注释的非必要性。今天重新反思了一下我设计和实现的过程，发现这篇文章还有一些需要补充的，才算完整。在此之前，先说明一下在这两篇文章中，那些“真正”属于注释范畴的东西：既提供给作者和修改者看的，和代码放在一起的文本。对于提供给使用者看的文本，比如上篇文章中提到的接口描述，无论是否采用了注释的形式，一概算作文档，不在讨论范畴之内。对注释有帮助的情况的个人经验补充引用一下上一篇文章说... 阅读全文

posted @ 2009-06-05 18:56 怪怪 阅读(2859) 评论(13) 推荐(0)

导航