Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ant-user@jakarta.apache.org
Message-ID: <3956B7121A30D411850800508B9A5EE0303A6E@NOVARRAINET1>
From: Mark Ashton <mashton@Novarra.com>
To: "'ant-user@jakarta.apache.org'" <ant-user@jakarta.apache.org>
Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))
Date: Tue, 5 Jun 2001 10:04:11 -0500 
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"

I like the ant documentation myself overall, but one thing I have found that
would be extremely useful is some information on how parameters for a task
map to different command-line options for that task (if applicable).

In other words, it would have saved me some time to know that debug="off" on
the javac task is equivalent to "javac" and not "javac -g:none" :-)

Of course, you can always just run with -verbose to find out that kind of
info, but it still would be nice to have the behavior documented.

-----Original Message-----
From: Brett Knights [mailto:brett@knightsofthenet.com]
Sent: Monday, June 04, 2001 5:39 PM
To: ant-user@jakarta.apache.org
Subject: RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))


I'd have to agree with Diane. The case in question it seemed the person
didn't really know how to run javadoc in the first place.
The ant documentation is a bit rough in that the index could use more
entries but everything is there somewhere.

Incidentally the source seems very well documented and makes a handy low
level reference as well.


> -----Original Message-----
> From: Diane Holt [mailto:holtdl@yahoo.com]
> Sent: Monday, June 04, 2001 3:28 PM
> To: ant-user@jakarta.apache.org
> Subject: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))
>
>
> --- Suu Quan <squan@wwc.com> wrote:
> > Same here (not javadoc, but other tasks). It says a lot about the
> > quality of the documentation.
> > If I'm still not clear: I give a Failing grade for documentation.
>
> I completely disagree -- but maybe I'm too familiar with it
> at this point
> to be objective about it. Where, specifically, do you think it fails?
> (Keeping in mind that it's not intended to teach people Java, XML, or
> anything other than how to use Ant.)
>
> Diane
>
> =====
> (holtdl@yahoo.com)
>
>
>
> __________________________________________________
> Do You Yahoo!?
> Get personalized email addresses from Yahoo! Mail - only $35
> a year!  http://personal.mail.yahoo.com/
>