3

我希望在记录的 c++ 实现文件(不是头文件)上获得类似的输出,例如使用docco生成的输出。有这样的工具吗?

4

3 回答 3

2

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

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

    cd docco/src
    coffee -c docco.coffee
    cp docco.js ../lib
    
  • 如果您在同一目录中有名称匹配的头文件和 c 文件,则一个会覆盖另一个。

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

更新- 作为覆盖问题的修复,我克隆了 repo 并删除了文件扩展名的删除。所以foo.h现在去foo.h.htmlwhich doesn't over-write 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
于 2012-06-01T16:40:34.383 回答
1

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

于 2013-08-15T10:45:29.193 回答
0

我不熟悉 docco,但它看起来像是一种文学编程形式。如果是这种情况,您可能需要查看cweb。语法可能不同,但它确实适用于 C++(即使它是在考虑 C 的情况下设计的)。

于 2012-01-04T10:54:25.940 回答