Doxygen: как ссылаться на общий интерфейс Java в документации

У меня есть интерфейс Java с документацией doxygen.

public interface Service< T , U > {
    ...
}

Doxygen создает документ для класса Service< T, U >. Когда я пытаюсь сослаться на эту страницу документа с какой-либо другой страницы с тегом @ref @ref Service< T , U>, генерируется предупреждение:

warning: unable to resolve reference to 'Service' for \ref command

Похоже, @ref не дружит с «‹» в имени.

Кто-нибудь знает какой-нибудь обходной путь для ссылки на класс с "‹" в названии?


java doxygen
person Dmitry Latnikov    schedule 09.08.2013    source источник
comment
Вы пробовали @ref Service?   -  person Lake    schedule 09.08.2013
comment
Да, конечно. Результат тот же - предупреждение. И понятно почему - документ создан для Сервиса‹T,U›, так что надо как-то ссылаться на него...   -  person Dmitry Latnikov    schedule 09.08.2013

Ответы (1)


arrow_upward
0
arrow_downward

Я попытался воспроизвести вашу проблему на следующем примере:

/** A service */
public interface Service< T , U > {
}


/** @mainpage
 *  See @ref Service<T,U> "the service interface" for details.
 */

но он работал нормально (как я и ожидал).

person doxygen    schedule 10.08.2013
comment
Проблема решена после перехода с версии doxygen 1.7.6.1 на 1.8.4. Спасибо за помощь - person Dmitry Latnikov; 12.08.2013