[MANUAL] Brazilian Portuguese:

- sync to r20765, r20794, r20799, r20818


git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20828 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/pt-br/module_specs/Zend_Controller-Basics.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17136 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.controller.basics">
     <title>O Básico de Zend_Controller</title>
@@ -28,149 +28,149 @@
         estes componentes do sistema, ter um conhecimento básico do processo é útil.
     </para>
 
-        <itemizedlist>
-            <listitem>
-                <para>
-                    <classname>Zend_Controller_Front</classname> orquestra todo o processo do
-                    sistema <classname>Zend_Controller</classname>. Ele é o interpretador do
-                    padrão FrontController. <classname>Zend_Controller_Front</classname> processa
-                    todas as requisições recebidas pelo servidor e é o responsável direto pela
-                    delegação dos pedidos dos ActionControllers
-                    (<classname>Zend_Controller_Action</classname>).
-                </para>
-            </listitem>
-
-            <listitem>
-                <para>
-                    <classname>Zend_Controller_Request_Abstract</classname> (muitas vezes chamado
-                    de <emphasis>Request Object</emphasis>) representa o ambiente de pedido e
-                    fornece métodos para colocação e recuperação do controlador e nomes de ações
-                    e qualquer parâmetros passados. Adicionalmente ele guarda o registro de que a
-                    ação foi despachada ou não pelo
-                    <classname>Zend_Controller_Dispatcher</classname>. Extensões do objeto de
-                    requisição abstrata podem ser usadas para encapsular todo o ambiente de
-                    requisição, permitindo aos roteadores colocarem informações no ambiente de
-                    requisição para estabelecer o controlador e nomes de ação.
-                </para>
-
-                <para>
-                    Por padrão, <classname>Zend_Controller_Request_Http</classname> é usado, para
-                    fornecer acesso a todo o ambiente de pedido de <acronym>HTTP</acronym>.
-                </para>
-            </listitem>
-
-            <listitem>
-                <para>
-                    <classname>Zend_Controller_Router_Interface</classname> é usado para definir
-                    os roteadores. Roteamento é o processo de examinação da requisição do ambiente
-                    para determinar qual controlador e ação do controlador, devem receber a
-                    requisição. Este controlador, ação e parâmetros opcionais são incluídos no
-                    objeto de requisição para serem processados pelo
-                    <classname>Zend_Controller_Dispatcher_Standard</classname>. O roteamento
-                    ocorre somente uma vez: quando a requisição é inicialmente recebida e antes
-                    do primeiro controlador ser despachado.
-                </para>
-
-                <para>
-                    O roteador padrão, <classname>Zend_Controller_Router_Rewrite</classname>, pega
-                    uma <acronym>URI</acronym> no ponto especificado em
-                    <classname>Zend_Controller_Request_Http</classname> e a decompõe em um
-                    controlador, ação e parâmetros baseado na informação do caminho da
-                    <acronym>URL</acronym>. Por exemplo, a <acronym>URL</acronym>
-                    <filename>http://localhost/foo/bar/key/value</filename> pode ser decomposta
-                    para usar o controlador <emphasis>foo</emphasis>, a ação
-                    <emphasis>bar</emphasis>, e o parâmetro especificado <emphasis>key</emphasis>
-                    com o valor igual a <emphasis>value</emphasis>.
-                </para>
-
-                <para>
-                    <classname>Zend_Controller_Router_Rewrite</classname> também pode ser usado
-                    para combinar caminhos arbitrários; veja a <link
-                        linkend="zend.controller.router">documentação do roteador</link>
-                    para mais informações.
-                </para>
-            </listitem>
-
-            <listitem>
-                <para>
-                    <classname>Zend_Controller_Dispatcher_Interface</classname> é usado para
-                    definir despachantes. Despachar é o processo de pegar o controlador e a ação
-                    do objeto de requisição e mapeá-lo para um arquivo de um controlador (ou
-                    classe) e método de ação na classe do controlador. Se o controlador ou ação
-                    não existir, ele determina o controlador e ação padrão para despachar.
-                </para>
-
-                <para>
-                    O processo atual de despacho consiste em instanciar a classe do controlador e
-                    chamar o método de ação nesta classe. Diferente do roteamento, que ocorre
-                    somente uma vez, o despacho ocorre em um laço. Se o status do objeto de
-                    requisição despachado é reiniciado em algum ponto, o laço irá se repetir,
-                    chamando qualquer ação atualmente estabelecida no objeto de requisição. A
-                    primeira vez que o laço do objeto de requisição terminar com o status ativado
-                    (<type>Boolean</type> <constant>TRUE</constant>), ele irá finalizar
-                    o processo.
-                </para>
-
-                <para>
-                    O despachador padrão é o
-                    <classname>Zend_Controller_Dispatcher_Standard</classname>. Ele define os
-                    controladores como MixedCasedClasses terminados com a palavra Controller, e os
-                    métodos de ações como camelCasedMethods terminadas com a palavra Action:
-                    <methodname>FooController::barAction()</methodname>. Neste caso, o controlador
-                    será chamado como <emphasis>foo</emphasis> e a ação como
-                    <emphasis>bar</emphasis>.
-                </para>
+    <itemizedlist>
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Front</classname> orquestra todo o processo do
+                sistema <classname>Zend_Controller</classname>. Ele é o interpretador do
+                padrão FrontController. <classname>Zend_Controller_Front</classname> processa
+                todas as requisições recebidas pelo servidor e é o responsável direto pela
+                delegação dos pedidos dos ActionControllers
+                (<classname>Zend_Controller_Action</classname>).
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Request_Abstract</classname> (muitas vezes chamado
+                de <emphasis>Request Object</emphasis>) representa o ambiente de pedido e
+                fornece métodos para colocação e recuperação do controlador e nomes de ações
+                e qualquer parâmetros passados. Adicionalmente ele guarda o registro de que a
+                ação foi despachada ou não pelo
+                <classname>Zend_Controller_Dispatcher</classname>. Extensões do objeto de
+                requisição abstrata podem ser usadas para encapsular todo o ambiente de
+                requisição, permitindo aos roteadores colocarem informações no ambiente de
+                requisição para estabelecer o controlador e nomes de ação.
+            </para>
+
+            <para>
+                Por padrão, <classname>Zend_Controller_Request_Http</classname> é usado, para
+                fornecer acesso a todo o ambiente de pedido de <acronym>HTTP</acronym>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Router_Interface</classname> é usado para definir
+                os roteadores. Roteamento é o processo de examinação da requisição do ambiente
+                para determinar qual controlador e ação do controlador, devem receber a
+                requisição. Este controlador, ação e parâmetros opcionais são incluídos no
+                objeto de requisição para serem processados pelo
+                <classname>Zend_Controller_Dispatcher_Standard</classname>. O roteamento
+                ocorre somente uma vez: quando a requisição é inicialmente recebida e antes
+                do primeiro controlador ser despachado.
+            </para>
+
+            <para>
+                O roteador padrão, <classname>Zend_Controller_Router_Rewrite</classname>, pega
+                uma <acronym>URI</acronym> no ponto especificado em
+                <classname>Zend_Controller_Request_Http</classname> e a decompõe em um
+                controlador, ação e parâmetros baseado na informação do caminho da
+                <acronym>URL</acronym>. Por exemplo, a <acronym>URL</acronym>
+                <filename>http://localhost/foo/bar/key/value</filename> pode ser decomposta
+                para usar o controlador <emphasis>foo</emphasis>, a ação
+                <emphasis>bar</emphasis>, e o parâmetro especificado <emphasis>key</emphasis>
+                com o valor igual a <emphasis>value</emphasis>.
+            </para>
+
+            <para>
+                <classname>Zend_Controller_Router_Rewrite</classname> também pode ser usado
+                para combinar caminhos arbitrários; veja a <link
+                    linkend="zend.controller.router">documentação do roteador</link>
+                para mais informações.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Dispatcher_Interface</classname> é usado para
+                definir despachantes. Despachar é o processo de pegar o controlador e a ação
+                do objeto de requisição e mapeá-lo para um arquivo de um controlador (ou
+                classe) e método de ação na classe do controlador. Se o controlador ou ação
+                não existir, ele determina o controlador e ação padrão para despachar.
+            </para>
+
+            <para>
+                O processo atual de despacho consiste em instanciar a classe do controlador e
+                chamar o método de ação nesta classe. Diferente do roteamento, que ocorre
+                somente uma vez, o despacho ocorre em um laço. Se o status do objeto de
+                requisição despachado é reiniciado em algum ponto, o laço irá se repetir,
+                chamando qualquer ação atualmente estabelecida no objeto de requisição. A
+                primeira vez que o laço do objeto de requisição terminar com o status ativado
+                (<type>Boolean</type> <constant>TRUE</constant>), ele irá finalizar
+                o processo.
+            </para>
+
+            <para>
+                O despachador padrão é o
+                <classname>Zend_Controller_Dispatcher_Standard</classname>. Ele define os
+                controladores como MixedCasedClasses terminados com a palavra Controller, e os
+                métodos de ações como camelCasedMethods terminadas com a palavra Action:
+                <methodname>FooController::barAction()</methodname>. Neste caso, o controlador
+                será chamado como <emphasis>foo</emphasis> e a ação como
+                <emphasis>bar</emphasis>.
+            </para>
+
+            <note>
+                <title>Convenções de Nomenclatura para Maiúsculas e Minúsculas</title>
 
-                <note>
-                    <title>Convenções de Nomenclatura para Maiúsculas e Minúsculas</title>
-
-                    <para>
-                        Desde que os seres humanos são notoriamente incapazes de preservar
-                        maiúsculas e minúsculas ao digitar links, o Zend Framework atualmente
-                        normaliza as informações sobre o caminho para minúsculas. Isto,
-                        naturalmente, afetará a forma como você nomeia o seu controlador e suas
-                        ações... ou referir-se a eles em links.
-                    </para>
-
-                    <para>
-                        Se você deseja que o nome de seu controlador de classe ou do método de ação
-                        tenham múltiplas MixedCasedWords ou camelCasedWords, você precisará, para
-                        separar as palavras na url, um '-' ou '.' (embora você pode configurar o
-                        caractere utilizado).
-                    </para>
-
-                    <para>
-                        Por exemplo, se você estava indo para a ação em
-                        <methodname>FooBarController::bazBatAction()</methodname>, você irá se
-                        referir a ela em uma url como <filename>/foo-bar/baz-bat</filename> ou
-                        <filename>/foo.bar/baz.bat</filename>.
-                    </para>
-                </note>
-            </listitem>
-
-            <listitem>
                 <para>
-                    <classname>Zend_Controller_Action</classname> é o componente base do
-                    controlador de ação. Cada controlador é uma classe única que extende a classe
-                    <classname>Zend_Controller_Action</classname> e deve conter um ou
-                    mais métodos de ação.
+                    Desde que os seres humanos são notoriamente incapazes de preservar
+                    maiúsculas e minúsculas ao digitar links, o Zend Framework atualmente
+                    normaliza as informações sobre o caminho para minúsculas. Isto,
+                    naturalmente, afetará a forma como você nomeia o seu controlador e suas
+                    ações... ou referir-se a eles em links.
                 </para>
