updates due to en revision

2026-03-23 22:52:12 +01:00 · 2024-04-22 22:25:13 -03:00
parent 54dc097f55
commit ff69b7097e
63 changed files with 504 additions and 618 deletions
--- a/appendices/migration56.xml
+++ b/appendices/migration56.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: leonardolara Status: ready --><!-- CREDITS: Joel Tavares, Ítalo Lelis, Marcio Daniel da Silva, Sandro Eric, Marianna Texeira, adiel -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: leonardolara Status: ready --><!-- CREDITS: Joel Tavares, Ítalo Lelis, Marcio Daniel da Silva, Sandro Eric, Marianna Texeira, adiel -->
 <!--
 Based on UPGRADING from PHP 5.6.0 beta 1. Work in progress!

@@ -13,6 +13,14 @@
 <appendix xml:id="migration56" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 5.5.x para o PHP 5.6.x</title>

+ <para>
+  A maioria das melhorias no PHP 5.6.x não tem impacto no código existente. Existem
+  <link linkend="migration56.incompatible">algumas incompatibilidades</link>
+  e <link linkend="migration56.new-features">novas funcionalidades</link> que devem
+  ser consideradas, e o codigo deve ser testado antes de alterar a versão
+  do PHP nos ambientes de produção.
+ </para>
+
 &appendices.migration56.incompatible;
 &appendices.migration56.new-features;
 &appendices.migration56.deprecated;
@@ -21,17 +29,6 @@
 &appendices.migration56.openssl;
 &appendices.migration56.extensions;
 &appendices.migration56.constants;
-
- <sect1 annotations="chunk:false" xml:id="migration56.intro">
-  <para>
-   A maioria das melhorias no PHP 5.6.x não tem impacto no código existente. Existem
-   <link linkend="migration56.incompatible">algumas incompatibilidades</link>
-   e <link linkend="migration56.new-features">novas funcionalidades</link> que devem
-   ser consideradas, e o codigo deve ser testado antes de alterar a versão
-   do PHP nos ambientes de produção.
-  </para>
-
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration70.xml
+++ b/appendices/migration70.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, royopa, adiel -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, royopa, adiel -->
 <!--
 Work in progress!
 -->
@@ -7,6 +7,19 @@
 <appendix xml:id="migration70" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 5.6.x para o PHP 7.0.x</title>

+ <para>
+  Apesar do fato do PHP 7.0 ser uma nova versão principal, esforços foram feitos
+  para que a migração seja feita da forma mais simples possível. Essa versão
+  foca na remoção de funcionalidades descontinuadas em versões
+  anteriores e na melhoria da consistência da linguagem.
+ </para>
+ <para>
+  Existem <link linkend="migration70.incompatible">algumas incompatibilidades</link>
+  e <link linkend="migration70.new-features">novos recursos</link> que devem ser
+  considerados, e o código deve ser testado antes da atualização da versão do PHP em
+  ambientes de produção.
+ </para>
+
 &appendices.migration70.incompatible;
 &appendices.migration70.new-features;
 &appendices.migration70.deprecated;
@@ -18,20 +31,6 @@
 &appendices.migration70.removed-exts-sapis;
 &appendices.migration70.other-changes;

- <sect1 annotations="chunk:false" xml:id="migration70.intro">
-  <para>
-   Apesar do fato do PHP 7.0 ser uma nova versão principal, esforços foram feitos
-   para que a migração seja feita da forma mais simples possível. Essa versão
-   foca na remoção de funcionalidades descontinuadas em versões
-   anteriores e na melhoria da consistência da linguagem.
-  </para>
-  <para>
-   Existem <link linkend="migration70.incompatible">algumas incompatibilidades</link>
-   e <link linkend="migration70.new-features">novos recursos</link> que devem ser
-   considerados, e o código deve ser testado antes de trocar a versão do PHP em
-   ambientes de produção.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration71.xml
+++ b/appendices/migration71.xml
@@ -1,9 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: mauricio Status: ready -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: mauricio Status: ready -->

 <appendix xml:id="migration71" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 7.0.x para o PHP 7.1.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration71.new-features">novos recursos</link> e
+  <link linkend="migration71.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da atualização de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration70">7.0.x</link>.
+ </para>
+
 &appendices.migration71.new-features;
 &appendices.migration71.new-functions;
 &appendices.migration71.constants;
@@ -13,20 +26,6 @@
 &appendices.migration71.other-changes;
 &appendices.migration71.windows-support;

- <sect1 annotations="chunk:false" xml:id="migration71.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration71.new-features">novos recursos</link> e
-   <link linkend="migration71.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration70">7.0.x</link>.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration72.xml
+++ b/appendices/migration72.xml
@@ -1,9 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: leonardolara Status: ready --><!-- CREDITS: github:vanildosouto, adiel -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: leonardolara Status: ready --><!-- CREDITS: github:vanildosouto, adiel -->

 <appendix xml:id="migration72" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 7.1.x para o PHP 7.2.x</title>

+ <para>
+  Esta nova versão menor traz
+  <link linkend="migration72.new-features">novos recursos</link> e
+  <link linkend="migration72.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da atualização da versão do PHP em ambientes
+  de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration70">7.0.x</link> e
+  <link linkend="migration71">7.1.x</link>.
+ </para>
+
 &appendices.migration72.new-features;
 &appendices.migration72.new-functions;
 &appendices.migration72.constants;
@@ -11,21 +25,6 @@
 &appendices.migration72.deprecated;
 &appendices.migration72.other-changes;

- <sect1 annotations="chunk:false" xml:id="migration72.intro">
-  <para>
-   Esta nova versão menor traz
-   <link linkend="migration72.new-features">novos recursos</link> e
-   <link linkend="migration72.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca da versão do PHP em ambientes
-   de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration70">7.0.x</link> e
-   <link linkend="migration71">7.1.x</link>.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration73.xml
+++ b/appendices/migration73.xml
@@ -1,9 +1,24 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: mauricio Status: ready --><!-- CREDITS: mauricio, adiel -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: mauricio Status: ready --><!-- CREDITS: mauricio, adiel -->

 <appendix xml:id="migration73" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 7.2.x para o PHP 7.3.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration73.new-features">novos recursos</link> e
+  <link linkend="migration73.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da atualização de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration70">7.0.x</link>,
+  <link linkend="migration71">7.1.x</link> e
+  <link linkend="migration72">7.2.x</link>.
+ </para>
+
 &appendices.migration73.new-features;
 &appendices.migration73.new-functions;
 &appendices.migration73.constants;
@@ -12,22 +27,6 @@
 &appendices.migration73.other-changes;
 &appendices.migration73.windows-support;

- <sect1 annotations="chunk:false" xml:id="migration73.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration73.new-features">novos recursos</link> e
-   <link linkend="migration73.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration70">7.0.x</link>,
-   <link linkend="migration71">7.1.x</link> e
-   <link linkend="migration72">7.2.x</link>.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration74.xml
+++ b/appendices/migration74.xml
@@ -1,9 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: mauricio Status: ready --><!-- CREDITS: geekcom -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: mauricio Status: ready --><!-- CREDITS: geekcom -->

 <appendix xml:id="migration74" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 7.3.x para o PHP 7.4.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration74.new-features">novos recursos</link> e
+  <link linkend="migration74.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da troca de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration70">7.0.x</link>,
+  <link linkend="migration71">7.1.x</link>,
+  <link linkend="migration72">7.2.x</link> e
+  <link linkend="migration73">7.3.x</link>.
+ </para>
+
 &appendices.migration74.new-features;
 &appendices.migration74.new-classes;
 &appendices.migration74.new-functions;
@@ -14,23 +30,6 @@
 &appendices.migration74.other-changes;
 &appendices.migration74.windows-support;

- <sect1 annotations="chunk:false" xml:id="migration74.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration74.new-features">novos recursos</link> e
-   <link linkend="migration74.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration70">7.0.x</link>,
-   <link linkend="migration71">7.1.x</link>,
-   <link linkend="migration72">7.2.x</link> e
-   <link linkend="migration73">7.3.x</link>.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration80.xml
+++ b/appendices/migration80.xml
@@ -1,32 +1,31 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: geekcom Status: ready --><!-- CREDITS: geekcom -->
+<!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: geekcom Status: ready --><!-- CREDITS: geekcom -->

 <appendix xml:id="migration80" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 7.4.x para o PHP 8.0.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration80.new-features">novos recursos</link> e
+  <link linkend="migration80.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da troca de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration70">7.0.x</link>,
+  <link linkend="migration71">7.1.x</link>,
+  <link linkend="migration72">7.2.x</link>,
+  <link linkend="migration73">7.3.x</link>.
+  <link linkend="migration74">7.4.x</link>.
+ </para>
+
 &appendices.migration80.new-features;
 &appendices.migration80.incompatible;
 &appendices.migration80.deprecated;
 &appendices.migration80.other-changes;

- <sect1 annotations="chunk:false" xml:id="migration80.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration80.new-features">novos recursos</link> e
-   <link linkend="migration80.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration70">7.0.x</link>,
-   <link linkend="migration71">7.1.x</link>,
-   <link linkend="migration72">7.2.x</link>,
-   <link linkend="migration73">7.3.x</link>.
-   <link linkend="migration74">7.4.x</link>.
-  </para>
- </sect1>
 </appendix>

 <!-- Keep this comment at the end of the file
--- a/appendices/migration81.xml
+++ b/appendices/migration81.xml
@@ -1,7 +1,24 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: lhsazevedo Status: ready -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: lhsazevedo Status: ready -->
 <appendix xml:id="migration81" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 8.0.x para o PHP 8.1.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration81.new-features">novos recursos</link> e
+  <link linkend="migration81.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da troca de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration71">7.1.x</link>,
+  <link linkend="migration72">7.2.x</link>,
+  <link linkend="migration73">7.3.x</link>,
+  <link linkend="migration74">7.4.x</link> e
+  <link linkend="migration80">8.0.x</link>.
+ </para>
+
 &appendices.migration81.new-features;
 &appendices.migration81.new-classes;
 &appendices.migration81.new-functions;
@@ -10,24 +27,6 @@
 &appendices.migration81.deprecated;
 &appendices.migration81.other-changes;

- <sect1 annotations="chunk:false" xml:id="migration81.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration81.new-features">novos recursos</link> e
-   <link linkend="migration81.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration71">7.1.x</link>,
-   <link linkend="migration72">7.2.x</link>,
-   <link linkend="migration73">7.3.x</link>,
-   <link linkend="migration74">7.4.x</link> e
-   <link linkend="migration80">8.0.x</link>.
-  </para>
- </sect1>
 </appendix>
 <!-- Keep this comment at the end of the file
 Local variables:
--- a/appendices/migration82.xml
+++ b/appendices/migration82.xml
@@ -1,7 +1,25 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: athos-ribeiro Status: ready -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: athos-ribeiro Status: ready -->
 <appendix xml:id="migration82" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 8.1.x para o PHP 8.2.x</title>

+ <para>
+  Esta nova versão menor traz vários
+  <link linkend="migration82.new-features">novos recursos</link> e
+  <link linkend="migration82.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes da troca de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration71">7.1.x</link>,
+  <link linkend="migration72">7.2.x</link>,
+  <link linkend="migration73">7.3.x</link>,
+  <link linkend="migration74">7.4.x</link>,
+  <link linkend="migration80">8.0.x</link>,
+  <link linkend="migration81">8.1.x</link>.
+ </para>
+
 &appendices.migration82.new-features;
 &appendices.migration82.new-functions;
 &appendices.migration82.constants;
@@ -10,25 +28,6 @@
 &appendices.migration82.other-changes;
 &appendices.migration82.windows-support;

- <sect1 annotations="chunk:false" xml:id="migration82.intro">
-  <para>
-   Esta nova versão menor traz vários
-   <link linkend="migration82.new-features">novos recursos</link> e
-   <link linkend="migration82.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes da troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration71">7.1.x</link>,
-   <link linkend="migration72">7.2.x</link>,
-   <link linkend="migration73">7.3.x</link>,
-   <link linkend="migration74">7.4.x</link>,
-   <link linkend="migration80">8.0.x</link>,
-   <link linkend="migration81">8.1.x</link>.
-  </para>
- </sect1>
 </appendix>
 <!-- Keep this comment at the end of the file
 Local variables:
--- a/appendices/migration83.xml
+++ b/appendices/migration83.xml
@@ -1,7 +1,26 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: marcosmarcolin Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9c422d0dd7aaa5864487d9526696dbff01a2052c Maintainer: marcosmarcolin Status: ready -->
 <appendix xml:id="migration83" xmlns="http://docbook.org/ns/docbook">
 <title>Migrando do PHP 8.2.x para o PHP 8.3.x</title>

+ <para>
+  Esta nova versão menor traz consigo várias
+  <link linkend="migration83.new-features">novas funcionalidades</link> e
+  <link linkend="migration83.incompatible">algumas incompatibilidades</link>
+  que devem ser testadas antes de realizar a troca de versões do PHP em
+  ambientes de produção.
+ </para>
+
+ <para>
+  &manual.migration.seealso;
+  <link linkend="migration71">7.1.x</link>,
+  <link linkend="migration72">7.2.x</link>,
+  <link linkend="migration73">7.3.x</link>,
+  <link linkend="migration74">7.4.x</link>,
+  <link linkend="migration80">8.0.x</link>,
+  <link linkend="migration81">8.1.x</link>,
+  <link linkend="migration82">8.2.x</link>.
+ </para>
+
 &appendices.migration83.new-features;
 &appendices.migration83.new-classes;
 &appendices.migration83.new-functions;
@@ -11,26 +30,6 @@
 &appendices.migration83.other-changes;
 &appendices.migration83.windows-support;

- <sect1 annotations="chunk:false" xml:id="migration83.intro">
-  <para>
-   Esta nova versão menor traz consigo várias
-   <link linkend="migration83.new-features">novas funcionalidades</link> e
-   <link linkend="migration83.incompatible">algumas incompatibilidades</link>
-   que devem ser testadas antes de realizar a troca de versões do PHP em
-   ambientes de produção.
-  </para>
-
-  <para>
-   &manual.migration.seealso;
-   <link linkend="migration71">7.1.x</link>,
-   <link linkend="migration72">7.2.x</link>,
-   <link linkend="migration73">7.3.x</link>,
-   <link linkend="migration74">7.4.x</link>,
-   <link linkend="migration80">8.0.x</link>,
-   <link linkend="migration81">8.1.x</link>,
-   <link linkend="migration82">8.2.x</link>.
-  </para>
- </sect1>
 </appendix>
 <!-- Keep this comment at the end of the file
 Local variables:
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: ae Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
+<!-- EN-Revision: 8fbb401370217ca8c57090d35ea0b1da200cc0ed Maintainer: ae Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Usando PHP a partir da linha de comando</title>
 <titleabbrev>Uso da linha de Comando</titleabbrev>
