Doxygen文档

 

Doxygen文档

ZhangRui@landwind.com.cn

Doxygen可以为C++, C, Java, IDL (Corba and Microsoft flavors) PHPC#生成文档

大致用途有三:

  1. 可以生成一个在线html文档或者一个离线的LATEX格式文档也支持RTF(MS-Word) PostScript, hyperlinked PDF, compressed HTML, Unix man pages多种格式生成。文档直接由源码生成,这使得保持文档和代码一致性更加轻松。
  2. 可以配置doxygen从无文档的源码中提取代码结构。这就便于在大型源码中迅速上路。也可以将这些不同元素间的关系使用图形表达出来,包括依赖图,继承图和collaboration图,这些都是自动生成的。
  3. 甚至可以使用它来生成平常的文档,例如手册

DoxygenLinux下开发,但高度可移植,可运行在各种平台之下。

这个手册包括下面三个部分,每个部分分为以下几个章节

第一部分是用户手册

  • Installation讲述如何下载,编译和安装doxygen
  • Getting started如何快速上手
  • Documenting the code讲述使用代码生成文档的各种方式
  • Lists讲述如何生成列表
  • Grouping讲述如何组织这些元素
  • Including formulas讲述如何在文档中插入公式
  • Graphs and diagrams讲述doxygen可以生成的各种图表
  • Preprocessing解释doxygen如何处理宏定义
  • Linking to external documentation解释如何让doxygen与外部文档生成链接
  • Frequently Asked Questions常见问题
  • Troubleshooting如何解决常见问题

第二部分是参考手册

  • Features doxygen特性
  • Doxygen History doxygen的开发历史和开发任务
  • Doxygen usage如何使用doxygen
  • Doxytag usage如何使用doxytag程序
  • Doxywizard usage如何使用doxywizard程序
  • Installdox usage在使用tag文件时,如何使用doxygen所生成的installdox脚本
  • Output Formats如何生成Doxygen所支持的各种输出文件格式
  • Automatic link generation如何在文档中添加链接到文件,类和成员
  • Configuration如何调整doxygen来生成你想要的文档
  • Special Commands在文档内可以使用的特殊命令
  • HTML Commands文档内可以使用的HTML命令

第三部分文档是为开发者准备的:

  • Doxygen's Internals描述了doxygen是如何设计的
  • Perl Module output format documentation描述了如何使用PerlMod输出
  • Internationalization explains解释了如何添加对新的输出语言的支持

第一章:出发吧

程序doxygen是分析源码和生成文档的。可以参考Doxytag usage了解详细的使用方法。只是在没有源码时,所以需要生成对外部文档的引用时(例如doxygen所生成的文档),使用Doxytag

下图展示如何工具间的关系和工具间信息的流程
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值