From 7ebabcb5a56f8865db60cafe8d456b30ca38c947 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Thu, 10 Sep 2026 16:46:25 +0200
Subject: [PATCH] strpos: document that an empty needle matches at every
 position and returns the offset

---
 reference/strings/functions/strpos.xml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/reference/strings/functions/strpos.xml b/reference/strings/functions/strpos.xml
index d788148cfd9e..5d3d550e7433 100644
--- a/reference/strings/functions/strpos.xml
+++ b/reference/strings/functions/strpos.xml
@@ -35,9 +35,15 @@
     <varlistentry>
      <term><parameter>needle</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        The string to search for.
-      </para>
+      </simpara>
+      <simpara>
+       Passing an empty string as <parameter>needle</parameter> matches at
+       every position. <function>strpos</function> returns
+       <parameter>offset</parameter> when it is specified, or
+       <literal>0</literal> otherwise.
+      </simpara>
       &strings.parameter.needle.non-string;
      </listitem>
     </varlistentry>