Merge branch 'master' of github.com:php/doc-pt_br

.tools/test/spce.php

@@ -36,7 +36,6 @@ function wsfix( $filename )
         $srcLines = explode_lines( $srcText );
         $dstLines = explode_lines( $dstText );
 
-        fwrite( STDERR , "Text line count mismatch: $filename\n" );
         for ( $l = 0 ; $l < min ( count( $srcLines ), count( $dstLines ) ) ; $l++ )
         {
             $fillcount = 0;
@@ -45,7 +44,7 @@ function wsfix( $filename )
             if ( $fillcount == 1 )
             {
                 $l1 = $l + 1;
-                fwrite( STDERR , "First mismatch at line {$l1}.\n" );
+                fwrite( STDERR , "Text line count mismatch: {$filename}:{$l1}\n" );
                 break;
             }
         }

README.md

@@ -1,18 +1,12 @@
-# Tradução brasileira da Documentação do PHP
+# Repositório da tradução brasileira do Manual do PHP
 
-[![Build][build-badge]][build-action]
+Veja [prioridades](https://github.com/php/doc-pt_br/wiki/Prioridades) e como participar [na _wiki_][wiki]. Pequenas correções e sugestões podem ser feitas por _issues_ ou pelo processo
+convencional de _fork_ e _pull requests_ do GitHub.
 
-## Resumo
+[![Build][build-badge]][build-action]
 
 [![Revision script][revcheck-graph]][revcheck-summary]
 
-## Contribuindo
-
-Veja como participar [na nossa _wiki_][wiki].
-
-Pequenas correções e sugestões podem ser feitas por _issues_ ou pelo processo
-convencional de _pull requests_ pelo GitHub mesmo.
-
 [build-action]: https://github.com/php/doc-pt_br/actions/workflows/build.yaml
 
 [build-badge]: https://github.com/php/doc-pt_br/actions/workflows/build.yaml/badge.svg?branch=master

appendices/about.xml

@@ -71,7 +71,7 @@
   </para>
 
   <para>
-   Existe também uma <link xlink:href="&url.php.echm;">versão CHM extendida</link>
+   Existe também uma <link xlink:href="&url.php.echm;">versão CHM estendida</link>
    disponível, que é atualizada menos frequentemente, mas que oferece muitos recursos
    adicionais. Entretanto ela irá funcionar apenas no <productname>Microsoft Windows</productname>,
    devido às tecnologias usadas para compilar as páginas de ajuda.
@@ -222,7 +222,7 @@ Retorna o tamanho da string dada.
      O que isso significa? in_array() retorna um valor
      <link linkend="language.types.boolean">booleano</link>, &true; em caso de
      sucesso (se <parameter>needle</parameter> foi encontrado em
-     <parameter>haystack</parameter>) ou &false; em caso de falha (se
+     <parameter>haystack</parameter>) &return.falseforfailure; (se
      <parameter>needle</parameter> não foi encontrado em
      <parameter>haystack</parameter>). O primeiro parâmetro é chamado
      <parameter>needle</parameter> e pode de ser de vários
@@ -233,7 +233,7 @@ Retorna o tamanho da string dada.
      <link linkend="language.types.array">array</link>.
      <parameter>haystack</parameter> (o array onde nós estamos procurando) é o
      segundo parâmetro. O terceiro parâmetro <emphasis>opcional</emphasis> é
-     chamado <parameter>strict</parameter>. Todos os parâmetros opcionais tem valores
+     chamado <parameter>strict</parameter>. Todos os parâmetros opcionais têm valores
      padrão (default). Se o valor padrão é desconhecido, então é mostrado um <literal>?</literal>. O exemplo
      diz que o valor padrão do parâmetro <parameter>strict</parameter> é o
      booleano &false;. Veja a página do manual de cada função para detalhes de
@@ -349,7 +349,7 @@ Retorna o tamanho da string dada.
   </para>
   <note>
    <para>
-    Por favor não abuse dos rastreadores de problemas enviando pedidos de ajuda.
+    Por favor, não abuse dos rastreadores de problemas enviando pedidos de ajuda.
     Neste caso, use uma das muitas
     <link xlink:href="&url.php.support;">opções de suporte</link>.
    </para>
@@ -373,7 +373,7 @@ Retorna o tamanho da string dada.
   </para>
   <para>
    O Projeto de Documentação do PHP também possui um canal IRC onde muitos
-   autores do manual se reunem. Passe no canal <literal>#php.doc</literal> em
+   autores do manual se reúnem. Passe no canal <literal>#php.doc</literal> em
    <literal>irc.efnet.org</literal> e discuta maneiras de melhorar
    a documentação do PHP.
   </para>
@@ -382,7 +382,7 @@ Retorna o tamanho da string dada.
  <sect1 xml:id="about.generate">
   <title>Como nós geramos os formatos</title>
   <para>
-   Este Manual é escrito em <acronym>XML</acronym> usando o<link
+   Este Manual é escrito em <acronym>XML</acronym> usando o <link
    xlink:href="&url.docbook.xml;">DocBook XML DTD</link>, usando <link
    xlink:href="&url.phd;"><acronym>PhD</acronym></link> (The [PH]P based
    [D]ocBook renderer) para manutenção e formatação.
@@ -391,7 +391,7 @@ Retorna o tamanho da string dada.
    Usar <acronym>XML</acronym> como formato fonte nos dá
    a capacidade de gerar diversos formatos de saída a partir
    dos arquivos fonte, enquanto apenas um documento fonte é mantido para todos os formatos.
-   A ferramente usada para formatar o manual online é <link
+   A ferramenta usada para formatar o manual online é <link
    xlink:href="&url.phd;">PhD</link>.
    Usamos <link xlink:href="&url.winhelp;">Microsoft HTML Help
    Workshop</link> para gerar o formato <productname>Windows HTML Help</productname>

appendices/filters.xml

@@ -187,9 +187,9 @@ $fp = fopen('php://output', 'w');
 stream_filter_append($fp, 'convert.base64-encode', STREAM_FILTER_WRITE, $param);
 fwrite($fp, "Isto é um teste.\n");
 fclose($fp);
-/* Saída:    SXN0byDD
-        :    qSB1bSB0
-        :    ZXN0ZS4K  */
+/* Saída  :  SXN0byDD
+          :  qSB1bSB0
+          :  ZXN0ZS4K  */
 
 $fp = fopen('php://output', 'w');
 stream_filter_append($fp, 'convert.base64-decode');
@@ -242,7 +242,7 @@ fwrite($fp, "Isto é um teste.\n");
     o suporte a <link linkend="book.iconv">iconv</link> estiver habilitado, e se sua utilização é
     equivalente a processar todos os dados do stream através do <function>iconv</function>.
     Esses filtros não suportam parâmetros, em vez disso esperam que as codificações
-    de entrada e saída sejam informados no nome do filtro, por exemplo, 
+    de entrada e saída sejam informados no nome do filtro, por exemplo,
     <literal>convert.iconv.&lt;input-encoding&gt;.&lt;output-encoding&gt;</literal> ou
     <literal>convert.iconv.&lt;input-encoding&gt;/&lt;output-encoding&gt;</literal>
     (ambas notações são equivalentes).
@@ -419,8 +419,8 @@ O arquivo comprimido tem 60 bytes.
    </simpara>
 
    <simpara>
-    Filtros de compressão zlib.* compression estarão disponíveis se o suporte ao
-    <link linkend="ref.zlib">zlib</link> estiver ativado.
+     Filtros de compressão bzip2.* estão disponíveis se suporte a
+     <link linkend="ref.bzip2">bz2</link> estiver ativado.
    </simpara>
 
    <example>

appendices/migration70/incompatible/other.xml

@@ -151,7 +151,7 @@ class B {
 ?>
 ]]>
    </programlisting>
