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

javadoc no longer inherits doc from sourcepath

    XMLWordPrintable

    Details

    • Subcomponent:
    • Resolved In Build:
      b121
    • CPU:
      generic
    • OS:
      generic
    • Verification:
      Verified

      Backports

        Description

        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

          Attachments

            Issue Links

              Activity

                People

                Assignee:
                jjg Jonathan Gibbons
                Reporter:
                jjg Jonathan Gibbons
                Votes:
                0 Vote for this issue
                Watchers:
                0 Start watching this issue

                  Dates

                  Created:
                  Updated:
                  Resolved:
                  Imported:
                  Indexed: