昨天,Dave DeLong回答a question of mine。这不是我想要的答案,但在这个问题中,他提到了为Objective-C生成doxygen风格文档的另一种方法。
在我真正研究之前,有人(也许是戴夫本人)注意到答案与那个问题不符并删除了。 * poof * gone是该文档工具的链接。
戴夫,你在外面吗?又是什么链接?答案 0 :(得分:9)
我显然不是Dave DeLong,但我会使用appledoc,这真是太棒了!
开发者页面引用:
appledoc 是帮助Objective-C开发人员生成的命令行工具 类似Apple的源代码文档 来自特殊格式的源代码 评论。它的设计理念是 可读源代码注释为 可以输入和使用 评论以及周围的来源 用于生成视觉吸引力的代码 HTML格式的文档 以及完全索引和可浏览 Xcode文档集。虽然 有几种工具可以 为...创建HTML文档 Objective-C,所有这些人都知道 达不到最低限度 目标如下所述。
人类可读的源代码 appledoc旨在保留源代码 代码注释尽可能可读 甚至在您的源代码编辑器中。
对象和成员的交叉引用创建对象的交叉引用 类,类别或协议是 既简单又自动化 尽可能。
类似Apple的源代码HTML文档生成吸引人的内容 具有相同样式的HTML文档 作为Apple的。
Xcode文档集创建生成并安装完全索引和 可浏览的Xcode文档集。 文档集也可以 自动安装到Xcode。
从工具代码到文档集的单一工具用于驱动生成的单一工具 从源代码解析到 文档集安装
轻松自定义输出 appledoc为您提供了大量命令 行开关,以便您可以参数化 输出。如果这还不够,你可以 更改任何或所有模板 文件以满足您的需求。
100%Objective-C实施整个appledoc都是用来编写的 Objective-C,因此您可以轻松更改 它使用熟悉的语言和工具。 这也使调试变得更加简单 并且有效。