Name: rmT116609 Date: 08/07/2003


FULL PRODUCT VERSION :
java version "1.4.2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28)
Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)

FULL OS VERSION :
Microsoft Windows 2000 [Version 5.00.2195]

EXTRA RELEVANT SYSTEM CONFIGURATION :
The disk that the output directory for the javadoc (the -d option) is a Windows mounted Unix drive on the network.

A DESCRIPTION OF THE PROBLEM :
javadoc 1.4.2 fails to create the directory structure for the HTML files it generates. The root directory
that is used with the -d option does exist, the directory structure below the root directory is not
created.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1) Create a very simple java source file with javadoc comments embedded.
2) Run javadoc with the -d option set to a windows mapped network drive on a unix machine.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Expected javadoc to create the HTML web pages on any mapped disk drive as it did in SDK 1.4.1_03.
ACTUAL -
One subdirectory was created:
'resources', which contained the file 'inherit.gif',
also the HTML page 'constant-values.html' was created,
then javadoc failed.

J: is a mapped drive on a unix platform.

J:\JAVA\bugTest>G:\j2sdk1.4.2\bin\javadoc.exe -d bugDoc -linkoffline http://java.sun.com/j2se/1.4.2/docs/api java.sun.com\java142 -use -version -author -private -splitindex -classpath .;classes; -group "System Build Package" "bug.*" -sourcepath .;classes; bug.testjavadoc -windowtitle "JavaDoc Bug Test" -header "<b><font size=-1>JavaDoc Bug Test</font></b>" -footer "<b><font size=-1>JavaDoc Bug Test</font></b>" -bottom "<center><font size='+2'>JavaDoc Bug Test</b></font></center>" -doctitle "JavaDoc Bug Test Package Overview"
Loading source files for package bug.testjavadoc... Constructing Javadoc information...
Standard Doclet version 1.4.2
Generating bugDoc\constant-values.html...
Building tree for all the packages and classes...
javadoc: Unable to create directory bugDoc\bug\testjavadoc\class-use
1 error


ERROR MESSAGES/STACK TRACES THAT OCCUR :
javadoc: Unable to create directory bugDoc\bug\testjavadoc\class-use

REPRODUCIBILITY :
This bug can be reproduced always.

---------- BEGIN SOURCE ----------

package bug.testjavadoc;

/**
 * Test javadoc
 */
public class testJavaDoc
{
  /**
   * Default constructor
   */
  public testJavaDoc( )
  {
  }
}

---------- END SOURCE ----------

CUSTOMER SUBMITTED WORKAROUND :
Can not use a mapped disk that is on a unix platform (Sun), must be a mapped disk on a Windows platform.
(Incident Review ID: 193658)
======================================================================