[DOCUMENTATION] Brazilian Portuguese:

- added some translantions (by jaguarnet7)


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

documentation/manual/pt-br/module_specs/Zend_Tool-Extending.xml

@@ -153,51 +153,49 @@
             </para>
 
             <sect4 id="zend.tool.extending.zend-tool-framework.cli-client.setup-general">
-                <title>Setting up the CLI tool</title>
+                <title>Configuração da ferramenta CLI</title>
 
                 <para>
-                    To issue tooling requests via the command line client, you first
-                    need to set up the client so that your system can handle the "zf"
-                    command. The command line client, for all intents and purposes, is
-                    the <filename>.sh</filename> or <filename>.bat</filename> file that is provided
-                    with your Zend Framework distribution. In trunk, it can be found here:
-                    <ulink
+                    Para distribuir pedidos via cliente de linha de comando, primeiro você
+                    precisa configurar o cliente para que seu sistema possa manipular os
+                    comandos "zf". O cliente de linha de comando, para todos as intenções e
+                    propósitos, é o arquivo <filename>.sh</filename> ou <filename>.bat</filename>
+                    que é provido com a sua distribuição do Zend Framework. No trunk, ele pode ser
+                    encontrado aqui:
+                    <ulink 
                         url="http://framework.zend.com/svn/framework/standard/trunk/bin/">http://framework.zend.com/svn/framework/standard/trunk/bin/</ulink>.
                 </para>
 
                 <para>
-                    As you can see, there are 3 files in the <filename>/bin/</filename>
-                    directory: a <filename>zf.php</filename>, <filename>zf.sh</filename>, and
-                    <filename>zf.bat</filename>. The <filename>zf.sh</filename> and the
-                    <filename>zf.bat</filename> are the operating system specific client
-                    wrappers: <filename>zf.sh</filename> for the *nix environment, and
-                    <filename>zf.bat</filename> for the Win32 environment. These client wrappers are
-                    responsible for finding the proper <filename>php.exe</filename>, finding the
-                    <filename>zf.php</filename>, and passing on the client request. The
-                    <filename>zf.php</filename> is the responsible for handling understanding
-                    your environment, constructing the proper include_path, and passing
-                    what is provided on the command line to the proper library component
-                    for dispatching.
+                    Como você pode ver, existem 3 arquivos no diretório <filename>/bin/</filename>:
+                    <filename>zf.php</filename>, <filename>zf.sh</filename>, e
+                    <filename>zf.bat</filename>. O <filename>zf.sh</filename> e o <filename>zf.bat</filename>
+                    são os pacotes específicos do sistema operacional: <filename>zf.sh</filename> para ambientes
+                    *nix, e <filename>zf.bat</filename> para ambientes Win32. Estes empacotadores clientes são
+                    responsáveis por procurar o php.exe correto, achando o <filename>zf.php</filename>, e
+                    passando o pedido para o cliente. O <filename>zf.php</filename>, é responsável por
+                    manipular a identificação do seu ambiente, construindo um include_path adequado, e passar o
+                    que é fornecido na linha de comando para o componente de biblioteca adequado
+                    para a expedição.
                 </para>
 
                 <para>
-                    Ultimately, you want to ensure two things to make everything work
-                    regardless of the operating system you are on:
+                    Finalmente, você quer garantir duas coisas para fazer tudo funcionar 
+                    independentemente do sistema operacional em que você está:
                 </para>
 
                 <orderedlist>
                     <listitem>
                         <para>
-                            <filename>zf.sh/zf.bat</filename> is reachable from your system
-                            path. This is the ability to call <command>zf</command> from
-                            anywhere on your command line, regardless of what your
-                            current working directory is.
+                            <filename>zf.sh/zf.bat</filename> acessível a partir do path do sistema. 
+                            Esta é a capacidade de chamar <command>zf</command> de qualquer lugar na sua linha de comando, 
+                            independentemente de qual é o seu diretório de trabalho atual.
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <filename>ZendFramework/library</filename> is in your
+                            <filename>ZendFramework/library</filename> estar no seu
                             <property>include_path</property>.
                         </para>
                     </listitem>
@@ -205,21 +203,20 @@
 
                 <note>
                     <para>
-                        Note: while the above are the most ideal
-                        requirements, you can simply download Zend Framework and expect it
-                        to work as <filename>./path/to/zf.php</filename> some command.
+                        Nota: enquanto os acima são os requisitos ideais, você pode simplesmente 
+                        baixar o Zend Framework e esperar que ele funcione como <filename>./path/to/zf.php</filename>
+                        algum comando..
                     </para>
                 </note>
             </sect4>
 
             <sect4 id="zend.tool.extending.zend-tool-framework.cli-client.setup-starnix">
-                <title>Setting up the CLI tool on Unix-like Systems</title>
+                <title>Configurando a ferramenta CLI em Sistemas Unix-like</title>
 
                 <para>
-                    The most common setup in the *nix environment, is to copy the
-                    <filename>zf.sh</filename> and <filename>zf.php</filename> into the same
-                    directory as your <acronym>PHP</acronym> binary. This can generally be found in
-                    one of the following places:
+                    A configuração mais comum no ambiente *nix, é copiar o <filename>zf.sh</filename> e
+                    o <filename>zf.php</filename> no mesmo diretório que o seu binário <acronym>PHP</acronym>.
+                    Isto pode geralmente ser achado nos seguintes lugares:                   
                 </para>
 
                 <programlisting language="text"><![CDATA[
@@ -230,31 +227,29 @@
 ]]></programlisting>
 
                 <para>
-                    To find out the location of your <acronym>PHP</acronym> binary, you can execute
-                    'which php' on the command line. This will return the location of the
-                    <acronym>PHP</acronym> binary you will be using to run <acronym>PHP</acronym>
-                    scripts in this environment.
+                    Para achar a localização do seu binário <acronym>PHP</acronym>, você pode executar
+                    'which php' na linha de comando. Isto retornará a localização do binário do <acronym>PHP</acronym>
+                    que você está usando para rodar scripts <acronym>PHP</acronym> no seu ambiente.          
                 </para>
 
                 <para>
-                    The next order of business is to ensure that Zend Framework
-                    library is set up correctly inside of the system <acronym>PHP</acronym>
-                    <property>include_path</property>. To find out where your
-                    <property>include_path</property> is located, you can execute
-                    <command>php -i</command> and look for the <property>include_path</property>
-                    variable, or more succinctly, execute
-                    <command>php -i | grep include_path</command>. Once you have found where
-                    your <property>include_path</property> is located (this will generally be
-                    something like <filename>/usr/lib/php</filename>,
-                    <filename>/usr/share/php</filename>, <filename>/usr/local/lib/php</filename>, or
-                    similar), ensure that the contents of the <filename>/library/</filename>
-                    directory are put inside your <property>include_path</property> specified
-                    directory.
+                    O próximo passo é certificar que a biblioteca Zend Framework está configurada
+                    corretamente dentro do sistema de <property>include_path</property> do 
+                    <acronym>PHP</acronym>. Para achar onde seu <property>include_path</property>
+                    está localizado, você pode executar <command>php -i</command> e olhar para
+                    a variável <property>include_path</property>, o mais sucintamente, executar
+                    <command>php -i | grep include_path</command>. Uma vez que você tenha achado
+                    onde seu <property>include_path</property> está localizado (isto irá geralmente
+                    estar em algum lugar como <filename>/usr/lib/php</filename>,
+                    <filename>/usr/share/php</filename>, <filename>/usr/local/lib/php</filename>, ou
+                    similar), certifique que o conteúdos do diretório <filename>/library/</filename>
+                    estão colocados dentro do seu diretório <property>include_path</property>
+                    especificado.
                 </para>
 
                 <para>
-                    Once you have done those two things, you should be able to issue a
-                    command and get back the proper response like this:
+                    Uma vez que você tenha terminado estas duas coisas, você deve ser capaz de digitar
+                    um comando e obter devolta a resposta adequada como:
                 </para>
 
                 <para>
@@ -263,54 +258,52 @@
                 </para>
 
                 <para>
-                    If you do not see this type of output, go back and check your setup
-                    to ensure you have all of the necessary pieces in the proper place.
+                    Se vocÊ não ver isto digitado na saída, volte e verifique sua configuração
+                    para ter certeza que tem todas as partes necessárias in devido lugar.
                 </para>
 
                 <para>
-                    There are a couple of alternative setups you might want to employ
-                    depending on your servers configuration, your level of access, or
-                    for other reasons.
+                    Existem uma combinação de configurações alternativas que você pode querer empregar
+                    dependendo das configurações dos servidores, seu nível de acesso, ou
+                    por outras razões.
                 </para>
 
                 <para>
-                    <emphasis>Alternative Setup</emphasis> involves keeping the Zend
-                    Framework download together as is, and creating a link from a
-                    <constant>PATH</constant> location to the <filename>zf.sh</filename>. What this
-                    means is you can place the contents of the ZendFramework download into a
-                    location such as <filename>/usr/local/share/ZendFramework</filename>, or more
-                    locally like <filename>/home/username/lib/ZendFramework</filename>, and creating
-                    a symbolic link to the <filename>zf.sh</filename>.
+                   <emphasis>Configuração Alternativa</emphasis> envolve guardar o download do
+                   Zend Framework junto como está, e criar um link de um local <constant>PATH</constant>
+                   para o <filename>zf.sh</filename>. O que isto significa é que você coloca o conteúdo
+                   do download do Zend Framework em uma localização tal como <filename>/usr/local/share/ZendFramework</filename>,
+                   ou mais localmente como <filename>/home/username/lib/ZendFramework</filename>, e cria
+                   um link simbólico para o <filename>zf.sh</filename>.
                 </para>
 
                 <para>
-                    Assuming you want to put the link inside <filename>/usr/local/bin</filename>
-                    (this could also work for placing the link inside
-                    <filename>/home/username/bin/</filename> for example) you would issue a
-                    command similar to this:
+                    Assumindo que você quer colocar o link dentro de <filename>/usr/local/bin</filename>
+                    (isto pode também funcionar colocando o link dentro de <filename>/home/username/bin/</filename>
+                    por exemplo) você poderia dgitar um comando similar a este:
                 </para>
 
                 <programlisting language="sh"><![CDATA[
 ln -s /usr/local/share/ZendFramework/bin/zf.sh /usr/local/bin/zf
 
-# OR (for example)
+# OU (por exemplo)
 ln -s /home/username/lib/ZendFramework/bin/zf.sh /home/username/bin/zf
 ]]></programlisting>
 
                 <para>
-                    This will create a link which you should be able to access globally
-                    on the command line.
+                    Isto irá criar um link que você poderá ser capaz de acessar globalmente
+                    na linha de comando.
                 </para>
             </sect4>
 
             <sect4 id="zend.tool.extending.zend-tool-framework.cli-client.setup-windows">
-                <title>Setting up the CLI tool on Windows</title>
+                <title>Configurando a ferramenta CLI no Windows</title>
 
                 <para>
-                    The most common setup in the Windows Win32 environment, is to copy
-                    the <filename>zf.bat</filename> and <filename>zf.php</filename> into the same
-                    directory as your <acronym>PHP</acronym> binary. This can generally be found in
-                    one of the following places:
+                    A confuguração mais comum no ambiente Win32, é copiar o 
+                    <filename>zf.bat</filename> e o <filename>zf.php</filename> para dentr do mesmo
+                    diretório do seu binário <acronym>PHP</acronym>. Este pode geralmente ser achado
+                    nos seguintes lugares:
                 </para>
 
                 <programlisting language="text"><![CDATA[
@@ -320,33 +313,30 @@ C:\WAMP\PHP\bin
 ]]></programlisting>
 
                 <para>
-                    You should be able to run <filename>php.exe</filename> on the command line.
-                    If you are not able to, first check the documentation that came with
-                    your <acronym>PHP</acronym> distribution, or ensure that the path to
-                    <filename>php.exe</filename> is in your
-                    Windows <constant>PATH</constant> environment variable.
+                    Você deve ser capaz de rodar <filename>php.exe</filename> na linha de comando.
+                    Se você não for capaz, primeiro verifique a documentação que veio com sua
+                    distribuição <acronym>PHP</acronym>, ou tenha certeza que o caminho para o
+                    <filename>php.exe</filename> está na sua variável de ambiente
+                    <constant>PATH</constant> do Windows.
                 </para>
 
                 <para>
-                    The next order of business is to ensure that Zend Framework
-                    library is set up correctly inside of the system <acronym>PHP</acronym>
-                    <property>include_path</property>. To find out where your
-                    <property>include_path</property> is located, you can type
-                    <command>php -i</command> and look for the <property>include_path</property>
-                    variable, or more succinctly execute
-                    <command>php -i | grep include_path</command> if you have Cygwin setup with
-                    grep available. Once you have found where your
-                    <property>include_path</property> is located (this will generally be
-                    something like <filename>C:\PHP\pear</filename>,
-                    <filename>C:\PHP\share</filename>,
-                    <filename>C:\Program%20Files\ZendServer\share</filename> or similar), ensure
-                    that the contents of the library/ directory are put inside your
-                    <property>include_path</property> specified directory.
+                    O próximo passo é ter certeza que a biblioteca do Zend Framework
+                    está configurada corretamente dentro do sistema de <property>include_path</property>
+                    do <acronym>PHP</acronym>. Para achar onde seu <property>include_path</property>
+                    está localizado, você pode digitar <command>php -i</command> e olhar para a
+                    variável <property>include_path</property>, ou mais sucintamente executar 
+                    <command>php -i | grep include_path</command> se você tem um Cygwin configurado
+                    com grep disponível. Uma vez você tenha achado onde seu <property>include_path</property>
+                    está localizado(isto irá geralmente ser algo como <filename>C:\PHP\pear</filename>,
+                    <filename>C:\PHP\share</filename>,<filename>C:\Program%20Files\ZendServer\share</filename>
+                    ou similar), verifique que os conteúdos do diretório library/ estão postos dentro
+                    do seu diretório <property>include_path</property>especificado.
                 </para>
 
                 <para>
-                    Once you have done those two things, you should be able to issue a
-                    command and get back the proper response like this:
+                    Uma vez tenha terminado aquilas duas coisas, você deve ser capaz de enviar um 
+                    comando e receber o devida resposta como:
                 </para>
 
                 <para>
@@ -355,31 +345,30 @@ C:\WAMP\PHP\bin
                 </para>
 
                 <para>
-                    If you do not see this type of output, go back and check your setup
-                    to ensure you have all of the necessary pieces in the proper place.
+                    Se você não ver isto digitado na saída, volte e verifique sua configuração
+                    para ter certeza que você tem todas as partes necessárias no lugar correto.
                 </para>
 
                 <para>
-                    There are a couple of alternative setups you might want to employ
-                    depending on your server's configuration, your level of access, or
-                    for other reasons.
+                    Existe uma combinação de configurações alternativas que você pode querer empregar
+                    dependendo das configurações do seu servidor, do seu nível de acesso, ou de
+                    outras razões.
                 </para>
 
                 <para>
-                    <emphasis>Alternative Setup</emphasis> involves keeping the Zend
-                    Framework download together as is, and altering both your system
-                    <constant>PATH</constant> as well as the <filename>php.ini</filename> file.
-                    In your user's environment, make sure to add
-                    <filename>C:\Path\To\ZendFramework\bin</filename>, so that your
-                    <filename>zf.bat</filename> file is executable. Also, alter the
-                    <filename>php.ini</filename> file to ensure that
-                    <filename>C:\Path\To\ZendFramework\library</filename> is in your
+                    <emphasis>Configuração Alternativa</emphasis> envolve guardar o download do
+                    Zend Framework junto como está, e alterar ambos seu sistema de <constant>PATH</constant>
+                    bem como o arquivo <filename>php.ini</filename>. No seu ambiente de usuário,
+                    tenha certeza de adcionar <filename>C:\Path\To\ZendFramework\bin</filename>,
+                    então seu arquivo <filename>zf.bat</filename> será executável. Também, altere 
+                    o arquivo <filename>php.ini</filename> certificando que 
+                    <filename>C:\Path\To\ZendFramework\library</filename> está no seu
                     <property>include_path</property>.
                 </para>
             </sect4>
 
             <sect4 id="zend.tool.extending.zend-tool-framework.cli-client.setup-othernotes">
-                <title>Other Setup Considerations</title>
+                <title>Outras Considerações de Configuração</title>
 
                 <para>
                     If for some reason you do not want Zend Framework library inside