From 8420c7c849e7ced8151b58ecd1d13cd20affeb06 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Wed, 21 Oct 2026 09:31:06 +0200
Subject: [PATCH] [Sync-En] openssl, dom: document the ValueError for length <
 1 and empty loadXML source

---
 reference/dom/domdocument/loadxml.xml         | 20 ++++++++++++-------
 .../functions/openssl-random-pseudo-bytes.xml |  9 +++++++--
 2 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/reference/dom/domdocument/loadxml.xml b/reference/dom/domdocument/loadxml.xml
index 00b4359bb4..5a4d6e8cc3 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>
+   Se 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 emitía un <constant>E_WARNING</constant>
+       y se devolvía &false;.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
diff --git a/reference/openssl/functions/openssl-random-pseudo-bytes.xml b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
index 52e2463434..ba638ee456 100644
--- a/reference/openssl/functions/openssl-random-pseudo-bytes.xml
+++ b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
@@ -1,6 +1,6 @@
 <?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 +22,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 raro que sea &false;, pero algunos
+   sistemas pueden estar dañados o ser antiguos.
   </para>
  </refsect1>
 
@@ -65,6 +66,10 @@
   <para>
    <function>openssl_random_pseudo_bytes</function> lanza una <classname>Exception</classname> en caso de error.
   </para>
+  <simpara>
+   Se lanza una <exceptionname>ValueError</exceptionname> si <parameter>length</parameter>
+   es inferior a <literal>1</literal>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">