* The stylesheet directory used by the DSL reference documentation.
     */
    public abstract DirectoryProperty getStylesheetDirectory();

    /**
     * The stylesheet used by the DSL reference to highlight code snippets.
     */
    public abstract RegularFileProperty getHighlightStylesheet();

    /**
     * Resources to include with the generated documentation.
     */
    public abstract ConfigurableFileCollection getResources();

            });

            // From the snippets and the samples, filter out files generated if the build contained was ever executed
            task.from(extension.getUserManual().getSnippets(), sub -> {
                sub.into("snippets");
                sub.exclude("**/.gradle/**");
                sub.exclude("**/build/**");

public abstract class UserManual {
    /**
     * The root of the user manual documentation.  This is the source of the adoc files.
     */
    public abstract DirectoryProperty getRoot();

    /**
     * Source of snippets that can be inserted into the user manual
     */
    public abstract DirectoryProperty getSnippets();

    /**
     * Source of samples that can be inserted into the user manual
     *
     */

   * Specifically, validation against <a href="http://www.ietf.org/rfc/rfc3490.txt">RFC 3490</a>
   * ("Internationalizing Domain Names in Applications") is skipped.
   *
   * <p>The following two code snippets are equivalent:
   *
   * <pre>{@code
   * domainName = InternetDomainName.isValid(name)
   *     ? InternetDomainName.from(name)
   *     : DEFAULT_DOMAIN;
   * }</pre>
   *
   * <pre>{@code

/**
 * {@code war} packaging plugins bindings provider for {@code default} lifecycle.
 */
@Named("war")
@Singleton
public final class WarLifecycleMappingProvider extends AbstractLifecycleMappingProvider {
    // START SNIPPET: war
    @SuppressWarnings("checkstyle:linelength")
    private static final String[] BINDINGS = {
        "process-resources",

    // START SNIPPET: wrapper
    private static final String[] PHASES = {"wrapper"};

    private static final String MAVEN_WRAPPER_PLUGIN_VERSION = "3.2.0";

    private static final String[] BINDINGS = {
        "wrapper", "org.apache.maven.plugins:maven-wrapper-plugin:" + MAVEN_WRAPPER_PLUGIN_VERSION + ":wrapper"
    };
    // END SNIPPET: wrapper

    @Inject

    // START SNIPPET: clean
    private static final String[] PHASES = {"pre-clean", "clean", "post-clean"};

    private static final String MAVEN_CLEAN_PLUGIN_VERSION = "3.2.0";

    private static final String[] BINDINGS = {
        "clean", "org.apache.maven.plugins:maven-clean-plugin:" + MAVEN_CLEAN_PLUGIN_VERSION + ":clean"
    };
    // END SNIPPET: clean

    @Inject

 */
@Named(DefaultLifecycleProvider.LIFECYCLE_ID)
@Singleton
public final class DefaultLifecycleProvider extends AbstractLifecycleProvider {
    static final String LIFECYCLE_ID = "default";

    // START SNIPPET: default
    private static final String[] PHASES = {
        "validate",
        "initialize",
        "generate-sources",
        "process-sources",
        "generate-resources",
        "process-resources",

/**
 * {@code jar} packaging plugins bindings provider for {@code default} lifecycle.
 */
@Named("jar")
@Singleton
public final class JarLifecycleMappingProvider extends AbstractLifecycleMappingProvider {
    // START SNIPPET: jar
    @SuppressWarnings("checkstyle:linelength")
    private static final String[] BINDINGS = {
        "process-resources",

 * they return from {@code get} behave like (and, of course, implement) {@link List} and {@link
 * Set}, respectively.
 *
 * <p>For example, the "presidents" code snippet above used a {@code ListMultimap}; if it had used a
 * {@code SetMultimap} instead, two presidents would have vanished, and last names might or might
 * not appear in chronological order.
 *