Swift 3 错误：“另见”标注未显示

Question

我刚刚将我的项目迁移到 Swift 3，发现快速帮助中的“另请参阅”标注没有显示。在之前的 Swift 版本中，一切都运行良好。以下是我的代码：

/**
 Adds a "See also" callout in the Quick Help for a symbol using the `seealso` delimiter. Multiple "See also" callouts appear in the description section in the same order as they do in the markup.

 - author: Tapas Pal

 - remark: Use the callout to add references to other information.

 - seealso: [The Swift Standard Library Reference](https://developer.apple.com/library/prerelease/ios//documentation/General/Reference/SwiftStandardLibraryReference/index.html)
*/
class SeeAlsoMarkup: NSObject {
    static func doSomething() {}
}

输出如下：

Apple 对这个标记有什么改变吗？ Apple 的 See Also 标记格式参考仍将 seealso 显示为有效标注。

Answer 1

（XCode 11，Swift 5）

为了澄清这个问题，XCode 似乎可以识别文档 cmets 中的降价。如果你有类似的东西：

/// # Reference 
/// [Link to Reference](https://www.google.com)

它被记录为：

我不知道这是否像 @seealso 那样挂钩到文档关键字，因为 # 降价标签只是指一个标题样式。为了证明这一点，您可以使用# 标签将任意部分添加到您的文档中：

///  # Reference
///  [Link to Reference](https://www.google.com)
///  # Section
///  This is a new section of documentation
///  # Remark
///  New remark

获取记录为：

Answer 2

将seealso 替换为# Reference。