Return-Path: 
 <ant-dev-return-12653-apmail-jakarta-ant-dev-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-ant-dev-archive@jakarta.apache.org
Received: (qmail 52174 invoked by uid 500); 11 Apr 2001 13:24:57 -0000
Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ant-dev@jakarta.apache.org
list-help: <mailto:ant-dev-help@jakarta.apache.org>
list-unsubscribe: <mailto:ant-dev-unsubscribe@jakarta.apache.org>
list-post: <mailto:ant-dev@jakarta.apache.org>
Delivered-To: mailing list ant-dev@jakarta.apache.org
Received: (qmail 52164 invoked from network); 11 Apr 2001 13:24:56 -0000
Message-Id: <3.0.6.32.20010411232805.00e233c0@mail.alphalink.com.au>
X-Sender: gdonald@mail.alphalink.com.au
X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.6 (32)
Date: Wed, 11 Apr 2001 23:28:05 +1000
To: ant-dev@jakarta.apache.org
From: Peter Donald <donaldp@apache.org>
Subject: Re: TASTE QUESTION: optional description attribute for ant
  projects?
In-Reply-To: <m3zodn1wgb.fsf@bodewig.bost.de>
References: <"Conor MacNeill"'s message of "Wed, 11 Apr 2001 21:45:36 +1000">
 <5.0.0.25.0.20010410220057.00a7fe20@mail.earthlink.net>
 <m34rvv51wy.fsf@bodewig.bost.de>
 <00d701c0c27d$de2919f0$d2e3223f@cognetnt>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N

At 01:56  11/4/01 +0200, Stefan Bodewig wrote:
>> I don't think it would need to be the first element in the
>> <project>, however.
>
>Agreed

What about putting it in a comment directly before the relevent element?
(Or maybe this could be just for ant2). This works like the javadoc
semi-illiterate style and should be familiar to most. (Besides it doesn't
require no magic element names but can still contain a chunk of text).

Cheers,

Pete

*-----------------------------------------------------*
| "Faced with the choice between changing one's mind, |
| and proving that there is no need to do so - almost |
| everyone gets busy on the proof."                   |
|              - John Kenneth Galbraith               |
*-----------------------------------------------------*