Merge pull request #894 from phpDocumentor/backport/1.x/pr-889

[1.x] Merge pull request #889 from phpDocumentor/bugfix/multiline-comments

Author: phpdoc-bot

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/CommentRule.php

@@ -56,11 +56,11 @@ private function isCommentLine(string|null $line): bool
             return false;
         }
 
-        return $this->isComment($line) || (trim($line) !== '' && $line[0] === ' ');
+        return $this->isComment($line) || trim($line) === '' || $line[0] === ' ';
     }
 
     private function isComment(string $line): bool
     {
-        return trim($line) === '..' || preg_match('/^\.\.\s+.*$/mUsi', $line) > 0;
+        return trim($line) === '..' || preg_match('/^\.\.\s+[^:]*$/mUsi', $line) > 0;
     }
 }

tests/Functional/tests/comment-empty/comment-empty.html

@@ -1,4 +1 @@
 <p>this is not a comment</p>
-<blockquote>
-    <p>this is a blockquote</p>
-</blockquote>

tests/Integration/tests/class/class-directive/expected/index.html

@@ -20,8 +20,6 @@ <h1>Document title</h1>
         <p>A note without a class</p>
 </div>
 
-            <blockquote class="highlights"><p>Block quote text.</p></blockquote>
-
     </div>
 
 <!-- content end -->

tests/Integration/tests/class/class-directive/input/index.rst

@@ -37,4 +37,4 @@ Document title
 
 ..
 
-    Block quote text.
+    This is a comment

tests/Integration/tests/comments/comment-multiline/expected/index.html

@@ -0,0 +1,8 @@
+<!-- content start -->
+    <div class="section" id="some-title">
+            <h1>Some Title</h1>
+
+            <p>This text is no comment</p>
+    </div>
+
+<!-- content end -->

tests/Integration/tests/comments/comment-multiline/input/index.rst

@@ -0,0 +1,10 @@
+Some Title
+==========
+
+..
+   This whole indented block
+   is a comment.
+
+   Still in the comment.
+
+This text is no comment

tests/Integration/tests/comments/comment-nested/expected/index.html

@@ -0,0 +1,12 @@
+<!-- content start -->
+    <div class="section" id="some-title">
+            <h1>Some Title</h1>
+
+            <div class="admonition note">
+            <p>No comment!</p><p>This text is no comment</p>
+</div>
+
+            <p>After the node</p>
+    </div>
+
+<!-- content end -->

tests/Integration/tests/comments/comment-nested/input/index.rst

@@ -0,0 +1,15 @@
+Some Title
+==========
+
+..  note::
+    No comment!
+
+    ..
+       This whole indented block
+       is a comment.
+
+       Still in the comment.
+
+    This text is no comment
+
+After the node