我开始寻找一种从源代码生成手册页的方法。我现在安装了 Doxygen，它会生成很棒的 HTML 页面，这些页面有条理、很有帮助等。
但是......似乎 Doxygen 在创建体面或可用的手册页方面很糟糕。从更多的谷歌搜索来看，似乎这可能是使用 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