Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4885687

spec of FlavorListener.flavorsChanged() does not correspond to CCC decision

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 5.0
    • 5.0
    • client-libs
    • tiger
    • generic
    • generic



      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
      ======================================================================

            agerasimsunw Alexander Gerasimov (Inactive)
            agerasimsunw Alexander Gerasimov (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: