MIFdoclet blues...

Hello Javadoc community,

Any estimate on when the new MIFdoclet that works with J2SE 5.0 will be released? The currently available version is simply too old for newer code that uses features such as enum.

Which bring me to a problem with an "out-of-the-box" use of the current MIFdoclet distribution. When I execute runmif.bat, I get the following java.lang.NoSuchMethodError error in my J2SE 5.0 SDK environment.

[snip]

MIF Doclet version 1.2 beta 2 (build date: 09 Aug 2002)

Generating sample-out\mif\overview.mif...

Using default stylemap file...

Template Used: c:\doc-tools\mifdoclet1

2\test\example-commandline\sample-out\mif\template.mif

Using default batchmap file...

javadoc: error - In doclet class com.sun.tools.doclets.mif.MIFDoclet, method s

art has thrown an exception java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodError: com.sun.tools.doclets.standard.Standard.configurat

on()Lcom/sun/tools/doclets/standard/ConfigurationStandard;

at com.sun.tools.doclets.mif.MIFDoclet.startGeneration(MIFDoclet.java:7

)

at com.sun.tools.doclets.mif.MIFDoclet.start(MIFDoclet.java:45)

at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl

java:39)

at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcce

sorImpl.java:25)

at java.lang.reflect.Method.invoke(Method.java:585)

at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269)

at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143)

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)

1 error

I have not modified the runmif.bat contents:

$ cat runmif.bat

javadoc ^

-doclet com.sun.tools.doclets.mif.MIFDoclet ^

-docletpath ..\..\lib\mifdoclet.jar ^

-J-Xmx20M ^

-batch dzbatcher ^

-print pdf ^

-d sample-out ^

-overviewfile ..\sample-src\overview.html ^

-overviewtitle "Sample Packages" ^

-overviewtree ^

-group "Summary of Sample Packages" "com.*" ^

-membersummary compact ^

-booktitle"Sample Packages" ^

-booksubtitle "for Java\xaa" ^

-bookversion"Version 1.0" ^

-bookauthor"Duke" ^

-bookpublisher "Sun Press" ^

-bookcopyright "Copyright \xa9 2001 Duke, Inc." ^

-sourcepath ..\sample-src ^

com.package1 com.package1.subpackage com.package2

Any pointers appreciated.

Thanks

Mathur

[2775 byte] By [mat_sida] at [2007-10-2 20:28:27]
# 1

We finished the MIF Doclet for J2SE 5.0 about a year ago -- it handles generics, and I believe enums, annotations, etc. But the powers inside Sun wanted more time to decide whether to release it. One thing that would help would be showing a demand for it. I suggest adding this as a request at

http://bugs.sun.com/services/bugreport/index.jsp

using the category "Custom doclets for the Javadoc tool" and subcategory "MIF Doclet"

I would call it something like "Please release MIF Doclet 5.0 to public"

(the version number of doclets always corresponds to the JDK version whose language features it supports)

Then vote for it and post the bug URL on this forum.

FYI, here's the list of open MIF doclet bugs:

http://bugs.sun.com/bugdatabase/search.do?process=1&category=customdoclets&bugStatus=open&subcategory=mifdoclet

As far as your error, I suggest going to this page and searching for "InvocationTargetException". There are a number of known causes for this error in the "out-of-the-box" version 1.2.

http://java.sun.com/j2se/javadoc/mifdoclet/1.2/docs/mifdoclet.html#errorandwarningmessages

dhkramera at 2007-7-13 23:11:23 > top of Java-index,Developer Tools,Debugging and Profiling Tool APIs...