-
Enhancement
-
Resolution: Fixed
-
P4
-
1.3.0
-
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.
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.