Javadoc 1.4 -linksource Errors
This problem was addressed in bug 4548768:
http://developer.java.sun.com/developer/bugParade/bugs/4548768.html
but I haven't seen it in the forum with regard to -linksource. I'll throw this in here so others can find it.
The problem:
While using the -linksource option, Javadoc complains about "java.io.FileNotFoundException" for classes that clearly exist (and are in the source path and/or classpath). While Javadoc will continue past these errors, it does terminate at another point with a null exception in the doclet itself. All the source code compiles without errors using the same classpath AND javadoc generates documentation without errors if the -linksource option is removed.
The "solution":
Javadoc is attempting to write files for classes existing in the classpath (even if not in the source path). The above problems are solved by omitting a classpath for Javadoc (set to "").
The "solution" causes some compiler (?) errors to occur when classes being documented use classes not being documented (more specifically, are not in the source path). I can understand that a classpath isn't really necessary as the files are not being compiled, but shouldn't these compiler errors then be ignored when generating documentation? (Question for the Javadoc Team if they are reading this)
I know that the classpath problem may be common knowledge (or maybe not; I don't frequent this forum much), but it took me a while to determine this was the underlying cause of my trouble as it appeared to be related to -linksource (of which I had difficulty finding in the forum). Hopefully, this post may save others a little time.