@@ -462,6 +462,7 @@ $ php -c /custom/directory/custom-file.ini my_script.php
         </screen>
        </para>
        <para><example>
+        <title>Exemplo de uso de <literal>-d</literal> para definir uma configuração INI</title>
         <screen>
 <![CDATA[
 # Omitir o valor irá configurar a diretiva para "1"
--- a/language/functions.xml
+++ b/language/functions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ad7129daf0d410badf414b6707080e2451a80d1f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae,geekcom,lhsazevedo -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae,geekcom,lhsazevedo -->
 <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
  <title>Funções</title>

@@ -1044,7 +1044,7 @@ $func(); // prints "bar"
     Em contrapartida, um <classname>TypeError</classname> é emitido no modo estrito.
    </para>

-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -1058,7 +1058,7 @@ var_dump(str_contains("foobar", null));
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>
   </note>

   <sect2 role="seealso">
@@ -1691,7 +1691,7 @@ $metodoPrivado();  // Foo1::metodoPrivado
   <note>
    <para>
     A sintaxe de callable de primeira classe não pode ser combinada com o <link linkend="language.oop5.basic.nullsafe">operador nullsafe</link>. Ambos os resultados a seguir resultam em um erro de tempo de compilação:
-     <example>
+     <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -1700,7 +1700,7 @@ $obj?->prop->metodo(...);
 ?>
 ]]>
      </programlisting>
-     </example>
+     </informalexample>
    </para>
   </note>
  </sect1>
--- a/language/oop5/basic.xml
+++ b/language/oop5/basic.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 102a046f5397fc02be82de2d7fca694b2c1ab574 Maintainer: ae Status: ready --><!-- CREDITS: ae,amandavale,narigone,fabioluciano,lhsazevedo -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: ae,amandavale,narigone,fabioluciano,lhsazevedo -->

 <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
  <title>O básico</title>
@@ -139,7 +139,7 @@ Stack trace:
     <classname>AllowDynamicProperties</classname>. Acrescentar o atributo em classes somente leitura
     irá disparar um erro de compilação.
    </para>
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -151,14 +151,14 @@ readonly class Foo {
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>

    <para>
     Como as propriedades estáticas ou sem tipo não podem ser marcadas com o
     modificador <literal>readonly</literal>, as classes somente leitura também não podem
     declará-las:
    </para>
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -183,7 +183,7 @@ readonly class Foo
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>
    <para>
     Uma classe <modifier>readonly</modifier> pode ser
     <link linkend="language.oop5.basic.extends">estendida</link>
--- a/language/oop5/inheritance.xml
+++ b/language/oop5/inheritance.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 99744a3bfa1e5c09f75e7ee02a12c92f9e4ef438 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,mauricio,ABDALAZARD,ae -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,mauricio,ABDALAZARD,ae -->
 <sect1 xml:id="language.oop5.inheritance" xmlns="http://docbook.org/ns/docbook">
  <title>Herança de Objetos</title>
  <para>
@@ -48,7 +48,7 @@
  <note>
   <para>
    Não é permitido sobrescrever uma propriedade de leitura/gravação com um <link linkend="language.oop5.properties.readonly-properties">propriedade somente de leitura</link> ou vice versa.
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -63,14 +63,13 @@ class B extends A {
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>
   </para>
  </note>

-  <sect2 xml:id="language.oop5.inheritance.examples">
-   <example xml:id="language.oop5.inheritance.examples.ex1">
-    <title>Exemplo de Herança</title>
-     <programlisting role="php">
+  <example>
+   <title>Exemplo de Herança</title>
+    <programlisting role="php">
 <![CDATA[
 <?php

@@ -104,9 +103,8 @@ $bar->printPHP();       // Output: 'PHP is great'

 ?>
 ]]>
-    </programlisting>
-   </example>
-  </sect2>
+   </programlisting>
+  </example>

  <sect2 xml:id="language.oop5.inheritance.internal-classes">
   <title>Compatibilidade de Tipo de Retorno com Classes Internas</title>
--- a/language/oop5/properties.xml
+++ b/language/oop5/properties.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ba65e0f4f7f28bb29b42362c38d60e41970bdfe6 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae, vinelouzada -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae, vinelouzada -->
 <sect1 xml:id="language.oop5.properties" xmlns="http://docbook.org/ns/docbook">
  <title>Propriedades</title>

@@ -254,7 +254,7 @@ $test1->prop = "foobar";
   <note>
    <para>
     Especificar um valor default para uma propriedade somente leitura não é permitido, porque uma propriedade com um valor default é essencialmente uma constante, e portanto não tem outro propósito.
-     <example>
+     <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -266,7 +266,7 @@ class Test {
 ?>
 ]]>
      </programlisting>
-     </example>
+     </informalexample>
    </para>
   </note>
   <note>
@@ -276,7 +276,7 @@ class Test {
   </note>
   <para>
    Nenhum tipo de modificação é permitido, e o seguintes casos resultarão em um <classname>Error</classname>:
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -301,11 +301,11 @@ foreach ($test as &$prop);
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>
   </para>
   <para>
    Entretanto, propriedades somente leitura não proíbem mutação. Objetos ou recursos armazenados em propriedades somente leitura ainda podem ser modificados internamente:
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -322,7 +322,7 @@ $test->obj = new stdClass;
 ?>
 ]]>
     </programlisting>
-    </example>
+    </informalexample>
   </para>
  </sect2>

--- a/language/oop5/serialization.xml
+++ b/language/oop5/serialization.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1f407ffe61c42c203c99ff0bacc1ae82b3414621 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fabioluciano,ABDALAZARD,WilliamSampaio,fernandowobeto -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fabioluciano,ABDALAZARD,WilliamSampaio,fernandowobeto -->
 <!-- TODO reescreva para remover o uso de "você" e fale sobre __serialize/_unserialize -->
 <sect1 xml:id="language.oop5.serialization" xmlns="http://docbook.org/ns/docbook">
  <title>Serialização de Objetos</title>
-  <title>Serialização de Objetos - Objetos em sessão</title>
+  <titleabbrev>Serialização de Objetos - Objetos em sessões</titleabbrev>

  <para>
   A função <function>serialize</function> retorna uma string contendo uma
--- a/language/predefined/arrayaccess.xml
+++ b/language/predefined/arrayaccess.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: ae Status: ready --><!-- CREDITS: royopa,fabioluciano,hugouke,ae,adaiasmagdiel -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: royopa,fabioluciano,hugouke,ae,adaiasmagdiel -->
 <phpdoc:classref xml:id="class.arrayaccess" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A interface ArrayAccess</title>
@@ -35,6 +35,7 @@
  </section>

  <section xml:id="arrayaccess.examples">
+   &reftitle.examples;
   <example xml:id="arrayaccess.example.basic"><!-- {{{ -->
    <title>Utilização básica</title>
    <programlisting role="php">
--- a/language/predefined/attributes/allowdynamicproperties.xml
+++ b/language/predefined/attributes/allowdynamicproperties.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
 <phpdoc:classref xml:id="class.allowdynamicproperties" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>A classe AllowDynamicProperties</title>
 <titleabbrev>AllowDynamicProperties</titleabbrev>
@@ -37,7 +37,7 @@
    portanto, usá-las sem marcar a classe com este atributo emitirá
    um aviso de descontinuação.
   </para>
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -60,7 +60,7 @@ $o2->nonExistingProp = true;
 Deprecated: Creation of dynamic property DefaultBehaviour::$nonExistingProp is deprecated in file on line 10
 ]]>
    </screen>
-   </example>
+   </informalexample>
  </section>

  <section xml:id="allowdynamicproperties.seealso">
--- a/language/predefined/attributes/override.xml
+++ b/language/predefined/attributes/override.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: fe11910e25e7eba44959bd347ba946ffc4d56934 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: leonardolara Status: ready -->
 <phpdoc:classref xml:id="class.override" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>A classe Override</title>
 <titleabbrev>Override</titleabbrev>
@@ -30,7 +30,7 @@

  <section>
   &reftitle.examples;
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -53,7 +53,7 @@ final class Extended extends Base {
 Fatal error: Extended::boo() has #[\Override] attribute, but no matching parent method exists
 ]]>
    </screen>
-   </example>
+   </informalexample>
  </section>

  <section xml:id="override.seealso">
--- a/language/predefined/attributes/sensitiveparameter.xml
+++ b/language/predefined/attributes/sensitiveparameter.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
 <phpdoc:classref xml:id="class.sensitiveparameter" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>A classe SensitiveParameter</title>
 <titleabbrev>SensitiveParameter</titleabbrev>
@@ -33,7 +33,7 @@

  <section>
   &reftitle.examples;
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -82,7 +82,7 @@ Stack trace:
 #1 {main}
 ]]>
    </screen>
-   </example>
+   </informalexample>
  </section>

  <section xml:id="sensitiveparameter.seealso">
--- a/language/predefined/iteratoraggregate.xml
+++ b/language/predefined/iteratoraggregate.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 92ae371db30ae40f0bc7bb818b3d4ced3adc5866 Maintainer: ae Status: ready --><!-- CREDITS: royopa,ae -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: royopa,ae -->
 <phpdoc:classref xml:id="class.iteratoraggregate" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>The IteratorAggregate interface</title>
@@ -40,6 +40,7 @@
  </section>

  <section xml:id="iteratoraggregate.examples">
+   &reftitle.examples;
   <example xml:id="iteratoraggregate.example.basic"><!-- {{{ -->
    <title>Basic usage</title>
    <programlisting role="php">
--- a/language/predefined/serializable.xml
+++ b/language/predefined/serializable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
 <phpdoc:classref xml:id="class.serializable" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>The Serializable interface</title>
@@ -52,6 +52,7 @@
  </section>

  <section xml:id="serializable.examples">
+   &reftitle.examples;
   <example xml:id="serializable.example.basic"><!-- {{{ -->
    <title>Basic usage</title>
    <programlisting role="php">
--- a/language/types/declarations.xml
+++ b/language/types/declarations.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e612d76529255bc8db91d0f87e5636e3a405dd38 Maintainer: ae Status: ready --><!-- CREDITS: marcosmarcolin,ae -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: marcosmarcolin,ae -->
 <sect1 xml:id="language.types.declarations">
 <title>Declarações de tipo</title>

@@ -152,7 +152,7 @@
     de tipo exigirá que o valor seja uma &instanceof; da classe ou interface
     <literal>boolean</literal>, em vez do tipo <type>bool</type>:
    </para>
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -173,7 +173,7 @@ Stack trace:
  thrown in - on line 2
 ]]>
     </screen>
-    </example>
+    </informalexample>
   </warning>
  </sect3>

--- a/language/types/type-juggling.xml
+++ b/language/types/type-juggling.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 183439d468314fc3b1a62cf58feb20330922ed11 Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,geekcom,gabrielsanva,ae -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,geekcom,gabrielsanva,ae -->
 <sect1 xml:id="language.types.type-juggling">
 <title>Conversão automática de tipos</title>

@@ -422,9 +422,7 @@ if ($fst === $str) {
    <member><link linkend="types.comparisons">A tabela de conversão de tipos</link></member>
   </simplelist>
  </para>
- </sect2>

- <simplesect>
  <note>
   <simpara>
    O PHP suporta a indexação de <type>string</type> utilizando
@@ -449,7 +447,7 @@ echo $a;       // bar
    da string</link> para mais informações.
   </simpara>
  </note>
- </simplesect>
+ </sect2>

 </sect1>
 <!-- Keep this comment at the end of the file
--- a/language/wrappers/audio.xml
+++ b/language/wrappers/audio.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9e2d8231b5d8a3795b365c6770fab288e59e6249 Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: adaiasmagdiel Status: ready --><!-- CREDITS: adaiasmagdiel -->

 <refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false">
 <refnamediv>
@@ -168,10 +168,6 @@
  </para>
 </refsect1> <!-- }}} -->

- <refsect1 role="examples"><!-- {{{ -->
-  &reftitle.examples;
- </refsect1><!-- }}} -->
-
 </refentry>

 <!-- Keep this comment at the end of the file
--- a/language/wrappers/expect.xml
+++ b/language/wrappers/expect.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec6e871a47fa15228aa3299f46fed826422adbc0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->

 <refentry xml:id="wrappers.expect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false">
 <refnamediv>
@@ -91,10 +91,6 @@
  </para>
 </refsect1> <!-- }}} -->

- <refsect1 role="examples"><!-- {{{ -->
-  &reftitle.examples;
- </refsect1><!-- }}} -->
-
 </refentry>

 <!-- Keep this comment at the end of the file
--- a/reference/datetime/dateperiod.xml
+++ b/reference/datetime/dateperiod.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
+<!-- EN-Revision: ac83abe55f4da019036de5ec14400d674fa3f9f5 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
 <phpdoc:classref xml:id="class.dateperiod" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A classe DatePeriod</title>
@@ -154,7 +154,7 @@
       <constant>DatePeriod::INCLUDE_END_DATE</constant>.
      </para>
      <para>
-       <example>
+       <informalexample>
        <programlisting role="php">
 <![CDATA[<?php
 $start = new DateTime('2018-12-31 00:00:00');
@@ -188,7 +188,7 @@ echo $period->recurrences, "\n";
 1
 0
         </screen>
-        </example>
+        </informalexample>
       </para>
      <para>
       Veja também <methodname>DatePeriod::getRecurrences</methodname>.
--- a/reference/datetime/formats.xml
+++ b/reference/datetime/formats.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, rogeriopradoj, leonardolara -->
+<!-- EN-Revision: ac83abe55f4da019036de5ec14400d674fa3f9f5 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, rogeriopradoj, leonardolara -->
 <chapter xml:id="datetime.formats" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Formatos de Data e Hora Suportados</title>

@@ -78,7 +78,7 @@
  <listitem>
   <para>
    Há uma verificação adicional se uma data inválida é fornecida:
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -96,7 +96,7 @@ array(1) {
 }
 ]]>
     </screen>
-    </example>
+    </informalexample>
   </para>
  </listitem>
  <listitem>
@@ -104,7 +104,7 @@ array(1) {
    Já é possível lidar com casos extremos, mas neste caso
    a função <function>DateTimeImmutable::createFromFormat</function> deve ser usada
    e o formato correto fornecido.
-    <example>
+    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -125,7 +125,7 @@ object(DateTimeImmutable)#1 (3) {
 }
 ]]>
     </screen>
-    </example>
+    </informalexample>
   </para>
  </listitem>
 </orderedlist>
@@ -189,7 +189,7 @@ object(DateTimeImmutable)#1 (3) {
      <entry>"00", "12", "59"</entry>
     </row>
     <row>
-      <entry><literal>espaço</literal></entry>
+      <entry><literal>space</literal></entry>
      <entry>[ \t]</entry>
      <entry></entry>
     </row>
--- a/reference/dir/functions/getcwd.xml
+++ b/reference/dir/functions/getcwd.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: aa0cb38a27858dac31214068ead6f600cd6047a2 Maintainer: rarruda Status: ready --><!-- CREDITS: rarruda,leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: rarruda Status: ready --><!-- CREDITS: rarruda,leonardolara -->
 <!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 -->
 <refentry xml:id="function.getcwd" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -70,6 +70,7 @@ echo getcwd() . "\n";
 </refsect1>

 <refsect1 role="notes">
+  &reftitle.notes;
  <caution>
   <para>
    Se o interpretador PHP foi compilado com ZTS (Zend Thread Safety) habilitado,
--- a/reference/ds/ds/deque/count.xml
+++ b/reference/ds/ds/deque/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-deque.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,6 +8,7 @@
 </refnamediv>

 <refsect1 role="description">
+  &reftitle.description;
  <para>
   Veja <function>Countable::count</function>
  </para>
--- a/reference/ds/ds/deque/jsonserialize.xml
+++ b/reference/ds/ds/deque/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-deque.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,12 +8,13 @@
 </refnamediv>

 <refsect1 role="description">
+  &reftitle.description;
  <para>
   Veja <function>JsonSerializable::jsonSerialize</function>
  </para>
  <note>
   <para>
-    Você nunca deveria precisar chamar isso diretamente.
+    Normalmente, não deve ser necessário chamar este método diretamente.
   </para>
  </note>
 </refsect1>
--- a/reference/ds/ds/map/count.xml
+++ b/reference/ds/ds/map/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-map.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,9 +8,10 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/map/jsonserialize.xml
+++ b/reference/ds/ds/map/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-map.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,14 +8,15 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Normalmente, você não precisa chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/pair/jsonserialize.xml
+++ b/reference/ds/ds/pair/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-pair.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,14 +8,15 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Você nunca deve precisar chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/priorityqueue/count.xml
+++ b/reference/ds/ds/priorityqueue/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-priorityqueue.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,13 +8,13 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/ds/ds/priorityqueue/jsonserialize.xml
+++ b/reference/ds/ds/priorityqueue/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-priorityqueue.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,18 +8,18 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Esta função nunca deve ser chamada diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/ds/ds/queue/count.xml
+++ b/reference/ds/ds/queue/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-queue.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,9 +8,10 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/queue/jsonserialize.xml
+++ b/reference/ds/ds/queue/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-queue.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,14 +8,15 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Normalmente, você não precisa chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/set/count.xml
+++ b/reference/ds/ds/set/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-set.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,9 +8,10 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/set/jsonserialize.xml
+++ b/reference/ds/ds/set/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-set.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,14 +8,15 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Você nunca deveria precisar chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/stack/count.xml
+++ b/reference/ds/ds/stack/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rafaelbernard Status: ready -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: rafaelbernard Status: ready -->

 <refentry xml:id="ds-stack.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,9 +8,10 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/stack/jsonserialize.xml
+++ b/reference/ds/ds/stack/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-stack.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,18 +8,18 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Você nunca deverá precisar chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/ds/ds/vector/count.xml
+++ b/reference/ds/ds/vector/count.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-vector.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,9 +8,10 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-    Veja <function>Countable::count</function>
-    </para>
+  &reftitle.description;
+  <para>
+   Veja <function>Countable::count</function>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/ds/ds/vector/jsonserialize.xml
+++ b/reference/ds/ds/vector/jsonserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ea2d87ea4308759b6c6295d6272b6cdf5dacd406 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->

 <refentry xml:id="ds-vector.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
@@ -8,14 +8,15 @@
 </refnamediv>

 <refsect1 role="description">
-    <para>
-        Veja <function>JsonSerializable::jsonSerialize</function>
-    </para>
-    <note>
-        <para>
-            Você nunca deve precisar chamar isso diretamente.
-        </para>
-    </note>
+  &reftitle.description;
+  <para>
+   Veja <function>JsonSerializable::jsonSerialize</function>
+  </para>
+  <note>
+   <para>
+    Normalmente, não deve ser necessário chamar este método diretamente.
+   </para>
+  </note>
 </refsect1>

 </refentry>
--- a/reference/exec/functions/escapeshellcmd.xml
+++ b/reference/exec/functions/escapeshellcmd.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1ea4e4f5769f1a173303f95074a91e8537f65133 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
 <refentry xml:id="function.escapeshellcmd" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>escapeshellcmd</refname>
-   <refpurpose>Escapa metacaracteres shell</refpurpose>
+   <refpurpose>Escapa meta-caracteres shell</refpurpose>
  </refnamediv>

 <refsect1 role="description">
@@ -78,20 +78,21 @@ system($escaped_command);
 </refsect1>

 <refsect1 role="notes">
+  &reftitle.notes;
  <warning xmlns="http://docbook.org/ns/docbook">
   <para>
-    <function>escapeshellcmd</function> should be used on the whole
-    command string, and it still allows the attacker to pass
-    arbitrary number of arguments. For escaping a single argument
-    <function>escapeshellarg</function> should be used instead.
+    <function>escapeshellcmd</function> deve ser usada na string de comando
+    inteira, e ainda assim permite ao intruso passar
+    um número arbitrário de argumentos. Para escapar um único argumento,
+    a função <function>escapeshellarg</function> deve ser usada em seu lugar.
   </para>
  </warning>
  <warning xmlns="http://docbook.org/ns/docbook">
   <para>
-    Spaces will not be escaped by <function>escapeshellcmd</function>
-    which can be problematic on Windows with paths like:
+    Espaços não serão escapados por <function>escapeshellcmd</function>,
+    o que pode ser problemático em caminhos do Windows como:
    <literal>C:\Program Files\ProgramName\program.exe</literal>.
-    This can be mitigated using the following code snippet:
+    Isto pode ser mitigado usando-se o seguinte trecho de código:
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -110,7 +111,7 @@ $cmd = preg_replace('`(?<!^) `', '^ ', escapeshellcmd($cmd));
    <member><function>exec</function></member>
    <member><function>popen</function></member>
    <member><function>system</function></member>
-    <member><link linkend="language.operators.execution">backtick operator</link></member>
+    <member><link linkend="language.operators.execution">operador crase</link></member>
   </simplelist>
  </para>
 </refsect1>
--- a/reference/gmp/gmp.xml
+++ b/reference/gmp/gmp.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5eadfcc2e75b7f75edb1968229e394333276e384 Maintainer: leonardolara Status: ready --><!-- CREDITS: rafaelbernard,leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: rafaelbernard,leonardolara -->
 <phpdoc:classref xml:id="class.gmp" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A classe GMP</title>
@@ -24,6 +24,7 @@
  </section>

  <section xml:id="gmp.synopsis">
+   &reftitle.classsynopsis;
   <classsynopsis class="class">
    <ooclass>
     <classname>GMP</classname>
--- a/reference/image/functions/imagexbm.xml
+++ b/reference/image/functions/imagexbm.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.imagexbm" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>imagexbm</refname>
@@ -142,9 +142,7 @@ imagedestroy($im);
   </example>
  </para>
 </refsect1>
