Return-Path: Delivered-To: apmail-ant-user-archive@www.apache.org Received: (qmail 80399 invoked from network); 19 May 2006 15:39:16 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 19 May 2006 15:39:16 -0000 Received: (qmail 87173 invoked by uid 500); 19 May 2006 15:39:11 -0000 Delivered-To: apmail-ant-user-archive@ant.apache.org Received: (qmail 87132 invoked by uid 500); 19 May 2006 15:39:10 -0000 Mailing-List: contact user-help@ant.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Help: List-Post: List-Id: "Ant Users List" Reply-To: "Ant Users List" Delivered-To: mailing list user@ant.apache.org Received: (qmail 87121 invoked by uid 99); 19 May 2006 15:39:10 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 May 2006 08:39:10 -0700 X-ASF-Spam-Status: No, hits=0.5 required=10.0 tests=DNS_FROM_RFC_ABUSE X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [207.69.200.28] (HELO pop04.mail.atl.earthlink.net) (207.69.200.28) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 May 2006 08:39:09 -0700 Received: from nc-71-51-254-71.dhcp.sprint-hsd.net ([71.51.254.71] helo=[192.168.168.6]) by pop04.mail.atl.earthlink.net with esmtp (Exim 3.36 #10) id 1Fh73v-00038A-00 for user@ant.apache.org; Fri, 19 May 2006 11:38:48 -0400 Message-ID: <446DE685.8040903@mindspring.com> Date: Fri, 19 May 2006 11:38:45 -0400 From: "Scot P. Floess" Reply-To: floess@mindspring.com User-Agent: Thunderbird 1.5.0.2 (X11/20060420) MIME-Version: 1.0 To: Ant Users List Subject: Commenting/generate documentation from an ant script Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N 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: user-unsubscribe@ant.apache.org For additional commands, e-mail: user-help@ant.apache.org