From b940c2a8705a5a2086ee0b2c5a7dcef01be23270 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud Catoire <la.catoire@gmail.com>
Date: Tue, 23 Dec 2025 13:41:12 +0100
Subject: [PATCH 1/2] intl: document Locale::isRightToLeft (PHP 8.5)

---
 reference/intl/locale.xml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/reference/intl/locale.xml b/reference/intl/locale.xml
index 34897d9bcaa5..8f355e5e69b5 100644
--- a/reference/intl/locale.xml
+++ b/reference/intl/locale.xml
@@ -46,6 +46,34 @@
   </section>
   <!-- }}} -->
 
+  <section xml:id="locale.isrighttoleft">
+   <title>Locale::isRightToLeft</title>
+
+   <para>
+    As of PHP 8.5, the <methodname>Locale::isRightToLeft</methodname> method
+    can be used to determine whether a locale uses a right-to-left writing
+    system.
+   </para>
+
+   <para>
+    This method relies on the ICU library and evaluates the dominant script
+    associated with the locale.
+   </para>
+
+   <para>
+    If an empty string is provided, the default locale is used.
+   </para>
+
+   <example>
+    <title>Checking text direction for a locale</title>
+    <programlisting><![CDATA[
+var_dump(Locale::isRightToLeft('en-US')); // bool(false)
+var_dump(Locale::isRightToLeft('ar'));    // bool(true)
+]]></programlisting>
+   </example>
+  </section>
+
+
   <section xml:id="locale.synopsis">
    &reftitle.classsynopsis;
 

From af53fa1c789d9c5486e981a03df98b3282f81897 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud Catoire <la.catoire@gmail.com>
Date: Tue, 6 Jan 2026 17:16:13 +0100
Subject: [PATCH 2/2] Add Locale::isRightToLeft method documentation

---
 reference/intl/locale.xml               |  28 -------
 reference/intl/locale/isrighttoleft.xml | 101 ++++++++++++++++++++++++
 2 files changed, 101 insertions(+), 28 deletions(-)
 create mode 100644 reference/intl/locale/isrighttoleft.xml

diff --git a/reference/intl/locale.xml b/reference/intl/locale.xml
index 8f355e5e69b5..34897d9bcaa5 100644
--- a/reference/intl/locale.xml
+++ b/reference/intl/locale.xml
@@ -46,34 +46,6 @@
   </section>
   <!-- }}} -->
 
-  <section xml:id="locale.isrighttoleft">
-   <title>Locale::isRightToLeft</title>
-
-   <para>
-    As of PHP 8.5, the <methodname>Locale::isRightToLeft</methodname> method
-    can be used to determine whether a locale uses a right-to-left writing
-    system.
-   </para>
-
-   <para>
-    This method relies on the ICU library and evaluates the dominant script
-    associated with the locale.
-   </para>
-
-   <para>
-    If an empty string is provided, the default locale is used.
-   </para>
-
-   <example>
-    <title>Checking text direction for a locale</title>
-    <programlisting><![CDATA[
-var_dump(Locale::isRightToLeft('en-US')); // bool(false)
-var_dump(Locale::isRightToLeft('ar'));    // bool(true)
-]]></programlisting>
-   </example>
-  </section>
-
-
   <section xml:id="locale.synopsis">
    &reftitle.classsynopsis;
 
diff --git a/reference/intl/locale/isrighttoleft.xml b/reference/intl/locale/isrighttoleft.xml
new file mode 100644
index 000000000000..09c274754f8b
--- /dev/null
+++ b/reference/intl/locale/isrighttoleft.xml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<refentry xml:id="locale.isrighttoleft"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink">
+
+ <refnamediv>
+  <refname>Locale::isRightToLeft</refname>
+  <refpurpose>Check whether a locale uses a right-to-left writing system</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+
+  <para>
+   &style.oop;
+  </para>
+
+  <methodsynopsis role="Locale">
+   <modifier>public</modifier>
+   <modifier>static</modifier>
+   <type>bool</type>
+   <methodname>Locale::isRightToLeft</methodname>
+   <methodparam choice="opt">
+    <type>string</type><parameter>locale</parameter>
+    <initializer>""</initializer>
+   </methodparam>
+  </methodsynopsis>
+
+  <para>
+   Determines whether a locale uses a right-to-left writing system.
+  </para>
+
+  <para>
+   This method relies on the ICU library and evaluates the dominant script
+   associated with the locale.
+  </para>
+
+  <para>
+   If an empty string is provided, the default locale is used.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>locale</parameter></term>
+     <listitem>
+      <para>
+       The locale identifier. If empty, the default locale is used.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns <constant>true</constant> if the locale uses a right-to-left
+   writing system, or <constant>false</constant> otherwise.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>PHP 8.5.0</entry>
+      <entry>
+       Added <methodname>Locale::isRightToLeft</methodname>.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Checking text direction for a locale</title>
+   <programlisting><![CDATA[
+var_dump(Locale::isRightToLeft('en-US')); // bool(false)
+var_dump(Locale::isRightToLeft('ar'));    // bool(true)
+]]></programlisting>
+  </example>
+ </refsect1>
+
+</refentry>