-
Bug
-
Resolution: Duplicate
-
P4
-
None
-
1.2.0
-
None
-
sparc
-
solaris_2.6
Warning messages are inconsistent in Javadoc and doclets.
Many warning messages that Javadoc emits properly show the fully qualified
name of the member where the problem exists:
Warning: java.awt.Scrollbar.Scrollbar(): Unsupported HTML tag
in documentation comment "</table>"
However not all messages do this. For example:
Warning: Tag @see: Class or Package not found: java.awtScrollbar#setValues
Also, some begin with "warning" (above), while others begin with "javadoc":
javadoc: warning - java.awt.SystemColor.getRGB(): Tag @see: can't find
getBlue(int) in java.awt.Color
It would be easier to scan down the list if they were consistent.
If it makes the line too long to include the fully-qualified class name,
then at least give the raw class name.
Many warning messages that Javadoc emits properly show the fully qualified
name of the member where the problem exists:
Warning: java.awt.Scrollbar.Scrollbar(): Unsupported HTML tag
in documentation comment "</table>"
However not all messages do this. For example:
Warning: Tag @see: Class or Package not found: java.awtScrollbar#setValues
Also, some begin with "warning" (above), while others begin with "javadoc":
javadoc: warning - java.awt.SystemColor.getRGB(): Tag @see: can't find
getBlue(int) in java.awt.Color
It would be easier to scan down the list if they were consistent.
If it makes the line too long to include the fully-qualified class name,
then at least give the raw class name.
- duplicates
-
JDK-4208989 Provide more information with warnings
-
- Closed
-