### Javadoc 1.4 Beta 2 feedback wanted

Javadoc 1.4 Beta 2 has been available for a few weeks

as part of the Java 2 SDK, Standard Edition, v 1.4.0 Beta 2:

http://java.sun.com/j2se/1.4/

It has many new features, including (1) the -subpackages option

to recursively traverse all subpackages by passing in a

single package root, (2) -tag option to easily create custom tags,

(3) -src option (to be renamed -linksource) to add links to source

code, (3) -quiet option to suppress non-warning/error messages,

(4) -noqualifier option to omit qualifying package name from

ahead of class names in the output.

The complete list is at:

http://java.sun.com/j2se/1.4/docs/tooldocs/javadoc/whatsnew-1.4.html

There will be one last beta version: Beta 3.

We are taking comments from developers until about September 16th

for possible changes or bug fixes in these new features. Please contact

us at:

javadoc-tool@sun.com

regards,

-Doug Kramer

[1024 byte] By [dkramer] at [2007-9-26 6:28:21]

# 1

can you describe the use of "-subpackages" in detail? What does this do exactly?

6tr6tr at 2007-7-1 15:34:35 >

# 2

Do you need more description than this (from the given web page):

Added -subpackages option to recursively traverse all subpackages by passing in a single package root.

The -exclude option unconditionally exclude packages

from the list of packages to document even if it

would otherwise be included by some previous or later -subpackages command-line flag. For example:

-subpackages java -exclude java.lang.ref

would include java.io, java.util, and java.lang (among

others), but not java.lang.ref.

-Doug Kramer

Javadoc team

dkramer at 2007-7-1 15:34:36 >

Developer Tools New Topic