sync with en rev

2026-03-23 22:52:12 +01:00 · 2025-11-16 12:23:40 -03:00
parent c07a4b8cd7
commit 6a7c54dab3
7 changed files with 37 additions and 44 deletions
--- a/appendices/filters.xml
+++ b/appendices/filters.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,diegopires,adiel,fibbarth,ae,leonardolara -->
+<!-- EN-Revision: 3f1dbc451b313fb1ec8058f24c1beccf55fce316 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,diegopires,adiel,fibbarth,ae,leonardolara -->
 <appendix xml:id="filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Lista de Filtros Disponíveis</title>
 <para>
@@ -118,9 +118,7 @@ fwrite($fp, "Isto é um teste.\n");
    segundo parâmetro da função <function>strip_tags</function>,
    ou como um array com os nomes das tags.
   </simpara>
-   <para>
-    &warn.deprecated.feature-7-3-0;
-   </para>
+   &warn.deprecated.feature-7-3-0;
   <example>
    <title>string.strip_tags</title>
    <programlisting role="php">
@@ -464,9 +462,7 @@ O arquivo comprimido tem 1488 bytes.

  <section xml:id="filters.encryption.mcrypt">
   <title>mcrypt.* e mdecrypt.*</title>
-   <para>
-     &warn.deprecated.feature-7-1-0;
-   </para>
+   &warn.deprecated.feature-7-1-0;

   <simpara>
    Os filtros <literal>mcrypt.*</literal> e <literal>mdecrypt.*</literal>
--- a/appendices/migration85/incompatible.xml
+++ b/appendices/migration85/incompatible.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ec45af749649dc0d6a23eaedeed1b601f7460813 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 87d781c7710702181b0d0669cf2c4d0f5c9d3037 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration85.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Alterações Incompatíveis com Versões Anteriores</title>

@@ -121,10 +121,10 @@
  </sect3>

  <sect3 xml:id="migration85.incompatible.core.destruct-non-array-values">
-   <title>Destruindo valores não-array</title>
+   <title>Desconstruindo valores não-array</title>

   <simpara>
-    Destruir valores não-array (diferentes de &null;) usando <literal>[]</literal> ou <function>list</function> agora
+    Desconstruir valores não-array (diferentes de &null;) usando <literal>[]</literal> ou <function>list</function> agora
    emite um alerta.
    <!-- RFC: https://wiki.php.net/rfc/warnings-php-8-5#destructuring_non-array_values -->
   </simpara>
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 239683eb0b1d6163da56a604d3ae1ecac0373bdd Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 69fe083419b7888f6d424595771d54fe2d850d9d 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: '>

@@ -346,6 +346,11 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
 <emphasis>DESCONTINUADA</emphasis> a partir do PHP 8.0.0. O uso desta função
 é fortemente desencorajado.</simpara></warning>'>

+<!ENTITY warn.deprecated.feature-8-1-0 '<warning
+xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso foi
+<emphasis>DESCONTINUADO</emphasis> a partir do PHP 8.1.0. O uso deste recurso
+é fortemente desencorajado.</simpara></warning>'>
+
 <!ENTITY warn.deprecated.function-8-1-0 '<warning
 xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
 <emphasis>DESCONTINUADA</emphasis> a partir do PHP 8.1.0. O uso desta função
--- a/language/types/null.xml
+++ b/language/types/null.xml
@@ -1,24 +1,24 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: fabioluciano Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, marcosmarcolin -->
+<!-- EN-Revision: 3f1dbc451b313fb1ec8058f24c1beccf55fce316 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, marcosmarcolin, leonardolara -->
 <sect1 xml:id="language.types.null">
 <title>NULL</title>

 <para>
-  O tipo <type>null</type> é o tipo unitário do PHP, ou seja, possui apenas um valor:
+  O tipo <type>null</type> é um tipo unitário do PHP, ou seja, possui apenas um valor:
  &null;.
 </para>

 <para>
-  Variáveis indefinidas e <function>unset</function> resolverão para o
-  valor &null;.
+  Variáveis indefinidas e com desfinição removida por <function>unset</function> serão interpretadas como
+  &null;.
 </para>

 <sect2 xml:id="language.types.null.syntax">
  <title>Sintaxe</title>

  <para>
-   Há apenas um valor do tipo <type>null</type>,
-   a constante case-insensitive &null;.
+   Há apenas um valor do tipo <type>null</type>, que é a
+   a constante &null;, insensível a maiúsculas/minúsculas.
  </para>

  <informalexample>
@@ -35,14 +35,12 @@ $var = NULL;
 <sect2 xml:id="language.types.null.casting">
  <title>Convertendo para &null;</title>

-  <para>
-   &warn.deprecated.feature-7-2-0.removed-8-0-0;
-  </para>
+  &warn.deprecated.feature-7-2-0.removed-8-0-0;

  <para>
   Converter uma variável para <type>null</type> utilizando <literal>(unset) $var</literal>
-   <emphasis>não</emphasis> removerá a variável ou apagará seu valor.
-   Apenas retornará &null; como valor.
+   <emphasis>não</emphasis> removerá nem a variável nem o seu valor.
+   Apenas retornará um valor &null;.
  </para>

 </sect2>
--- a/reference/info/constants.xml
+++ b/reference/info/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9fd978fa05772318164be04d0f769902c7fb8648 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 3f1dbc451b313fb1ec8058f24c1beccf55fce316 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <appendix xml:id="info.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants.core;
@@ -263,8 +263,8 @@
   <listitem>
    <para>
     Habilita avaliação da função <function xmlns="http://docbook.org/ns/docbook">assert</function>.
-     &warn.deprecated.feature-8-3-0;
    </para>
+    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-callback">
@@ -275,8 +275,8 @@
   <listitem>
    <para>
     Função de retorno a ser chamada em afirmações falhadas.
-     &warn.deprecated.feature-8-3-0;
    </para>
+    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-bail">
@@ -287,8 +287,8 @@
   <listitem>
    <para>
     Termina execução em afirmações falhadas.
-     &warn.deprecated.feature-8-3-0;
    </para>
+    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-exception">
@@ -299,8 +299,8 @@
   <listitem>
    <para>
     Emite uma <classname>AssertionError</classname> para cada afirmação falhada.
-     &warn.deprecated.feature-8-3-0;
    </para>
+    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-warning">
@@ -311,8 +311,8 @@
   <listitem>
    <para>
     Emite um alerta do PHP para cada afirmação falhada.
-     &warn.deprecated.feature-8-3-0;
    </para>
+    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-quiet-eval">
--- a/reference/mbstring/overloading.xml
+++ b/reference/mbstring/overloading.xml
@@ -1,16 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 669c19f74eba53dc8437027380ecc6a6a59ab0bf Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 3f1dbc451b313fb1ec8058f24c1beccf55fce316 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->

 <chapter xml:id="mbstring.overload" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>
  Recurso de Sobrecarga de Funções
 </title>

+ &warn.deprecated.feature-7-2-0.removed-8-0-0;
 <para>
-  &warn.deprecated.feature-7-2-0.removed-8-0-0;
- </para>
- <para>
-  Você pode frequentemente encontrar dificuldades ao fazer com que uma aplicação PHP existente
+  É possível que frequentemente sejam encontradas dificuldades ao fazer com que uma aplicação PHP existente
  funcione em um ambiente multibyte específico. Isso acontece porque a maioria
  das aplicações PHP por aí são escritas com funções de string padrão
  como <function>substr</function>, que são conhecidas por
--- a/reference/pdo/constants.fetch-modes.xml
+++ b/reference/pdo/constants.fetch-modes.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 7e384b24f7e37c6b4caf735f3601179cc65ef8f9 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 86d3fb841e0206e2588896ad3c21432333535848 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <section xmlns="http://docbook.org/ns/docbook" xml:id="pdo.constants.fetch-modes">
 <title>Modos de Busca</title>

@@ -865,12 +865,7 @@ object(TestEntity)#3 (4) {

 <section xml:id="pdo.constants.fetch-serialize" annotations="chunk:false">
  <title>PDO::FETCH_SERIALIZE (<type>int</type>)</title>
-  <warning>
-   <simpara>
-    Este recurso foi <emphasis>DESCONTINUADO</emphasis> a partir do PHP 8.1.0.
-    O uso deste recurso é altamente desencorajado.
-   </simpara>
-  </warning>
+  &warn.deprecated.feature-8-1-0;
  <simpara>
   Este modo de busca só pode ser usado em combinação com
   <constant>PDO::FETCH_CLASS</constant> (e
@@ -912,14 +907,16 @@ class TestEntity implements Serializable
            . (isset($this->name) ? 'Sim' : 'Não') . "\n";
    }

-    public function serialize() {
+    public function serialize()
+    {
        return join(
            "|",
            [$this->userid, $this->name, $this->country, $this->referred_by_userid]
        );
    }

-    public function unserialize(string $data) {
+    public function unserialize(string $data)
+    {
        $parts = explode("|", $data);
        $this->userid = (int) $parts[0];
        $this->name = $parts[1];
@@ -946,7 +943,7 @@ $origObj->referred_by_userid = null;
 $insert = $db->prepare("INSERT INTO serialize (sdata) VALUES (:sdata)");
 $insert->execute(['sdata' => $origObj->serialize()]);

-print "\nRecuperando o resultado:\n"
+print "\nRecuperando o resultado:\n";
 $query = "SELECT sdata FROM serialize";
 $stmt = $db->query($query);
 // NOTA: O construtor nunca é chamado!
@@ -1016,7 +1013,6 @@ $stmt->bindColumn('country', $country);
 // Por exemplo: referrer.name AS referrer_name
 $stmt->bindColumn(4, $referrerName);

-print "\nbusca:\n";
 while ($stmt->fetch(\PDO::FETCH_BOUND)) {
    print join("\t", [$userId, $name, $country, ($referrerName ?? 'NULL')]) . "\n";
 }