Согласно руководству по 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 в первую очередь.
AUTOLINK_SUPPORT = YES
но я получаю перекрестные ссылки только при добавлении пространства имен к каждому имени. Это не может быть так, как это должно работать - person Ichthyo   schedule 23.01.2021