From dfafcd55c50f49126c11c5540904dbc22681c2e0 Mon Sep 17 00:00:00 2001
From: jrfnl <jrfnl@users.noreply.github.com>
Date: Fri, 18 Oct 2024 04:42:08 +0200
Subject: [PATCH] Squiz/Heredoc: add XML doc

Related to 148
---
 .../Squiz/Docs/PHP/HeredocStandard.xml        | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 src/Standards/Squiz/Docs/PHP/HeredocStandard.xml

diff --git a/src/Standards/Squiz/Docs/PHP/HeredocStandard.xml b/src/Standards/Squiz/Docs/PHP/HeredocStandard.xml
new file mode 100644
index 0000000000..b2a63be396
--- /dev/null
+++ b/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>