stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8075081: Fix missing doclint warnings in java.awt

Browse Source 
Reviewed-by: serb
This commit is contained in:
Joe Darcy 2015-03-31 08:48:53 -07:00
parent 68aa2c14c2
commit 410bc96fd4
7 changed files with 27 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
jdk/src/java.desktop/share/classes/java/awt/AWTEventMulticaster.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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, * contains only the specified listener. If no such listeners are chained,
* this method returns an empty array. * this method returns an empty array.
* *
* @param <T> the listener type
* @param l the specified <code>java.util.EventListener</code> * @param l the specified <code>java.util.EventListener</code>
* @param listenerType the type of listeners requested; this parameter * @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from * should specify an interface that descends from

6
jdk/src/java.desktop/share/classes/java/awt/Component.java
View File

@ -4316,9 +4316,12 @@ public abstract class Component implements ImageObserver, MenuContainer,
*/ */
protected boolean validatedContents; // = false protected boolean validatedContents; // = false
/** /**
* Size of the back buffers * Width of the back buffers
*/ */
protected int width; protected int width;
/**
* Height of the back buffers
*/
protected int height; 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. * If no such listeners exist, this method returns an empty array.
* *
* @param <T> the type of the listeners
* @param listenerType the type of listeners requested; this parameter * @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from * should specify an interface that descends from
* <code>java.util.EventListener</code> * <code>java.util.EventListener</code>

3
jdk/src/java.desktop/share/classes/java/awt/MenuComponent.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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 * Its use is discouraged, and it may not be supported
* in the future. * in the future.
* @param evt the event which is to take place * @param evt the event which is to take place
* @return unconditionally returns false
* @deprecated As of JDK version 1.1, replaced by {@link * @deprecated As of JDK version 1.1, replaced by {@link
* #dispatchEvent(AWTEvent) dispatchEvent}. * #dispatchEvent(AWTEvent) dispatchEvent}.
*/ */

3
jdk/src/java.desktop/share/classes/java/awt/MenuContainer.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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. * Posts an event to the listeners.
* *
* @param evt the event to dispatch * @param evt the event to dispatch
* @return the results of posting the event
* @deprecated As of JDK version 1.1 * @deprecated As of JDK version 1.1
* replaced by dispatchEvent(AWTEvent). * replaced by dispatchEvent(AWTEvent).
*/ */

3
jdk/src/java.desktop/share/classes/java/awt/MenuItem.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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. * If no such listeners exist, this method returns an empty array.
* *
* @param <T> the type of the listeners
* @param listenerType the type of listeners requested; this parameter * @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from * should specify an interface that descends from
* <code>java.util.EventListener</code> * <code>java.util.EventListener</code>

13
jdk/src/java.desktop/share/classes/java/awt/Toolkit.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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 * subclasses should override this to provide their own implementation
* *
* @param <T> the type of DragGestureRecognizer to create
* @param abstractRecognizerClass The abstract class of the required recognizer * @param abstractRecognizerClass The abstract class of the required recognizer
* @param ds The DragSource * @param ds The DragSource
* @param c The Component target for the DragGestureRecognizer * @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) { protected Object lazilyLoadDesktopProperty(String name) {
return null; return null;
@ -1947,8 +1950,14 @@ public abstract class Toolkit {
return desktopPropsSupport.getPropertyChangeListeners(propertyName); return desktopPropsSupport.getPropertyChangeListeners(propertyName);
} }
/**
* The desktop properties.
*/
protected final Map<String,Object> desktopProperties = protected final Map<String,Object> desktopProperties =
new HashMap<String,Object>(); new HashMap<String,Object>();
/**
* The desktop properties change support.
*/
protected final PropertyChangeSupport desktopPropsSupport = protected final PropertyChangeSupport desktopPropsSupport =
Toolkit.createPropertyChangeSupport(this); Toolkit.createPropertyChangeSupport(this);

4
jdk/src/java.desktop/share/classes/java/awt/Window.java
View File

@ -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. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * 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 * @deprecated As of J2SE 1.4, replaced by
* {@link Component#applyComponentOrientation Component.applyComponentOrientation}. * {@link Component#applyComponentOrientation Component.applyComponentOrientation}.
* @param rb the resource bundle
*/ */
@Deprecated @Deprecated
public void applyResourceBundle(ResourceBundle rb) { public void applyResourceBundle(ResourceBundle rb) {
@ -2798,6 +2799,7 @@ public class Window extends Container implements Accessible {
/** /**
* @deprecated As of J2SE 1.4, replaced by * @deprecated As of J2SE 1.4, replaced by
* {@link Component#applyComponentOrientation Component.applyComponentOrientation}. * {@link Component#applyComponentOrientation Component.applyComponentOrientation}.
* @param rbName the resource name
*/ */
@Deprecated @Deprecated
public void applyResourceBundle(String rbName) { public void applyResourceBundle(String rbName) {