有没有像docco一样的C/ C++源代码文档生成器？

Question

我希望在有文档记录的c++实现文件(不是头文件)上获得类似的输出，就像用docco生成的输出一样。有这样的工具吗？

Answer 1

Docco声称现在支持这一点- https://github.com/jashkenas/docco/pull/96

Answer 2

docco源代码(git repo)支持C。如果你克隆它，你可以用npm在本地安装它。但是：

• 我不得不把docco.coffee编译成javascript：

cd docco/src one -c docco.coffee cp docco.js ../lib

• 如果您在同一目录中有名称匹配的头文件和c文件，则其中一个文件会覆盖另一个文件。

• 由于某种原因，node.js相关的所有内容都会出现分段错误，但我认为这一定是安装出了什么问题(幸运的是，docco在生成输出后最后出现分段错误)。

更新-作为覆盖问题的修复，我克隆了存储库，并删除了文件扩展名。所以foo.h现在转到了foo.h.html，它不会覆盖foo.c.html。您可以从https://github.com/andrewcooke/docco获取一份副本

我还重新编译了javascript，因此要使用它，请执行以下操作：

git clone git://github.com/andrewcooke/docco.git
npm install docco
docco src/*.c src/*.h

Answer 3

我不熟悉docco，但它看起来像是一种识字编程。如果是这样的话，您可能想看看cweb。语法可能有所不同，但它确实适用于C++ (即使它在设计时考虑到了C语言)。