程序开发文档生成利器
2005-02-01 17:45
309 查看
2005年2月1日 编写开发文档的利器 |
这两天我同事“黎叔”介绍了一个用于编写代码文档的好工具Doxygen,这个软件是个开源的项目,虽然界面写得比较难看一些不过还是相当实用的工具。有了这个工具可以很方便的生成程序开发文档,无论从版式还是从组织都可以说是一流,我花了一个小时的时间研究了一下还真是不错呢。 |
(一)基本设置 首先从网上下一个Doxygen的工具然后安装到你的机器上,然后尽量不要改工具的设置,只需要修改几个地方就可以了 打开wizard对话框然后点expert按钮在projectd页下做以下几个设置你会发现写程序文档还是比较爽的 不选:FULL_PATH_NAMES 选:JAVADOC_AUTOBRIEF选这个选项后可以按java文档的格式生成文档,第一句是简要描述,我比较喜欢这种风格,它的例子大部份是QT格式的文档,不好看不美观所以建议不使用。 点开build页 不选:SHOW_DIRECTORIES除非你想要显示你代码的路径名和文件名 (二)注释风格 呵呵说到注释风格,因为我以前一直按照java文档的注释风格来写的,所以改动不是很大,主要风格如下 类的声名 /** IChart IChart.h "inc/IChart.h". * this is base abstract class for chart * * IChart is abstract class for all type of chart */ 主要的代码风格比较像java的代码注释风格,是类c的注释风格,主是注意"/**"的下一句一般会被认为是简要描述,记住一定要在简要描述的后面加上结束的符号"."否则就会被认为是一行。 类成员函数的声名 /** * initialize the chart. * @param char* title - [in] chart title name * @param char* category - [in] chart category name * @param char* value - [in] chart value name * @param IDataSet* data - [in] chart data * @param bool bRow - [in,default] use row data or use column data */ virtual void ; init( char* title , char* category , char* value , IDataSet* data , IColors* colors , bool bRow = true ) = 0 /** * the chart color table used to display chart plot. * @param IColors* colors - [in] the color table * @return a character pointer. */ virtual void set_colortable( IColors* colors ) = 0; 这里其它部份就不用说了说明是这里有几个关键字"@param"表示的是参数,写了这个关键字就可以在文档中生成函数的参数部份的文档了还有一个关键字是"@return"这个是返回值关键字,有了这个就可生成返回值部份的文档了,只要有这几个基本就可生成比较好看的程序文档了,代码写完文档也就写好了,真的是不错的东东啊。强烈建议大家都用这个工具生成项目文档。其它关键字就等用的时候去看了...... (三)生成的文档示例 |
IChart Class Reference
IChart IChart.h "inc/IChart.h" this is base abstract class for chart.More...
#include <IChart.h>
List of all members.
Public Member Functions | |
virtual IColors * | get_colortable ()=0 |
the chart color table used to display chart plot. | |
virtual void | set_colortable (IColors *colors)=0 |
the chart color table used to display chart plot. | |
virtual char * | get_title ()=0 |
the chart title property | |
virtual void | init (char *title, char *category, char *value, IDataSet *data, IColors *colors, bool bRow=true)=0 |
initialize the chart. |
Detailed Description
IChart IChart.h "inc/IChart.h" this is base abstract class for chart.IChart is abstract class for all type of chart
Member Function Documentation
|
| the chart color table used to display chart plot. return a character pointer. |
|
| initialize the chart. Parameters:
|
|
| the chart color table used to display chart plot. Parameters:
|
Generated on Tue Feb 1 16:18:45 2005 for chart by
1.4.1
相关文章推荐
- Java学习笔记--使用Javadoc生成程序开发文档
- 自动生成你的程序开发文档
- 正规军的脚步:自动生成你的程序开发文档
- Android 开发文档 程序基础 ——Broadcast receivers组件
- Android 开发文档 程序基础——Affinities and new tasks
- Java 的 Api 文档生成工具 JApiDocs 程序文档工具
- QT程序自动寻找依赖的DLL(Qt官方开发环境生成的exe发布方式--使用windeployqt)
- 基于ONVIF协议的(IPC)客户端程序开发-5:使用gSOAP生成ONVIF框架代码
- Lombok — Java代码自动生成 开发利器
- 【iOS开发】---- appledoc:Objective-C注释文档生成工具
- AppleWatch开发教程之调试程序使用帮助文档
- 使用java程序生成excel文档程序
- ubuntu下整合eclipse和javah生成jni头文件开发android的native程序
- N9程序开发-生成项目
- Lombok — Java代码自动生成 开发利器
- 微信小程序(天气预报)开发文档
- Ruby on rails开发从头来(windows)(十八)-自动生成文档
- MFC:“Debug Assertion Failed!” ——自动生成的单文档程序项目编译运行就有错误
- Xcode4自动生成注释和开发文档