From a916ed751a6f96b2f5ce3e6dd404647397eb44d8 Mon Sep 17 00:00:00 2001 From: Alexander Stepanov Date: Fri, 28 Mar 2014 14:33:53 +0400 Subject: [PATCH] 8038242: Tidy warnings cleanup for java.awt.datatransfer, java.awt.dnd, java.awt.event Reviewed-by: pchelko, serb --- .../java/awt/datatransfer/FlavorListener.java | 2 +- .../awt/datatransfer/SystemFlavorMap.java | 1 - .../classes/java/awt/dnd/Autoscroll.java | 4 +- .../java/awt/dnd/DragGestureEvent.java | 32 +++++++------- .../java/awt/dnd/DragGestureListener.java | 2 +- .../java/awt/dnd/DragGestureRecognizer.java | 44 +++++++++---------- .../classes/java/awt/dnd/DragSource.java | 30 ++++++------- .../java/awt/dnd/DragSourceContext.java | 6 +-- .../java/awt/dnd/DragSourceDropEvent.java | 2 +- .../classes/java/awt/dnd/DragSourceEvent.java | 2 +- .../classes/java/awt/dnd/DropTarget.java | 36 +++++++-------- .../java/awt/dnd/DropTargetContext.java | 38 ++++++++-------- .../java/awt/dnd/DropTargetDragEvent.java | 12 ++--- .../java/awt/dnd/DropTargetDropEvent.java | 22 +++++----- .../classes/java/awt/dnd/DropTargetEvent.java | 4 +- .../java/awt/dnd/DropTargetListener.java | 4 +- .../awt/dnd/InvalidDnDOperationException.java | 2 +- .../awt/dnd/MouseDragGestureRecognizer.java | 22 +++++----- .../classes/java/awt/event/MouseEvent.java | 2 +- 19 files changed, 133 insertions(+), 134 deletions(-) diff --git a/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java b/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java index 280d96f9b35..cc048335f7a 100644 --- a/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java +++ b/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java @@ -38,7 +38,7 @@ public interface FlavorListener extends EventListener { * Invoked when the target {@link Clipboard} of the listener * has changed its available {@link DataFlavor}s. *

- * Some notifications may be redundant — they are not + * Some notifications may be redundant — they are not * caused by a change of the set of DataFlavors available * on the clipboard. * For example, if the clipboard subsystem supposes that diff --git a/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java b/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java index 4fd4c8163cd..1b8390eccf2 100644 --- a/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java +++ b/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java @@ -54,7 +54,6 @@ import sun.awt.datatransfer.DataTransferer; * which correspond to platform-independent MIME types. This mapping is used * by the data transfer subsystem to transfer data between Java and native * applications, and between Java applications in separate VMs. - *

* * @since 1.2 */ diff --git a/jdk/src/share/classes/java/awt/dnd/Autoscroll.java b/jdk/src/share/classes/java/awt/dnd/Autoscroll.java index 203826e0337..0e3f0fb459a 100644 --- a/jdk/src/share/classes/java/awt/dnd/Autoscroll.java +++ b/jdk/src/share/classes/java/awt/dnd/Autoscroll.java @@ -62,7 +62,7 @@ public interface Autoscroll { * This value is read once by the DropTarget * upon entry of the drag Cursor * into the associated Component. - *

+ * * @return the Insets */ @@ -70,7 +70,7 @@ public interface Autoscroll { /** * notify the Component to autoscroll - *

+ * * @param cursorLocn A Point indicating the * location of the cursor that triggered this operation. */ diff --git a/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java b/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java index 3c9eadd6e56..e8827f44358 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java @@ -82,14 +82,14 @@ public class DragGestureEvent extends EventObject { * the user's preferred action, an {@code ori} parameter * indicating the origin of the drag, and a {@code List} of * events that comprise the gesture({@code evs} parameter). - *

+ * * @param dgr The DragGestureRecognizer firing this event * @param act The user's preferred action. * For information on allowable values, see * the class description for {@link DragGestureEvent} * @param ori The origin of the drag * @param evs The List of events that comprise the gesture - *

+ * * @throws IllegalArgumentException if any parameter equals {@code null} * @throws IllegalArgumentException if the act parameter does not comply with * the values given in the class @@ -124,7 +124,7 @@ public class DragGestureEvent extends EventObject { /** * Returns the source as a DragGestureRecognizer. - *

+ * * @return the source as a DragGestureRecognizer */ @@ -135,7 +135,7 @@ public class DragGestureEvent extends EventObject { /** * Returns the Component associated * with this DragGestureEvent. - *

+ * * @return the Component */ @@ -143,7 +143,7 @@ public class DragGestureEvent extends EventObject { /** * Returns the DragSource. - *

+ * * @return the DragSource */ @@ -152,7 +152,7 @@ public class DragGestureEvent extends EventObject { /** * Returns a Point in the coordinates * of the Component over which the drag originated. - *

+ * * @return the Point where the drag originated in Component coords. */ @@ -163,7 +163,7 @@ public class DragGestureEvent extends EventObject { /** * Returns an Iterator for the events * comprising the gesture. - *

+ * * @return an Iterator for the events comprising the gesture */ @SuppressWarnings("unchecked") @@ -172,7 +172,7 @@ public class DragGestureEvent extends EventObject { /** * Returns an Object array of the * events comprising the drag gesture. - *

+ * * @return an array of the events comprising the gesture */ @@ -180,9 +180,9 @@ public class DragGestureEvent extends EventObject { /** * Returns an array of the events comprising the drag gesture. - *

+ * * @param array the array of EventObject sub(types) - *

+ * * @return an array of the events comprising the gesture */ @SuppressWarnings("unchecked") @@ -191,7 +191,7 @@ public class DragGestureEvent extends EventObject { /** * Returns an int representing the * action selected by the user. - *

+ * * @return the action selected by the user */ @@ -199,7 +199,7 @@ public class DragGestureEvent extends EventObject { /** * Returns the initial event that triggered the gesture. - *

+ * * @return the first "triggering" event in the sequence of the gesture */ @@ -242,7 +242,7 @@ public class DragGestureEvent extends EventObject { * Starts the drag given the initial Cursor to display, * the Transferable object, * and the DragSourceListener to use. - *

+ * * @param dragCursor The initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see @@ -251,7 +251,7 @@ public class DragGestureEvent extends EventObject { * during drag and drop * @param transferable The source's Transferable * @param dsl The source's DragSourceListener - *

+ * * @throws InvalidDnDOperationException if * the Drag and Drop system is unable to * initiate a drag operation, or if the user @@ -269,7 +269,7 @@ public class DragGestureEvent extends EventObject { * the Image, * the Transferable object, and * the DragSourceListener to use. - *

+ * * @param dragCursor The initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see @@ -280,7 +280,7 @@ public class DragGestureEvent extends EventObject { * @param imageOffset The dragImage's offset * @param transferable The source's Transferable * @param dsl The source's DragSourceListener - *

+ * * @throws InvalidDnDOperationException if * the Drag and Drop system is unable to * initiate a drag operation, or if the user diff --git a/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java b/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java index 5adb328b6e3..f3e600e6cd4 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java @@ -53,7 +53,7 @@ import java.util.EventListener; * drag initiating gesture. To initiate the drag and drop operation, * if appropriate, {@link DragGestureEvent#startDrag startDrag()} method on * the {@code DragGestureEvent} has to be invoked. - *

+ * * @see java.awt.dnd.DragGestureRecognizer * @see java.awt.dnd.DragGestureEvent * @param dge the DragGestureEvent describing diff --git a/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java b/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java index 18f2e2a813d..b3dbeb5f477 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java @@ -76,7 +76,7 @@ import java.io.Serializable; * for causing the associated * DragSource to start the Drag and Drop operation (if * appropriate). - *

+ * * @author Laurence P. G. Cable * @see java.awt.dnd.DragGestureListener * @see java.awt.dnd.DragGestureEvent @@ -96,7 +96,7 @@ public abstract class DragGestureRecognizer implements Serializable { * for this Drag and Drop operation, and the * DragGestureListener to notify * once a drag initiating gesture has been detected. - *

+ * * @param ds the DragSource this * DragGestureRecognizer * will use to process the Drag and Drop operation @@ -115,7 +115,7 @@ public abstract class DragGestureRecognizer implements Serializable { * * @param dgl the DragGestureRecognizer * to notify when a drag gesture is detected - *

+ * * @throws IllegalArgumentException * if ds is null. */ @@ -144,7 +144,7 @@ public abstract class DragGestureRecognizer implements Serializable { * DragGestureRecognizer should "observe" * for drag initiating gestures, and the action(s) * supported for this Drag and Drop operation. - *

+ * * @param ds the DragSource this * DragGestureRecognizer will use to * process the Drag and Drop operation @@ -158,7 +158,7 @@ public abstract class DragGestureRecognizer implements Serializable { * * @param sa the set (logical OR) of the DnDConstants * that this Drag and Drop operation will support - *

+ * * @throws IllegalArgumentException * if ds is null. */ @@ -174,7 +174,7 @@ public abstract class DragGestureRecognizer implements Serializable { * the Component this * DragGestureRecognizer * should "observe" for drag initiating gestures. - *

+ * * @param ds the DragSource this * DragGestureRecognizer * will use to process the Drag and Drop operation @@ -186,7 +186,7 @@ public abstract class DragGestureRecognizer implements Serializable { * If this value is null, * the DragGestureRecognizer * is not associated with any Component. - *

+ * * @throws IllegalArgumentException * if ds is null. */ @@ -199,11 +199,11 @@ public abstract class DragGestureRecognizer implements Serializable { * Construct a new DragGestureRecognizer * given the DragSource to be used in this * Drag and Drop operation. - *

+ * * @param ds the DragSource this * DragGestureRecognizer will * use to process the Drag and Drop operation - *

+ * * @throws IllegalArgumentException * if ds is null. */ @@ -233,7 +233,7 @@ public abstract class DragGestureRecognizer implements Serializable { * this DragGestureRecognizer * will use in order to process the Drag and Drop * operation. - *

+ * * @return the DragSource */ @@ -244,7 +244,7 @@ public abstract class DragGestureRecognizer implements Serializable { * that is to be "observed" by the * DragGestureRecognizer * for drag initiating gestures. - *

+ * * @return The Component this DragGestureRecognizer * is associated with */ @@ -256,7 +256,7 @@ public abstract class DragGestureRecognizer implements Serializable { * * registerListeners() and unregisterListeners() are called as a side * effect as appropriate. - *

+ * * @param c The Component or null */ @@ -274,7 +274,7 @@ public abstract class DragGestureRecognizer implements Serializable { * This method returns an int representing the * type of action(s) this Drag and Drop * operation will support. - *

+ * * @return the currently permitted source action(s) */ @@ -283,7 +283,7 @@ public abstract class DragGestureRecognizer implements Serializable { /** * This method sets the permitted source drag action(s) * for this Drag and Drop operation. - *

+ * * @param actions the permitted source drag action(s) */ @@ -295,7 +295,7 @@ public abstract class DragGestureRecognizer implements Serializable { * This method returns the first event in the * series of events that initiated * the Drag and Drop operation. - *

+ * * @return the initial event that triggered the drag gesture */ @@ -310,10 +310,10 @@ public abstract class DragGestureRecognizer implements Serializable { /** * Register a new DragGestureListener. - *

+ * * @param dgl the DragGestureListener to register * with this DragGestureRecognizer. - *

+ * * @throws java.util.TooManyListenersException if a * DragGestureListener has already been added. */ @@ -330,10 +330,10 @@ public abstract class DragGestureRecognizer implements Serializable { /** * unregister the current DragGestureListener - *

+ * * @param dgl the DragGestureListener to unregister * from this DragGestureRecognizer - *

+ * * @throws IllegalArgumentException if * dgl is not (equal to) the currently registered DragGestureListener. */ @@ -351,7 +351,7 @@ public abstract class DragGestureRecognizer implements Serializable { /** * Notify the DragGestureListener that a Drag and Drop initiating * gesture has occurred. Then reset the state of the Recognizer. - *

+ * * @param dragAction The action initially selected by the users gesture * @param p The point (in Component coords) where the gesture originated */ @@ -369,14 +369,14 @@ public abstract class DragGestureRecognizer implements Serializable { * Listeners registered on the Component by this Recognizer shall record * all Events that are recognized as part of the series of Events that go * to comprise a Drag and Drop initiating gesture via this API. - *

+ *

* This method is used by a DragGestureRecognizer * implementation to add an InputEvent * subclass (that it believes is one in a series * of events that comprise a Drag and Drop operation) * to the array of events that this * DragGestureRecognizer maintains internally. - *

+ * * @param awtie the InputEvent * to add to this DragGestureRecognizer's * internal array of events. Note that null diff --git a/jdk/src/share/classes/java/awt/dnd/DragSource.java b/jdk/src/share/classes/java/awt/dnd/DragSource.java index 2b32b87da14..3236ca241f5 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragSource.java +++ b/jdk/src/share/classes/java/awt/dnd/DragSource.java @@ -228,7 +228,7 @@ public class DragSource implements Serializable { * whether or not drag * Image support * is available on the underlying platform. - *

+ * * @return if the Drag Image support is available on this platform */ @@ -270,7 +270,7 @@ public class DragSource implements Serializable { * the Transferable subject data * of the drag, the DragSourceListener, * and the FlavorMap. - *

+ * * @param trigger the DragGestureEvent that initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; @@ -282,7 +282,7 @@ public class DragSource implements Serializable { * @param transferable the subject data of the drag * @param dsl the DragSourceListener * @param flavorMap the FlavorMap to use, or null - *

+ * * @throws java.awt.dnd.InvalidDnDOperationException * if the Drag and Drop * system is unable to initiate a drag operation, or if the user @@ -332,7 +332,7 @@ public class DragSource implements Serializable { * the Transferable subject data * of the drag, the DragSourceListener, * and the FlavorMap. - *

+ * * @param trigger the DragGestureEvent that * initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation @@ -342,7 +342,7 @@ public class DragSource implements Serializable { * @param transferable the subject data of the drag * @param dsl the DragSourceListener * @param flavorMap the FlavorMap to use or null - *

+ * * @throws java.awt.dnd.InvalidDnDOperationException * if the Drag and Drop * system is unable to initiate a drag operation, or if the user @@ -368,7 +368,7 @@ public class DragSource implements Serializable { * at the instant of the trigger, * the subject data of the drag, and * the DragSourceListener. - *

+ * * @param trigger the DragGestureEvent that initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; @@ -379,7 +379,7 @@ public class DragSource implements Serializable { * of the Cursor at the instant of the trigger * @param transferable the subject data of the drag * @param dsl the DragSourceListener - *

+ * * @throws java.awt.dnd.InvalidDnDOperationException * if the Drag and Drop * system is unable to initiate a drag operation, or if the user @@ -403,15 +403,15 @@ public class DragSource implements Serializable { * use, * the Transferable subject data * of the drag, and the DragSourceListener. - *

- * @param trigger the DragGestureEvent that initiated the drag + * + * @param trigger the DragGestureEvent that initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see DragSourceContext class * for more details on the cursor handling mechanism during drag and drop * @param transferable the subject data of the drag * @param dsl the DragSourceListener - *

+ * * @throws java.awt.dnd.InvalidDnDOperationException * if the Drag and Drop * system is unable to initiate a drag operation, or if the user @@ -480,7 +480,7 @@ public class DragSource implements Serializable { /** * This method returns the * FlavorMap for this DragSource. - *

+ * * @return the FlavorMap for this DragSource */ @@ -494,13 +494,13 @@ public class DragSource implements Serializable { * sets the specified Component * and DragGestureListener on * the newly created object. - *

+ * * @param the type of {@code DragGestureRecognizer} to create * @param recognizerAbstractClass the requested abstract type * @param actions the permitted source drag actions * @param c the Component target * @param dgl the DragGestureListener to notify - *

+ * * @return the new DragGestureRecognizer or null * if the Toolkit.createDragGestureRecognizer method * has no implementation available for @@ -528,11 +528,11 @@ public class DragSource implements Serializable { * * For this DragSource * the default is MouseDragGestureRecognizer. - *

+ * * @param c the Component target for the recognizer * @param actions the permitted source actions * @param dgl the DragGestureListener to notify - *

+ * * @return the new DragGestureRecognizer or null * if the Toolkit.createDragGestureRecognizer method * has no implementation available for diff --git a/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java b/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java index cbc4c83b148..58e43ff3d89 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java @@ -289,7 +289,7 @@ public class DragSourceContext /** * Returns the current drag Cursor. - *

+ * * @return the current drag Cursor */ @@ -300,11 +300,11 @@ public class DragSourceContext * DragSourceContext if one has not already been added. * If a DragSourceListener already exists, * this method throws a TooManyListenersException. - *

+ * * @param dsl the DragSourceListener to add. * Note that while null is not prohibited, * it is not acceptable as a parameter. - *

+ * * @throws TooManyListenersException if * a DragSourceListener has already been added */ diff --git a/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java b/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java index 5cc3c8f6694..f31e3d233dc 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java @@ -36,7 +36,7 @@ package java.awt.dnd; * originator of the operation * to provide appropriate feedback to the end user * when the operation completes. - *

+ * * @since 1.2 */ diff --git a/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java b/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java index 3effe4f07ad..b9f55e15170 100644 --- a/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java @@ -131,7 +131,7 @@ public class DragSourceEvent extends EventObject { /** * This method returns the DragSourceContext that * originated the event. - *

+ * * @return the DragSourceContext that originated the event */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTarget.java b/jdk/src/share/classes/java/awt/dnd/DropTarget.java index 9f5462a320b..a6939b924a7 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTarget.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTarget.java @@ -234,7 +234,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Gets the Component associated * with this DropTarget. - *

+ * * @return the current Component */ @@ -244,7 +244,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Sets the default acceptable actions for this DropTarget - *

+ * * @param ops the default actions * @see java.awt.dnd.DnDConstants */ @@ -264,7 +264,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Gets an int representing the * current action(s) supported by this DropTarget. - *

+ * * @return the current default actions */ @@ -275,7 +275,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Sets the DropTarget active if true, * inactive if false. - *

+ * * @param isActive sets the DropTarget (in)active. */ @@ -291,7 +291,7 @@ public class DropTarget implements DropTargetListener, Serializable { * Reports whether or not * this DropTarget * is currently active (ready to accept drops). - *

+ * * @return true if active, false if not */ @@ -301,9 +301,9 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Adds a new DropTargetListener (UNICAST SOURCE). - *

+ * * @param dtl The new DropTargetListener - *

+ * * @throws TooManyListenersException if a * DropTargetListener is already added to this * DropTarget. @@ -322,7 +322,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Removes the current DropTargetListener (UNICAST SOURCE). - *

+ * * @param dtl the DropTargetListener to deregister. */ @@ -464,7 +464,7 @@ public class DropTarget implements DropTargetListener, Serializable { * If no FlavorMap has been set for this * DropTarget, it is associated with the default * FlavorMap. - *

+ * * @return the FlavorMap for this DropTarget */ @@ -473,7 +473,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Sets the FlavorMap associated * with this DropTarget. - *

+ * * @param fm the new FlavorMap, or null to * associate the default FlavorMap with this DropTarget. */ @@ -494,7 +494,7 @@ public class DropTarget implements DropTargetListener, Serializable { * association of the ComponentPeer with the Component may result in * a malfunction of the DnD system. ********************************************************************** - *

+ * * @param peer The Peer of the Component we are associated with! * */ @@ -529,7 +529,7 @@ public class DropTarget implements DropTargetListener, Serializable { * disassociation of the ComponentPeer from the Component may result in * a malfunction of the DnD system. ********************************************************************** - *

+ * * @param peer The Peer of the Component we are being disassociated from! */ @@ -549,7 +549,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * Gets the DropTargetContext associated * with this DropTarget. - *

+ * * @return the DropTargetContext associated with this DropTarget. */ @@ -641,7 +641,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * construct a DropTargetAutoScroller - *

+ * * @param c the Component * @param p the Point */ @@ -710,7 +710,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * cause autoscroll to occur - *

+ * * @param newLocn the Point */ @@ -734,7 +734,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * cause autoscroll to occur - *

+ * * @param e the ActionEvent */ @@ -779,7 +779,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * initialize autoscrolling - *

+ * * @param p the Point */ @@ -791,7 +791,7 @@ public class DropTarget implements DropTargetListener, Serializable { /** * update autoscrolling with current cursor location - *

+ * * @param dragCursorLocn the Point */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java b/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java index 5a55c844df2..43e71180c86 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java @@ -61,7 +61,7 @@ public class DropTargetContext implements Serializable { /** * Construct a DropTargetContext * given a specified DropTarget. - *

+ * * @param dt the DropTarget to associate with */ @@ -74,7 +74,7 @@ public class DropTargetContext implements Serializable { /** * This method returns the DropTarget associated with this * DropTargetContext. - *

+ * * @return the DropTarget associated with this DropTargetContext */ @@ -83,7 +83,7 @@ public class DropTargetContext implements Serializable { /** * This method returns the Component associated with * this DropTargetContext. - *

+ * * @return the Component associated with this Context */ @@ -91,7 +91,7 @@ public class DropTargetContext implements Serializable { /** * Called when associated with the DropTargetContextPeer. - *

+ * * @param dtcp the DropTargetContextPeer */ @@ -111,7 +111,7 @@ public class DropTargetContext implements Serializable { /** * This method sets the current actions acceptable to * this DropTarget. - *

+ * * @param actions an int representing the supported action(s) */ @@ -130,7 +130,7 @@ public class DropTargetContext implements Serializable { /** * This method returns an int representing the * current actions this DropTarget will accept. - *

+ * * @return the current actions acceptable to this DropTarget */ @@ -145,9 +145,9 @@ public class DropTargetContext implements Serializable { /** * This method signals that the drop is completed and * if it was successful or not. - *

+ * * @param success true for success, false if not - *

+ * * @throws InvalidDnDOperationException if a drop is not outstanding/extant */ @@ -160,7 +160,7 @@ public class DropTargetContext implements Serializable { /** * accept the Drag. - *

+ * * @param dragOperation the supported action(s) */ @@ -186,7 +186,7 @@ public class DropTargetContext implements Serializable { * called to signal that the drop is acceptable * using the specified operation. * must be called during DropTargetListener.drop method invocation. - *

+ * * @param dropOperation the supported action(s) */ @@ -212,7 +212,7 @@ public class DropTargetContext implements Serializable { /** * get the available DataFlavors of the * Transferable operand of this operation. - *

+ * * @return a DataFlavor[] containing the * supported DataFlavors of the * Transferable operand. @@ -227,7 +227,7 @@ public class DropTargetContext implements Serializable { * This method returns a the currently available DataFlavors * of the Transferable operand * as a java.util.List. - *

+ * * @return the currently available * DataFlavors as a java.util.List */ @@ -240,9 +240,9 @@ public class DropTargetContext implements Serializable { * This method returns a boolean * indicating if the given DataFlavor is * supported by this DropTargetContext. - *

+ * * @param df the DataFlavor - *

+ * * @return if the DataFlavor specified is supported */ @@ -252,9 +252,9 @@ public class DropTargetContext implements Serializable { /** * get the Transferable (proxy) operand of this operation - *

+ * * @throws InvalidDnDOperationException if a drag is not outstanding/extant - *

+ * * @return the Transferable */ @@ -279,7 +279,7 @@ public class DropTargetContext implements Serializable { /** * Get the DropTargetContextPeer - *

+ * * @return the platform peer */ @@ -322,7 +322,7 @@ public class DropTargetContext implements Serializable { * data transfer for a particular drag-n-drop operation and * a boolean which indicates whether the * drag-n-drop operation is local (within the same JVM). - *

+ * * @param t the Transferable object * @param local true, if t represents * the result of local drag-n-drop operation @@ -336,7 +336,7 @@ public class DropTargetContext implements Serializable { /** * Returns an array of DataFlavor objects indicating the flavors * the data can be provided in by the encapsulated transferable. - *

+ * * @return an array of data flavors in which the data can be * provided by the encapsulated transferable */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java b/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java index daa5487a1ad..00639cf9043 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java @@ -80,7 +80,7 @@ public class DropTargetDragEvent extends DropTargetEvent { * the location of the "Drag" Cursor's hotspot * in the Component's coordinates, the * user drop action, and the source drop actions. - *

+ * * @param dtc The DropTargetContext for this operation * @param cursorLocn The location of the "Drag" Cursor's * hotspot in Component coordinates @@ -118,7 +118,7 @@ public class DropTargetDragEvent extends DropTargetEvent { * indicating the Cursor's current * location within the Component's * coordinates. - *

+ * * @return the current cursor location in * Component's coords. */ @@ -131,7 +131,7 @@ public class DropTargetDragEvent extends DropTargetEvent { /** * This method returns the current DataFlavors from the * DropTargetContext. - *

+ * * @return current DataFlavors from the DropTargetContext */ @@ -142,7 +142,7 @@ public class DropTargetDragEvent extends DropTargetEvent { /** * This method returns the current DataFlavors * as a java.util.List - *

+ * * @return a java.util.List of the Current DataFlavors */ @@ -153,9 +153,9 @@ public class DropTargetDragEvent extends DropTargetEvent { /** * This method returns a boolean indicating * if the specified DataFlavor is supported. - *

+ * * @param df the DataFlavor to test - *

+ * * @return if a particular DataFlavor is supported */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java b/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java index e6ad6844aa8..32b16e16169 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java @@ -85,7 +85,7 @@ public class DropTargetDropEvent extends DropTargetEvent { * assumes that the target is not in the same virtual machine as * the source; that is, {@link #isLocalTransfer()} will * return false. - *

+ * * @param dtc The DropTargetContext for this operation * @param cursorLocn The location of the "Drag" Cursor's * hotspot in Component coordinates @@ -128,7 +128,7 @@ public class DropTargetDropEvent extends DropTargetEvent { * the current set of actions supported by the source, * and a boolean indicating if the source is in the same JVM * as the target. - *

+ * * @param dtc The DropTargetContext for this operation * @param cursorLocn The location of the "Drag" Cursor's * hotspot in Component's coordinates @@ -154,7 +154,7 @@ public class DropTargetDropEvent extends DropTargetEvent { * This method returns a Point * indicating the Cursor's current * location in the Component's coordinates. - *

+ * * @return the current Cursor location in Component's coords. */ @@ -165,7 +165,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * This method returns the current DataFlavors. - *

+ * * @return current DataFlavors */ @@ -176,7 +176,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * This method returns the currently available * DataFlavors as a java.util.List. - *

+ * * @return the currently available DataFlavors as a java.util.List */ @@ -188,9 +188,9 @@ public class DropTargetDropEvent extends DropTargetEvent { * This method returns a boolean indicating if the * specified DataFlavor is available * from the source. - *

+ * * @param df the DataFlavor to test - *

+ * * @return if the DataFlavor specified is available from the source */ @@ -215,7 +215,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * This method returns the Transferable object * associated with the drop. - *

+ * * @return the Transferable associated with the drop */ @@ -225,7 +225,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * accept the drop, using the specified action. - *

+ * * @param dropAction the specified action */ @@ -244,7 +244,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * This method notifies the DragSource * that the drop transfer(s) are completed. - *

+ * * @param success a boolean indicating that the drop transfer(s) are completed. */ @@ -255,7 +255,7 @@ public class DropTargetDropEvent extends DropTargetEvent { /** * This method returns an int indicating if * the source is in the same JVM as the target. - *

+ * * @return if the Source is in the same JVM */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java b/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java index 326ba939a3f..e7911ab8cbb 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java @@ -47,7 +47,7 @@ public class DropTargetEvent extends java.util.EventObject { /** * Construct a DropTargetEvent object with * the specified DropTargetContext. - *

+ * * @param dtc The DropTargetContext * @throws NullPointerException if {@code dtc} equals {@code null}. * @see #getSource() @@ -63,7 +63,7 @@ public class DropTargetEvent extends java.util.EventObject { /** * This method returns the DropTargetContext * associated with this DropTargetEvent. - *

+ * * @return the DropTargetContext */ diff --git a/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java b/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java index 03659845580..60676f99b0d 100644 --- a/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java @@ -91,7 +91,7 @@ public interface DropTargetListener extends EventListener { /** * Called if the user has modified * the current drop gesture. - *

+ * * @param dtde the DropTargetDragEvent */ @@ -144,7 +144,7 @@ public interface DropTargetListener extends EventListener { * DropTargetDropEvent.isLocalTransfer() returns * true. Otherwise, the behavior of the call is * implementation-dependent. - *

+ * * @param dtde the DropTargetDropEvent */ diff --git a/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java b/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java index 1f9368e5899..e0727aba3b5 100644 --- a/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java +++ b/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java @@ -48,7 +48,7 @@ public class InvalidDnDOperationException extends IllegalStateException { /** * Create an Exception with its own descriptive message - *

+ * * @param msg the detail message */ diff --git a/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java b/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java index 1fc0e0bd8a0..cf975835f22 100644 --- a/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java +++ b/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java @@ -74,7 +74,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i * permitted for this drag operation, and * the DragGestureListener to * notify when a drag gesture is detected. - *

+ * * @param ds The DragSource for the Component c * @param c The Component to observe * @param act The actions permitted for this Drag @@ -92,7 +92,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i * the Component c, * the Component to observe, and the action(s) * permitted for this drag operation. - *

+ * * @param ds The DragSource for the Component c * @param c The Component to observe * @param act The actions permitted for this drag @@ -107,7 +107,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i * given the DragSource for the * Component c, and the * Component to observe. - *

+ * * @param ds The DragSource for the Component c * @param c The Component to observe */ @@ -119,7 +119,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Construct a new MouseDragGestureRecognizer * given the DragSource for the Component. - *

+ * * @param ds The DragSource for the Component */ @@ -150,7 +150,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when the mouse has been clicked on a component. - *

+ * * @param e the MouseEvent */ @@ -159,7 +159,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when a mouse button has been * pressed on a Component. - *

+ * * @param e the MouseEvent */ @@ -167,7 +167,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when a mouse button has been released on a component. - *

+ * * @param e the MouseEvent */ @@ -175,7 +175,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when the mouse enters a component. - *

+ * * @param e the MouseEvent */ @@ -183,7 +183,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when the mouse exits a component. - *

+ * * @param e the MouseEvent */ @@ -191,7 +191,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when a mouse button is pressed on a component. - *

+ * * @param e the MouseEvent */ @@ -200,7 +200,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i /** * Invoked when the mouse button has been moved on a component * (with no buttons no down). - *

+ * * @param e the MouseEvent */ diff --git a/jdk/src/share/classes/java/awt/event/MouseEvent.java b/jdk/src/share/classes/java/awt/event/MouseEvent.java index 89c950aff1f..65a8626f872 100644 --- a/jdk/src/share/classes/java/awt/event/MouseEvent.java +++ b/jdk/src/share/classes/java/awt/event/MouseEvent.java @@ -930,7 +930,7 @@ public class MouseEvent extends InputEvent { * and will cause the returning an unspecified string. * Zero parameter means that no modifiers were passed and will * cause the returning an empty string. - *

+ * * @param modifiers A modifier mask describing the modifier keys and * mouse buttons that were down during the event * @return string string text description of the combination of modifier