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

stddoclet: Rename -src to -linksource

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.3.0
    • tools
    • beta3
    • sparc
    • solaris_2.6
    • Verified

      Javadoc (with the standard doclet) now has two similarly-named
      options:

        -src Adds links to the source code (and converts source
                      files to HTML)

        -source 1.4 Supports 1.4 source code (assertions)

      These two options seem a source of confusion, particularly since
      they are both pronounced the same.

      The second one has already been in the compiler for some time, and
      it should be consistent between the compiler and javadoc. Suggest
      changing -src to -linksource.

      This makes sense because the new option is generally related to the
      -link command (in that they both add links to the pages).
      (It's also better than -linksrc, so that the word "source" is
      consistently spelled the same as in -source and -sourcepath.)

      Note the original request to add the -src feature is 1242492.

            jhosunw Jamie Ho (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: