@availability关键字在Xcode中不起作用＆＃34; alt + click＆＃34;文档助手

Question

我正在尝试记录我的头文件，我非常喜欢alt + click documentation helper的概念。 使用下面的代码我可以设置@param或@return或@see等关键字，但不幸的是@availability没有以正确的方式显示。

/**
 * Super method for super feature
 *
 * @param someParameter super cool method parameter
 *
 * @availability Version 3.0 (and later)
 *
 * @return void
 */

问题是：如何在文档助手中设置可用性参数？

Answer 1

您正在寻找@since，而不是@availability。

有关命令的完整列表，请参阅this question。

Answer 2

您需要用户NS_AVAILABLE_IOS(5_0)来显示可用性。
这是一个例子：

/**
 Check whether a file at a given URL has a newer timestamp than a given file.
 Example usage:
 @code
 NSURL *url1, *url2;
 BOOL isNewer = [FileUtils
 isThisFileNewerThanThatFile:url1 thatURL:url2];
 @endcode
 @param index
 The index
 @return the results
 */
- (UIImage*)imageForSectionIndex:(NSUInteger)index NS_AVAILABLE_IOS(6_0){
   // your implem
}