带有委托协议的 Headerdoc - Swift 和 xcode 7.2

Question

我已经定义了一个协议，并为这个协议中的方法添加了HeaderDoc文档。当我 Option+Click 方法时它正确显示：

但是，当我在实现此协议的控制器中选择并单击实现时，文档没有显示：

我的期望是我为协议编写的文档会出现在控制器中，类似于 Apple 的文档：

如何让我的协议文档在其他地方可见？

Answer 1

如果您在协议扩展中记录协议的方法实现，则该文档将在符合该协议的任何类型中可见。

如果您省略扩展的文档，协议中的 canDo 文档不会显示在协议本身之外的任何其他地方，正如您注意到的那样。

protocol Doable {
    /// Does something
    func canDo()
}

extension Doable {
    /// Does something really well
    func canDo() {
        print("Did it!")
    }
}

struct Task: Doable {
    init() {
        canDo()
    }
}

带有委托协议的 Headerdoc - Swift 和 xcode 7.2

Headerdoc with delegate Protocols - Swift and xcode 7.2

xcode

headerdoc

appledoc

swift