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

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

    XMLWordPrintable

Details

    • Bug
    • Resolution: Won't Fix
    • P4
    • None
    • 5.0
    • 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

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

              Dates

                Created:
                Updated:
                Resolved:
                Imported:
                Indexed: