Xcode8自動生成クイックヘルプドキュメント

Xcode 8で発表された新機能の中には、

「クイックヘルプドキュメントの自動生成」：

これは、NSHipsterからこの記事で学ぶことができるような手動コードドキュメントの終わりですか？

誰かがこの新機能の長所と短所を概説できますか？Jazzyのようなツールに取って代わりますか？

新機能に関する詳細情報が見つかりませんでした。

これは、Xcode 8（およびそれ以降）の機能を指し、次のような方法を選択できます。

func foo(bar: Int) -> String { ... }

...そして押し⌘+ option+ /（または「構造」»Xcodeのの『編集』メニューから『ドキュメントの追加』を選択してください）、それはあなたのために以下のコメントテンプレートを生成します。

/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>

クイックヘルプのドキュメントの作成を容易にするだけです。

この動作は時間の経過とともに少し変化しますが、Xcodeは、これを実行しようとするときにカーソルがどこにある必要があるかに注意を払うことができることに注意してください。たとえば、これが機能するにfooは、上記の例では、カーソルが関数名のどこかにある必要があります。それとも、二重の関数名をクリックし、キーを押し⌘+ option+/

これは、キーボードがShiftキーを押して取得する必要がある場合、現在のXCode8ビルドでは「/」が付いたすべてのホットキーが機能しないという事実に関連している可能性があります。

つまり、ドイツ語キーボードの「/」はshift + 7であり、alt + cmd + shift-7を押しても何も起こりません。つまり、cmd + shift + opt + dを割り当てると、問題なく機能します。

残念ながら現在も機能しないショートカット「///」は、おそらくこのショートカットを正確に使用していた古いXCodeプラグインVVDocumenterが原因です。

素晴らしい機能、Apple側のひどいQA。