From d4b23e852ef6ff57b8c5703033274842a66d588b Mon Sep 17 00:00:00 2001 From: Daniil Ovchinnikov Date: Thu, 8 Dec 2022 13:58:33 +0100 Subject: [PATCH] add ApiStatus.Obsolete annotation --- .../org/jetbrains/annotations/ApiStatus.java | 19 +++++++++++++++++++ gradle.properties | 2 +- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/common/src/main/java/org/jetbrains/annotations/ApiStatus.java b/common/src/main/java/org/jetbrains/annotations/ApiStatus.java index 53ded57..2f47e29 100644 --- a/common/src/main/java/org/jetbrains/annotations/ApiStatus.java +++ b/common/src/main/java/org/jetbrains/annotations/ApiStatus.java @@ -72,6 +72,25 @@ private ApiStatus() { }) public @interface Internal {} + /** + *

Indicates that a public API of the annotated element (class, method or field) is subject to deprecation in a future version. + * It's a weaker variant of {@link Deprecated} annotation. + * The annotated API is not supposed to be used in the new code because a better API exists, + * but it's permitted to postpone the migration of the existing code, therefore the usage is not considered a warning. + *

+ */ + @Documented + @Retention(RetentionPolicy.CLASS) + @Target({ + ElementType.TYPE, ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR, ElementType.FIELD, ElementType.PACKAGE + }) + public @interface Obsolete { + /** + * Specifies in which version the API became obsolete. + */ + String since() default ""; + } + /** *

Indicates that a public API of the annotated element (class, method or field) is subject to removal in a future version. * It's a stronger variant of {@link Deprecated} annotation.

diff --git a/gradle.properties b/gradle.properties index 11375aa..830616a 100644 --- a/gradle.properties +++ b/gradle.properties @@ -14,5 +14,5 @@ # limitations under the License. # -projectVersion=23.0.1 +projectVersion=23.1.0 #JDK_5= \ No newline at end of file