sync with en rev

php · Dec 1, 2024 · 421d553 · 421d553
1 parent 89cb1df
commit 421d553
Show file tree

Hide file tree

Showing 14 changed files with 327 additions and 102 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c75f19c74fa3b64abfafd7a35aaa652b07834a5a Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b 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: '>
 
@@ -2149,11 +2149,17 @@ para usar essas funções.</simpara>'>
 <!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">modo seguro do SQL</link>'>
 
 <!-- BCMath Notes -->
-<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
-<parameter>scale</parameter></term><listitem><para>Este parâmetro opcional é usado para definir o número
-de dígitos após a casa decimal do resultado. Se omitido, o padrão será a escala definida
-globalmente com a função <function>bcscale</function> ou, em último caso, <literal>0</literal> se
-a escala não tiver sido definida.</para></listitem></varlistentry>'>
+<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>scale</parameter></term>
+ <listitem>
+  <simpara>
+   Este parâmetro opcional é usado para definir o número de dígitos após a casa decimal no resultado.
+   Se for igual a &null; o padrão será a escala definida com a função <function>bcscale</function>
+   ou, em último caso, o valor da diretiva INI
+   <link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link>.
+  </simpara>
+ </listitem>
+</varlistentry>'>
 
 <!-- CTYPE Notes -->
 <!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>

diff --git a/language/predefined/php-incomplete-class.xml b/language/predefined/php-incomplete-class.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 26e26a95fdc3aac9b464068953ea3105dee00f14 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: c0e48705eb88453af785e0e4a6cbd526085dfe3a Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <reference xml:id="class.php-incomplete-class" role="class" 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 __PHP_Incomplete_Class</title>
@@ -28,6 +28,7 @@
 
    <classsynopsis class="class">
     <ooclass>
+     <modifier>final</modifier>
      <classname>__PHP_Incomplete_Class</classname>
     </ooclass>
    </classsynopsis>
@@ -41,6 +42,28 @@
    </para>
   </section>
 
+  <section xml:id="php-incomplete-class.changelog" 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>
+        Esta classe agora é <literal>final</literal>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
   <section xml:id="php-incomplete-class.examples" role="examples">
    &reftitle.examples;
    <example xml:id="php-incomplete-class.basic-example">

diff --git a/reference/datetime/dateinterval/createfromdatestring.xml b/reference/datetime/dateinterval/createfromdatestring.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: bd1ae73f4a88404c9a3015940c66a85aaeec5889 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateInterval::createFromDateString</refname>
@@ -10,7 +10,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="DateInterval">
-   <modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>DateInterval</type><type>false</type></type><methodname>DateInterval::createFromDateString</methodname>
+   <modifier>public</modifier> <modifier>static</modifier> <type>DateInterval</type><methodname>DateInterval::createFromDateString</methodname>
    <methodparam><type>string</type><parameter>datetime</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
@@ -53,7 +53,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna uma nova instância de <classname>DateInterval</classname> em caso de sucesso, &return.falseforfailure;.
+   Retorna <classname>DateTimeImmutable</classname> em caso de sucesso.
+   &return.falseforfailure.style.procedural;
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Apenas para API orientada a objetos: Se uma string de data/horário inválida for passada,
+   uma exceção <exceptionname>DateMalformedStringException</exceptionname> é lançada.
   </para>
  </refsect1>
 
@@ -68,6 +77,17 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.3.0</entry>
+      <entry>
+       <methodname>DateInterval::createFromDateString</methodname> agora lança
+       uma exceção <exceptionname>DateMalformedStringException</exceptionname> se uma
+       string inválida for passada. Anteriormente, retornava <literal>false</literal>
+       e um alerta era emitido.
+       A função <function>date_interval_create_from_date_string</function> não foi
+       alterada.
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>

diff --git a/reference/datetime/datetime/modify.xml b/reference/datetime/datetime/modify.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4cd196cb84cb840d2580804e39d3a5dc4682e312 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="datetime.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTime::modify</refname>
@@ -11,7 +11,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="DateTime">
-   <modifier>public</modifier> <type class="union"><type>DateTime</type><type>false</type></type><methodname>DateTime::modify</methodname>
+   <modifier>public</modifier> <type>DateTime</type><methodname>DateTime::modify</methodname>
    <methodparam><type>string</type><parameter>modifier</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
@@ -42,15 +42,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &date.datetime.return.modifiedobjectorfalseforfailure;
+   Retorna <classname>DateTime</classname> em caso de sucesso.
+   &return.falseforfailure.style.procedural;
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-    Apenas para API orientada a objetos: Se uma string inválida de data/hora for passada,
-    é disparada uma exceção <exceptionname>DateMalformedStringException</exceptionname>.
+   Apenas para API orientada a objetos: Se uma string inválida de data/hora for passada,
+   uma exceção <exceptionname>DateMalformedStringException</exceptionname> é lançada.
   </para>
  </refsect1>
 
@@ -68,11 +69,11 @@
      <row>
       <entry>8.3.0</entry>
       <entry>
