sync with en rev

php · Jan 20, 2025 · 0548a20 · 0548a20
1 parent 99d8e56
commit 0548a20
Show file tree

Hide file tree

Showing 22 changed files with 235 additions and 39 deletions.
diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87fa7783ea39a768ded613803e7e789ddf6ec5e3 Maintainer: ae Status: ready --><!-- CREDITS: galvao,ae,fabioluciano,geekcom,adiel,leonardolara -->
+<!-- EN-Revision: cc5b61f3f889ae2d65a7007e9bdd34981b8aba50 Maintainer: leonardolara Status: ready --><!-- CREDITS: galvao,ae,fabioluciano,geekcom,adiel,leonardolara -->
  <section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
   <title>Lista de diretivas do &php.ini;</title>
   <para>
@@ -452,7 +452,7 @@
       <row>
        <entry>mail.force_extra_parameters</entry>
        <entry>&null;</entry>
-       <entry>Somente no &php.ini;</entry>
+       <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ffd2ef754b37526c0b96e94859d57ce06acfbf41 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 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: '>
 
@@ -1702,6 +1702,7 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
 </itemizedlist>'>
 
 
+
 <!-- Dom Examples -->
 <!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Os exemplos a seguir usam um arquivo <filename>book.xml</filename> que contém o seguinte:</para>
 <programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
@@ -1742,6 +1743,28 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
   das <link linkend="libxml.constants">constantes de opções da libxml</link>.
 </para>'>
 
+<!ENTITY dom.parameter.compliant.options '&dom.parameter.options;
+ <simpara xmlns="http://docbook.org/ns/docbook">
+  Também é possível passar <constant>Dom\HTML_NO_DEFAULT_NS</constant>
+  para desabilitar o uso do namespace HTML e o elemento modelo.
+  Isto só deve ser usado se as implicações forem adequadamente compreendidas.
+</simpara>'>
+
+<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
+ A codificação na qual o documento foi criado.
+ Se não informada, tentará determinar a codificação que é mais comumente usada.
+</simpara>'>
+
+<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
+ &reftitle.notes;
+ <note>
+  <simpara>
+   Espaço em branco nas etiquetas <literal>html</literal> e <literal>head</literal>
+   não é considerado significativo e pode perder a formatação.
+  </simpara>
+ </note>
+</refsect1>'>
+
 <!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>registerNodeNS</parameter></term>
  <listitem>
@@ -1753,6 +1776,14 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
  </listitem>
 </varlistentry>'>
 
+<!ENTITY dom.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
+ Opções Adicionais.
+ As opções <constant>LIBXML_NOEMPTYTAG</constant>
+ e <constant>LIBXML_NOXMLDECL</constant> são suportadas.
+ Antes do PHP 8.3.0, apenas a opção <constant>LIBXML_NOEMPTYTAG</constant>
+ era suportada.
+</simpara>'>
+
 <!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
   <listitem>
@@ -1768,9 +1799,9 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
  <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
   <listitem>
   <para>
-    Emitido se este nó é de um tipo que não permite filhos do
-    tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
-    inserido é um dos ancestrais deste nó, ou o próprio nó.
+   Emitido se este nó é de um tipo que não permite filhos do
+   tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
+   inserido é um dos ancestrais deste nó, ou o próprio nó.
   </para>
  </listitem>
 </varlistentry>'>
@@ -1779,12 +1810,33 @@ seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">
  <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
   <listitem>
   <para>
-    Emitido se um dos <parameter>nodes</parameter> informados foi criado a partir de um documento
-    diferente daquele que criou este nó.
+   Emitido se um dos <parameter>nodes</parameter> informados foi criado a partir de um documento
+   diferente daquele que criou este nó.
   </para>
  </listitem>
 </varlistentry>'>
 
+<!ENTITY dom.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  Lança uma exceção <exceptionname>Dom\DOMException</exceptionname> com código
+  <constant>Dom\WRONG_DOCUMENT_ERR</constant> se <parameter>node</parameter>
+  for de outro documento.
+ </simpara>
+</listitem>'>
+
+<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  Lança uma exceção <exceptionname>ValueError</exceptionname> se
+  <parameter>options</parameter> contiver uma opção inválida.
+ </simpara>
+</listitem>
+<listitem>
+ <simpara>
+  Lança uma exceção <exceptionname>ValueError</exceptionname> s
+  <parameter>overrideEncoding</parameter> for uma codificação desconhecida.
+ </simpara>
+</listitem>'>
+
 <!ENTITY dom.changelog.previous_hierarchy_exception 'Anteriormente, era lançada uma exceção
  <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> com código
  <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

diff --git a/language/control-structures/require.xml b/language/control-structures/require.xml
@@ -1,16 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 84b8fca68fc762fefe85acde180a38b2e77a28b9 Maintainer: fabioluciano Status: ready --><!-- CREDITS: royopa, fabioluciano -->
+<!-- EN-Revision: 30c0106d51ac2786b81b27709ca88f1daf07e716 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa, fabioluciano, leonardolara -->
 
 <sect1 xml:id="function.require" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>require</title>
  <?phpdoc print-version-for="require"?>
 
  <para>
   A declaração <literal>require</literal> é idêntica a <function>include</function>
-  exceto que em caso de falha também produzirá um erro fatal de nível
-  <constant>E_COMPILE_ERROR</constant>. Em outras palavras, ele parará
-  o script enquanto que o <function>include</function> apenas emitirá um alerta
-  (<constant>E_WARNING</constant>) permitindo que o script continue.
+  exceto que em caso de falha também produzirá uma exceção <classname>Error</classname>
+  (erro de nível <constant>E_COMPILE_ERROR</constant> antes do
+  PHP 8.0.0) enquanto que <function>include</function> apenas emitirá um alerta
+  (nível de erro <constant>E_WARNING</constant>).
  </para>
  <para>
   Veja a documentação <function>include</function> para saber como isso funciona.

diff --git a/language/enumerations.xml b/language/enumerations.xml
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 83e2056f071742c44d2b0bdbc8574d73697c7a08 Maintainer: ae Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
+<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 3d5ec5f3634cc9abcbfea7200067861025e9b13e Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
  <chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook">
   <title>Enumerações</title>
   <sect1 xml:id="language.enumerations.overview">
@@ -511,7 +511,7 @@ enum Tamanho
 
   <para>Enumerações podem utilizar traits, que se comportam da mesma maneira que nas classes.
    A limitação é que usados com <literal>use</literal> em uma enum não podem conter propriedades.
-   Eles podem incluir apenas métodos e métodos estáticos. Um trait com propriedades
+   Eles podem incluir apenas métodos, métodos estáticos e constantes. Um trait com propriedades
    resultará em um erro fatal.
   </para>
 

diff --git a/reference/array/functions/array-unique.xml b/reference/array/functions/array-unique.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 3ba15fd3dfb8196a1762b1a21a14311e0279284b Maintainer: lhsazevedo Status: ready --><!-- CREDITS: lucasr,narigone,rafaelbernard,felipe,lhsazevedo -->
+<!-- EN-Revision: 651fad6c6677036edd2871bb78199e17586a3acd Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,narigone,rafaelbernard,felipe,lhsazevedo,leonardolara -->
 <refentry xml:id="function.array-unique" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_unique</refname>
@@ -25,8 +25,8 @@
   <note>
    <simpara>
     Dois elementos são considerados iguais se, e somente se,
-    <literal>(string) $elem1 === (string) $elem2</literal>. Em palavras:
-    quando a represetação em string é a mesma, o primeiro elemento será usado.
+    <literal>(string) $elem1 === (string) $elem2</literal>, ou seja,
+    quando a representação em string é a mesma, o primeiro elemento será usado.
    </simpara>
   </note>
  </refsect1>
@@ -119,9 +119,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$input = array("a" => "verde", "vermelho", "b" => "verde", "azul", "vermelho");
+
+$input = ["a" => "verde", "vermelho", "b" => "verde", "azul", "vermelho"];
 $result = array_unique($input);
 print_r($result);
+
 ?>
 ]]>
     </programlisting>
