From 124e06375b7e84d5ad90fe4349d8f89fc859fa13 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Wed, 2 Sep 2026 09:43:54 +0200
Subject: [PATCH] sync: clarify ValueError conditions in mb_*code_numericentity

Closes #1206
---
 .../mbstring/functions/mb-decode-numericentity.xml     | 10 +++++-----
 .../mbstring/functions/mb-encode-numericentity.xml     | 10 +++++-----
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/reference/mbstring/functions/mb-decode-numericentity.xml b/reference/mbstring/functions/mb-decode-numericentity.xml
index 9fe776c671..440dbd0196 100644
--- a/reference/mbstring/functions/mb-decode-numericentity.xml
+++ b/reference/mbstring/functions/mb-decode-numericentity.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4e69a9f2b14deefca0befec576335e33152448f3 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 3505aae96c190f3970e15bf3b7a12ead73b95662 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.mb-decode-numericentity" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mb_decode_numericentity</refname>
@@ -63,7 +62,8 @@
   &reftitle.errors;
   <simpara>
    Genera una excepción <exceptionname>ValueError</exceptionname> si
-   <parameter>map</parameter> no es una lista de &integer;s.
+   <parameter>map</parameter> contiene algún valor que no sea un
+   &integer;, &float;, &boolean;, &null;, o una <link linkend="language.types.numeric-strings">cadena numérica</link>.
   </simpara>
  </refsect1>
 
@@ -81,9 +81,9 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       <function>mb_decode_numericentity</function> ahora genera una
+       La función <function>mb_decode_numericentity</function> ahora genera una
        <exceptionname>ValueError</exceptionname> si <parameter>map</parameter>
-       no es una lista de &integer;s.
+       contiene algún valor que no pueda convertirse implícitamente a int.
       </entry>
      </row>
      &mbstring.changelog.encoding-nullable;
diff --git a/reference/mbstring/functions/mb-encode-numericentity.xml b/reference/mbstring/functions/mb-encode-numericentity.xml
index dd423dc56e..b216cc1067 100644
--- a/reference/mbstring/functions/mb-encode-numericentity.xml
+++ b/reference/mbstring/functions/mb-encode-numericentity.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a60ef65239113c7871643be68ada91081376c936 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 3505aae96c190f3970e15bf3b7a12ead73b95662 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.mb-encode-numericentity" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mb_encode_numericentity</refname>
@@ -74,7 +73,8 @@
   &reftitle.errors;
   <simpara>
    Lanza una <exceptionname>ValueError</exceptionname> si
-   <parameter>map</parameter> no es una lista de &integer;s.
+   <parameter>map</parameter> contiene algún valor que no sea un
+   &integer;, &float;, &boolean;, &null;, o una <link linkend="language.types.numeric-strings">cadena numérica</link>.
   </simpara>
  </refsect1>
 
@@ -92,9 +92,9 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       <function>mb_encode_numericentity</function> ahora lanza una
+       La función <function>mb_encode_numericentity</function> ahora lanza una
        <exceptionname>ValueError</exceptionname> si <parameter>map</parameter>
-       no es una lista de &integer;s.
+       contiene algún valor que no pueda convertirse implícitamente a int.
       </entry>
      </row>
      &mbstring.changelog.encoding-nullable;