From 99bebe1c0a8870953f22b3d11ebf5e842b4fa4a8 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Wed, 21 Oct 2026 09:32:36 +0200
Subject: [PATCH] [Sync-En] gmp, image: update gmp_random_seed example for PHP
 8 and explain imagepng filters with system libgd

---
 reference/gmp/functions/gmp-random-seed.xml | 34 ++++++++++-----------
 reference/image/functions/imagepng.xml      | 11 ++++---
 2 files changed, 24 insertions(+), 21 deletions(-)

diff --git a/reference/gmp/functions/gmp-random-seed.xml b/reference/gmp/functions/gmp-random-seed.xml
index ac9e0ec80..6440c9718 100644
--- a/reference/gmp/functions/gmp-random-seed.xml
+++ b/reference/gmp/functions/gmp-random-seed.xml
@@ -1,6 +1,6 @@
 <?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 +23,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 +42,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 +66,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 un <constant>E_WARNING</constant> y se devolvía &false;.
       </entry>
      </row>
     </tbody>
@@ -86,25 +85,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 +116,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/image/functions/imagepng.xml b/reference/image/functions/imagepng.xml
index 854ce16e3..9638427dc 100644
--- a/reference/image/functions/imagepng.xml
+++ b/reference/image/functions/imagepng.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a1628012b48b8f21553ca6e2cefe65d038221042 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xml:id="function.imagepng" xmlns="http://docbook.org/ns/docbook">
@@ -44,7 +44,7 @@
      <listitem>
       <para>
        Grado de compresión: desde 0 (ninguna compresión) hasta 9.
-       El valor por omisión (<literal>-1</literal>) utiliza la compresión por omisión de zlib.
+       El valor predeterminado (<literal>-1</literal>) utiliza la compresión predeterminada de zlib.
        Para más información ver el <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.zlib.manual;">manual zlib</link>.
       </para>
      </listitem>
@@ -59,11 +59,14 @@
        <constant>PNG_NO_FILTER</constant> o
        <constant>PNG_ALL_FILTERS</constant> pueden ser utilizados
        para, respectivamente, desactivar o activar todos los filtros.
-       El valor por omisión (<literal>-1</literal>) desactiva el filtrado.
+       El valor predeterminado (<literal>-1</literal>) desactiva el filtrado.
       </para>
       <caution>
        <simpara>
-        El argumento <parameter>filters</parameter> es ignorado por la libgd del sistema.
+        El argumento <parameter>filters</parameter> solo tiene efecto cuando PHP
+        utiliza la libgd integrada. Se ignora cuando PHP se compila con la
+        libgd del sistema. Consulte <constant>GD_BUNDLED</constant> o
+        <function>gd_info</function> para saber cuál se está utilizando.
        </simpara>
       </caution>
      </listitem>