sync with en rev

php · Jan 30, 2025 · 93bd617 · 93bd617
1 parent 4122f6a
commit 93bd617
Show file tree

Hide file tree

Showing 16 changed files with 65 additions and 59 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 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: '>
 
@@ -2292,19 +2292,6 @@ 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>
-  <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>
 Se um <type>int</type> entre -128 e 255 inclusive for fornecido, ele será interpretado como

diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6507fc94c2d0a0e65ee9486a98e9135f34220ae7 Maintainer: lhsazevedo Status: ready --><!-- CREDITS: lhsazevedo, leonardolara -->
+<!-- EN-Revision: e50047b76fc0be5a2345a0b7c34979e3077e8580 Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo, leonardolara -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>match</title>
@@ -88,8 +88,9 @@ string(11) "Adolescente"
   </note>
   <note>
    <simpara>
-    Uma expressão <literal>match</literal> <emphasis>precisa</emphasis> ser
-    terminada por um ponto e vírgula <literal>;</literal>.
+    Quando uma expressão <literal>match</literal> é usada como uma expressão
+    única, ela <emphasis>precisa</emphasis> ser terminada
+    com um ponto-e-vírgula <literal>;</literal>.
    </simpara>
   </note>
  </example>

diff --git a/language/oop5/static.xml b/language/oop5/static.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3c831023489be0c64268882d5b656149140d6f8b Maintainer: ae Status: ready --><!-- CREDITS: narigone,thiago,felipe,ae,fabioluciano -->
+<!-- EN-Revision: 888507ca9ed7a8517edbf2d00a64fcaf5865aa23 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,thiago,felipe,ae,fabioluciano,leonardolara -->
  <sect1 xml:id="language.oop5.static" xmlns="http://docbook.org/ns/docbook">
   <title>Palavra-Chave 'static'</title>
 

diff --git a/reference/array/functions/usort.xml b/reference/array/functions/usort.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2226ad08fd93e3979efbba47c5ae3545eec97d25 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,leonardolara -->
+<!-- EN-Revision: 5d19b00f2f70fa61eee46fee4049b625a8a9bfd2 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,leonardolara -->
 <refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>usort</refname>
