This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
Summary: | [69cat] "Error in Javadoc" not always really an error | ||
---|---|---|---|
Product: | java | Reporter: | matthies <matthies> |
Component: | Javadoc | Assignee: | Jan Becicka <jbecicka> |
Status: | NEW --- | ||
Severity: | normal | ||
Priority: | P3 | ||
Version: | 6.x | ||
Hardware: | PC | ||
OS: | Windows XP | ||
Issue Type: | ENHANCEMENT | Exception Reporter: |
Description
matthies
2010-05-31 14:01:32 UTC
I'm not sure what you expect NB to do. Anyway it looks like enhancement. I'd expect "Error in Javadoc" to be restricted to erroneous syntax and stuff that the Javadoc tool considers to be an error or warning, such as dangling references. That would be really helpful for finding out about such errors without having to actually run the Javadoc tool. A missing "@param" tag though is not an error, as it's (like all tags) optional in javadoc. I consider it a bug that "Error in Javadoc" marks this as an error. It's like if a hint "Error in Java source code" would complain about some coding style issue. If warnings/errors for missing @param tags are wanted, that ought to be a different hint (e.g. "Missing recommended Javadoc tag"). |