United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4385048 : stddoclet: Subdirectories of "doc-files" (e.g., doc-files/images) are not copied

Details
Type:
Bug
Submit Date:
2000-11-01
Status:
Resolved
Updated Date:
2014-05-05
Project Name:
JDK
Resolved Date:
2001-03-17
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.3.0
Fixed Versions:
1.4.0 (beta)

Related Reports

Sub Tasks

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


                                     
2004-06-14
WORK AROUND



Name: krC82822			Date: 11/01/2000


Move all images out of the directory.
======================================================================
                                     
2004-06-11
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
                                     
2001-08-04
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
                                     
2001-01-18



Hardware and Software, Engineered to Work Together