Swift 5, Xcode 10.
При написании документации для моего кода я столкнулся с проблемой @escaping, в результате которой в окне документации появилось дополнительное поле с «- No Description» (как описано здесь ).
Итак, я изменил это:
private func myFunc(something: @escaping (FileObject?) -> ()) {}
к этому (как предложено здесь и здесь ):
/**
Description of myFunc.
- Parameters:
- something: Is something.
- f: Something else.
*/
private func myFunc(something: @escaping (_ f: FileObject?) -> ()) {}
, который выглядит так:
Почему он отображает описание для f в дополнительных полях и как мне заставить его вести себя как "нормальный" параметр?