Document Dom\NodeList class

reference/dom/book.xml

@@ -62,6 +62,7 @@
  &reference.dom.dom.dom-namednodemap;
  &reference.dom.dom.dom-namespaceinfo;
  &reference.dom.dom.dom-node;
+ &reference.dom.dom.dom-nodelist;
  &reference.dom.dom.dom-notation;
  &reference.dom.dom.dom-processinginstruction;
  &reference.dom.dom.dom-text;

reference/dom/dom/dom-nodelist.xml

@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<reference xml:id="class.dom-nodelist" 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>The <classname>Dom\NodeList</classname> class</title>
+ <titleabbrev>Dom\NodeList</titleabbrev>
+
+ <partintro>
+
+  <section xml:id="dom-nodelist.intro">
+   <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.intro')/*)">
+    <xi:fallback/>
+   </xi:include>
+   <simpara>
+    This is the modern, spec-compliant equivalent of
+    <classname>DOMNodeList</classname>.
+   </simpara>
+  </section>
+
+  <section xml:id="dom-nodelist.synopsis">
+   &reftitle.classsynopsis;
+   <classsynopsis class="class">
+    <ooclass>
+     <classname>Dom\NodeList</classname>
+    </ooclass>
+
+    <oointerface>
+     <modifier>implements</modifier>
+     <interfacename>IteratorAggregate</interfacename>
+    </oointerface>
+
+    <oointerface>
+     <interfacename>Countable</interfacename>
+    </oointerface>
+
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>readonly</modifier>
+     <type>int</type>
+     <varname linkend="dom-nodelist.props.length">length</varname>
+    </fieldsynopsis>
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-nodelist')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\NodeList'])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+  </section>
+
+  <section xml:id="dom-nodelist.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="dom-nodelist.props.length">
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.props.length')/*)">
+      <xi:fallback/>
+     </xi:include>
+    </varlistentry>
+   </variablelist>
+  </section>
+ </partintro>
+
+<!-- &reference.dom.dom.entities.nodelist; -->
+
+</reference>

reference/dom/domnodelist.xml

@@ -12,16 +12,12 @@ Remove me once you perform substitutions
  
  <partintro>
  
-<!-- {{{ DOMNodeList intro -->
-<!-- FIXME: 
   <section xml:id="domnodelist.intro">
    &reftitle.intro;
-   <para>
-    
-   </para>
+   <simpara>
+    Represents a live list of nodes.
+   </simpara>
   </section>
--->
-<!-- }}} -->
  
   <section xml:id="domnodelist.synopsis">
    &reftitle.classsynopsis;

reference/dom/versions.xml

@@ -220,6 +220,7 @@
  <function name="dom\namednodemap" from="PHP 8 &gt;= 8.4.0"/>
  <function name="dom\namespaceinfo" from="PHP 8 &gt;= 8.4.0"/>
  <function name="dom\node" from="PHP 8 &gt;= 8.4.0"/>
+ <function name="dom\nodelist" from="PHP 8 &gt;= 8.4.0"/>
  <function name="dom\notation" from="PHP 8 &gt;= 8.4.0"/>
  <function name="dom\implementation" from="PHP 8 &gt;= 8.4.0"/>
  <function name="dom\processinginstruction" from="PHP 8 &gt;= 8.4.0"/>