更积极地维护哪些文档包:NaturalDocs或RoboDoc?

时间:2013-06-04 05:21:14

标签: documentation tcl

我正在记录一个小的itcl项目。由于itcl支持doxygen的缺点,以及Ruff的事实!不支持itcl,我留下了NaturalDocs和RoboDoc作为主要候选人。但是,我不想选择一个不受支持的系统,并且想知道哪个系统会长期存在?

1 个答案:

答案 0 :(得分:0)

从长远来看会有什么?谁知道!这取决于人们使用它的程度,实际上,与所有开源代码系统一样。应该注意的是,你所提到的这两个工具在这一点上发展得非常缓慢:他们做了他们所做的事情,并且需要做一些重大改变才能继续这样做。

据我所知,ROBODoc要求你自己做几乎所有的注释工作,而NaturalDocs会为你得到更多。虽然不是很多;特别是,无论您使用哪种路线,都必须在大量的注释上写下。 (虽然我没有特别的经验;我倾向于将文档保存在一个单独的文件中,例如doctools,但这是一种非常不同的方法。我过去也做了令人讨厌的自定义事情;你真的不想使用它们。)