Doxygen 文档的模块化
Doxygen 提供了 grouping(分组)功能,可实现程序源码中内容相近的文档化内容的归类处理,合理使用该功能可有效提高程序文档结构的逻辑性。Doxygen 的 grouping 可通过三种机制来实现,即模块、成员与子页面,详细介绍可参考 doxygen 手册中的 grouping.html(通常位于 /usr/share/doc/doxygen*/html/grouping.html)。对于制作 C 程序文档而言,只有模块机制是有效的(个人观点)。本文讲述如何按照 Doxygen 的模块文档化规则实现 C 程序文档的模块化。
使用 Doxygen 制作 C 程序文档
目前,网上所能搜到 Doxygen 资料,大都是介绍 C++ 程序文档生成的,对于 C 程序的文档生成鲜有记述。由于我们的项目主要是采用 C 语言实现,这两天在学习使用 Doxygen 制作 C 程序文档时,摸索了一点东西出来,记之备忘。