javadoc

Trying to use the -source path option, but it is not working with my package strucure. It will only identify one level, nothing below or above. I would think you could Identify one directory and it would search that directory and all sub-directories.

In my example I have the following package strucures.

(example 1)

com.ata.common.elements

com.ata.common.business

(example 2)

com.ata.common.cor.elements

com.ata.common.personnel.elements

I can't get the javadoc utility to pick up both package structures. Is my package structure not a good one?

The following command works for the first packages but not the second one.

....../jdk1.3.1_02/bin/javadoc -link http://java.sun.com/j2se/1.3/docs/api -d $DESTDIR -sourcepa

th . */*/*/*.java

The following command works for the second packages but not the first one.

....../jdk1.3.1_02/bin/javadoc -link http://java.sun.com/j2se/1.3/docs/api -d $DESTDIR -sourcepa

th . */*/*/*/*.java

The only difference is I added another */ in the sourcepath parameter. I want to do the whole directory/package structure from com on down........is it possible?

Thanks GMD

[1206 byte] By [gmdmsaa] at [2007-9-27 8:54:49]
# 1

If you're documenting packages, you should pass in package names,

not source filenames. If you want to include all subpackages, use

the -subpackages option. The -sourcepath is mostly ignored when you

pass in source filenames (as your example does). Here's an example:

Case 1 - Run recursively starting from one or more packages - This example

uses -sourcepath so javadoc can be run from any directory. It traverses the

subpackages of java excluding packages rooted at java.net and java.lang.

Notice this excludes java.lang.ref, a subpackage of java.lang).

C:> javadoc -d \home\html -sourcepath \home\src -subpackages java -exclude java.net:java.lang

More examples are at:

http://java.sun.com/j2se/1.4.1/docs/tooldocs/windows/javadoc.html#examples

-Doug Kramer

Javadoc team

dkramera at 2007-7-8 17:39:29 > top of Java-index,Developer Tools,Debugging and Profiling Tool APIs...