Fix OC-5992 Formatter: block comments indentation +review CR-OC @Anton.Makeev

platform/core-api/src/com/intellij/psi/PsiComment.java

@@ -28,4 +28,12 @@ public interface PsiComment extends PsiElement {
    * @return the token type of the comment.
    */
   IElementType getTokenType();
+
+  /**
+   * The instance with implemented interface need to be formatted as set of formatting blocks.
+   *
+   * Applying for in-comment documentation that is similar, but different from Javadoc,
+   * and does not contain internal PSI nodes (injections).
+   */
+  interface BlockFormatting {}
 }

platform/lang-impl/src/com/intellij/psi/impl/source/codeStyle/CodeStyleManagerRunnable.java

@@ -133,7 +133,7 @@ abstract class CodeStyleManagerRunnable<T> {
   protected abstract T doPerform(int offset, TextRange range);
 
   private static boolean isInsidePlainComment(int offset, @Nullable PsiElement element) {
-    if (!(element instanceof PsiComment) || !element.getTextRange().contains(offset)) {
+    if (!(element instanceof PsiComment) || element instanceof PsiComment.BlockFormatting || !element.getTextRange().contains(offset)) {
       return false;
     }