Not using Forte, not reading package.html
I'm working with the Javadoc tool that came with J2SDK 1.4 on a RH Linux 7.2 machine. I've written a simple command to run javadoc on the .java files in the working directory:
javadoc -d /usr/local/jakarta-tomcat-4.0.1/webapps/doc -verbose -private *.java
(I'm trying to set up a Web app for the sole purpose of displaying documentation of all the other Web apps.)
However, if I'm in the package's directory and it contains the file package.html, with comments within <body></body> tags, those comments are not included in the javadoc output. They do not appear in the package's overview page. The package's classes are documented as expected.
Any help would be greatly appreciated!
Thanks,
Ethan
I get the same results you do if I do it as you have done,
passing in *.java without the package directories in the
path. But package.html is included if I start above at the
source directory root and pass in the full path that includes
the package name src/com/package1/*.java
Here are the details. This includes package.html,
where the current directory is above the source root:
/jdk/1.4.0/latest/binaries/solsparc/bin/javadoc \
-J-Xmx20M \
-d html-package \
src/com/package1/*.java
This does not include package.html, where the
current directory is where the .java files are:
/jdk/1.4.0/latest/binaries/solsparc/bin/javadoc \
-J-Xmx20M \
-d /home/dkramer/javadoc/1.4/html-package2 \
*.java
Would you please submit this as a bug? (following
the instructions at http://java.sun.com/j2se/javadoc/faq/index.html#submitbugs)
-Doug