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

API Doc hides important interface information - StringBuffer impl. Appendable

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P4 P4
    • None
    • 5.0
    • tools



      Name: rmT116609 Date: 02/05/2004


      A DESCRIPTION OF THE PROBLEM :
      StringBuffer implements interface Appendable, but the API doc does not
      show that fact. This is very confusing. This is probably because
      StringBuffer implements Formatter indirectly through the private
      AbstractStringBuilder class, and JavaDoc is not smart enough
      to show that fact.

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      All Implemented Interfaces should say:
          CharSequence, Serializable, Appendable
      ACTUAL -
      All Implemented Interfaces currently say:
          CharSequence, Serializable

      URL OF FAULTY DOCUMENTATION :
      http://java.sun.com/j2se/1.5.0/docs/api/java/lang/StringBuffer.html
      (Incident Review ID: 237362)
      ======================================================================

            jhosunw Jamie Ho (Inactive)
            rmandalasunw Ranjith Mandala (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: