Table of Contents
概述
CuraEngine源码有w行,如果没有详细的说明文档那简直不是人看的。好在有doxygen这通过注释个自动生成代码文档的工具,还有graphviz可以生成依赖图等。效果如图:
生成说明文档
- 下载 doxygen:http://www.stack.nl/~dimitri/doxygen/download.html
graphviz:http://www.graphviz.org/
- 配置 打开doxygen GUI界面,这是用来生成配置文件的。
详细的配置过程参见:http://www.tuicool.com/articles/r6nuUjF ,其中
OUTPUT_DIRECTORY这行要屏蔽,INPUT这行要屏蔽,GENERATE_HTMLHELP =YES,OUTPUT_LANGUAGE=Chinese
建议生成html文档,graphviz的选项最好都选上,生成的配置文件复制到vs工程目录里。 - 与vs集成 详情参见:http://www.cnblogs.com/bluepointcq/archive/2006/08/18/480497.html
在VS环境中:Tools->External Tools->Add
Title: Doxygen
Command: D:\Program Files\doxygen\bin\doxygen.exe(doxygen的安装目录)
Arguments: $(ProjectDir)\default.doxygen
Initial directory: $(ProjectDir)
以后点击 工具-Doxygen 就可以在vs当前目录生成说明文档了。
doxygen的语法
要生成格式化的文档,必然对注释有语法要求。更详细的语法参考官网,这里只是列举最简单的用法,不过对于CuraEngine已经够用了。(原作者貌似也就用了一点点而已)
- 用在函数或者变量之前,单行
/*! 注释内容 */
- 用在变量之后,单行
/*!< 注释内容 */ 或者 //!< 注释内容
- 用在函数或者变量之前,多行
/** * 注释内容 */ 或者 /*! * 注释内容 */
- 宏注释
/*! \def MAX(x,y) 宏的具体注释 */
- 函数参数
- \property 属性
- \param 参数名 描述 参数说明
- \return 描述 返回值说明
- \a 增强视觉感受
- TODO事项
//TODO: 待办事项
- 高级用法
自己查资料啊~比如这个鬼
其他
大致就这么多,反正培养良好的注释习惯肯定有好处的~
https://fhln.blog.ustc.edu.cn/