Return-Path: Delivered-To: apmail-jakarta-ant-user-archive@jakarta.apache.org Received: (qmail 89463 invoked by uid 500); 5 Jun 2001 16:26:45 -0000 Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: Reply-To: ant-user@jakarta.apache.org Delivered-To: mailing list ant-user@jakarta.apache.org Received: (qmail 89453 invoked from network); 5 Jun 2001 16:26:44 -0000 Message-ID: <98370158FCC47C45A3CDE597649758EA01C023@MN7012EXcuag01.ags.agere.com> From: "Swart, James (Jim) ** CTR **" To: "'ant-user@jakarta.apache.org'" Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!)) Date: Tue, 5 Jun 2001 12:27:21 -0400 MIME-Version: 1.0 X-Mailer: Internet Mail Service (5.5.2653.19) Content-Type: multipart/alternative; boundary="----_=_NextPart_001_01C0EDDC.65869240" X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N This message is in MIME format. Since your mail reader does not understand this format, some or all of this message may not be legible. ------_=_NextPart_001_01C0EDDC.65869240 Content-Type: text/plain; charset="iso-8859-1" ahh.. yes. that would be nice.. I know what you mean.. like, when I want to find out the methods in a public class like -----Original Message----- From: O'Hara, Patrick [mailto:patrick.ohara@workscape.com] Sent: Tuesday, June 05, 2001 9:27 AM To: 'ant-user@jakarta.apache.org' Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!)) I think you missed the point. It would be useful to understand why certain attributes are used in Ant. Knowing what an attribute does is not the same as knowing when to use it. For example if an HTML reference described that the HEAD tag denotes the Heading of an HTML page, that would be accurate. Of course if I wanted to learn HTML I would have to know that 1) an HTML page has a head section and 2) the HEAD tag denotes it before the reference would be helpful. A section of the manual given over to complete working examples of various aspects of the build process would be much appreciated. Perhaps once I know more about how Ant "is supposed to work" I will look into doing this. Pat O'Hara pdohara@techneex.com -----Original Message----- From: Swart, James (Jim) ** CTR ** [ mailto:swartj@agere.com ] Sent: Tuesday, June 05, 2001 9:54 AM To: 'ant-user@jakarta.apache.org' Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!)) yes.. there are TONS of java docs on suns java.sun.com site you can reference.. there are even tutors. -----Original Message----- From: S Page [ mailto:spage@macromedia.com ] Sent: Monday, June 04, 2001 7:31 PM To: 'ant-user@jakarta.apache.org' Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!)) The ant documentation explains the features of ant. But it lacks explanation of the purpose of those features. It has the methods, but not the motivation. Take any feature -- properties, tasks, token filters, path-like structures, etc. -- and there is no explanation of why ant has this feature and what it's good for. So I'm staggering around in the dark trying to figure out what Ant features will get me where I want to go (and I consider myself pretty expert at old-skool Makefiles). I can't fix this myself yet, but the recipe is to add to every feature's section in the manual a paragraph similar to: "You use this feature to .... Or you might want to accomplish .... , and this feature can help by ....." Supportively yours, -- =S Page a www.macromedia.com site engineer "There is much software that is essential to a business, but which does not differentiate that business from its competitors" http://www.perens.com/Articles/StandTogether.html ------_=_NextPart_001_01C0EDDC.65869240 Content-Type: text/html; charset="iso-8859-1" RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))
ahh.. yes. that would be nice.. I know what you mean.. like, when I want to find out the methods in a public class like
-----Original Message-----
From: O'Hara, Patrick [mailto:patrick.ohara@workscape.com]
Sent: Tuesday, June 05, 2001 9:27 AM
To: 'ant-user@jakarta.apache.org'
Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))

I think you missed the point.  It would be useful to understand why certain attributes are used in Ant.  Knowing what an attribute does is not the same as knowing when to use it.  For example if an HTML reference described that the HEAD tag denotes the Heading of an HTML page, that would be accurate.  Of course if I wanted to learn HTML I would have to know that 1) an HTML page has a head section and 2) the HEAD tag denotes it before the reference would be helpful.

A section of the manual given over to complete working examples of various aspects of the build process would be much appreciated.  Perhaps once I know more about how Ant "is supposed to work"  I will look into doing this.

Pat O'Hara
pdohara@techneex.com


-----Original Message-----
From: Swart, James (Jim) ** CTR ** [mailto:swartj@agere.com]
Sent: Tuesday, June 05, 2001 9:54 AM
To: 'ant-user@jakarta.apache.org'
Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))


yes.. there are TONS of java docs on suns java.sun.com site you can
reference.. there are even tutors.

-----Original Message-----
From: S Page [mailto:spage@macromedia.com]
Sent: Monday, June 04, 2001 7:31 PM
To: 'ant-user@jakarta.apache.org'
Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))


The ant documentation explains the features of ant.  But it lacks
explanation of the purpose of those features.  It has the methods, but not
the motivation.

Take any feature -- properties, tasks, token filters, path-like structures,
etc. -- and there is no explanation of why ant has this feature and what
it's good for.  So I'm staggering around in the dark trying to figure out
what Ant features will get me where I want to go (and I consider myself
pretty expert at old-skool Makefiles).

I can't fix this myself yet, but the recipe is to add to every feature's
section in the manual a paragraph similar to:

"You use this feature to .... 
Or you might want to accomplish .... ,
and this feature can help by ....."

Supportively yours,
--
=S Page  a www.macromedia.com site engineer

"There is much software that is essential to a business, but which does not
differentiate that business from its competitors"
http://www.perens.com/Articles/StandTogether.html

------_=_NextPart_001_01C0EDDC.65869240--