From: "Pasi Nummisalo" <[EMAIL PROTECTED]>
> Documenting taglibs has been discussed earlier at
> this list. The current solution to produce TLD and
> HTML doc from XML file is one solution.
>
> Personally I would like to do the documentation once
> in the source code and generate
> TLD and HTML tag reference docs with custom doclets.
>
> The "TLD" doclet could translate extra doclet tags to give
> necessary information for TLD generation, e.g. for set
> methods "@tld:required true".
>
> Is there already such doclets?
> Any arguments against this approach?
> Any standard efforts on this matter?
I do quite like how the current build works right now but documenting the
individual attributes of tags can be troublesome - that could be a great
area for doclets - to spot all the setFoo() methods and use the comment
@tld:required true markup to generate the attribute documentation & TLD.
Right now its very easy to add some attributes to a tag in Java code but
forget to update the XML to document them and put them in the TLD.
James
_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com
