Name: agR10216 Date: 07/01/2003


The javadoc for FlavorListener.flavorsChanged() does
not correspond to the spec of this method that was
approved by CCC.
Currently the spec is:

    /**
     * Invoked when the target {@link Clipboard} of the listener
     * has changed its available {@link DataFlavor}s.
     * <p>
     * Some notifications may be redundant &#151; 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.
     * <p>
     * Note that the detection of changes to the set of DataFlavors
     * available on the clipboard takes into account only those
     * DataFlavors which a particular Clipboard implementation
     * can provide data in.
     * For example, if a native application places data
     * on the system clipboard in formats that the
     * clipboard subsystem doesn't know how to transfer,
     * no notifications are sent.
     *
     * @param e a <code>FlavorEvent</code> object
     */
    void flavorsChanged(FlavorEvent e);

while according to the approved CCC request 4259272 it should
not contain the last paragraph: "Note that the detection..."

###@###.### 2003-07-01
======================================================================