如何将 Xcode“添加文档”改回块样式注释

Wil*_*iuk 5 xcode

Does anyone know how to change the Add Documentation single line commenting style in Xcode 11 back to the block commenting style of Xcode 10?

Context

Xcode 10 provided us with the ability to document functions and methods with either Editor -> Structure -> Add Documentation by pressing command + option + / and this would insert a comment above a function or method with the traditional C block comments style to permit easy documentation as in the filled-out example:

/**
 Flashes the garage door opener light (built in) to give
 indication as to what might be going on.

 For example, we might flash it 0.25 second interval for 2
 seconds to indicate that the garage door is going to close
 or we might flash it with an SOS pattern if the
 garage door is jammed

 @param flashPattern    flashPattern enumerated to indicate
                        what pattern to flash on the garage
                        door light to indicate status
                        of the garage door opener
 */
void FlashGarageDoorOpenerLight(GarageDoorOpenerLightFlashPatterns flashPattern) {
Run Code Online (Sandbox Code Playgroud)

Xcode pulls the parameters out of the function declaration and adds in the @param for each. Just tab between the description and parameter place holders and fill them out. This was really great albeit not perfect...

现在Add DocumentationXcode 11 将行尾注释样式斜杠 /// 放在每一行的前面:

/// Flashes the garage door opener light (built in) to give
/// indication as to what might be going on.
///
/// For example, we might flash it 0.25 second interval for 2
/// seconds to indicate that the garage door is going to close
/// or we might flash it with an SOS pattern if the
/// garage door is jammed
///
/// @param flashPattern flashPattern    enumerated to indicate
///                                     what pattern to flash on the garage
///                                     door light to indicate status
///                                     of the garage door opener
void FlashGarageDoorOpenerLight(GarageDoorOpenerLightFlashPatterns flashPattern) {
Run Code Online (Sandbox Code Playgroud)

在每一行都有所有这些额外的 /// 在视觉上会分散注意力,并且似乎没有任何方法可以将 Xcode 恢复到简单干净的块注释样式,因此出现了这个问题。