OpenJDK / jdk / hs
changeset 23588:b0269b21e313
8038242: Tidy warnings cleanup for java.awt.datatransfer, java.awt.dnd, java.awt.event
Reviewed-by: pchelko, serb
Contributed-by: Alexander Stepanov <alexander.v.stepanov@oracle.com>
line wrap: on
line diff
--- a/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java Fri Mar 28 14:33:53 2014 +0400 @@ -38,7 +38,7 @@ * Invoked when the target {@link Clipboard} of the listener * has changed its available {@link DataFlavor}s. * <p> - * 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
--- a/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java Fri Mar 28 14:33:53 2014 +0400 @@ -54,7 +54,6 @@ * 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. - * <p> * * @since 1.2 */
--- a/jdk/src/share/classes/java/awt/dnd/Autoscroll.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/Autoscroll.java Fri Mar 28 14:33:53 2014 +0400 @@ -62,7 +62,7 @@ * This value is read once by the <code>DropTarget</code> * upon entry of the drag <code>Cursor</code> * into the associated <code>Component</code>. - * <P> + * * @return the Insets */ @@ -70,7 +70,7 @@ /** * notify the <code>Component</code> to autoscroll - * <P> + * * @param cursorLocn A <code>Point</code> indicating the * location of the cursor that triggered this operation. */
--- a/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -82,14 +82,14 @@ * 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). - * <P> + * * @param dgr The <code>DragGestureRecognizer</code> 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 <code>List</code> of events that comprise the gesture - * <P> + * * @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 @@ /** * Returns the source as a <code>DragGestureRecognizer</code>. - * <P> + * * @return the source as a <code>DragGestureRecognizer</code> */ @@ -135,7 +135,7 @@ /** * Returns the <code>Component</code> associated * with this <code>DragGestureEvent</code>. - * <P> + * * @return the Component */ @@ -143,7 +143,7 @@ /** * Returns the <code>DragSource</code>. - * <P> + * * @return the <code>DragSource</code> */ @@ -152,7 +152,7 @@ /** * Returns a <code>Point</code> in the coordinates * of the <code>Component</code> over which the drag originated. - * <P> + * * @return the Point where the drag originated in Component coords. */ @@ -163,7 +163,7 @@ /** * Returns an <code>Iterator</code> for the events * comprising the gesture. - * <P> + * * @return an Iterator for the events comprising the gesture */ @SuppressWarnings("unchecked") @@ -172,7 +172,7 @@ /** * Returns an <code>Object</code> array of the * events comprising the drag gesture. - * <P> + * * @return an array of the events comprising the gesture */ @@ -180,9 +180,9 @@ /** * Returns an array of the events comprising the drag gesture. - * <P> + * * @param array the array of <code>EventObject</code> sub(types) - * <P> + * * @return an array of the events comprising the gesture */ @SuppressWarnings("unchecked") @@ -191,7 +191,7 @@ /** * Returns an <code>int</code> representing the * action selected by the user. - * <P> + * * @return the action selected by the user */ @@ -199,7 +199,7 @@ /** * Returns the initial event that triggered the gesture. - * <P> + * * @return the first "triggering" event in the sequence of the gesture */ @@ -242,7 +242,7 @@ * Starts the drag given the initial <code>Cursor</code> to display, * the <code>Transferable</code> object, * and the <code>DragSourceListener</code> to use. - * <P> + * * @param dragCursor The initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see @@ -251,7 +251,7 @@ * during drag and drop * @param transferable The source's Transferable * @param dsl The source's DragSourceListener - * <P> + * * @throws InvalidDnDOperationException if * the Drag and Drop system is unable to * initiate a drag operation, or if the user @@ -269,7 +269,7 @@ * the <code>Image</code>, * the <code>Transferable</code> object, and * the <code>DragSourceListener</code> to use. - * <P> + * * @param dragCursor The initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see @@ -280,7 +280,7 @@ * @param imageOffset The dragImage's offset * @param transferable The source's Transferable * @param dsl The source's DragSourceListener - * <P> + * * @throws InvalidDnDOperationException if * the Drag and Drop system is unable to * initiate a drag operation, or if the user
--- a/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureListener.java Fri Mar 28 14:33:53 2014 +0400 @@ -53,7 +53,7 @@ * 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. - * <P> + * * @see java.awt.dnd.DragGestureRecognizer * @see java.awt.dnd.DragGestureEvent * @param dge the <code>DragGestureEvent</code> describing
--- a/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java Fri Mar 28 14:33:53 2014 +0400 @@ -76,7 +76,7 @@ * for causing the associated * <code>DragSource</code> to start the Drag and Drop operation (if * appropriate). - * <P> + * * @author Laurence P. G. Cable * @see java.awt.dnd.DragGestureListener * @see java.awt.dnd.DragGestureEvent @@ -96,7 +96,7 @@ * for this Drag and Drop operation, and the * <code>DragGestureListener</code> to notify * once a drag initiating gesture has been detected. - * <P> + * * @param ds the <code>DragSource</code> this * <code>DragGestureRecognizer</code> * will use to process the Drag and Drop operation @@ -115,7 +115,7 @@ * * @param dgl the <code>DragGestureRecognizer</code> * to notify when a drag gesture is detected - * <P> + * * @throws IllegalArgumentException * if ds is <code>null</code>. */ @@ -144,7 +144,7 @@ * <code>DragGestureRecognizer</code> should "observe" * for drag initiating gestures, and the action(s) * supported for this Drag and Drop operation. - * <P> + * * @param ds the <code>DragSource</code> this * <code>DragGestureRecognizer</code> will use to * process the Drag and Drop operation @@ -158,7 +158,7 @@ * * @param sa the set (logical OR) of the <code>DnDConstants</code> * that this Drag and Drop operation will support - * <P> + * * @throws IllegalArgumentException * if ds is <code>null</code>. */ @@ -174,7 +174,7 @@ * the <code>Component</code> this * <code>DragGestureRecognizer</code> * should "observe" for drag initiating gestures. - * <P> + * * @param ds the <code>DragSource</code> this * <code>DragGestureRecognizer</code> * will use to process the Drag and Drop operation @@ -186,7 +186,7 @@ * If this value is <code>null</code>, * the <code>DragGestureRecognizer</code> * is not associated with any <code>Component</code>. - * <P> + * * @throws IllegalArgumentException * if ds is <code>null</code>. */ @@ -199,11 +199,11 @@ * Construct a new <code>DragGestureRecognizer</code> * given the <code>DragSource</code> to be used in this * Drag and Drop operation. - * <P> + * * @param ds the <code>DragSource</code> this * <code>DragGestureRecognizer</code> will * use to process the Drag and Drop operation - * <P> + * * @throws IllegalArgumentException * if ds is <code>null</code>. */ @@ -233,7 +233,7 @@ * this <code>DragGestureRecognizer</code> * will use in order to process the Drag and Drop * operation. - * <P> + * * @return the DragSource */ @@ -244,7 +244,7 @@ * that is to be "observed" by the * <code>DragGestureRecognizer</code> * for drag initiating gestures. - * <P> + * * @return The Component this DragGestureRecognizer * is associated with */ @@ -256,7 +256,7 @@ * * registerListeners() and unregisterListeners() are called as a side * effect as appropriate. - * <P> + * * @param c The <code>Component</code> or <code>null</code> */ @@ -274,7 +274,7 @@ * This method returns an int representing the * type of action(s) this Drag and Drop * operation will support. - * <P> + * * @return the currently permitted source action(s) */ @@ -283,7 +283,7 @@ /** * This method sets the permitted source drag action(s) * for this Drag and Drop operation. - * <P> + * * @param actions the permitted source drag action(s) */ @@ -295,7 +295,7 @@ * This method returns the first event in the * series of events that initiated * the Drag and Drop operation. - * <P> + * * @return the initial event that triggered the drag gesture */ @@ -310,10 +310,10 @@ /** * Register a new <code>DragGestureListener</code>. - * <P> + * * @param dgl the <code>DragGestureListener</code> to register * with this <code>DragGestureRecognizer</code>. - * <P> + * * @throws java.util.TooManyListenersException if a * <code>DragGestureListener</code> has already been added. */ @@ -330,10 +330,10 @@ /** * unregister the current DragGestureListener - * <P> + * * @param dgl the <code>DragGestureListener</code> to unregister * from this <code>DragGestureRecognizer</code> - * <P> + * * @throws IllegalArgumentException if * dgl is not (equal to) the currently registered <code>DragGestureListener</code>. */ @@ -351,7 +351,7 @@ /** * Notify the DragGestureListener that a Drag and Drop initiating * gesture has occurred. Then reset the state of the Recognizer. - * <P> + * * @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 @@ * 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. - *<P> + * <P> * This method is used by a <code>DragGestureRecognizer</code> * implementation to add an <code>InputEvent</code> * 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 * <code>DragGestureRecognizer</code> maintains internally. - * <P> + * * @param awtie the <code>InputEvent</code> * to add to this <code>DragGestureRecognizer</code>'s * internal array of events. Note that <code>null</code>
--- a/jdk/src/share/classes/java/awt/dnd/DragSource.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragSource.java Fri Mar 28 14:33:53 2014 +0400 @@ -228,7 +228,7 @@ * whether or not drag * <code>Image</code> support * is available on the underlying platform. - * <P> + * * @return if the Drag Image support is available on this platform */ @@ -270,7 +270,7 @@ * the <code>Transferable</code> subject data * of the drag, the <code>DragSourceListener</code>, * and the <code>FlavorMap</code>. - * <P> + * * @param trigger the <code>DragGestureEvent</code> 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 @@ * @param transferable the subject data of the drag * @param dsl the <code>DragSourceListener</code> * @param flavorMap the <code>FlavorMap</code> to use, or <code>null</code> - * <P> + * * @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 @@ * the <code>Transferable</code> subject data * of the drag, the <code>DragSourceListener</code>, * and the <code>FlavorMap</code>. - * <P> + * * @param trigger the <code>DragGestureEvent</code> that * initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation @@ -342,7 +342,7 @@ * @param transferable the subject data of the drag * @param dsl the <code>DragSourceListener</code> * @param flavorMap the <code>FlavorMap</code> to use or <code>null</code> - * <P> + * * @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 @@ * at the instant of the trigger, * the subject data of the drag, and * the <code>DragSourceListener</code>. - * <P> + * * @param trigger the <code>DragGestureEvent</code> 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 @@ * of the <code>Cursor</code> at the instant of the trigger * @param transferable the subject data of the drag * @param dsl the <code>DragSourceListener</code> - * <P> + * * @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 @@ * use, * the <code>Transferable</code> subject data * of the drag, and the <code>DragSourceListener</code>. - * <P> - * @param trigger the <code>DragGestureEvent</code> that initiated the drag + * + * @param trigger the <code>DragGestureEvent</code> that initiated the drag * @param dragCursor the initial {@code Cursor} for this drag operation * or {@code null} for the default cursor handling; * see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a> class * for more details on the cursor handling mechanism during drag and drop * @param transferable the subject data of the drag * @param dsl the <code>DragSourceListener</code> - * <P> + * * @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 @@ /** * This method returns the * <code>FlavorMap</code> for this <code>DragSource</code>. - * <P> + * * @return the <code>FlavorMap</code> for this <code>DragSource</code> */ @@ -494,13 +494,13 @@ * sets the specified <code>Component</code> * and <code>DragGestureListener</code> on * the newly created object. - * <P> + * * @param <T> the type of {@code DragGestureRecognizer} to create * @param recognizerAbstractClass the requested abstract type * @param actions the permitted source drag actions * @param c the <code>Component</code> target * @param dgl the <code>DragGestureListener</code> to notify - * <P> + * * @return the new <code>DragGestureRecognizer</code> or <code>null</code> * if the <code>Toolkit.createDragGestureRecognizer</code> method * has no implementation available for @@ -528,11 +528,11 @@ * * For this <code>DragSource</code> * the default is <code>MouseDragGestureRecognizer</code>. - * <P> + * * @param c the <code>Component</code> target for the recognizer * @param actions the permitted source actions * @param dgl the <code>DragGestureListener</code> to notify - * <P> + * * @return the new <code>DragGestureRecognizer</code> or <code>null</code> * if the <code>Toolkit.createDragGestureRecognizer</code> method * has no implementation available for
--- a/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceContext.java Fri Mar 28 14:33:53 2014 +0400 @@ -289,7 +289,7 @@ /** * Returns the current drag <code>Cursor</code>. - * <P> + * * @return the current drag <code>Cursor</code> */ @@ -300,11 +300,11 @@ * <code>DragSourceContext</code> if one has not already been added. * If a <code>DragSourceListener</code> already exists, * this method throws a <code>TooManyListenersException</code>. - * <P> + * * @param dsl the <code>DragSourceListener</code> to add. * Note that while <code>null</code> is not prohibited, * it is not acceptable as a parameter. - * <P> + * * @throws TooManyListenersException if * a <code>DragSourceListener</code> has already been added */
--- a/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -36,7 +36,7 @@ * originator of the operation * to provide appropriate feedback to the end user * when the operation completes. - * <P> + * * @since 1.2 */
--- a/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -131,7 +131,7 @@ /** * This method returns the <code>DragSourceContext</code> that * originated the event. - * <P> + * * @return the <code>DragSourceContext</code> that originated the event */
--- a/jdk/src/share/classes/java/awt/dnd/DropTarget.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTarget.java Fri Mar 28 14:33:53 2014 +0400 @@ -234,7 +234,7 @@ /** * Gets the <code>Component</code> associated * with this <code>DropTarget</code>. - * <P> + * * @return the current <code>Component</code> */ @@ -244,7 +244,7 @@ /** * Sets the default acceptable actions for this <code>DropTarget</code> - * <P> + * * @param ops the default actions * @see java.awt.dnd.DnDConstants */ @@ -264,7 +264,7 @@ /** * Gets an <code>int</code> representing the * current action(s) supported by this <code>DropTarget</code>. - * <P> + * * @return the current default actions */ @@ -275,7 +275,7 @@ /** * Sets the DropTarget active if <code>true</code>, * inactive if <code>false</code>. - * <P> + * * @param isActive sets the <code>DropTarget</code> (in)active. */ @@ -291,7 +291,7 @@ * Reports whether or not * this <code>DropTarget</code> * is currently active (ready to accept drops). - * <P> + * * @return <CODE>true</CODE> if active, <CODE>false</CODE> if not */ @@ -301,9 +301,9 @@ /** * Adds a new <code>DropTargetListener</code> (UNICAST SOURCE). - * <P> + * * @param dtl The new <code>DropTargetListener</code> - * <P> + * * @throws TooManyListenersException if a * <code>DropTargetListener</code> is already added to this * <code>DropTarget</code>. @@ -322,7 +322,7 @@ /** * Removes the current <code>DropTargetListener</code> (UNICAST SOURCE). - * <P> + * * @param dtl the DropTargetListener to deregister. */ @@ -464,7 +464,7 @@ * If no <code>FlavorMap</code> has been set for this * <code>DropTarget</code>, it is associated with the default * <code>FlavorMap</code>. - * <P> + * * @return the FlavorMap for this DropTarget */ @@ -473,7 +473,7 @@ /** * Sets the <code>FlavorMap</code> associated * with this <code>DropTarget</code>. - * <P> + * * @param fm the new <code>FlavorMap</code>, or null to * associate the default FlavorMap with this DropTarget. */ @@ -494,7 +494,7 @@ * association of the ComponentPeer with the Component may result in * a malfunction of the DnD system. ********************************************************************** - * <P> + * * @param peer The Peer of the Component we are associated with! * */ @@ -529,7 +529,7 @@ * disassociation of the ComponentPeer from the Component may result in * a malfunction of the DnD system. ********************************************************************** - * <P> + * * @param peer The Peer of the Component we are being disassociated from! */ @@ -549,7 +549,7 @@ /** * Gets the <code>DropTargetContext</code> associated * with this <code>DropTarget</code>. - * <P> + * * @return the <code>DropTargetContext</code> associated with this <code>DropTarget</code>. */ @@ -641,7 +641,7 @@ /** * construct a DropTargetAutoScroller - * <P> + * * @param c the <code>Component</code> * @param p the <code>Point</code> */ @@ -710,7 +710,7 @@ /** * cause autoscroll to occur - * <P> + * * @param newLocn the <code>Point</code> */ @@ -734,7 +734,7 @@ /** * cause autoscroll to occur - * <P> + * * @param e the <code>ActionEvent</code> */ @@ -779,7 +779,7 @@ /** * initialize autoscrolling - * <P> + * * @param p the <code>Point</code> */ @@ -791,7 +791,7 @@ /** * update autoscrolling with current cursor location - * <P> + * * @param dragCursorLocn the <code>Point</code> */
--- a/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetContext.java Fri Mar 28 14:33:53 2014 +0400 @@ -61,7 +61,7 @@ /** * Construct a <code>DropTargetContext</code> * given a specified <code>DropTarget</code>. - * <P> + * * @param dt the DropTarget to associate with */ @@ -74,7 +74,7 @@ /** * This method returns the <code>DropTarget</code> associated with this * <code>DropTargetContext</code>. - * <P> + * * @return the <code>DropTarget</code> associated with this <code>DropTargetContext</code> */ @@ -83,7 +83,7 @@ /** * This method returns the <code>Component</code> associated with * this <code>DropTargetContext</code>. - * <P> + * * @return the Component associated with this Context */ @@ -91,7 +91,7 @@ /** * Called when associated with the <code>DropTargetContextPeer</code>. - * <P> + * * @param dtcp the <code>DropTargetContextPeer</code> */ @@ -111,7 +111,7 @@ /** * This method sets the current actions acceptable to * this <code>DropTarget</code>. - * <P> + * * @param actions an <code>int</code> representing the supported action(s) */ @@ -130,7 +130,7 @@ /** * This method returns an <code>int</code> representing the * current actions this <code>DropTarget</code> will accept. - * <P> + * * @return the current actions acceptable to this <code>DropTarget</code> */ @@ -145,9 +145,9 @@ /** * This method signals that the drop is completed and * if it was successful or not. - * <P> + * * @param success true for success, false if not - * <P> + * * @throws InvalidDnDOperationException if a drop is not outstanding/extant */ @@ -160,7 +160,7 @@ /** * accept the Drag. - * <P> + * * @param dragOperation the supported action(s) */ @@ -186,7 +186,7 @@ * called to signal that the drop is acceptable * using the specified operation. * must be called during DropTargetListener.drop method invocation. - * <P> + * * @param dropOperation the supported action(s) */ @@ -212,7 +212,7 @@ /** * get the available DataFlavors of the * <code>Transferable</code> operand of this operation. - * <P> + * * @return a <code>DataFlavor[]</code> containing the * supported <code>DataFlavor</code>s of the * <code>Transferable</code> operand. @@ -227,7 +227,7 @@ * This method returns a the currently available DataFlavors * of the <code>Transferable</code> operand * as a <code>java.util.List</code>. - * <P> + * * @return the currently available * DataFlavors as a <code>java.util.List</code> */ @@ -240,9 +240,9 @@ * This method returns a <code>boolean</code> * indicating if the given <code>DataFlavor</code> is * supported by this <code>DropTargetContext</code>. - * <P> + * * @param df the <code>DataFlavor</code> - * <P> + * * @return if the <code>DataFlavor</code> specified is supported */ @@ -252,9 +252,9 @@ /** * get the Transferable (proxy) operand of this operation - * <P> + * * @throws InvalidDnDOperationException if a drag is not outstanding/extant - * <P> + * * @return the <code>Transferable</code> */ @@ -279,7 +279,7 @@ /** * Get the <code>DropTargetContextPeer</code> - * <P> + * * @return the platform peer */ @@ -322,7 +322,7 @@ * data transfer for a particular drag-n-drop operation and * a <code>boolean</code> which indicates whether the * drag-n-drop operation is local (within the same JVM). - * <p> + * * @param t the <code>Transferable</code> object * @param local <code>true</code>, if <code>t</code> represents * the result of local drag-n-drop operation @@ -336,7 +336,7 @@ /** * Returns an array of DataFlavor objects indicating the flavors * the data can be provided in by the encapsulated transferable. - * <p> + * * @return an array of data flavors in which the data can be * provided by the encapsulated transferable */
--- a/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -80,7 +80,7 @@ * the location of the "Drag" <code>Cursor</code>'s hotspot * in the <code>Component</code>'s coordinates, the * user drop action, and the source drop actions. - * <P> + * * @param dtc The DropTargetContext for this operation * @param cursorLocn The location of the "Drag" Cursor's * hotspot in Component coordinates @@ -118,7 +118,7 @@ * indicating the <code>Cursor</code>'s current * location within the <code>Component'</code>s * coordinates. - * <P> + * * @return the current cursor location in * <code>Component</code>'s coords. */ @@ -131,7 +131,7 @@ /** * This method returns the current <code>DataFlavor</code>s from the * <code>DropTargetContext</code>. - * <P> + * * @return current DataFlavors from the DropTargetContext */ @@ -142,7 +142,7 @@ /** * This method returns the current <code>DataFlavor</code>s * as a <code>java.util.List</code> - * <P> + * * @return a <code>java.util.List</code> of the Current <code>DataFlavor</code>s */ @@ -153,9 +153,9 @@ /** * This method returns a <code>boolean</code> indicating * if the specified <code>DataFlavor</code> is supported. - * <P> + * * @param df the <code>DataFlavor</code> to test - * <P> + * * @return if a particular DataFlavor is supported */
--- a/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -85,7 +85,7 @@ * assumes that the target is not in the same virtual machine as * the source; that is, {@link #isLocalTransfer()} will * return <code>false</code>. - * <P> + * * @param dtc The <code>DropTargetContext</code> for this operation * @param cursorLocn The location of the "Drag" Cursor's * hotspot in <code>Component</code> coordinates @@ -128,7 +128,7 @@ * the current set of actions supported by the source, * and a <code>boolean</code> indicating if the source is in the same JVM * as the target. - * <P> + * * @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 @@ * This method returns a <code>Point</code> * indicating the <code>Cursor</code>'s current * location in the <code>Component</code>'s coordinates. - * <P> + * * @return the current <code>Cursor</code> location in Component's coords. */ @@ -165,7 +165,7 @@ /** * This method returns the current DataFlavors. - * <P> + * * @return current DataFlavors */ @@ -176,7 +176,7 @@ /** * This method returns the currently available * <code>DataFlavor</code>s as a <code>java.util.List</code>. - * <P> + * * @return the currently available DataFlavors as a java.util.List */ @@ -188,9 +188,9 @@ * This method returns a <code>boolean</code> indicating if the * specified <code>DataFlavor</code> is available * from the source. - * <P> + * * @param df the <code>DataFlavor</code> to test - * <P> + * * @return if the DataFlavor specified is available from the source */ @@ -215,7 +215,7 @@ /** * This method returns the <code>Transferable</code> object * associated with the drop. - * <P> + * * @return the <code>Transferable</code> associated with the drop */ @@ -225,7 +225,7 @@ /** * accept the drop, using the specified action. - * <P> + * * @param dropAction the specified action */ @@ -244,7 +244,7 @@ /** * This method notifies the <code>DragSource</code> * that the drop transfer(s) are completed. - * <P> + * * @param success a <code>boolean</code> indicating that the drop transfer(s) are completed. */ @@ -255,7 +255,7 @@ /** * This method returns an <code>int</code> indicating if * the source is in the same JVM as the target. - * <P> + * * @return if the Source is in the same JVM */
--- a/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -47,7 +47,7 @@ /** * Construct a <code>DropTargetEvent</code> object with * the specified <code>DropTargetContext</code>. - * <P> + * * @param dtc The <code>DropTargetContext</code> * @throws NullPointerException if {@code dtc} equals {@code null}. * @see #getSource() @@ -63,7 +63,7 @@ /** * This method returns the <code>DropTargetContext</code> * associated with this <code>DropTargetEvent</code>. - * <P> + * * @return the <code>DropTargetContext</code> */
--- a/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/DropTargetListener.java Fri Mar 28 14:33:53 2014 +0400 @@ -91,7 +91,7 @@ /** * Called if the user has modified * the current drop gesture. - * <P> + * * @param dtde the <code>DropTargetDragEvent</code> */ @@ -144,7 +144,7 @@ * <code>DropTargetDropEvent.isLocalTransfer()</code> returns * <code>true</code>. Otherwise, the behavior of the call is * implementation-dependent. - * <P> + * * @param dtde the <code>DropTargetDropEvent</code> */
--- a/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java Fri Mar 28 14:33:53 2014 +0400 @@ -48,7 +48,7 @@ /** * Create an Exception with its own descriptive message - * <P> + * * @param msg the detail message */
--- a/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java Fri Mar 28 14:33:53 2014 +0400 @@ -74,7 +74,7 @@ * permitted for this drag operation, and * the <code>DragGestureListener</code> to * notify when a drag gesture is detected. - * <P> + * * @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 @@ * the <code>Component</code> c, * the <code>Component</code> to observe, and the action(s) * permitted for this drag operation. - * <P> + * * @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 @@ * given the <code>DragSource</code> for the * <code>Component</code> c, and the * <code>Component</code> to observe. - * <P> + * * @param ds The DragSource for the Component c * @param c The Component to observe */ @@ -119,7 +119,7 @@ /** * Construct a new <code>MouseDragGestureRecognizer</code> * given the <code>DragSource</code> for the <code>Component</code>. - * <P> + * * @param ds The DragSource for the Component */ @@ -150,7 +150,7 @@ /** * Invoked when the mouse has been clicked on a component. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -159,7 +159,7 @@ /** * Invoked when a mouse button has been * pressed on a <code>Component</code>. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -167,7 +167,7 @@ /** * Invoked when a mouse button has been released on a component. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -175,7 +175,7 @@ /** * Invoked when the mouse enters a component. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -183,7 +183,7 @@ /** * Invoked when the mouse exits a component. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -191,7 +191,7 @@ /** * Invoked when a mouse button is pressed on a component. - * <P> + * * @param e the <code>MouseEvent</code> */ @@ -200,7 +200,7 @@ /** * Invoked when the mouse button has been moved on a component * (with no buttons no down). - * <P> + * * @param e the <code>MouseEvent</code> */
--- a/jdk/src/share/classes/java/awt/event/MouseEvent.java Thu Mar 27 17:11:28 2014 -0700 +++ b/jdk/src/share/classes/java/awt/event/MouseEvent.java Fri Mar 28 14:33:53 2014 +0400 @@ -930,7 +930,7 @@ * and will cause the returning an unspecified string. * Zero parameter means that no modifiers were passed and will * cause the returning an empty string. - * <p> + * * @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