Автоматичната връзка на Doxygen към Java класове не работи, освен ако не е квалифициран

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

Имам клас Wibble (например).

Нито едно от Wibble \ref Wibble \see Wibble в текста не води до връзка към класа Wibble. Ако обаче квалифицирам името седно ниво на пакет, напр. pobble.Wibble \ref pobble.Wibble' и т.н. всичко работи добре (но изглежда наивно).

Въпрос: Това очаквано ли е? буболечка? или съм пропуснал някъде настройка?

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

Doxygen версия 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