Hi all, Current javadoc tag situation is really miserable, there is no formal tag definition, and neither way to validate they correctness.
So missed required parameter will bomb with cryptic error message which does not say anything abot its cause. I thought about this problem, and I have started to work at solution ( xtags ) What it shall provide: - clear way to define and describe javadoc tags ( required parameters , data types etc. ). I we are thinking about GUI tools which would help to tag classes, such formal definition is necessary. Formal tag definition can be used to produce tag documentation automagically. - Generic "tag bean" which can be conveniently costructed from tag text , and would bomb if required parameters are missed, or on not allowed values. Such tag bean can be built using reflection proxy & invocation handlers. Another advantage of tag bean would be possibility to prewalk javadoc tree, and construct tag beans thus checking supplied tags for correctness. Tag bean could be then used in templates I already started to work on this, and here is the archive: http://www.pribluda.de/xtags.tar.gz What works: - xml parsing, meta data building, automatic tag bean interface generation Magic reflection proxies / invocation handlers are not existing yet, but in work. Build scripts are tested on unix, so bat files are on your discretion comments please... regards, ===== Konstantin Priblouda ( ko5tik ) Freelance Software developer < http://www.pribluda.de > < play java games -> http://www.yook.de > < render charts online -> http://www.pribluda.de/povray/ > __________________________________________________ Do You Yahoo!? Send FREE video emails in Yahoo! Mail! http://promo.yahoo.com/videomail/ _______________________________________________ Xdoclet-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
