Xcode的可用文档工具 [英] Available Documentation Tools for Xcode

问题描述

什么是Xcode的一个很好的文档工具？我知道appledoc和HeaderDoc。这些比较如何？每个人的利弊是什么？你有使用他们的个人经验吗？有什么办法可以检查吗？有没有可以整合到构建过程中？ HTML输出将是首选。

解决方案

HeaderDoc已经死了。我记得苹果在内部使用了一种名为古腾堡的工具，但是他们并没有把它提供给世界其他地方（他们可能已经从上次调查了这些传言之后取而代之）。

我的经验是 Doxygen 是关于最好的ObjC文档系统在那里这不是说这是理想的。它有一些对象主义的麻烦。但是，对于大型项目来说，这仍然是最好的，并且在多语言和跨平台项目中都有很好的优势。

What is a good documentation tool for Xcode? I know of appledoc and HeaderDoc. How do these compare? What are the pros and cons of each. Do you have personal experience using them? Are there are any alternatives worth checking into? Are there any that can be integrated into the build process? HTML output would be preferred.

解决方案

HeaderDoc is pretty dead. Apple uses a tool called Gutenberg internally as I recall, but they don't make it available to the rest of the world (they may have replaced it since last I investigated the rumors).

My experience is that Doxygen is about the best ObjC documentation system out there. That's not to say it's ideal. It has trouble with some ObjC-isms. But it's still the best I've found and works pretty well for large-scale projects, and has the advantage of integrating well in multi-language and cross-platform projects.

这篇关于Xcode的可用文档工具的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！