From 09f33a635dc6a94a18e7f88eaddd976f50b962b3 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 31 Aug 2026 13:55:22 +0200
Subject: [PATCH] pcntl: fix the reference pages and document the 8.4 failure
 return

---
 reference/pcntl/constants.xml                 | 13 +-----
 reference/pcntl/functions/pcntl-exec.xml      | 10 +++--
 .../pcntl/functions/pcntl-sigprocmask.xml     | 28 ++++++-------
 .../pcntl/functions/pcntl-sigtimedwait.xml    | 42 +++++++++++--------
 .../pcntl/functions/pcntl-sigwaitinfo.xml     | 31 ++++++++------
 reference/pcntl/functions/pcntl-unshare.xml   | 19 ++++-----
 reference/pcntl/versions.xml                  |  7 +++-
 7 files changed, 78 insertions(+), 72 deletions(-)

diff --git a/reference/pcntl/constants.xml b/reference/pcntl/constants.xml
index 1a88b61298..6560bd874f 100644
--- a/reference/pcntl/constants.xml
+++ b/reference/pcntl/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 71fa455c5670ea4a3a3a0c60e34d906d1061a6c8 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <appendix xml:id="pcntl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -644,17 +644,6 @@
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.si-msggq">
-   <term>
-    <constant>SI_MSGGQ</constant>
-    (<type>int</type>)
-   </term>
-   <listitem>
-    <simpara>
-
-    </simpara>
-   </listitem>
-  </varlistentry>
   <varlistentry xml:id="constant.si-asyncio">
    <term>
     <constant>SI_ASYNCIO</constant>
diff --git a/reference/pcntl/functions/pcntl-exec.xml b/reference/pcntl/functions/pcntl-exec.xml
index 19c85626ab..fc208f617e 100644
--- a/reference/pcntl/functions/pcntl-exec.xml
+++ b/reference/pcntl/functions/pcntl-exec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.pcntl-exec" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -58,9 +58,11 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Возвращает &false;.
-  </para>
+  <simpara>
+   Функция возвращает &false; в случае ошибки. В случае успешного выполнения
+   функция не возвращает управление, поскольку образ текущего процесса
+   заменяется исполняемой программой.
+  </simpara>
  </refsect1>
 
 </refentry>
diff --git a/reference/pcntl/functions/pcntl-sigprocmask.xml b/reference/pcntl/functions/pcntl-sigprocmask.xml
index d9047977db..c03b2b792f 100644
--- a/reference/pcntl/functions/pcntl-sigprocmask.xml
+++ b/reference/pcntl/functions/pcntl-sigprocmask.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.pcntl-sigprocmask" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -84,22 +84,24 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не задано,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если параметр <parameter>signals</parameter> пуст,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>,
+       кроме случая, когда значение параметра <parameter>mode</parameter> —
+       константа <constant>SIG_SETMASK</constant>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не целое число (<type>int</type>),
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если значение параметра <parameter>signals</parameter> не целое число (<type>int</type>),
+       выбрасывается ошибка <exceptionname>TypeError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> некорректно,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если значение параметра <parameter>signals</parameter> некорректно,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
@@ -107,7 +109,7 @@
       <entry>
        Если значение параметра <parameter>mode</parameter> не
        <constant>SIG_BLOCK</constant>, <constant>SIG_UNBLOCK</constant> или
-       <constant>SIG_SETMASK</constant>, выбрасывается ошибка <classname>ValueError</classname>.
+       <constant>SIG_SETMASK</constant>, выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
     </tbody>
@@ -135,12 +137,10 @@ pcntl_sigprocmask(SIG_UNBLOCK, array(SIGHUP), $oldset);
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>pcntl_sigwaitinfo</function></member>
-    <member><function>pcntl_sigtimedwait</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>pcntl_sigwaitinfo</function></member>
+   <member><function>pcntl_sigtimedwait</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/pcntl/functions/pcntl-sigtimedwait.xml b/reference/pcntl/functions/pcntl-sigtimedwait.xml
index f3677cff50..76ba8e020e 100644
--- a/reference/pcntl/functions/pcntl-sigtimedwait.xml
+++ b/reference/pcntl/functions/pcntl-sigtimedwait.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.pcntl-sigtimedwait" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -87,43 +87,51 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не задано,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       В случае ошибки теперь возвращается &false;; раньше в ряде случаев
+       возвращалось значение <literal>-1</literal>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не целое число (<type>int</type>),
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если параметр <parameter>signals</parameter> пуст,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> некорректно,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если значение параметра <parameter>signals</parameter> не целое число (<type>int</type>),
+       выбрасывается ошибка <exceptionname>TypeError</exceptionname>.
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Если значение параметра <parameter>signals</parameter> некорректно,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
        Если значение параметра <parameter>seconds</parameter> меньше <literal>0</literal>,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>nanoseconds</parameter> меньше <literal>0</literal>,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если значение параметра <parameter>nanoseconds</parameter> не находится
+       в диапазоне от <literal>0</literal> до <literal>1e9</literal>,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>seconds</parameter> и <parameter>nanoseconds</parameter>
-       меньше <literal>0</literal>, выбрасывается ошибка <classname>ValueError</classname>.
+       Если значения параметров <parameter>seconds</parameter> и <parameter>nanoseconds</parameter>
+       равны <literal>0</literal>, выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
     </tbody>
@@ -133,12 +141,10 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>pcntl_sigprocmask</function></member>
-    <member><function>pcntl_sigwaitinfo</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>pcntl_sigprocmask</function></member>
+   <member><function>pcntl_sigwaitinfo</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/pcntl/functions/pcntl-sigwaitinfo.xml b/reference/pcntl/functions/pcntl-sigwaitinfo.xml
index a8edeb1787..ad21440c93 100644
--- a/reference/pcntl/functions/pcntl-sigwaitinfo.xml
+++ b/reference/pcntl/functions/pcntl-sigwaitinfo.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.pcntl-sigwaitinfo" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -100,22 +100,29 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не задано,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       В случае ошибки теперь возвращается &false;; раньше в ряде случаев
+       возвращалось значение <literal>-1</literal>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> не целое число (<type>int</type>),
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если параметр <parameter>signals</parameter> пуст,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Если значение параметра <parameter>signal</parameter> некорректно,
-       выбрасывается ошибка <classname>ValueError</classname>.
+       Если значение параметра <parameter>signals</parameter> не целое число (<type>int</type>),
+       выбрасывается ошибка <exceptionname>TypeError</exceptionname>.
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Если значение параметра <parameter>signals</parameter> некорректно,
+       выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
       </entry>
      </row>
     </tbody>
@@ -149,12 +156,10 @@ pcntl_sigwaitinfo(array(SIGHUP), $info);
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>pcntl_sigprocmask</function></member>
-    <member><function>pcntl_sigtimedwait</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>pcntl_sigprocmask</function></member>
+   <member><function>pcntl_sigtimedwait</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/pcntl/functions/pcntl-unshare.xml b/reference/pcntl/functions/pcntl-unshare.xml
index 80aa4dda3f..17b6313ce2 100644
--- a/reference/pcntl/functions/pcntl-unshare.xml
+++ b/reference/pcntl/functions/pcntl-unshare.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d7c1097cca089f4571977b41855e63d3c3638433 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id='function.pcntl-unshare' xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -49,21 +49,20 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Возвращает <literal>0</literal> в случае успешного выполнения, <literal>-1</literal> в противном случае.
+  <simpara>
+   Функция возвращает &true; в случае успешного выполнения или &false;
+   в случае ошибки.
    В случае возникновения ошибки устанавливается код ошибки,
    который можно получить с помощью функции <function>pcntl_get_last_error</function>.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><link linkend="pcntl.constants.clone">Константы PCNTL</link></member>
-    <member><function>pcntl_get_last_error</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><link linkend="pcntl.constants.clone">Константы PCNTL</link></member>
+   <member><function>pcntl_get_last_error</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/pcntl/versions.xml b/reference/pcntl/versions.xml
index 67657a0008..65a11df49f 100644
--- a/reference/pcntl/versions.xml
+++ b/reference/pcntl/versions.xml
@@ -1,18 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
 <?do-not-translate?>
-<!-- EN-Revision: c2149ab44867d36166d750d5d8730a2ca7dd61e2 Credit: lacatoire -->
+<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Credit: lacatoire -->
 <versions>
  <function name="pcntl_alarm" from="PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_async_signals" from="PHP 7 &gt;= 7.1.0, PHP 8"/>
  <function name="pcntl_errno" from="PHP 5 &gt;= 5.3.4, PHP 7, PHP 8"/>
  <function name="pcntl_exec" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_fork" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
+ <function name="pcntl_forkx" from="PHP 8 &gt;= 8.2.0"/>
+ <function name="pcntl_getcpu" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_getcpuaffinity" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_getqos_class" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_getpriority" from="PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_get_last_error" from="PHP 5 &gt;= 5.3.4, PHP 7, PHP 8"/>
  <function name="pcntl_rfork" from="PHP 8 &gt;= 8.1.0"/>
  <function name="pcntl_setcpuaffinity" from="PHP 8 &gt;= 8.4.0"/>
+ <function name="pcntl_setns" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_setpriority" from="PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_setqos_class" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_signal" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
@@ -27,6 +30,7 @@
  <function name="pcntl_waitpid" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_waitid" from="PHP 8 &gt;= 8.4.0"/>
  <function name="pcntl_wexitstatus" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
+ <function name="pcntl_wifcontinued" from="PHP 7, PHP 8"/>
  <function name="pcntl_wifexited" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_wifsignaled" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl_wifstopped" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
@@ -34,6 +38,7 @@
  <function name="pcntl_wtermsig" from="PHP 4 &gt;= 4.1.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pcntl\qosclass" from="PHP 8 &gt;= 8.4.0"/>
 </versions>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml