objective-c - 如何用 doxygen 记录 Objective-C 块？

Question

我正在研究一个基于 doxygen 文档的项目，但我不知道如何记录一个块。让我们想象一个带有块作为回调的异步函数

- (void)startWithCompletionBlock:(void (^)(BOOL success, NSError *error))block;

应该如何记录这个参数？

Answer 1

如文档中所示，评论一个块看起来像这样

/**
 *@brief Short description
 *
 * Extended description
 *
 *@param[in/out/in,out] success
 *@param[in/out/in,out] error
 */
(void)startWithCompletionBlock:(void (^)(BOOL success, NSError *error))block;