On 10/08/2012, at 11:02 PM, Spencer Allain wrote:
> Probably just because I'm taking another hard look at the documentation
> layout, but there's something about the DSL that jumps right out at me now,
> which is the discontinuity of the default available script blocks. The top
> level DSL documentation has no mention of the ant {} script block, and the
> project level one has no reference to sourceSets {}.
>
> From the top, main DSL documentation there are:
> allprojects { }
> Configures this project and each of its sub-projects.
> artifacts { }
> Configures the published artifacts for this project.
> buildscript { }
> Configures the build script classpath for this project.
> configurations { }
> Configures the dependency configurations for this project.
> dependencies { }
> Configures the dependencies for this project.
> repositories { }
> Configures the repositories for this project.
> sourceSets { }
> Configures the source sets of this project.
> subprojects { }
> Configures the sub-projects of this project.
>
> Going to the Project DSL info there are:
> allprojects
> Configures this project and each of its sub-projects.
> ant
> Executes the given closure against the AntBuilder for this project. You can
> use this in your build file to execute ant tasks. The AntBuild is passed to
> the closure as the closure's delegate. See example in javadoc for
> Project.getAnt()
> artifacts
> Configures the published artifacts for this project.
> buildscript
> Configures the build script classpath for this project.
> configurations
> Configures the dependency configurations for this project.
> dependencies
> Configures the dependencies for this project.
> repositories
> Configures the repositories for this project.
> subprojects
> Configures the sub-projects of this project.
>
SourceSets is mentioned further down, in the 'script blocks added by the java
plugin' section. The 'sourceSets' property isn't a core property. I imagine we
could do something to tweak the layout of the DSL guide to make this a bit
clearer.
> -Spencer
>
> From: Szczepan Faber <[email protected]>
> To: [email protected]
> Sent: Friday, August 10, 2012 5:05 AM
> Subject: Re: [gradle-dev] New docs style.
>
> It looks awesome, thanks! The black-background code snippets have white
> background for printing - very nice :D
>
> Cheers!
>
> On Wed, Aug 1, 2012 at 9:15 PM, Luke Daley <[email protected]> wrote:
> I've unified the look and feel of the release notes, dsl ref and user guide.
>
> http://builds.gradle.org/repository/download/bt45/.lastSuccessful/docs/userguide/userguide.html
> http://builds.gradle.org/repository/download/bt45/.lastSuccessful/docs/dsl/index.html
> http://builds.gradle.org/repository/download/bt45/.lastSuccessful/docs/release-notes.html
>
> Send through any feedback, or feel free to change the stylesheets.
>
> --
> Luke Daley
> Principal Engineer, Gradleware
> http://gradleware.com
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this list, please visit:
>
> http://xircles.codehaus.org/manage_email
>
>
>
>
>
> --
> Szczepan Faber
> Principal engineer@gradleware
> Lead@mockito
>
>
--
Adam Murdoch
Gradle Co-founder
http://www.gradle.org
VP of Engineering, Gradleware Inc. - Gradle Training, Support, Consulting
http://www.gradleware.com