- <refsect1 role="notes">
-  &reftitle.notes;
- </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
--- a/reference/mbstring/functions/mb-ord.xml
+++ b/reference/mbstring/functions/mb-ord.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 30c25e7d490278bb31b9d5df6107a3b300d7e10a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <refentry xml:id="function.mb-ord" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>mb_ord</refname>
@@ -69,8 +69,9 @@
  &reftitle.examples;
  <para>
   <example>
+    <title>Um exemplo básico de <function>mb_ord</function></title>
    <programlisting role="php">
-     <![CDATA[
+<![CDATA[
 <?php
 var_dump(mb_ord("A", "UTF-8"));
 var_dump(mb_ord("🐘", "UTF-8"));
--- a/reference/mysqli/functions/mysqli-get-client-stats.xml
+++ b/reference/mysqli/functions/mysqli-get-client-stats.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 473b5ab2c14369c0bc9f17a7f122c9669718c3e3 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="function.mysqli-get-client-stats" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>mysqli_get_client_stats</refname>
@@ -24,6 +24,7 @@

 <refsect1 role="parameters">
  &reftitle.parameters;
+  &no.function.parameters;
 </refsect1>

 <refsect1 role="returnvalues">
--- a/reference/mysqli/mysqli_result/fetch-field-direct.xml
+++ b/reference/mysqli/mysqli_result/fetch-field-direct.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c56455e0f9db0c9338d129c060c9ff7f080305c4 Maintainer: leonardolara Status: ready -->
-<refentry xml:id="mysqli-result.fetch-field-direct" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="mysqli-result.fetch-field-direct" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
 <refnamediv>
  <refname>mysqli_result::fetch_field_direct</refname>
  <refname>mysqli_fetch_field_direct</refname>
@@ -51,65 +51,9 @@
   se nenhuma informação de campo para o valor especificado em <parameter>index</parameter> estiver
   disponível.
  </para>
-  <para>
-   <table xml:id="mysqli-result.fetch-field-direct.returnvalues">
-    <title>Atributos de objetos</title>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>Atributo</entry>
-       <entry>Descrição</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>name</entry>
-       <entry>O nome da coluna.</entry>
-      </row>
-      <row>
-       <entry>orgname</entry>
-       <entry>Nome original da coluna se um apelido foi especificado.</entry>
-      </row>
-      <row>
-       <entry>table</entry>
-       <entry>O nome da tabela à qual este campo pertence (se não calculado).</entry>
-      </row>
-      <row>
-       <entry>orgtable</entry>
-       <entry>Nome original da tabela se um apelido foi especificado.</entry>
-      </row>
-      <row>
-       <entry>def</entry>
-       <entry>O valor padrão para este campo, representado como uma string.</entry>
-      </row>
-      <row>
-       <entry>max_length</entry>
-       <entry>A largura máxima do campo no resultado. A partir do PHP 8.1, este valor é sempre <literal>0</literal>.</entry>
-      </row>
-      <row>
-       <entry>length</entry>
-       <entry>A largura do campo, como especificada na definição da tabela.</entry>
-      </row>
-      <row>
-       <entry>charsetnr</entry>
-       <entry>O número do conjunto de caracteres para o campo.</entry>
-      </row>
-      <row>
-       <entry>flags</entry>
-       <entry>Um inteiro representando os bits de opções para o campo.</entry>
-      </row>
-      <row>
-       <entry>type</entry>
-       <entry>O tipo de dados usado para este campo.</entry>
-      </row>
-      <row>
-       <entry>decimals</entry>
-       <entry>O número de decimais usadas (para campos numéricos)</entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </table>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('mysqli-result.fetch-fields')/db:refsect1[@role='returnvalues']/db:table)">
+   <xi:fallback/>
+  </xi:include>
 </refsect1>

 <refsect1 role="examples">
--- a/reference/mysqli/mysqli_result/fetch-field.xml
+++ b/reference/mysqli/mysqli_result/fetch-field.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
-<refentry xml:id="mysqli-result.fetch-field" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
+<refentry xml:id="mysqli-result.fetch-field" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
 <refnamediv>
  <refname>mysqli_result::fetch_field</refname>
  <refname>mysqli_fetch_field</refname>
@@ -41,73 +41,9 @@
   Retorna um objeto que contém informações sobre a definição do campo ou &false;
   se nenhuma informação de campos estiver disponível.
  </para>
-  <para>
-   <table xml:id="mysqli-result.fetch-field.returnvalues">
-    <title>Propriedades do objeto</title>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>Propriedade</entry>
-       <entry>Descrição</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>name</entry>
-       <entry>O nome da coluna</entry>
-      </row>
-      <row>
-       <entry>orgname</entry>
-       <entry>Nome original da coluna se foi especificado um apelido</entry>
-      </row>
-      <row>
-       <entry>table</entry>
-       <entry>O nome da tabela à qual este campo pertence (se não calculada)</entry>
-      </row>
-      <row>
-       <entry>orgtable</entry>
-       <entry>Nome da tabela original se foi especificado um apelido</entry>
-      </row>
-      <row>
-       <entry>def</entry>
-       <entry>Reservado para o valor padrão, atualmente sempre igual a ""</entry>
-      </row>
-      <row>
-       <entry>db</entry>
-       <entry>O nome do banco de dados</entry>
-      </row>
-      <row>
-       <entry>catalog</entry>
-       <entry>O nome do catálogo, sempre igual a "def"</entry>
-      </row>
-      <row>
-       <entry>max_length</entry>
-       <entry>O tamanho máximo do campo para o conjunto de resultados.</entry>
-      </row>
-      <row>
-       <entry>length</entry>
-       <entry>A largura do campo, como especificada na definição da tabela.</entry>
-      </row>
-      <row>
-       <entry>charsetnr</entry>
-       <entry>O número do conjunto de caracteres para o campo.</entry>
-      </row>
-      <row>
-       <entry>flags</entry>
-       <entry>Um inteiro representando os bits de opções para o campo.</entry>
-      </row>
-      <row>
-       <entry>type</entry>
-       <entry>O tipo de dados usado para este campo</entry>
-      </row>
-      <row>
-       <entry>decimals</entry>
-       <entry>O número de decimais usadas (para campos inteiros)</entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </table>
-  </para>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('mysqli-result.fetch-fields')/db:refsect1[@role='returnvalues']/db:table)">
+   <xi:fallback/>
+  </xi:include>
 </refsect1>

 <refsect1 role="examples">
--- a/reference/mysqli/mysqli_result/fetch-fields.xml
+++ b/reference/mysqli/mysqli_result/fetch-fields.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 301d51acc2b8f54edbbd00ce4fdbbe649e4ae192 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
+<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
 <refentry xml:id="mysqli-result.fetch-fields" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysqli_result::fetch_fields</refname>
@@ -42,66 +42,79 @@
  <para>
   Retorna um array de objetos contendo informações de definições de campo.
  </para>
-  <para>
-   <table xml:id="mysqli-result.fetch-fields.returnvalues">
-    <title>Propriedades dos objetos</title>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>Propriedade</entry>
-       <entry>Descrição</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>name</entry>
-       <entry>O nome da coluna</entry>
-      </row>
-      <row>
-       <entry>orgname</entry>
-       <entry>O nome original da coluna se foi especificado um apelido</entry>
-      </row>
-      <row>
-       <entry>table</entry>
-       <entry>O nome da tabela à qual o campo pertence (se não calculado)</entry>
-      </row>
-      <row>
-       <entry>orgtable</entry>
-       <entry>Nome da tabela original se foi especificado um apelido</entry>
-      </row>
-      <row>
-       <entry>max_length</entry>
-       <entry>A largura máxima do campo para o conjunto de resultados. A partir do PHP 8.1, este valor é sempre <literal>0</literal>.</entry>
-      </row>
-      <row>
-       <entry>length</entry>
-       <entry>
-        A largura do campo, em bytes, como especificada na definição da tabela. Note que
-        este número (bytes) pode ser diferente do valor na definição da tabela (caracteres), dependendo do
-        conjunto de caracteres sendo utilizado. Por exemplo, o conjunto de caracteres utf8 tem 3 bytes por caractere,
-        por isso varchar(10) retornará um comprimento de 30 for utf8 (10*3), mas retornará 10 para latin1 (10*1).
-       </entry>
-      </row>
-      <row>
-       <entry>charsetnr</entry>
-       <entry>O número (id) do conjunto de caracteres do campo.</entry>
-      </row>
-      <row>
-       <entry>flags</entry>
-       <entry>Um inteiro representando bits de opções para o campo.</entry>
-      </row>
-      <row>
-       <entry>type</entry>
-       <entry>O tipo de dados usado para este campo</entry>
-      </row>
-      <row>
-       <entry>decimals</entry>
-       <entry>O número de decimais usadas (para campos inteiros)</entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </table>
-  </para>
+
+  <table>
+   <title>Propriedades dos objetos</title>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>Propriedade</entry>
+      <entry>Descrição</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>name</entry>
+      <entry>O nome da coluna</entry>
+     </row>
+     <row>
+      <entry>orgname</entry>
+      <entry>O nome original da coluna se foi especificado um apelido</entry>
+     </row>
+     <row>
+      <entry>table</entry>
+      <entry>O nome da tabela à qual o campo pertence (se não calculado)</entry>
+     </row>
+     <row>
+      <entry>orgtable</entry>
+      <entry>Nome da tabela original se foi especificado um apelido</entry>
+     </row>
+     <row>
+      <entry>def</entry>
+      <entry>Não utilizado. Sempre uma string vazia</entry>
+     </row>
+     <row>
+      <entry>db</entry>
+      <entry>O nome do banco de dados</entry>
+     </row>
+     <row>
+      <entry>catalog</entry>
+      <entry>Não utilizado. Sempre <literal>"def"</literal></entry>
+     </row>
+     <row>
+      <entry>max_length</entry>
+      <entry>A largura máxima do campo para o conjunto de resultados. A partir do PHP 8.1, este valor é sempre <literal>0</literal>.</entry>
+     </row>
+     <row>
+      <entry>length</entry>
+      <entry>
+       O comprimento do campo em bytes. Para colunas de strings,
+       o valor do comprimento varia conforme o conjunto de caracteres. Por exemplo,
+       se o conjunto de caracteres for <literal>latin1</literal>, um conjunto de um byte,
+       o valor de comprimento para uma consulta <literal>SELECT 'abc'</literal> será 3.
+       Se o conjunto for <literal>utf8mb4</literal>, um conjunto multi-bytes
+       onde os caracteres podem ter até 4 bytes, o valor de comprimento será 12.
+      </entry>
+     </row>
+     <row>
+      <entry>charsetnr</entry>
+      <entry>O número do conjunto de caracteres do campo.</entry>
+     </row>
+     <row>
+      <entry>flags</entry>
+      <entry>Um inteiro representando bits de opções para o campo.</entry>
+     </row>
+     <row>
+      <entry>type</entry>
+      <entry>O tipo de dados usado para este campo</entry>
+     </row>
+     <row>
+      <entry>decimals</entry>
+      <entry>O número de decimais para campos numéricos, e a precisão em segundos fracionários para campos temporais.</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </table>
 </refsect1>

 <refsect1 role="examples">
--- a/reference/mysqlinfo/set.xml
+++ b/reference/mysqlinfo/set.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 02237d4e03cb1766cfee23f15aa333527d002702 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: f3c97392225bcb44afff9ddc86529179c81d0f8e Maintainer: leonardolara Status: ready -->

 <set xml:id="set.mysqlinfo">
 <title>Drivers e Plugins MySQL</title>
@@ -21,26 +21,24 @@
 <book xml:id="mysql">
  <title>Visão geral dos drivers PHP para MySQL</title>

-  <info xml:id="mysqlinfo.intro">
+  <preface xml:id="mysqlinfo.intro">
   <title>Introdução</title>
-   <abstract>
-    <para>
-     Existem muitas APIs de PHP
-     para acessar bancos de dados MySQL. Os usuários podem escolher entre as
-     extesões <link linkend="book.mysqli">mysqli</link> ou
-     <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
-    </para>
-    <para>
-     Este guia explica a
-     <link linkend="mysqlinfo.terminology">terminologia</link> usada para descrever
-     cada API, informação sobre a
-     <link linkend="mysqlinfo.api.choosing">escolha de qual API</link> a
-     ser usada, e também informação para ajudar a escolher qual
-     <link linkend="mysqlinfo.library.choosing">biblioteca</link> MySQL a ser usada com
-     a API.
-    </para>
-   </abstract>
-  </info>
+   <para>
+    Existem muitas APIs de PHP
+    para acessar bancos de dados MySQL. Os usuários podem escolher entre as
+    extesões <link linkend="book.mysqli">mysqli</link> ou
+    <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
+   </para>
+   <para>
+    Este guia explica a
+    <link linkend="mysqlinfo.terminology">terminologia</link> usada para descrever
+    cada API, informação sobre a
+    <link linkend="mysqlinfo.api.choosing">escolha de qual API</link> a
+    ser usada, e também informação para ajudar a escolher qual
+    <link linkend="mysqlinfo.library.choosing">biblioteca</link> MySQL a ser usada com
+    a API.
+   </para>
+  </preface>

  <chapter xml:id="mysqlinfo.terminology" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Visão geral de terminologia</title>
--- a/reference/outcontrol/flushing-system-buffers.xml
+++ b/reference/outcontrol/flushing-system-buffers.xml
@@ -1,16 +1,18 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7610e990293c87168d026ad078d8272e643e2c23 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7ad99aeafea66a1562f668aa3cb11dcc9d9cb951 Maintainer: leonardolara Status: ready -->
 <chapter xml:id="outcontrol.flushing-system-buffers" xmlns="http://docbook.org/ns/docbook">
+ <title>Descarregando Buffers de Sistema</title>
+ <para>
+  O PHP fornece duas maneiras relacionadas
+  para descarregar os buffers de sistema (enviar e descartar o conteúdo):
+  chamando-se a função <function>flush</function>
+  e habilitando o descarregamento implicitamente
+  com a função <function>ob_implicit_flush</function>
+  ou com a configuração <link linkend="ini.implicit-flush">implicit_flush</link>
+  do &php.ini;.
+ </para>
+
 <section>
-  <title>Descarregando Buffers de Sistema</title>
-  <para>
-   O PHP fornece duas maneiras relacionadas
-   para descarregar os buffers de sistema (enviar e descartar o conteúdo):
-   chamando-se a função <function>flush</function>
-   e habilitando o descarregamento implicitamente
-   com a função <function>ob_implicit_flush</function>
-   ou com a configuração <link linkend="ini.implicit-flush">implicit_flush</link>
-   do &php.ini;.
-  </para>
+  <title>Comportamento do Descarregameto da Saída</title>
  <para>
   Com o descarregamento implícito desabilitado, o PHP irá descarregar a saída somente
   quendo <function>flush</function> for chamada ou quando o script terminar.
--- a/reference/outcontrol/output-buffering.xml
+++ b/reference/outcontrol/output-buffering.xml
@@ -1,15 +1,13 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7610e990293c87168d026ad078d8272e643e2c23 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7ad99aeafea66a1562f668aa3cb11dcc9d9cb951 Maintainer: leonardolara Status: ready -->
 <chapter xml:id="outcontrol.output-buffering" xmlns="http://docbook.org/ns/docbook">
- <section>
-  <title>Buffer de Saída</title>
-  <para>
-   O buffer de saída é o buffer (armazenamento temporário) da saída
-   antes de ela ser descarregada (enviada e descartada) para o navegador (em um contexto da web)
-   ou para o shell (na linha de comando).
-   Enquanto o buffer de saída estiver ativo, nenhuma saída será enviada do script;
-   em vez disso, a saída será armazenada em um buffer interno.
-  </para>
- </section>
+ <title>Buffer de Saída</title>
+ <para>
+  O buffer de saída é o buffer (armazenamento temporário) da saída
+  antes de ela ser descarregada (enviada e descartada) para o navegador (em um contexto da web)
+  ou para o shell (na linha de comando).
+  Enquanto o buffer de saída estiver ativo, nenhuma saída será enviada do script;
+  em vez disso, a saída será armazenada em um buffer interno.
+ </para>

 <section>
  <title>Buffer Afetando o PHP</title>
--- a/reference/outcontrol/user-level-output-buffers.xml
+++ b/reference/outcontrol/user-level-output-buffers.xml
@@ -1,14 +1,12 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 0ec4999397fd6f7dd382120d620b72e48103a683 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7ad99aeafea66a1562f668aa3cb11dcc9d9cb951 Maintainer: leonardolara Status: ready -->
 <chapter xml:id="outcontrol.user-level-output-buffers" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
- <section>
-  <title>Buffers de Saída em Nível de Usuário</title>
-  <para>
-   Os buffers de saída no nível do usuário podem ser iniciados, manipulados
-   e finalizados a partir do código PHP.
-   Cada um desses buffers inclui um buffer de saída
-   e uma função de manipulador de saída associada.
-  </para>
- </section>
+ <title>Buffers de Saída em Nível de Usuário</title>
+ <para>
+  Os buffers de saída no nível do usuário podem ser iniciados, manipulados
+  e finalizados a partir do código PHP.
+  Cada um desses buffers inclui um buffer de saída
+  e uma função de manipulador de saída associada.
+ </para>

 <section xml:id="outcontrol.what-output-is-buffered">
  <title>Que Saída é Armazenada em Buffer?</title>
--- a/reference/pcre/functions/preg-replace.xml
+++ b/reference/pcre/functions/preg-replace.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 31b22987dd66a0251de914029b9f1b4c377bf9af Maintainer: leonardolara Status: ready --><!-- CREDITS: FelipeBarth, adiel, leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: FelipeBarth, adiel, leonardolara -->
 <refentry xml:id="function.preg-replace" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>preg_replace</refname>
@@ -314,7 +314,7 @@ xp***to
    como inversão de dois valores, substitua um padrão por uma referência intermediária, e então em um par
    posterior substitua a referência intermediária pelo substituto desejado.
   </para>
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -325,7 +325,7 @@ print_r(preg_replace($p, $r, 'a'));
 ?>
 ]]>
    </programlisting>
