-
Bug
-
Resolution: Won't Fix
-
P4
-
None
-
5.0
-
generic
-
other
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).
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).
- relates to
-
JDK-8248001 javadoc generates invalid HTML pages whose ftp:// links are broken
- Resolved