Im having problem running javadoc on my source packages. When I execute the javadoc tool it never stops. I had it running one whole night without finishing and after 10 minutes it begins to steal every CPU cycle I have which brings my computer to a halt.
It feels like a bug, but I cant report it yet since I dont want to share all source files (or cant due to policy) and dont know what may be wrong. (it would be silly to add a bug that says "It freezes..."). Is there any way to begin debugging the javadoc tool?
This is what my command looks like:
javadoc -sourcepath src
-classpath ..\libs\lib\imFoundation.jar;..\libs\lib\
iwipCommon.jar;..\libs\ext-lib\velocity.jar;
..\libs\extlib\xerces.jar;..\libs\extlib\servlet.jar;
..\libs\extlib\mail.jar;..\libs\ext-lib\commons-net.jar;
..\libs\ext-lib\activation.jar
-d javadocs -subpackages com.imbridge.iwip.server -verbose
The output looks like this:
((Lot of Loading source files...)
Loading source files for package com.imbridge.iwip.server.util...
Constructing Javadoc information...
Standard Doclet version 1.4.1
Generating javadocs\constant-values.html...
Building tree for all the packages and classes...
Building index for all the packages and classes...
Generating javadocs\overview-tree.html...
Generating javadocs\index-all.html...
D:\Projekt\iwipservlet\src\com\imbridge\iwip\server\socket\
FileUpdater.java:17: warning - @author tag has no arguments.
It always freezes after the warning is displayed, and nothing seem to works after that. When I run the tool with the verbose option, it freezes just after the displayed warning. Ive tried to remove all classpaths but it still gives the same problem...
Im runing on Windows XP under the latest released JDK 1.4.1 version, Ive tried older ones but they has the same result.
java version "1.4.1_02"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_02-b06)
Java HotSpot(TM) Client VM (build 1.4.1_02-b06, mixed mode)
Do anyone has any clue on how to fix this, or how to begin to investigate this??
I need my documentation!!!