ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jose Alberto Fernandez" <jalbe...@cellectivity.com>
Subject RE: Possible Enhancements to <description> datatype
Date Thu, 29 Apr 2004 10:33:09 GMT
I think we are streaching the meaning of <description>
way beyond what is what defined for.

<description> is used by -projecthelp to generate online help
on a terminal console. It was not conceived as a javados style facility.

If we want to provide something like <xdoc> or <antdoc> to ducument
ANT buildfiles, Then I think we should go for a diferent kind of
element using the new facilityes that can allow retrieving XML
fragments.

Jose Alberto

> -----Original Message-----
> From: Claas Thiele [mailto:cthiele@ct42.de] 
> Sent: 29 April 2004 09:01
> To: Ant Developers List
> Subject: Possible Enhancements to <description> datatype
> 
> 
> Short:
> a) description element should allow every attribute and every 
> markup inside.
> b) description element should be usable inside macrodef, 
> presetdef and 
> any container task like sequential.
> 
> a) und b) will not be processed by ant (simply ignored). text 
> nodes will 
> be processed only.
> 
> What can be done with that things:
> With this enhancements it is possible to add markup to description 
> elements related to a target documentation system or a 
> special ant doc 
> markup like javadoc has.
> This seems to be necessary since macrodef makes reusable ant files 
> possible. Descriptions have to be more than a remark now.
> The enhancements above make it possible to build a Automated 
> Documentation System for Ant like JavaDoc for Java.
> 
> What do you think?
> 
> 
> Claas
> -- 
> ____________________________________________________________________
> Dipl.-Inf. Claas Thiele              EMail: cthiele<at>ct42.de
> Konradstr. 58                        Web:   http://ct42.de
> 04315 Leipzig                        Tel.: +49 (0)341 68 70 92 29
> GERMANY                              Fax   +49 (0)341 68 70 92 30
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org
> 
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message