【发布时间】：2010-02-19 03:18:01
【问题描述】：
是否可以记录 configure.ac 以便 doxygen 可以拾取嵌入式 cmets 并在生成的手册中为选项、变量等生成文档？
谢谢
【问题讨论】：
标签： documentation doxygen autotools autoconf
【发布时间】：2010-02-19 03:18:01
【问题描述】：
您应该使用像 ##! 这样的 cmets 来使用 Doxygen 进行评论，对吗？我不认为 Doxygen 支持这样的 cmets，但是您可以尝试修改 Doxygen 以接受这样的 cmets，然后您可以使用常用的 Doxygen 命令 @var、@cond em>等
修改可能很难，但您可以尝试修改此文件commentcnv.l（从@line 319 开始）。也许你可以用项目开发者邮件列表来邮寄。
【讨论】：
-
实际上 python 文档使用双哈希，也许我可以欺骗 doxygen 将 configure.ac 视为 python/Perl 文件。谢谢
在Autoconf Archive 上提供了用于 Doxygen 的 Autoconf 宏。在configure.ac 中包含DX_INIT_DOXYGEN 宏，然后automake 将创建诸如doxygen-doc 之类的目标，用于生成文档的各种子集。
【讨论】：
-
谢谢，但是我需要记录 configure.ac 本身，而不是生成 doxygen-* 目标
-
哦。那我不知道了，抱歉。