-            </listitem>
 
-            <listitem>
                 <para>
-                    <classname>Zend_Controller_Response_Abstract</classname> define a classe básica
-                    de resposta usada para coletar e retornar repostas dos controladores de ação.
-                    Ela coleta tanto cabeçalhos como conteúdos de corpo.
+                    Se você deseja que o nome de seu controlador de classe ou do método de ação
+                    tenham múltiplas MixedCasedWords ou camelCasedWords, você precisará, para
+                    separar as palavras na url, um '-' ou '.' (embora você pode configurar o
+                    caractere utilizado).
                 </para>
 
                 <para>
-                    A classe de resposta padrão é
-                    <classname>Zend_Controller_Response_Http</classname>, que é conveniente para
-                    uso em um ambiente <acronym>HTTP</acronym>.
+                    Por exemplo, se você estava indo para a ação em
+                    <methodname>FooBarController::bazBatAction()</methodname>, você irá se
+                    referir a ela em uma url como <filename>/foo-bar/baz-bat</filename> ou
+                    <filename>/foo.bar/baz.bat</filename>.
                 </para>
-            </listitem>
-        </itemizedlist>
+            </note>
+        </listitem>
+
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Action</classname> é o componente base do
+                controlador de ação. Cada controlador é uma classe única que extende a classe
+                <classname>Zend_Controller_Action</classname> e deve conter um ou
+                mais métodos de ação.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <classname>Zend_Controller_Response_Abstract</classname> define a classe básica
+                de resposta usada para coletar e retornar repostas dos controladores de ação.
+                Ela coleta tanto cabeçalhos como conteúdos de corpo.
+            </para>
+
+            <para>
+                A classe de resposta padrão é
+                <classname>Zend_Controller_Response_Http</classname>, que é conveniente para
+                uso em um ambiente <acronym>HTTP</acronym>.
+            </para>
+        </listitem>
+    </itemizedlist>
 
     <para>
         O processo do <classname>Zend_Controller</classname> é relativamente simples. Uma

