jme3 javadoc building broken?

normen · March 28, 2010, 11:39am

I have a strange nullpointer happening when I try to build the javadoc for jme3. It happens when I call the ant javadoc target in NetBeans and on the command line.

Anyone else having this problem or does the javadoc build without problems for you?

[javadoc] java.lang.NullPointerException [javadoc] at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUse(PackageUseWriter.java:180) [javadoc] at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageList(PackageUseWriter.java:124) [javadoc] at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUse(PackageUseWriter.java:110) [javadoc] Generating /Users/normenhansen/Documents/Code/jme3/dist/javadoc/package-use.html... [javadoc] 123 warnings [javadoc] at com.sun.tools.doclets.formats.html.PackageUseWriter.generatePackageUseFile(PackageUseWriter.java:99) [javadoc] at com.sun.tools.doclets.formats.html.PackageUseWriter.generate(PackageUseWriter.java:78) [javadoc] at com.sun.tools.doclets.formats.html.ClassUseWriter.generate(ClassUseWriter.java:116) [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(HtmlDoclet.java:92) [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:122) [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) [javadoc] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) [javadoc] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) [javadoc] at java.lang.reflect.Method.invoke(Method.java:592) [javadoc] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) [javadoc] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) [javadoc] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) [javadoc] at com.sun.tools.javadoc.Start.begin(Start.java:128) [javadoc] at com.sun.tools.javadoc.Main.execute(Main.java:41) [javadoc] at com.sun.tools.javadoc.Main.main(Main.java:31)

Empire_Phoenix · March 28, 2010, 12:54pm

Yes, I also get exactly that one when using Eclipse and not the provided Ant script.

normen · March 28, 2010, 2:16pm

Ok, so somewhere in the jme3 javadoc seems to be a syntax error that triggers a bug in the javadoc compiler

Momoko_Fan · March 28, 2010, 5:17pm

I feel proud for writing docs that break javadoc, they must really kick ass.

Anyone know which file is causing the issue?

normen · March 28, 2010, 7:35pm

Momoko_Fan said:

I feel proud for writing docs that break javadoc, they must really kick ass.
Anyone know which file is causing the issue?

Yeah you sure can be ;) Its kinda hard to follow which file it is because it happens after parsing the files when they are already put into internal java objects. Did not try to make javadoc more verbose yet. From what it looks its somehow on the class level, not methods because it fails to compile the uses of some class.

pgi · March 29, 2010, 12:49am

On my pc the npe is generated by the PrettyFace.java class in the default package of Tools. Moving that class to a "jme3tools" package solved the issue.

normen · March 29, 2010, 1:32am

pgi said:

On my pc the npe is generated by the PrettyFace.java class in the default package of Tools. Moving that class to a "jme3tools" package solved the issue.

Yup, that file was it, thank you pgi. I think it can be removed from jme3 anyway, Kirill?

Momoko_Fan · March 29, 2010, 5:24pm

Maybe…? I just ported it from blender to generate UV coords for lightmapping… yeah it can be removed.