It seems that as of JDK 1.5 (observed in b32d and also in later builds), the javadoc tool will insert gratuitous slashes into filenames as it prints them, resulting in an invalid filename. At least on Linux. For example, using sources from

  http://www.netbeans.org/source/browse/openide/src/

if I run

/space/jdk1.4.2_04/bin/javadoc -sourcepath /space/src/nb_all/openide/src -d /tmp/javadocout -source 1.4 org.openide org.openide.actions org.openide.awt org.openide.cookies org.openide.explorer org.openide.explorer.propertysheet org.openide.explorer.propertysheet.editors org.openide.explorer.view org.openide.filesystems org.openide.modules org.openide.nodes org.openide.options org.openide.text org.openide.util org.openide.util.actions org.openide.util.datatransfer org.openide.util.enum org.openide.util.io org.openide.util.lookup org.openide.windows org.openide.xml

then I get output with lines like the following:

Generating /tmp/javadocout/org/openide/modules/Dependency.html...

whereas in JDK 1.5.0 (b37, for example), the same line appears as:

Generating /tmp/javadocout/org/openide/modules//Dependency.html...

Note that most kinds of error output is still fine, e.g.

/space/src/nb_all/openide/src/org/openide/util/WeakListeners.java:229: warning - Tag @link: reference not found: javax.naming.event.EventContext

But messages beginning with "Generating" usually have the doubled slash. Not all, but most:

Generating /tmp/javadocout/org/openide/windows//Workspace.html...
Generating /tmp/javadocout/org/openide/windows//package-frame.html...
Generating /tmp/javadocout/org/openide/windows//package-summary.html...
Generating /tmp/javadocout/org/openide/windows//package-tree.html...
Generating /tmp/javadocout/serialized-form.html...

I guess all the messages that involve a package name are broken.
###@###.### 2004-05-16