Improve opener/closer descriptions and comparisons.

Author: costdev

src/Standards/Squiz/Docs/Commenting/BlockCommentStandard.xml

@@ -5,39 +5,7 @@
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Uses /* */.">
-        <![CDATA[
-/*
-    A block comment.
-*/
-        ]]>
-        </code>
-        <code title="Invalid: Uses /** */.">
-        <![CDATA[
-<em>/**</em>
-    A block comment.
-*/
-        ]]>
-        </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Uses /* */.">
-        <![CDATA[
-/*
-    A block comment.
-*/
-        ]]>
-        </code>
-        <code title="Invalid: Uses /* **/.">
-        <![CDATA[
-/*
-    A block comment.
-<em>**/</em>
-        ]]>
-        </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Uses /* */.">
+        <code title="Valid: Uses a valid opener and closer.">
         <![CDATA[
 /*
     A block comment.
@@ -53,38 +21,21 @@
         </code>
     </code_comparison>
     <code_comparison>
-        <code title="Valid: Uses /* */.">
+        <code title="Valid: Uses a valid opener and closer.">
         <![CDATA[
 /*
-    A block comment
-    with
-    multiple lines.
+ * A block comment
+ * with multiple lines.
 */
         ]]>
         </code>
-        <code title="Invalid: Uses multiple //.">
+        <code title="Invalid: Uses multiple // or #.">
         <![CDATA[
 <em>//</em> A block comment
-<em>//</em> with
-<em>//</em> multiple lines.
-        ]]>
-        </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Uses /* */.">
-        <![CDATA[
-/*
-    A block comment
-    with
-    multiple lines.
-*/
-        ]]>
-        </code>
-        <code title="Invalid: Uses multiple #.">
-        <![CDATA[
+<em>//</em> with multiple lines.
+
 <em>#</em> A block comment
-<em>#</em> with
-<em>#</em> multiple lines.
+<em>#</em> with multiple lines.
         ]]>
         </code>
     </code_comparison>