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

ftp:// links are broken on class-use page

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Won't Fix
    • Affects Version/s: 5.0
    • Fix Version/s: None
    • Component/s: tools

      Description

      If "ftp://" appears in a link <A HREF="ftp://..."> in the first sentence
      of a doc comment for a class, then when that class appears in a class-use
      page, javadoc mistakenly treats the "ftp://" as a relative path and prepends
      a relative path to it, which breaks the link.

      It should instead recognize it as an absolute path and leave it alone.

      EXAMPLE

      Here is the class doc comment in /src/share/classes/javax/naming/ldap/Control.java

      /**
        * This interface represents an LDAPv3 control as defined in
        * <A HREF="ftp://ftp.isi.edu/in-notes/rfc2251.txt">RFC 2251</A>.
        */
      public interface Control extends java.io.Serializable {


      This is the generated comment in the Serializable generated javadoc page
      http://java.sun.com/j2se/1.5.0/docs/api/java/io/class-use/Serializable.html

       This interface represents an LDAPv3 control as defined in
       <A HREF="../../../javax/naming/ldap/ftp://ftp.isi.edu/in-notes/rfc2251.txt">RFC 2251</A>.

      The HREF should instead look like it did in the doc comment:

       <A HREF="ftp://ftp.isi.edu/in-notes/rfc2251.txt">RFC 2251</A>

      Same problem happens on package-use pages (same example applies)
      and index pages (see Control class at docs/api/index-files/index-3.html).

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              bpatel Bhavesh Patel (Inactive)
              Reporter:
              dkramersunw Douglas Kramer (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: