我开始寻找一种从源代码生成手册页的方法。我现在有Doxygen设置,它会生成很棒的HTML页面,这些页面有组织,有用等等。
但是......看起来Doxygen糟透了所创造的体面或可用的手册页。从更多谷歌搜索来看,在使用Doxygen生成手册页时,似乎可能是普遍的共识。这是真的吗,还是有一个页面/提示解释了如何让Doxygen在手册页上做得更好?
我在GitHub上找到了一个项目 - doxy2man - 它似乎专门用于将Doxygen xml输出文件重新按压到手册页中,但我很想知道Doxygen本身是否可以被强制做得更好。 / p>
我正在使用的Doxygen选项(没有很多)用于手册页:
$ grep MAN Doxyfile | grep -v "#"
GENERATE_MAN = YES
MAN_OUTPUT = man
MAN_EXTENSION = .3
MAN_LINKS = YES