objective-c - Doxygen 和 Objective-C 类别

Question

虽然最新版本的 Doxygen claim better handling of Objective-C categories ，它似乎仍然对我的源代码中的类别感到窒息。我想知道是否有人已将其正确记录类别。

例如，我在 NSString 上定义了一个类别:

@interface NSString (CCFExtensions)

带有一个名为 NSString_CCFExtensions.h 的接口(interface)文件和一个名为 NSString_CCFExtension.m 的实现文件

Doxygen 将引用具有父类(super class)的文件；但是没有记录任何类别方法，尽管看似有效的 doxygen 语法。

使 Objective-C 类别正常工作的正确源代码标记是什么？

Answer 1

经过一些回归测试(和一些常识)后的解决方案:

假设我在 NSObject 上有一个类别 Cat1，为了让 doxygen 解析我的类别头文件，它应该大致如下所示:

#import <Cocoa/Cocoa.h>

/*! \category NSObject(Cat1) 
    \abstract A category on NSObject
*/

@interface NSObject(Cat1)
    - (void)foo;
@end

和实现文件:

#import "NSObject_Cat1.h"

@implementation NSObject(Cat1)

- (void)foo {
    //  do something
}

@end

重要的是，类名和类别名之间不要有空格。