Doxygen autolink to Java classes not working unless qualified -
according doxygen manual "all words in documentation correspond documented class , contain @ least 1 non-lower case character automatically replaced link page containing documentation of class."
i have class wibble
(for example).
none of wibble
\ref wibble
\see wibble
in text results in link wibble class. however, if qualify name one level of package, e.g. pobble.wibble
\ref pobble.wibble
' etc. works fine (but looks naff).
question: expected? bug? or have missed setting somewhere?
my settings:
doxygen version 1.8.5. autolink_support
set yes. there 1 class name wibble in whole codebase, , full package name com.snooze.banana.pobble whch don't need specify. input
path includes java/blah/com/snooze/banana/pobble
, recursive
on. extending path makes no difference. /blah/
1 of 3 peer folders, other 2 folder paths don't contain wibble either.
i know can hack naffness out \ref pobble.wibble "wibble"
that's inelegant, , elegance (or @ least, ease of getting right first time without hasslesome formatting) 1 of reasons using doxygen in first place.
i work don't have several packages. guess though actual name package.class , thats why doesn't recognise it. yeild unexpected results if there several classes same name , thats why it's not possible. suggestion checking out aliases http://www.stack.nl/~dimitri/doxygen/manual/custcmd.html if dont want have add package.
Comments
Post a Comment