From 1ace9c1d0f255676fd19a5d485e925fe76f876ff Mon Sep 17 00:00:00 2001
From: Larry Garfield <lgarfield@makershub.ai>
Date: Fri, 3 Oct 2025 11:43:43 -0500
Subject: [PATCH] Add deprecation/changelog for switch statement semicolons.

---
 language/control-structures/switch.xml | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/language/control-structures/switch.xml b/language/control-structures/switch.xml
index 3ffa3a6098ca..c768e8bb93ea 100644
--- a/language/control-structures/switch.xml
+++ b/language/control-structures/switch.xml
@@ -269,7 +269,7 @@ endswitch;
   </informalexample>
  </para>
  <para>
-  It's possible to use a semicolon instead of a colon after a case like:
+  Prior to PHP 8.5.0, it was possible to use a semicolon instead of a colon after a case like:
   <informalexample>
    <programlisting role="php">
 <![CDATA[
@@ -290,8 +290,32 @@ switch($beer)
 ]]>
    </programlisting>
   </informalexample>
+  This syntax has been deprecated as of PHP 8.5.0.
  </para>
 
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       The alternate syntax using a semicolon after <literal>case</literal> has been deprecated.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <sect2 role="seealso">
   &reftitle.seealso;
   <para>