[DOCUMENTATION] Brazilian Portuguese:

- added some translations (thanks to jaguarnet7)


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

documentation/manual/pt-br/module_specs/Zend_Tool-Usage-CLI.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 22745 -->
+<!-- EN-Revision: 24333 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.tool.usage.cli">
     <title>Usando Zend_Tool na Linha de Comando</title>
@@ -53,9 +53,8 @@ pear install zfcampus/zf
 ]]></programlisting>
 
             <para>
-                That is it. After the initial install, you should be able to continue on by
-                running the zf command. Go good way to check to see if it't there is to run
-                zf --help
+                É isto. Depois de instalação inicial, você deve ser capaz de continuar executando
+                o comando zf. Uma boa maneira para ver se está tudo certo é executar o zf --help
             </para>
         </sect3>
 
@@ -88,14 +87,14 @@ pear install zfcampus/zf
     </sect2>
 
     <sect2 id="zend.tool.usage.cli.general-purpose-commands">
-        <title>General Purpose Commands</title>
+        <title>Comandos de Propósito General</title>
 
         <sect3 id="zend.tool.usage.cli.general-purpose-commands.version">
             <title>Version</title>
 
             <para>
-                This will show the current version number of the copy of Zend Framework the zf.php
-                tool is using.
+                Isto mostrará o número da versão corrente da cópia do Zend Framework que a ferramenta
+                zf.php está usando.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -104,14 +103,14 @@ zf show version
         </sect3>
 
         <sect3 id="zend.tool.usage.cli.general-purpose-commands.built-in-help">
-            <title>Built-in Help</title>
+            <title>Help Embutido</title>
 
             <para>
-                The built-in help system is the primary place where you can get up-to-date
-                information on what your system is capable of doing. The help system is dynamic in
-                that as providers are added to your system, they are automatically dispatchable, and
-                as such, the parameters required to run them will be in the help screen. The
-                easiest way to retrieve the help screen is the following:
+                O sistema de help embutido é o primeiro lugar onde você pode obter informações atualizadas
+                sobre o que o seu sistema é capaz de fazer. O sistema de help é dinâmico pois como
+                os providers são adicionados ao seus sistema, eles são automaticamente executáveis, 
+                bem como, os parametros necessários para executar-los estarão na tela de ajuda. O caminho
+                mais fácil de obter a tela de ajuda é o seguinte:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -119,12 +118,12 @@ zf --help
 ]]></programlisting>
 
             <para>
-                This will give you an overview of the various capabilities of the system.
-                Sometimes, there are more finite commands than can be run, and to gain more
-                information about these, you might have to run a more specialized help command.
-                For specialized help, simply replace any of the elements of the command with a "?".
-                This will tell the help system that you want more information about what commands
-                can go in place of the question mark. For example:
+                Isto dará a você uma visão geral de várias capacidades do sistema.
+                Algumas vezes, existem mais comandos expecíficos que podem ser executados, e para ter
+                mas informações sobre eles, você pode ter que rodar mais um comando de help especializado.
+                Para um help especializado, simplesmente substitua qualquer um dos elementos do comando
+                por uma "?". Isto dirá ao sistema de help que você quer mais informações sobre que
+                comandos podem ir no lugar da interrogação. Por exemplo:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -132,8 +131,8 @@ zf ? controller
 ]]></programlisting>
 
             <para>
-                The above means "show me all 'actions' for the provider 'controller'"; while the
-                following:
+                O acima exposto significa "mostre-me todos os 'actions' do provider 'controller'"; 
+                enquanto o seguinte:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -141,13 +140,13 @@ zf show ?
 ]]></programlisting>
 
             <para>
-                means "show me all providers that support the 'show' action". This works for
-                drilling down into options as well as you can see in the following examples:
+                significa "mostre-me todos os providers que suportam a action 'show'". Isso funciona 
+                para as opções do exemplo a baixo, bem como você pode ver nos exemplos a seguir:
             </para>
 
             <programlisting language="text"><![CDATA[
-zf show version.? (show any specialties)
-zf show version ? (show any options)
+zf show version.? (mostra todas as especialidades)
+zf show version ? (mostra todas as opções)
 ]]></programlisting>
         </sect3>
 
@@ -155,8 +154,8 @@ zf show version ? (show any options)
             <title>Manifest</title>
 
             <para>
