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

Add syntax to generate in-line @see links in descriptions and tag text

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.2.0
    • 1.1, 1.1.3, 1.2.0
    • tools
    • 1.2beta4
    • generic, x86, sparc
    • solaris_2.5, solaris_2.5.1, windows_95
    • Verified

      The @deprecated tag currently looks like this
       
       /**
        * Description...
        *
        * @deprecated Replaced by setEnabled(boolean)
        */
        disable() {
          // implementation
        }

      When you generate the HTML, the result looks like:

        <a>java.awt.Component.disable()</a> replaced by setEnabled(boolean)

      where "disable" has a link but "setEnabled" does not.

      We need a new delimiter added to the @deprecated argument that indicates
      to javadoc that a link should be added to "setEnabled".

      We sometimes refer to this feature as "in-line @see tags".

            adambalksunw Atul Dambalkar (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: