Sincronia estrutural, tag literal

appendices/ini.core.xml

@@ -1177,7 +1177,7 @@ include_path=".;c:\php\includes"
         Utilizar um <literal>.</literal> no include_path permite
         inclusões relativas ao diretório atual. Entretanto
         é mais eficiente utilizar explicitamente <literal>include
-        './arquivo'</literal> em vez de fazer o PHP sempre procurar no diretório
+        './file'</literal> em vez de fazer o PHP sempre procurar no diretório
         atual a cada inclusão.
        </para>
        <note>

appendices/migration80/incompatible.xml

@@ -13,7 +13,7 @@
    <para>
     Comparações não estritas entre números e strings não numéricas, agora funcionam convertendo o número em
     string e comparando as strings. As comparações entre números e strings numéricas continuam
-    funcionando como antes. Notavelmente, isso significa que a comparação: <code>0 == "não-número"</code> agora é considerada
+    funcionando como antes. Notavelmente, isso significa que a comparação: <code>0 == "not-a-number"</code> agora é considerada
     falsa.
     <informaltable>
      <tgroup cols="3">
@@ -404,9 +404,9 @@ class X {
       </programlisting>
      </para>
      <para>
-      Se <code> T1::func()</code> e <code>T2::func()</code> existem, este código anteriormente era
+      Se <code>T1::func()</code> e <code>T2::func()</code> existem, este código anteriormente era
       aceito de forma silenciosa e func assumia referência a <code>T1::func</code>. Agora irá gerar um
-      erro fatal, e <code>T1::func</code> ou <code>T2::func </code> precisam ser
+      erro fatal, e <code>T1::func</code> ou <code>T2::func</code> precisam ser
       escritos explicitamente.
      </para>
     </listitem>
@@ -862,7 +862,7 @@ $array["key"];
     <para>
      A <constant>FILTER_FLAG_SCHEME_REQUIRED</constant> e
      <constant>FILTER_FLAG_HOST_REQUIRED</constant> sinalizadores para o filtro
-     <constant>FILTER_VALIDATE_URL</constant> foram removidas. O <literal>esquema</literal>
+     <constant>FILTER_VALIDATE_URL</constant> foram removidas. O <literal>scheme</literal>
      e <literal>host</literal> são (e foram) sempre necessários.
     </para>
    </listitem>
@@ -1323,8 +1323,8 @@ $array["key"];
    </listitem>
    <listitem>
     <para>
-     <methodname>SplHeap::compare</methodname> agora especifica uma assinatura de método. Herdando classes,
-     implementar este método agora terá que usar uma assinatura de método compatível.
+     <methodname>SplFileObject::seek</methodname> agora sempre posiciona no começo da linha.
+     Anteriormente, posições <literal>&gt;=1</literal> resultavam no começo da linha seguinte.
     </para>
    </listitem>
    <listitem>
@@ -1432,7 +1432,7 @@ $array["key"];
    <listitem>
     <para>
      A opção <literal>'salt'</literal> de <function>password_hash</function> não é mais
-     suportado. Se a opção <literal>'sal'</literal> for usada, um aviso será gerado, o
+     suportado. Se a opção <literal>'salt'</literal> for usada, um aviso será gerado, o
      salt é ignorado e um salt gerado é usado em seu lugar.
     </para>
    </listitem>

chapters/tutorial.xml

@@ -81,9 +81,9 @@
      </programlisting>
      <simpara>
       Use o seu navegador para acessar o arquivo com a URL de seu servidor web, terminando
-      com a referência ao arquivo <literal>/ola.php</literal>. Quando o desenvolvimento for local está
-      URL será algo como <literal>http://localhost/ola.php</literal>
-      ou <literal>http://127.0.0.1/ola.php</literal> mas isso depende da
+      com a referência ao arquivo <literal>/hello.php</literal>. Quando o desenvolvimento for local está
+      URL será algo como <literal>http://localhost/hello.php</literal>
+      ou <literal>http://127.0.0.1/hello.php</literal> mas isso depende da
       configuração do seu servidor web. Se tudo foi configurado corretamente, este
       arquivo será interpretado pelo PHP e a seguinte mensagem será enviada ao
       seu navegador:

faq/build.xml

@@ -204,7 +204,7 @@
         <simpara>
          Tenha certeza que o binário httpd que você está executando é o
          que você acabou de compilar. Para fazer isso, tente executar:
-          <literal>/caminho/para/binário/httpd -l</literal>
+          <literal>/path/to/binary/httpd -l</literal>
         </simpara>
         <simpara>
          Se você não vê <filename>mod_php4.c</filename> na lista, então
@@ -215,7 +215,7 @@
        <listitem>
         <simpara>
          Certifique-se de ter adicionado o Mime Type correto em um dos seus
-         arquivos <literal>.conf do Apache</literal>. Deveria ser:
+         arquivos <literal>Apache .conf</literal>. Deveria ser:
          <literal>AddType application/x-httpd-php .php</literal>
         </simpara>
         <simpara>

features/commandline.xml

@@ -77,7 +77,7 @@
 
   <note>
    <para>
-    A página do <literal>manual</literal> Unix está disponível digitando <command>man
+    A página do <literal>man</literal> Unix está disponível digitando <command>man
     php</command> no ambiente shell.
    </para>
   </note>

features/file-upload.xml

@@ -257,7 +257,7 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
    <simpara>
     O PHP retorna um código de erro apropriado na array do arquivo.
     O código de erro pode ser encontrado no segmento
-    <literal>['error']</literal> da array que é criada pelo PHP durante o upload do arquivo.
+    <literal>error</literal> da array que é criada pelo PHP durante o upload do arquivo.
     Em outras palavras, o erro pode ser encontrado em
     <varname>$_FILES['userfile']['error']</varname>.
    </simpara>
@@ -371,7 +371,7 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
      O parâmetro <link linkend="ini.max-input-time">max_input_time</link> define o tempo máximo,
      em segundos, que é permitido ao script a receber entradas, isto inclui
      upload de arquivos. Para um arquivo grande, múltiplos arquivos ou usuários com conexões lentas,
-     o padrão de <literal>60 segundos</literal> pode ser ultrapassado.
+     o padrão de <literal>60</literal> segundos pode ser ultrapassado.
     </simpara>
    </warning>
    <simpara>

features/remote-files.xml

@@ -56,9 +56,9 @@ fclose($file);
   <para>
    Para conectar como um usuário diferente de 'anonymous', você precisa especificar
    o nome de usuário (e possivelmente a senha) dentro da URL, como
-   '<literal>ftp://usuario:senha@ftp.example.com/caminho/para/arquivo</literal>'. (Você pode usar
-   o mesmo tipo de sintaxe para acessar arquivos via <acronym>HTTP</acronym> quando eles requerem
-   autenticação Basic).
+   '<literal>ftp://user:password@ftp.example.com/path/to/file</literal>'.
+   (Você pode usar o mesmo tipo de sintaxe para acessar arquivos via
+   <acronym>HTTP</acronym> quando eles requerem autenticação Basic).
   </para>
   <para>
    <example>

install/macos/bundled.xml

@@ -39,8 +39,8 @@
      <simpara>
       Uma maneira de modificar o arquivo é usando um editor de texto baseado em Unix no
       Terminal, por exemplo <literal>nano</literal>, e, como o dono do arquivo 
-      é o root, nós usaremos o comando <literal>sudo</literal> para abrí-lo.
-      Digite o seguinte comando na aplicação de
+      é o <literal>root</literal>, nós usaremos o comando <literal>sudo</literal>
+      para abrí-lo (no usuário <literal>root</literal>)  Digite o seguinte comando na aplicação de
       <literal>Terminal</literal> (você precisará digitar
       a sua senha):
       <literal>sudo nano /private/etc/apache2/httpd.conf</literal>

install/pecl.xml

@@ -9,20 +9,21 @@
   <simpara>
    &link.pecl; é um repositório de extensões PHP disponibilizadas através do
    sistema de pacotes <link xlink:href="&url.php.pear;">PEAR</link>.
+   <!---->
    Esta seção do manual destina-se a demonstrar como obter e instalar extensões
    PECL.
   </simpara>
   <simpara>
-   Estas instruções assumem que
-   <literal>/caminho/para/o/diretorio/php/src/</literal>
-   seja o caminho para o código-fonte do PHP e que <literal>extname</literal>
+   Estas instruções assumem que <literal>/path/to/php/src/dir/</literal> seja o
+   caminho para o código-fonte do PHP e que <literal>extname</literal>
    seja o nome da extensão PECL. Ajuste adequadamente.
    Estas instruções também assumem uma familiaridade com o
    <link xlink:href="&url.php.pear.cli;">comando pear</link>.
    As informações no manual do PEAR para o comando
-   <literal>pear</literal>
+   <command>pear</command>
    também se aplicam ao comando
-   <literal>pecl</literal>.
+   <command>pecl</command>.
+   <!---->
   </simpara>
   <simpara>
    Uma extensão compartilhada deve ser compilada, instalada e carregada para ser

language/context/parameters.xml

@@ -10,9 +10,8 @@
  <refsect1 role="description">
   &reftitle.description;
   <para>
-   Estes <literal>parâmetros</literal> podem ser definidos em um 
-   <literal>contexto</literal> usando a função
-   <function>stream_context_set_params</function>.
+   Estes <literal>parameters</literal> podem ser definidos em um <literal>context</literal>
+   usando a função <function>stream_context_set_params</function>.
   </para>
  </refsect1>
 

language/control-structures/foreach.xml

@@ -124,26 +124,26 @@ foreach (array(1, 2, 3, 4) as &$valor) {
    <programlisting role="php">
 <![CDATA[
 <?php
-/* foreach example 1: value only */
+/* Exemplo foreach1: somente valores */
 
 $a = array(1, 2, 3, 17);
 
 foreach ($a as $v) {
     echo "Current value of \$a: $v.\n";
 }
 
-/* foreach example 2: value (with its manual access notation printed for illustration) */
+/* Exemplo foreach 2: valor com acesso manual (apenas ilustrativo) */
 
 $a = array(1, 2, 3, 17);
 
-$i = 0; /* for illustrative purposes only */
+$i = 0; /* apenas para ilustrar */
 
 foreach ($a as $v) {
     echo "\$a[$i] => $v.\n";
     $i++;
 }
 
-/* foreach example 3: key and value */
+/* Exemplo foreach 3: chave e valor */
 
 $a = array(
     "one" => 1,
@@ -156,7 +156,7 @@ foreach ($a as $k => $v) {
     echo "\$a[$k] => $v.\n";
 }
 
-/* foreach example 4: multi-dimensional arrays */
+/* Exemplo foreach 4: arrays multi dimencionais */
 $a = array();
 $a[0][0] = "a";
 $a[0][1] = "b";
@@ -169,7 +169,7 @@ foreach ($a as $v1) {
     }
 }
 
-/* foreach example 5: dynamic arrays */
+/* Exemplo foreach 5: arrays dinâmicos */
 
 foreach (array(1, 2, 3, 4, 5) as $v) {
     echo "$v\n";
@@ -235,7 +235,7 @@ $array = [
 ];
 
 foreach ($array as list($a)) {
-    // Note that there is no $b here.
+    // Veja que não existe $b aqui.
     echo "$a\n";
 }
 ?>

language/exceptions.xml

@@ -84,7 +84,7 @@
   </sect1>
 
  <sect1 phd:chunk="false" xml:id="language.exceptions.exception-handler">
-  <title><literal>Manipulador de exceções global</literal></title>
+  <title>Manipulador de exceções global</title>
   <para>
    Se uma exceção alcança o escopo global, ela ainda pode ser capturada
    por um manipulador global de exceções, opcional. A função <function>set_exception_handler</function>

language/variables.xml

@@ -22,7 +22,7 @@
    <note>
     <simpara>
      Para nosso propósito, as letras a-z, A-Z e os bytes
-     de 127 a 255 (<literal>0x7f-0xff</literal>).
+     de 127 a 255 (<literal>0x80-0xff</literal>).
     </simpara>
    </note>
 

reference/mysqli/mysqli/real-escape-string.xml

@@ -49,8 +49,9 @@
        A string a ser escapada.
       </para>
       <para>
-       Os caracteres codificados são <literal>NUL (ASCII 0), \n, \r, \, ', ", e
-       Control-Z</literal>.
+       Os caracteres codificados são <literal>NUL (ASCII 0)</literal>,
+       <literal>\n</literal>, <literal>\r</literal>, <literal>\</literal>,
+       <literal>'</literal>, <literal>"</literal> e <literal>Control-Z</literal>.
       </para>
      </listitem>
     </varlistentry>