objective-c - 如何评论 Apple 的 Doxygen 块扩展？

Doxygen announced in their changelog for version 1.7.2 to support Apple's block extension 。我想知道生成文档的语法是什么。我找不到任何提示 - 在 doxygen 配置文件(1.7.2 版)中也找不到。
更新: 1.7.5 版本于 2011 年 8 月 14 日发布。我仍然没有找到如何为 Apple 块编写文档。

最佳答案

看看 1.7.1 和 1.7.2 之间的差异，我相信这一行的意思是 Doxygen 扫描器已更新以在识别 typedefs 块类型时支持 Apple 的块语法。例如，您可以像这样记录一个函数指针 typedef:

///
/// This is a typedef for a function pointer type.
/// It takes an NSUInteger parameter, an id adopting protocol Foo, and has no return value.
///
typedef void (*MyFunctionPtrType)(NSUInteger p1, id<Foo> p2);

并得到这样的输出:

对扫描器的更改似乎增加了对块类型定义的支持，如下所示:

///
/// This is a typedef for a block type.
/// It takes an NSUInteger parameter, an id adopting protocol Foo, and has no return value.
///
typedef void (^MyBlockType)(NSUInteger p1, id<Foo> p2);

事实上，使用最新版本的 Doxygen，它会产生如下输出:

您可以记录块类型的全局变量，但这种行为有点不稳定。例如，有了这个:

///
/// This is a global variable of type MyBlockType. It logs the parameters to the console.
///
MyBlockType myGlobalBlock = ^(NSUInteger p1, id<Foo> p2){

    /**
     * This is a block comment inside my block, which would get
     * concatted into the "in body" description if this were a function.
     * but won't be because this is a block.
     */
    NSLog(@"p1: %lu p2: %@", p1, p2);
};

///
/// This is the definition for the function MyFunction
///
void MyFunction(NSUInteger p1, id<Foo> p2)
{
    /**
     * This is a block comment inside my function, which will get
     * concatted into the "in body" description.
     */

    NSLog(@"p1: %lu p2: %@", p1, p2);
}

我得到这个输出，有点，有点不是我想要的:

幸运的是，我怀疑块类型的全局变量在实践中并不是那么常见的模式，因此 Doxygen 在处理它们方面不是非常出色的事实并不是什么大问题。似乎没有任何证据表明对差异中的块有任何进一步的支持。

关于objective-c - 如何评论 Apple 的 Doxygen 块扩展？，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/3916078/