fix and improve translation

2026-03-23 22:52:12 +01:00 · 2025-06-07 18:15:22 -03:00
parent 69e9330d11
commit 3ae15180a3
19 changed files with 70 additions and 70 deletions
--- a/reference/dio/functions/dio-seek.xml
+++ b/reference/dio/functions/dio-seek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="function.dio-seek" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>dio_seek</refname>
-  <refpurpose>Move-se para a posição pos no descritor de arquivo (fd) a partir de whence</refpurpose>
+  <refpurpose>Move para a posição pos no descritor de arquivo (fd) a partir de whence</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
--- a/reference/eio/functions/eio-seek.xml
+++ b/reference/eio/functions/eio-seek.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="function.eio-seek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>eio_seek</refname>
-  <refpurpose>Busca uma posição</refpurpose>
+  <refpurpose>Aponta para uma posição</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -52,13 +52,13 @@
    <term><parameter>whence</parameter></term>
    <listitem>
     <para>
-       Os valores para <parameter>whence</parameter> são:
-       <simplelist>
-        <member><constant>EIO_SEEK_SET</constant> - Define a posição igual a <parameter>offset</parameter> bytes.</member>
-        <member><constant>EIO_SEEK_CUR</constant> - Define a posição igual à atual mais <parameter>offset</parameter>.</member>
-        <member><constant>EIO_SEEK_END</constant> - Define a posição igual à do final do arquivo mais <parameter>offset</parameter>.</member>
-       </simplelist>
-      </para>
+      Os valores para <parameter>whence</parameter> são:
+      <simplelist>
+       <member><constant>EIO_SEEK_SET</constant> - Define a posição igual a <parameter>offset</parameter> bytes.</member>
+       <member><constant>EIO_SEEK_CUR</constant> - Define a posição igual à atual mais <parameter>offset</parameter>.</member>
+       <member><constant>EIO_SEEK_END</constant> - Define a posição igual à do final do arquivo mais <parameter>offset</parameter>.</member>
+      </simplelist>
+     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
--- a/reference/filesystem/functions/fseek.xml
+++ b/reference/filesystem/functions/fseek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="function.fseek" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
 <refname>fseek</refname>
- <refpurpose>Procura (seeks) em um ponteiro de arquivo</refpurpose>
+ <refpurpose>Aponta para uma posição no arquivo</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -22,9 +22,9 @@
  <parameter>whence</parameter>.
 </para>
 <para>
-  Geralmente é permitido procurar (seek) além do fim-do-arquivo; se algum dado for então
+  Geralmente é permitido apontar para além do fim-do-arquivo; se algum dado for então
  escrito, leituras além de qualquer região escrita entre o fim-do-arquivo e a região desejada
-  irão trazer bytes com valor 0. Entretanto, alguns fluxos (streams)
+  irão trazer bytes com valor 0. Entretanto, alguns fluxos
  podem não suportar esse comportamento, especialmente quando têm definido
  um tamanho de armazenamento fixo.
 </para>
@@ -47,7 +47,7 @@
      A posição.
     </para>
     <para>
-      Para mover até uma posição anterior ao fim-do-arquivo,
+      Para apontar para uma posição anterior ao fim-do-arquivo,
      um valor negativo em <parameter>offset</parameter> deve ser passado
      e o parâmetro <parameter>whence</parameter> deve ser definido
      para <constant>SEEK_END</constant>.
--- a/reference/mysql/functions/mysql-data-seek.xml
+++ b/reference/mysql/functions/mysql-data-seek.xml
@@ -74,21 +74,21 @@
 <?php
 $link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
 if (!$link) {
-    die('Could not connect: ' . mysql_error());
+    die('Não foi possível conectar: ' . mysql_error());
 }
 $db_selected = mysql_select_db('sample_db');
 if (!$db_selected) {
-    die('Could not select database: ' . mysql_error());
+    die('Não foi possível selecionar o banco de dados: ' . mysql_error());
 }
 $query = 'SELECT last_name, first_name FROM friends';
 $result = mysql_query($query);
 if (!$result) {
-    die('Query failed: ' . mysql_error());
+    die('A consulta falhou: ' . mysql_error());
 }
-/* fetch rows in reverse order */
+/* Busca linhas na ordem inversa */
 for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
    if (!mysql_data_seek($result, $i)) {
-        echo "Cannot seek to row $i: " . mysql_error() . "\n";
+        echo "Não foi possível apontar para a linha $i: " . mysql_error() . "\n";
        continue;
    }

--- a/reference/mysqli/mysqli_result/data-seek.xml
+++ b/reference/mysqli/mysqli_result/data-seek.xml
@@ -73,7 +73,7 @@ $result->data_seek(400);
 /* Recebe uma única linha */
 $row = $result->fetch_row();

