when:
        builder.willBeRemovedInGradle9().undocumented().nagUser()

        then:
        expectMessage "Summary is deprecated. This is scheduled to be removed in Gradle ${NEXT_GRADLE_VERSION}. Context. Advice."
    }

    def "logs generic deprecation message for specific thing"() {
        when:
        DeprecationLogger.deprecate("Something").willBeRemovedInGradle9().undocumented().nagUser()

        then:

        DeprecationLogger.deprecateProperty(AbstractCompile.class, "destinationDir")
            .replaceWith("destinationDirectory")
            .willBeRemovedInGradle9()
            .withUpgradeGuideSection(7, "compile_task_wiring")
            .nagUser();

        return destinationDirectory.getAsFile().getOrNull();
    }

    /**

            DeprecationLogger.deprecateMethod(LenientConfiguration.class, "getFirstLevelModuleDependencies(Spec)")
                .withAdvice("Use getFirstLevelModuleDependencies() instead.")
                .willBeRemovedInGradle9()
                .withUpgradeGuideSection(8, "deprecate_filtered_configuration_file_and_filecollection_methods")
                .nagUser();

            return Collections.emptySet();
        }

        DeprecationLogger.deprecateAction("Directly instantiating a ResolveException")
            .withContext("Instantiating this exception is reserved for Gradle internal use only.")
            .willBeRemovedInGradle9()
            .undocumented()
            .nagUser();
    }

    /**
     * Do not call this constructor.
     *
     * @deprecated This constructor will be made protected in 9.0
     */

        DeprecationLogger.deprecateMethod(LenientConfiguration.class, "getFirstLevelModuleDependencies(Spec)")
            .withAdvice("Use getFirstLevelModuleDependencies() instead.")
            .willBeRemovedInGradle9()
            .withUpgradeGuideSection(8, "deprecate_filtered_configuration_file_and_filecollection_methods")
            .nagUser();

        Set<ResolvedDependency> matches = new LinkedHashSet<>();

        DeprecationLogger.deprecateMethod(ResolvedConfiguration.class, "getFiles(Spec)")
            .withAdvice("Use an ArtifactView with a componentFilter instead.")
            .willBeRemovedInGradle9()
            .withUpgradeGuideSection(8, "deprecate_filtered_configuration_file_and_filecollection_methods")
            .nagUser();

        ResolvedFilesCollectingVisitor visitor = new ResolvedFilesCollectingVisitor();

    @Deprecated
    public File getDestinationDir() {
        DeprecationLogger.deprecateProperty(TestReport.class, "destinationDir").replaceWith("destinationDirectory")
                .willBeRemovedInGradle9()
                .withDslReference()
                .nagUser();
        return getDestinationDirectory().get().getAsFile();
    }

    /**
     * Sets the directory to write the HTML report to.
     *

@Target({ElementType.METHOD})
public @interface ReplacedDeprecation {

    /**
     * Set if deprecation nagging is enabled or not
     */
    boolean enabled() default true;

    /**
     * Corresponds to .willBeRemovedInGradle9() in the DeprecationLogger
     */
    RemovedIn removedIn() default RemovedIn.UNSPECIFIED;

    /**
     * Corresponds to .withUpgradeGuideSection(majorVersion, section) in the DeprecationLogger
     */

        );
    }

    private static void logFileDeprecationWarning(DeprecationMessageBuilder<?> specifyingCustomFileLocation) {
        specifyingCustomFileLocation
            .willBeRemovedInGradle9()
            .withUpgradeGuideSection(7, "configuring_custom_build_layout")
            .nagUser();
    }

        // TODO Switch to SimpleBuildCacheKey once this method is removed
        DeprecationLogger.deprecateMethod(BuildCacheKey.class, "getDisplayName()")
            .replaceWith("getHashCode()")
            .willBeRemovedInGradle9()
            .undocumented()
            .nagUser();
        return getHashCode();
    }

    @Override
    public String toString() {
        return getHashCode();
    }

    @Override