Doxygen 可以被迫创建像样的手册页吗？

Question

我开始寻找一种从源代码生成手册页的方法。 我现在已经安装了 Doxygen，它会生成很棒的 HTML 页面，这些页面有组织、有帮助等等。

但是... Doxygen 似乎在创建像样或可用的手册页方面很糟糕。 从更多的 Google 搜索来看，似乎这可能是使用 Doxygen 生成手册页的普遍共识。 确实是这样吗，或者是否有页面/提示解释了如何让 Doxygen 更好地处理手册页？

我在 GitHub 上发现了一个项目——doxy2man——它似乎是专门为将 Doxygen xml 输出文件重新整理到手册页中而设计的，但我很好奇是否可以强制 Doxygen 本身做得更好。

我在手册页中使用的 Doxygen 选项（数量不多）是：

$ grep MAN Doxyfile | grep -v "#"
GENERATE_MAN           = YES
MAN_OUTPUT             = man
MAN_EXTENSION          = .3
MAN_LINKS              = YES

Answer 1

我开始相信答案是否定的。 Chat GPT 确实相信有一些，而且那些看起来还不错，但它们看起来像是被人类按摩了不少。