Question

由于某些原因，我想记录一个API，但我不想直接在源代码中编写文档，因为它现在已广泛使用。我正在寻找一个文档生成器工具，它可以将文档文件作为输入，并且能够从源代码中获取函数原型并检查与文档的一致性。你知道任何可以做到这一点的工具吗？

Answer 1

当文档文本在源代码之外时，

Doxygen也可以记录代码。只需创建一个文本为注释的源文件，其中包含标题：

例如，如果你有

<强> SOURCE.H

void func();

你可以添加

<强> SOURCE.DOX

/**
   \function void func()
   Your usual doxygen text here.
*/

并生成文件，使doxygen接受.h和.dox文件。