diff --git a/platform/lang-api/src/com/intellij/codeInsight/completion/CompletionContributor.java b/platform/lang-api/src/com/intellij/codeInsight/completion/CompletionContributor.java
index 1b3ac51b9cca..7c70c516393b 100644
--- a/platform/lang-api/src/com/intellij/codeInsight/completion/CompletionContributor.java
+++ b/platform/lang-api/src/com/intellij/codeInsight/completion/CompletionContributor.java
@@ -189,8 +189,10 @@ public abstract class CompletionContributor {
   }
 
   /**
-   * Allow autoPopup to appear after custom symbol
+   * Don't use this method, because {@code position} can come from uncommitted PSI and be totally unrelated to the code being currently in the document/editor.
+   * Please consider using {@link com.intellij.codeInsight.editorActions.TypedHandlerDelegate#checkAutoPopup} instead.
    */
+  @Deprecated
   public boolean invokeAutoPopup(@NotNull PsiElement position, char typeChar) {
     return false;
   }