-   &example.outputs.5;
+   &example.outputs.56;
    <screen>
 <![CDATA[
 Deprecated: Non-static method A::test() should not be called statically, assuming $this from incompatible context in /tmp/test.php on line 8

appendices/migration81/new-features.xml

@@ -81,7 +81,7 @@ $arr2 = [...$arr1, 'c' => 'd']; //[1, 'a' => 'b', 'c' => 'd']
    <title>Fibers</title>
 
    <para>
-    Suporte para <link linkend="class.fiber">Fibers</link> foi adicionado.
+    Suporte para <link linkend="language.fibers">Fibers</link> foi adicionado.
     <!-- RFC: https://wiki.php.net/rfc/fibers -->
    </para>
   </sect3>
@@ -156,7 +156,7 @@ $arr2 = [...$arr1, 'c' => 'd']; //[1, 'a' => 'b', 'c' => 'd']
 
    <para>
     Adicionado suporte ao <link linkend="language.oop5.final.example.php81">modificador <modifier>final</modifier> para constantes de classe.</link>
-    Além disso as constantes de interface podem ser sobreescritas.
+    Além disso, as constantes de interface podem ser sobreescritas.
     <!-- RFC: https://wiki.php.net/rfc/final_class_const -->
    </para>
   </sect3>
@@ -426,7 +426,7 @@ echo $result->fetch_column();
   <para>
    A sintaxe DSN <literal>"file:"</literal> do SQLite agora é suportada,
    que permite especificar flags adicionais.
-   Essa funcionalidade não está disponível se open_basedir estiver definida.
+   Essa funcionalidade não está disponível se open_basedir estiver definido.
    <informalexample>
     <programlisting role="php">
 <![CDATA[
@@ -453,7 +453,7 @@ new PDO('sqlite:file:caminho/para/sqlite.db?mode=ro')
 
   <para>
    <function>fputcsv</function> agora aceita um novo argumento
-   <parameter>eol</parameter> que permite a definição de uma sequencia de
+   <parameter>eol</parameter> que permite a definição de uma sequência de
    fim de linha personalizada, o padrão continua o mesmo e é <literal>"\n"</literal>.
   </para>
  </sect2>
@@ -463,7 +463,7 @@ new PDO('sqlite:file:caminho/para/sqlite.db?mode=ro')
 
   <para>
    <methodname>SplFileObject::fputcsv</methodname> agora aceita um novo argumento
-   <parameter>eol</parameter> que permite a definição de uma sequencia de
+   <parameter>eol</parameter> que permite a definição de uma sequência de
    fim de linha personalizada, o padrão continua o mesmo e é <literal>"\n"</literal>.
   </para>
  </sect2>

bookinfo.xml

@@ -31,7 +31,7 @@
    </simpara>
   </legalnotice>
 
-  <authorgroup xml:id="translators">
+  <authorgroup>
    <author>
     <personname>Alessander Pery Lopes Thomaz</personname>
    </author>
@@ -101,7 +101,7 @@
   </authorgroup>
 
  </info>
- 
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

faq/mailinglist.xml

@@ -18,7 +18,7 @@
      <para>
       É claro! Existem várias listas de discussão sobre vários assuntos.
       Uma listagem das principais listas de discussão pode ser encontrada na nossa
-      página de <link xlink:href="&url.php.support;">Suporte</link>.
+      <link xlink:href="&url.php.mailing-lists;">listas de discussão por email</link>.
      </para>
      <para>
       A lista de discussão mais geral é <literal>php-general</literal>.
@@ -28,7 +28,7 @@
      </para>
      <para>
       Você pode se inscrever e sair das listas usando nossa interface
-      web disponível em <link xlink:href="&url.php.support;">Suporte</link>,
+      web disponível em <link xlink:href="&url.php.mailing-lists;">listas de discussão</link>,
       além de instruções incluídas no rodapé
       de cada e-mail da lista.
      </para>
@@ -41,7 +41,7 @@
     </question>
     <answer>
      <para>
-      Existem incontáveis comunidades voltadas a PHP ao redor do mundo. Nós
+      Existem incontáveis comunidades voltadas ao PHP ao redor do mundo. Nós
       temos links, para algumas delas (e informação de como aprender mais) em nossa página
       de <link xlink:href="&url.php.support;">Suporte</link>
      </para>
@@ -50,7 +50,7 @@
 
    <qandaentry xml:id="faq.mailinglist.myown">
     <question>
-     <para>Posso iniciar minha própia lista de discussões de PHP?</para>
+     <para>Posso iniciar minha própria lista de discussões de PHP?</para>
     </question>
     <answer>
      <para>
@@ -65,7 +65,7 @@
    <qandaentry xml:id="faq.mailinglist.subscribing">
     <question>
      <para>
-      Ajuda! Não consigo me increver ou sair de
+      Ajuda! Não consigo me inscrever ou sair de
       nenhuma das listas de discussão!
      </para>
     </question>
@@ -83,7 +83,7 @@
      </para>
      <para>
       A causa mais comum para as pessoas terem dificuldades em se inscrever ou sair de
-      uma lista de disscussão é por causa do uso de e-mails encaminhados. Por exemplo
+      uma lista de discussão é por causa do uso de e-mails encaminhados. Por exemplo
       se seu e-mail for [email protected], mas você se inscrever
       usando um e-mail com encaminhamento como [email protected] que repassa
       depois a [email protected], tentar remover da lista o e-mail
@@ -96,19 +96,19 @@
 
    <qandaentry xml:id="faq.mailinglist.archive">
     <question>
-     <para>Existe um histório das listas de discussão em algum lugar?</para>
+     <para>Existe um histórico das listas de discussão em algum lugar?</para>
     </question>
     <answer>
      <para>
        Sim, você encontrará uma lista de sites com o histórico na
        página de <link xlink:href="&url.php.mailing-lists;">listas de email</link>.
        Você também vai encontrar dezenas de arquivos e/ou referências
-       para nossas listas de discussões usando seu macanismo de busca preferido
+       para nossas listas de discussões usando seu mecanismo de busca preferido
        ao procurar por "php mailing list archives".
-    </para>
-    <para>
+     </para>
+     <para>
        Os artigos da lista de discussão também são arquivados como
-       mensagens de nóticia. Você pode acessar o servidor de notícias em <link
+       mensagens de notícia. Você pode acessar o servidor de notícias em <link
        xlink:href="&url.php.news;">&url.php.news;</link>
        com um cliente de notícias. Também existe uma interface web
        experimental para o servidor de notícias em <link
@@ -132,7 +132,7 @@
      <para>
       Antes de postar em uma lista verifique nessa FAQ e no
       manual se não consegue encontrar a informação aqui. Se não
-      encontrar então daí tente os arquivos das listas (veja acima).
+      encontrar então tente os arquivos das listas (veja acima).
       Se está tendo problemas instalando ou configurando o PHP primeiro
       leia toda a documentação incluída e os README's. Se ainda não
       conseguir encontrar a informação que lhe ajude, você é
@@ -162,7 +162,7 @@
     </question>
     <answer>
      <para>
-      Mensagems como "Não consigo colocar o PHP para funcionar! Me ajude! O que está
+      Mensagens como "Não consigo colocar o PHP para funcionar! Me ajude! O que está
       errado?" são inúteis. Se você tiver problemas
       fazendo o PHP funcionar, você deve incluir que sistema operacional
       você está usando, qual a versão do PHP você está tentando instalar,
@@ -175,21 +175,21 @@
       encontradas no processo. Se você tiver problemas com nosso código
       fonte, você precisa incluir a parte do código que não está funcionando,
       indicando a linha apresenta o problema através do posicionamento de
-      um comentário de códio. Não inclua mais código
+      um comentário de código. Não inclua mais código
       que o necessário! Isso torna a mensagem difícil de ler e muitas
       pessoas podem simplesmente ignorar ela por isso. Se você não
       tiver certeza sobre quanta informação incluir na mensagem, é melhor
       incluir muito do que pouco.
      </para>
      <para>
       Outra coisa importante a lembrar é resumir o problema no
-      assunto da mensagem. Um assungo como "SOCCOOORRROO!!!" ou "Qual é o
+      assunto da mensagem. Um assunto como "SOCCOOORRROO!!!" ou "Qual é o
       problema aqui" será ignorada pela maioria dos leitores.
      </para>
      <para>
       E finalmente, você é encorajado a ler o artigo sobre
       <link xlink:href="&url.smart.questions;">Como Fazer Perguntas de
-      Maneira Inteligente</link> já quer irá ser de grande ajuda para todo mundo,
+      Maneira Inteligente</link> já que irá ser de grande ajuda para todo mundo,
       especialmente você.
      </para>
     </answer>

install/unix/index.xml

@@ -105,7 +105,7 @@
     Você pode pegar a lista de todas as opções disponíveis junto com uma pequena
     explicação executando o comando <command>./configure --help</command>.
     Nosso manual documenta as diferentes opções separadamente. Você encontrará
-    as <link linkend="configure">opções principais no apêndice</link>,
+    as <link linkend="configure.about">opções principais no apêndice</link>,
     enquanto as opções específicas das diferentes extensões são descritas nas
     páginas de referência.
    </para>
@@ -130,7 +130,7 @@
 
    <note>
     <simpara>
-     A compilação cruzada para ARM através do toolchain Android não é surportada.
+     A compilação cruzada para ARM através do toolchain Android não é suportada.
     </simpara>
    </note>
 

language/exceptions.xml

@@ -42,7 +42,7 @@
     Múltiplos blocos &catch; podem ser utilizados para capturar exceções
     diferentes. A execução normal (quando nenhuma exceção é lançada dentro de um
     &try;) irão continuar a execução após o último &catch; definido em sequência.
-    Exceções podem ser lançadas (ou relançadas) dentro um bloco &catch;. Caso contrário,
+    Exceções podem ser lançadas ou relançadas (&throw;) dentro um bloco &catch;. Caso contrário,
     a execução irá continuar após o bloco&catch; que foi acionado.
    </para>
    <para>
@@ -87,7 +87,7 @@
   <title><literal>Manipulador de exceções global</literal></title>
   <para>
    Se uma exceção alcança o escopo global, ela ainda pode ser capturada
-   por um manipulador global de esceções, opcional. A função <function>set_exception_handler</function>
+   por um manipulador global de exceções, opcional. A função <function>set_exception_handler</function>
    pode configurar uma função que será chamada no lugar de um bloco &catch; na ausẽncia
    de outros blocos. O efeito é essencialmente o mesmo que ter o programa inteiro
    envelopado dentro de um bloco &try;-&catch; e a função informada funcionando como o &catch;.
@@ -528,7 +528,7 @@ echo "\n\n";
  </sect1>
 
  </chapter>
- 
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

language/functions.xml

@@ -1068,7 +1068,7 @@ $func(); // prints "bar"
     <para>
      Tipos escalares para funções embutidas são anuláveis por padrão no modo coercivo.
      A partir do PHP 8.1.0, passar &null; para um parâmetro de uma função interna que não é declarado anulável
-     é desencorajado e emite uma notícia de depreciação no modo coercivo para alinhar com o comportamento de funções definidas pelo usuário,
+     é desencorajado e emite uma notícia de depreciação no modo coercitivo para alinhar com o comportamento de funções definidas pelo usuário,
      onde tipos escalares precisam ser marcados como anuláveis explícitamente.
     </para>
 
@@ -1726,7 +1726,7 @@ $metodoPrivado();  // Foo1::metodoPrivado
 
    <note>
     <para>
-     A sintaxe de callable de primeira classe não pode ser combinada com o operador nullsafe. Ambos os resultados a seguir resultam em um erro de tempo de compilação:
+     A sintaxe de callable de primeira classe não pode ser combinada com o <link linkend="language.oop5.basic.nullsafe">operador nullsafe</link>. Ambos os resultados a seguir resultam em um erro de tempo de compilação:
      <example>
       <programlisting role="php">
 <![CDATA[