Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 217102 - dev-java/ant-core-1.7.0-r1: javadoc dies with jdk 1.4
Summary: dev-java/ant-core-1.7.0-r1: javadoc dies with jdk 1.4
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Java (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Java team
URL: https://issues.apache.org/bugzilla/sh...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-04-10 08:53 UTC by Martin von Gagern
Modified: 2009-05-18 16:25 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
Switch lines, failonerror (bug217102a.patch,1.98 KB, patch)
2009-02-18 14:33 UTC, Martin von Gagern
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Martin von Gagern 2008-04-10 08:53:46 UTC
javadoc: In doclet class com.sun.tools.doclets.standard.Standard,  method start has thrown an exception java.lang.reflect.InvocationTargetException
java.lang.NullPointerException
        at com.sun.tools.doclets.standard.tags.ValueTaglet.toString(ValueTaglet.java:43)
        at com.sun.tools.doclets.standard.HtmlStandardWriter.commentTagsToString(HtmlStandardWriter.java:1691)
        at com.sun.tools.doclets.standard.tags.SimpleTaglet.toString(SimpleTaglet.java:244)
        at com.sun.tools.doclets.standard.AbstractSubWriter.printTags(AbstractSubWriter.java:235)
        at com.sun.tools.doclets.standard.AbstractSubWriter.printCommentAndTags(AbstractSubWriter.java:293)
        at com.sun.tools.doclets.standard.AbstractSubWriter.printFullComment(AbstractSubWriter.java:287)
        at com.sun.tools.doclets.standard.FieldSubWriter.printMember(FieldSubWriter.java:100)
        at com.sun.tools.doclets.standard.AbstractSubWriter.printMembers(AbstractSubWriter.java:416)
        at com.sun.tools.doclets.standard.ClassWriter.printAllMembers(ClassWriter.java:269)
        at com.sun.tools.doclets.standard.ClassWriter.generateClassFile(ClassWriter.java:234)
        at com.sun.tools.doclets.standard.ClassWriter.generate(ClassWriter.java:90)
        at com.sun.tools.doclets.standard.Standard.generateClassCycle(Standard.java:236)
        at com.sun.tools.doclets.standard.Standard.generateClassFiles(Standard.java:199)
        at com.sun.tools.doclets.standard.Standard.startGeneration(Standard.java:165)
        at com.sun.tools.doclets.standard.Standard.start(Standard.java:43)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:324)
        at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:193)
        at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:92)
        at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:311)
        at com.sun.tools.javadoc.Start.begin(Start.java:121)
        at com.sun.tools.javadoc.Main.execute(Main.java:41)
        at com.sun.tools.javadoc.Main.main(Main.java:31)

This error causes part of the documentation not to get built. However, the build does not fail, so the emerge does not fail either. It's just missing some javadoc classes.

I could reproduce this issue with both dev-java/blackdown-jdk-1.4.2.03-r16 and dev-java/sun-jdk-1.4.2.17 while dev-java/sun-jdk-1.5.0.14 seems to work.

So a workaround would be this command:
JAVA_PKG_FORCE_VM=sun-jdk-1.5 emerge ant-core

The actual problem might be within the javadoc code itself, so I guess it might have to be fixed properly upstream. Still, the ebuild should deal with the issue, maybe depend on sun-jdk-1.5 if doc is used, maybe print a warning if files are missing from the generated documentation, I don't know.
Comment 1 Petteri Räty (RETIRED) gentoo-dev 2008-04-10 20:44:03 UTC
I remember javadoc failing like this with some special tags should just dig out what it was and fix it in the javadoc sources.
Comment 2 Martin von Gagern 2009-02-18 14:33:09 UTC
Created attachment 182433 [details, diff]
Switch lines, failonerror

The cause seems to be @value tags after @since tags.
This patch fixes the issue by switching some lines in question. It also adds failonerror to the javadoc tasks in build.xml.
Comment 3 Petteri Räty (RETIRED) gentoo-dev 2009-02-18 18:57:22 UTC
(In reply to comment #2)
> Created an attachment (id=182433) [edit]
> Switch lines, failonerror
> 
> The cause seems to be @value tags after @since tags.
> This patch fixes the issue by switching some lines in question. It also adds
> failonerror to the javadoc tasks in build.xml.
> 

Please submit the patch upstream and post the link back here.
Comment 4 Martin von Gagern 2009-02-18 19:33:08 UTC
(In reply to comment #3)
> Please submit the patch upstream and post the link back here.

Done: https://issues.apache.org/bugzilla/show_bug.cgi?id=46731
Comment 5 Petteri Räty (RETIRED) gentoo-dev 2009-03-17 12:54:34 UTC
Patch added. Sorry about the wait. It helps to ping us on IRC :)
Comment 6 Martin von Gagern 2009-05-18 16:25:41 UTC
Comitted upstream, so this patch can go as soon as it doesn't apply any more.
https://issues.apache.org/bugzilla/show_bug.cgi?id=46731#c1
http://svn.apache.org/viewvc?view=rev&revision=775914