8.4: Document all new DOM classes and methods - part 1

language-snippets.ent

@@ -1648,30 +1648,40 @@ it is inserted with (e.g.) <function xmlns="http://docbook.org/ns/docbook">DOMNo
 
 <!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">While malformed HTML should load successfully, this function may generate <constant>E_WARNING</constant> errors when it encounters bad markup. <link linkend="function.libxml-use-internal-errors">libxml&apos;s error handling functions</link> may be used to handle these errors.</para>'>
 <!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>The DOM extension uses UTF-8 encoding. Use <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, or <function>iconv</function> to handle other encodings.</para></note>'>
+<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  The DOM extension uses UTF-8 encoding when working with methods or properties.
+  The parser methods auto-detect the encoding or allow the caller to specify an encoding.
+ </simpara>
+</note>'>
 <!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>When using <function>json_encode</function> on a <classname>DOMDocument</classname> object the result will be that of encoding an empty object.</para></note>'>
 <!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
- <para>
+ <simpara>
+  Use <classname>Dom\HTMLDocument</classname> to parse and process modern HTML
+  instead of <classname>DOMDocument</classname>.
+ </simpara>
+ <simpara>
   This function parses the input using an HTML 4 parser. The parsing rules
   of HTML 5, which is what modern web browsers use, are different. Depending
   on the input this might result in a different DOM structure. Therefore
   this function cannot be safely used for sanitizing HTML.
- </para>
- <para>
+ </simpara>
+ <simpara>
   The behavior when parsing HTML can depend on the version of
   <literal>libxml</literal> that is being used, particularly with regards to
   edge conditions and error handling.
   For parsing that conforms to the HTML5 specification,
   use <methodname>Dom\HTMLDocument::createFromString</methodname> or
   <methodname>Dom\HTMLDocument::createFromFile</methodname>, added in PHP 8.4.
- </para>
- <para>
+ </simpara>
+ <simpara>
   As an example, some HTML elements will implicitly close a parent element
   when encountered. The rules for automatically closing parent elements
   differ between HTML 4 and HTML 5 and thus the resulting DOM structure that
   <classname>DOMDocument</classname> sees might be different from the DOM
   structure a web browser sees, possibly allowing an attacker to break the
   resulting HTML.
- </para>
+ </simpara>
 </warning>'>
 
 

reference/dom/book.xml

@@ -42,6 +42,35 @@
  &reference.dom.domtext;
  &reference.dom.domxpath;
 
+ &reference.dom.dom.dom-adjacentposition;
+ &reference.dom.dom.dom-attr;
+ &reference.dom.dom.dom-cdatasection;
+ &reference.dom.dom.dom-characterdata;
+ &reference.dom.dom.dom-childnode;
+ &reference.dom.dom.dom-comment;
+ &reference.dom.dom.dom-document;
+ &reference.dom.dom.dom-documentfragment;
+ &reference.dom.dom.dom-documenttype;
+ &reference.dom.dom.dom-dtdnamednodemap;
+ &reference.dom.dom.dom-element;
+ &reference.dom.dom.dom-entity;
+ &reference.dom.dom.dom-entityreference;
+ &reference.dom.dom.dom-htmlcollection;
+ &reference.dom.dom.dom-htmldocument;
+ &reference.dom.dom.dom-htmlelement;
+ &reference.dom.dom.dom-implementation;
+ &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-parentnode;
+ &reference.dom.dom.dom-processinginstruction;
+ &reference.dom.dom.dom-text;
+ &reference.dom.dom.dom-tokenlist;
+ &reference.dom.dom.dom-xmldocument;
+ &reference.dom.dom.dom-xpath;
+
  <!-- FIXME:
  <section xml:id="dom.class.domnamelist">
      <title><classname>DOMNameList</classname></title>