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

javadoc: Want @see/@link alone to be sufficient ext ref for -link to create link

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Duplicate
    • Icon: P4 P4
    • None
    • 1.2.0, 1.3.0
    • tools
    • None
    • generic, sparc
    • generic, solaris_2.6

      In 1.3, for @see to link to an external referenced class, that class
      must appear somewhere in a signature or explicitly in an import statement.
      This means many links do not appear unless someone examines the HTML
      pages to see if links actually were generated. It also means someone
      must add such a reference (such as "import java.lang.SecurityManager")
      just to make the link appear. These are difficult constraints to
      live with.

      With javadoc built on the new compiler, can it be redesigned so that @see or {@link} itself will be a sufficient reference to allow -link to create links? If not, can Javadoc be redesigned to enable linking to any classes that are referenced in the *implementation*?

            gafter Neal Gafter (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: