From 2238d6194516d9a9fefb43e1e301554a92a95c78 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 20 Oct 2026 10:11:39 +0200
Subject: [PATCH] [Sync-En] DOM, GMP, OpenSSL and SysV semaphores: sync recent
 doc-en changes

---
 reference/dom/domdocument/loadxml.xml         | 20 +++++++----
 reference/gmp/functions/gmp-random-seed.xml   | 35 +++++++++----------
 .../functions/openssl-random-pseudo-bytes.xml | 10 ++++--
 reference/sem/functions/sem-get.xml           | 23 ++++++++----
 4 files changed, 53 insertions(+), 35 deletions(-)

diff --git a/reference/dom/domdocument/loadxml.xml b/reference/dom/domdocument/loadxml.xml
index 00b4359bb4..44ff54bade 100644
--- a/reference/dom/domdocument/loadxml.xml
+++ b/reference/dom/domdocument/loadxml.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 765749a26b620538117fff4425fafb3ed5834b54 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 587b7ec5ece08cb9feba0475d23fdfb28754b701 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="domdocument.loadxml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -51,12 +51,10 @@
  </refsect1>
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   Si se pasa una cadena vacía como argumento <parameter>source</parameter>,
-   se generará una advertencia. Esta advertencia no es generada
-   por libxml, y no puede ser gestionada utilizando las funciones de gestión
-   de errores de libxml.
-  </para>
+  <simpara>
+   Lanza una <exceptionname>ValueError</exceptionname> si <parameter>source</parameter>
+   es una cadena vacía.
+  </simpara>
  </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;
@@ -75,6 +73,14 @@
        Esta función tiene ahora un tipo de retorno <type>bool</type> provisional.
       </entry>
      </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Pasar una cadena vacía como <parameter>source</parameter> lanza ahora una
+       <exceptionname>ValueError</exceptionname>; anteriormente, se generaba un
+       <constant>E_WARNING</constant> y se devolvía &false;.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
diff --git a/reference/gmp/functions/gmp-random-seed.xml b/reference/gmp/functions/gmp-random-seed.xml
index ac9e0ec807..1d32b959d7 100644
--- a/reference/gmp/functions/gmp-random-seed.xml
+++ b/reference/gmp/functions/gmp-random-seed.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: b412bbd26214f7281ac7dd858710e09952a275f2 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: ea41e5c4e5b73512b59c76f6a45ea146a97667a9 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="function.gmp-random-seed" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -23,11 +22,10 @@
     <varlistentry>
      <term><parameter>seed</parameter></term>
      <listitem>
-      <para>
-       La semilla a definir para las funciones <function>gmp_random</function>,
-       <function>gmp_random_bits</function>, y
+      <simpara>
+       La semilla a definir para las funciones <function>gmp_random_bits</function> y
        <function>gmp_random_range</function>.
-      </para>
+      </simpara>
 
       &gmp.parameter;
      </listitem>
@@ -43,13 +41,13 @@
   </para>
  </refsect1>
 
- <refsect1 role="errors"><!-- {{{ -->
+ <refsect1 role="errors">
   &reftitle.errors;
   <para>
    Levanta una excepción <classname>ValueError</classname> si el
    argumento <parameter>seed</parameter> es inválido.
   </para>
- </refsect1><!-- }}} -->
+ </refsect1>
 
  <refsect1 role="changelog">
   &reftitle.changelog;
@@ -67,7 +65,7 @@
       <entry>
        Si el argumento <parameter>seed</parameter> es inválido, <function>gmp_random_seed</function>
        levanta una excepción <classname>ValueError</classname> a partir de ahora.
-       Anteriormente se emitía una advertencia <constant>E_WARNING</constant>.
+       Anteriormente se emitía una advertencia <constant>E_WARNING</constant> y se devolvía &false;.
       </entry>
      </row>
     </tbody>
@@ -86,25 +84,27 @@
 // definir la semilla
 gmp_random_seed(100);
 
-var_dump(gmp_strval(gmp_random(1)));
+var_dump(gmp_strval(gmp_random_bits(10)));
 
 // definir la semilla a otro valor
 gmp_random_seed(gmp_init(-100));
 
-var_dump(gmp_strval(gmp_random_bits(10)));
+var_dump(gmp_strval(gmp_random_range(0, 100)));
 
 // definir una semilla con un valor inválido
-var_dump(gmp_random_seed('not a number'));
+try {
+    gmp_random_seed('not a number');
+} catch (\ValueError $e) {
+    echo $e->getMessage(), PHP_EOL;
+}
 ]]>
     </programlisting>
     &example.outputs;
     <screen>
 <![CDATA[
-string(20) "15370156633245019617"
-string(3) "683"
-
-Warning: gmp_random_seed(): Unable to convert variable to GMP - string is not an integer in %s on line %d
-bool(false)
+string(3) "800"
+string(2) "32"
+gmp_random_seed(): Argument #1 ($seed) is not an integer string
 ]]>
     </screen>
    </example>
@@ -115,7 +115,6 @@ bool(false)
   &reftitle.seealso;
   <simplelist>
    <member><function>gmp_init</function></member>
-   <member><function>gmp_random</function></member>
    <member><function>gmp_random_bits</function></member>
    <member><function>gmp_random_range</function></member>
   </simplelist>
diff --git a/reference/openssl/functions/openssl-random-pseudo-bytes.xml b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
index 52e2463434..17a4264e71 100644
--- a/reference/openssl/functions/openssl-random-pseudo-bytes.xml
+++ b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 52c495140bdb84f45f186bfb1cccf09788b0121e Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 9666c3ea1febc91522ac52e02e692002413701f4 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.openssl-random-pseudo-bytes" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -22,7 +21,8 @@
   <para>
    Indica asimismo si el algoritmo fuerte de criptología ha sido utilizado para
    producir estos octetos pseudo-aleatorios, utilizando el argumento
-   <parameter>strong_result</parameter>.
+   <parameter>strong_result</parameter>. Es poco frecuente que sea &false;, pero algunos
+   sistemas pueden estar defectuosos o ser antiguos.
   </para>
  </refsect1>
 
@@ -65,6 +65,10 @@
   <para>
    <function>openssl_random_pseudo_bytes</function> lanza una <classname>Exception</classname> en caso de error.
   </para>
+  <simpara>
+   Lanza una <exceptionname>ValueError</exceptionname> si <parameter>length</parameter>
+   es inferior a <literal>1</literal>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">
diff --git a/reference/sem/functions/sem-get.xml b/reference/sem/functions/sem-get.xml
index 93975ee575..74117716cf 100644
--- a/reference/sem/functions/sem-get.xml
+++ b/reference/sem/functions/sem-get.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: fd2f14b2e44fbda6dd3f94a1d07f2bc9a7567aff Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: e1ed939373254ebf51ed7822d1a700eb4abeb3a1 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sem-get">
  <refnamediv>
@@ -57,7 +56,7 @@
     <listitem>
      <simpara>
       Los permisos del semáforo.
-      Actualmente, este valor solo se aplica
+      En realidad, este valor solo se aplica
       si el proceso es el único proceso actualmente
       adjunto al semáforo.
      </simpara>
@@ -68,7 +67,7 @@
     <listitem>
      <simpara>
       El argumento opcional <parameter>auto_release</parameter> especifica
-      si el semáforo debe ser liberado automáticamente al cerrar.
+      si el semáforo debe ser liberado automáticamente al finalizar la petición.
      </simpara>
     </listitem>
    </varlistentry>
@@ -78,7 +77,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Retorna un recurso de semáforo en caso de éxito, y &false; en caso de error.
+   Retorna un identificador de semáforo positivo en caso de éxito, y &false; en caso de error.
   </simpara>
  </refsect1>
 
@@ -97,8 +96,8 @@
       <entry>8.0.0</entry>
       <entry>
        En caso de éxito, esta función retorna una instancia de
-       <classname>SysvSemaphore</classname> ahora; anteriormente; un
-       <type>resource</type> era retornado.
+       <classname>SysvSemaphore</classname> ahora; anteriormente,
+       se retornaba un <type>resource</type>.
       </entry>
      </row>
      <row>
@@ -125,6 +124,16 @@
     semáforo.
    </simpara>
   </warning>
+  <warning>
+   <simpara>
+    Si <parameter>auto_release</parameter> está habilitado, las reservas
+    mantenidas por un objeto <classname>SysvSemaphore</classname> también se
+    liberan en cuanto el objeto es liberado, por ejemplo cuando la variable que
+    lo contiene es destruida con unset, sobrescrita o sale de ámbito, y no solo
+    al finalizar la petición. Conserve una referencia al objeto durante todo el
+    tiempo que el semáforo deba permanecer reservado.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="seealso">