JavaFolding: added folding for multiline comments (IDEA-106702), added header for javadocs foldings (IDEA-144788)

java/java-tests/testData/codeInsight/folding/MultilineComments.java

@@ -0,0 +1,44 @@
+<fold text='/*...*/'>/*
+outer class comment
+ */</fold>
+class Test {
+  <fold text='/*...*/'>/*
+  dangling multiline commnent
+   */</fold>
+
+  <fold text='/*...*/'>/*
+  field comment
+   */</fold>
+  int field;
+
+  <fold text='/*...*/'>/*
+  method comment
+  */</fold>
+  void foo() <fold text='{...}'>{
+
+    <fold text='/*...*/'>/*
+    method var comment
+     */</fold>
+    final int i = 42;
+  }</fold>
+
+  <fold text='/*...*/'>/*
+  inner class comment
+   */</fold>
+  class Inner <fold text='{...}'>{
+
+    <fold text='/*...*/'>/*
+    inner class method comment
+     */</fold>
+    void foo() <fold text='{...}'>{
+      class MethodInner <fold text='{...}'>{
+        <fold text='/*...*/'>/*
+        method inside class declared in method comment
+        */</fold>
+        void foo() <fold text='{}'>{
+
+        }</fold>
+      }</fold>
+    }</fold>
+  }</fold>
+}