1,生成CHM:
2,生成RTF:
一,注释风格
1, 类注释:写在类名的上一行。
/**
* 类的介绍
*@author 作者
*@date 时间
*@note 注释
*/
Public class MyClass{};
2, 成员注释:写在注释的上一行
/** 成员变量描述 */
int m_Var;
3, 函数:写在函数的上一行
/**
* 函数功能描述
* @param p1 输入参数p1描述
* @param p2 输入参数p2描述
* @return 输出参数(返回值)描述
*/
int testMe(int a,const char *s);
附加可选常用参数:
类:
* @brief 类的简介,生成word文档时在目录附带
* @version 1.1 --版本号
函数:
* @note 注意,调用此方法时要XXX --备注
* @exception IOException 抛出IO异常 --异常
* @see 参考IDAO接口的XX --参考
实例:
#pragma once /** * 此类是一个动物抽象类, 所有动物都继承此类。 *@author 袁 *@date 2013-2-20 14:25:17 *@note 测试注释,可以不写这个参数。 */ class Animal { /**动物的年龄*/ public:int age; /**动物的ID*/ int id; /** * 根据ID得到动物的年龄 * @param aid 动物的ID * @return 返回动物的年龄 */ public: int getAge(int aid){ if(aid==id){ return age;} else{ return -1; } } public: Animal(void); ~Animal(void); };
生成word文档:
类索引
类列表
这里列出了所有类、结构、联合以及接口定义等,并附带简要说明:
Animal .................................................................................................................................................... pagenum
类说明
Animal类 参考
#include <Animal.h>
Public 成员函数
l int getAge (int aid)
Public 属性
l int age
l int id
详细描述
此类是一个动物抽象类, 所有动物都继承此类。
作者:
袁
日期:
2013-2-20 14:25:17
注解:
测试注释,可以不写这个参数。
在文件 Animal.h 第 8 行定义.
成员函数说明
int Animal::getAge (int aid)[inline]
根据ID得到动物的年龄
参数:
aid |
动物的ID |
返回:
返回动物的年龄
在文件 Animal.h 第 19 行定义.
类成员变量说明
int Animal::age
动物的年龄
在文件 Animal.h 第 11 行定义.
int Animal::id
动物的ID
在文件 Animal.h 第 13 行定义.
该类的文档由以下文件生成:
l E:/C/myPro01/myPro01/Animal.h
l E:/C/myPro01/myPro01/Animal.cpp