-   </example>
+   </informalexample>
  </note>
 </refsect1>

--- a/reference/session/sessionhandler.xml
+++ b/reference/session/sessionhandler.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
 <phpdoc:classref xml:id="class.sessionhandler" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A classe SessionHandler</title>
@@ -85,6 +85,7 @@
  </section>

  <section xml:id="session.notes">
+   &reftitle.notes;
   <warning>
    <para>
     Esta classe é projetada para expor o manipulador interno do PHP de gravação de sessão; se você quiser
@@ -95,6 +96,7 @@
  </section>

  <section xml:id="sessionhandler.examples">
+   &reftitle.examples;
   <example>
    <title>
     Usando <classname>SessionHandler</classname> para adicionar criptografia aos manipuladores internos do PHP de gravação.
--- a/reference/session/sessionhandlerinterface.xml
+++ b/reference/session/sessionhandlerinterface.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
 <phpdoc:classref xml:id="class.sessionhandlerinterface" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A classe SessionHandlerInterface</title>
@@ -42,6 +42,7 @@
  </section>

  <section xml:id="sessionhandlerinterface.examples">
+   &reftitle.examples;
   <example>
    <title>
     Exemplo usando <classname>SessionHandlerInterface</classname>
--- a/reference/spl/directoryiterator/getextension.xml
+++ b/reference/spl/directoryiterator/getextension.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: KinnCoelhoJulião -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: KinnCoelhoJulião -->
 <refentry xml:id="directoryiterator.getextension" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>DirectoryIterator::getExtension</refname>
