Javadoc for Frame.finalize() strange and confusing

XMLWordPrintable

    • Type: Bug
    • Resolution: Fixed
    • Priority: P4
    • 5.0
    • Affects Version/s: 1.4.1
    • Component/s: client-libs
    • tiger
    • x86
    • linux_redhat_7.2

      http://java.sun.com/j2se/1.4.1/docs/api/java/awt/Frame.html#finalize()

      says:

      "We have to remove the (hard) reference to weakThis in the Vector, otherwise the WeakReference instance will never get garbage collected."

      This is apparently referring to some private implementation detail which makes no sense without reading the source code. It should not be in the public Javadoc of the API specification. Suggest that the Javadoc comment be made into a simple (one-asterisk) comment instead.
      ###@###.### 2003-03-21

            Assignee:
            Eric Hawkes (Inactive)
            Reporter:
            Jesse Glick (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: