Java: preserve multi-line HTML comments inside Javadoc block tags (#7500)

`convertMultiline` already routed `DCText` through `visitText` so that
each newline consumes the corresponding `LineBreak` (with its `*` margin)
from the lineBreaks map. `DCComment` fell through to `scan`/`visitComment`,
which bumped the cursor by the body length in one shot and wrapped the
multi-line body in a single `Javadoc.Text`. The result was that interior
`*` margins were dropped and orphan `LineBreak`s were appended at the end
of the doc as extra blank `*` lines. Mirror the `DCText` handling for
`DCComment` across all version-specific visitors.

Author: timtebeek

rewrite-java-11/src/main/java/org/openrewrite/java/isolated/ReloadableJava11JavadocVisitor.java

@@ -1158,6 +1158,8 @@ private List<Javadoc> convertMultiline(List<? extends DocTree> dts) {
                 js.addAll(whitespaceBefore());
                 if (dt instanceof DCTree.DCText) {
                     js.addAll(visitText(((DCTree.DCText) dt).getBody()));
+                } else if (dt instanceof DCTree.DCComment) {
+                    js.addAll(visitText(((DCTree.DCComment) dt).getBody()));
                 } else {
                     js.add((Javadoc) scan(dt, emptyList()));
                 }

rewrite-java-17/src/main/java/org/openrewrite/java/isolated/ReloadableJava17JavadocVisitor.java

@@ -1161,6 +1161,8 @@ private List<Javadoc> convertMultiline(List<? extends DocTree> dts) {
                 js.addAll(whitespaceBefore());
                 if (dt instanceof DCTree.DCText) {
                     js.addAll(visitText(((DCTree.DCText) dt).getBody()));
+                } else if (dt instanceof DCTree.DCComment) {
+                    js.addAll(visitText(((DCTree.DCComment) dt).getBody()));
                 } else {
                     js.add((Javadoc) scan(dt, emptyList()));
                 }

rewrite-java-21/src/main/java/org/openrewrite/java/isolated/ReloadableJava21JavadocVisitor.java

@@ -1196,6 +1196,8 @@ private List<Javadoc> convertMultiline(List<? extends DocTree> dts) {
                 js.addAll(whitespaceBefore());
                 if (dt instanceof DCTree.DCText) {
                     js.addAll(visitText(((DCTree.DCText) dt).getBody()));
+                } else if (dt instanceof DCTree.DCComment) {
+                    js.addAll(visitText(((DCTree.DCComment) dt).getBody()));
                 } else {
                     js.add((Javadoc) scan(dt, emptyList()));
                 }

rewrite-java-25/src/main/java/org/openrewrite/java/isolated/ReloadableJava25JavadocVisitor.java

@@ -1339,6 +1339,8 @@ private List<Javadoc> convertMultiline(List<? extends DocTree> dts) {
                     js.addAll(visitText(textNode.getBody()));
                 } else if (dt instanceof DCTree.DCRawText rawTextNode) {
                     js.addAll(visitText(rawTextNode.getContent()));
+                } else if (dt instanceof DCTree.DCComment commentNode) {
+                    js.addAll(visitText(commentNode.getBody()));
                 } else {
                     js.add((Javadoc) scan(dt, emptyList()));
                 }

rewrite-java-8/src/main/java/org/openrewrite/java/ReloadableJava8JavadocVisitor.java

@@ -1086,6 +1086,8 @@ private List<Javadoc> convertMultiline(List<? extends DocTree> dts) {
                 js.addAll(whitespaceBefore());
                 if (dt instanceof DCTree.DCText) {
                     js.addAll(visitText(((DCTree.DCText) dt).getBody()));
+                } else if (dt instanceof DCTree.DCComment) {
+                    js.addAll(visitText(((DCTree.DCComment) dt).getBody()));
                 } else {
                     js.add((Javadoc) scan(dt, emptyList()));
                 }

rewrite-java-tck/src/main/java/org/openrewrite/java/tree/JavadocTest.java

@@ -2214,6 +2214,23 @@ class Test {
         );
     }
 
+    @Test
+    void multilineHtmlCommentInBlockTag() {
+        rewriteRun(
+          java(
+            """
+              /**
+              * @version 0.1
+              *    <!-- xml comment nested
+              *       * [someAuthor] fixed something
+              *    -->
+              **/
+              class Test {}
+              """
+          )
+        );
+    }
+
     @Issue("https://github.com/openrewrite/rewrite/issues/5443")
     @Test
     void parsingIncorrectJavadocValueReference() {