@@ -68,7 +68,7 @@ gz
    Outra maneira de obter a extensão é utilizar a função
    <function>pathinfo</function>.
   </para>
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -76,7 +76,7 @@ $extension = pathinfo($fileinfo->getFilename(), PATHINFO_EXTENSION);
 ?>
 ]]>
    </programlisting>
-   </example>
+   </informalexample>
  </note>
 </refsect1>

--- a/reference/spl/seekableiterator.xml
+++ b/reference/spl/seekableiterator.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <phpdoc:classref xml:id="class.seekableiterator" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

 <title>A interface SeekableIterator</title>
@@ -45,6 +45,7 @@
  </section>

  <section xml:id="seekableiterator.examples">
+   &reftitle.examples;
   <example xml:id="seekableiterator.examples.basic"><!-- {{{ -->
    <title>Utilização básica</title>
    <para>
--- a/reference/spl/splfileinfo/getextension.xml
+++ b/reference/spl/splfileinfo/getextension.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <refentry xml:id="splfileinfo.getextension" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SplFileInfo::getExtension</refname>
@@ -69,7 +69,7 @@ string(2) "gz"
    Outra maneira de obter a extensão é usar a
    função <function>pathinfo</function>.
   </para>
-   <example>
+   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -77,7 +77,7 @@ $extension = pathinfo($info->getFilename(), PATHINFO_EXTENSION);
 ?>
 ]]>
    </programlisting>
-   </example>
+   </informalexample>
  </note>
 </refsect1>

--- a/reference/strings/functions/substr.xml
+++ b/reference/strings/functions/substr.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 49299f8b46e7d259b78f22c057be1cdefe22da43 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
+<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
 <refentry xml:id="function.substr" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>substr</refname>
@@ -218,27 +218,25 @@ echo "7) ".var_export(substr(1.2e3, 0, 4), true).PHP_EOL;
     Se uma faixa inválida de caracteres for requisitada, <function>substr</function> retorna
     uma string vazia a partir do PHP 8.0.0; anteriormente, &false; era retornado.
    </para>
-    <example>
-     <programlisting role="php">
+    <programlisting role="php">
 <![CDATA[
 <?php
 var_dump(substr('a', 2));
 ?>
 ]]>
-     </programlisting>
-     &example.outputs.8;
-     <screen>
+    </programlisting>
+    &example.outputs.8;
+    <screen>
 <![CDATA[
 string(0) ""
 ]]>
-     </screen>
-     &example.outputs.7;
-     <screen>
+    </screen>
+    &example.outputs.7;
+    <screen>
 <![CDATA[
 bool(false)
 ]]>
-     </screen>
-    </example>
+    </screen>
   </example>
  </para>
 </refsect1>