[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[aspectj-dev] ajdoc is dead, long live ajdoc

We all thought that we buried that version of ajdoc that generated source
files, ran Javadoc over them, then post-processed the generated HTML.  But
this seemed like the only way to get ajdoc back in the hands of users given
our current resources.  So I resurrected it, moved it on top of the ASM, and
made it work for 1.2-1.4 doclets.

By "made it work", I mean that it generates documentation for spacewar and a
few other simple systems in its test suite.  I implemented the "advises" and
"advised by" links, so there is still all the declare stuff to do.  But now
that all the infrastructure works that should be straightforward.  Russell
Miles has volunteered (yay!) and I'll help him make that work.  A few notes:

BUILD

George: Could you check that the "ajdoc" module is getting built on the
build machine?  Also, it's "ajdoc.bat" file should be getting generated in
the same way that "ajbrowser.bat" is.

Wes: should George grab the script generation stuff from 1.0.x or should we
just copy the ajbrowser stuff since its so similar?

TESTING

We need to run ajdoc on a big system as a part of testing, and make sure
that it doesn't fail.  Either the JDK or our source tree.  Right now I'm
pretty sure something will fail when it gets into the corner case of the
JDK, but any fixes should be straightforward.  How do we do that as a part
of the build?  It would also be good to run it with 1.2, 1.3, and 1.4
versions of Javadoc underneath.

UI RATIONALE

I took a quick pass at making the display of crosscutting a bit better.  The
"Advises" and "Advised by" headings show up in a light-orange cell (keeping
with "blue is OO, orange is AO" theme).  The shading parallels how Javadoc
displays "inherited members"--i.e. things that aren't really in that file,
but are links to elsewhere.  Instead of a vertical arrangement of "inherited
members", the table has a horizontal arrangement to make it different and
make better use of h-space.

Mik

--
http://kerstens.org/mik
 

Attachment: ajdoc.gif
Description: GIF image