-                This will show what information is in the tooling systems manifest. This is more
-                important for provider developers than casual users of the tooling system.
+                Isto irá mostrar o que existe no manifest das ferramentas do sistema. Isso é mais importante
+				para os desenvolvedores de provider do que para usuários casuais das ferramentas do sistema.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -175,15 +174,15 @@ zf show manifest
     </sect2>
 
     <sect2 id="zend.tool.usage.cli.project-specific-commands">
-        <title>Project Specific Commands</title>
+        <title>Comandos Específicos do Projeto</title>
 
         <sect3 id="zend.tool.usage.cli.project-specific-commands.project">
             <title>Project</title>
 
             <para>
-                The project provider is the first command you might want to run. This will setup the
-                basic structure of your application. This is required before any of the other
-                providers can be executed.
+                O provider project é o primeiro comando que você deve querer rodar. Ele irá configurar a 
+				estrutura básica da sua aplicação. Isto é necessário antes de qualquer dos outros
+				providers pode serem executado.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -191,22 +190,22 @@ zf create project MyProjectName
 ]]></programlisting>
 
             <para>
-                This will create a project in a directory called ./MyProjectName. From this point
-                on, it is important to note that any subsequent commands on the command line must be
-                issued from within the project directory you had just created. So, after creation,
-                changing into that directory is required.
+				Isso irá criar um projeto em um diretório chamado ./MyProjectName. A partir deste ponto,
+				é importante notar que qualquer dos comandos subseqüentes na linha de comando deve ser 
+				executado de dentro do diretório do projeto que você acabou de criar. Assim, após a criação,
+				a mudança de diretório é necessária.
             </para>
         </sect3>
 
         <sect3 id="zend.tool.usage.cli.project-specific-commands.module">
-            <title>Project</title>
+            <title>Module</title>
 
             <para>
-                The module provider allows for the easy creation of a Zend Framework module. A
-                module follows the hMVC pattern loosely. When creating modules, it will take the
-                same structure used at the application/ level, and duplicate it inside of the chosen
-                name for your module, inside of the "modules" directory of the application/
-                directory without duplicating the modules directory itself. For example:
+                O provider module permite a fácil criação de um modulo Zend Framework. Um
+				um módulo segue ligeiramente o padrão hMVC. Ao criar módulos, levamos a mesma
+				estrutura usada no nível application/, e duplicamos dentro do nome escolhido
+				para o seu módulo, dentro do diretório "modules" do diretório application/
+				sem duplicar o diretório de modules em si. Por exemplo:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -214,8 +213,8 @@ zf create module Blog
 ]]></programlisting>
 
             <para>
-                This will create a module named Blog at application/modules/Blog, and all of the
-                artifacts that a module will need.
+                Isto irá criar um módulo chamado Blog em application/modules/Blog, e todos os artefatos
+				que o módulo irá precisar.
             </para>
         </sect3>
 
@@ -223,9 +222,9 @@ zf create module Blog
             <title>Controller</title>
 
             <para>
-                The controller provider is responsible for creating (mostly) empty controllers as
-                well as their corresponding view script directories and files. To utilize it to
-                create an 'Auth' controlller, for example, execute:
+                O privider controller é responsável por criar (principalmente) controllers vazios bem
+                como seus correspondentes diretórios dos script de view e os arquivos. Para utiliza-lo
+                crie um 'Auth' controlller, por exemplo, execute:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -233,9 +232,9 @@ zf create controller Auth
 ]]></programlisting>
 
             <para>
-                This will create a controller named Auth, specifically it will create a file at
-                application/controllers/AuthController.php with the AuthController inside.
-                If you wish to create a controller for a module, use any of the following:
+                Isto irá criar um controller chamado Auth, expecificamente criará um arquivo em
+                application/controllers/AuthController.php com AuthController dentro.
+                Se você quiser criar um controller para um módulo, use qualquer dos seguintes comandos:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -245,7 +244,7 @@ zf create controller Post --module=Blog
 ]]></programlisting>
 
             <para>
-                Note: In the first command, 1 is the value for the "includeIndexAction" flag.
+                Note: No primeiro comando, 1 é o valor para a flag "includeIndexAction".
             </para>
         </sect3>
 
@@ -253,7 +252,7 @@ zf create controller Post --module=Blog
             <title>Action</title>
 
             <para>
-                To create an action within an existing controller:
+                Para criar uma action dentro de um controller existente:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -267,8 +266,8 @@ zf create action login --controller-name=Auth
             <title>View</title>
 
             <para>
