Summary: | Unable to control level of JavaDoc errors | ||
---|---|---|---|
Product: | [Eclipse Project] JDT | Reporter: | Brian Pontarelli <brian> |
Component: | Core | Assignee: | Frederic Fusier <frederic_fusier> |
Status: | VERIFIED FIXED | QA Contact: | |
Severity: | normal | ||
Priority: | P3 | ||
Version: | 3.0 | ||
Target Milestone: | 3.0 M6 | ||
Hardware: | All | ||
OS: | All | ||
Whiteboard: |
Description
Brian Pontarelli
2003-12-02 18:53:50 EST
You can iuse different compiler setting for different projects. This might lower the number of flaged errors/warnings. Javadoc error detection is done by JDT/Core. Moving... Adding all platforms We could introduce yet another option to allow missing tags in javadocs... but then it weakens the value of Javadoc validation greatly IMHO. Need to think about it... or have more requests for it... Just wanted to add one more thing to this bug. This stems from a general dislike of Eclipse for very large software products. For example, if a project has 6000 classes and many developers, it is not only possible but an almost certainty that many people have not commented their code well. I do not feel the need to go and correct 30,000 JavaDoc problems just to appease the IDE I'm using. That is why I opened this bug. I feel that JavaDoc errors should have their own page personally. I'd like to be able to control every aspect of their errors. Missing tags, incorrect names, extra tags, new tags (i.e. I use @asserts for assertion JavaDoc), bad HTML or XHTML (even better), bad links/references, etc. Something else that would be really nice would be an option to control whether or not JavaDoc errors are displayed like compile errors. For example, I could turn all JavaDoc problems to the "error" setting, but uncheck the "display as compile errors" option. This would mean that not until I open a file are the errors added to the list of problems or displayed. Therefore, I could see the problems in the files I'm working in and not the files that the 100 other developers are working in. Verified for 3.0M6. |