[DOC-CVS] [doc-en] master: pcre: replace (see below) with xref for atomic groups (#5221)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-08-24T12:07:10+02:00

Commit: https://github.com/php/doc-en/commit/3e1cd2462664adb2495cff5887671ba8a9909cf9
Raw diff: https://github.com/php/doc-en/commit/3e1cd2462664adb2495cff5887671ba8a9909cf9.diff

pcre: replace (see below) with xref for atomic groups (#5221)

Replace the vague "see below" reference for atomic groups with an
explicit xref to the "Once-only subpatterns" section, which already
documents the concept in full. Also note in that section that
once-only subpatterns are also known as atomic groups.

Fixes #5126

Changed paths:
  M  reference/pcre/pattern.syntax.xml


Diff:

diff --git a/reference/pcre/pattern.syntax.xml b/reference/pcre/pattern.syntax.xml
index 9e832051bc79..c87e73c4804e 100644
--- a/reference/pcre/pattern.syntax.xml
+++ b/reference/pcre/pattern.syntax.xml
@@ -1052,15 +1052,15 @@
    composed character, regardless of how many individual characters are
    actually used to render it.
   </para>
-  <para>
+  <simpara>
    In versions of PCRE older than 8.32 (which corresponds to PHP versions
    before 5.4.14 when using the bundled PCRE library), <literal>\X</literal>
    is equivalent to <literal>(?>\PM\pM*)</literal>. That is, it matches a
    character without the "mark" property, followed by zero or more characters
    with the "mark" property, and treats the sequence as an atomic group (see
-   below). Characters with the "mark" property are typically accents that
-   affect the preceding character.
-  </para>
+   <xref linkend="regexp.reference.onlyonce"/>). Characters with the "mark"
+   property are typically accents that affect the preceding character.
+  </simpara>
   <para>
    Matching characters by Unicode property is not fast, because PCRE has
    to search a structure that contains data for over fifteen thousand
@@ -1987,6 +1987,9 @@
 
  <section xml:id="regexp.reference.onlyonce">
   <title>Once-only subpatterns</title>
+  <simpara>
+   Once-only subpatterns are also known as <emphasis>atomic groups</emphasis>.
+  </simpara>
   <para>
    With both maximizing and minimizing repetition, failure of
    what follows normally causes the repeated item to be