Bug 574183 - Every project should set 'Malformed Javadoc comment' to 'Error'
Summary: Every project should set 'Malformed Javadoc comment' to 'Error'
Status: NEW
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Releng (show other bugs)
Version: 4.21   Edit
Hardware: PC Linux
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Platform-Releng-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-06-14 05:07 EDT by Vikas Chandra CLA
Modified: 2022-02-03 15:27 EST (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Vikas Chandra CLA 2021-06-14 05:07:29 EDT 
Every project should set Malformed Javadoc comment to 'Error'

Steps:
1. Select the plug-in project
2. context menu > Properties
3. Go to Java Compiler->Javadoc
4. If the project is not yet using project specific settings, change it by enabling the checkbox
5. Change "Malformed Javadoc comments" to Error
6. Change "Only consider members as visible" to Public ( can be Private if preferred for more strict checking in a project)
7. Check Validate tag arguments 
8. Check Report non visible references
9. Check Report deprecated references

Fix any malformed javadoc issues in the project and commit this settings.

Post this, javadoc related issues in the I build would reduce ( if not totally stop).
Comment 1 Alexander Kurtakov CLA 2022-02-03 15:27:44 EST 
Do you plan to work on that ? While being nice to be that way I don't envision anyone doing it and having hundreds of bugs which no one acts on is just counterproductive/