Here's a message from an XDoclet developer, and there is a comment at the end (directed to me) regarding the nested <tag> of <javadoc>..... thoughts? Is this a bug?
----- Original Message ----- From: "Andrew Stevens" <[EMAIL PROTECTED]> To: <[email protected]> Sent: Monday, June 17, 2002 6:34 PM Subject: [Xdoclet-devel] @tags and javadoc 1.4 warnings > Something I was wondering about earlier... > > The ejb.tags format was added so that javadoc 1.4 can be told to ignore > our custom tags with the -tag option. However, we do have quite a lot of > them so typing them all in by hand is likely to be laborious and error > prone. Since they're all described in the xtags, how about somewhere in > the documentation generating a list of them all suitable for cut & paste > into the -tag command line argument? > > Also, since such a list is likely to exceed the maximum command line > length on many systems, perhaps we should also/instead generate a file > containing them on separate -tag lines for including with @argfile (as > described under "Example of a complete set of tags" at > http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html#tag )? > > Lastly, I see that Ant 1.5's javadoc task supports <tag> nested elements; > it might be a good idea if we generated a list of them all in this format > too, so that they can be included in Ant scripts with just an entity > declaration. > > By the way, Erik (resident Ant expert), any idea why the description > attribute of tag nested elements is required? (according to the docs at > http://jakarta.apache.org/ant/manual/CoreTasks/javadoc.html#tagelement ) > The javadoc docs include examples "-tag param", "-tag example:X", etc. > which suggests to me it should be optional? > > > Andrew. > > -------------------------------------------------------------------------- -- > Bringing you mounds of caffeinated joy > >>> http://thinkgeek.com/sf <<< > > _______________________________________________ > Xdoclet-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/xdoclet-devel > -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
