From ccee5b5c59c73ab991a70553591fcec41124b265 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 8 Sep 2026 09:34:51 +0200
Subject: [PATCH] [Sync-En] ext/intl: clarify Locale::getKeywords return values
 and empty locale

---
 reference/intl/locale/get-keywords.xml | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/reference/intl/locale/get-keywords.xml b/reference/intl/locale/get-keywords.xml
index dcfa198c38..075e1375b8 100644
--- a/reference/intl/locale/get-keywords.xml
+++ b/reference/intl/locale/get-keywords.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: d8de774ae203bccf3ffe02895d8c8fc754377451 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="locale.getkeywords" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -36,9 +36,11 @@
     <varlistentry>
      <term><parameter>locale</parameter></term>
      <listitem>
-      <para>
-       La configuración local de la cual extraer las palabras clave.
-      </para>
+      <simpara>
+       La configuración local de la cual extraer las palabras clave. Si se pasa
+       una cadena vacía, se utiliza en su lugar el valor devuelto por
+       <function>locale_get_default</function>.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -47,9 +49,11 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Un &array; asociativo que contiene los pares clave-valor para esta configuración local.
-  </para>
+  <simpara>
+   Un &array; asociativo que contiene los pares clave-valor para esta configuración
+   local, &null; si la configuración local no tiene palabras clave, o &false; en
+   caso de error.
+  </simpara>
   &intl.locale-len.return;
  </refsect1>
 
@@ -61,7 +65,7 @@
 <![CDATA[
 <?php
 $keywords_arr = locale_get_keywords('de_DE@currency=EUR;collation=PHONEBOOK');
-if ($keywords_arr) {
+if (is_array($keywords_arr)) {
     foreach ($keywords_arr as $key => $value) {
         echo "$key = $value\n";
     }
@@ -76,7 +80,7 @@ if ($keywords_arr) {
 <![CDATA[
 <?php
 $keywords_arr = Locale::getKeywords('de_DE@currency=EUR;collation=PHONEBOOK');
-if ($keywords_arr) {
+if (is_array($keywords_arr)) {
     foreach ($keywords_arr as $key => $value) {
         echo "$key = $value\n";
     }
@@ -99,6 +103,8 @@ currency = EUR
   <para>
    <simplelist>
     <member><function>locale_get_all_variants</function></member>
+    <member><function>locale_get_default</function></member>
+    <member><function>locale_set_default</function></member>
    </simplelist>
   </para>
  </refsect1>