无论文档是通过键盘快捷键还是从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
}这是一个bug,还是我应该在某个地方更改设置?
发布于 2020-01-19 05:04:24
这是一个bug。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.
}我打开了a radar。也请通过Apple Feedback向它打开一个问题。??
https://stackoverflow.com/questions/58863020
复制相似问题