-
Bug
-
Resolution: Fixed
-
P2
-
7
-
b121
-
generic
-
generic
-
Verified
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-2191382 | OpenJDK6 | Jonathan Gibbons | P2 | Closed | Won't Fix |
From Martin Buchholz, ###@###.###
Hi javadoc team,
This is a bug report. Seems pretty serious - S2?
javadoc man page says,
"""
The source file for the inherited method need only be on the path spec
ified by -sourcepath for the doc comment to actually be available to
copy. Neither the class nor its package needs to be passed in on the
command line. This contrasts with 1.3.x and earlier releases, where the
class had to be a documented class
"""
It seems that the jdk has reverted to the 1.3.x behavior.
This happened somewhere between openjdk6-b12 and openjdk6-b13,
and is still broken at head of openjdk7. But 6u19 works fine!
E.g.
public class JavadocBug {
public String toString() { return ""; }
}
Then try
javadoc -sourcepath $PATH_TO_JDK_SOURCES/src/share/classes JavadocBug.java
Martin
Hi javadoc team,
This is a bug report. Seems pretty serious - S2?
javadoc man page says,
"""
The source file for the inherited method need only be on the path spec
ified by -sourcepath for the doc comment to actually be available to
copy. Neither the class nor its package needs to be passed in on the
command line. This contrasts with 1.3.x and earlier releases, where the
class had to be a documented class
"""
It seems that the jdk has reverted to the 1.3.x behavior.
This happened somewhere between openjdk6-b12 and openjdk6-b13,
and is still broken at head of openjdk7. But 6u19 works fine!
E.g.
public class JavadocBug {
public String toString() { return ""; }
}
Then try
javadoc -sourcepath $PATH_TO_JDK_SOURCES/src/share/classes JavadocBug.java
Martin
- backported by
-
JDK-2191382 javadoc no longer inherits doc from sourcepath
- Closed
- relates to
-
JDK-6289776 javadoc should retrieve inherited data from source files even when newer class files found
- Closed