--- old/src/java.datatransfer/share/classes/java/awt/datatransfer/FlavorListener.java 2017-05-23 19:14:14.000000000 -0700 +++ new/src/java.datatransfer/share/classes/java/awt/datatransfer/FlavorListener.java 2017-05-23 19:14:14.000000000 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2017, 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 @@ -22,11 +22,11 @@ * or visit www.oracle.com if you need additional information or have any * questions. */ + package java.awt.datatransfer; import java.util.EventListener; - /** * Defines an object which listens for {@link FlavorEvent}s. * @@ -34,22 +34,21 @@ * @since 1.5 */ public interface FlavorListener extends EventListener { + /** - * Invoked when the target {@link Clipboard} of the listener - * has changed its available {@link DataFlavor}s. + * Invoked when the target {@link Clipboard} of the listener has changed its + * available {@link DataFlavor}s. *
- * 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
- * the system clipboard's contents has been changed but it
- * can't ascertain whether its DataFlavors have been changed
- * because of some exceptional condition when accessing the
- * clipboard, the notification is sent to ensure from omitting
- * a significant notification. Ordinarily, those redundant
- * notifications should be occasional.
+ * 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 the system clipboard's contents
+ * has been changed but it can't ascertain whether its DataFlavors have been
+ * changed because of some exceptional condition when accessing the
+ * clipboard, the notification is sent to ensure from omitting a significant
+ * notification. Ordinarily, those redundant notifications should be
+ * occasional.
*
- * @param e a FlavorEvent
object
+ * @param e a {@code FlavorEvent} object
*/
void flavorsChanged(FlavorEvent e);
}