Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 355777 - javadoc warnings occur even though prefs say Ignore for all
Summary: javadoc warnings occur even though prefs say Ignore for all
Status: RESOLVED WORKSFORME
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.8   Edit
Hardware: Macintosh Mac OS X - Carbon (unsup.)
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-08-24 20:01 EDT by Ray Kiddy CLA
Modified: 2011-08-25 01:38 EDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Ray Kiddy CLA 2011-08-24 20:01:49 EDT
Build Identifier: 20110218-0911


An example is this:

    /**
     * Utility method to set credentials for basic authorization.
     * 
     */
    public void setCredentials(String userName, String password) {
    ...
    }

I get a "Javadoc: Missing tag for parameter userName" and "Javadoc: Missing tag for parameter password" warning.

Yet, when I go to Preferences->Java->Compiler->Javadoc, the 'Process Javadoc comments' can be checked or not, and all the options are greyed out and/or set to 'Ignore'. Yet, I still see these warnings in my code.

How can I get rid of these warnings if not here?

Why is there not a switch for these warnings in Preferences->Java->Compiler->Errors/Warnings?


Reproducible: Always
Comment 1 Ayushman Jain CLA 2011-08-25 01:07:34 EDT
I think your project settings and workspace settings are different. Please right click on your project and then go to Preferences->Java->Compiler->Javadoc. Configure your warnings there, instead of doing it from the "Window" menu. Thanks!
Comment 2 Ray Kiddy CLA 2011-08-25 01:38:29 EDT
It is a little harder to get to the project-specific settings, as I do not have a 3-button mouse. But I found it. Wow. I cannot believe someone checked our project in with those obnoxious preferences set.

I guess the UI could help a bit here. If there are project-specific settings, the Preferences window has a link for 'Configure Project-Specific Settings...'. And if there are no project-specific settings, the Preferences window has a link for 'Configure Project-Specific Settings...'.

There could be a difference in the UI here. But that is a more minor issue. Ok to close.