-                To create a view outside of the normal controller/action creation, you would use
-                one of the following:
+                Para criar uma view fora do controller/action corrente, você poderia
+                usar um dos seguintess comandos:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -277,7 +276,7 @@ zf create view -c Auth -a my-script-name
             ]]></programlisting>
 
             <para>
-                This will create a view script in the controller folder of Auth.
+                Isto irá criar um script de view na pasta do controller Auth.
             </para>
         </sect3>
 
@@ -285,8 +284,8 @@ zf create view -c Auth -a my-script-name
             <title>Model</title>
 
             <para>
-                The model provider is only responsible for creating the proper model files,
-                with the proper name inside the application folder. For example
+                O provider model é apenas responsável por criar os arquivos de modelo de forma adequada,
+                com o próprio nome dentro da pasta application. Por exemplo
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -294,7 +293,7 @@ zf create model User
 ]]></programlisting>
 
             <para>
-                If you wish to create a model within a specific module:
+                Se você deseja criar um model dentro de um módulo específico:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -302,7 +301,7 @@ zf create model Post -m Blog
 ]]></programlisting>
 
             <para>
-                The above will create a 'Post' model inside of the 'Blog' module.
+                O comando a cima cria um model 'Post' dentro do módulo 'Blog'.
             </para>
         </sect3>
 
@@ -310,8 +309,8 @@ zf create model Post -m Blog
             <title>Form</title>
 
             <para>
-                The form provider is only responsible for creating the proper form file and
-                init() method, with the proper name inside the application folder. For example:
+                O provider form é apenas responsável por criar o arquivo e o 
+				método init() de forma adequada, com o nome adequado dentro da pasta application. Por exemplo:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -319,7 +318,7 @@ zf create form Auth
 ]]></programlisting>
 
             <para>
-                If you wish to create a model within a specific module:
+                Se você deseja criar um model dentro de um módulo expecífico:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -327,7 +326,7 @@ zf create form Comment -m Blog
 ]]></programlisting>
 
             <para>
-                The above will create a 'Comment' form inside of the 'Blog' module.
+                O comando acima criará o form 'Comment' dentro do módulo 'Blog'.
             </para>
         </sect3>
 
@@ -335,12 +334,12 @@ zf create form Comment -m Blog
             <title>DbAdapter</title>
 
             <para>
-                To configure a DbAdapter, you will need to provide the information as a url
-                encoded string. This string needs to be in quotes on the command line.
+                Parar configurar um DbAdapter, você precisará fornecer informações como uma
+                string de url codificada. As strings precisam estar com aspas na linha de comando.
             </para>
 
             <para>
-                For example, to enter the following information:
+                Por exemplo, para digitar as seguintes informações:
 
                 <itemizedlist>
                     <listitem>
@@ -360,7 +359,7 @@ zf create form Comment -m Blog
                     </listitem>
                 </itemizedlist>
 
-                The following will have to be run on the command line:
+                O seguinte comando terá que ser rodado na linha de comando:
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -368,10 +367,10 @@ zf configure dbadapter "adapter=Pdo_Mysql&username=test&password=test&dbname=tes
 ]]></programlisting>
 
             <para>
-                This assumes you wish to store this information inside of the
-                'production' space of the application configuration file. The following will
-                demonstrate an sqlite configuration, in the 'development' section of the
-                application config file.
+                Isto assume que você deseja armazenar estas informações no 
+                espaço de 'production' do arquivo de configuração da aplicação. O comando seguinte
+                irá demonstrar uma configuração para sqlite, na sessão 'development' do arquivo de
+				configuração da aplicação.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -384,25 +383,25 @@ zf configure dbadapter "adapter=Pdo_Sqlite&dbname=../data/test.db" -s developmen
             <title>DbTable</title>
 
             <para>
-                The DbTable provider is responsible for creating
-                <classname>Zend_Db_Table</classname> model/data access files for your application to
-                consume, with the proper class name, and in the proper location in the application.
-                The two important pieces of information are the <emphasis>DbTable name</emphasis>,
-                and the <emphasis>actual database table name</emphasis>. For example:
+                O provider DbTable é responsável por criar arquivos de modelo
+                <classname>Zend_Db_Table</classname>/dados de acesso para a sua aplicação consumir,
+				com o nome da classe adequada e em local apropriado na aplicação.
+				As duas importantes peças de informação são o <emphasis>nome da DbTable</emphasis>,
+				e o <emphasis>nome da tabela atual banco de dados</emphasis>. Por exemplo:
             </para>
 
             <programlisting language="text"><![CDATA[
 zf create dbtable User user
 zf create dbtable User -a user
 
-// also accepts a force option to overwrite existing files
+// também aceita a opção force para sobreescrever arquivos existentes
 zf create dbtable User user -f
-zf create dbtable User user --force-override
+zf create dbtable User user --force-overwrite
 ]]></programlisting>
 
             <para>
-                The DbTable provider is also capable of creating the proper files by
-                scanning the database configured with the above DbAdapter provider.
+                O provider DbTable é também capaz de criar os arquivos apropriadamente
+                mapeando o banco de dados configurado com o provider DbAdapter abaixo.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -410,9 +409,9 @@ zf create dbtable.from-database
 ]]></programlisting>
 
             <para>
-                When executing the above, it might make sense to use the pretend / "-p"
-                flag first so that you can see what would be done, and what tables can
-                be found in the database.
+                Ao executar o acima exposto, pode ser fazer sentido usar primeiro a flag de simulação
+				"-p" para que você possa ver o que seria feito, e que tablelas podem
+                ser encontradas no banco da dados.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -424,9 +423,9 @@ zf -p create dbtable.from-database
             <title>Layout</title>
 
             <para>
-                Currently, the only supported action for layouts is simply to enable them
-                will setup the proper keys in the application.ini file for the application
-                resource to work, and create the proper directories and layout.phtml file.
+                Atualmente, a única ação suportada para layout é simplesmente permitir-lhes,
+				então configurar apropriadamente o arquivo application.ini para o aplicativo trabalhar,
+				e criar os diretórios e arquivos layout.phtml.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -436,15 +435,15 @@ zf enable layout
     </sect2>
 
     <sect2 id="zend.tool.usage.cli.environment-customization">
-        <title>Environment Customization</title>
+        <title>Personalização do Ambiente</title>
 
         <sect3 id="zend.tool.usage.cli.environment-customization.storage-directory">
-            <title>The Storage Directory</title>
+            <title>O Storage Directory</title>
 
             <para>
-                The storage directory is important so that providers may have a place to find
-                custom user generated logic that might change the way they behave. One example
-                can be found below is the placement of a custom project profile file.
+               O storage directory é importante para que os providers poderem ter um lugar para encontrar
+			   a lógica do usuário personalizada gerada que pode mudar a maneira como eles se comportam.
+			   Um exemplo pode ser encontrado abaixo é a colocação de um arquivo profile do projeto.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -453,13 +452,13 @@ zf --setup storage-directory
         </sect3>
 
         <sect3 id="zend.tool.usage.cli.environment-customization.configuration-file">
-            <title>The Configuration File</title>
+            <title>O Arquivo de Configuração</title>
 
             <para>
-                This will create the proper zf.ini file. This <emphasis>should</emphasis>
-                be run after <command>zf --setup storage-directory</command>. If it is not, it will
-                be located inside the users home directory. If it is, it will be located inside
-                the users storage directory.
+                Isto irá criar o arquivo zf.ini adequado. Este <emphasis> deve </emphasis> 
+				ser executado após <command>zf --setup storage-directory</command>. Se não for,
+			    será localizado dentro do diretório home do usuário. Se for, ele será localizado
+			    dentro do storage directory do usuário.
             </para>
 
             <programlisting language="text"><![CDATA[
@@ -471,8 +470,8 @@ zf --setup config-file
             <title>Environment Locations</title>
 
             <para>
-                These should be set if you wish to override the default places where zf will
-                attempt to read their values.
+                Estes devem ser configurados, se você deseja substituir os locais padrão onde o zf
+                tentará de ler os seus valores.
             </para>
 
             <itemizedlist>
@@ -481,18 +480,18 @@ zf --setup config-file
 
                     <itemizedlist>
                         <listitem>
-                            <para>the directory this tool will look for a home directory</para>
+                            <para>o diretório onde a ferramenta irá procurar um diretório home</para>
                         </listitem>
 
-                        <listitem><para>directory must exist</para></listitem>
+                        <listitem><para>o diretório deve existir</para></listitem>
 
                         <listitem>
-                            <para>search order:</para>
+                            <para>ordem de pesquisa:</para>
 
                             <itemizedlist>
-                                <listitem><para>ZF_HOME environment variable</para></listitem>
-                                <listitem><para>HOME environment variable</para></listitem>
-                                <listitem><para>then HOMEPATH environment variable</para></listitem>
+                                <listitem><para>variável de ambiente ZF_HOME</para></listitem>
+                                <listitem><para>variável de ambiente HOME</para></listitem>
+                                <listitem><para>então a variável de ambiente HOMEPATH</para></listitem>
                             </itemizedlist>
                         </listitem>
                     </itemizedlist>
@@ -503,20 +502,20 @@ zf --setup config-file
 
                     <itemizedlist>
                         <listitem>
-                            <para>where this tool will look for a storage directory</para>
+                            <para>onde esta ferramenta vai procurar por um storage directory</para>
                         </listitem>
 
-                        <listitem><para>directory must exist</para></listitem>
+                        <listitem><para>o diretório deve existir</para></listitem>
 
                         <listitem>
-                            <para>search order:</para>
+                            <para>ordem de pesquisa:</para>
 
                             <itemizedlist>
                                 <listitem>
-                                    <para>ZF_STORAGE_DIRECTORY environment variable</para>
+                                    <para>variável de ambiente ZF_STORAGE_DIRECTORY</para>
                                 </listitem>
 
-                                <listitem><para>$homeDirectory/.zf/ directory</para></listitem>
+                                <listitem><para>diretório $homeDirectory/.zf/</para></listitem>
                             </itemizedlist>
                         </listitem>
                     </itemizedlist>
@@ -527,23 +526,23 @@ zf --setup config-file
 
                     <itemizedlist>
                         <listitem>
-                            <para>where this tool will look for a configuration file</para>
+                            <para>onde esta ferramenta vai procurar pelo arquivo de configuração</para>
                         </listitem>
 
                         <listitem>
-                            <para>search order:</para>
+                            <para>ordem de pesquisa:</para>
 
                             <itemizedlist>
                                 <listitem>
-                                    <para>ZF_CONFIG_FILE environment variable</para>
+                                    <para>variável de ambiente ZF_CONFIG_FILE</para>
                                 </listitem>
 
                                 <listitem>
-                                    <para>$homeDirectory/.zf.ini file if it exists</para>
+                                    <para>se existir o arquivo $homeDirectory/.zf.ini</para>
                                 </listitem>
 
                                 <listitem>
-                                    <para>$storageDirectory/zf.ini file if it exists</para>
+                                    <para>se existir o arquivo $storageDirectory/zf.ini</para>
                                 </listitem>
                             </itemizedlist>
                         </listitem>
@@ -551,30 +550,30 @@ zf --setup config-file
                 </listitem>
 
                 <listitem>
-                    <para>ZF_INCLUDE_PATH</para>
+                    <para>ZEND_TOOL_INCLUDE_PATH</para>
 
                     <itemizedlist>
                         <listitem>
-                            <para>set the include_path for this tool to use this value</para>
+                            <para>configura o include_path para esta ferramenta usar este valor</para>
                         </listitem>
 
                         <listitem>
-                            <para>original behavior:</para>
+                            <para>comportamento original:</para>
 
                             <itemizedlist>
                                 <listitem>
                                     <para>
-                                        use <acronym>PHP</acronym>'s include_path to find ZF
+                                        usa o include_path do <acronym>PHP</acronym> para procurar o ZF
                                     </para>
                                 </listitem>
 
                                 <listitem>
-                                    <para>use the ZF_INCLUDE_PATH environment variable</para>
+                                    <para>usa a variável de ambiente ZEND_TOOL_INCLUDE_PATH</para>
                                 </listitem>
 
                                 <listitem>
                                     <para>
-                                        use the path ../library (relative to zf.php) to find ZF
+                                        usa o caminho ../library (relativo para zf.php) para procurar o ZF
                                     </para>
                                 </listitem>
                             </itemizedlist>
@@ -583,11 +582,11 @@ zf --setup config-file
                 </listitem>
 
                 <listitem>
-                    <para>ZF_INCLUDE_PATH_PREPEND</para>
+                    <para>ZF_TOOL_INCLUDE_PATH_PREPEND</para>
 
                     <itemizedlist>
                         <listitem>
-                            <para>prepend the current php.ini include_path with this value</para>
+                            <para>precede o php.ini include_path atual com este valor</para>
                         </listitem>
                     </itemizedlist>
                 </listitem>
@@ -595,4 +594,3 @@ zf --setup config-file
         </sect3>
     </sect2>
 </sect1>
-