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

Docs for javax.swing.plaf.synth.ColorType.toString() is not clear

XMLWordPrintable

    • b39
    • sparc
    • solaris_2.6



      Name: apR10229 Date: 07/15/2003


      Filed By : SPB JCK team (###@###.###)
      JDK : java full version "1.5.0-beta-b10"
      JCK : 1.5
      Platform[s] : Solaris
      switch/Mode :
      JCK test owner : http://javaweb.eng/jct/sqe/JCK-tck/usr/owners.jto
      Failing Test [s] : N/A


      Specification excerpt:
      ======================
      --------- J2SE API spec v.1.5 ---------
      ...
      public java.lang.String toString()

          Returns the textual description of this ColorType.

      Returns:
      description of the string.

      ...
      ---------- end-of-excerpt ---------------

      Problem description
      ===================
      API Doc for javax.swing.plaf.synth.ColorType.toString() is not clear.
      It is not evident that "textual description of this ColorType" is the same value
      that we pass to a constructor. This need to be described more carefully, because
      someone may understand that toString() should return just a textual representation
      for this object, but not a description of this ColorType that was passed as a parameter
      to a ColorType constructor.
      Also "Returns: description of the string." is an ambiguos assertion.


      JCK test source location:
      ==========================
      /java/re/jck/1.5/promoted/latest/JCK-runtime-15/tests

      ======================================================================

            gromainsunw Guy Romain (Inactive)
            pavsunw Pav Pav (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: