[MANUAL] Brazilian Portuguese

- sync to r20765


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

documentation/manual/pt-br/module_specs/Zend_Config-Introduction.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15978 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.introduction">
     <title>Introdução</title>
+
     <para>
         <classname>Zend_Config</classname> é projetado para simplificar o acesso e a utilização
         dos dados de configuração dentro das aplicações. Ele fornece uma propriedade do objeto
@@ -13,8 +14,10 @@
         <link linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link> e
         <link linkend="zend.config.adapters.xml"><classname>Zend_Config_Xml</classname></link>.
     </para>
+
     <example id="zend.config.introduction.example.using">
         <title>Usando o Zend_Config</title>
+
         <para>
             Normalmente, espera-se que os usuários usem uma das classes adaptadoras como <link
                 linkend="zend.config.adapters.ini"><classname>Zend_Config_Ini</classname></link> ou
@@ -24,6 +27,7 @@
             <classname>Zend_Config</classname> a fim de utilizar uma simples interface
             orientada a objetos:
         </para>
+
         <programlisting language="php"><![CDATA[
 // Dada uma matriz de dados de configuração
 $configArray = array(
@@ -54,26 +58,32 @@ $db = Zend_Db::factory($config->database->adapter,
 $db = Zend_Db::factory($config->database);
 ]]></programlisting>
     </example>
+
     <para>
         Como ilustrado no exemplo acima, <classname>Zend_Config</classname> fornece a sintaxe da
         propriedade do objeto aninhado para acessar os dados de configuração passados para o
         construtor.
     </para>
+
     <para>
         Junto com o acesso orientado a objeto aos valores dos dados,
         <classname>Zend_Config</classname> também tem o <methodname>get()</methodname>, que
         retornará o valor padrão fornecido se o elemento do dado não existir. Por exemplo:
     </para>
+
     <programlisting language="php"><![CDATA[
 $host = $config->database->get('host', 'localhost');
 ]]></programlisting>
+
     <example id="zend.config.introduction.example.file.php">
         <title>Usando o Zend_Config com um Arquivo de Configuração em PHP</title>
+
         <para>
             Muitas vezes é desejável utilizar um arquivo de configuração puramente em
             <acronym>PHP</acronym>. O código a seguir ilustra como isto pode ser
             realizado facilmente:
         </para>
+
         <programlisting language="php"><![CDATA[
 // config.php
 return array(
@@ -89,6 +99,7 @@ return array(
     )
 );
 ]]></programlisting>
+
         <programlisting language="php"><![CDATA[
 // Consumo de configuração
 $config = new Zend_Config(require 'config.php');

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17564 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.adapters.ini">
     <title>Zend_Config_Ini</title>
@@ -46,7 +46,6 @@ $config = new Zend_Config_Ini('/path/to/config.ini',
                               'staging',
                               $options);
 ]]></programlisting>
-
     </note>
 
     <example id="zend.config.adapters.ini.example.using">
@@ -97,53 +96,62 @@ echo $config->database->params->dbname; // imprime "dbname"
     </example>
 
     <note>
-    <table id="zend.config.adapters.ini.table">
-        <title>Parâmetros do Construtor Zend_Config_Ini</title>
-        <tgroup cols="2">
-            <thead>
-                  <row>
-                    <entry>Parâmetro</entry>
-                    <entry>Notas</entry>
-                </row>
-            </thead>
-            <tbody>
-                <row>
-                    <entry><varname>$filename</varname></entry>
-                    <entry>O arquivo <acronym>INI</acronym> a ser carregado.</entry>
-                </row>
-                <row>
-                    <entry><varname>$section</varname></entry>
-                    <entry>A [seção] no arquivo ini que está sendo carregado. Definir este
-                        parâmetro como <constant>NULL</constant> irá carregar todas as seções.
-                        Alternativamente, uma matriz de nomes de seção pode ser fornecida para
-                        carregar várias seções.
-                    </entry>
-                </row>
-                <row>
-                    <entry><varname>$options</varname> (padrão <constant>FALSE</constant>)</entry>
-                    <entry>Matriz de opções. As seguintes chaves são suportadas:
-                        <itemizedlist>
-                            <listitem>
-                                <para>
-                                    <emphasis><property>allowModifications</property></emphasis>:
-                                    Defina como <constant>TRUE</constant> para permitir a alteração
-                                    subsequente dos dados de configuração carregados na memória.
-                                    O padrão é <constant>NULL</constant>
-                                </para>
-                            </listitem>
-                            <listitem>
-                                <para>
-                                    <emphasis><property>nestSeparator</property></emphasis>:
-                                    Define o caractere a ser usado como separador de aninhamento.
-                                    O padrão é "."
-                                </para>
-                            </listitem>
-                        </itemizedlist>
-                    </entry>
-                </row>
-            </tbody>
-        </tgroup>
-    </table>
+        <table id="zend.config.adapters.ini.table">
+            <title>Parâmetros do Construtor Zend_Config_Ini</title>
+
+            <tgroup cols="2">
+                <thead>
+                    <row>
+                        <entry>Parâmetro</entry>
+                        <entry>Notas</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><varname>$filename</varname></entry>
+                        <entry>O arquivo <acronym>INI</acronym> a ser carregado.</entry>
+                    </row>
+
+                    <row>
+                        <entry><varname>$section</varname></entry>
+
+                        <entry>A [seção] no arquivo ini que está sendo carregado. Definir este
+                            parâmetro como <constant>NULL</constant> irá carregar todas as seções.
+                            Alternativamente, uma matriz de nomes de seção pode ser fornecida para
+                            carregar várias seções.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry>
+                            <varname>$options</varname> (padrão <constant>FALSE</constant>)
+                        </entry>
+
+                        <entry>Matriz de opções. As seguintes chaves são suportadas:
+                            <itemizedlist>
+                                <listitem>
+                                    <para>
+                                        <emphasis><property>allowModifications</property></emphasis>:
+                                        Defina como <constant>TRUE</constant> para permitir a
+                                        alteração subsequente dos dados de configuração carregados
+                                        na memória. O padrão é <constant>NULL</constant>
+                                    </para>
+                                </listitem>
+
+                                <listitem>
+                                    <para>
+                                        <emphasis><property>nestSeparator</property></emphasis>:
+                                        Define o caractere a ser usado como separador de
+                                        aninhamento. O padrão é "."
+                                    </para>
+                                </listitem>
+                            </itemizedlist>
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
     </note>
 </sect1>
 <!--

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19691 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.writer.introduction">
     <title>Zend_Config_Writer</title>
@@ -23,11 +23,13 @@
                 <classname>Zend_Config_Writer_Array</classname>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <classname>Zend_Config_Writer_Ini</classname>
             </para>
         </listitem>
+
         <listitem>
             <para>
                 <classname>Zend_Config_Writer_Xml</classname>
@@ -62,11 +64,13 @@
 
     <example id="zend.config.writer.example.using">
         <title>Usando o Zend_Config_Writer</title>
+
         <para>
             Este exemplo ilustra a utilização básica de
             <classname>Zend_Config_Writer_Xml</classname>
             para criar um novo arquivo de configuração:
         </para>
+
         <programlisting language="php"><![CDATA[
 // Cria o objeto de configuração
 $config = new Zend_Config(array(), true);
@@ -98,6 +102,7 @@ $writer->setConfig($config)
 $writer = new Zend_Config_Writer_Xml();
 $writer->write('config.xml', $config);
 ]]></programlisting>
+
         <para>
             Isso criará um arquivo de configuração <acronym>XML</acronym> com as seções de produção
             e de testes, onde testes estende produção.
@@ -106,9 +111,11 @@ $writer->write('config.xml', $config);
 
     <example id="zend.config.writer.modifying">
         <title>Modificando uma Configuração Existente</title>
+
         <para>
             Este exemplo demonstra como editar um arquivo de configuração existente.
         </para>
+
         <programlisting language="php"><![CDATA[
 // Carrega todas as seções de um arquivo de configuração
 // existente, enquanto pula o que é estendido.
@@ -129,6 +136,7 @@ $writer->write();
 
     <note>
         <title>Carregando um Arquivo de Configuração</title>
+
         <para>
             Ao carregar um arquivo de configuração existente para modificações, é muito importante
             que se carregue todas as seções e que se pule tudo o que é estendido, para que valores

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

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20101 -->
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.adapters.xml">
     <title>Zend_Config_Xml</title>
+
     <para>
         <classname>Zend_Config_Xml</classname> permite aos desenvolvedores armazenarem os dados de
         configuração em um formato <acronym>XML</acronym> simples e lê-los através de uma sintaxe
@@ -16,16 +17,20 @@
         <emphasis>extends</emphasis>, e o valor deste atributo corresponde à seção a que a
         informação deve ser herdada.
     </para>
+
     <note>
         <title>Tipo de Retorno</title>
+
         <para>
             Os dados de configuração lidos em <classname>Zend_Config_Xml</classname> são sempre
             retornados como strings. A conversão de dados de strings para outros tipos é deixado
             para os desenvolvedores de acordo com suas necessidades específicas.
         </para>
     </note>
+
     <example id="zend.config.adapters.xml.example.using">
         <title>Usando o Zend_Config_Xml</title>
+
         <para>
             Este exemplo ilustra uma utilização básica de <classname>Zend_Config_Xml</classname>
             para carregar dados de configuração de um arquivo <acronym>XML</acronym>. Neste
@@ -37,6 +42,7 @@
             mais complexas. Suponha-se, então, que os dados de configuração a seguir estão
             contidos em <filename>/path/to/config.xml</filename>:
         </para>
+
         <programlisting language="xml"><![CDATA[
 <?xml version="1.0"?>
 <configdata>
@@ -63,11 +69,13 @@
     </staging>
 </configdata>
 ]]></programlisting>
+
         <para>
             Em seguida, suponha que o desenvolvedor do aplicativo necessite dos dados de
             configuração de testes do arquivo <acronym>XML</acronym>. É o simples caso de carregar
             esses dados especificando o arquivo <acronym>XML</acronym> e a seção de testes:
         </para>
+
         <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Xml('/path/to/config.xml', 'staging');
 
@@ -75,8 +83,10 @@ echo $config->database->params->host;   // prints "dev.example.com"
 echo $config->database->params->dbname; // prints "dbname"
 ]]></programlisting>
     </example>
+
     <example id="zend.config.adapters.xml.example.attributes">
         <title>Usando os Atributos de Tag no Zend_Config_Xml</title>
+
         <para>
             <classname>Zend_Config_Xml</classname> também suporta outras duas maneiras para definir
             os nós na configuração. Ambas fazem uso de atributos. A partir do momento que os
@@ -85,6 +95,7 @@ echo $config->database->params->dbname; // prints "dbname"
             ser utilizados. A primeira maneira usar os atributos é adicionar um nó pai, assim eles
             serão interpretados como um filho deste nó:
         </para>
+
         <programlisting language="xml"><![CDATA[
 <?xml version="1.0"?>
 <configdata>
@@ -102,11 +113,13 @@ echo $config->database->params->dbname; // prints "dbname"
     </staging>
 </configdata>
 ]]></programlisting>
+
         <para>
             A outra maneira não encurta realmente a configuração, mas a torna mais fácil para
             manter, pois você não tem que escrever o nome da tag duas vezes. Você simplesmente cria
             uma tag vazia com o valor no atributo <emphasis>value</emphasis>:
         </para>
+
         <programlisting language="xml"><![CDATA[
 <?xml version="1.0"?>
 <configdata>
@@ -134,14 +147,17 @@ echo $config->database->params->dbname; // prints "dbname"
 </configdata>
 ]]></programlisting>
     </example>
-<note>
+
+    <note>
         <title>Strings XML</title>
+
         <para>
             <classname>Zend_Config_Xml</classname> é capaz de carregar uma string
             <acronym>XML</acronym> diretamente, por exemplo, uma que foi recuperada de um banco de
             dados. A string é passada como primeiro parâmetro para o construtor e deve começar com
             os caracteres <emphasis>'&lt;?xml'</emphasis>:
         </para>
+
         <programlisting language="xml"><![CDATA[
 $string = <<<EOT
 <?xml version="1.0"?>
@@ -167,8 +183,10 @@ EOT;
 $config = new Zend_Config_Xml($string, 'staging');
 ]]></programlisting>
     </note>
-<note>
+
+    <note>
         <title>Namespace XML do Zend_Config</title>
+
         <para>
             <classname>Zend_Config</classname> vem com sua próprio namespace <acronym>XML</acronym>,
             que adiciona funcionalidade adicional ao processo de análise. Para aproveitá-la, você
@@ -183,6 +201,7 @@ $config = new Zend_Config_Xml($string, 'staging');
             transferido para um novo namespace e está depreciado no namespace
             <constant>NULL</constant>. Ele será completamente removido no Zend Framework 2.0.
         </para>
+
         <programlisting language="xml"><![CDATA[
 $string = <<<EOT
 <?xml version="1.0"?>