-       Agora dispara
-       a exceção <exceptionname>DateMalformedStringException</exceptionname> com
-       <methodname>DateTime::modify</methodname> se uma string inválida for
-       passada, em vez de um aviso.
-       <function>date_modify</function> não foi modificada.
+       <methodname>DateTime::modify</methodname> agora lança uma
+       exceção <exceptionname>DateMalformedStringException</exceptionname> se uma
+       string inválida for passada. Anteriormente, retornava <literal>false</literal>
+       e um alerta era emitido.
+       A função <function>date_modify</function> não foi alterada.
       </entry>
      </row>
     </tbody>

diff --git a/reference/datetime/datetime/sub.xml b/reference/datetime/datetime/sub.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d7b51f68698544fb3e0384693809fe2aafa9c69e Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="datetime.sub" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTime::sub</refname>
@@ -64,10 +64,10 @@
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-    Apenas para API orientada a objeto: Se uma operação não suportada for realizada, como o uso
-    de um objeto <classname>DateInterval</classname> representando especificações de tempo relativo
-    tipo <literal>next weekday</literal>, uma
-    exceção <exceptionname>DateInvalidOperationException</exceptionname> é disparada.
+   Apenas para API orientada a objetos: Se uma operação não suportada for realizada, como o uso
+   de um objeto <classname>DateInterval</classname> representando especificações de tempo relativo
+   tipo <literal>next weekday</literal>, uma
+   exceção <exceptionname>DateInvalidOperationException</exceptionname> é lançada.
   </para>
  </refsect1>
 
@@ -85,11 +85,11 @@
      <row>
       <entry>8.3.0</entry>
       <entry>
-       Agora dispara uma exceção
+       Agora lança uma exceção
        <exceptionname>DateInvalidOperationException</exceptionname> com
        <methodname>DateTime::sub</methodname>, em vez de um
-       aviso quando uma operação não suportada é realizada.
-       A função <function>date_sub</function> não foi modificada.
+       alerta quando uma operação não suportada é realizada.
+       A função <function>date_sub</function> não foi alterada.
       </entry>
      </row>
     </tbody>

diff --git a/reference/datetime/datetimeimmutable/modify.xml b/reference/datetime/datetimeimmutable/modify.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a11c5b53bc132289a0ddcc6d3efee5d97f0027b4 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="datetimeimmutable.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTimeImmutable::modify</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
-   <modifier>public</modifier> <type class="union"><type>DateTimeImmutable</type><type>false</type></type><methodname>DateTimeImmutable::modify</methodname>
+   <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::modify</methodname>
    <methodparam><type>string</type><parameter>modifier</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -33,7 +33,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna um novo objeto DateTimeImmutable modificado&return.falseforfailure;.
+   Retorna <classname>DateTimeImmutable</classname> em caso de sucesso.
+   &return.falseforfailure.style.procedural;
   </para>
  </refsect1>
 
@@ -60,9 +61,10 @@
      <row>
       <entry>8.3.0</entry>
       <entry>
-       Agora dispara
-       <exceptionname>DateMalformedStringException</exceptionname> se uma
-       string inválida é passada, em vez de um aviso.
+       <methodname>DateTimeImmutable::modify</methodname> agora lança
+       uma exceção <exceptionname>DateMalformedStringException</exceptionname> se uma
+       string inválida for passada. Anteriormente, retornava <literal>false</literal>
+       e um alerta era emitido.
       </entry>
      </row>
     </tbody>

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: 2474b979c1a9cd8b6f48445edf634c3d21c29fb2 Maintainer: leonardolara Status: ready --><!-- CREDITS: thiago, diogo, rarruda, ae, leonardolara -->
+<!-- EN-Revision: 781f2ec04ee8817687e5e333bc3e64ab973322d7 Maintainer: leonardolara Status: ready --><!-- CREDITS: thiago, diogo, rarruda, ae, leonardolara -->
 <refentry xml:id="function.fgetcsv" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>fgetcsv</refname>
@@ -162,6 +162,14 @@
         descontinuado.
        </entry>
       </row>
+      <row>
+       <entry>8.3.0</entry>
+       <entry>
+        Uma string vazia é retornada ao invés de uma string com um único
+        byte nulo para o último campo, se ele contiver apenas um demarcador
+        não terminado.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

diff --git a/reference/mysqli/mysqli_driver/report-mode.xml b/reference/mysqli/mysqli_driver/report-mode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 772cf37c3f2e1a1f4ba9fa552ac7fcfd78453f13 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
+<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin -->
 <refentry xml:id="mysqli-driver.report-mode" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli_driver::$report_mode</refname>
@@ -11,11 +11,11 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <fieldsynopsis>
-   <type>int</type><varname linkend="mysqli-driver.report-mode">mysqli_driver->report_mode</varname>
+   <type>int</type><varname linkend="mysqli-driver.report-mode">mysqli_driver-&gt;report_mode</varname>
   </fieldsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <type>bool</type><methodname>mysqli_report</methodname>
+   <type>true</type><methodname>mysqli_report</methodname>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -83,7 +83,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna &true;.
+   &return.true.always;
   </para>
  </refsect1>
 
@@ -199,7 +199,6 @@ try {
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml