Xcode中 - 添加自定義的文檔斯威夫特關閉

Question

問：到自定義Swift封閉

• 什麼是正確的格式添加文件（使用內置的功能不是第三方）在Xcode 8？
• 您能否提供Apple文檔鏈接以供參考？
• 如何指定closureparameters？
• 如何指定closurereturn type？

例子：

struct S1 { 

    /// This block is executed after completion 
    var completion : (String, Int) -> (Bool) 
} 

注：

Xcode 8已建成功能文檔添加到自定義代碼。

這可以做到的，通過執行以下操作中的一個：對碼

• Command + Option + Click

• 保持光標上代碼和Editor>Structure>Add documentation

Answer 1

參考：

• 更多信息參見Markup Formatting Reference即節「格式化快速幫助」

解決方法：

如果這些標籤不支持給定位置的唯一可能的解決方法似乎是現在：

struct S1 { 

    /// description 
    /// 
    /// __returns__ 
    /// blah blah 
    /// 
    /// __parameters__ 
    /// blah blah 
    var completion : (String, Int) -> (Bool) 
}