From 0c015d4619690ada14e4badb57718d819e4be217 Mon Sep 17 00:00:00 2001
From: AlwaysVictorious <213483686+AlwaysVictorious@users.noreply.github.com>
Date: Fri, 14 Aug 2026 15:00:41 +0200
Subject: [PATCH 1/2] Example PHP 7.3.0: clarify indentation concerns the
 identifier not the output

Updated heredoc example in string.xml to reflect indentation changes.
---
 language/types/string.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/language/types/string.xml b/language/types/string.xml
index 2013b079d4c5..bbed5e62fad2 100644
--- a/language/types/string.xml
+++ b/language/types/string.xml
@@ -233,7 +233,7 @@ echo 'Variables do not $expand $either', PHP_EOL;
     <programlisting role="php">
 <![CDATA[
 <?php
-// no indentation
+// closing identifier not indented
 echo <<<END
       a
      b
@@ -241,7 +241,7 @@ echo <<<END
 \n
 END;
 
-// 4 spaces of indentation
+// closing identifier indented with 4 spaces
 echo <<<END
       a
      b

From ee1dabd4fda02ce8c7936539a29fbe50aa93ed70 Mon Sep 17 00:00:00 2001
From: AlwaysVictorious <213483686+AlwaysVictorious@users.noreply.github.com>
Date: Fri, 14 Aug 2026 15:08:36 +0200
Subject: [PATCH 2/2] Clarify Heredoc closing identifier indentation behaviour

Clarify indentation behavior for closing identifiers in Heredoc strings. Modify the example to display the newly described  behaviour
---
 language/types/string.xml | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/language/types/string.xml b/language/types/string.xml
index bbed5e62fad2..1a83844a67fd 100644
--- a/language/types/string.xml
+++ b/language/types/string.xml
@@ -216,8 +216,9 @@ echo 'Variables do not $expand $either', PHP_EOL;
    </simpara>
 
    <simpara>
-    The closing identifier may be indented by space or tab, in which case
-    the indentation will be stripped from all lines in the doc string.
+    The closing identifier may be indented with spaces or tabs. Whitespace
+    equal to the closing identifier's indentation is then removed from the
+    beginning of every line in the Heredoc string.
     Prior to PHP 7.3.0, the closing identifier <emphasis>must</emphasis>
     begin in the first column of the line.
    </simpara>
@@ -241,12 +242,12 @@ echo <<<END
 \n
 END;
 
-// closing identifier indented with 4 spaces
+// closing identifier indented with 3 spaces; 3 spaces stripped from each line
 echo <<<END
       a
      b
     c
-    END;
+   END;
 ]]>
     </programlisting>
     &example.outputs.73;
@@ -256,9 +257,9 @@ echo <<<END
      b
     c
 
-  a
- b
-c
+   a
+  b
+ c
 ]]>
     </screen>
    </example>