documentation/manual/pt-br/module_specs/Zend_Controller-QuickStart.xml

@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16705 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.controller.quickstart">
     <title>Guia de Início Rápido do Zend_Controller</title>
 
     <sect2 id="zend.controller.quickstart.introduction">
         <title>Introdução</title>
+
         <para>
             <classname>Zend_Controller</classname> é o coração do sistema <acronym>MVC</acronym>
             do Zend Framework. <acronym>MVC</acronym> significa <ulink
@@ -17,6 +18,7 @@
             frontal e despachados individualmente para ações baseadas no
             <acronym>URL</acronym> requerido.
         </para>
+
         <para>
             O sistema <classname>Zend_Controller</classname> foi construído com a extensibilidade
             em mente, tanto por derivação das classes existentes, como escrevendo novas classes
@@ -57,7 +59,6 @@ html/
     .htaccess
     index.php
 ]]></programlisting>
-
         </sect3>
 
         <sect3 id="zend.controller.quickstart.go.docroot">
@@ -327,9 +328,11 @@ PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
                 <listitem>
                     <para><filename>http://example.com/</filename></para>
                 </listitem>
+
                 <listitem>
                     <para><filename>http://example.com/index</filename></para>
                 </listitem>
+
                 <listitem>
                     <para><filename>http://example.com/index/index</filename></para>
                 </listitem>

documentation/manual/pt-br/module_specs/Zend_Server.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20818 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.server.introduction">
     <title>Introdução</title>
+
     <para>
         A família de classes do <classname>Zend_Server</classname> fornece funcionalidades para as
         várias classes de servidores, incluindo <classname>Zend_XmlRpc_Server</classname>,
@@ -12,6 +13,7 @@
         <acronym>PHP</acronym> 5; todas as classes de servidores deverão implementar esta
         interface, a fim de fornecer uma <acronym>API</acronym> padrão de servidor.
     </para>
+
     <para>
         A árvore <classname>Zend_Server_Reflection</classname> fornece um mecanismo padrão para
         executar introspecção de função e classe para usar como chamadas de retorno com as

documentation/manual/pt-br/module_specs/Zend_Server_Reflection.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20818 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.server.reflection">
     <title>Zend_Server_Reflection</title>
