Shebang 与 doxygen 的冲突答案

【问题标题】：Shebang conflict with doxygenShebang 与 doxygen 的冲突
【发布时间】：2012-01-17 05:40:48
【问题描述】：

doxygen 不能在带有 shebang 的 python 脚本上正常工作吗？

我在我公司的工具目录中尝试了一个带有 shebang 的 python 脚本并运行了 doxygen。它根本无法显示命名空间（函数）。

如果你们有类似的经历，请分享。

【问题讨论】：

【解决方案1】：

在配置文件中启用 EXTRACT_ALL 为 YES，doxygen 将生成正确的预期结果。

但问题仍然存在，为什么 doxygen 无法为 EXTRACT_ALL = NO 的 python 生成文档文件。任何有更好答案的人都可以在这里帮助我。

【讨论】：

【解决方案2】：

这听起来像是脚本问题，而不是 Shebang 和 doxygen 之间的冲突

【讨论】：

Doxygen 不解析 python 语法，只解析 cmets。顺便说一句，当我将 EXTRACT_ALL 启用为 YES 时，doxygen 能够读取它并生成所需的结果。但是问题仍然存在，为什么 doxygen 无法使用 EXTRACT_ALL = NO 为 python 生成文档文件