From 01e9931e7e6e734bdc2bafb25dd5cf252648717c Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 20 Jul 2026 11:22:57 +0200
Subject: [PATCH 1/4] [Sync EN] Document Dom\\Element::$outerHTML property (PHP
 8.5)

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

diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index f162d590f6..6bd63f70a6 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>
@@ -127,6 +127,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>
@@ -232,6 +237,15 @@
       <simpara>Внутренний HTML (или XML для XML-документов) элемента.</simpara>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="dom-element.props.outerhtml">
+     <term><varname>outerHTML</varname></term>
+     <listitem>
+      <simpara>
+       The outer HTML (or XML for XML documents) of the element, including the
+       element itself. Available as of PHP 8.5.0.
+      </simpara>
+     </listitem>
+    </varlistentry>
     <varlistentry xml:id="dom-element.props.substitutednodevalue">
      <term><varname>substitutedNodeValue</varname></term>
      <listitem>

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

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

diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index 6bd63f70a6..ea83944c4e 100644
--- a/reference/dom/dom/dom-element.xml
+++ b/reference/dom/dom/dom-element.xml
@@ -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>
@@ -231,6 +237,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>

From 2712f9e0c76e3b7bb6132772e700b7a176c3f79d Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 20 Jul 2026 14:33:48 +0200
Subject: [PATCH 3/4] fix(dom-element): replace xi:include with direct term for
 children property

---
 reference/dom/dom/dom-element.xml | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index ea83944c4e..bb312732fd 100644
--- a/reference/dom/dom/dom-element.xml
+++ b/reference/dom/dom/dom-element.xml
@@ -238,9 +238,12 @@
      </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>
+     <term><varname>children</varname></term>
+     <listitem>
+      <simpara>
+       Объект <classname>Dom\HTMLCollection</classname>, содержащий все дочерние элементы данного узла. Доступно начиная с PHP 8.5.0.
+      </simpara>
+     </listitem>
     </varlistentry>
     <varlistentry xml:id="dom-element.props.innerhtml">
      <term><varname>innerHTML</varname></term>

From d63a744d85154a93226e84b39999f51516ebbe97 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 20 Jul 2026 14:46:54 +0200
Subject: [PATCH 4/4] fix(dom): use xi:include for children varlistentry and
 add property to Dom\ParentNode

---
 reference/dom/dom/dom-element.xml    |  9 +++------
 reference/dom/dom/dom-parentnode.xml | 24 +++++++++++++++++++++++-
 2 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml
index bb312732fd..ea83944c4e 100644
--- a/reference/dom/dom/dom-element.xml
+++ b/reference/dom/dom/dom-element.xml
@@ -238,12 +238,9 @@
      </xi:include>
     </varlistentry>
     <varlistentry xml:id="dom-element.props.children">
-     <term><varname>children</varname></term>
-     <listitem>
-      <simpara>
-       Объект <classname>Dom\HTMLCollection</classname>, содержащий все дочерние элементы данного узла. Доступно начиная с PHP 8.5.0.
-      </simpara>
-     </listitem>
+     <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>
diff --git a/reference/dom/dom/dom-parentnode.xml b/reference/dom/dom/dom-parentnode.xml
index 096b27aadb..db4a2ca7ce 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,20 @@
 
   </section>
 
+  <section xml:id="dom-parentnode.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="dom-parentnode.props.children">
+     <term><varname>children</varname></term>
+     <listitem>
+      <simpara>
+       Объект <classname>Dom\HTMLCollection</classname>, содержащий все дочерние элементы данного узла. Доступно начиная с PHP 8.5.0.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
  </partintro>
 
  &reference.dom.dom.entities.parentnode;