API Doc hides important interface information - StringBuffer impl. Appendable

XMLWordPrintable

    • Type: Bug
    • Resolution: Duplicate
    • Priority: P4
    • None
    • Affects Version/s: 5.0
    • Component/s: 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)
      ======================================================================

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

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: