Not sure "-v" is the correct switch name, but this switch is needed.
The "javadoc -J-version" reaches through and prints the "java" version:
% java version "1.2"
Classic VM (build JDK-1.2-V, green threads, sunwjit)
which is interesting but not the same. Is it enough of a difference to matter?
I suggest we do what the MIF doclet does, and always print the version
to the output stream. Then no switch is needed (which would be confused
with the -version switch that javadoc already has). I suggest the javadoc
tool print its version and the standard doclet print its version.
There will be people modifying the standard doclet, wanting to know its
version separate from the javadoc or java version.
I also suggest that the version not be printed when -quiet is used
if there are no warnings or errors. However, if there are any
printed warnings or errors, go ahead and display the version.
Users seeking help can then just paste the output in an email and
it will automatically include the version string. Also, including
separate version numbers for both javadoc and the doclet will show which
errors are for which parts of the software.
This has been implemented. The version is printed during each run of the standard doclet. If -quiet is used, the version is only printed when an error or warning message is printed.
Location of fix: