paip. c++ doxygen 文档工具的使用以及跟QT CREATOR的集成
来源:互联网 发布:虚拟聊天软件下载 编辑:程序博客网 时间:2024/06/16 09:55
paip. c++ doxygen 文档工具的使用以及跟QT CREATOR的集成
作者Attilax , EMAIL:1466519819@qq.com
来源:attilax的专栏
地址:http://blog.csdn.net/attilax
doxygen 文档例子:
/////////////////////////////
/**
@file
@brief like 360 start menu button
@note 详细注释
@bug arg timer ,should hook window
@todo heyeug hookwind yaozwl .
@author attilax <1466519819@qq.com>
@date c925
文件头注释@file
//////////////////////
因为文件不在任何东西里面,所以不能像类、函数等在上方放注释,只能用@file方式定义,其格式如下,一般@file后面为空,表示本文件.
2、简要注释和详细注释
///////////////////////////
@brief 简要注释
@note 详细注释
3.类,函数注释
///////////////
类,函数注释分别写在 类,函数的上方就好..
4.3.5 类成员变量定义示例
////////////////////////////////////
只在头文件的定义处进行简要注释,不要详细注释。可以在
上方用/** @brief some brief description */
或右方用///< some brief description
(1)在成员变量上面加注释的格式
/** 成员变量描述 */
int m_Var;
(2)在成员变量后面加注释的格式
int m_color; /**< 颜色变量 */
5.跟QT CREATOR的集成
//////////////////////////////
QT CREATOR>>tool>>external>>config ,,加了个D:/doxygen/bin/doxygen.exe 参数"D:\doxygen\bin\Doxyfile4c++.cfg"但是,..不执行..提示doxygen.exe 在执行,实际不执行...使用个process monitor查看累挂..doxygen.exe没见执行..好像QT有BUG了
只好建立了个.bat....在把这个C:\Documents and Settings\Administrator\桌面\c920\doxygen.bat加到个扩展里面.走ok兰..
qt的扩展实际保存地址是 C:\Documents and Settings\Administrator\Application Data\QtProject\qtcreator\externaltools\*.xml
虽然也修改这个QtCreator.ini文件了,不过是根据externaltools\*.xml自动生成
C:\Documents and Settings\Administrator\Application Data\QtProject\QtCreator.ini
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\1\Tool=doxygen
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\2\Tool=New_Tool
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\3\Tool=attilaxc925
参考
doxygen注释语法(一):JavaDoc注释风格、文件头和类注释 - 可乐鸡翅 - 博客频道 - CSDN.NET.htm
Doxygen详细介绍 - Timmy_zhou的专栏 - 博客频道 - CSDN.NET.htm
Doxygen - 老孙的博客 - 博客频道 - CSDN.NET.htm
使用doxygen为C C++程序生成中文文档(上).htm
Doxygen簡介.htm
作者Attilax , EMAIL:1466519819@qq.com
来源:attilax的专栏
地址:http://blog.csdn.net/attilax
doxygen 文档例子:
/////////////////////////////
/**
@file
@brief like 360 start menu button
@note 详细注释
@bug arg timer ,should hook window
@todo heyeug hookwind yaozwl .
@author attilax <1466519819@qq.com>
@date c925
文件头注释@file
//////////////////////
因为文件不在任何东西里面,所以不能像类、函数等在上方放注释,只能用@file方式定义,其格式如下,一般@file后面为空,表示本文件.
2、简要注释和详细注释
///////////////////////////
@brief 简要注释
@note 详细注释
3.类,函数注释
///////////////
类,函数注释分别写在 类,函数的上方就好..
4.3.5 类成员变量定义示例
////////////////////////////////////
只在头文件的定义处进行简要注释,不要详细注释。可以在
上方用/** @brief some brief description */
或右方用///< some brief description
(1)在成员变量上面加注释的格式
/** 成员变量描述 */
int m_Var;
(2)在成员变量后面加注释的格式
int m_color; /**< 颜色变量 */
5.跟QT CREATOR的集成
//////////////////////////////
QT CREATOR>>tool>>external>>config ,,加了个D:/doxygen/bin/doxygen.exe 参数"D:\doxygen\bin\Doxyfile4c++.cfg"但是,..不执行..提示doxygen.exe 在执行,实际不执行...使用个process monitor查看累挂..doxygen.exe没见执行..好像QT有BUG了
只好建立了个.bat....在把这个C:\Documents and Settings\Administrator\桌面\c920\doxygen.bat加到个扩展里面.走ok兰..
qt的扩展实际保存地址是 C:\Documents and Settings\Administrator\Application Data\QtProject\qtcreator\externaltools\*.xml
虽然也修改这个QtCreator.ini文件了,不过是根据externaltools\*.xml自动生成
C:\Documents and Settings\Administrator\Application Data\QtProject\QtCreator.ini
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\1\Tool=doxygen
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\2\Tool=New_Tool
OverrideCategories\SpecialEmptyCategoryForUncategorizedTools\3\Tool=attilaxc925
参考
doxygen注释语法(一):JavaDoc注释风格、文件头和类注释 - 可乐鸡翅 - 博客频道 - CSDN.NET.htm
Doxygen详细介绍 - Timmy_zhou的专栏 - 博客频道 - CSDN.NET.htm
Doxygen - 老孙的博客 - 博客频道 - CSDN.NET.htm
使用doxygen为C C++程序生成中文文档(上).htm
Doxygen簡介.htm
- paip. c++ doxygen 文档工具的使用以及跟QT CREATOR的集成
- Doxygen文档生成工具的使用
- Doxygen文档生成工具的使用
- Doxygen文档生成工具的使用
- paip.c++ qt creator svn 设置以及使用总结.
- qt creator doxygen 快速注释文档
- Qt creator 的使用
- Qt Creator的使用
- 便利的开发文档工具-doxygen
- 便利的开发文档工具-doxygen
- 便利的开发文档工具-doxygen
- 便利的开发文档工具-doxygen
- Doxygen 编写软件参考文档的工具
- CUDA + QT Creator + Win7的集成
- doxygen文档工具在Eclipse中的集成
- 开发文档生成工具----Doxygen自动文档生成工具在Eclipse中的集成及使用举例
- 使用代码文档工具 doxygen
- 一、qt creator的使用
- 档案文件properties的使用
- GCD实战2:资源竞争
- WPF第三篇——listbox选择后显示隐藏菜单
- POJ 1251 (2013.9.21周赛H题:MST最小生成树prim和kruskal算法)
- linux基础命令
- paip. c++ doxygen 文档工具的使用以及跟QT CREATOR的集成
- Block教程系列
- 十、android的ContentProvider对外共享数据
- 北京hulu笔试,按Z字形打印矩阵
- django-cms学习笔计(一)
- Block介绍(一)基础
- Struct和Class的区别
- Block介绍(二)内存管理与其他特性
- Java Web 视频教程(收藏)