add ApiStatus.Obsolete annotation

common/src/main/java/org/jetbrains/annotations/ApiStatus.java

@@ -72,6 +72,25 @@ private ApiStatus() {
   })
   public @interface Internal {}
 
+  /**
+   * <p>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.
+   * </p>
+   */
+  @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 "";
+  }
+
   /**
    * <p>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.</p>

gradle.properties

@@ -14,5 +14,5 @@
 # limitations under the License.
 #
 
-projectVersion=23.0.1
+projectVersion=23.1.0
 #JDK_5=<path-to-older-java-version>