Updates due to en revision (php#598)

* updates due to en revision * Delete reference/curl/constants.xml * update due to en revision * update due to en revision * Update fdiv.xml * Update is-finite.xml * Update is-infinite.xml * Update is-nan.xml
adielcristo · Apr 17, 2024 · 826935c · 826935c
1 parent b2f370a
commit 826935c
Show file tree

Hide file tree

Showing 26 changed files with 148 additions and 105 deletions.
diff --git a/appendices/migration83/other-changes.xml b/appendices/migration83/other-changes.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 307ee0078a4c33f4766e3f467612be7c528327ec Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: e1e0c52f12f7f01724d36b12cb0044ecb0c3f20d Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
 <sect1 xml:id="migration83.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Outras mudanças</title>
 
@@ -386,9 +386,9 @@
    </para>
 
    <para>
-    <function>proc_open</function> retorna falso se o array <parameter>$command</parameter>
+    <function>proc_open</function> retorna &false; se o array <parameter>$command</parameter>
     for inválido, em vez de um objeto do tipo resource que produz um aviso posteriormente.
-    Este já era o comportamento no Windows mas agora também é aplicável se a implementação
+    Este já era o comportamento no Windows mas agora também é aplicável se uma implementação
     posix_spawn estiver em uso (maioria das plataformas Linux, BSD e MacOS). Ainda existem
     algumas plataformas antigas onde este comportamento não foi alterado já que posix_spawn não
     é suportado nelas.
@@ -404,9 +404,9 @@
    </para>
 
    <para>
-    O parâmetro <parameter>$decimal</parameter> da função <function>number_format</function>
+    O parâmetro <parameter>$decimals</parameter> da função <function>number_format</function>
     agora lida corretamente com números inteiros negativos.
-    Arredondar com um valor negativo para <parameter>$decimal</parameter> significa
+    Arredondar com um valor negativo para <parameter>$decimals</parameter> significa
     que <parameter>$num</parameter> é arredondado para <parameter>$decimals</parameter>
     dígitos significativos antes do ponto decimal.
     Anteriormente, valores negativos para <parameter>$decimals</parameter> eram silenciosamente

diff --git a/language/operators/bitwise.xml b/language/operators/bitwise.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 43d07782b514d0c7a8487f2c74063739f302df8d Maintainer: ae Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: ae Status: ready --><!-- CREDITS: ae,leonardolara -->
 <sect1 xml:id="language.operators.bitwise">
  <title>Operadores Binários</title>
  <titleabbrev>Binários</titleabbrev>
@@ -646,7 +646,7 @@ Expressão: 0 = -4 << 62
  <warning>
   <para>
    Utilize as funções da extensão <link linkend="book.gmp">gmp</link> para manipulações
-   de troca de bit em números maiores que <literal>PHP_INT_MAX</literal>.
+   de troca de bit em números maiores que <constant>PHP_INT_MAX</constant>.
   </para>
  </warning>
 

diff --git a/language/predefined/closure/bindto.xml b/language/predefined/closure/bindto.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9c74079f12d67cabb52c124d761f48275417d7eb Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 2a4874ed531bcc223ca4bc1b4f9a5292594abaea Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="closure.bindto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Closure::bindTo</refname>
@@ -97,14 +97,21 @@
 <![CDATA[
 <?php
 
-class A {
+class A
+{
     private $val;
-    function __construct($val) {
+
+    public function __construct($val)
+    {
         $this->val = $val;
     }
-    function getClosure() {
-        //retorna a closure ligada a este objeto e escopo
-        return function() { return $this->val; };
+
+    public function getClosure()
+    {
+        // Retorna a closure ligada a este objeto e escopo
+        return function() {
+            return $this->val;
+        };
     }
 }
 
@@ -113,8 +120,10 @@ $ob2 = new A(2);
 
 $cl = $ob1->getClosure();
 echo $cl(), "\n";
+
 $cl = $cl->bindTo($ob2);
 echo $cl(), "\n";
+
 ?>
 ]]>
    </programlisting>

diff --git a/preface.xml b/preface.xml
@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 20921e0003650cf65965d91b038bb98771d49f37 Maintainer: ae Status: ready --><!-- CREDITS: rarruda -->
+<!-- EN-Revision: 95b8f4df6657b1bc07bcb91679164b7b49ca63ac Maintainer: ae Status: ready --><!-- CREDITS: rarruda,leonardolara -->
 
 <preface xml:id="preface" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
  <info><title>Prefácio</title>
  <abstract>
   <simpara>
    <acronym>PHP</acronym>, que significa &quot;<literal>PHP: Hypertext
-   Preprocessor</literal>&quot;, é uma linguagem de programação de ampla utilização,
-   interpretada, que é especialmente interessante para desenvolvimento
-   para a web e pode ser mesclada dentro do código HTML. A sintaxe da linguagem
-   lembra C, Java e Perl, e é fácil de aprender. O objetivo principal da
+   Preprocessor</literal>&quot; (pré-processador de hipertexto), é uma linguagem de script
+   de uso geral de código aberto amplamente utilizada, especialmente adequada para
+   desenvolvimento web e pode ser incorporada em HTML. Sua sintaxe baseia-se em
+   C, Java e Perl, e é fácil de aprender. O objetivo principal da
    linguagem é permitir a desenvolvedores escreverem páginas que serão geradas
-   dinamicamente rapidamente, mas você pode fazer muito mais do que isso com PHP.
+   de forma dinâmica e rápida, mas pode-se fazer muito mais do que isso com o PHP.
   </simpara>
  </abstract>
 </info>
@@ -20,17 +20,17 @@
   Esse manual consiste primeiramente de uma <link linkend="funcref">
   referência de funções</link>, mas ele também contém uma
   <link linkend="langref">referência da linguagem</link>, explicações
-  sobre as mais importantes <link linkend="features">características</link> do PHP,
+  sobre os <link linkend="features">recursos</link> mais importantes do PHP,
   e outras informações <link linkend="appendices">suplementares</link>.
 
  </para>
  <para>
-  Você pode fazer o download deste manual em vários formatos em <link
+  Este manual pode ser obtido em vários formatos em <link
   xlink:href="&url.php.doc.downloads;">&url.php.doc.downloads;</link>.
-  Mais informações sobre como esse manual é desenvolvido podem ser encontradas
+  Mais informações sobre como este manual é desenvolvido podem ser encontradas
   no apêndice <link linkend="about">'Sobre o manual'</link>. Se você está
   interessado na <link linkend="history">história do PHP</link>,
-  veja o apêndice relevante.
+  consulte o apêndice correspondente.
  </para>
 
  &contributors;

diff --git a/reference/classobj/functions/class-alias.xml b/reference/classobj/functions/class-alias.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9a8a05e0133a3a255d0cadd669b18ff83dfe2a95 Maintainer: leonardolara Status: ready --><!-- CREDITS: everaldofilho,leonardolara -->
+<!-- EN-Revision: 194d020921b4f2bc7616ac9eacabe362e89752ef Maintainer: leonardolara Status: ready --><!-- CREDITS: everaldofilho,leonardolara -->
 <refentry xml:id="function.class-alias" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>class_alias</refname>
@@ -20,7 +20,7 @@
   </para>
   <note>
    <simpara>
-    A partir do PHP 8.3.0, <function>class_alias()</function> também suporta
+    A partir do PHP 8.3.0, <function>class_alias</function> também suporta
     a criação de um apelido de uma classe interna do PHP.
    </simpara>
   </note>
@@ -78,7 +78,7 @@
      <row>
       <entry>8.3.0</entry>
       <entry>
-       <function>class_alias()</function> agora suporta criação de apelido de uma classe interna.
+       <function>class_alias</function> agora suporta criação de apelido de uma classe interna.
       </entry>
      </row>
     </tbody>

diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4a0b755422db68c731b978cd7e8a979ead0cfe13 Maintainer: leonardolara Status: ready --><!-- CREDITS: lisaldo,geekcom,klaussilveira,ae,leonardolara -->
+<!-- EN-Revision: 72b9959ea6f46e524aa2daaa49f82db986002355 Maintainer: leonardolara Status: ready --><!-- CREDITS: lisaldo,geekcom,klaussilveira,ae,leonardolara -->
 <appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;

diff --git a/reference/curl/functions/curl-setopt.xml b/reference/curl/functions/curl-setopt.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c957c4c205b18978e0bf318b24978e92c70e19ee Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
+<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>curl_setopt</refname>
@@ -76,7 +76,7 @@
           <row>
            <entry valign="top"><constant>CURLOPT_CERTINFO</constant></entry>
            <entry valign="top">
-            &true; para enviar informações de certificação SSL para <literal>STDERR</literal>
+            &true; para enviar informações de certificação SSL para <constant>STDERR</constant>
             em transferências seguras.
            </entry>
            <entry valign="top">
@@ -564,7 +564,7 @@
            <entry valign="top">
             &true; para usar o modo ASCII para transferências FTP.
             Para LDAP, ele recupera dados em texto simples em vez de HTML. Em
-            sistemas Windows, ele não definirá <literal>STDOUT</literal> para o
+            sistemas Windows, ele não definirá <constant>STDOUT</constant> para o
             modo binário.
            </entry>
            <entry valign="top">
@@ -593,7 +593,7 @@
            <entry valign="top"><constant>CURLOPT_VERBOSE</constant></entry>
            <entry valign="top">
             &true; para gerar informações detalhadas. Grava a
-            saída em <literal>STDERR</literal> ou no arquivo especificado
+            saída em <constant>STDERR</constant> ou no arquivo especificado
             usando <constant>CURLOPT_STDERR</constant>.
            </entry>
            <entry valign="top">
@@ -684,9 +684,9 @@
            <entry valign="top"><constant>CURLOPT_FTPSSLAUTH</constant></entry>
            <entry valign="top">
             O método de autenticação FTP (quando ativado):
-            <literal>CURLFTPAUTH_SSL</literal> (tente SSL primeiro),
-            <literal>CURLFTPAUTH_TLS</literal> (tente TLS primeiro) ou
-            <literal>CURLFTPAUTH_DEFAULT</literal> (deixe cURL decidir).
+            <constant>CURLFTPAUTH_SSL</constant> (tenta SSL primeiro),
+            <constant>CURLFTPAUTH_TLS</constant> (tenta TLS primeiro) ou
+            <constant>CURLFTPAUTH_DEFAULT</constant> (deixa o cURL decidir).
            </entry>
            <entry valign="top">
             Adicionado no cURL 7.12.2.
@@ -760,7 +760,7 @@
              aquele que encontrar mais seguro.
             </para>
             <para>
-             <constant>CURLAUTH_ANYSAFE</constant> define todos os bits, exceto <literal>CURLAUTH_BASIC</literal>.
+             <constant>CURLAUTH_ANYSAFE</constant> define todos os bits, exceto <constant>CURLAUTH_BASIC</constant>.
              cURL selecionará automaticamente o método que considerar mais seguro.
             </para>
            </entry>
@@ -2330,7 +2330,7 @@
            <entry valign="top"><constant>CURLOPT_FILE</constant></entry>
            <entry valign="top">
             O arquivo no qual a transferência deve ser gravada. O padrão
-            é <literal>STDOUT</literal> (a janela do navegador).
+            é <constant>STDOUT</constant> (a janela do navegador).
            </entry>
           </row>
           <row>
@@ -2343,7 +2343,7 @@
            <entry valign="top"><constant>CURLOPT_STDERR</constant></entry>
            <entry valign="top">
             Um local alternativo para gerar erros em vez de
-            <literal>STDERR</literal>.
+            <constant>STDERR</constant>.
            </entry>
           </row>
           <row>

diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: c44475e1fafcbee203ed4935a6d5d7a01379fcdc Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,fernandoc,leonardolara -->
+<!-- EN-Revision: d715365c098db000eaf7dcd987ee6093f6e83091 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,fernandoc,leonardolara -->
 <refentry xml:id="function.trigger-error" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>trigger_error</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>trigger_error</methodname>
+   <type>true</type><methodname>trigger_error</methodname>
    <methodparam><type>string</type><parameter>message</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>error_level</parameter><initializer><constant>E_USER_NOTICE</constant></initializer></methodparam>
   </methodsynopsis>
@@ -55,11 +55,44 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Esta função retorna &false; se for especificado um <parameter>error_level</parameter>
-   incorreto, &true; caso contrário.
+   &return.true.always;
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Esta função lança uma exceção <classname>ValueError</classname> se
+   <parameter>error_level</parameter> não for uma das constantes
+   <constant>E_USER_ERROR</constant>, <constant>E_USER_WARNING</constant>,
+   <constant>E_USER_NOTICE</constant> ou <constant>E_USER_DEPRECATED</constant>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       A função agora lança uma exceção <classname>ValueError</classname> se um
+       <parameter>error_level</parameter> inválido for especificado. Anteriormente, retornava &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 34e2e3541c52edc9f60a1ad9735b1f769254eb1e Maintainer: thiago Status: ready --><!-- CREDITS: diogo, rarruda, ae, leonardolara -->
+<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: thiago Status: ready --><!-- CREDITS: diogo, rarruda, ae, leonardolara -->
 <refentry xml:id="function.fgetcsv" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>fgetcsv</refname>
@@ -25,7 +25,7 @@
   <note>
    <para>
     As configurações de localidade são consideradas por esta função. Se
-    <literal>LC_CTYPE</literal> for por exemplo <literal>en_US.UTF-8</literal>, arquivos em
+    <constant>LC_CTYPE</constant> for por exemplo <literal>en_US.UTF-8</literal>, arquivos em
     codificação de um byte podem ser lidos incorretamente por esta função.
    </para>
   </note>

diff --git a/reference/ftp/functions/ftp-rename.xml b/reference/ftp/functions/ftp-rename.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
+<!-- EN-Revision: 6ce59dacb46cddfc09b3a44f25632db264ab786a Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
 <refentry xml:id="function.ftp-rename" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ftp_rename</refname>
@@ -51,7 +51,7 @@
   &reftitle.returnvalues;
   <para>
    &return.success; Em caso de falha (como em tentativa de renomear um arquivo que
-   não existe), um erro de nível <literal>E_WARNING</literal> será emitido.
+   não existe), um erro de nível <constant>E_WARNING</constant> será emitido.
   </para>
  </refsect1>
 
@@ -83,21 +83,22 @@
 $old_file = 'algumArquivo.txt.bak';
 $new_file = 'algumArquivo.txt';
 
-// define uma conexão básica
+// Configura uma conexão básica
 $ftp = ftp_connect($ftp_server);
 
-// login com usuário e senha
+// Login com usuário e senha
 $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
 
-// tenta renomear $old_file para $new_file
+// Tenta renomear $old_file para $new_file
 if (ftp_rename($ftp, $old_file, $new_file)) {
     echo "Sucesso ao renomear $old_file para $new_file\n";
 } else {
     echo "Houve um problema ao renomear $old_file para $new_file\n";
 }
 
-// fecha a conexão
+// Fecha a conexão
 ftp_close($ftp);
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/intl/intlcalendar/setdatetime.xml b/reference/intl/intlcalendar/setdatetime.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2a9c4f55b0f25315245e04d9a5f68ccc5418323a Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: d715365c098db000eaf7dcd987ee6093f6e83091 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="intlcalendar.setdatetime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>IntlCalendar::setDateTime</refname>
@@ -14,7 +14,7 @@
    <methodparam><type>int</type><parameter>dayOfMonth</parameter></methodparam>
    <methodparam><type>int</type><parameter>hour</parameter></methodparam>
    <methodparam><type>int</type><parameter>minute</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>second</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>second</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Define campos de data e horário para os valores fornecidos.

diff --git a/reference/intl/intlgregoriancalendar/createfromdate.xml b/reference/intl/intlgregoriancalendar/createfromdate.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 15d8e3806f3edb7b9f5f19999c611ae06b427be9 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: d715365c098db000eaf7dcd987ee6093f6e83091 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="intlgregoriancalendar.createfromdate" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>IntlGregorianCalendar::createFromDate</refname>
@@ -8,7 +8,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="IntlGregorianCalendar">
-   <modifier>public</modifier> <type>static</type><methodname>IntlGregorianCalendar::createFromDate</methodname>
+   <modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>IntlGregorianCalendar::createFromDate</methodname>
    <methodparam><type>int</type><parameter>year</parameter></methodparam>
    <methodparam><type>int</type><parameter>month</parameter></methodparam>
    <methodparam><type>int</type><parameter>dayOfMonth</parameter></methodparam>