[DOC-CVS] [doc-en] master: Move default flag clarification to top of flags description (#4831) (#5224)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2026-01-30T10:29:19Z

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

Move default flag clarification to top of flags description (#4831) (#5224)

The note about PREG_PATTERN_ORDER being the default was buried at the
end of the flags list, making it easy to miss.

Changed paths:
  M  reference/pcre/functions/preg-match-all.xml


Diff:

diff --git a/reference/pcre/functions/preg-match-all.xml b/reference/pcre/functions/preg-match-all.xml
index cc71d88c5f5e..d5387b6952f1 100644
--- a/reference/pcre/functions/preg-match-all.xml
+++ b/reference/pcre/functions/preg-match-all.xml
@@ -60,6 +60,10 @@
     <varlistentry>
      <term><parameter>flags</parameter></term>
      <listitem>
+      <simpara>
+       If no order flag is given, <constant>PREG_PATTERN_ORDER</constant> is
+       assumed.
+      </simpara>
       <para>
        Can be a combination of the following flags (note that it doesn't make
        sense to use <constant>PREG_PATTERN_ORDER</constant> together with
@@ -246,10 +250,6 @@ Array
         </varlistentry>  
        </variablelist>
       </para>
-      <para>
-       If no order flag is given, <constant>PREG_PATTERN_ORDER</constant> is
-       assumed.
-      </para>
      </listitem>
     </varlistentry>
     <varlistentry>