I am not sure if this is jdk bug (maybe not). Just write down as side note.
When compiling with jdk 6 (java version "1.6.0_25") following exception is thrown. Switching to jdk 7, this api doc exception goes away. Came across to find on the interest there is a same problem report, but no bug database link is provided. [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.8.1:jar (default) on project hama-core: MavenReportException: Error while creating archive: [ERROR] Exit code: 1 - java.lang.NullPointerException [ERROR] at com.sun.tools.javac.jvm.ClassReader.findMethod(ClassReader.java:974) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readEnclosingMethodAttr(ClassReader.java:926) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readMemberAttr(ClassReader.java:909) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readClassAttr(ClassReader.java:1053) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readClassAttrs(ClassReader.java:1067) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readClass(ClassReader.java:1560) [ERROR] at com.sun.tools.javac.jvm.ClassReader.readClassFile(ClassReader.java:1658) [ERROR] at com.sun.tools.javac.jvm.ClassReader.fillIn(ClassReader.java:1845) [ERROR] at com.sun.tools.javac.jvm.ClassReader.complete(ClassReader.java:1777) [ERROR] at com.sun.tools.javac.code.Symbol.complete(Symbol.java:386) [ERROR] at com.sun.tools.javac.code.Symbol$ClassSymbol.complete(Symbol.java:763) [ERROR] at com.sun.tools.javac.code.Symbol$ClassSymbol.flags(Symbol.java:695) [ERROR] at com.sun.tools.javadoc.ClassDocImpl.getFlags(ClassDocImpl.java:105) [ERROR] at com.sun.tools.javadoc.ClassDocImpl.isAnnotationType(ClassDocImpl.java:116) [ERROR] at com.sun.tools.javadoc.DocEnv.isAnnotationType(DocEnv.java:574) [ERROR] at com.sun.tools.javadoc.DocEnv.getClassDoc(DocEnv.java:546) [ERROR] at com.sun.tools.javadoc.PackageDocImpl.getClasses(PackageDocImpl.java:154) [ERROR] at com.sun.tools.javadoc.PackageDocImpl.addAllClassesTo(PackageDocImpl.java:170) [ERROR] at com.sun.tools.javadoc.RootDocImpl.classes(RootDocImpl.java:178) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:96) [ERROR] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) [ERROR] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) [ERROR] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [ERROR] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) [ERROR] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) [ERROR] at java.lang.reflect.Method.invoke(Method.java:597) [ERROR] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) [ERROR] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) [ERROR] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) [ERROR] at com.sun.tools.javadoc.Start.begin(Start.java:128) [ERROR] at com.sun.tools.javadoc.Main.execute(Main.java:41) [ERROR] at com.sun.tools.javadoc.Main.main(Main.java:31) [ERROR]