From 410bc96fd4f894557752d1a10151e15c4022ab67 Mon Sep 17 00:00:00 2001 From: Joe Darcy Date: Tue, 31 Mar 2015 08:48:53 -0700 Subject: [PATCH] 8075081: Fix missing doclint warnings in java.awt Reviewed-by: serb --- .../share/classes/java/awt/AWTEventMulticaster.java | 3 ++- .../share/classes/java/awt/Component.java | 6 +++++- .../share/classes/java/awt/MenuComponent.java | 3 ++- .../share/classes/java/awt/MenuContainer.java | 3 ++- .../share/classes/java/awt/MenuItem.java | 3 ++- .../share/classes/java/awt/Toolkit.java | 13 +++++++++++-- .../java.desktop/share/classes/java/awt/Window.java | 4 +++- 7 files changed, 27 insertions(+), 8 deletions(-) diff --git a/jdk/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java b/jdk/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java index 01e42428a73..8297188f1f9 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java +++ b/jdk/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -1088,6 +1088,7 @@ public class AWTEventMulticaster implements * contains only the specified listener. If no such listeners are chained, * this method returns an empty array. * + * @param the listener type * @param l the specified java.util.EventListener * @param listenerType the type of listeners requested; this parameter * should specify an interface that descends from diff --git a/jdk/src/java.desktop/share/classes/java/awt/Component.java b/jdk/src/java.desktop/share/classes/java/awt/Component.java index a5e8dfee50c..72e473d8465 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/Component.java +++ b/jdk/src/java.desktop/share/classes/java/awt/Component.java @@ -4316,9 +4316,12 @@ public abstract class Component implements ImageObserver, MenuContainer, */ protected boolean validatedContents; // = false /** - * Size of the back buffers + * Width of the back buffers */ protected int width; + /** + * Height of the back buffers + */ protected int height; /** @@ -6013,6 +6016,7 @@ public abstract class Component implements ImageObserver, MenuContainer, * * If no such listeners exist, this method returns an empty array. * + * @param the type of the listeners * @param listenerType the type of listeners requested; this parameter * should specify an interface that descends from * java.util.EventListener diff --git a/jdk/src/java.desktop/share/classes/java/awt/MenuComponent.java b/jdk/src/java.desktop/share/classes/java/awt/MenuComponent.java index 64b1db9bf06..f9f9f28da0d 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/MenuComponent.java +++ b/jdk/src/java.desktop/share/classes/java/awt/MenuComponent.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -328,6 +328,7 @@ public abstract class MenuComponent implements java.io.Serializable { * Its use is discouraged, and it may not be supported * in the future. * @param evt the event which is to take place + * @return unconditionally returns false * @deprecated As of JDK version 1.1, replaced by {@link * #dispatchEvent(AWTEvent) dispatchEvent}. */ diff --git a/jdk/src/java.desktop/share/classes/java/awt/MenuContainer.java b/jdk/src/java.desktop/share/classes/java/awt/MenuContainer.java index 8ba5e70245b..995c7d4ceb6 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/MenuContainer.java +++ b/jdk/src/java.desktop/share/classes/java/awt/MenuContainer.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -50,6 +50,7 @@ public interface MenuContainer { * Posts an event to the listeners. * * @param evt the event to dispatch + * @return the results of posting the event * @deprecated As of JDK version 1.1 * replaced by dispatchEvent(AWTEvent). */ diff --git a/jdk/src/java.desktop/share/classes/java/awt/MenuItem.java b/jdk/src/java.desktop/share/classes/java/awt/MenuItem.java index ab797f4dd1a..e70ec305cdf 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/MenuItem.java +++ b/jdk/src/java.desktop/share/classes/java/awt/MenuItem.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -595,6 +595,7 @@ public class MenuItem extends MenuComponent implements Accessible { * * If no such listeners exist, this method returns an empty array. * + * @param the type of the listeners * @param listenerType the type of listeners requested; this parameter * should specify an interface that descends from * java.util.EventListener diff --git a/jdk/src/java.desktop/share/classes/java/awt/Toolkit.java b/jdk/src/java.desktop/share/classes/java/awt/Toolkit.java index 985c946f422..9b3ad9b5777 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/Toolkit.java +++ b/jdk/src/java.desktop/share/classes/java/awt/Toolkit.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -1766,6 +1766,7 @@ public abstract class Toolkit { * * subclasses should override this to provide their own implementation * + * @param the type of DragGestureRecognizer to create * @param abstractRecognizerClass The abstract class of the required recognizer * @param ds The DragSource * @param c The Component target for the DragGestureRecognizer @@ -1867,7 +1868,9 @@ public abstract class Toolkit { } /** - * an opportunity to lazily evaluate desktop property values. + * An opportunity to lazily evaluate desktop property values. + * @return the desktop property or null + * @param name the name */ protected Object lazilyLoadDesktopProperty(String name) { return null; @@ -1947,8 +1950,14 @@ public abstract class Toolkit { return desktopPropsSupport.getPropertyChangeListeners(propertyName); } + /** + * The desktop properties. + */ protected final Map desktopProperties = new HashMap(); + /** + * The desktop properties change support. + */ protected final PropertyChangeSupport desktopPropsSupport = Toolkit.createPropertyChangeSupport(this); diff --git a/jdk/src/java.desktop/share/classes/java/awt/Window.java b/jdk/src/java.desktop/share/classes/java/awt/Window.java index 5f819cda87a..56ca461a90b 100644 --- a/jdk/src/java.desktop/share/classes/java/awt/Window.java +++ b/jdk/src/java.desktop/share/classes/java/awt/Window.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -2789,6 +2789,7 @@ public class Window extends Container implements Accessible { /** * @deprecated As of J2SE 1.4, replaced by * {@link Component#applyComponentOrientation Component.applyComponentOrientation}. + * @param rb the resource bundle */ @Deprecated public void applyResourceBundle(ResourceBundle rb) { @@ -2798,6 +2799,7 @@ public class Window extends Container implements Accessible { /** * @deprecated As of J2SE 1.4, replaced by * {@link Component#applyComponentOrientation Component.applyComponentOrientation}. + * @param rbName the resource name */ @Deprecated public void applyResourceBundle(String rbName) {