JDK-4385048 : stddoclet: Subdirectories of "doc-files" (e.g., doc-files/images) are not copied
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.3.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2000-11-01
  • Updated: 2014-05-05
  • Resolved: 2001-03-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.0 betaFixed
Description
Name: krC82822			Date: 11/01/2000


01 Nov 2000, eval1127@eng -- user is requesting a "deep" (recursive) copy of everything in and below/under "doc-files".  See also # 4256505.

----------------

java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)

According to this documentation:

http://java.sun.com/products/jdk/1.2/docs/tooldocs/win32/javadoc.html#unprocessed

Quote:

   ... it simply copies the directory and all its contents to the destination.

The bug is that if I have a file tutorial.html in doc-files and put gif files in
a subdirectory (very common) such as doc-files/images, then that directory is
never copied. The tutorial.html file is copied, but not the images needed.
(Review ID: 109203) 
======================================================================

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: merlin-beta FIXED IN: merlin-beta INTEGRATED IN: merlin-beta
14-06-2004

WORK AROUND Name: krC82822 Date: 11/01/2000 Move all images out of the directory. ======================================================================
11-06-2004

PUBLIC COMMENTS This bug has been fixed. The standard doclet now does a "deep" recursive copy of everything in and below/under "doc-files". jamie.ho@Eng 2001-01-18 For this to be enabled, it requires this option: -docfilessubdirs and if you need it, also this option: -excludedocfilessubdir <name1>:<name2>... to exclude any doc-files subdirectories with the given names. This prevents the copying of SCCS and other source-code-control subdirectories. doug.kramer@Eng 2001-08-04
04-08-2001

EVALUATION The following changes were made to fix this bug: HtmlStandardWriter: - Added constant to store the docs file directory name ("doc-files"). - Modified method "copyDocFiles" to recursively copy everything in and below/under "doc-files". jamie.ho@Eng 2001-01-18 Javadoc should do a deep copy of the doc-files directory, recursively copying *all* of its contents. More than one developer has asked for this. doug.kramer@Eng 2001-01-18
18-01-2001