@@ -144,9 +146,11 @@ Array
     <programlisting role="php">
 <![CDATA[
 <?php
-$input = array(4, "4", "3", 4, 3, "3");
+
+$input = [4, "4", "3", 4, 3, "3"];
 $result = array_unique($input);
 var_dump($result);
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/bc/bcmath.number.xml b/reference/bc/bcmath.number.xml
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<reference xml:id="class.bcmath-number" 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 BcMath\Number</title>
+ <titleabbrev>BcMath\Number</titleabbrev>
+
+ <partintro>
+  <section xml:id="bcmath-number.intro">
+   &reftitle.intro;
+   <simpara>
+    Uma classe para número de precisão arbitrária.
+    Estes objetos suportam sobrecarga de operadores
+    <link linkend="language.operators.arithmetic">aritméticos</link> e
+    <link linkend="language.operators.comparison">comparativos</link>.
+   </simpara>
+
+   <note>
+    <simpara>
+     Esta classe não é afetada pela diretiva INI
+     <link linkend="ini.bcmath.scale">bcmath.scale</link>
+     definida no &php.ini;.
+    </simpara>
+   </note>
+
+   <note>
+    <simpara>
+     O comportamento de um operador sobrecarregado é o mesmo que especificar &null; para o
+     parâmetro <parameter>scale</parameter> no método correspondente.
+    </simpara>
+   </note>
+  </section>
+
+  <section xml:id="bcmath-number.synopsis">
+   &reftitle.classsynopsis;
+
+   <classsynopsis class="class">
+    <ooclass>
+     <modifier>final</modifier>
+     <modifier>readonly</modifier>
+     <classname>BcMath\Number</classname>
+    </ooclass>
+
+    <oointerface>
+     <modifier>implements</modifier>
+     <interfacename>Stringable</interfacename>
+    </oointerface>
+
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>string</type>
+     <varname linkend="bcmath-number.props.value">value</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>int</type>
+     <varname linkend="bcmath-number.props.scale">scale</varname>
+    </fieldsynopsis>
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.bcmath-number')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='BcMath\\Number'])">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.bcmath-number')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='BcMath\\Number'])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+  </section>
+
+  <section xml:id="bcmath-number.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="bcmath-number.props.value">
+     <term><varname>value</varname></term>
+     <listitem>
+      <simpara>
+       Uma representação string de um número de precisão arbitrária.
+      </simpara>
+     </listitem>
+    </varlistentry>
+    <varlistentry xml:id="bcmath-number.props.scale">
+     <term><varname>scale</varname></term>
+     <listitem>
+      <simpara>
+       O valor de escala atualmente definido no objeto.
+       Para objetos resultantes de cálculos, este valore é computado e definido automaticamente,
+       a menos que o parâmetro <parameter>scale</parameter> tenha sido definido no método de cálculo.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
+ </partintro>
+
+ &reference.bc.bcmath.entities.number;
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/bc/book.xml b/reference/bc/book.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: ae Status: ready --><!-- CREDITS: felipe,ae -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,ae,leonardolara -->
 
 <book xml:id="book.bc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
@@ -48,6 +48,7 @@ echo bcsub($num1, $num2, 1); // => '0.0'
 
  &reference.bc.setup;
  &reference.bc.reference;
+ &reference.bc.bcmath.number;
 
 </book>
 

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: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
 <refentry xml:id="function.bcadd" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcadd</refname>
@@ -115,6 +115,7 @@ echo bcadd($a, $b, 4);  // 6.2340
   <para>
    <simplelist>
     <member><function>bcsub</function></member>
+    <member><methodname>BcMath\Number::add</methodname></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcceil.xml b/reference/bc/functions/bcceil.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.bcceil" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcceil</refname>
@@ -76,6 +76,7 @@ string(2) "-3"
   <simplelist>
    <member><function>bcfloor</function></member>
    <member><function>bcround</function></member>
+   <member><methodname>BcMath\Number::ceil</methodname></member>
   </simplelist>
  </refsect1>
 </refentry>

diff --git a/reference/bc/functions/bccomp.xml b/reference/bc/functions/bccomp.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
+<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: leonardolara Status: ready --><!-- CREDITS: rarruda,ae -->
 <refentry xml:id="function.bccomp" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>bccomp</refname>
@@ -74,6 +74,13 @@ echo bccomp('1.00001', '1', 5); // 1
    </programlisting>
   </example>
  </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>BcMath\Number::compare</methodname></member>
+  </simplelist>
+ </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables: