Автоссылка Doxygen на классы Java не работает без квалификации

Согласно руководству по doxygen, "все слова в документации, соответствующие к задокументированному классу и содержат хотя бы один символ, отличный от нижнего регистра, будут автоматически заменены ссылкой на страницу, содержащую документацию по классу."

У меня есть класс Wibble (например).

Ни один из Wibble \ref Wibble \see Wibble в тексте не приводит к ссылке на класс Wibble. Однако, если я уточню имя с одним уровнем пакета, например. pobble.Wibble \ref pobble.Wibble' и т. д. все работает нормально (но выглядит нелепо).

Вопрос: ожидается ли это? Жук? или я где-то пропустил настройку?

Мои настройки:

Доксиген версии 1.8.5. AUTOLINK_SUPPORT установлено значение ДА. Во всей кодовой базе есть только один класс с именем Wibble, а полное имя пакета — com.snooze.banana.pobble, чего я не< /em> нужно указать. Путь INPUT включает java/blah/com/snooze/banana/pobble, а RECURSIVE включен. Расширение пути не имеет значения. /blah/ — это одна из трех одноранговых папок, но пути к двум другим папкам также не содержат Wibble.

Я знаю, что могу избавиться от наивности с помощью \ref pobble.Wibble "Wibble", но это так неэлегантно, а элегантность (или, по крайней мере, легкость сделать это правильно с первого раза без утомительного форматирования) является одной из причин использования doxygen в первую очередь.


person Cheeseminer    schedule 18.08.2014    source источник
comment
Не отличается под 1.8.7, до которой я только что обновился.   -  person Cheeseminer    schedule 18.08.2014
comment
Меня поразила похожая проблема с 1.8.13 и документированием кодовой базы C++. AUTOLINK_SUPPORT = YES но я получаю перекрестные ссылки только при добавлении пространства имен к каждому имени. Это не может быть так, как это должно работать   -  person Ichthyo    schedule 23.01.2021


Ответы (1)


Я заставляю его работать, но на самом деле у меня нет нескольких пакетов. Я предполагаю, что фактическое имя package.class, и поэтому он его не распознает. Это могло бы привести к неожиданным результатам, если бы было несколько классов с одинаковым именем, и поэтому это невозможно. Я бы посоветовал проверить псевдонимы http://www.doxygen.nl/manual/custcmd.html если вы не хотите добавлять пакет.

person emiliojorge    schedule 26.08.2014