Swiftのブロックのパラメータに関するドキュメントのマークアップ形式は何ですか？

Question

マニュアル用のマークアップを追加すると、Swiftのブロックのパラメータがブロックのパラメータ用のテーブルに表示されますが、このテーブルの記入方法はわかりません。 Xcode markup reference formattingで検索しましたが、何も見つかりませんでした。

例：

AppleのAPIを

が完了ブロックパラメータテーブルが記入示しています

/** 
Foo 

- parameter completion: A block to execute 
*/ 
func foo(completion: (Bool) -> Void) { 
    // do something 
} 

これは私がoption + click Xcodeで機能に上記のドキュメントを表示する場合は、最大表示するものです。これはCloudKit APIドキュメントビューの例である：

Answer 1

あなたは、パラメータに名前を与える必要がありますが、アンダースコアでそれに先立つ：

/** 
Foo 

- parameter completion: A block to execute 
- parameter aflag: Some Bool flag 
*/ 
func foo(completion: (_ aflag: Bool) -> Void) { 
    // do something 
}