-printf("City: %s  Countrycode: %s\n", $row[0], $row[1]);
+printf("Cidade: %s  Código do país: %s\n", $row[0], $row[1]);
 ]]>
   </programlisting>
   <para>&style.procedural;</para>
@@ -94,13 +94,13 @@ mysqli_data_seek($result, 400);
 /* Recebe uma única linha */
 $row = mysqli_fetch_row($result);

-printf ("City: %s  Countrycode: %s\n", $row[0], $row[1]);
+printf ("Cidade: %s  Código do país: %s\n", $row[0], $row[1]);
 ]]>
   </programlisting>
   &examples.outputs;
   <screen>
 <![CDATA[
-City: Benin City  Countrycode: NGA
+Cidade: Benin City  Código do país: NGA
 ]]>
   </screen>
  </example>
@@ -128,7 +128,7 @@ for ($row_no = $result->num_rows - 1; $row_no >= 0; $row_no--) {
    /* Recebe uma linha */
    $row = $result->fetch_row();

-    printf("City: %s  Countrycode: %s\n", $row[0], $row[1]);
+    printf("Cidade: %s  Código do país: %s\n", $row[0], $row[1]);
 }

 /* Redefine o ponteito para o início do conjunto de resultados */
@@ -138,22 +138,22 @@ print "\n";

 /* Itera o mesmo conjunto novamente */
 while ($row = $result->fetch_row()) {
-    printf("City: %s  Countrycode: %s\n", $row[0], $row[1]);
+    printf("Cidade: %s  Código do país: %s\n", $row[0], $row[1]);
 }
 ]]>
   </programlisting>
   &examples.outputs;
   <screen>
 <![CDATA[
-City: Acmbaro  Countrycode: MEX
-City: Abuja  Countrycode: NGA
-City: Abu Dhabi  Countrycode: ARE
-City: Abottabad  Countrycode: PAK
+Cidade: Acmbaro  Código do país: MEX
+Cidade: Abuja  Código do país: NGA
+Cidade: Abu Dhabi  Código do país: ARE
+Cidade: Abottabad  Código do país: PAK

-City: Abottabad  Countrycode: PAK
-City: Abu Dhabi  Countrycode: ARE
-City: Abuja  Countrycode: NGA
-City: Acmbaro  Countrycode: MEX
+Cidade: Abottabad  Código do país: PAK
+Cidade: Abu Dhabi  Código do país: ARE
+Cidade: Abuja  Código do país: NGA
+Cidade: Acmbaro  Código do país: MEX
 ]]>
   </screen>
  </example>
--- a/reference/mysqli/summary.xml
+++ b/reference/mysqli/summary.xml
@@ -456,7 +456,7 @@
     <entry><methodname>mysqli_stmt::data_seek</methodname></entry>
     <entry><function>mysqli_stmt_data_seek</function></entry>
     <entry>N/A</entry>
-     <entry>Procura uma linha arbitrária no conjunto de resultados da instrução</entry>
+     <entry>Aponta para uma linha arbitrária no conjunto de resultados da instrução</entry>
    </row>
    <row>
     <entry><methodname>mysqli_stmt::execute</methodname></entry>
--- a/reference/pgsql/functions/pg-lo-seek.xml
+++ b/reference/pgsql/functions/pg-lo-seek.xml
@@ -5,7 +5,7 @@
 <refnamediv>
  <refname>pg_lo_seek</refname>
  <refpurpose>
-   Procura posição dentro de um objeto grande
+   Aponta para posição dentro de um objeto grande
  </refpurpose>
 </refnamediv>

@@ -40,7 +40,7 @@
     <term><parameter>offset</parameter></term>
     <listitem>
      <para>
-       O número de bytes a serem procurados.
+       A posição em bytes para apontar.
      </para>
     </listitem>
    </varlistentry>
@@ -48,9 +48,9 @@
     <term><parameter>whence</parameter></term>
     <listitem>
      <para>
-       Uma das constantes <constant>PGSQL_SEEK_SET</constant> (busca no início do objeto),
-       <constant>PGSQL_SEEK_CUR</constant> (busca na posição atual)
-       ou <constant>PGSQL_SEEK_END</constant> (busca no final do objeto).
+       Uma das constantes <constant>PGSQL_SEEK_SET</constant> (aponta a partir do início do objeto),
+       <constant>PGSQL_SEEK_CUR</constant> (aponta a partir da posição atual)
+       ou <constant>PGSQL_SEEK_END</constant> (aponta a partir do final do objeto).
      </para>
     </listitem>
    </varlistentry>
--- a/reference/spl/arrayiterator/key.xml
+++ b/reference/spl/arrayiterator/key.xml
@@ -42,7 +42,7 @@ $array = array('key' => 'value');
 $arrayobject = new ArrayObject($array);
 $iterator = $arrayobject->getIterator();

