diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ClassBodyParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ClassBodyParsing.java
index af3dcdf38783..5261951b12a6 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ClassBodyParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ClassBodyParsing.java
@@ -25,7 +25,7 @@ import com.intellij.psi.impl.source.tree.TreeElement;
 import com.intellij.psi.tree.IElementType;
 
 /**
- *
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
  */
 public class ClassBodyParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.ClassBodyParsing");
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/DeclarationParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/DeclarationParsing.java
index a220b14d694a..10899f2551ef 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/DeclarationParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/DeclarationParsing.java
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- *
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
  */
 public class DeclarationParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.DeclarationParsing");
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ExpressionParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ExpressionParsing.java
index fc27fc95ca14..fb96293d27e0 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ExpressionParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ExpressionParsing.java
@@ -34,6 +34,9 @@ import com.intellij.psi.tree.TokenSet;
 import com.intellij.util.CharTable;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
+ */
 public class ExpressionParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.ExpressionParsing");
 
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/FileTextParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/FileTextParsing.java
index 50bdf945ddd0..93035892410e 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/FileTextParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/FileTextParsing.java
@@ -31,7 +31,7 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- *
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
  */
 public class FileTextParsing extends Parsing {
   public FileTextParsing(JavaParsingContext context) {
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ImportsTextParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ImportsTextParsing.java
index 2a24d49bd43a..bae311297dba 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/ImportsTextParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/ImportsTextParsing.java
@@ -28,7 +28,7 @@ import com.intellij.psi.TokenType;
 import org.jetbrains.annotations.Nullable;
 
 /**
- *
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
  */
 public class ImportsTextParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.ImportsTextParsing");
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/JavadocParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/JavadocParsing.java
index 0617588c385b..b43a2b70755d 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/JavadocParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/JavadocParsing.java
@@ -33,6 +33,9 @@ import com.intellij.psi.tree.IElementType;
 import com.intellij.psi.tree.TokenSet;
 import org.jetbrains.annotations.NonNls;
 
+/**
+ * todo[r.sh] rewrite and deprecate
+ */
 public class JavadocParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.JavadocParsing");
 
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/Parsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/Parsing.java
index b9a38cba114a..a93645b172a5 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/Parsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/Parsing.java
@@ -33,6 +33,9 @@ import com.intellij.util.CharTable;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+/**
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
+ */
 public class Parsing  {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.Parsing");
   protected static final boolean DEEP_PARSE_BLOCKS_IN_STATEMENTS = false;
@@ -198,8 +201,8 @@ public class Parsing  {
     return type;
   }
 
-  public CompositeElement parseTypeWithEllipsis(Lexer lexer, boolean eatLastDot, boolean allowWilcard) {
-    CompositeElement type = parseType(lexer, eatLastDot, allowWilcard, false);
+  public CompositeElement parseTypeWithEllipsis(Lexer lexer, boolean eatLastDot, boolean allowWildcard) {
+    CompositeElement type = parseType(lexer, eatLastDot, allowWildcard, false);
     if (type == null) return null;
     if (lexer.getTokenType() == JavaTokenType.ELLIPSIS) {
       CompositeElement type1 = ASTFactory.composite(JavaElementType.TYPE);
diff --git a/java/java-impl/src/com/intellij/psi/impl/source/parsing/StatementParsing.java b/java/java-impl/src/com/intellij/psi/impl/source/parsing/StatementParsing.java
index 6e4f8feade39..c45036a40403 100644
--- a/java/java-impl/src/com/intellij/psi/impl/source/parsing/StatementParsing.java
+++ b/java/java-impl/src/com/intellij/psi/impl/source/parsing/StatementParsing.java
@@ -33,6 +33,9 @@ import org.jetbrains.annotations.Nullable;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * @deprecated old Java parser is deprecated in favor of PSI builder-based one (see com.intellij.lang.java.parser.*) (to remove in IDEA 11).
+ */
 public class StatementParsing extends Parsing {
   private static final Logger LOG = Logger.getInstance("#com.intellij.psi.impl.source.parsing.StatementParsing");