From caf08e73f831fc401d8008ba60a5738c734f170d Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Thu, 14 Dec 2023 11:44:22 -0300
Subject: [PATCH 1/2] Generic/EmptyPHPStatement: add documentation

---
 .../EmptyPHPStatementStandard.xml             | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml

diff --git a/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml b/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
new file mode 100644
index 0000000000..23e27678f2
--- /dev/null
+++ b/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
@@ -0,0 +1,44 @@
+<documentation title="Empty PHP Statement">
+    <standard>
+    <![CDATA[
+    Empty PHP tags are not allowed.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: There is at least one statement inside the PHP tag pair.">
+        <![CDATA[
+<?php <em>echo 'Hello World';</em> ?>
+<?= <em>'Hello World';</em> ?>
+        ]]>
+        </code>
+        <code title="Invalid: There is no statement inside the PHP tag pair.">
+        <![CDATA[
+<?php <em>// some comment</em> ?>
+<?= <em></em> ?>
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Superfluous semi-colons are not allowed.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: There is no superfluous semi-colon after a PHP statement.">
+            <![CDATA[
+function_call()<em>;</em>
+if (true) {
+    echo 'Hello World'<em>;</em>
+}
+        ]]>
+        </code>
+        <code title="Invalid: There are one or more superfluous semi-colons after a PHP statement.">
+            <![CDATA[
+function_call()<em>;;;</em>
+if (true) {
+    echo 'Hello World';
+}<em>;</em>
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From d82f8173c93b567d94e129327af7b26d504a7a37 Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Thu, 4 Jan 2024 10:55:24 -0300
Subject: [PATCH 2/2] Fix one of the invalid examples in
 EmptyPHPStatementStandard.xml

---
 .../Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml b/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
index 23e27678f2..5652f657af 100644
--- a/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
+++ b/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
@@ -13,7 +13,7 @@
         </code>
         <code title="Invalid: There is no statement inside the PHP tag pair.">
         <![CDATA[
-<?php <em>// some comment</em> ?>
+<?php <em>;</em> ?>
 <?= <em></em> ?>
         ]]>
         </code>