objective-c - 为 Xcode 5 的快速帮助⁣帮助创建枚举文档字符串

Question

我想在 Xcode 5 中记录一个枚举，这样我就可以在自动完成弹出窗口中看到我的文档字符串作为快速帮助。例如，如果我这样做:

//! Better than a normal int!
typedef int superint;

然后我可以输入 superi，弹出窗口显示 superint，并且在弹出窗口的底部显示“比普通 int 更好!”。

不过，我似乎无法想出任何方法来让它在枚举中工作。我的枚举看起来像这样:

typedef enum: unsigned int {
    a = 1,
    b = 2,
    c = 3,
} abc_t;

前置 //!(或 /// 或 /**)行在这种情况下不起作用。我输入“abc_”，完成出现在弹出窗口中，但底部没有文档字符串。

我的一个想法是 Apple 可能会更好地支持使用他们的 NS_ENUM() 宏，但是 //! 在 typedef NS_ENUM(...) { ... 也不起作用。

我查看了 Foundation 的标题以寻找可行的示例，但我认为他们一定在做一些特别的事情。例如，NSXMLParserError 是一个枚举，它在自动完成弹出窗口中显示文档字符串(如果您键入“NSXMLParserE”)，但在 NSXmlParser.h 中它有一个普通的 // 注释在它之前的线上。在我自己的代码中遵循这种风格不会在弹出窗口中显示文档字符串。

Answer 1

我找到了一种让它工作的方法，但它有点难看:

typedef enum: unsigned int {
    //! First letter
    ABC_A = 1,
    //! Second letter
    ABC_B = 2,
    //! Third letter
    ABC_C = 3,
}
//! Now I know my ABC's.
abc_t;

我希望有一个解决方案可以让我将文档字符串保留在声明的之上，就像它在所有其他上下文中一样。