Eclipse Community Forums: Java Development Tools (JDT) » How to suppress javadoc compiler warning for public static attributes?

Home » Language IDEs » Java Development Tools (JDT) » How to suppress javadoc compiler warning for public static attributes?

Show: Today's Messages :: Show Polls :: Message Navigator

How to suppress javadoc compiler warning for public static attributes? [message #635218]

Tue, 26 October 2010 03:51

Velganesh Subramanian

Messages: 69
Registered: July 2009

Member

I have turned on compiler for javadoc also since I would like to maintain javadoc as in Eclipse code. I have classes that has constants (public static final) and classes that extend NLS for i18n. The attributes are public and the names are self explanatory and they do not deserve javadoc. The compiler generates warning since the attributes are public and there is no way to suppress this. Or, is there a way to suppress?

Can this be a new feature request for JDT UI?

Report message to a moderator

Re: How to suppress javadoc compiler warning for public static attributes? [message #635243 is a reply to message #635218]

Tue, 26 October 2010 07:40

Dani Megert

Messages: 3802
Registered: July 2009

Senior Member

Velganesh Subramanian wrote:
> I have turned on compiler for javadoc also since I would like to
> maintain javadoc as in Eclipse code. I have classes that has constants
> (public static final) and classes that extend NLS for i18n. The
> attributes are public and the names are self explanatory and they do
> not deserve javadoc. The compiler generates warning since the
> attributes are public and there is no way to suppress this. Or, is
> there a way to suppress?
Add @SuppressWarnings("all") before the declaration.

Dani
>
> Can this be a new feature request for JDT UI?

Report message to a moderator

Re: How to suppress javadoc compiler warning for public static attributes? [message #635503 is a reply to message #635243]

Wed, 27 October 2010 07:09

Velganesh Subramanian

Messages: 69
Registered: July 2009

Member

Is it a good practice to suppress ALL warnings? I don't think so.

I use Checkstyle to check for proper javadoc - it throws too many wanrings and my editor is filled with Checkstyle comments. I guess there is no way out.

Report message to a moderator

Re: How to suppress javadoc compiler warning for public static attributes? [message #635515 is a reply to message #635503]

Wed, 27 October 2010 07:31

Dani Megert

Messages: 3802
Registered: July 2009

Senior Member

Velganesh Subramanian wrote:
> Is it a good practice to suppress ALL warnings? I don't think so.
Well, how many other warnings do you expect on a field declaration? And
while we're at it: is it a good practice not to Javadoc your public
members? ;-)

Dani
>
> I use Checkstyle to check for proper javadoc - it throws too many
> wanrings and my editor is filled with Checkstyle comments. I guess
> there is no way out.

Report message to a moderator