Yo! (This is Aslak writing from Hotmail, which I rarely do. My regular ISP 
is down).

After a discussion with Ara yesterday, we decided that it's time to start 
replacing com.sun.javadoc with xjavadoc in the xdoclet source. I have 
created a new branch named XJAVADOC_REFACTORING for this.

PLEASE TRY TO AVOID ADDING/COMMITTING ANYTHING TO THE XDOCLET CORE UNTIL THE 
REFACTORING IS DONE.

It's a very big job, so I would like to warn you all that this might take 
some time (at least a three days, more likely a week). The first step is to 
get things to compile, the second is to verify that everything works as 
before.

It's important that as many as possible can participate in the second step, 
as nobody knows all parts an dark corners of xdoclet anymore. The 
refactoring will most likely introduce some bugs, so let's kill them 
together.

The main changes will be:
1) No more com.sun.javadoc dependency
2) Reading tags and tag parameters will be done by xjavadoc, and not 
xdoclet. (I suggest we call parameters attributes instead. That's more along 
the lines of the XML vocabulary).
3) Hopefully xdoclet will be a lot faster, but that remains to prove. 
Benchmarks are positive though.

I won't commit anything to the branch before I can compile the new core, but 
I will do it as soon as it does.

In the meanwhile it's time for you all to take a look at the xjavadoc code 
and get familiar with it, as you'll all be using it very soon.

Cheers,
Aslak

_________________________________________________________________
Get your FREE download of MSN Explorer at http://explorer.msn.com/intl.asp.


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

Reply via email to