Hi Steve, XDoclet!

You're right, there is a new sub project called xjavadoc. It's 
something Ara and I have discussed the last week. It started out as a 
discussion about a reverse XDoclet engine - something that can read 
deployment descriptors and java source code, and then insert the proper 
@tags that would be able to reproduce the deployment descriptors. Why? 
lots of reasons, mainly to make XDoclet easier to adopt for projects 
that didn't use it from the start.

Then we had to find a way to insert the tags. We talked about using 
JRefactory's visitors, try to write something on top of that. 
JRefactory is built on top of JavaCC, so we figured out writing this 
code mutation engine from scratch based on JavaCC would be just as 
easy, and give us more control.

This engine will have an API similar to Javadoc, except it will have 
mutators too. Sorta ClassDeclaration.getMethod().addTag(). When/if this 
engine gets good enough, we can swap good'ol Javadoc which we all know 
sucks bigtime with XJavadoc, which will provide the same services++, 
but without all the braindead stdout warnings and other shortcomings.

There has also been some talk about GUIs for XDoclet. We'll try to 
design the XJavadoc and reverse XDoclet so it can be easily used by GUI 
tools like Middlegen and perhaps other tools.

Back to the reverse XDoclet. This will be a second subproject that 
relies on xjavadoc for code mutation. Reverse XDoclet's core 
functionality will be to parse various deployment descriptors and use 
XJavadoc to stuff in new tags. We'll probably use JDom/Jaxen/SaxPath to 
do the XML parsing/content extraction.

So what's the status? I have been prototyping an experimenting a little 
with JavaCC, and I feel confident with it. I have also done some work 
on the XML parsing stuff. I will hopefully commit this into the new 
module during the weekend, so everybody can have a word before I paint 
myself into a corner.

Regards,
Aslak



----- Original Message -----
From: [EMAIL PROTECTED] (Andrew Stevens)
Date: Thursday, November 15, 2001 11:17 pm
Subject: Re: [Xdoclet-devel] CVS update: 'xjavadoc - Imported sources'

> A wise old hermit known only as Ara Abrahamian 
> <[EMAIL PROTECTED]> once said:
> 
> > Log Message:
> > Created a new module: xjavadoc
> > 
> > Status:
> > 
> > Vendor Tag:        XDoclet
> > Release Tags:        v0_1
> >                 
> > N xjavadoc/readme.txt
> 
> "A sub-project of XDoclet to create a better and more 
> extensible/flexible 
> javadoc doclet engine mainly for GUI tools."
> 
> Care to enlighten us, Ara?
> 
> 
> Andrew.
> 
> _______________________________________________
> Xdoclet-devel mailing list
> [EMAIL PROTECTED]
> https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
> 


_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel

Reply via email to