doc-files directory contents not copied
Hello forum folks! I have been struggling with a problem for a couple of
days now and can't seem to get my doc-files directory to copy with my
package api, so I am hoping that someone here will be able to help me.
My javadoc version is:
java version "1.4.1_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)
I have a directory structure as follows:
drwxr-xr-x src
drwxr-xr-x src/CVS
-rw-r--r-- src/CVS/Root
-rw-r--r-- src/CVS/Repository
-rw-r--r-- src/CVS/Entries
drwxr-xr-x src/cmdline
drwxr-xr-x src/cmdline/CVS
-rw-r--r-- src/cmdline/CVS/Root
-rw-r--r-- src/cmdline/CVS/Repository
-rw-r--r-- src/cmdline/CVS/Entries
-rw-r--r-- src/cmdline/AbstractHandlerDecorator.java
-rw-r--r-- src/cmdline/AbstractParameter.java
-rw-r--r-- src/cmdline/BasicCmdLineHandler.java
.. additional .java files omitted for brevity's sake
-rw-r--r-- src/cmdline/package.html
-rw-r--r-- src/cmdline/strings.properties
drwxr-xr-x src/cmdline/doc-files
drwxr-xr-x src/cmdline/doc-files/CVS
-rw-r--r-- src/cmdline/doc-files/CVS/Root
-rw-r--r-- src/cmdline/doc-files/CVS/Repository
-rw-r--r-- src/cmdline/doc-files/CVS/Entries
-rw-r--r-- src/cmdline/doc-files/userguide.html
I execute the following javadoc command:
/usr/java/j2sdk1.4.1_01/jre/../bin/javadoc \
-d /tmp/cmdline/build/doc/cmdline/api \
-protected -use -windowtitle "cmdline API" \
-classpath /usr/java/junit3.7/junit.jar \
-sourcepath /tmp/cmdline/src -version -author cmdline
This correctly creates the javadoc for the .java files and the package.html
file, but does not copy the contents of my doc-files directory! Does
anyone know why? (Note: I have tried removing the CVS directory from
both the package and the doc-files directories to see if that would help
and it still did not work).
Thanks in advance to anyone that can point me in the right direction!
Lynne Lawrence
[2164 byte] By [
w1tebeara] at [2007-9-27 23:12:47]
This bug was supposed to have been fixed in 1.4.0 (merlin).
http://developer.java.sun.com/developer/bugParade/bugs/4256505.html
I have just re-tested it on 1.4.0 and 1.4.1, and it works for me.
Your command looks fine.
When I run it, I get messages saying that the files are being
copied. Would you please send us your similar command line
output.
Generating html-4468396-docfilessubdirs/com/package1/FinalClass.html...
Generating html-4468396-docfilessubdirs/com/package1/MIFStyles.html...
Generating html-4468396-docfilessubdirs/com/package1/SerializableClass.html...
Generating html-4468396-docfilessubdirs/com/package1/SubClass.html...
Generating html-4468396-docfilessubdirs/com/package1/SubClassOfNestedClass.html...
Generating html-4468396-docfilessubdirs/com/package1/subpackage/SubPackageClass.html...
Copying file src-docfilessubdirs/doc-files/conclusion.html to directory
html-4468396-docfilessubdirs/doc-files...
Copying file src-docfilessubdirs/doc-files/appendix.html to directory
html-4468396-docfilessubdirs/doc-files...
Copying file src-docfilessubdirs/doc-files/colophon.html to directory
html-4468396-docfilessubdirs/doc-files...
-Doug Kramer
Javadoc team
Thanks for your help - here is the output from my javadoc command:
Loading source files for package jcmdline...
Constructing Javadoc information...
Standard Doclet version 1.4.1
Generating /tmp/jcmdline/build/doc/jcmdline/api/constant-values.html...
Building tree for all the packages and classes...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/VersionCmdLineHandler.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/UsageFormatter.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/TimeParam.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/TextUsageFormatter.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/Strings.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/StringParam.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/StringFormatHelper.html...
#- omitting some classes for brevity #
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/class-use/AbstractHandlerDecorator.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/package-use.html...
Building index for all the packages and classes...
Generating /tmp/jcmdline/build/doc/jcmdline/api/overview-tree.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/index-all.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/deprecated-list.html...
Building index for all classes...
Generating /tmp/jcmdline/build/doc/jcmdline/api/allclasses-frame.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/allclasses-noframe.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/index.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/packages.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/package-frame.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/package-summary.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/package-tree.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/CmdLineHandler.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/CmdLineParser.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/OptionTakesNoValue.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/Parameter.html...
# again omitting some here #
Generating /tmp/jcmdline/build/doc/jcmdline/api/jcmdline/CmdLineException.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/serialized-form.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/package-list...
Generating /tmp/jcmdline/build/doc/jcmdline/api/help-doc.html...
Generating /tmp/jcmdline/build/doc/jcmdline/api/stylesheet.css...
