On Fri, 2011-02-25 at 08:44 -0800, Peter Niederwieser wrote: > Have a look at the DSL guide for the Test task: > > http://gradle.org/0.9/docs/dsl/org.gradle.api.tasks.testing.Test.html#org.gradle.api.tasks.testing.Test:bootstrapClasspath(java.lang.Object...)
Well that tells me something exists, but it is not a user document, it
doesn't have lots of useful examples of real use that people can work
from by analogy -- this is the purpose of the user guide, it is supposed
to guide you in how to use it (and for a lot of stuff it does, it just
doesn't have intermediate and advanced usage stuff).
So how do I specify a test execution bootclasspath in a build file?
Clearly not:
test.bootclasspath = [ ' /path/to/some/jar/file.jar' ]
that tells me stuff about FileCollections which means I have to go back
to guide to find out how to specify those.
> I wonder why you found it difficult to find this. Do we need to send a
> clearer message that the user guide won't answer all detail questions, and
> that the DSL guide and JavaDoc (and source code!) are also valuable
> resources?
I have to admit, because I didn't look. JavaDoc generated documents
and/or API specification documents rarely have useful user
documentation, i.e. rarely has lots of examples of real world use. The
Java documentation is a surprising exception to this rule in that most
of the important and used classes have a good spiel with example usages
at the top of the JavaDoc page.
Cross-references from guide to API spec is great, but what is needed is
lots of example of real world, and most importantly, known to work,
examples.
Sorry to sound grumpy, not your fault, nor Gradles, but you really don't
need a catalogue of my problems ;-)
--
Russel.
=============================================================================
Dr Russel Winder t: +44 20 7585 2200 voip: sip:[email protected]
41 Buckmaster Road m: +44 7770 465 077 xmpp: [email protected]
London SW11 1EN, UK w: www.russel.org.uk skype: russel_winder
signature.asc
Description: This is a digitally signed message part
