[Cp-tools-discuss] Contributions: java parser; java annotation tool.

[C. Scott Ananian]

I read somewhere that gjdoc deliberately does *not* use a full java parser
because of speed concerns, but I thought I'd note that a tested and
working grammar for Java 1.4 --- as well as one for 1.4 + the JSE-14 "gj"
extensions --- licensed under the GPL is available from:
  http://www.cs.princeton.edu/~appel/modern/java/CUP/javagrm.tar.gz

I used this to create an annotation tool for java sources which is
currently distributed only as part of the FLEX Java compiler
  http://flexc.lcs.mit.edu
but is also under the GPL and might make a dandy classpath-tool, if
the consensus is that it is worthwhile enough for me to clean
up/package/contribute.  Sample output is at:
  
http://www.flex-compiler.lcs.mit.edu/Harpoon/srcdoc/harpoon/ClassFile/HClass.html

In other news, the lack of a javadoc tool that works with "generic java"
(Java 1.4 + JSE-14, "Java 1.5") has been a sore point for those of us who
like using parameterized types on a daily basis:
   http://forum.java.sun.com/thread.jsp?forum=316&thread=215781
I'm considering extending gjdoc for my own use to allow me to maintain
javadoc for my FLEX project (which recently moved to generic java).
Do those on the list think this is something worthwhile for the mainstream
tree (looking forward to generic types' eventual inclusion in Java 1.x)
or needn't I worry about making my gjdoc hacks pretty?
 --scott
[please cc me on any response; I'm not subscribed to this list.]

Secretary Yakima direct action Noriega corporate globalization Sugar Grove 
SSBN 731 SSBN 743 shotgun North Korea global action network RUCKUS 
                         ( http://cscott.net/ )