找回密码
 立即注册
搜索
热搜: 活动 交友 discuz
查看: 15|回复: 0

Doxygen中文版(编程工具辅助)

[复制链接]

32万

主题

0

回帖

96万

积分

超级版主

积分
964681
发表于 2025-3-14 11:23:40 | 显示全部楼层 |阅读模式
软件标签:  doxygen   编程工具
doxygen的开发作为方便和访问文件系统的c、c++、、java中的objective-c、python中的idl,并在一定程度上的php、c#和d。欢迎需要的朋友在绿色资源网免费下载使用!
doxygen软件介绍
doxygen是一种开源跨平台的,以类似javadoc风格描述的文档系统,完全支持c、c++、java、objective-c和idl语言,部分支持php、c#。注释的语法与qt-doc、kdoc和javadoc兼容。doxygen可以从一套归档源文件开始,生成html格式的在线类浏览器,或离线的latex、rtf参考手册。




程序语言
c/c++

java

objective-c

python

idl (corba, microsoft及kde-dcop类型)

fortran

vhdl

php

c#
文件格式
html

xml

latex

rtf (ms-word)

postscript

unix man page
doxygen 教程
由于只是工具的使用,这里不介绍它的原理,直接从使用步骤开始。doxygen的使用步骤非常简单。主要可以分为:

1)第一次使用需要安装doxygen的程序

2)生成doxygen配置文件

3)编码时,按照某种格式编写注释

4)生成对应文档

doxygen的安装非常简单, linux下可以直接下载安装包运行即可,下载源代码编译安装也是比较通用的编译安装命令。请参考其安装文档完成安装。

doxygen在生成文档时可以定义项目属性以及文档生成过程中的很多选项,使用下面命令能够产生一个缺省的配置文件:

doxygen -g [配置文件名]

可以根据项目的具体需求修改配置文件中对应的项,具体的修改过程在下面介绍。修改过的配置文件可以作为以后项目的模板。

让doxygen自动产生文档,平常的注释风格可不行,需要遵循doxygen自己的格式。具体如何写doxygen认识的注释在第3节详细介绍。

ok,代码编完了,注释也按照格式写好了,最后的文档是如何的哪?非常简单,运行下面的命令,相应的文档就会产生在指定的目录中。

doxygen [配置文件名]

需要注意的是doxygen并不处理所有的注释,doxygen重点关注与程序结构有关的注释,比如:文件、类、结构、函数、变量、宏等注释,而忽略函数内变量、代码等的注释。




aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|ziyuan80.com

GMT+8, 2025-8-17 03:13 , Processed in 0.077012 second(s), 19 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表