Return-Path: Delivered-To: apmail-jakarta-ant-dev-archive@apache.org Received: (qmail 98655 invoked from network); 5 Jan 2003 23:32:39 -0000 Received: from exchange.sun.com (192.18.33.10) by daedalus.apache.org with SMTP; 5 Jan 2003 23:32:39 -0000 Received: (qmail 17919 invoked by uid 97); 5 Jan 2003 23:33:59 -0000 Delivered-To: qmlist-jakarta-archive-ant-dev@jakarta.apache.org Received: (qmail 17903 invoked by uid 97); 5 Jan 2003 23:33:58 -0000 Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 17890 invoked by uid 98); 5 Jan 2003 23:33:58 -0000 X-Antivirus: nagoya (v4218 created Aug 14 2002) X-Sent: 5 Jan 2003 23:32:39 GMT Date: Sun, 5 Jan 2003 18:33:01 -0500 Subject: Re: XDoclet and Ant descriptor generation Content-Type: text/plain; charset=US-ASCII; format=flowed Mime-Version: 1.0 (Apple Message framework v551) From: Erik Hatcher To: "Ant Developers List" Content-Transfer-Encoding: 7bit In-Reply-To: <3E18AA5B.2000108@chalko.com> Message-Id: <0809B8DB-2106-11D7-9914-000393A564E6@ehatchersolutions.com> X-Mailer: Apple Mail (2.551) X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N On Sunday, January 5, 2003, at 04:57 PM, Nick Chalko wrote: > Antoine Levy-Lambert wrote: > >> Yes it works out of the box for me. And it is convincing. >> Now I see which javadoc comments will be important in the future. >> You will need to tell people how to add external files to the >> generated >> documentation, to add examples, tips, bugs, ... >> > Why not * @antdoc.example snippet="" > * description="Generates a default bar" > Lets keep as much as possible in the the source file. Because its a real pain to HTML encode all the <> symbols and its much easier to have an external file with samples clearly formatted and styled in HTML I believe. XDoclet's merge points make this a no brainer as far as pulling in some external information into the generated result, and other methods could be used to do something similar after the XDoclet processing. At this point, my goal is to round out the subtasks for XML/.properties generation for datatypes. I'm personally not planning on spending much time on making the transformation from XML to something pretty, but I will do whatever I can to get the data out of Ant's .java files into the generated descriptors. I'm looking for others to jump in and extend what I've done. There are folks that are much more adept at twisting, bending, and morphing XML into all sorts of other things - have at it! Erik -- To unsubscribe, e-mail: For additional commands, e-mail: