c++ - 是否有像 docco 这样的 C/C++ 源代码文档生成器？

Question

<分区>

Answer 1

docco 源代码(git repo)支持 c。如果你克隆它，你可以使用 npm 在本地安装它。然而:

• 我必须将 docco.coffee 编译成 javascript:

  cd docco/src
  coffee -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