ext/simplexml: Document that get methods and string casts no longer implicitly rewind (#5737)

Author: lacatoire

reference/simplexml/simplexmlelement.xml

@@ -56,6 +56,18 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Get methods (such as
+        <methodname>SimpleXMLElement::asXML</methodname> or
+        <methodname>SimpleXMLElement::getName</methodname>) and casting a
+        <classname>SimpleXMLElement</classname> to a &string; no longer
+        implicitly rewind the iterator.
+        The iterator must now be rewound explicitly, using
+        <methodname>SimpleXMLElement::rewind</methodname>, where needed.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

reference/simplexml/simplexmlelement/rewind.xml

@@ -22,6 +22,17 @@
   <para>
    This method rewinds the <classname>SimpleXMLElement</classname> to the first element.
   </para>
+
+  <note>
+   <simpara>
+    As of PHP 8.4.0, calling get methods (such as
+    <methodname>SimpleXMLElement::asXML</methodname> or
+    <methodname>SimpleXMLElement::getName</methodname>) or casting a
+    <classname>SimpleXMLElement</classname> to a &string; no longer
+    implicitly rewinds the iterator. Where required, the iterator must be
+    rewound explicitly by calling this method.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">