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

6877122: Many javadoc warnings from java.awt.Window, other awt classes

Browse Source 
Reviewed-by: anthony
This commit is contained in:
Joe Darcy 2009-08-28 11:11:11 -07:00
parent 4b58ee1a37
commit 575a3613d5
3 changed files with 26 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
jdk/src/share/classes/java/awt/Cursor.java
View File

@ -119,7 +119,7 @@ public class Cursor implements java.io.Serializable {
public static final int MOVE_CURSOR = 13; public static final int MOVE_CURSOR = 13;
/** /**
* @deprecated As of JDK version 1.7, the {@link #getPredefinedCursor()} * @deprecated As of JDK version 1.7, the {@link #getPredefinedCursor(int)}
* method should be used instead. * method should be used instead.
*/ */
@Deprecated @Deprecated

48
jdk/src/share/classes/java/awt/Window.java
View File

@ -3347,7 +3347,7 @@ public class Window extends Container implements Accessible {
* *
* @return the opacity of the window * @return the opacity of the window
* *
* @see Window#setOpacity * @see Window#setOpacity(float)
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
* *
* @since 1.7 * @since 1.7
@ -3366,7 +3366,7 @@ public class Window extends Container implements Accessible {
* window. This is a platform-dependent behavior. * window. This is a platform-dependent behavior.
* <p> * <p>
* In order for this method to enable the translucency effect, the {@link * In order for this method to enable the translucency effect, the {@link
* GraphicsDevice#isWindowTranslucencySupported()} method must indicate that * GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)} method must indicate that
* the {@link GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT} * the {@link GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT}
* translucency is supported. * translucency is supported.
* <p> * <p>
@ -3375,8 +3375,8 @@ public class Window extends Container implements Accessible {
* IllegalComponentStateException} is thrown. * IllegalComponentStateException} is thrown.
* <p> * <p>
* The translucency levels of individual pixels may also be effected by the * The translucency levels of individual pixels may also be effected by the
* alpha component of their color (see {@link setBackground()}) and the * alpha component of their color (see {@link Window#setBackground(Color)}) and the
* current shape of this window (see {@link setShape()}). * current shape of this window (see {@link #setShape(Shape)}).
* *
* @param opacity the opacity level to set to the window * @param opacity the opacity level to set to the window
* *
@ -3389,10 +3389,10 @@ public class Window extends Container implements Accessible {
* translucency kind is not supported and the opacity is less than 1.0f * translucency kind is not supported and the opacity is less than 1.0f
* *
* @see Window#getOpacity * @see Window#getOpacity
* @see Window#setBackground() * @see Window#setBackground(Color)
* @see Window#setShape() * @see Window#setShape(Shape)
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported() * @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
* *
* @since 1.7 * @since 1.7
*/ */
@ -3434,7 +3434,7 @@ public class Window extends Container implements Accessible {
* @return the shape of the window or {@code null} if no * @return the shape of the window or {@code null} if no
* shape is specified for the window * shape is specified for the window
* *
* @see Window#setShape * @see Window#setShape(Shape)
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
* *
* @since 1.7 * @since 1.7
@ -3458,19 +3458,19 @@ public class Window extends Container implements Accessible {
* <ul> * <ul>
* <li>The {@link GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSPARENT * <li>The {@link GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSPARENT
* PERPIXEL_TRANSPARENT} translucency kind must be supported by the * PERPIXEL_TRANSPARENT} translucency kind must be supported by the
* underlying system (see {@link }) * underlying system
* <i>and</i> * <i>and</i>
* <li>The window must not be in the full-screen mode (see * <li>The window must not be in the full-screen mode (see
* {@link GraphicsDevice#setFullScreenWindow()}) * {@link GraphicsDevice#setFullScreenWindow(Window)})
* </ul> * </ul>
* If a certain condition is not met, either the {@code * If a certain condition is not met, either the {@code
* UnsupportedOperationException} or {@code IllegalComponentStateException} * UnsupportedOperationException} or {@code IllegalComponentStateException}
* is thrown. * is thrown.
* <p> * <p>
* The tranlucency levels of individual pixels may also be effected by the * The tranlucency levels of individual pixels may also be effected by the
* alpha component of their color (see {@link setBackground()}) and the * alpha component of their color (see {@link Window#setBackground(Color)}) and the
* opacity value (see {@link setOpacity()}). See {@link * opacity value (see {@link #setOpacity(float)}). See {@link
* GraphicsDevice#WindowTranslucency} for more details. * GraphicsDevice.WindowTranslucency} for more details.
* *
* @param shape the shape to set to the window * @param shape the shape to set to the window
* *
@ -3481,10 +3481,10 @@ public class Window extends Container implements Accessible {
* PERPIXEL_TRANSPARENT} translucency is not supported * PERPIXEL_TRANSPARENT} translucency is not supported
* *
* @see Window#getShape() * @see Window#getShape()
* @see Window#setBackgound() * @see Window#setBackground(Color)
* @see Window#setOpacity() * @see Window#setOpacity(float)
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported() * @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
* *
* @since 1.7 * @since 1.7
*/ */
@ -3520,7 +3520,7 @@ public class Window extends Container implements Accessible {
* *
* @return this component's background color * @return this component's background color
* *
* @see Window#setBackground * @see Window#setBackground(Color)
* @see Window#isOpaque * @see Window#isOpaque
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
*/ */
@ -3544,7 +3544,7 @@ public class Window extends Container implements Accessible {
* PERPIXEL_TRANSLUCENT} translucency must be supported * PERPIXEL_TRANSLUCENT} translucency must be supported
* by the graphics device where this window is located <i>and</i> * by the graphics device where this window is located <i>and</i>
* <li>The window must not be in the full-screen mode (see {@link * <li>The window must not be in the full-screen mode (see {@link
* GraphicsDevice#setFullScreenWindow()}) * GraphicsDevice#setFullScreenWindow(Window)})
* </ul> * </ul>
* If a certain condition is not met at the time of calling this method, * If a certain condition is not met at the time of calling this method,
* the alpha component of the given background color will not effect the * the alpha component of the given background color will not effect the
@ -3561,8 +3561,8 @@ public class Window extends Container implements Accessible {
* method is equal to zero.) * method is equal to zero.)
* <p> * <p>
* The actual level of translucency of a given pixel also depends on window * The actual level of translucency of a given pixel also depends on window
* opacity (see {@link setOpacity()}), as well as the current shape of * opacity (see {@link #setOpacity(float)}), as well as the current shape of
* this window (see {@link setShape()}). * this window (see {@link #setShape(Shape)}).
* <p> * <p>
* Note that painting a pixel with the alpha value of 0 may or may not * Note that painting a pixel with the alpha value of 0 may or may not
* disable the mouse event handling on this pixel. This is a * disable the mouse event handling on this pixel. This is a
@ -3585,10 +3585,10 @@ public class Window extends Container implements Accessible {
* *
* @see Window#getBackground * @see Window#getBackground
* @see Window#isOpaque * @see Window#isOpaque
* @see Window#setOpacity() * @see Window#setOpacity(float)
* @see Window#setShape() * @see Window#setShape(Shape)
* @see GraphicsDevice.WindowTranslucency * @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported() * @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
* @see GraphicsConfiguration#isTranslucencyCapable() * @see GraphicsConfiguration#isTranslucencyCapable()
*/ */
@Override @Override
@ -3635,7 +3635,7 @@ public class Window extends Container implements Accessible {
* @return {@code true} if the window is opaque, {@code false} otherwise * @return {@code true} if the window is opaque, {@code false} otherwise
* *
* @see Window#getBackground * @see Window#getBackground
* @see Window#setBackground * @see Window#setBackground(Color)
* @since 1.7 * @since 1.7
*/ */
@Override @Override

2
jdk/src/share/classes/java/awt/dnd/DragSourceContext.java
View File

@ -275,7 +275,7 @@ public class DragSourceContext
* *
* @param c the initial {@code Cursor} for this drag operation, * @param c the initial {@code Cursor} for this drag operation,
* or {@code null} for the default cursor handling; * or {@code null} for the default cursor handling;
* see {@linkplain #defaultCursor class * see {@linkplain Cursor class
* level documentation} for more details * level documentation} for more details
* on the cursor handling during drag and drop * on the cursor handling during drag and drop
* *