以前，我们使用Word记录我们的软件组件（固件的一部分，因此用户是其他开发人员）。我们遇到了几个问题，例如该软件的更改未记录在案，因为开发人员忘记了。 现在我们切换到Doxygen，因此我们可以将所有内容记录一次，如果我们对API进行了更改，则只需编辑该功能上方的文档即可。此外，我们将MD文件用于其他说明，这些说明不属于代码。

现在的问题是，我们很难建立适当的审核流程。以前，我们只是设置PDF服务器审阅。到目前为止，我们尝试的是：

• 使用Doxygen的Latex输出，并使用MikTeX和pdflatex（在Windows下）将Latex转换为PDF

->输出看起来很杂乱，因为每个函数的标头占用大量空间，而且格式通常是错误的。

• 使用Doxygen的RTF输出

->与Latex遇到的相同问题

• 将HTML页面打印为PDF，然后进行合并。

->可以毫无问题地查看生成的文档，但是创建文档需要花费大量时间，并且创建者必须注意每次都使用单个文件的相同顺序（以使比较更容易）。

我正在寻找什么：

• 建议一种自动创建格式正确的PDF的方法。

• 除PDF审阅外，其他审阅过程还使多个审阅者可以审阅文档并查看其他审阅者的评论，并且可以使用Doxygen HTML输出。

我们正在使用Windows，并将其用于源代码管理ClearCase和GIT。