Skip to main content

Generating JavaDoc documentation of CLDC using "make docs_html" in Linux.

1 reply [Last post]
sandykhan
Offline
Joined: 2008-01-15

I have installed javaDoc documentation tool along with JDK 1.4.2, but I am unable to generate documentation through it.

Whenever I run the make docs_html command, the following error appears:

make: *** No rule to make target `docs_html'. Stop.

Please, guide me how to resolve this. I am building a CLDC Reference Port of phoneME Feature software.

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
jonek
Offline
Joined: 2006-12-13

Hi,

I have the same problem. Help appreciated!

CLDC: there is NO make target "docs_javadoc" available
MIDP: there is a make target "docs_javadoc" available!

Do javadocs of MIDP depend on javadocs generated for CLDC? (see $MEHOME/midp/build/common/makefiles/Docs.gmk:
...
CLDC_JAVADOC_PACKAGES += \
com.sun.cldc.io \
com.sun.cldc.util.j2me \
com.sun.cldc.util \
com.sun.cldchi.io \
com.sun.cldchi.jvm \
com.sun.midp.io.j2me \
java.io \
java.lang.ref \
java.lang
...
)

Invoking "docs_javadoc" after building MIDP for Linux generates some docs but failes like:
...
Generating /tmp/phoneME-feature-MR2/build_output/midp/doc/javadoc/html/javax/microedition/media/MediaException.html...
javadoc: In doclet class com.sun.tools.doclets.standard.Standard, method start has thrown an exception java.lang.reflect.InvocationTargetException
com.sun.tools.javac.v8.code.Symbol$CompletionFailure: file java/lang/Throwable.class not found
at com.sun.tools.javac.v8.code.ClassReader.(ClassReader.java:1118)
at com.sun.tools.javadoc.JavadocClassReader.(JavadocClassReader.java:32)
at com.sun.tools.javadoc.JavadocClassReader.instance0(JavadocClassReader.java:26)
at com.sun.tools.javadoc.JavadocTool.make0(JavadocTool.java:106)
at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:300)
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)
101 errors
459 warnings
make: *** [docs_javadoc] Error 1

I'm also interested in building Java documentation for more than just the 'public interface' of the CLDC and the MIDP API. Is that possible somehow?

Greets, Jonek.