-echo $iterator->key(); //key
+echo $iterator->key(); // chave
 ?>
 ]]>
    </programlisting>
--- a/reference/spl/arrayiterator/next.xml
+++ b/reference/spl/arrayiterator/next.xml
@@ -13,7 +13,7 @@
   <void/>
  </methodsynopsis>
  <para>
-   O iterador para o próximo elemento do array.
+   Avança o iterador para o próximo elemento do array.
  </para>
 </refsect1>

--- a/reference/spl/arrayiterator/rewind.xml
+++ b/reference/spl/arrayiterator/rewind.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="arrayiterator.rewind" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ArrayIterator::rewind</refname>
-  <refpurpose>Recoloca o array no início</refpurpose>
+  <refpurpose>Retrocede o array</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -13,7 +13,7 @@
   <void/>
  </methodsynopsis>
  <para>
-   Esta função recoloca o iterador no início do array.
+   Esta função retrocede o iterador para o início do array.
  </para>
 </refsect1>

@@ -46,10 +46,10 @@ $arrayobject[] = 'dois';
 $iterator = $arrayobject->getIterator();

 $iterator->next();
-echo $iterator->key(); //1
+echo $iterator->key(); // 1

-$iterator->rewind(); //retornando ao início
-echo $iterator->key(); //0
+$iterator->rewind(); // retornando ao início
+echo $iterator->key(); // 0
 ?>
 ]]>
    </programlisting>
--- a/reference/spl/arrayiterator/valid.xml
+++ b/reference/spl/arrayiterator/valid.xml
@@ -46,7 +46,7 @@ var_dump($iterator->valid()); //bool(true)

 $iterator->next(); // avança para o próximo item

-//bool(false) porque só existe um único elemento no array
+// bool(false) porque só existe um único elemento no array
 var_dump($iterator->valid());
 ?>
 ]]>
--- a/reference/spl/directoryiterator/seek.xml
+++ b/reference/spl/directoryiterator/seek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="directoryiterator.seek" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>DirectoryIterator::seek</refname>
-  <refpurpose>Procura uma determinada posição no item do DirectoryIterator</refpurpose>
+  <refpurpose>Aponta para uma determinada posição no item do DirectoryIterator</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
@@ -13,7 +13,7 @@
  </methodsynopsis>

  <para>
-   Procura uma determinada posição no item do <classname>DirectoryIterator</classname>.
+   Aponta para uma determinada posição no item do <classname>DirectoryIterator</classname>.
  </para>
 </refsect1>

@@ -25,7 +25,7 @@
     <term><parameter>offset</parameter></term>
     <listitem>
      <para>
-       Posição de base zero para procurar.
+       Posição para apontar com referência em zero.
      </para>
     </listitem>
    </varlistentry>
@@ -44,9 +44,9 @@
  &reftitle.examples;
  <para>
   <example>
-    <title>Exemplo do <methodname>DirectoryIterator::seek</methodname></title>
+    <title>Exemplo de <methodname>DirectoryIterator::seek</methodname></title>
    <para>
-     Procurar o quarto item no diretório que contém o script.
+     Aponta para o quarto item no diretório que contém o script.
     Os dois primeiros geralmente são <literal>.</literal> e <literal>..</literal>
    </para>
    <programlisting role="php">
--- a/reference/spl/limititerator/seek.xml
+++ b/reference/spl/limititerator/seek.xml
@@ -35,7 +35,7 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Retorna a posição de offset após a busca.
+   Retorna a posição após o apontamento.
  </para>
 </refsect1>

--- a/reference/spl/seekableiterator/seek.xml
+++ b/reference/spl/seekableiterator/seek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="seekableiterator.seek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SeekableIterator::seek</refname>
-  <refpurpose>Move para uma posição</refpurpose>
+  <refpurpose>Aponta para uma posição</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -13,7 +13,7 @@
   <methodparam><type>int</type><parameter>offset</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Move o iterador para uma posição específica.
+   Aponta o iterador para uma posição específica.
  </para>

 </refsect1>
@@ -26,7 +26,7 @@
     <term><parameter>offset</parameter></term>
     <listitem>
      <para>
-       A posição para onde mover.
+       A posição para onde apontar.
      </para>
     </listitem>
    </varlistentry>
@@ -55,7 +55,7 @@
   <example>
    <title>Exemplo de <methodname>SeekableIterator::seek</methodname></title>
    <para>
-     Move para o item na posição 3 no iterador
+     Aponta para o item na posição 3 no iterador
     (<classname>ArrayIterator</classname> implementa <classname>SeekableIterator</classname>).
    </para>
    <programlisting role="php">
--- a/reference/spl/splfileobject/fread.xml
+++ b/reference/spl/splfileobject/fread.xml
@@ -64,7 +64,7 @@ $contents = $file->fread($file->getSize());
    Observe que <methodname>SplFileObject::fread</methodname> lê a partir da posição atual
    do ponteiro do arquivo. Use <methodname>SplFileObject::ftell</methodname>
    para encontrar a posição atual do ponteiro e <methodname>SplFileObject::rewind</methodname>
-    (ou <methodname>SplFileObject::fseek</methodname>) para rebobinar a posição do ponteiro.
+    (ou <methodname>SplFileObject::fseek</methodname>) para retroceder a posição do ponteiro.
   </para>
  </note>
 </refsect1>
--- a/reference/spl/splfileobject/fseek.xml
+++ b/reference/spl/splfileobject/fseek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="splfileobject.fseek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SplFileObject::fseek</refname>
-  <refpurpose>Posiciona-se para uma posição</refpurpose>
+  <refpurpose>Aponta para uma posição</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -14,7 +14,7 @@
   <methodparam choice="opt"><type>int</type><parameter>whence</parameter><initializer><constant>SEEK_SET</constant></initializer></methodparam>
  </methodsynopsis>
  <para>
-   Posiciona-se para uma posição no arquivo medida em bytes
+   Aponta para uma posição no arquivo medida em bytes
   a partir do início do arquivo, obtida ao adicionar o
   <parameter>offset</parameter> à posição especificada por
   <parameter>whence</parameter>.
--- a/reference/spl/splfileobject/seek.xml
+++ b/reference/spl/splfileobject/seek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="splfileobject.seek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SplFileObject::seek</refname>
-  <refpurpose>Busca uma linha especificada</refpurpose>
+  <refpurpose>Aponta para uma linha especificada</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -13,7 +13,7 @@
   <methodparam><type>int</type><parameter>line</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Busca a linha especificada no arquivo.
+   Aponta para a linha especificada no arquivo.
  </para>
 </refsect1>

@@ -25,7 +25,7 @@
     <term><parameter>line</parameter></term>
     <listitem>
      <para>
-       O número da linha baseada em zero para buscar.
+       O número da linha baseada em zero para apontar.
      </para>
     </listitem>
    </varlistentry>
@@ -43,8 +43,8 @@
 <refsect1 role="errors">
  &reftitle.errors;
  <para>
-   Lança um <classname>LogicException</classname> se a
-   <parameter>line</parameter> é negativa.
+   Lança uma <classname>LogicException</classname> se
+   <parameter>line</parameter> for negativa.
  </para>
 </refsect1>

--- a/reference/spl/splobjectstorage/seek.xml
+++ b/reference/spl/splobjectstorage/seek.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="splobjectstorage.seek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SplObjectStorage::seek</refname>
-  <refpurpose>Move o iterador para uma posição</refpurpose>
+  <refpurpose>Aponta o iterador para uma posição</refpurpose>
 </refnamediv>

 <refsect1 role="description">
@@ -13,7 +13,7 @@
  </methodsynopsis>

  <simpara>
-   Move para uma determinada posição no iterador.
+   Aponta para uma determinada posição no iterador.
  </simpara>
 </refsect1>

@@ -24,7 +24,7 @@
    <term><parameter>offset</parameter></term>
    <listitem>
     <simpara>
-      A posição a ser definida.
+      A posição a ser apontada.
     </simpara>
    </listitem>
   </varlistentry>
@@ -42,7 +42,7 @@
  &reftitle.errors;
  <simpara>
   Lança uma exceção <classname>OutOfBoundsException</classname>
-   se <parameter>offset</parameter> não for posicionável.
+   se <parameter>offset</parameter> não for apontável.
  </simpara>
 </refsect1>

@@ -51,7 +51,7 @@
  <example xml:id="splobjectstorage.seek.example.basic">
   <title>Exemplo de <methodname>SplObjectStorage::seek</methodname></title>
   <simpara>
-    Move para o item na posição 2 no iterador.
+    Aponta para o item na posição 2 no iterador.
   </simpara>
   <programlisting role="php">
 <![CDATA[
--- a/reference/zlib/functions/gzseek.xml
+++ b/reference/zlib/functions/gzseek.xml
@@ -3,7 +3,7 @@
 <refentry xml:id="function.gzseek" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>gzseek</refname>
-  <refpurpose>Busca em um ponteiro de arquivo gz</refpurpose>
+  <refpurpose>Posiciona um ponteiro de arquivo gz</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
@@ -15,7 +15,7 @@
  </methodsynopsis>
  <para>
   Define o indicador de posição de arquivo para o ponteiro de arquivo
-   dado no byte de deslocamento dado na sequência de arquivo. Equivalente a chamar (em C)
+   dado no byte de deslocamento na sequência de arquivo. Equivalente a chamar (em C)
   <literal>gzseek(zp, offset, SEEK_SET)</literal>.
  </para>
  <para>