Использование @link с Xcode 6
Я использую HeaderDoc для документирования своего кода и хотел бы сослаться на другие методы в документации. Я не пытаюсь сгенерировать HTML (по крайней мере, на данный момент), но я хочу, чтобы он появился на правой панели XCode. Ниже приведена документация для -applicationDidEnterBackground: как это появляется в Xcode. Я хочу получить эти синие ссылки, ссылающиеся на другие методы, которые я написал сам:
Документы говорят, чтобы использовать @link, но это не похоже на работу:
Вот что я попробовал:
/**
* @abstract Returns an array with a copy of all elements in the heap in sorted order.
*
* @discussion The original heap remains unchanged. This getter uses Heap Sort which takes O(n log n),
* although it copies the heap first (in linear time). If losing the elements on the heap is
* acceptable you should use @link -removeAllObjectsWithArray: @/link instead, which is faster.
*/
Вот результат:
Как вы видите, он не рендерится правильно. Я прочитал здесь, что @link не работает, но комментарий датируется 2013 годом. Есть ли исправление? Я делаю это неправильно?
Изменить: я попробовал предложение Санты, это результат:
/**
* @abstract Whether the heap is empty.
*
* @discussion An empty heap contains no objects, in which case this property returns <code>YES</code>.
* Returns <code>NO</code> otherwise, which also implies that calls to {@link count}
* return zero.
*/
Отображается как:
