From 2f12a1ccb7585a1450c0d7169f8f812cc85f163e Mon Sep 17 00:00:00 2001
From: Niels Dossche <7771979+nielsdos@users.noreply.github.com>
Date: Wed, 20 Nov 2024 21:05:57 +0100
Subject: [PATCH 1/2] Document PHP 8.3 proc_get_status() change

---
 reference/exec/functions/proc-get-status.xml | 38 ++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/reference/exec/functions/proc-get-status.xml b/reference/exec/functions/proc-get-status.xml
index 1c4000ec1c3c..02fa63f35f1c 100644
--- a/reference/exec/functions/proc-get-status.xml
+++ b/reference/exec/functions/proc-get-status.xml
@@ -90,8 +90,17 @@
       <entry>
        The exit code returned by the process (which is only
        meaningful if <literal>running</literal> is &false;).
-       Only first call of this function return real value, next calls return
-       <literal>-1</literal>.
+       Prior to PHP 8.3.0, only first call of this function returned the real
+       value, the following calls returned <literal>-1</literal>.
+      </entry>
+     </row>
+     <row>
+      <entry>cached</entry>
+      <entry><type>bool</type></entry>
+      <entry>
+       As of PHP 8.3.0, this is &true; when the exit code is cached.
+       Caching is necessary to make sure the exit code is not lost by
+       subsequent calls to process APIs.
       </entry>
      </row>
      <row>
@@ -116,6 +125,31 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.3.0</entry>
+      <entry>
+       The <literal>"cached"</literal> entry has been added to the returned
+       array. Prior to PHP 8.3.0, only the first call returned the real exit
+       code. The <literal>"cached"</literal> entry indicates that the exit code
+       was cached.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

From a400926202865cd41644a8dc08613a350e3a319e Mon Sep 17 00:00:00 2001
From: Niels Dossche <7771979+nielsdos@users.noreply.github.com>
Date: Thu, 21 Nov 2024 07:20:39 +0100
Subject: [PATCH 2/2] Update reference/exec/functions/proc-get-status.xml

Co-authored-by: Gina Peter Banyard <girgias@php.net>
---
 reference/exec/functions/proc-get-status.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/exec/functions/proc-get-status.xml b/reference/exec/functions/proc-get-status.xml
index 02fa63f35f1c..0ac5ab248893 100644
--- a/reference/exec/functions/proc-get-status.xml
+++ b/reference/exec/functions/proc-get-status.xml
@@ -90,7 +90,7 @@
       <entry>
        The exit code returned by the process (which is only
        meaningful if <literal>running</literal> is &false;).
-       Prior to PHP 8.3.0, only first call of this function returned the real
+       Prior to PHP 8.3.0, only the first call of this function returned the real
        value, the following calls returned <literal>-1</literal>.
       </entry>
      </row>