From 7cc9d5a5b401cad9db17e5bcf376a46d3e2dbd0d Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Fri, 17 Jul 2026 09:52:52 +0200
Subject: [PATCH] Sync ext/dom: document the new Dom\ParentNode $children
 property (PHP 8.5)

---
 reference/dom/dom/dom-document.xml         | 14 ++++++++++--
 reference/dom/dom/dom-documentfragment.xml | 14 ++++++++++--
 reference/dom/dom/dom-element.xml          | 13 ++++++++++-
 reference/dom/dom/dom-parentnode.xml       | 26 ++++++++++++++++++++--
 4 files changed, 60 insertions(+), 7 deletions(-)

diff --git a/reference/dom/dom/dom-document.xml b/reference/dom/dom/dom-document.xml
index 9cc79c9b54..338f06bb5e 100644
--- a/reference/dom/dom/dom-document.xml
+++ b/reference/dom/dom/dom-document.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: lacatoire Status: ready -->
 <reference xml:id="class.dom-document" 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>La classe Dom\Document</title>
  <titleabbrev>Dom\Document</titleabbrev>
@@ -105,6 +104,12 @@
      <type>int</type>
      <varname linkend="dom-document.props.childelementcount">childElementCount</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
+     <type>Dom\HTMLCollection</type>
+     <varname linkend="dom-document.props.children">children</varname>
+    </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type class="union"><type>Dom\HTMLElement</type><type>null</type></type>
@@ -211,6 +216,11 @@
       <xi:fallback/>
      </xi:include>
     </varlistentry>
+    <varlistentry xml:id="dom-document.props.children">
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.props.children')/*)">
+      <xi:fallback/>
+     </xi:include>
+    </varlistentry>
     <varlistentry xml:id="dom-document.props.body">
      <term><varname>body</varname></term>
      <listitem>
diff --git a/reference/dom/dom/dom-documentfragment.xml b/reference/dom/dom/dom-documentfragment.xml
index fc93fa08bc..119afa435c 100644
--- a/reference/dom/dom/dom-documentfragment.xml
+++ b/reference/dom/dom/dom-documentfragment.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: lacatoire Status: ready -->
 <reference xml:id="class.dom-documentfragment" 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>La classe Dom\DocumentFragment</title>
  <titleabbrev>Dom\DocumentFragment</titleabbrev>
@@ -61,6 +60,12 @@
      <type>int</type>
      <varname linkend="dom-documentfragment.props.childelementcount">childElementCount</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
+     <type>Dom\HTMLCollection</type>
+     <varname linkend="dom-documentfragment.props.children">children</varname>
+    </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
@@ -99,6 +104,11 @@
       <xi:fallback/>
      </xi:include>
     </varlistentry>
+    <varlistentry xml:id="dom-documentfragment.props.children">
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.props.children')/*)">
+      <xi:fallback/>
+     </xi:include>
+    </varlistentry>
    </variablelist>
   </section>
 
diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index c539862c00..419853e61c 100644
--- a/reference/dom/dom/dom-element.xml
+++ b/reference/dom/dom/dom-element.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9a5e44a0cadb280477b8341294db85c215eea827 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: lacatoire Status: ready -->
 <reference xml:id="class.dom-element" 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>La classe Dom\Element</title>
  <titleabbrev>Dom\Element</titleabbrev>
@@ -121,6 +121,12 @@
      <type class="union"><type>Dom\Element</type><type>null</type></type>
      <varname linkend="dom-element.props.nextelementsibling">nextElementSibling</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
+     <type>Dom\HTMLCollection</type>
+     <varname linkend="dom-element.props.children">children</varname>
+    </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type>string</type>
@@ -236,6 +242,11 @@
       <xi:fallback/>
      </xi:include>
     </varlistentry>
+    <varlistentry xml:id="dom-element.props.children">
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.props.children')/*)">
+      <xi:fallback/>
+     </xi:include>
+    </varlistentry>
     <varlistentry xml:id="dom-element.props.innerhtml">
      <term><varname>innerHTML</varname></term>
      <listitem>
diff --git a/reference/dom/dom/dom-parentnode.xml b/reference/dom/dom/dom-parentnode.xml
index 5ee3c5356a..06d57cca39 100644
--- a/reference/dom/dom/dom-parentnode.xml
+++ b/reference/dom/dom/dom-parentnode.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: lacatoire Status: ready -->
 <reference xml:id="class.dom-parentnode" 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>L'interface Dom\ParentNode</title>
  <titleabbrev>Dom\ParentNode</titleabbrev>
@@ -23,6 +22,14 @@
      <interfacename>Dom\ParentNode</interfacename>
     </oointerface>
 
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
+     <type>Dom\HTMLCollection</type>
+     <varname linkend="dom-parentnode.props.children">children</varname>
+    </fieldsynopsis>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-parentnode')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\ParentNode'])">
      <xi:fallback/>
@@ -31,6 +38,21 @@
 
   </section>
 
+  <section xml:id="dom-parentnode.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="dom-parentnode.props.children">
+     <term><varname>children</varname></term>
+     <listitem>
+      <simpara>
+       Une <classname>Dom\HTMLCollection</classname> contenant tous les éléments
+       enfants de ce nœud. Disponible à partir de PHP 8.5.0.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
  </partintro>
 
  &reference.dom.dom.entities.parentnode;