When I run javadoc passing in package names or .java files, I expect
to get the same results. I tried doing this and diffing the results,
but get different results.
Here I pass in .java files:
/java/re/jdk/1.4.0/archive/beta2/binaries/solsparc/bin/javadoc -J-Xbootclasspath/p:/home/jamieh/bin/standarddoclet.jar: /java/re/jdk/1.4.0/promoted/latest/binaries/solsparc/lib/tools.jar -J-Xmx20M -d html-javafiles -quiet -overview sample-src/overview.html sample-src/com/package1/*.java sample-src/com/package2/*.java sample-src/com/package1/subpackage/*.java
Then I pass in package names, replacing the last line with:
com.package1 com.package2 com.package1.subpackage
One difference is that in the first case, the first sentence of packages
does not appear on the overview page.
Some diffs are in whether a link exists or not:
238c238
< <CODE> com.package1.Interface1</CODE></FONT></TD>
---
> <CODE> <A HREF="../../com/package1/Interface1.html">Interface1</A></CODE></FONT></TD>
Also, when .java files are passed in, the package tree is not
generated. Only the overview tree is generated in this case.