Xcode 11：添加文档不包含退货

Question

每当通过键盘快捷键或 Xcode 编辑器生成文档时，Xcode 都不会生成returns文档。

生成的文档示例：

/// <#Description#>
/// - Parameter message: <#message description#>
func greeting(message: String) -> String {
return message
}

应该是：

/// <#Description#>
/// - Parameter message: <#message description#>
/// - Returns: <#.....#>
func greeting(message: String) -> String {
return message
}

这是一个错误还是我应该在某处更改设置？

Answer 1

这是一个错误。Xcode的"添加文档"也完全忽略了throws。

例如，对于一个receives parameters、throws和returns的函数，这就是我得到的：

快捷方式：⌘ + ⌥ + /

/// <#Description#>
/// - Parameters:
///   - size: <#size description#>
///   - settings: <#settings description#>
func context(for size: CGSize, settings: SImageSettings = SImageSettings()) throws -> CGContext {
// Function body.
}

预期：

/// <#Description#>
/// - Parameters:
///   - size: <#size description#>
///   - settings: <#settings description#>
/// - Throws: 👈🏻👈🏻
/// - Returns: 👈🏻👈🏻
func context(for size: CGSize, settings: SImageSettings = SImageSettings()) throws -> CGContext {
// Function body.
}

我打开了一个雷达。 也请通过苹果反馈打开一个问题。👍🏻