Hi!
I'm new to Doxygen, installed 1.8.8 only today trying to create documenation
of my project.
Unfortunately I already came across a problem which seems to be a bug. Or I
just wasn't able to find a documented solution. Please forgive me if the
latter is the case, and thanks for any hints.
The problem I came across is similar to the problem described in the forum
post " Possible bug while producing documentation of java method which uses
generics
<http://doxygen.10944.n7.nabble.com/Possible-bug-while-producing-documentation-of-java-method-which-uses-generics-td6781.html>
" only with the difference that it isn't related to generics but to
annotations.
Annotated Class
If a java class is annotated, Doxygen does not produce any class
documenation or index entry for that class. (Although, it is listed in the
'File list'.)
The "@SuppressWarnings" annotation here was only used to illustrate the
problem, it occurs with other (custom) annotations as well. For a reason
unknown to me the problem does /not/ occur with the "@Deprecated"
annotation.
Annotated Method
If a method is annotated Doxygen does create class documenation up until the
the method with the annotation. The annotated method all methods thereafter
are missing in the output.
Again, the "@SuppressWarnings" annotation here was only used to illustrate
the problem, it occurs with other (custom) annotations as well.
Without annotations the output looks like expected.
I also attach my .doxyfile to review the generator settings: test.doxyfile
<http://doxygen.10944.n7.nabble.com/file/n6802/test.doxyfile>
Thanks in advance for confirmation, any hints or even better a fix! ;-)
Markus
--
View this message in context: http://doxygen.10944.n7.nabble.com/Java-Annotations-prevent-Doxygen-from-documenting-class-completely-tp6802.html
Sent from the Doxygen - Users mailing list archive at Nabble.com.
|
