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。