[dbdoclet] Re: upgrade dbdoclet to jdk 1.5

Hi,

Michael wrote:

Hello,
I want to upgrade dbdoclet to jdk 1.5.
Some users need support for annotations and I want to use the new features.
Afterwards, dbdoclet will no longer work with JDK 1.4.x.

If anybody has something to say, say it now.

Regards
Michael




The dbdoclet port to Java 1.5 seems to be insidpensable to me.
http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/doclet/transition-1.5docletapi.html says how.
Annotations will become more and more importand, and so will their JavaDoc documentation.
See for example MMBI http://jsesoft-mmbi.sourceforge.net (a little tool of mine which
instruments arbitrary objects as JMX ModelMBeans).

On the other hand, it's not only Java that changes regularly: it is DocBook as well.
And other formats are around (e.g. maven's xdoc, see http://maven.apache.org )
In my opinion, it would be nice to have a JavaDocInspector, which traverses the
JavaDoc of a class with the help of the DocLet API and calls respective handler
functions for all JavaDoc elements (ClassDoc, MethodDoc, ConstructorDoc,
ParamTag, ...) encountered. By the help of subclassing, attaching a strategy, or
even plug-in (see http://jpf.sourceforge.net) these handler functions can be customized
for producing different DocBook for different situationa, or even other XML or
non-XML formats. The above mentioned MMBI project does similar things
(provides a ReflectionInspector which traverses the reflection tree and calls respective
handler functions for all class members found, attaches a strategy which generates
JMX ModelMbean information which is customizable by annotations). And it
works nice.

Sorry for that lengthy post, but that's what came into my mind as I heard about
porting dbdoclet to Java 1.5.

Have fun,
Klaus

Other related posts: