Problems with javadoc:

Javadoc makes a number of assumptions:

1) It assumes that the java api's are in the same place as the
directory as the html files generated for your classes

2) There are a handful of filenames that collide(eg, AllNames.html,
tree.html).

3) The package names are prefixed onto the name of the html file
which quickly exceeds the filename length.


What if package names where directories, instead of, prefixing them to
the filename? This would take care of 2 and may be useful for problem 3.

Example:
before: sun.jws.build.ExecBuild.html after: sun/jws/build/ExecBuild.html