ios - 注释标记@code 不适用于属性

Question

我正在为 Xcode 中的快速帮助功能记录我的 Objective-C 代码，如下所示:

但是我在记录属性时遇到了一个小问题:可以使用标签@code吗？

因为这条评论不起作用:

/** 
 the URL base for backend APIs
 @code
 codeexample;
 @endcode
*/
@property (nonatomic, strong) NSString *baseUrl;

但这行得通:

/** 
 the URL base for backend APIs
*/
@property (nonatomic, strong) NSString *baseUrl;

也许 @code 标签不能与属性一起使用？还是我做错了什么？

Answer 1

这种风格的文档不适用于属性，仅适用于方法。这就是为什么 @psobko 的示例有效而您的示例无效。他们记录了方法定义。