sync with en rev

php · Oct 24, 2024 · e3565fb · e3565fb
1 parent 3faa79f
commit e3565fb
Show file tree

Hide file tree

Showing 11 changed files with 277 additions and 332 deletions.
diff --git a/appendices/migration84/deprecated.xml b/appendices/migration84/deprecated.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: d64e811eac61a5c7c744312d8bc6e2244de81488 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: b1b039696eedcc82e9c1144eeecbfc0a8a1b3859 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration84.deprecated">
  <title>Recursos Descontinuados</title>
 
@@ -337,7 +337,7 @@ class _MyClass {}
   <simpara>
    <function>lcg_value</function> foi descontinuada,
    já que esta função foi quebrada de várias maneiras.
-   Alternativamente, o método <methodname>\Random\Randomizer::getFloat</methodname> deve ser usado.
+   Alternativamente, o método <methodname>Random\Randomizer::getFloat</methodname> deve ser usado.
   </simpara>
  </sect2>
 

diff --git a/appendices/migration84/incompatible.xml b/appendices/migration84/incompatible.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 4309102ef25eba1a9aa5a87d24e679286b7927e9 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: b1b039696eedcc82e9c1144eeecbfc0a8a1b3859 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration84.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Alterações Incompatíveis com Versões Anteriores</title>
 
@@ -459,10 +459,10 @@
 
   <simpara>
    Alguns métodos DOM anteriormente retornavam &false; ou uma exceção
-   <exceptionname>DOMException</exceptionname> <constant>PHP_ERR</constant>
-   se um novo nó não pudesse ser alocado.
+   <exceptionname>DOMException</exceptionname> com código
+   <constant>DOM_PHP_ERR</constant> se um novo nó não pudesse ser alocado.
    Eles agora lançam consistentemente uma exceção <exceptionname>DOMException</exceptionname>
-   <constant>INVALID_STATE_ERR</constant>.
+   com código <constant>DOM_INVALID_STATE_ERR</constant>.
    Esta situação é extremamente improvável e a probabilidade de ser afetado
    é baixa.
    Como resultado, <methodname>DOMImplementation::createDocument</methodname>
@@ -626,8 +626,8 @@
   <title>PDO_DBLIB</title>
 
   <simpara>
-   Os atributos <constant>DBLIB_ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant> e
-   <constant>DBLIB_ATTR_DATETIME_CONVERT</constant> agora atuam como
+   Os atributos <constant>Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant> e
+   <constant>Pdo\Dblib::ATTR_DATETIME_CONVERT</constant> agora atuam como
    atributos booleanos em vez de atributos inteiros.
    Assim, definir o atributo via <methodname>PDO::setAttribute</methodname>
    e recuperá-lo via <methodname>PDO::getAttribute</methodname> espera
@@ -639,7 +639,7 @@
   <title>PDO_FIREBIRD</title>
 
   <simpara>
-   O atributo <constant>ATTR_AUTOCOMMIT</constant> agora atua como
+   O atributo <constant>PDO::ATTR_AUTOCOMMIT</constant> agora atua como
    atributos booleanos em vez de atributos inteiros.
    Assim, definir o atributo via <methodname>PDO::setAttribute</methodname>
    e recuperá-lo via <methodname>PDO::getAttribute</methodname> espera
@@ -657,9 +657,9 @@
   <title>PDO_MYSQL</title>
 
   <simpara>
-   Os atributos <constant>ATTR_AUTOCOMMIT</constant>,
-   <constant>ATTR_EMULATE_PREPARES</constant> e
-   <constant>MYSQL_ATTR_DIRECT_QUERY</constant> agora atuam como
+   Os atributos <constant>PDO::ATTR_AUTOCOMMIT</constant>,
+   <constant>PDO::ATTR_EMULATE_PREPARES</constant> e
+   <constant>PDO::MYSQL_ATTR_DIRECT_QUERY</constant> agora atuam como
    atributos booleanos em vez de atributos inteiros.
    Assim, definir o atributo via <methodname>PDO::setAttribute</methodname>
    e recuperá-lo via <methodname>PDO::getAttribute</methodname> espera

diff --git a/appendices/migration84/other-changes.xml b/appendices/migration84/other-changes.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ea61eef42bca712fe78f86ae71abab77950ee6fe Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: b1b039696eedcc82e9c1144eeecbfc0a8a1b3859 Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="migration84.other-changes">
  <title>Outras Alterações</title>
 
