--- 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); }