@@ -181,7 +181,7 @@ $frutas[2]: limões
 <![CDATA[
 <?php
 class TestObj {
-    var $name;
+    public string $name;
 
     function TestObj($name)
     {

diff --git a/reference/bc/bcmath/number/add.xml b/reference/bc/bcmath/number/add.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="bcmath-number.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>BcMath\Number::add</refname>
@@ -32,8 +32,8 @@
     <term><parameter>scale</parameter></term>
     <listitem>
      <simpara>
-      O parâmetro <parameter>scale</parameter> especifica explicitamente a escala para os resultados de cálculo.
-      Se <parameter>scale</parameter> for &null;, o resultado do cálculo será definido automaticamente.
+      A propriedade <property>BcMath\Number::scale</property> especifica explicitamente a escala para os resultados de cálculo.
+      Se for &null;, a <property>BcMath\Number::scale</property> do resultado do cálculo será definida automaticamente.
      </simpara>
     </listitem>
    </varlistentry>

diff --git a/reference/bc/bcmath/number/construct.xml b/reference/bc/bcmath/number/construct.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="bcmath-number.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>BcMath\Number::__construct</refname>

diff --git a/reference/bc/bcmath/number/div.xml b/reference/bc/bcmath/number/div.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="bcmath-number.div" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>BcMath\Number::div</refname>
@@ -49,13 +49,13 @@
    <literal>15</literal>.
   </simpara>
   <simpara>
-    Mesmo em cálculos indivisíveis, a <property>BcMath\Number::scale</property> não será sempre
-    <literal>+10</literal>.
-    Considera-se que um <literal>0</literal> no final do resultado não precisa de expansão, então a
-    <property>BcMath\Number::scale</property> é reduzida por essa quantidade.
-    A <property>BcMath\Number::scale</property> nunca será menor que a
-    <property>BcMath\Number::scale</property> anterior à expansão.
-    Consulte também o <link linkend="bcmath-number.div.example.expansion-scale">exemplo de código</link>.
+   Mesmo em cálculos indivisíveis, a <property>BcMath\Number::scale</property> não será sempre
+   <literal>+10</literal>.
+   Considera-se que um <literal>0</literal> no final do resultado não precisa de expansão, então a
+   <property>BcMath\Number::scale</property> é reduzida por essa quantidade.
+   A <property>BcMath\Number::scale</property> nunca será menor que a
+   <property>BcMath\Number::scale</property> anterior à expansão.
+   Consulte também o <link linkend="bcmath-number.div.example.expansion-scale">exemplo de código</link>.
   </simpara>
  </refsect1>
 

diff --git a/reference/bc/bcmath/number/round.xml b/reference/bc/bcmath/number/round.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="bcmath-number.round" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>BcMath\Number::round</refname>
@@ -43,6 +43,13 @@
   </simpara>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Este método lança uma exceção <exceptionname>ValueError</exceptionname> se um parâmetro <parameter>mode</parameter> inválido for especificado.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
    <example>

diff --git a/reference/bc/bcmath/number/sqrt.xml b/reference/bc/bcmath/number/sqrt.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="bcmath-number.sqrt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>BcMath\Number::sqrt</refname>
@@ -30,12 +30,13 @@
   </simpara>
   <simpara>
    Quando a propriedade <property>BcMath\Number::scale</property> do objeto resultante é definida automaticamente,
-   a <property>BcMath\Number::scale</property> deste objeto é usada. Entretanto, em casos como
+   a <property>BcMath\Number::scale</property> de <varname>$this</varname> é usada. Entretanto, em casos como
    uma divisão indivisível, a <property>BcMath\Number::scale</property> do resultado é expandida.
    A expansão é feita apenas quando necessário, até um limite de <literal>+10</literal>.
+   Este comportamento é o mesmo de <methodname>BcMath\Number::div</methodname>, consulte este método para detalhes.
   </simpara>
   <simpara>
-   Ou seja, se a <property>BcMath\Number::scale</property> do dividendo for <literal>5</literal>,
+   Ou seja, se a <property>BcMath\Number::scale</property> de <varname>$this</varname> for <literal>5</literal>,
    a <property>BcMath\Number::scale</property> do resultado estará entre <literal>5</literal> e
    <literal>15</literal>.
   </simpara>
@@ -46,7 +47,7 @@
   <para>
    Este método lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
    <simplelist>
-    <member>Este objeto é um valor negativo</member>
+    <member><varname>$this</varname> é um valor negativo</member>
     <member><parameter>scale</parameter> está fora do intervalo válido</member>
     <member><property>BcMath\Number::scale</property> do objeto resultante está fora do intervalo válido</member>
    </simplelist>

diff --git a/reference/bc/functions/bcadd.xml b/reference/bc/functions/bcadd.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
 <refentry xml:id="function.bcadd" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcadd</refname>
@@ -40,7 +40,17 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <varlistentry xml:id="function.bcadd..parameters.scale">
+     <term><parameter>scale</parameter></term>
+     <listitem>
+      <simpara>
+       Este parâmetro é usado para definir o número de dígitos após o separador de decimais do resultado.
+       Se for &null;, será usada a escala padrão definida com <function>bcscale</function>,
+       ou será usado o valor da diretiva INI
+       <link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link>.
+      </simpara>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcdiv.xml b/reference/bc/functions/bcdiv.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
 <refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcdiv</refname>
@@ -39,7 +39,7 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <xi:include xpointer="function.bcadd..parameters.scale" />
    </variablelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcmul.xml b/reference/bc/functions/bcmul.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
 <refentry xml:id="function.bcmul" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcmul</refname>

diff --git a/reference/bc/functions/bcpow.xml b/reference/bc/functions/bcpow.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
-<refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcpow</refname>
   <refpurpose>Eleva um número de precisão arbitrária a outro</refpurpose>
@@ -42,7 +42,7 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <xi:include xpointer="function.bcadd..parameters.scale" />
    </variablelist>
   </para>
  </refsect1>
@@ -84,8 +84,8 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Potências negativas de <literal>0</literal> anteriormente retornavam 0, mas agora lançam uma exceção
-       <exceptionname>DivisionByZeroError</exceptionname>.
+       Potências negativas de <literal>0</literal> anteriormente retornavam <literal>0</literal>, mas agora lançam uma
+       exceção <exceptionname>DivisionByZeroError</exceptionname>.
       </entry>
      </row>
      <row>

diff --git a/reference/bc/functions/bcpowmod.xml b/reference/bc/functions/bcpowmod.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,ae -->
-<refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,ae,leonardolara -->
+<refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcpowmod</refname>
   <refpurpose>Eleva um número de precisão arbitrária para outro, reduzido por um módulo especificado</refpurpose>
@@ -17,7 +17,7 @@
   </methodsynopsis>
   <para>
    Utiliza o método de exponenciação rápida para elevar
-   <parameter>num</parameter> para a potência
+   <parameter>num</parameter> à potência
    <parameter>exponent</parameter> levando em conta o módulo
    <parameter>modulus</parameter>.
   </para>
@@ -31,27 +31,27 @@
      <term><parameter>num</parameter></term>
      <listitem>
       <para>
-       O número base, na forma de inteiro em string (a escala tem de ser zero).
+       A base, na forma de inteiro em string (a escala tem que ser zero).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>exponent</parameter></term>
      <listitem>
       <para>
-       O número expoente, na forma de um inteiro não negativo, em string (a escala tem de ser zero).
+       O expoente, na forma de um inteiro não negativo, em string (a escala tem que ser zero).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>modulus</parameter></term>
      <listitem>
       <para>
-       O número módulo, na forma de um inteiro em string (a escala tem de ser zero).
+       O  módulo, na forma de um inteiro em string (a escala tem que ser zero).
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <xi:include xpointer="function.bcadd..parameters.scale" />
    </variablelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcround.xml b/reference/bc/functions/bcround.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.bcround" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcround</refname>
@@ -51,7 +51,7 @@
    Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
    <simplelist>
     <member><parameter>num</parameter> não é uma string numérica BCMath bem formada.</member>
-    <member><parameter>scale</parameter> está fora do intervalo válido.</member>
+    <member>Um <parameter>mode</parameter> inválido é especificado.</member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcsqrt.xml b/reference/bc/functions/bcsqrt.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
-<refentry xml:id="function.bcsqrt" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<refentry xml:id="function.bcsqrt" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bcsqrt</refname>
   <refpurpose>Obtém a raiz quadrada de um número de precisão arbitrária</refpurpose>
@@ -30,7 +30,7 @@
       </para>
      </listitem>
     </varlistentry>
-    &bc.scale.description;
+    <xi:include xpointer="function.bcadd..parameters.scale" />
    </variablelist>
   </para>
  </refsect1>