> -----Original Message----- > From: Erik Hatcher [mailto:[EMAIL PROTECTED] > Sent: Wednesday, 27 February 2002 3:44 PM > To: Ant Developers List; [EMAIL PROTECTED] > Subject: XDocs Proposal > > > From: <[EMAIL PROTECTED]> > > > ehatcher 02/02/26 21:25:36 > > > > Added: proposal/xdocs/src/org/apache/tools/ant/xdoclet > > AntSubTask.java AntTagsHandler.java > > Log: > > First pass at XDoclet generation of Ant task documentation. >
> > Let me know if you spot any idiosyncracies in what it generates - > I've only > spot checked some things to make sure it was looking decent. I > wrapped all > possible XML breaking things in CDATA - maybe its better to encode strings > first? > > Anyway, have at it! I look forward to your feedback and improvements. > Wow. This is very cool. Some minor comments: * It looks like the template is picking up nested classes when generating the default.properties file. For example, there's a task called 'ant.reference' in there that points to class taskdefs.Ant. * I wonder if might be worth adding an (optional) @ant:description tag, which would take precedence over the comment. It might be useful at times to be able to add comments to a class or method, that don't end up in the user guide. * Should we add the equivalent of the user manual's "required" column somewhere? * I guess we need to handle the data types as well. Seems like it should be straight-forward enough. Adam -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
