如何使用doxygen记录Objective-C块？

Question

我正在研究基于doxygen文档的项目，我无法弄清楚如何记录块。让我们设想一个带有块作为回调的异步函数

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

如何记录这个参数？

Answer 1

正如documentation所示，评论一个块看起来像这样

/**
 *@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;