From 4d4bc5d8a22b2e7780a4094533acfe4a47cb180d Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 31 Aug 2026 13:17:12 +0200
Subject: [PATCH 1/3] simplexml: document that get methods and string casts no
 longer implicitly rewind

---
 reference/simplexml/simplexmlelement.xml      | 22 +++++++++++++------
 .../simplexml/simplexmlelement/rewind.xml     | 13 ++++++++++-
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/reference/simplexml/simplexmlelement.xml b/reference/simplexml/simplexmlelement.xml
index 67c240b5bb..5062858df7 100644
--- a/reference/simplexml/simplexmlelement.xml
+++ b/reference/simplexml/simplexmlelement.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="class.simplexmlelement" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Класс SimpleXMLElement</title>
@@ -39,12 +39,8 @@
     </oointerface>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.simplexmlelement')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SimpleXMLElement'])">
-     <xi:fallback/>
-    </xi:include>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.simplexmlelement')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SimpleXMLElement'])">
-     <xi:fallback/>
-    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.simplexmlelement')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SimpleXMLElement'])"/>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.simplexmlelement')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SimpleXMLElement'])"/>
    </classsynopsis>
 <!-- }}} -->
 
@@ -61,6 +57,18 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Методы получения данных, например
+        <methodname>SimpleXMLElement::asXML</methodname> или
+        <methodname>SimpleXMLElement::getName</methodname>, и приведение
+        объекта класса <classname>SimpleXMLElement</classname> к строке
+        (&string;) больше не перематывают итератор неявно.
+        Теперь итератор при необходимости перематывают явно — методом
+        <methodname>SimpleXMLElement::rewind</methodname>.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
diff --git a/reference/simplexml/simplexmlelement/rewind.xml b/reference/simplexml/simplexmlelement/rewind.xml
index e0fcd3ee55..1a4c425f66 100644
--- a/reference/simplexml/simplexmlelement/rewind.xml
+++ b/reference/simplexml/simplexmlelement/rewind.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dcb657b7e9e4f7622ce3394ae1fa3c14538721e1 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="simplexmlelement.rewind" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -23,6 +23,17 @@
   <para>
    Метод перематывает <classname>SimpleXMLElement</classname> к первому элементу.
   </para>
+
+  <note>
+   <simpara>
+    Начиная с PHP 8.4.0 вызов методов получения данных, например
+    <methodname>SimpleXMLElement::asXML</methodname> или
+    <methodname>SimpleXMLElement::getName</methodname>, и приведение
+    объекта класса <classname>SimpleXMLElement</classname> к строке
+    (&string;) больше не перематывают итератор неявно. При необходимости
+    итератор перематывают явно вызовом этого метода.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">

From 0e0309546089a104bc7666c8d7208ee8251f1d67 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Tue, 22 Sep 2026 01:45:42 +0300
Subject: [PATCH 2/3] Update rewind.xml

---
 .../simplexml/simplexmlelement/rewind.xml     | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/reference/simplexml/simplexmlelement/rewind.xml b/reference/simplexml/simplexmlelement/rewind.xml
index 1a4c425f66..148e8b3f8e 100644
--- a/reference/simplexml/simplexmlelement/rewind.xml
+++ b/reference/simplexml/simplexmlelement/rewind.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="simplexmlelement.rewind" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>SimpleXMLElement::rewind</refname>
-  <refpurpose>Перемотка к первому элементу</refpurpose>
+  <refpurpose>Перематывает итератор к первому элементу</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -15,23 +15,23 @@
 
   <warning>
    <simpara>
-    До версии PHP 8.0 метод <methodname>SimpleXMLElement::rewind</methodname>
-    был объявлен только для дочернего класса <classname>SimpleXMLIterator</classname>.
+    До PHP 8.0 метод <methodname>SimpleXMLElement::rewind</methodname>
+    объявлялся только для подкласса <classname>SimpleXMLIterator</classname>.
    </simpara>
   </warning>
 
   <para>
-   Метод перематывает <classname>SimpleXMLElement</classname> к первому элементу.
+   Метод перематывает объект <classname>SimpleXMLElement</classname> к первому элементу.
   </para>
 
   <note>
    <simpara>
-    Начиная с PHP 8.4.0 вызов методов получения данных, например
-    <methodname>SimpleXMLElement::asXML</methodname> или
-    <methodname>SimpleXMLElement::getName</methodname>, и приведение
-    объекта класса <classname>SimpleXMLElement</classname> к строке
-    (&string;) больше не перематывают итератор неявно. При необходимости
-    итератор перематывают явно вызовом этого метода.
+    Начиная с PHP 8.4.0 вызов методов получения данных наподобие
+    <methodname>SimpleXMLElement::asXML</methodname>
+    и <methodname>SimpleXMLElement::getName</methodname>
+    или приведение объекта <classname>SimpleXMLElement</classname> к типу
+    &string; больше не перематывают итератор неявно. Итератор
+    перематывают явно вызовом этого метода.
    </simpara>
   </note>
  </refsect1>
@@ -52,15 +52,15 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Перемотка к первому элементу</title>
+    <title>Пример перемотки итератора к первому элементу</title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $xmlElement = new SimpleXMLElement('<books><book>PHP Basics</book><book>XML Basics</book></books>');
 $xmlElement->rewind();
 
 var_dump($xmlElement->current());
-?>
 ]]>
     </programlisting>
     &example.outputs;

From 49fdc612b3bc8e3bcc166c74a187d4d1c076aa55 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@gmail.com>
Date: Tue, 22 Sep 2026 01:46:59 +0300
Subject: [PATCH 3/3] Update simplexmlelement.xml

---
 reference/simplexml/simplexmlelement.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/simplexml/simplexmlelement.xml b/reference/simplexml/simplexmlelement.xml
index 5062858df7..4a80386730 100644
--- a/reference/simplexml/simplexmlelement.xml
+++ b/reference/simplexml/simplexmlelement.xml
@@ -60,12 +60,12 @@
       <row>
        <entry>8.4.0</entry>
        <entry>
-        Методы получения данных, например
-        <methodname>SimpleXMLElement::asXML</methodname> или
-        <methodname>SimpleXMLElement::getName</methodname>, и приведение
-        объекта класса <classname>SimpleXMLElement</classname> к строке
-        (&string;) больше не перематывают итератор неявно.
-        Теперь итератор при необходимости перематывают явно — методом
+        Методы получения данных наподобие
+        <methodname>SimpleXMLElement::asXML</methodname>
+        и <methodname>SimpleXMLElement::getName</methodname>
+        или приведение объекта <classname>SimpleXMLElement</classname> к типу
+        &string; больше не перематывают итератор неявно.
+        Итератор перематывают явно вызовом метода
         <methodname>SimpleXMLElement::rewind</methodname>.
        </entry>
       </row>