We now have an @Experimental annotation to attach to things that are public, but not quite ready to lock down for the long term. We should probably start attaching this to pretty much every new thing we add, and have some policy for when it gets removed (the policy would be gut feel at the moment).
We should probably also retrospectively attach this to the stuff that is currently experimental (c++ and javascript stuff, for example). The fact that something is @Experimental ends up in the DSL reference, as does the fact that something is @Deprecated. Only works for annotations at the moment, not @deprecated javadoc tags. The presentation is not fantastic, but is functional to some degree (just like the rest of the DSL reference). We can tweak this over time. On 25/06/2012, at 3:55 PM, GitHub wrote: > Branch: refs/heads/master > Home: https://github.com/gradle/gradle > Commit: bcc744c8e4378d90987be575a7505101fc84111e > > https://github.com/gradle/gradle/commit/bcc744c8e4378d90987be575a7505101fc84111e > Author: Adam Murdoch <[email protected]> > Date: 2012-06-24 (Sun, 24 Jun 2012) > > Changed paths: > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/BlockDoc.groovy > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/ClassDoc.groovy > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/ClassDocRenderer.groovy > A > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/DslElementDoc.java > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/MethodDoc.groovy > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/docbook/PropertyDoc.groovy > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/model/AbstractLanguageElement.java > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/model/LanguageElement.java > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/model/MethodMetaData.java > M > buildSrc/src/main/groovy/org/gradle/build/docs/dsl/model/PropertyMetaData.java > M > buildSrc/src/test/groovy/org/gradle/build/docs/dsl/model/ClassMetaDataTest.groovy > M > buildSrc/src/test/groovy/org/gradle/build/docs/dsl/model/MethodMetaDataTest.groovy > M > buildSrc/src/test/groovy/org/gradle/build/docs/dsl/model/PropertyMetaDataTest.groovy > A subprojects/base-services/src/main/java/org/gradle/api/Experimental.java > M subprojects/docs/src/docs/dsl/dsl.xml > > Log Message: > ----------- > - Added @Experimental, and added support for it in the DSL reference. > - Some tweaks to how we show deprecated DSL elements. > - Added some words to the DSL reference about what 'deprecated' and > 'experimental' mean. > > > Commit: 130fe6590f96ff512eaaa0882593bffbb2f58634 > > https://github.com/gradle/gradle/commit/130fe6590f96ff512eaaa0882593bffbb2f58634 > Author: Adam Murdoch <[email protected]> > Date: 2012-06-24 (Sun, 24 Jun 2012) > > Changed paths: > M subprojects/core/src/main/groovy/org/gradle/api/Project.java > > Log Message: > ----------- > Javadoc tweaks. > > > Commit: 7d2d3c3d621eaeae1dccb4220cc18dc53b8c3925 > > https://github.com/gradle/gradle/commit/7d2d3c3d621eaeae1dccb4220cc18dc53b8c3925 > Author: Adam Murdoch <[email protected]> > Date: 2012-06-24 (Sun, 24 Jun 2012) > > Changed paths: > M > subprojects/core-impl/src/test/groovy/org/gradle/api/internal/artifacts/ivyservice/resolveengine/DependencyGraphBuilderTest.groovy > > Log Message: > ----------- > Removed unused field. > > > Commit: 2980512de7130a4bcc4b252aabf18a9abc1228dc > > https://github.com/gradle/gradle/commit/2980512de7130a4bcc4b252aabf18a9abc1228dc > Author: Adam Murdoch <[email protected]> > Date: 2012-06-24 (Sun, 24 Jun 2012) > > Changed paths: > M subprojects/base-services/src/main/java/org/gradle/api/Nullable.java > > Log Message: > ----------- > Added a target type constraint. > > > Compare: https://github.com/gradle/gradle/compare/ff47dcfd8e80...2980512de713 > > > <hr/> > <p> > To unsubscribe from this list please visit: > </p> > <p> > <a > href="http://xircles.codehaus.org/manage_email";>http://xircles.codehaus.org/manage_email</a> > </p> -- Adam Murdoch Gradle Co-founder http://www.gradle.org VP of Engineering, Gradleware Inc. - Gradle Training, Support, Consulting http://www.gradleware.com
