10

我知道 Doxygen 可以生成文档。我正在寻找的是在 Xcode 中插入文档的快速方法，类似于 Eclipse 在编辑 Java 文件时所做的。

假设我有一个带有如下参数的 Objective-c 方法：

-(NSInteger*) sumOf: (NSInteger*) one and:(NSInteger*) two {...

在 Eclipse 中，如果将光标放在方法上方并键入：/**<Enter>您将获得一个预先填充了@param和@return标记的 Javadoc 模板。

是否有可能在 Xcode 中实现类似的功能？输入后/**<Enter>，我想自动得到这个：

/**
 *
 * @param one
 * @param two
 * 
 * @return
 */
 -(NSInteger*) sumOf: (NSInteger*) one and:(NSInteger*) two {...
4

4 回答 4

7

此处的脚本http://www.duckrowing.com/2011/05/14/using-the-doxygen-helper-in-xcode-4/完全符合您的要求。

编辑：这是脚本的更新版本：https ://github.com/premosystems/DoxygenXCodeHelper

于 2011-11-04T15:11:15.180 回答
2

我一直在 Xcode 5 中成功使用VVDocumenter-Xcode，它运行良好。当您在方法上方输入“///”时，它会自动生成特定于方法的模板。

于 2013-10-09T18:51:03.257 回答
1

“用户脚本”菜单（Xcode 菜单栏中的黑色小滚动图标）有一个 HeaderDoc 子菜单，其中包含用于高清语法的各种文档标记的模板。您可以通过转到 Xcode 的“首选项”窗口中的“键绑定”来为要使用的项目设置键盘快捷键。

由于用户脚本本质上是 shell 脚本，因此您可以使用任何脚本语言来编写自己的脚本，因此如果您愿意，甚至可以编写一个小正则表达式辅助脚本来解析所选行中的参数名称并填写您的基础知识HeaderDoc 评论。

于 2010-04-10T13:22:31.487 回答
0

如果您有耐心，请看这里，因为它解释了 XCode 中的完成行为和覆盖。我不知道这是否适用于评论集，但这似乎是一个好的开始。

——弗兰克

于 2010-03-19T10:45:02.887 回答