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

java.awt.Toolkit areExtraMouseButtonsEnabled clarification

    XMLWordPrintable

    Details

    • Subcomponent:
    • CPU:
      x86
    • OS:
      windows_7

      Description

      A DESCRIPTION OF THE PROBLEM :
      Current text seems to say that this method returns the value that was set in either the command line arguments or by a System.setProperty(...) call.

      There is not any indication of whether this actually enables or disables extra mouse button input being allowed.

      It also seems to imply that the default "true" return has no built in relevance to whether the system itself supports extra mouse buttons.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      A clear description of what the method does and does not do.

      If the implications are both true, then that should be explicitly stated.

      If the implications are not true, then the real use of this method needs to be explained more clearly.

      I know it's not high priority, but it seems like it's either a simple fix or very broken :)
      ACTUAL -
      The text is confusing. The clearest reading I get from it is that calling this method returns a value set by the user and/or programmer but has no effect or relation other than being an awkward global boolean.

      URL OF FAULTY DOCUMENTATION :
      http://download.oracle.com/javase/7/docs/api/java/awt/Toolkit.html

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              Unassigned Unassigned
              Reporter:
              webbuggrp Webbug Group
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Dates

                Created:
                Updated:
                Imported:
                Indexed: