下载doxygen:http://www.cnblogs.com/duxiuxing/p/4301015.html
学习思路
doxygen能够根据代码和注释生成文档。可想而知,doxygen对注释的书写必定是有其语法要求的。在一个开发团队中推广doxygen,最需要优先考虑的问题是如何降低doxygen化注释的书写成本。如果要求开发同学必须先额外记忆大量的复杂的语法规则,这个事情是很难在开发团队中长久地坚持下去的。所以我采取的思路是:
- 记忆尽量少的语法规则:C++注释和doxygen注释(链接:http://www.cnblogs.com/duxiuxing/p/4302502.html)
- 针对需要文档化的对象制定统一的注释模板(*表示常用的)
- 接口文件的说明
- 在实际开发中按照统一的模板来添加注释