Javadoc newbie

Question

I'm using JavaDoc 1.3.1_01 with Windows:
I have a directory (package) structure A/B/C/D and A/B/C/E with packages C, D & E containing source files. I'd like to use javadoc to generate documentation on these sourcefiles from the 3 packages C, D, & E. How do I go about doing this.
My javadoc command now has something like
javadoc -d c:\javadocs -private -sourcepath A:\B\C D E *.java.
The output from this only shows the source files in the C package. I don't get the sourcefiles under the D & E packages. In generating the documentation, I see meesages saying that the source files for package D is being loaded but I don't see the individual sourcefile displayed.
Any hints on what I'm doing incorrectly?

Answer 1

It's simpler to pass in package names than source filenames.
(The -sourcepath option is basically ignored when you pass in source filenames.)
Assuming your packages are named C, C.D and C.E,
try this:
javadoc -d c:\javadocs -private -sourcepath A C C.D C.E
Here, -sourcepath points to the parent directory (A) of the
top-level package (C). The package names are passed in with
"C C.D C.E"
The suggestion made by another developer is useful if you have
too many packages to fit on the command line.
This is all documented at:
http://java.sun.com/j2se/1.4/docs/tooldocs/win32/javadoc.html#documentingpackages
-Doug Kramer
Javadoc team