@@ -15,11 +15,13 @@
             dos protótipos de funções e métodos (ex.: todas as possíveis combinações de chamada
             válidas), e as descrições de funções e métodos.
         </para>
+
         <para>
             Normalmente, esta funcionalidade só será usada por desenvolvedores de classes de
             servidor para o framework.
         </para>
     </sect2>
+
     <sect2 id="zend.server.reflection.usage">
         <title>Utilização</title>
 

documentation/manual/pt-br/module_specs/Zend_Service.xml

@@ -1,17 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20818 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.introduction">
     <title>Introdução</title>
+
     <para>
         <classname>Zend_Service</classname> é uma classe abstrata que serve como base para
         implementações para web service, como <acronym>SOAP</acronym> ou REST.
     </para>
+
     <para>
         Se você precisar de suporte básico para serviços REST baseados em <acronym>XML</acronym>,
         você pode olhar em <link
             linkend="zend.rest.client"><classname>Zend_Rest_Client</classname></link>.
     </para>
+
     <para>
         Além de ser capaz de estender o <classname>Zend_Service</classname> e usar o
         <classname>Zend_Rest_Client</classname> para web services baseados em REST, Zend
@@ -21,56 +24,45 @@
 
     <itemizedlist>
         <listitem>
-            <para>
-                <link linkend="zend.service.akismet">Akismet</link>
-            </para>
+            <para><link linkend="zend.service.akismet">Akismet</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.amazon">Amazon</link>
-            </para>
+            <para><link linkend="zend.service.amazon">Amazon</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.audioscrobbler">Audioscrobbler</link>
-            </para>
+            <para><link linkend="zend.service.audioscrobbler">Audioscrobbler</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.delicious">Del.icio.us</link>
-            </para>
+            <para><link linkend="zend.service.delicious">Del.icio.us</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.flickr">Flickr</link>
-            </para>
+            <para><link linkend="zend.service.flickr">Flickr</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.simpy">Simpy</link>
-            </para>
+            <para><link linkend="zend.service.simpy">Simpy</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.slideshare">SlideShare</link>
-            </para>
+            <para><link linkend="zend.service.slideshare">SlideShare</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.strikeiron">StrikeIron</link>
-            </para>
+            <para><link linkend="zend.service.strikeiron">StrikeIron</link></para>
         </listitem>
+
         <listitem>
-            <para>
-                <link linkend="zend.service.yahoo">Yahoo!</link>
-            </para>
+            <para><link linkend="zend.service.yahoo">Yahoo!</link></para>
         </listitem>
     </itemizedlist>
 
     <para>
         Mais serviços serão adicionados no futuro.
     </para>
-
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/pt-br/module_specs/Zend_Version.xml

@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19432 -->
+<!-- EN-Revision: 20794 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.version.reading">
-
     <title>Obtendo a Versão do Zend Framework</title>
 
     <para>
@@ -23,12 +22,12 @@
 
     <example id="zend.version.reading.example">
         <title>Exemplo do método compareVersion()</title>
+
         <programlisting language="php"><![CDATA[
 // retorna -1, 0 ou 1
 $cmp = Zend_Version::compareVersion('2.0.0');
 ]]></programlisting>
     </example>
-
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/pt-br/module_specs/Zend_Wildfire.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20764 -->
+<!-- EN-Revision: 20799 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.wildfire.chapter">
     <title>Zend_Wildfire</title>
@@ -32,9 +32,9 @@
     </para>
 
     <para>
-        Há também um componente <link linkend="zend.db.profiler.profilers.firebug">
-        <classname>Zend_Db_Profiler_Firebug</classname></link> para registrar informações de
-        profiling do banco de dados no Firebug.
+        Há também um componente <link
+            linkend="zend.db.profiler.profilers.firebug"><classname>Zend_Db_Profiler_Firebug</classname></link>
+        para registrar informações de profiling do banco de dados no Firebug.
     </para>
 </sect1>
 <!--