From 46d77a56962010b20cb0cdc084c903747000fa8e Mon Sep 17 00:00:00 2001
From: qodelicious <162776175+qodelicious@users.noreply.github.com>
Date: Mon, 19 Oct 2026 00:13:21 +0000
Subject: [PATCH] openssl_random_pseudo_bytes(): document the ValueError for
 length < 1

Fixes #1523
---
 reference/openssl/functions/openssl-random-pseudo-bytes.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/openssl/functions/openssl-random-pseudo-bytes.xml b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
index 923ece93b869..9b5c1969511e 100644
--- a/reference/openssl/functions/openssl-random-pseudo-bytes.xml
+++ b/reference/openssl/functions/openssl-random-pseudo-bytes.xml
@@ -64,6 +64,10 @@
    <function>openssl_random_pseudo_bytes</function> throws an <classname>Exception</classname>
    on failure.
   </para>
+  <simpara>
+   Throws a <exceptionname>ValueError</exceptionname> if <parameter>length</parameter>
+   is less than <literal>1</literal>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">