JDK-5101868 : REGRESSION: javadoc crashes after generating mixed Windows/Linux file-linknames
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 5.0,6
  • Priority: P3
  • Status: Resolved
  • Resolution: Cannot Reproduce
  • OS: linux,windows_2000,windows_xp
  • CPU: x86
  • Submitted: 2004-09-14
  • Updated: 2014-05-05
  • Resolved: 2013-09-03
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.
JDK 8
8Resolved
Related Reports
Duplicate :  
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