Merge pull request #634 from PHPCSStandards/feature/148-squiz-heredoc-add-docs

Squiz/Heredoc: add XML doc

Author: jrfnl

src/Standards/Squiz/Docs/PHP/HeredocStandard.xml

@@ -0,0 +1,32 @@
+<documentation title="Heredoc">
+    <standard>
+    <![CDATA[
+    Forbids the use of heredoc and nowdoc syntax.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Using standard strings or inline HTML.">
+        <![CDATA[
+$text = "some $text";
+
+
+
+?>
+some text
+<?php
+
+        ]]>
+        </code>
+        <code title="Invalid: Using heredoc or nowdoc syntax.">
+        <![CDATA[
+$text = <em><<<EOD
+some $text
+EOD</em>;
+
+echo <em><<<'EOD'
+some text
+EOD</em>;
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>