def mutable = new DefaultMutableVersionConstraint("")
            spec.delegate = mutable
            spec.resolveStrategy = Closure.DELEGATE_FIRST
            spec.call()
            def version = DefaultImmutableVersionConstraint.of(mutable)
            assert model.version == version
        }
    }

    @CompileStatic
    private static class PluginSpec {

     */
    @CheckReturnValue
    public abstract FileHierarchySet plus(File path);

    /**
     * Returns a set that contains the union of this set and the given absolute path. The set contains the path itself, plus all its descendants.
     */
    @CheckReturnValue

It cannot be used in script plugins or init scripts.

[[sec:subprojects_plugins_dsl]]
==== Applying plugins to all subprojects

Suppose you have a <<multi_project_builds.adoc#multi_project_builds,multi-project build>>, you probably want to apply plugins to some or all of the subprojects in your build but not to the `root` project.

.docs-navigation a:hover {
    color: #35c1e4;
    text-decoration: none;
}

.docs-navigation a code {
    color: #02303A;
    overflow-wrap: break-word;
    padding: 0;
    word-break: break-all;
}

.docs-navigation a.active {
    text-decoration: underline;
    outline: 0;
    border: none;
    outline-style: none;
    -moz-outline-style: none;
}

.docs-navigation a.active:hover {

        m.pom.expectGetBroken()

        when:
        maybeExpectDeprecation(expression)
        fails 'show'

        then:
        failure.assertHasCause("Could not resolve all files for configuration ':compile'.")
        failure.assertHasCause("Could not find any matches for org:test:1.0+ as no versions of org:test are available.")
        failure.assertHasCause("Could not resolve org:test2:2.0.")

            assert decoder.readString() == value.toString()
        }

        where:
        value                            | _
        ""                               | _
        "all ascii"                      | _
        "\u0000\u0101\u3100"             | _
        "${1 + 2}"                       | _
        new StringBuilder("some string") | _
        CharBuffer.wrap("a string")      | _

// Copyright 2006, Google Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above

You also want to ensure that all consumers of the property see the same value when they query the value.

[[lazy_configuration_faqs]]
== Using the Provider API

Guidelines to be successful with the Provider API:

include::{snippetsPath}/ant/useAntTask/tests/useAntTask.out[]
----

TIP: You can mix Groovy/Kotlin code and the Ant task markup. This can be extremely powerful.

You pass nested text to an Ant task as a parameter of the task method call.
In this example, we pass the message for the `echo` task as nested text:

====
include::sample[dir="snippets/ant/taskWithNestedText/kotlin",files="build.gradle.kts"]

                count = socket.write(buffer);
                if (count < 0) {
                    throw new EOFException();
                } else if (count == 0) {
                    // buffer was full, just call Thread.yield
                    Thread.yield();
                }
            }
            return count;
        }

        private void waitForWriteBufferToDrain() throws IOException {