DocCheck Not Finding All Source Files
I'm on windows xp running DocCheck from a bat file. I specify the sourcepath as follows:
-sourcepath .\com\SteveSystems\People\*.java
There are two classes (.java files) in the People directory and both have missing Javadoc tags. However, DocCheck only reports errors in one class. Am I using the -sourcepath option incorrectly?
The entire contents of my bat file are:
if exist docCheckOutput rmdir /s /q docCheckOutput
mkdir docCheckOutput
javadoc ^
-doclet com.sun.tools.doclets.doccheck.DocCheck ^
-docletpath C:\DocCheck\doccheck1.2b2\doccheck.jar ^
-J-Xmx20M^
-d docCheckOutput^
-classlist^
-docletID^
-title"DocCheck Sample Code"^
-sourcepath .\com\SteveSystems\People\*.java
pause
Thanks.
[858 byte] By [
falc1a] at [2007-11-26 18:43:44]
# 1
The -sourcepath option takes a path ending in a directory. It should not
contain "*.java" or any other file pattern. And it supplies the path to the
root directory of the package directories, not directories contain source files.
(I think it should have been named "packagepath".) It is mostly ignored\
when passing in source filenames (like *.java).
So try replacing this:
-sourcepath .\com\SteveSystems\People\*.java
with this:
.\com\SteveSystems\People\*.java
-Doug
# 2
For more info on documenting source files:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#documentingclasses
For documenting packages:
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#documentingpackages
FWIW, your "mkdir" command is not needed, because javadoc automatically will create the -d directory.
