diff --git a/java/compiler/openapi/src/com/intellij/openapi/compiler/CompilerManager.java b/java/compiler/openapi/src/com/intellij/openapi/compiler/CompilerManager.java index 0364b3f74a52..405004d2c649 100644 --- a/java/compiler/openapi/src/com/intellij/openapi/compiler/CompilerManager.java +++ b/java/compiler/openapi/src/com/intellij/openapi/compiler/CompilerManager.java @@ -252,19 +252,19 @@ public abstract class CompilerManager { @Nullable Runnable onTaskFinished); /** - * @deprecated Use CompilerTopics.COMPILATION_STATUS + * @deprecated Use {@link CompilerTopics#COMPILATION_STATUS} instead */ @Deprecated public abstract void addCompilationStatusListener(@NotNull CompilationStatusListener listener); /** - * @deprecated Use CompilerTopics.COMPILATION_STATUS + * @deprecated Use {@link CompilerTopics#COMPILATION_STATUS} instead */ @Deprecated public abstract void addCompilationStatusListener(@NotNull CompilationStatusListener listener, @NotNull Disposable parentDisposable); /** - * @deprecated Use CompilerTopics.COMPILATION_STATUS + * @deprecated Use {@link CompilerTopics#COMPILATION_STATUS} instead */ @Deprecated public abstract void removeCompilationStatusListener(@NotNull CompilationStatusListener listener); diff --git a/platform/analysis-api/src/com/intellij/codeInsight/daemon/DaemonCodeAnalyzer.java b/platform/analysis-api/src/com/intellij/codeInsight/daemon/DaemonCodeAnalyzer.java index 6346de4f4bbf..369e8f8f19e5 100644 --- a/platform/analysis-api/src/com/intellij/codeInsight/daemon/DaemonCodeAnalyzer.java +++ b/platform/analysis-api/src/com/intellij/codeInsight/daemon/DaemonCodeAnalyzer.java @@ -80,7 +80,7 @@ public abstract class DaemonCodeAnalyzer { } /** - * @deprecated Please use DaemonListener directly + * @deprecated Please use {@link DaemonListener} directly */ public abstract static class DaemonListenerAdapter implements DaemonListener { @Override diff --git a/platform/analysis-impl/src/com/intellij/profile/codeInspection/InspectionProfileLoadUtil.java b/platform/analysis-impl/src/com/intellij/profile/codeInspection/InspectionProfileLoadUtil.java index 375d8e38a461..2ee901821817 100644 --- a/platform/analysis-impl/src/com/intellij/profile/codeInspection/InspectionProfileLoadUtil.java +++ b/platform/analysis-impl/src/com/intellij/profile/codeInspection/InspectionProfileLoadUtil.java @@ -47,7 +47,7 @@ public class InspectionProfileLoadUtil { } /** - * @deprecated Please use load(file: Path, ...) + * @deprecated Please use {@link #load(Path, InspectionToolRegistrar, InspectionProfileManager)} instead */ @NotNull @Deprecated diff --git a/platform/core-api/src/com/intellij/openapi/editor/event/DocumentAdapter.java b/platform/core-api/src/com/intellij/openapi/editor/event/DocumentAdapter.java index e69ed27407a2..b270019a9b7a 100644 --- a/platform/core-api/src/com/intellij/openapi/editor/event/DocumentAdapter.java +++ b/platform/core-api/src/com/intellij/openapi/editor/event/DocumentAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.editor.event; /** - * @deprecated Use DocumentListener + * @deprecated Use {@link DocumentListener} instead */ @Deprecated public abstract class DocumentAdapter implements DocumentListener { diff --git a/platform/core-impl/src/com/intellij/execution/process/CommandLineArgumentsProvider.java b/platform/core-impl/src/com/intellij/execution/process/CommandLineArgumentsProvider.java index fea61d6ecac6..60aa8f4ba9d2 100644 --- a/platform/core-impl/src/com/intellij/execution/process/CommandLineArgumentsProvider.java +++ b/platform/core-impl/src/com/intellij/execution/process/CommandLineArgumentsProvider.java @@ -26,7 +26,7 @@ import java.util.Map; /** * @author Roman.Chernyatchik, oleg - * @deprecated Use GeneralCommandLine instead + * @deprecated Use {@link com.intellij.execution.configurations.GeneralCommandLine} instead * @deprecated Usages only in Ruby. Move to Ruby module? */ @Deprecated diff --git a/platform/editor-ui-api/src/com/intellij/ide/projectView/PresentationData.java b/platform/editor-ui-api/src/com/intellij/ide/projectView/PresentationData.java index dc282bc3834b..a9ecff1cb8ba 100644 --- a/platform/editor-ui-api/src/com/intellij/ide/projectView/PresentationData.java +++ b/platform/editor-ui-api/src/com/intellij/ide/projectView/PresentationData.java @@ -79,7 +79,7 @@ public class PresentationData implements ColoredItemPresentation, ComparableObje } /** - * @deprecated Use constructor with single icon instead. + * @deprecated Use {@link #PresentationData(String, String, Icon, TextAttributesKey)} instead. */ public PresentationData(String presentableText, String locationString, Icon openIcon, Icon closedIcon, @Nullable TextAttributesKey attributesKey) { diff --git a/platform/editor-ui-api/src/com/intellij/openapi/editor/event/CaretAdapter.java b/platform/editor-ui-api/src/com/intellij/openapi/editor/event/CaretAdapter.java index 7cea30698250..7ff04f554063 100644 --- a/platform/editor-ui-api/src/com/intellij/openapi/editor/event/CaretAdapter.java +++ b/platform/editor-ui-api/src/com/intellij/openapi/editor/event/CaretAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.editor.event; /** - * @deprecated Use CaretListener + * @deprecated Use {@link CaretListener} instead */ @Deprecated public abstract class CaretAdapter implements CaretListener { diff --git a/platform/editor-ui-api/src/com/intellij/openapi/vcs/FileStatus.java b/platform/editor-ui-api/src/com/intellij/openapi/vcs/FileStatus.java index 078a7589b6b9..e9cfdb2e9591 100644 --- a/platform/editor-ui-api/src/com/intellij/openapi/vcs/FileStatus.java +++ b/platform/editor-ui-api/src/com/intellij/openapi/vcs/FileStatus.java @@ -24,7 +24,7 @@ import java.awt.*; @SuppressWarnings("UseJBColor") public interface FileStatus { /** - * @deprecated Use FileStatus.getColor() instead + * @deprecated Use {@link FileStatus#getColor} instead */ @Deprecated Color COLOR_NOT_CHANGED = null; // deliberately null, do not use hardcoded Color.BLACK @Deprecated Color COLOR_NOT_CHANGED_RECURSIVE = new Color(138, 164, 200); diff --git a/platform/lang-api/src/com/intellij/execution/BeforeRunTask.java b/platform/lang-api/src/com/intellij/execution/BeforeRunTask.java index 880a712c9870..cf347ee6db05 100644 --- a/platform/lang-api/src/com/intellij/execution/BeforeRunTask.java +++ b/platform/lang-api/src/com/intellij/execution/BeforeRunTask.java @@ -50,7 +50,7 @@ public abstract class BeforeRunTask implements Cloneabl } /** - * @deprecated Use PersistentStateComponent (see LaunchBrowserBeforeRunTask for example). + * @deprecated Use {@link PersistentStateComponent} instead (see {@link com.intellij.ide.browsers.LaunchBrowserBeforeRunTask} for example). */ public void writeExternal(@NotNull Element element) { if (this instanceof PersistentStateComponent) { @@ -62,7 +62,7 @@ public abstract class BeforeRunTask implements Cloneabl } /** - * @deprecated Use PersistentStateComponent (see LaunchBrowserBeforeRunTask for example). + * @deprecated Use {@link PersistentStateComponent} instead (see {@link com.intellij.ide.browsers.LaunchBrowserBeforeRunTask} for example). */ public void readExternal(@NotNull Element element) { String attribValue = element.getAttributeValue("enabled"); diff --git a/platform/lang-api/src/com/intellij/execution/runners/AsyncGenericProgramRunner.java b/platform/lang-api/src/com/intellij/execution/runners/AsyncGenericProgramRunner.java index 6aaac8fa2103..2fd5df6fd9f5 100644 --- a/platform/lang-api/src/com/intellij/execution/runners/AsyncGenericProgramRunner.java +++ b/platform/lang-api/src/com/intellij/execution/runners/AsyncGenericProgramRunner.java @@ -14,7 +14,7 @@ import org.jetbrains.concurrency.Promise; import static com.intellij.execution.runners.GenericProgramRunnerKt.startRunProfile; /** - * @deprecated Use AsyncProgramRunner + * @deprecated Use {@link AsyncProgramRunner} instead */ @Deprecated public abstract class AsyncGenericProgramRunner extends BaseProgramRunner { diff --git a/platform/lang-api/src/com/intellij/formatting/SpacingBuilder.java b/platform/lang-api/src/com/intellij/formatting/SpacingBuilder.java index 10fe5d6e7fec..b1922d717a3b 100644 --- a/platform/lang-api/src/com/intellij/formatting/SpacingBuilder.java +++ b/platform/lang-api/src/com/intellij/formatting/SpacingBuilder.java @@ -180,7 +180,7 @@ public class SpacingBuilder { /** * @param codeStyleSettings - * @deprecated Use other constructors! + * @deprecated Use {@link #SpacingBuilder(CodeStyleSettings, Language)} or {@link #SpacingBuilder(CommonCodeStyleSettings)} instead */ @SuppressWarnings("unused") @Deprecated diff --git a/platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettings.java b/platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettings.java index 9880698cce78..e095f6f4da2c 100644 --- a/platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettings.java +++ b/platform/lang-api/src/com/intellij/psi/codeStyle/CommonCodeStyleSettings.java @@ -434,7 +434,7 @@ public class CommonCodeStyleSettings { public boolean ALIGN_MULTILINE_PARAMETERS_IN_CALLS = false; public boolean ALIGN_MULTILINE_RESOURCES = true; public boolean ALIGN_MULTILINE_FOR = true; - /** @deprecated Use RubyCodeStyleSettings.INDENT_WITH_CASES */ + /** @deprecated Use {@link org.jetbrains.plugins.ruby.settings.RubyCodeStyleSettings#INDENT_WHEN_CASES} instead */ @Deprecated public boolean INDENT_WHEN_CASES = true; diff --git a/platform/lang-impl/src/com/intellij/execution/RunManagerAdapter.java b/platform/lang-impl/src/com/intellij/execution/RunManagerAdapter.java index a66ae064b65c..8336b4ed5ef9 100644 --- a/platform/lang-impl/src/com/intellij/execution/RunManagerAdapter.java +++ b/platform/lang-impl/src/com/intellij/execution/RunManagerAdapter.java @@ -16,7 +16,7 @@ package com.intellij.execution; /** - * @deprecated Please use RunManagerListener directly + * @deprecated Please use {@link RunManagerListener} instead */ @Deprecated public abstract class RunManagerAdapter implements RunManagerListener { diff --git a/platform/platform-api/src/com/intellij/codeStyle/CodeStyleFacade.java b/platform/platform-api/src/com/intellij/codeStyle/CodeStyleFacade.java index 16c26850ac24..826f8800f09b 100644 --- a/platform/platform-api/src/com/intellij/codeStyle/CodeStyleFacade.java +++ b/platform/platform-api/src/com/intellij/codeStyle/CodeStyleFacade.java @@ -75,7 +75,7 @@ public abstract class CodeStyleFacade { } /** - * @deprecated Use CodeStyle.getIndentSize(psiFile) instead. + * @deprecated Use {@link com.intellij.application.options.CodeStyle#getIndentSize(com.intellij.psi.PsiFile)} instead. */ public abstract int getIndentSize(FileType fileType); diff --git a/platform/platform-api/src/com/intellij/openapi/application/ApplicationActivationListener.java b/platform/platform-api/src/com/intellij/openapi/application/ApplicationActivationListener.java index 1d0107a48f27..23a2ad755345 100644 --- a/platform/platform-api/src/com/intellij/openapi/application/ApplicationActivationListener.java +++ b/platform/platform-api/src/com/intellij/openapi/application/ApplicationActivationListener.java @@ -48,7 +48,7 @@ public interface ApplicationActivationListener { } /** - * @deprecated Use ApplicationActivationListener directly + * @deprecated Use {@link ApplicationActivationListener} instead */ @Deprecated abstract class Adapter implements ApplicationActivationListener { diff --git a/platform/platform-api/src/com/intellij/openapi/command/CommandAdapter.java b/platform/platform-api/src/com/intellij/openapi/command/CommandAdapter.java index 75873d262c52..0038fe8ac4d1 100644 --- a/platform/platform-api/src/com/intellij/openapi/command/CommandAdapter.java +++ b/platform/platform-api/src/com/intellij/openapi/command/CommandAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.command; /** - * @deprecated Use CommandListener directly + * @deprecated Use {@link CommandListener} instead */ public abstract class CommandAdapter implements CommandListener { } \ No newline at end of file diff --git a/platform/platform-api/src/com/intellij/openapi/editor/colors/EditorColorsAdapter.java b/platform/platform-api/src/com/intellij/openapi/editor/colors/EditorColorsAdapter.java index 961f3b6b823b..4415107af225 100644 --- a/platform/platform-api/src/com/intellij/openapi/editor/colors/EditorColorsAdapter.java +++ b/platform/platform-api/src/com/intellij/openapi/editor/colors/EditorColorsAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.editor.colors; /** - * @deprecated Use EditorColorsListener directly + * @deprecated Use {@link EditorColorsListener} instead */ @Deprecated public abstract class EditorColorsAdapter implements EditorColorsListener { diff --git a/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManager.java b/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManager.java index 8679cc7f977b..aeb7f3f2ed27 100644 --- a/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManager.java +++ b/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManager.java @@ -185,7 +185,7 @@ public abstract class FileEditorManager { /** * Adds specified {@code listener} * @param listener listener to be added - * @deprecated Use MessageBus instead: see {@link FileEditorManagerListener#FILE_EDITOR_MANAGER} + * @deprecated Use {@link com.intellij.util.messages.MessageBus} instead: see {@link FileEditorManagerListener#FILE_EDITOR_MANAGER} */ public abstract void addFileEditorManagerListener(@NotNull FileEditorManagerListener listener); diff --git a/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManagerAdapter.java b/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManagerAdapter.java index 1e4b5ef677af..29c195e58cb9 100644 --- a/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManagerAdapter.java +++ b/platform/platform-api/src/com/intellij/openapi/fileEditor/FileEditorManagerAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.fileEditor; /** - * @deprecated Please use FileEditorManagerListener + * @deprecated Please use {@link FileEditorManagerListener} instead */ @Deprecated public abstract class FileEditorManagerAdapter implements FileEditorManagerListener { diff --git a/platform/platform-api/src/com/intellij/openapi/project/ProjectManagerAdapter.java b/platform/platform-api/src/com/intellij/openapi/project/ProjectManagerAdapter.java index 7c82d27a1c02..c5bf2d477d29 100644 --- a/platform/platform-api/src/com/intellij/openapi/project/ProjectManagerAdapter.java +++ b/platform/platform-api/src/com/intellij/openapi/project/ProjectManagerAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.project; /** - * @deprecated Use ProjectManagerListener + * @deprecated Use {@link ProjectManagerListener} instead */ @Deprecated public abstract class ProjectManagerAdapter implements ProjectManagerListener { diff --git a/platform/platform-api/src/com/intellij/ui/treeStructure/SimpleNodeRenderer.java b/platform/platform-api/src/com/intellij/ui/treeStructure/SimpleNodeRenderer.java index af486965577c..3bda4e5aaf35 100644 --- a/platform/platform-api/src/com/intellij/ui/treeStructure/SimpleNodeRenderer.java +++ b/platform/platform-api/src/com/intellij/ui/treeStructure/SimpleNodeRenderer.java @@ -18,7 +18,7 @@ package com.intellij.ui.treeStructure; import com.intellij.ide.util.treeView.NodeRenderer; /** - * @deprecated Use NodeRenderer instead + * @deprecated Use {@link NodeRenderer} instead */ public class SimpleNodeRenderer extends NodeRenderer { diff --git a/platform/projectModel-api/src/com/intellij/openapi/project/ModuleAdapter.java b/platform/projectModel-api/src/com/intellij/openapi/project/ModuleAdapter.java index e469cf3338fd..c8b44a813863 100644 --- a/platform/projectModel-api/src/com/intellij/openapi/project/ModuleAdapter.java +++ b/platform/projectModel-api/src/com/intellij/openapi/project/ModuleAdapter.java @@ -16,7 +16,7 @@ package com.intellij.openapi.project; /** - * @deprecated Please use ModuleListener directly. + * @deprecated Please use {@link ModuleListener} directly. */ public abstract class ModuleAdapter implements ModuleListener { } diff --git a/platform/util/src/com/intellij/openapi/util/JDOMUtil.java b/platform/util/src/com/intellij/openapi/util/JDOMUtil.java index 69f8c6e058ea..53385710cf37 100644 --- a/platform/util/src/com/intellij/openapi/util/JDOMUtil.java +++ b/platform/util/src/com/intellij/openapi/util/JDOMUtil.java @@ -122,7 +122,7 @@ public class JDOMUtil { } /** - * @deprecated Use Element.getChildren() directly + * @deprecated Use {@link Element#getChildren} instead */ @NotNull @Deprecated diff --git a/platform/util/src/com/intellij/util/Base64Converter.java b/platform/util/src/com/intellij/util/Base64Converter.java index 7d48a54b7e5f..04171dbc36f4 100644 --- a/platform/util/src/com/intellij/util/Base64Converter.java +++ b/platform/util/src/com/intellij/util/Base64Converter.java @@ -19,9 +19,8 @@ import com.intellij.util.text.StringFactory; import org.jetbrains.annotations.NotNull; /** - * @deprecated Please use java.util.Base64 + * @deprecated Please use {@link java.util.Base64} instead */ -@SuppressWarnings("unused") @Deprecated public class Base64Converter { private static final char[] alphabet = { diff --git a/platform/vcs-api/src/com/intellij/openapi/vcs/changes/VcsDirtyScopeManager.java b/platform/vcs-api/src/com/intellij/openapi/vcs/changes/VcsDirtyScopeManager.java index 8ceadfc005d8..66ea77776f84 100644 --- a/platform/vcs-api/src/com/intellij/openapi/vcs/changes/VcsDirtyScopeManager.java +++ b/platform/vcs-api/src/com/intellij/openapi/vcs/changes/VcsDirtyScopeManager.java @@ -59,7 +59,7 @@ public abstract class VcsDirtyScopeManager { * Requests an asynchronous file status update for all files under the specified directory. * * @param dir the directory for which the file status update is requested. - * @deprecated Use single-parameter version instead. + * @deprecated Use {@link #dirDirtyRecursively(VirtualFile)} instead. */ public abstract void dirDirtyRecursively(VirtualFile dir, final boolean scheduleUpdate); diff --git a/platform/vcs-api/vcs-api-core/src/com/intellij/lifecycle/PeriodicalTasksCloser.java b/platform/vcs-api/vcs-api-core/src/com/intellij/lifecycle/PeriodicalTasksCloser.java index 33e62fc03897..c28f68053bf3 100644 --- a/platform/vcs-api/vcs-api-core/src/com/intellij/lifecycle/PeriodicalTasksCloser.java +++ b/platform/vcs-api/vcs-api-core/src/com/intellij/lifecycle/PeriodicalTasksCloser.java @@ -26,7 +26,7 @@ import com.intellij.util.ExceptionUtil; import org.jetbrains.annotations.NotNull; /** - * @deprecated Use plain {@link ServiceManager#getService(Project, Class)} and {@link Project#getComponent(Class)}. + * @deprecated Use {@link ServiceManager#getService(Project, Class)} and {@link Project#getComponent(Class)}. *

* To avoid "Already Disposed" exceptions and NPEs the calls to getService/getComponent should happen either from a Read Action * with a dispose check, or from a background task with a proper dispose-aware ProgressIndicator, diff --git a/plugins/git4idea/src/git4idea/GitPlatformFacade.java b/plugins/git4idea/src/git4idea/GitPlatformFacade.java index 931a6f8482e9..8cfd9c0fc642 100644 --- a/plugins/git4idea/src/git4idea/GitPlatformFacade.java +++ b/plugins/git4idea/src/git4idea/GitPlatformFacade.java @@ -25,21 +25,18 @@ import org.jetbrains.annotations.NotNull; /** * @deprecated Use direct instance or ServiceManager methods to access platform structures. */ -@SuppressWarnings("DeprecatedIsStillUsed") @Deprecated public interface GitPlatformFacade { /** * @deprecated To remove in IDEA 2017. Use {@link ChangeListManager#getInstance(Project)}. */ - @SuppressWarnings("unused") @Deprecated ChangeListManagerEx getChangeListManager(@NotNull Project project); /** * @deprecated To remove in IDEA 2017. Use {@link VfsUtil#markDirtyAndRefresh(boolean, boolean, boolean, VirtualFile...)}. */ - @SuppressWarnings("unused") @Deprecated void hardRefresh(@NotNull VirtualFile root); }