@@ -371,7 +371,7 @@
 
    <simpara>
     O parâmetro <parameter>backlog</parameter> da função
-    <function>socket_create_listen(</function> agora tem um valor padrão de
+    <function>socket_create_listen</function> agora tem um valor padrão de
     <constant>SOMAXCONN</constant>.
     Anteriormente, era <literal>128</literal>.
    </simpara>
@@ -446,39 +446,50 @@
     <title>Arredondando com <function>round</function></title>
 
     <simpara>
-     O parâmetro $mode da função round() foi ampliado para RoundingMode|int,
-     aceitando instâncias de uma nova enumeração RoundingMode.
+     O parâmetro <parameter>mode</parameter> da
+     função <function>round</function> foi ampliado para
+     <!-- TODO Proper union type -->
+     <literal>RoundingMode|int</literal>,
+     <!-- TODO should be <enumname> ? -->
+     aceitando instâncias de uma nova enumeração <classname>RoundingMode</classname>.
      <!-- RFC: https://wiki.php.net/rfc/correctly_name_the_rounding_mode_and_make_it_an_enum -->
     </simpara>
 
-    <simpara>
-     Quatro novos modos foram adicionados à função round(): RoundingMode::PositiveInfinity,
-     RoundingMode::NegativeInfinity, RoundingMode::TowardsZero, RoundingMode::AwayFromZero.
+    <para>
+     Quatro novos modos foram adicionados à função <function>round</function>:
+     <simplelist type="inline">
+      <member><!-- <enumidentifier> -->RoundingMode::PositiveInfinity<!-- </enumidentifier> --></member>
+      <member><!-- <enumidentifier> -->RoundingMode::NegativeInfinity<!-- </enumidentifier> --></member>
+      <member><!-- <enumidentifier> -->RoundingMode::TowardsZero<!-- </enumidentifier> --></member>
+      <member><!-- <enumidentifier> -->RoundingMode::AwayFromZero<!-- </enumidentifier> --></member>
+     </simplelist>
      <!-- RFC: https://wiki.php.net/rfc/new_rounding_modes_to_round_function -->
-    </simpara>
+    </para>
 
     <simpara>
      A implementação interna para arredondamento para números inteiros foi reescrita
      para ser mais fácil de verificar a precisão e para ser mais fácil de manter.
      Alguns problemas de arredondamento foram corrigidos como resultado da reescrita.
-     Por exemplo, arredondar anteriormente 0.49999999999999994 para o número inteiro mais próximo
-     teria resultado em 1.0 em vez do resultado correto 0.0.
+     Por exemplo, arredondar anteriormente <literal>0.49999999999999994</literal>
+     para o número inteiro mais próximo resultaria em <literal>1.0</literal>
+     ao invés do resultado correto <literal>0.0</literal>.
      Entradas adicionais também podem ser afetadas e resultar em resultados diferentes
      em comparação com versões anteriores do PHP.
     </simpara>
 
     <simpara>
-     Foi corrigido um problema causado pelo "pré-arredondamento" da função round().
-     Anteriormente, era usado um "pré-arredondamento" para tratar um valor como 0.285
-     (na verdade 0.28499999999999998) como um número decimal e arredondá-lo para 0.29.
+     Foi corrigido um problema causado pelo "pré-arredondamento" da função <function>round</function>.
+     Anteriormente, era usado um "pré-arredondamento" para tratar um valor como <literal>0.285</literal>
+     (na verdade <literal>0.28499999999999998</literal>) como um número decimal
+     e arredondá-lo para <literal>0.29</literal>.
      No entanto, o "pré-arredondamento" arredonda incorretamente determinados números,
      portanto, essa correção remove o "pré-arredondamento" e altera a forma como os números são comparados,
      para que os valores sejam arredondados corretamente como números decimais.
     </simpara>
 
     <simpara>
-     A precisão máxima que pode ser tratada por round() foi estendida
-     em um dígito.
+     A precisão máxima que pode ser tratada por <function>round</function>
+     foi estendida em um dígito.
      Por exemplo, <code>round(4503599627370495.5)</code> retornava
      <literal>4503599627370495.5</literal>,
      mas agora retorna <literal>4503599627370496</literal>.
@@ -617,9 +628,9 @@
    <simpara>
     Foi melhorado o desempenho da análise e formatação de números de ponto flutuante em
     compilações ZTS sob cargas altamente simultâneas.
-    Isso afeta a família de funções <function>printf()</function>, bem como
+    Isso afeta a família de funções <function>printf</function>, bem como
     funções de serialização, como <function>json_encode</function>
-    ou <function>serialize()</function>.
+    ou <function>serialize</function>.
    </simpara>
 
    <simpara>
@@ -642,7 +653,7 @@
    <title>DOM</title>
 
    <simpara>
-    O desempenho de <methodname>DOMNode::C14N()</methodname> foi bastante
+    O desempenho de <methodname>DOMNode::C14N</methodname> foi bastante
     melhorado para o caso sem uma consulta xpath.
     Isso pode proporcionar uma melhoria de tempo de facilmente duas ordens de
     magnitude para documentos com dezenas de milhares de nós.
@@ -714,10 +725,10 @@
    <title>Random</title>
 
    <simpara>
-    Melhorado o desempenho de <classname>\Random\Randomizer</classname>,
+    Melhorado o desempenho de <classname>Random\Randomizer</classname>,
     com foco específico nos métodos
-    <methodname>\Random\Randomizer::getBytes</methodname>
-    e <methodname>getBytesFromString()</methodname>.
+    <methodname>Random\Randomizer::getBytes</methodname>
+    e <methodname>Random\Randomizer::getBytesFromString</methodname>.
    </simpara>
   </sect3>
 

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 27ae0a4a16cdfc868a884c0f0dad7023b5f2709c Maintainer: adiel 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: '>
 
@@ -3774,6 +3774,50 @@ local: {
 '>
 
 <!-- strings snippets -->
+<!ENTITY strings.stripped.characters '
+ <itemizedlist xmlns="http://docbook.org/ns/docbook">
+    <listitem>
+     <simpara>
+      <literal>" "</literal> (<acronym>ASCII</acronym> 32 (0x20)), um espaço normal.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      <literal>"\t"</literal> (<acronym>ASCII</acronym> 9 (0x09)), uma tabulação.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      <literal>"\n"</literal> (<acronym>ASCII</acronym> 10 (0x0A)), uma nova linha (alimentação de linha).
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      <literal>"\r"</literal> (<acronym>ASCII</acronym> 13 (0x0D)), um retorno de carro.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      <literal>"\0"</literal> (<acronym>ASCII</acronym> 0 (0x00)), o byte NUL.
+     </simpara>
+    </listitem>
+    <listitem>
+     <simpara>
+      <literal>"\v"</literal> (<acronym>ASCII</acronym> 11 (0x0B)), uma tabulação vertical.
+     </simpara>
+    </listitem>
+   </itemizedlist>
+'>
+
+<!ENTITY strings.parameter.characters.optional '
+ <simpara xmlns="http://docbook.org/ns/docbook">
+  Opcionalmente, os caracteres removidos também podem ser especificados usando
+  o parâmetro <parameter>characters</parameter>.
+  Simplesmente liste todos os caracteres que precisam ser removidos.
+  Com <literal>..</literal> é possível especificar um intervalo incremental de caracteres.
+ </simpara>
+'>
+
 <!ENTITY strings.parameter.encoding '
  <para xmlns="http://docbook.org/ns/docbook">
   Um argumento opcional que define a codificação usada na conversão de caracteres.

diff --git a/reference/dba/setup.xml b/reference/dba/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 8b2eba9e48eb1037f11aef36820db6b5b07fa08c Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 
 <chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -218,9 +218,8 @@
  <section xml:id="dba.resources">
   &reftitle.resources;
   <para>
-   As funções <function>dba_open</function> e
-   <function>dba_popen</function> retornam um identificador para o arquivo de
-   banco de dados especificado para acesso, que é usado por todas as outras chamadas de função dba.
+   Antes do PHP 8.4.0, a maioria das funções DBA retornavam ou operavam sobre recursos (ex.: <function>dba_open</function>
+   retorna um identificador positivo de conexão DBA requerido pela maior parte das funções DBA).
   </para>
  </section>
  <!-- }}} -->

diff --git a/reference/dom/domxpath.xml b/reference/dom/domxpath.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 0185cc34ca3528205e3bda346a4d907c28a57bc5 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <!--
 Remove me once you perform substitutions
     domxpath
@@ -87,6 +87,14 @@ Remove me once you perform substitutions
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Não é mais possível clonar um objeto <classname>DOMXPath</classname>.
+        Fazer isso resultará no lançamento de uma exceção.
+        Antes do PHP 8.4.0 isso resultava em um objeto não utilizável.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>