sync with en rev

php · Oct 27, 2024 · 4b129b4 · 4b129b4
1 parent bcfb952
commit 4b129b4
Show file tree

Hide file tree

Showing 16 changed files with 61 additions and 49 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 27ae0a4a16cdfc868a884c0f0dad7023b5f2709c Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 024f0e6014e07bea51c71b1e2493953e5ee89b5c 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: '>
 
@@ -3778,32 +3778,38 @@ local: {
  <itemizedlist xmlns="http://docbook.org/ns/docbook">
     <listitem>
      <simpara>
-      <literal>" "</literal> (<acronym>ASCII</acronym> 32 (0x20)), um espaço normal.
+      <literal>" "</literal>: caractere <acronym>ASCII</acronym> <acronym>SP</acronym>
+      <literal>0x20</literal>, um espaço normal.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
-      <literal>"\t"</literal> (<acronym>ASCII</acronym> 9 (0x09)), uma tabulação.
+      <literal>"\t"</literal>: caractere <acronym>ASCII</acronym> <acronym>HT</acronym>
+      <literal>0x09</literal>, uma tabulação.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
-      <literal>"\n"</literal> (<acronym>ASCII</acronym> 10 (0x0A)), uma nova linha (alimentação de linha).
+      <literal>"\n"</literal>: caractere <acronym>ASCII</acronym> <acronym>LF</acronym>
+      <literal>0x0A</literal>, uma nova linha (alimentação de linha).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
-      <literal>"\r"</literal> (<acronym>ASCII</acronym> 13 (0x0D)), um retorno de carro.
+      <literal>"\r"</literal>: caractere <acronym>ASCII</acronym> <acronym>CR</acronym>
+      <literal>0x0D</literal>, um retorno de carro.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
-      <literal>"\0"</literal> (<acronym>ASCII</acronym> 0 (0x00)), o byte NUL.
+      <literal>"\0"</literal>: caractere <acronym>ASCII</acronym> <acronym>NUL</acronym>
+      <literal>0x00</literal>, o byte nulo.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
-      <literal>"\v"</literal> (<acronym>ASCII</acronym> 11 (0x0B)), uma tabulação vertical.
+      <literal>"\v"</literal>: caractere <acronym>ASCII</acronym> <acronym>VT</acronym>
+      <literal>0x0B</literal>, uma tabulação vertical.
      </simpara>
     </listitem>
    </itemizedlist>

diff --git a/reference/com/functions/variant-cast.xml b/reference/com/functions/variant-cast.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dccfbf96599009809b81fc2599f76a4dd40f2666 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.variant-cast" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>variant_cast</refname>
@@ -39,7 +39,7 @@
      <listitem>
       <para>
        <parameter>type</parameter> deve ser uma das constantes
-       <constant>VT_XXX</constant>.
+       <constant>VT_<replaceable>*</replaceable></constant>.
       </para>
      </listitem>
     </varlistentry>

diff --git a/reference/com/functions/variant-get-type.xml b/reference/com/functions/variant-get-type.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2b220300c871e7530c0a62fb69c23b75800b4c63 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.variant-get-type" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>variant_get_type</refname>
@@ -37,7 +37,7 @@
    <parameter>variant</parameter>, que pode ser uma instância das classes
    <xref linkend="class.com"/>, <xref linkend="class.dotnet"/> ou
    <xref linkend="class.variant"/>. O valor de retorno pode ser comparado
-   com uma das constantes <constant>VT_XXX</constant>.
+   com uma das constantes <constant>VT_<replaceable>*</replaceable></constant>.
   </para>
   <para>
    O valor de retorno para objetos COM e DOTNET normalmente será

diff --git a/reference/com/variant/construct.xml b/reference/com/variant/construct.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 49ff12041acd30489ef8cb7b1e08ec1ddf4dc6bc Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <refentry xml:id="variant.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>variant::__construct</refname>
@@ -34,9 +34,10 @@
     <term><parameter>type</parameter></term>
     <listitem>
      <simpara>
-      Especifica o tipo de conteúdo do objeto variant. Valores possíveis são uma
-      das <xref
-      linkend="com.constants"/> <constant>VT_XXX</constant>..
+      Especifica o tipo de conteúdo do objeto variant. Pode ser
+      uma das <xref
+      linkend="com.constants"/>
+      <constant>VT_<replaceable>*</replaceable></constant>.
      </simpara>
      <simpara>
       O PHP consegue detectar parâmetros passados por referência

diff --git a/reference/curl/functions/curl-multi-add-handle.xml b/reference/curl/functions/curl-multi-add-handle.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 92226911a09278dd440b836583bf382c629cfc63 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, enzogamads, fernandoc, leonardolara -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, enzogamads, fernandoc, leonardolara -->
 <refentry xml:id="function.curl-multi-add-handle" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>curl_multi_add_handle</refname>
@@ -33,7 +33,7 @@
   &reftitle.returnvalues;
   <para>
    Retorna 0 em caso de sucesso, ou um dos códigos de erro
-   <constant>CURLM_XXX</constant>.
+   <constant>CURLM_<replaceable>*</replaceable></constant>.
   </para>
  </refsect1>
 

diff --git a/reference/curl/functions/curl-multi-remove-handle.xml b/reference/curl/functions/curl-multi-remove-handle.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="function.curl-multi-remove-handle" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>curl_multi_remove_handle</refname>
@@ -35,7 +35,7 @@
   &reftitle.returnvalues;
   <para>
    Retorna 0 em caso de sucesso, ou um dos códigos de erro
-   <constant>CURLM_XXX</constant>.
+   <constant>CURLM_<replaceable>*</replaceable></constant>.
   </para>
  </refsect1>
 

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: 310963ad9ab1c2ca315361ff94314a21fa65f8b8 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin,leonardolara -->
 <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>curl_setopt</refname>
@@ -28,7 +28,7 @@
      <term><parameter>option</parameter></term>
      <listitem>
       <para>
-       A opção <literal>CURLOPT_XXX</literal> a ser definida.
+       A opção <constant>CURLOPT_<replaceable>*</replaceable></constant> a ser definida.
       </para>
      </listitem>
     </varlistentry>

diff --git a/reference/curl/functions/curl-version.xml b/reference/curl/functions/curl-version.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 08a941584f00b659f595dfc6d108a73b2e6849a6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="function.curl-version" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>curl_version</refname>
@@ -65,7 +65,7 @@
       </row>
       <row>
        <entry>features</entry>
-       <entry>Uma máscara de bits das contantes <literal>CURL_VERSION_XXX</literal></entry>
+       <entry>Uma máscara de bits das contantes <constant>CURL_VERSION_<replaceable>*</replaceable></constant></entry>
       </row>
       <row>
        <entry>protocols</entry>

diff --git a/reference/dom/domnode.xml b/reference/dom/domnode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fa6a5829a0d00c24eea2ed9a270e4b56f73c032f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <reference xml:id="class.domnode" 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 DOMNode</title>
  <titleabbrev>DOMNode</titleabbrev>
@@ -164,7 +164,7 @@
     <varlistentry xml:id="domnode.props.nodetype">
      <term><varname>nodeType</varname></term>
      <listitem>
-      <para>Obtém o tipo do nó. Um dos constantes predefinidas <link linkend="dom.constants">XML_xxx_NODE</link></para>
+      <para>Obtém o tipo do nó. Um dos constantes predefinidas <constant>XML_<replaceable>*</replaceable>_NODE</constant></para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="domnode.props.parentnode">

diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="utf-8"?> <!-- CREDITS: fernandoc,marcosmarcolin -->
-<!-- EN-Revision: d0532e45fb2b6766c7fc73c7ccfc30a9720f8888 Maintainer: marcosmarcolin Status: ready -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: fernandoc,marcosmarcolin,leonardolara -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
  <refnamediv>
   <refname>getimagesize</refname>
@@ -118,7 +118,7 @@
    </para>
   </note>
   <para>
-   O índice 2 é uma das <link linkend="image.constants">constantes IMAGETYPE_XXX</link>, que
+   O índice 2 é uma das constantes <constant>IMAGETYPE_<replaceable>*</replaceable></constant>, que
    indica o tipo da imagem.
   </para>
   <para>

diff --git a/reference/image/functions/image-type-to-extension.xml b/reference/image/functions/image-type-to-extension.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.image-type-to-extension" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>image_type_to_extension</refname>
@@ -13,7 +13,7 @@
    <methodparam choice="opt"><type>bool</type><parameter>include_dot</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Retorna a extensão de arquivo para a constante <literal>IMAGETYPE_XXX</literal>
+   Retorna a extensão de arquivo para a constante <constant>IMAGETYPE_<replaceable>*</replaceable></constant>
    informada.
   </para>
  </refsect1>
@@ -25,7 +25,7 @@
      <term><parameter>image_type</parameter></term>
      <listitem>
       <para>
-       Uma das constantes <literal>IMAGETYPE_XXX</literal>.
+       Uma das constantes <constant>IMAGETYPE_<replaceable>*</replaceable></constant>.
       </para>
      </listitem>
     </varlistentry>
@@ -40,7 +40,7 @@
    </variablelist>
   </para>
  </refsect1>
- 
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -73,7 +73,7 @@ imagedestroy($im);
   &reftitle.notes;
   &note.gd.notrequired;
  </refsect1>
- 
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/image/functions/image-type-to-mime-type.xml b/reference/image/functions/image-type-to-mime-type.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f40e02ff1bd0eb238dc8e542434004de9eb03a58 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.image-type-to-mime-type" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>image_type_to_mime_type</refname>
@@ -25,7 +25,7 @@
      <term><parameter>image_type</parameter></term>
      <listitem>
       <para>
-       Uma das constantes <literal>IMAGETYPE_XXX</literal>.
+       Uma das constantes <constant>IMAGETYPE_<replaceable>*</replaceable></constant>.
       </para>
      </listitem>
     </varlistentry>

diff --git a/reference/image/functions/imagepng.xml b/reference/image/functions/imagepng.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: ae Status: ready --><!-- CREDITS: fernandoc,ae,leonardolara -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: ae Status: ready --><!-- CREDITS: fernandoc,ae,leonardolara -->
 <refentry xml:id="function.imagepng" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagepng</refname>
@@ -51,7 +51,7 @@
      <listitem>
       <para>
        Permite reduzir o tamanho do arquivo PNG. Uma máscara de bits pode ser
-       informada por qualquer combinação das contantes <literal>PNG_FILTER_XXX</literal>.
+       informada por qualquer combinação das contantes <constant>PNG_FILTER_<replaceable>*</replaceable></constant>.
        <constant>PNG_NO_FILTER</constant> ou
        <constant>PNG_ALL_FILTERS</constant> também podem ser utilizados, respectivamente,
        para desativar ou ativar todos os filtros.

diff --git a/reference/soap/soapserver/setpersistence.xml b/reference/soap/soapserver/setpersistence.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="soapserver.setpersistence" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>SoapServer::setPersistence</refname>
@@ -39,7 +39,7 @@
      <term><parameter>mode</parameter></term>
      <listitem>
       <para>
-       Uma das constantes <literal>SOAP_PERSISTENCE_XXX</literal>.
+       Uma das constantes <constant>SOAP_PERSISTENCE_<replaceable>*</replaceable></constant>.
       </para>
       <para>
        <constant>SOAP_PERSISTENCE_REQUEST</constant> - Os dados do SoapServer não persistem entre

diff --git a/reference/spl/arrayobject/getiterator.xml b/reference/spl/arrayobject/getiterator.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d51166ca16fda8e766849505b84f9306ef443f71 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: diogo -->
+<!-- EN-Revision: da11d3f56626c3d87a4933227180909676b27109 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: diogo, leonardolara -->
 <refentry xml:id="arrayobject.getiterator" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ArrayObject::getIterator</refname>
   <refpurpose>Retorna o iterador do ArrayObject</refpurpose>
  </refnamediv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="ArrayObject">
@@ -36,19 +37,23 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$array = array('1' => 'um',
-               '2' => 'dois',
-               '3' => 'três');
+
+$array = [
+    '1' => 'um',
+    '2' => 'dois',
+    '3' => 'três',
+];
 
 $arrayobject = new ArrayObject($array);
 
 $iterator = $arrayobject->getIterator();
 
-while($iterator->valid()) {
+while ($iterator->valid()) {
     echo $iterator->key() . ' => ' . $iterator->current() . "\n";
 
     $iterator->next();
 }
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/tidy/constants.xml b/reference/tidy/constants.xml
@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 423252b252bbb0d54ed044b279caa7938f755226 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: leonardolara Status: ready -->
 <appendix xml:id="tidy.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
  <para>
-  Cada <literal>TIDY_TAG_XXX</literal> representa uma tag HTML. Por exemplo,
-  <constant>TIDY_TAG_A</constant> representa uma tag
-  <literal>"&lt;a href="XX"&gt;link&lt;/a&gt;"</literal> tag.
+  Cada <constant>TIDY_TAG_<replaceable>*</replaceable></constant> representa uma etiqueta HTML. Por exemplo,
+  <constant>TIDY_TAG_A</constant> representa uma etiqueta
+  <literal>"&lt;a href="XX"&gt;link&lt;/a&gt;"</literal>.
  </para>
  <para>
   As seguintes constantes estão definidas:
   <table xml:id="tidy.constants.tag">
-   <title>Constantes de tag do Tidy</title>
+   <title>Constantes de etiqueta do Tidy</title>
     <tgroup cols="2">
      <thead>
       <row>