JDK-7054669 : javadoc warnings from java.awt.Toolkit
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.awt
  • Affected Version: 8
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2011-06-14
  • Updated: 2013-07-10
  • Resolved: 2011-07-06
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8 b01Fixed
Related Reports
Relates :  
Description
The API changes in 7020922 "java.awt.Toolkit.getPropertyChangeListeners() should mention that it returns proxies" introduced a number of javadoc warnings from references to PropertyChangeListenerProxy not having a fully qualified name (or an added import) and for an extra space after the "@" in a javadoc tag.

Comments
SUGGESTED FIX # HG changeset patch # User darcy # Date 1308079891 25200 # Node ID 4e7a9fa84dea807567785921bf61906fdab80823 # Parent 08fdfdb19ad6d7037d2c50bde4c7e0ce3ec8c6b4 7054669: javadoc warnings from java.awt.Toolkit Reviewed-by: anthony --- a/src/share/classes/java/awt/Toolkit.java Tue Jun 14 18:05:42 2011 +0100 +++ b/src/share/classes/java/awt/Toolkit.java Tue Jun 14 12:31:31 2011 -0700 @@ -1856,9 +1856,11 @@ public abstract class Toolkit { } /** - * Adds the specified property change listener for the named desktop - * property. When a {@link PropertyChangeListenerProxy} object is added, - * its property name is ignored, and the wrapped listener is added. + * Adds the specified property change listener for the named + * desktop property. When a {@link + * java.beans.PropertyChangeListenerProxy + * PropertyChangeListenerProxy} object is added, its property name + * is ignored, and the wrapped listener is added. * If {@code name} is {@code null} or {@code pcl} is {@code null}, * no exception is thrown and no action is performed. * @@ -1874,9 +1876,10 @@ public abstract class Toolkit { /** * Removes the specified property change listener for the named - * desktop property. When a {@link PropertyChangeListenerProxy} object - * is removed, its property name is ignored, and - * the wrapped listener is removed. + * desktop property. When a {@link + * java.beans.PropertyChangeListenerProxy + * PropertyChangeListenerProxy} object is removed, its property + * name is ignored, and the wrapped listener is removed. * If {@code name} is {@code null} or {@code pcl} is {@code null}, * no exception is thrown and no action is performed. * @@ -1896,7 +1899,7 @@ public abstract class Toolkit { * contains {@code PropertyChangeListenerProxy} objects * that associate listeners with the names of desktop properties. * - * @return all of this toolkit's {@ code PropertyChangeListener} + * @return all of this toolkit's {@code PropertyChangeListener} * objects wrapped in {@code PropertyChangeListenerProxy} objects * or an empty array if no listeners are added *
14-06-2011

EVALUATION Javadoc warnings are bad.
14-06-2011

PUBLIC COMMENTS See http://hg.openjdk.java.net/jdk8/tl/jdk/rev/4e7a9fa84dea
14-06-2011