Eclipse c++注释模板以及注释文档生成

首先注释可以使用中文,主要目的是为了让其他人看懂。

注释可以通过eclipse模板设置进行规范:Windows---preferences---C/C++----Code Style----CodeTemplates。

下面介绍如何在写代码过程中可以设置快捷键自动输入模板:

首先设置相关模板输入,Windows-preferences-C/C++-Editor-Templates,加入自定义2个模板,zsdata(数据类型定义注释模板), zsfunc(函数注释模板)。

zsdata如下设置:

/**  简述${cursor}

 

 *   详细描述

 */

zsfunc如下设置:

/**简述 ${cursor}

 

 * 这里写该函数的详述信息

 * @param [in] (输入参数说明,包括每个参数的作用、取值及参数间关系)

 * @param [out] (输出参数的说明)

 * @return (返回值的说明)

 * @see    (本函数参考其它的相关的函数,这里作一个链接)

 * @note   (描述需要注意的问题)

*/

其次设置快捷键:Windows-preferences-General-Keys:

设置C/C++Content Assist(Templates Proposals)的快捷键为ALT+Z。另外一个很重要的快捷键是Word Completion,原始快捷键是ALT+/,可以设置为ALT+X等更方便的方式。


doxygen是代码文档工具。

下载地址:www.doxygen.org

Graphviz

这个工具配合doxygen使用,可以提取函数,模块之间的调用关,非常清晰。

下载地址:http://www.graphviz.org/

使用Doxygen工具,通过配置工程源文件路径等设置后,自动就生成帮助文档,集成graphviz可以有文件关系图示。

如有需要,生成的html还再用HTML Help Workshop生成chm,这里不另述。

你可能感兴趣的:(Eclipse c++注释模板以及注释文档生成)