Xcode 8自动生成快速帮助文档
在Xcode 8中宣布的新function中,我们可以看到
“自动生成快速帮助文档”:
这是手动代码文档的结尾,就像我们可以从NSHipster学到的这篇文章一样 ?
有人可以概述这个新function的利弊吗? 它是否会取代像爵士这样的工具 ?
我找不到有关新function的更多信息。
他们只是说,在Xcode 8中,你可以select一个像这样的方法:
func foo(bar: Int) -> String { ... }
然后按下命令 + 选项 + /或从Xcode的“编辑器”菜单中select“结构” – “添加文档”,它将为您生成以下评论模板:
/// <#Description#> /// /// - parameter bar: <#bar description#> /// /// - returns: <#return value description#>
它只是简化了快速帮助文档的编写。
这很可能与以下事实有关:如果您的键盘需要按Shift键才能获得,那么带有“/”的所有热键在当前的XCode 8版本中都不起作用。
即德国键盘上的'/'是shift + 7,按alt + cmd + shift-7不会做任何事情。 如果你指定即cmd + shift + opt + d,它工作得很好。
不幸的是,现在还不能正常工作的快捷方式“///”可能是由于旧的XCode插件VVDocumenter,它恰好使用了这个快捷方式。
function很强大,苹果方面糟糕的QA。