Re: [aspectwerkz-dev] Creating AOPified javadocs

Hi

Mik will comment on method 1.

As regards method 2, we have a new weaver under dev that will "emit join
point". I guess that if we extend it to have a listener to that, we can
probably do the weaving not on the sources but on the "javac compiled
classes" ie fully reuse the regular weaver and avoid developping another.
Moreover, if javac debug mode had been turned on, we can emit the source
code line number of the join point I think.
Then the tool consumes the emitted join point (each notification has a bunch
of data, that might even allow avoiding qdox resolution of java.lang.reflect
resolution) and could "patch javadocs" - though I think having regular
javadoc processing on some empty stubs might be better.

Well, this is not ready yet, but, what do you think ?

The drawback of method 2 is that - I guess - doing the method 1 way might
open more opportunities to further integrate AJDT.

Alex


----- Original Message ----- 
From: "the_mindstorm" <[email protected]>
To: <[email protected]>
Sent: Thursday, August 26, 2004 11:39 PM
Subject: Re: [aspectwerkz-dev] Creating AOPified javadocs


> Hi!
>
> I finally got some time to look into ajdoc implementation.
>
> If i got it right the process used is the following:
> - compile the sources (weave aspects in)
> - generate fake/stub sources (including only declaration and javadoc
comments)
> from weaved classes
> - run javadoc upon the stubs
> - inject aspect related directly into html
>
> This seems to me a pretty complex and long process (2 memory extensive
consumers
> are run: weaving (AspectJ compiler) and javadoc).
>
> The draft solution I have in my mind is the following:
> - using QDox extract all joinpoint definitions
> - solve joinpoint definitions upon available sources
> - inject specific javadoc comments into the QDox structures
> - write down stubs generated by QDox
> - run javadoc upon stubs using a specific doclet
>
> Please give me your impressions/opinions on the above. 10x
>
> ::the_mindstorm
>
> PS: by the way, I am still using a nickname and I was not presenting
myself:
> Alexandru Popescu.
>
>
>