@availability keyword not working in Xcode "alt+click" documentation helper

Question

I'm trying to document my header files and I really like the concept of alt+click documentation helper. Using code below I can set keywords like @param or @return or @see but unforunately @availability is not being displayed in the proper way.

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

The question is: how to set availability parameter in documentation helper?

Answer 1

You're looking for @since, not @availability.

For a comprehensive list of commands, see this question.

Answer 2

You need to user NS_AVAILABLE_IOS(5_0) to show the availability.
Here is an example:

/**
 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
}