生成文档doxygen样式而无需注释代码

Question

我正在寻找一种以与Doxygen类似的方式创建文档页面的方法，但我不想将文档作为注释放入我的代码中。最好的方法是将其键入普通文本文件或其他内容，然后从中生成页面。

根据我的理解，Doxygen不支持这一点，所以我想知道是否有任何替代品可以做我想要的。

Answer 1

在INPUT参考文件部分的*.dox文件中创建常规文本文件的文件夹。例如：

INPUT = ./supplement

之后，您可以创建常规文本文件，只需将/*!放在开头，将*/放在最后。并使用\page或其他标签对其进行分类。例如：

My.txt文件

/*!
  \page threading Describe Threading tech
  In details this describe cases:
  \li case 1
  \li case 2
*/

您可以在单个文件中放置多个\page声明（请参阅http://www.doxygen.nl/manual/commands.html#cmdpage）