United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-5101868 : REGRESSION: javadoc crashes after generating mixed Windows/Linux file-linknames

Details
Type:
Bug
Submit Date:
2004-09-14
Status:
Resolved
Updated Date:
2013-09-03
Project Name:
JDK
Resolved Date:
2013-09-03
Component:
docs
OS:
linux,windows_xp,windows_2000
Sub-Component:
doclet
CPU:
x86
Priority:
P3
Resolution:
Cannot Reproduce
Affected Versions:
5.0,6
Fixed Versions:
8

Related Reports
Duplicate:

Sub Tasks

Description
Name: rmT116609			Date: 09/14/2004


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

ADDITIONAL OS VERSION INFORMATION :
os.name              = Windows 2000

EXTRA RELEVANT SYSTEM CONFIGURATION :
java.vm.version      = 1.5.0-rc-b63
java.vm.vendor       = Sun Microsystems Inc.
java.vendor.url      = http://java.sun.com/
path.separator       = ;
file.separator       = java.vm.name         = Java HotSpot(TM) Client VM
file.encoding.pkg    = sun.io
user.country         = DE
sun.os.patch.level   = Service Pack 4
java.vm.specification.name = Java Virtual Machine Specification
user.dir             = D:\weinert\javaFactory
java.runtime.version = 1.5.0-rc-b63

A DESCRIPTION OF THE PROBLEM :
Javadoc generation with Links to Sun-Api, JDOM etc. by the folowing commands

PushD %jdksRoot%\%javaVersion%\docs\aWeinertBib

del /s /q %jdksRoot%\%javaVersion%\docs\aWeinertBib\*.*

Javadoc -author -version -protected -use -source 1.4  -J-mx32m -J-ms32m -link ../api -link ../jDOM  -sourcepath D:\Weinert\javaFactory\  @D:\Weinert\javaFactory\DEawDoc.list

PopD

works (very) fine up to 1.4.2

but crashes with any 1.5.x

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Call JavaDoc according to Description

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
should work as iuntil 1.4.2
ACTUAL -
output shows the generation of mixed Windows Linux fileseparator
filenames and /or links

the Nullpointer crash w/o having generated the javadoc index.html file
might be a consequence.

ERROR MESSAGES/STACK TRACES THAT OCCUR :
........
Generating de/a_weinert/facil/\class-use\CodeTaste.html...
Generating de/a_weinert/facil/\class-use\Blitz.html...
Generating de/a_weinert/facil/\class-use\BinTriggSensor.html...
Generating de/a_weinert/facil/\class-use\BinAktor.html...
Generating de/a_weinert/facil/\class-use\BewMeld.html...
Generating de/a_weinert/facil/\class-use\Bereich.html...
Generating package-use.html...
Generating de/a_weinert/\package-use.html...
java.lang.NullPointerException
        at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUs
e(PackageUseWriter.java:180)
        at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageLi
st(PackageUseWriter.java:124)
        at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUs
e(PackageUseWriter.java:110)
        at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUs
eFile(PackageUseWriter.java:99)
        at com.sun.tools.doclets.formats.html.PackageUseWriter.generate(PackageU
seWriter.java:78)
        at com.sun.tools.doclets.formats.html.ClassUseWriter.generate(ClassUseWr
iter.java:116)
        at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(Html
Doclet.java:92)
        at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration
(AbstractDoclet.java:122)
        at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractD
oclet.java:64)
        at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:4
2)
        at com.sun.tools.doclets.standard.Standard.start(Standard.java:23)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.
java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:585)
        at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:215)
        at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:91)
        at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340)
        at com.sun.tools.javadoc.Start.begin(Start.java:128)
        at com.sun.tools.javadoc.Main.execute(Main.java:41)
        at com.sun.tools.javadoc.Main.main(Main.java:31)

C:\Programme\jdk\docs\aWeinertBib>REM Javadoc -author -version -protected -use -
J-mx32m -J-ms32m -link ../api -link ../jDOM  @D:\Weinert\javaFactory\DEawDoc.lis
t

C:\Programme\jdk\docs\aWeinertBib>PopD

D:\weinert\javaFactory>Pause Alles OK ? (Abbruch mit cntl+C)
DrM-^O????cken Sie eine beliebige Taste . . .

D:\weinert\javaFactory>java -version
java version "1.5.0-rc"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0-rc-b63)
Java HotSpot(TM) Client VM (build 1.5.0-rc-b63, mixed mode, sharing)

REPRODUCIBILITY :
This bug can be reproduced always.

Release Regression From : 1.4.2
The above release value was the last known release where this 
bug was known to work. Since then there has been a regression.

(Incident Review ID: 302313) 
======================================================================

                                    

Comments
Cannot be reproduced on JDK 8. Seems to be fix in one of the earlier releases.
                                     
2013-09-03
WORK AROUND

The workaround is to leave off the -use switch, since
that's where the NPE occurs. But the bug definitely
needs fixing.
                                     
2006-03-23
EVALUATION

###@###.### 2004-09-16
                                     
2004-09-16



Hardware and Software, Engineered to Work Together