From a876e6d766548c830747e31b2c5215f2f08ffacb Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 20 Jul 2026 11:19:24 +0200
Subject: [PATCH 1/2] [Sync EN] Document the new Dom\ParentNode $children
 property (PHP 8.5)

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

diff --git a/reference/dom/dom/dom-document.xml b/reference/dom/dom/dom-document.xml
index 8d7ef133d9..9956f18c21 100644
--- a/reference/dom/dom/dom-document.xml
+++ b/reference/dom/dom/dom-document.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <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>Класс Dom\Document</title>
@@ -105,6 +105,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>
@@ -204,6 +210,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')/*)" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <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 7ff3172e46..26b8358465 100644
--- a/reference/dom/dom/dom-documentfragment.xml
+++ b/reference/dom/dom/dom-documentfragment.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <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>Класс Dom\DocumentFragment</title>
@@ -61,6 +61,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;']]))">
@@ -93,6 +99,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')/*)" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback/>
+     </xi:include>
+    </varlistentry>
    </variablelist>
   </section>
 
diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index f162d590f6..c3742611ad 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: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <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>Класс Dom\Element</title>
@@ -122,6 +122,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>
@@ -226,6 +232,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')/*)" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <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 096b27aadb..34af33b161 100644
--- a/reference/dom/dom/dom-parentnode.xml
+++ b/reference/dom/dom/dom-parentnode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <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>Интерфейс Dom\ParentNode</title>
@@ -23,6 +23,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 +39,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>
+       A <classname>Dom\HTMLCollection</classname> containing all child
+       elements of this node. Available as of PHP 8.5.0.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
  </partintro>
 
  &reference.dom.dom.entities.parentnode;

From b8baa9bf948cb664a9da961fb8f1ba1f8905b2ba Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 20 Jul 2026 14:31:38 +0200
Subject: [PATCH 2/2] fix(dom-element): add missing outerHTML fieldsynopsis and
 varlistentry

---
 reference/dom/dom/dom-element.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index c3742611ad..2fab9e2908 100644
--- a/reference/dom/dom/dom-element.xml
+++ b/reference/dom/dom/dom-element.xml
@@ -133,6 +133,11 @@
      <type>string</type>
      <varname linkend="dom-element.props.innerhtml">innerHTML</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>string</type>
+     <varname linkend="dom-element.props.outerhtml">outerHTML</varname>
+    </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type>string</type>
@@ -243,6 +248,14 @@
       <simpara>Внутренний HTML (или XML для XML-документов) элемента.</simpara>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="dom-element.props.outerhtml">
+     <term><varname>outerHTML</varname></term>
+     <listitem>
+      <simpara>
+       Внешний HTML (или XML для XML-документов) элемента, включая сам элемент. Доступно начиная с PHP 8.5.0.
+      </simpara>
+     </listitem>
+    </varlistentry>
     <varlistentry xml:id="dom-element.props.substitutednodevalue">
      <term><varname>substitutedNodeValue</varname></term>
      <listitem>