Eclipse - @SuppressWarnings("javadoc") does not work

Question

Hi,

I have my Eclipse configured to show warnings on missing javadoc comments and tags for public elements. That comes very usefull for me in order to keep my code well documented.

But sometimes I have a class, where I have several constants describing for example states of DFA or something.. theres no need to document theese constant, because they are self-explaining..

So I added annotation @SuppressWarnings("javadoc") to the class and here's my point - Eclipse does not concider the annotation and still shows warnings on missing javadocs..

@SuppressWarnings("all") does the job, but that has side effects, which are not desired ;-)

Are you experiencing the same issue? Is this a bug or do I only have something missconfigured? Is there any workaround? Or is this corrected in newer versions?

PS: I'm using Version: 3.3.2 Build id: M20080221-1800

Answer 1

have you tried "allJavadoc" ?

Answer 2

I found this bug, which is still open.

Answer 3

At the end of this page you will find all SuppressWarning options which are handled in Eclipse. Unfortunately currently there is no support for suppressing just javadoc warnings. The bug Andrew mentioned is really a feature request for adding this but it seems to have low priority (you can vote for this bug to show Eclipse developers the importance of this feature for you).