sync with en rev

language-snippets.ent

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ed1aff13602c94f86344bdd7c4fbc31f5a71bf84 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: ebbc5bb97c8c063d31309725c0bb93d21213993b Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
 
 <!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção em tempo de compilação: '>
 
@@ -1648,30 +1648,40 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
 
 <!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Embora o HTML malformado deva ser carregado com sucesso, esta função pode gerar erros <constant>E_WARNING</constant> quando encontrar marcação incorreta. As <link linkend="function.libxml-use-internal-errors">funções de tratamento de erros da biblioteca libxml</link> podem ser usadas para lidar com esses erros.</para>'>
 <!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>A extensão DOM usa codificação UTF-8. Use <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname> ou <function>iconv</function> para lidar com outras codificações.</para></note>'>
+<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  A extensão DOM usa codificação UTF-8 ao trabalhar com métodos ou propriedades.
+  Os métodos do analisador detectam automaticamente a codificação ou permitem que o chamador especifique uma codificação.
+ </simpara>
+</note>'>
 <!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>Ao usar <function>json_encode</function> em um objeto <classname>DOMDocument</classname>, o resultado será a codificação de um objeto vazio.</para></note>'>
 <!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
- <para>
+ <simpara>
+  Use <classname>Dom\HTMLDocument</classname> para analisar e processar HTML moderno
+  ao invés de <classname>DOMDocument</classname>.
+ </simpara>
+ <simpara>
   Esta função interpreta a entrada usando um analisador de HTML 4. As regras de análise
   de HTML 5, que são as que os navegadores modernos usam, são diferentes. Dependendo
   da entrada isso pode resultar em uma estrutura DOM diferente. Portanto,
   esta função não pode ser usada para sanitizar HTML de forma segura.
- </para>
- <para>
+ </simpara>
+ <simpara>
   O comportamento ao interpretar HTML pode depender da versão da
   <literal>libxml</literal> que está sendo usada, particularmente em relação a
   condições de contorno e manipulação de erros.
   Para interpretação que se conforma à especificação HTML5,
   use <methodname>Dom\HTMLDocument::createFromString</methodname> ou
   <methodname>Dom\HTMLDocument::createFromFile</methodname>, adicionado no PHP 8.4.
- </para>
- <para>
+ </simpara>
+ <simpara>
   Como um exemplo, alguns elementos HTML irão fechar implicitamente um elemento pai
   quando encontrados. As regras para fechamento automático de elementos pai
   diferem entre HTML 4 e HTML 5 e por isso a estrutura DOM resultante que
   <classname>DOMDocument</classname> enxerga pode ser diferente da estrutura
   DOM que um navegador enxerga, possivelmente permitindo a um intruso quebrar
   o HTML resultante.
- </para>
+ </simpara>
 </warning>'>
 
 

reference/dom/book.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9b18516d6feb02d12056f8c7e88d0e83082e2e79 Maintainer: ae Status: ready --><!-- CREDITS: marabesi,ae,leonardolara -->
+<!-- EN-Revision: 8aa5f18461de969e5131fbed3a95c365420e571a Maintainer: ae Status: ready --><!-- CREDITS: marabesi,ae,leonardolara -->
 
 <book xml:id="book.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundledexternal" ?>
@@ -42,6 +42,34 @@
  &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>