when:
        DeprecationLogger.deprecate("Something").withAdvice("Advice.").withContext("Contextual advice.").willBeRemovedInGradle9().undocumented().nagUser()

        then:
        expectMessage "Something has been deprecated. This is scheduled to be removed in Gradle ${NEXT_GRADLE_VERSION}. Contextual advice. Advice."
    }

    def "logs deprecated build invocation message"() {
        when:

        "summary" | "removalDetails" | "advice" | null               | null                                         | "summary removalDetails advice"
        "summary" | "removalDetails" | "advice" | "contextualAdvice" | null                                         | "summary removalDetails contextualAdvice advice"

        return removalDetails;
    }

    /**
     * General, non usage specific, advice on what to do about this notice.
     *
     * Example: Use method Foo.baz() instead.
     */
    @Nullable
    public String getAdvice() {
        return advice;
    }

    /**
     * Advice on what to do about the notice, specific to this usage.
     *

    private final String advice;
    private final String context;
    private final DocLink documentation;
    private final DeprecatedFeatureUsage.Type usageType;
    private final String problemIdDisplayName;
    private final String problemId;

    DeprecationMessage(
        String summary,
        String removalDetails,
        @Nullable String advice,
        @Nullable String context,

        userIndirectCodeDeprecationDetails.removalDetails == 'This is scheduled to be removed in Gradle 9.0.'
        userIndirectCodeDeprecationDetails.advice == "Some advice."
        userIndirectCodeDeprecationDetails.type == 'USER_CODE_INDIRECT'
        userIndirectCodeDeprecationDetails.stackTrace.length() > 0
        userIndirectCodeDeprecationDetails.stackTrace.contains('build.gradle:6')

            this.contextualAdvice = contextualAdvice;
            return this;
        }

        @CheckReturnValue
        public Builder withAdvice(String advice) {
            this.advice = advice;
            return this;
        }

        @Override
        @CheckReturnValue
        public Builder withDocumentation(DocLink documentation) {
            this.documentation = documentation;

    public T withContext(String context) {
        this.context = context;
        return (T) this;
    }

    @SuppressWarnings("unchecked")
    public T withAdvice(String advice) {
        this.advice = advice;
        return (T) this;
    }

    @SuppressWarnings("unchecked")
    public T withProblemIdDisplayName(String problemIdDisplayName) {
        this.problemIdDisplayName = problemIdDisplayName;

 * @since 8.6
 */
@Incubating
public interface Severity {

    // Note: the static fields must be in sync with entries from org.gradle.api.problems.Severity.
    /**
     * Advice-level severity.
     *
     * @since 8.6
     */
    Severity ADVICE = new DefaultSeverity(0, true);

    /**
     * Warning-level severity.
     *
     * @since 8.6
     */
    Severity WARNING = new DefaultSeverity(1, true);

    /**

 */

package org.gradle.api.problems;

import org.gradle.api.Incubating;

/**
 * A problem severity.
 *
 * @since 8.6
 */
@Incubating
public enum Severity {
    ADVICE("Advice"),
    WARNING("Warning"),
    ERROR("Error");
    private final String displayName;

    Severity(String displayName) {
        this.displayName = displayName;
    }

    @Override

    }

    @Override
    public boolean isKnown() {
        return known;
    }

    public static Severity from(int severity) {
        if (severity == Severity.ADVICE.getSeverity()) {
            return Severity.ADVICE;
        } else if (severity == Severity.WARNING.getSeverity()) {
            return Severity.WARNING;
        } else if (severity == Severity.ERROR.getSeverity()) {
            return Severity.ERROR;