[Doxygen-users] Java: Annotations prevent Doxygen from documenting class (completely)

[starfuryAll <mar...@al...>]

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.