From 44f1f2cfd6791b7eec92093ab7c939564722b810 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20Porto=20Mari=C3=B1o?= <php@marcospor.to>
Date: Thu, 11 Dec 2025 15:10:03 +0100
Subject: [PATCH 1/3] DateTimeZone::listIdentifiers improvements

---
 .../datetime/datetimezone/listidentifiers.xml | 42 ++++++++++++-------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/reference/datetime/datetimezone/listidentifiers.xml b/reference/datetime/datetimezone/listidentifiers.xml
index 097406c4a..15ae139c2 100644
--- a/reference/datetime/datetimezone/listidentifiers.xml
+++ b/reference/datetime/datetimezone/listidentifiers.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: c018a4d2c85ac429f238f78679eca46d86c63a31 Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no Maintainer: Marqitos -->
 <refentry xml:id="datetimezone.listidentifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTimeZone::listIdentifiers</refname>
@@ -22,6 +22,18 @@
    <methodparam choice="opt"><type>int</type><parameter>timezoneGroup</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>countryCode</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
+  <simpara>
+   Devuelve la lista de <link xlink:href="&url.wiki.tzdb.names;">identificadores de zona horaria de IANA</link>.
+  </simpara>
+
+  <note>
+   <simpara>
+    Es posible detectar la zona horaria del cliente (navegador) con JavaScript usando
+    <link xlink:href="&url.js.intl-datetimeformat;">Intl.DateTimeFormat</link> o
+    <link xlink:href="&url.js.temporal-zoneddatetime;">Temporal.ZonedDateTime</link>.
+   </simpara>
+  </note>
+
  </refsect1>
 
  <refsect1 role="parameters">
@@ -100,25 +112,28 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Ejemplo con <methodname>DateTimeZone::listIdentifiers</methodname></title>
+    <title>Lista de identificadores con comentarios de ubicación</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-$timezone_identifiers = DateTimeZone::listIdentifiers();
-for ($i=0; $i < 5; $i++) {
-    echo "$timezone_identifiers[$i]\n";
+$identifiers = DateTimeZone::listIdentifiers(DateTimeZone::ALL);
+
+foreach ($identifiers as $tzid) {
+    $tz = new DateTimeZone($tzid);
+    $comments = $tz->getLocation()['comments'];
+    echo $tzid . " (" . ($comments ?: 'Toda la región') . ")\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
     <screen>
 <![CDATA[
-Africa/Abidjan
-Africa/Accra
-Africa/Addis_Ababa
-Africa/Algiers
-Africa/Asmara
+America/Antigua (Toda la región)
+America/Araguaina (Tocantins)
+America/Argentina/Buenos_Aires (Buenos Aires (BA, CF))
+America/Argentina/Catamarca (Catamarca (CT), Chubut (CH))
+America/Argentina/Cordoba (Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF))
+// (Salida recortada debido a la longitud)
 ]]>
     </screen>
    </example>
@@ -133,7 +148,6 @@ $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA );
 for ($i=0; $i < 5; $i++) {
     echo "$timezone_identifiers[$i]\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
@@ -157,7 +171,6 @@ Asia/Aqtau
 <?php
 $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA | DateTimeZone::PACIFIC );
 echo join( ', ', $timezone_identifiers );
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
@@ -204,7 +217,6 @@ $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::PER_COUNTRY
 foreach( $timezone_identifiers as $identifier ) {
     echo "$identifier\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;

From b9ec0350f47f82441d3f327da2811e9c132390c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20Porto=20Mari=C3=B1o?= <php@marcospor.to>
Date: Thu, 11 Dec 2025 15:23:31 +0100
Subject: [PATCH 2/3] Document key_length param deprecation in
 openssl_pkey_derive

---
 .../openssl/functions/openssl-pkey-derive.xml | 32 ++++++++++++++++---
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/reference/openssl/functions/openssl-pkey-derive.xml b/reference/openssl/functions/openssl-pkey-derive.xml
index 8e025921d..1f121d656 100644
--- a/reference/openssl/functions/openssl-pkey-derive.xml
+++ b/reference/openssl/functions/openssl-pkey-derive.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7fd8e591b8b5a35eda6a0fa6cdecd2a83b195920 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: af71bd1bd3bb0604c7bb3d2ff12019480c842843 Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no Maintainer: Marqitos -->
 <refentry xml:id="function.openssl-pkey-derive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>openssl_pkey_derive</refname>
@@ -50,9 +50,9 @@
      </para>
      <caution>
       <simpara>
-       Este parámetro no debe utilizarse, ya que no funciona como se espera. Nunca devuelve un secreto
-       más largo que el tamaño del primero. Si la longitud deseada es menor que el tamaño del
-       primero, solo trunca la longitud para claves ECDH pero falla para claves DH.
+       Este parámetro está obsoleto y no debe utilizarse, ya que no funciona como se espera. Nunca devuelve un secreto
+       más largo que el tamaño del primero Si la longitud deseada es menor que
+       el tamaño del primero, trunca la longitud solo para las claves ECDH, pero falla para las claves DH.
       </simpara>
      </caution>
     </listitem>
@@ -67,6 +67,28 @@
   </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.5.0</entry>
+      <entry>
+       El parámetro <parameter>key_length</parameter> ahora está obsoleto.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

From 16b27f4f68fa1d43f8ed50440e1f4d1a0aff5294 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20Porto=20Mari=C3=B1o?= <php@marcospor.to>
Date: Thu, 11 Dec 2025 15:26:47 +0100
Subject: [PATCH 3/3] XMLWriter: Change setIndent as it expects a boolean

---
 reference/xmlwriter/xmlwriter/setindent.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/xmlwriter/xmlwriter/setindent.xml b/reference/xmlwriter/xmlwriter/setindent.xml
index 74969e47d..03ad0c673 100644
--- a/reference/xmlwriter/xmlwriter/setindent.xml
+++ b/reference/xmlwriter/xmlwriter/setindent.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4a742792da6fd1ba27acd118bfeeed326c8d9aaf Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes Maintainer: PhilDaiguille -->
+<!-- EN-Revision: 78a71e92ebbf67a604e2225e2d005ac7b9559610 Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no Maintainer: Marqitos -->
 <refentry xml:id="xmlwriter.setindent" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLWriter::setIndent</refname>
@@ -78,7 +78,7 @@
 <?php
 $writer = new XMLWriter();
 $writer->openMemory();
-$writer->setIndent(2);
+$writer->setIndent(true);
 $writer->startDocument();
 $writer->startElement('p');
 $writer->text('before');