IJPL-212619 platform API: mark deprecated unused API for removal

API, which was marked as deprecated in 252 or earlier and has no external and internal usages, is marked for removal.

GitOrigin-RevId: ffc76e73eb10551bc9c19b6d2567be4fe898de10

platform/analysis-api/src/com/intellij/openapi/vfs/newvfs/FileAttribute.java

@@ -51,7 +51,7 @@ public class FileAttribute {
   }
 
   /** @deprecated use {@link FileAttribute#FileAttribute(String, int, boolean)} -- shouldEnumerate is ignored (was never implemented) */
-  @Deprecated
+  @Deprecated(forRemoval = true)
   public FileAttribute(@NonNls @NotNull String id,
                        int version,
                        boolean fixedSize,

platform/code-style-api/src/com/intellij/psi/codeStyle/modifier/TransientCodeStyleSettings.java

@@ -36,7 +36,7 @@ public final class TransientCodeStyleSettings extends CodeStyleSettings {
   /**
    * @deprecated Use {@link #TransientCodeStyleSettings(VirtualFile,Project,CodeStyleSettings)}
    */
-  @Deprecated
+  @Deprecated(forRemoval = true)
   public TransientCodeStyleSettings(@NotNull PsiFile psiFile, @NotNull CodeStyleSettings settings) {
     super(true, false);
     myFileRef = new WeakReference<>(psiFile.getVirtualFile());

platform/core-api/src/com/intellij/codeInsight/documentation/DocumentationManagerUtil.java

@@ -2,6 +2,7 @@
 package com.intellij.codeInsight.documentation;
 
 import com.intellij.psi.PsiElement;
+import org.jetbrains.annotations.ApiStatus;
 
 public final class DocumentationManagerUtil {
 
@@ -45,6 +46,7 @@ public final class DocumentationManagerUtil {
   /**
    * @deprecated use {@link #createHyperlink(StringBuilder, String, String, boolean)}
    */
+  @ApiStatus.ScheduledForRemoval
   @Deprecated
   public static void createHyperlink(
     StringBuilder buffer,

platform/core-api/src/com/intellij/psi/tree/StubFileElementType.java

@@ -21,6 +21,7 @@ import org.jetbrains.annotations.Nullable;
 public abstract class StubFileElementType<T extends PsiFileStub> extends IFileElementType implements StubSerializer<T> {
 
   /** @deprecated this constant is unused */
+  @ApiStatus.ScheduledForRemoval
   @Deprecated
   public static final String DEFAULT_EXTERNAL_ID = "psi.file";
 

platform/external-process-auth-helper/src/externalProcessAuthHelper/ExternalProcessHandlerService.kt

@@ -59,6 +59,7 @@ abstract class ExternalProcessHandlerService<T : ExternalAppHandler> @ApiStatus.
   private val coroutineScope: CoroutineScope?
 ) {
 
+  @ApiStatus.ScheduledForRemoval
   @Deprecated("Use constructor with scriptBody")
   constructor(scriptNamePrefix: String, scriptMainClass: Class<out ExternalApp>) :
     this(scriptNamePrefix, scriptMainClass, null, emptyList(), null)

platform/ide-core-impl/src/com/intellij/openapi/project/ex/PerProjectInstancePaths.kt

@@ -2,13 +2,14 @@
 package com.intellij.openapi.project.ex
 
 import com.intellij.openapi.application.PathManager
+import org.jetbrains.annotations.ApiStatus
 import org.jetbrains.annotations.VisibleForTesting
 import java.nio.file.Path
 import java.nio.file.Paths
 import kotlin.io.path.div
 import kotlin.io.path.name
 
-
+@ApiStatus.ScheduledForRemoval
 @Deprecated("Use P3PathsEx")
 class PerProjectInstancePaths(private val projectStoreBaseDir: Path) {
 

platform/platform-api/src/com/intellij/openapi/observable/util/RevertOnDisposeUtil.kt

@@ -8,6 +8,7 @@ import com.intellij.openapi.ui.ComponentWithBrowseButton
 import com.intellij.ui.EditorTextComponent
 import com.intellij.ui.hover.HoverListener
 import com.intellij.util.ui.TableViewModel
+import org.jetbrains.annotations.ApiStatus
 import java.awt.Component
 import java.awt.Container
 import java.awt.ItemSelectable
@@ -30,6 +31,7 @@ import javax.swing.text.Document
 import javax.swing.text.JTextComponent
 import javax.swing.tree.TreeModel
 
+@ApiStatus.ScheduledForRemoval
 @Deprecated("Use setObservableProperty instead", ReplaceWith("setObservableProperty(this, value, parentDisposable)"))
 fun <T> ObservableMutableProperty<T>.set(value: T, parentDisposable: Disposable? = null) {
   val oldValue = get()

platform/platform-api/src/com/intellij/openapi/progress/tasks.kt

@@ -34,6 +34,7 @@ suspend fun <T> withBackgroundProgress(
   return withBackgroundProgress(project, title, action)
 }
 
+@ApiStatus.ScheduledForRemoval
 @Deprecated(
   "Moved to com.intellij.platform.ide.progress",
   ReplaceWith(
@@ -51,6 +52,7 @@ suspend fun <T> withBackgroundProgress(
   return withBackgroundProgress(project, title, cancellable, action)
 }
 
+@ApiStatus.ScheduledForRemoval
 @Deprecated(
   "Moved to com.intellij.platform.ide.progress",
   ReplaceWith(
@@ -68,6 +70,7 @@ suspend fun <T> withBackgroundProgress(
   return withBackgroundProgress(project, title, cancellation, action)
 }
 
+@ApiStatus.ScheduledForRemoval
 @Deprecated(
   "Moved to com.intellij.platform.ide.progress",
   ReplaceWith(
@@ -86,6 +89,7 @@ fun <T> runWithModalProgressBlocking(
   return runWithModalProgressBlocking(project, title, action)
 }
 
+@ApiStatus.ScheduledForRemoval
 @Deprecated(
   "Moved to com.intellij.platform.ide.progress",
   ReplaceWith(

platform/platform-impl/src/com/intellij/execution/impl/EditorHyperlinkSupport.java

@@ -510,7 +510,7 @@ public final class EditorHyperlinkSupport {
   /**
    * @deprecated use {@link EditorHyperlinkSupport#getNextOccurrence(int, Consumer)} instead
    */
-  @Deprecated
+  @Deprecated(forRemoval = true)
   public static @Nullable OccurenceNavigator.OccurenceInfo getNextOccurrence(@NotNull Editor editor,
                                                                              int delta,
                                                                              @NotNull com.intellij.util.Consumer<? super RangeHighlighter> action) {

platform/projectModel-impl/src/com/intellij/openapi/options/SchemeManager.kt

@@ -31,6 +31,7 @@ abstract class SchemeManager<T> {
 
   abstract fun reload()
 
+  @ApiStatus.ScheduledForRemoval
   @Deprecated(message = "Use reload()", replaceWith = ReplaceWith("reload()"))
   open fun reload(retainFilter: ((scheme: T) -> Boolean)?) {
     reload()

platform/structuralsearch/source/com/intellij/structuralsearch/plugin/ui/StructuralSearchDialogKeys.java

@@ -12,6 +12,6 @@ public final class StructuralSearchDialogKeys {
   /**
    * @deprecated AI code generation for the structural search is not supported anymore.
    */
-  @Deprecated
+  @Deprecated(forRemoval = true)
   public static final Key<Boolean> AI_SUPPORT_KEY = Key.create("ssr.ai.support");
 }

platform/testFramework/src/com/intellij/util/io/DirectoryContentSpec.kt

@@ -14,6 +14,7 @@ import com.intellij.util.io.impl.JarSpec
 import com.intellij.util.io.impl.ZipSpec
 import com.intellij.util.io.impl.assertContentUnderFileMatches
 import com.intellij.util.io.impl.fillSpecFromDirectory
+import org.jetbrains.annotations.ApiStatus
 import org.junit.rules.ErrorCollector
 import java.io.File
 import java.nio.file.Path
@@ -105,6 +106,7 @@ interface DirectoryContentSpec {
   /**
    * Generates files, directories and archives accordingly to this specification in [target] directory
    */
+  @ApiStatus.ScheduledForRemoval
   @Deprecated("Use generate(Path) instead")
   fun generate(target: File): Unit = generate(target.toPath())
 

platform/util/multiplatform/src/com/intellij/util/lang/JavaVersion.kt

@@ -2,6 +2,7 @@
 package com.intellij.util.lang
 
 import com.intellij.util.currentJavaVersionPlatformSpecific
+import org.jetbrains.annotations.ApiStatus
 import kotlin.jvm.JvmField
 import kotlin.jvm.JvmOverloads
 import kotlin.jvm.JvmStatic
@@ -143,6 +144,7 @@ class JavaVersion private constructor(
       ReplaceWith("com.intellij.util.lang.CurrentJavaVersion.currentJavaVersion()"),
       level = DeprecationLevel.ERROR
     )
+    @ApiStatus.ScheduledForRemoval
     @JvmStatic
     fun current(): JavaVersion = currentJavaVersionPlatformSpecific()
 

platform/util/src/com/intellij/util/containers/ContainerUtil.java

@@ -526,6 +526,7 @@ public final class ContainerUtil {
    * unlike the {@link Collections#unmodifiableList(List)} (Subject to change in subsequent JDKs).
    */
   @Contract(pure = true)
+  @ApiStatus.ScheduledForRemoval
   @Deprecated
   public static @Unmodifiable @NotNull <E> ImmutableList<E> immutableList(@NotNull List<? extends E> list) {
     //noinspection unchecked

platform/workspace/jps/src/com/intellij/platform/workspace/jps/entities/facet.kt

@@ -6,6 +6,7 @@ import com.intellij.platform.workspace.storage.EntityType
 import com.intellij.platform.workspace.storage.MutableEntityStorage
 import com.intellij.platform.workspace.storage.WorkspaceEntity
 import com.intellij.platform.workspace.storage.annotations.Parent
+import org.jetbrains.annotations.ApiStatus
 import org.jetbrains.annotations.NonNls
 
 data class FacetEntityTypeId(val name: @NonNls String)
@@ -61,6 +62,7 @@ interface FacetEntity : ModuleSettingsFacetBridgeEntity {
     ): Builder = FacetEntityType.compatibilityInvoke(moduleId, name, typeId, entitySource, init)
 
     //region compatibility generated code
+    @ApiStatus.ScheduledForRemoval
     @Deprecated(
       message = "This method is deprecated and will be removed in next major release",
       replaceWith = ReplaceWith("invoke(moduleId, name, typeId, entitySource, init)"),

platform/workspace/storage/src/com/intellij/platform/workspace/storage/annotations/Child.kt

@@ -1,6 +1,8 @@
 // Copyright 2000-2023 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
 package com.intellij.platform.workspace.storage.annotations
 
+import org.jetbrains.annotations.ApiStatus
+
 /**
  * Marks a property in an interface extending [WorkspaceEntity][com.intellij.platform.workspace.storage.WorkspaceEntity] as referring to
  * a child entity. 
@@ -18,6 +20,7 @@ package com.intellij.platform.workspace.storage.annotations
  * always added and removed together. So it's simpler to just put all properties from the child entity to the parent entity instead. If you
  * want to group several related properties, you may extract them to a separate data class instead of defining such a child entity.
  */
+@ApiStatus.ScheduledForRemoval
 @Deprecated("Use @Parent annotation in the child entity instead")
 @Target(AnnotationTarget.PROPERTY, AnnotationTarget.TYPE)
 public annotation class Child