Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4385048
Votes 0
Synopsis stddoclet: Subdirectories of "doc-files" (e.g., doc-files/images) are not copied
Category doclet:tbd
Reported Against 1.3
Release Fixed 1.4(merlin-beta)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 01-NOV-2000
Description
This bug has been fixed.  The standard doclet now does a "deep" recursive copy of everything in and below/under "doc-files".
 xxxxx@xxxxx  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.

 xxxxx@xxxxx  2001-08-04


01 Nov 2000,  xxxxx@xxxxx  -- 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) 
======================================================================
Work Around




Move all images out of the directory.
======================================================================
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".
 xxxxx@xxxxx  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.
 xxxxx@xxxxx  2001-01-18
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang