I will look into both of of these tools. Thank you so much for the response :)

Varadarajan, Srivathsan wrote:
This may just address some of your questions but FWIW, I happen to know
specific tools that you are looking for. Never used them before myself
though.

For a tool to generate Javadocs for your Ant scripts - AntDoc
(http://antdoc.free.fr/)

For unit testing in Ant, check out AntUnit
(http://ant.apache.org/antlibs/antunit/index.html)

HTH

-- Srivathsan

-----Original Message-----
From: Scot P. Floess [mailto:[EMAIL PROTECTED]
Sent: Friday, May 19, 2006 11:39 AM
To: Ant Users List
Subject: Commenting/generate documentation from an ant script

I have what may be either a stupid questions or a silly ones...but I
can't find an answer (perhaps my google search is using the wrong key
words)...

As part of one of my open source projects I am working on some (I
hope)
reusable Ant scripts.  I have some macro definitions, etc.  I was
wondering if there is any standard out there on how one should
document
macros?  Sorta like javadoc notation or some "preferred" way of
internal
documentation.

Another question, is there a tool to generate java-doc like HTML
against
Ant scripts?  Or does one need to handcraft their own web pages?

Final question (wow it just keeps going):  what about unit test cases
for one's Ant scripts.  For instance, supposing one writes macros -
what
do people do for unit test cases?  Presently, I have a script file
that
imports the macro scripts file and calls out to the macros...then I
evaluate properties, etc for accuracy.  However, I was wondering if
there is some "preferred" mechanism as well...

Thanks again :)

Scot

--
Scot P. Floess
27 Lake Royale
Louisburg, NC  27549

252-478-8087 (Home)
919-754-4592 (Work)

Chief Architect JPlate  http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



**************************************************************
This message, including any attachments, contains confidential information 
intended for a specific individual and purpose, and is protected by law.  If 
you are not the intended recipient, please contact sender immediately by reply 
e-mail and destroy all copies.  You are hereby notified that any disclosure, 
copying, or distribution of this message, or the taking of any action based on 
it, is strictly prohibited.
TIAA-CREF
**************************************************************


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



--
Scot P. Floess
27 Lake Royale
Louisburg, NC  27549

252-478-8087 (Home)
919-754-4592 (Work)

Chief Architect JPlate  http://sourceforge.net/projects/jplate
Chief Architect JavaPIM http://sourceforge.net/projects/javapim

Reply via email to