"This is scheduled to be removed in Gradle 9.0. " +
                "Consult the upgrading guide for further information: " +
                "https://docs.gradle.org/current/userguide/upgrading_version_7.html#org_gradle_util_reports_deprecations"
            if (GradleContextualExecuter.isConfigCache()) {
                executer.expectDocumentedDeprecationWarning(wrapUtilWarning)
            } else {

        inDirectory(subDirectory).usingSettingsFile(subSettingsFile).withTasks("help").run();
    }

    @Test
    public void specifyingCustomBuildFileIsDeprecated() {

        executer.expectDocumentedDeprecationWarning("Specifying custom build file location has been deprecated. This is scheduled to be removed in Gradle 9.0. Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_7.html#configuring_custom_build_layout");

        when:

                "Simply remove the call. " +
                "Consult the upgrading guide for further information: " +
                "https://docs.gradle.org/current/userguide/upgrading_version_7.html#for_use_at_configuration_time_deprecation"
        )
    }

        runBuildWithScanRequest("-b", "other-build.gradle")

        then:
        pluginAppliedOnce()
    }

                "Consult the upgrading guide for further information: " +
                "https://docs.gradle.org/current/userguide/upgrading_version_7.html#org_gradle_util_reports_deprecations"
        )
        executer.expectDocumentedDeprecationWarning(
            "The org.gradle.api.plugins.Convention type has been deprecated. " +
                "This is scheduled to be removed in Gradle 9.0. " +

     *
     * @since 6.5
     * @deprecated Since version 7.4 this method does nothing. All providers can be used at configuration time without explicit opt-in.
     * @see <a href="https://docs.gradle.org/current/userguide/upgrading_version_7.html#for_use_at_configuration_time_deprecation">the upgrade guide</a>
     */
    @Deprecated
    Provider<T> forUseAtConfigurationTime();

    /**

            "Consult the upgrading guide for further information: ${documentationRegistry.getDocumentationFor("upgrading_version_7", "configuring_custom_build_layout")}")
        initFailsWith targetScriptDsl as BuildInitDsl

        then:
        result.assertTasksExecuted(":init")

            " Add the individual files to the file collection instead." +
            " Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_7.html#file_collection_to_classpath")
    }

    private def stylesheetFileRelativePath(String name) {
        if (JavaVersion.current().isCompatibleWith(JavaVersion.VERSION_22)) {

            " Add the individual files to the file collection instead." +
            " Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_7.html#file_collection_to_classpath")
    }

    @ToBeImplemented
    @Issue('https://github.com/gradle/gradle/issues/29147')