[MANUAL] pt-br: sync

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

documentation/manual/pt-br/module_specs/Zend_Db_Profiler-Firebug.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20766 -->
+<!-- EN-Revision: 22856 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.db.profiler.profilers.firebug">
     <title>Analisando o Desempenho com Firebug</title>
@@ -55,7 +55,7 @@ $profiler = new Zend_Db_Profiler_Firebug('All DB Queries');
 $profiler->setEnabled(true);
 
 // Anexa o analisador de desempenho ao seu adaptador de banco de dados
-$db->setProfiler($profiler)
+$db->setProfiler($profiler);
 
 // Despache seu controlador frontal
 
@@ -72,7 +72,7 @@ $profiler = new Zend_Db_Profiler_Firebug('All DB Queries');
 $profiler->setEnabled(true);
 
 // Anexa o analisador de desempenho ao seu adaptador de banco de dados
-$db->setProfiler($profiler)
+$db->setProfiler($profiler);
 
 $request  = new Zend_Controller_Request_Http();
 $response = new Zend_Controller_Response_Http();

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22432 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.basics">
     <title>Uso Básico</title>
@@ -39,8 +39,8 @@ if($debug) {
 
         <para>
             O segundo argumento opcional de <methodname>Zend_Json::prettyPrint()</methodname> é uma
-            matriz de opções. A opção <code>indent</code> lhe permite definir a string de recuo -
-            por padrão é um único caractere de tabulação.
+            matriz de opções. A opção <property>indent</property> lhe permite definir a string de
+            recuo - por padrão é um único caractere de tabulação.
         </para>
     </sect2>
 </sect1>

documentation/manual/pt-br/module_specs/Zend_Json-Objects.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 22747 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.advanced">
     <title>Uso Avançado do Zend_Json</title>
@@ -44,8 +44,8 @@ $phpNative = Zend_Json::decode($encodedValue, Zend_Json::TYPE_OBJECT);
 
         <para>
             Todos os objetos descodificados assim são retornados como objetos de
-            <code>StdClass</code> com as propriedades que correspondem aos pares chave/valor na
-            notação de <acronym>JSON</acronym>.
+            <classname>StdClass</classname> com as propriedades que correspondem aos pares
+            chave/valor na notação de <acronym>JSON</acronym>.
         </para>
 
         <para>
@@ -110,10 +110,11 @@ Zend_Json::$useBuiltinEncoderDecoder = true:
             <classname>Zend_Json_Expr</classname>. Ela implementa o padrão value object e é
             imutável. Você pode definir a expressão javascript como o primeiro argumento do
             construtor. Por padrão <classname>Zend_Json::encode</classname> não codifica callbacks
-            de javascript, você deverá passar a opção <code>'enableJsonExprFinder' = true</code>
-            para a função <code>encode</code>. Se ativado, o suporte à expressão funcionará para
-            todas as expressões aninhadas em estruturas de grande porte.
-            Um exemplo de uso seria parecido com:
+            de javascript, você deverá passar a opção <property>enableJsonExprFinder</property> e
+            defini-la para <constant>TRUE</constant> para a função
+            <methodname>encode()</methodname>. Se ativado, o suporte à expressão funcionará para
+            todas as expressões aninhadas em estruturas de grande porte. Um exemplo de uso seria
+            parecido com:
         </para>
 
         <programlisting language="php"><![CDATA[

documentation/manual/pt-br/module_specs/Zend_Layout-Advanced.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 22432 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.advanced">
     <title>Uso Avançado de Zend_Layout</title>
@@ -112,19 +112,18 @@ $layoutVars   = $placeholders->placeholder('Zend_Layout')->getArrayCopy();
 
         <para>
             Quando o usamos com os componentes <acronym>MVC</acronym>,
-            <classname>Zend_Layout</classname> registra um plugin front controller que
-            renderiza o layout como a última ação antes de abandonar o laço de despacho.
-            Na maioria dos casos, o plugin padrão servirá, mas você se você desejar escrever
-            o seu próprio, você pode especificar o nome da classe plugin a ser carregada
-            carregar pela passagem da opção <code>pluginClass</code> ao método
-            <methodname>startMvc()</methodname>.
+            <classname>Zend_Layout</classname> registra um plugin front controller que renderiza o
+            layout como a última ação antes de abandonar o laço de despacho. Na maioria dos casos, o
+            plugin padrão servirá, mas você se você desejar escrever o seu próprio, você pode
+            especificar o nome da classe plugin a ser carregada carregar pela passagem da opção
+            <property>pluginClass</property> ao método <methodname>startMvc()</methodname>.
         </para>
 
         <para>
             Qualquer classe plugin que você escrever para esse propósito precisará estender
-            <classname>Zend_Controller_Plugin_Abstract</classname>, e deverá aceitar uma
-            instância de objeto layout como um argumento para o construtor. Caso contrário,
-            os detalhes de sua implementação ficarão acima de você.
+            <classname>Zend_Controller_Plugin_Abstract</classname>, e deverá aceitar uma instância
+            de objeto layout como um argumento para o construtor. Caso contrário, os detalhes de sua
+            implementação ficarão acima de você.
         </para>
 
         <para>
@@ -138,20 +137,19 @@ $layoutVars   = $placeholders->placeholder('Zend_Layout')->getArrayCopy();
 
         <para>
             Quando o usamos com componentes <acronym>MVC</acronym>,
-            <classname>Zend_Layout</classname> registra um helper action controller com o
-            helper broker. O helper padrão,
-            <classname>Zend_Layout_Controller_Action_Helper_Layout</classname>,
-            age como um proxy mudo para a própria instância do objeto de layout,
-            e deve servir para a maioria dos casos de uso.
+            <classname>Zend_Layout</classname> registra um helper action controller com o helper
+            broker. O helper padrão,
+            <classname>Zend_Layout_Controller_Action_Helper_Layout</classname>, age como um proxy
+            mudo para a própria instância do objeto de layout, e deve servir para a maioria dos
+            casos de uso.
         </para>
 
         <para>
-            Se você sentir necessidade de escrever funcionalidades customizadas,
-            simplesmente escreva uma classe action helper estendendo
-            <classname>Zend_Controller_Action_Helper_Abstract</classname> e passe o nome da
-            classe como uma opção <code>helperClass</code> para o método
-            <methodname>startMvc()</methodname>. Detalhes da implementação ficarão
-            acima de você.
+            Se você sentir necessidade de escrever funcionalidades customizadas, simplesmente
+            escreva uma classe action helper estendendo
+            <classname>Zend_Controller_Action_Helper_Abstract</classname> e passe o nome da classe
+            como uma opção <property>helperClass</property> para o método
+            <methodname>startMvc()</methodname>. Detalhes da implementação ficarão acima de você.
         </para>
     </sect2>
 

documentation/manual/pt-br/module_specs/Zend_Layout-Options.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22748 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.options">
     <title>Opções de Configuração Zend_Layout</title>
@@ -102,8 +102,8 @@
         <title>helperClass e pluginClass devem ser passados para startMvc()</title>
 
         <para>
-            Para que as configurações <code>helperClass</code> e <code>pluginClass</code>
-            tenham efeito, elas devem ser passadas como opções para
+            Para que as configurações <property>helperClass</property> e
+            <property>pluginClass</property> tenham efeito, elas devem ser passadas como opções para
             <methodname>startMvc()</methodname>; se forem configuradas mais tarde,
             elas não tem efeito.
         </para>
@@ -192,8 +192,8 @@ $layout->setConfig($options);
 ]]></programlisting>
 
             <para>
-                Note, entretanto, que certas opções, tais como <code>pluginClass</code> e
-                <code>helperClass</code>, não serão afetadas quando a passagem for feita
+                Note, entretanto, que certas opções, tais como <property>pluginClass</property> e
+                <property>helperClass</property>, não serão afetadas quando a passagem for feita
                 por esse método; elas precisam ser passadas ao construtor ou método
                 <methodname>startMvc()</methodname>.
             </para>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22743 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.quickstart">
     <title>Guia Rápido Zend_Layout</title>
@@ -105,7 +105,7 @@
             layout com qualquer conteúdo de aplicação uma vez que o laço de despacho foi feito,
             e registra um action helper para permitir o acesso ao objeto layout a partir de seus
             action controllers. Adicionalmente, você pode a qualquer tempo pegar a instância de
-            dentro de um view script usando o view helper <code>layout</code>.
+            dentro de um view script usando o view helper <classname>Layout</classname>.
         </para>
 
         <para>
@@ -121,12 +121,12 @@ Zend_Layout::startMvc();
         <para>
             <methodname>startMvc()</methodname> pode tomar uma matriz opcional de opções ou
             um objeto <classname>Zend_Config</classname> para customizar a instância; essas
-            opções são detalhadas na <xref linkend="zend.layout.options" />.
+            opções são detalhadas <link linkend="zend.layout.options">nesta seção</link>.
         </para>
 
         <para>
-            Em um action controller, você pode então acessar a instância de
-            layout como um action helper:
+            Em um action controller, você pode então acessar a instância de layout como um action
+            helper:
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -147,8 +147,8 @@ class FooController extends Zend_Controller_Action
 ]]></programlisting>
 
         <para>
-            Em seus view scripts, você pode então acessar o objeto de <code>layout</code>
-            via view helper layout. Esse view helper é levemente diferente dos outros
+            Em seus view scripts, você pode então acessar o objeto de layout via view helper
+            <classname>Layout</classname>. Esse view helper é levemente diferente dos outros
             no que toca a não tomar argumentos, e retornar um objeto ao invés de um valor
             string. Isso permite que você imediatamente chame métodos no objeto de layout:
         </para>

documentation/manual/pt-br/module_specs/Zend_Pdf-Drawing.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21992 -->
+<!-- EN-Revision: 22745 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.pdf.drawing">
     <title>Desenhando</title>
@@ -261,8 +261,8 @@ $pdfPage->drawText('Olá mundo!', 72, 720);
             (como uma string UTF-8 sendo lida de um arquivo no disco, ou uma string MacRoman obtida
             de um bando de dados legado), você pode a codificação na hora de desenhar e a
             <classname>Zend_Pdf</classname> irá tratar a comunicação para você. Você pode fornecer
-            as strings em qualquer método de codificação suportada pela função <code><ulink
-                url="http://www.php.net/manual/function.iconv.php">iconv()</ulink></code> do
+            as strings em qualquer método de codificação suportada pela função <ulink
+                url="http://www.php.net/manual/function.iconv.php">iconv()</ulink> do
             <acronym>PHP</acronym>:
         </para>
 

documentation/manual/pt-br/module_specs/Zend_Pdf-Pages.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20872 -->
+<!-- EN-Revision: 22797 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.pdf.pages">
     <title>Trabalhando com Páginas</title>
@@ -22,17 +22,9 @@
             <classname>Zend_Pdf_Page</classname> diretamente ou chamando o método
             <methodname>Zend_Pdf::newPage()</methodname>, que retorna um objeto
             <classname>Zend_Pdf_Page</classname>. <methodname>Zend_Pdf::newPage()</methodname> cria
-            uma página já anexada à um documento. Páginas desanexadas não podem ser usadas com
-            múltiplos documentos <acronym>PDF</acronym>, mas elas possuem uma performance
-            relativamente maior.
-
-            <footnote>
-                <para>
-                    Esta é uma limitação da versão atual do Zend Framework. Esta limitação será
-                    eliminada nas versões futuras. Mas páginas desanexadas sempre terão um
-                    desempenho melhor no compartilhamento de páginas entre diversos documentos.
-                </para>
-            </footnote>
+            uma página já anexada à um documento. Páginas anexadas não podem ser usadas com outros
+            documentos <acronym>PDF</acronym> até que não esteja clonado. Veja a seção <link
+                linkend="zend.pdf.pages.cloning">Clonagem de página</link> para obter mais detalhes.
         </para>
 
         <para>
@@ -79,15 +71,15 @@ unset($pdf->pages[$id]);
     </sect2>
 
     <sect2 id="zend.pdf.pages.cloning">
-        <title>Clonagem de Página</title>
+        <title>Clonagem de página</title>
 
         <para>
-            Páginas <acronym>PDF</acronym> podem ser clonadas através da criação de um novo objeto
+            Páginas <acronym>PDF</acronym> podem ser duplicadas através da criação de um novo objeto
             <classname>Zend_Pdf_Page</classname> com uma página já existente como parâmetro:
         </para>
 
         <example id="zend.pdf.pages.example-2">
-            <title>Clonando páginas existentes</title>
+            <title>Duplicando páginas existentes</title>
 
             <programlisting language="php"><![CDATA[
 ...
@@ -96,11 +88,13 @@ $template = $pdf->pages[$templatePageIndex];
 ...
 // Adiciona nova página
 $page1 = new Zend_Pdf_Page($template);
+$page1->drawText('Algum texto...', $x, $y);
 $pdf->pages[] = $page1;
 ...
 
 // Adiciona outra página
 $page2 = new Zend_Pdf_Page($template);
+$page2->drawText('Outro texto...', $x, $y);
 $pdf->pages[] = $page2;
 ...
 
@@ -117,11 +111,60 @@ unset($pdf->pages[$templatePageIndex]);
 
         <caution>
             <para>
-                Importante! Uma página clonada compartilha alguns recursos do <acronym>PDF</acronym>
-                com uma página template, então ela só pode ser usada no mesmo documento como uma
-                página template. Um documento modificado pode ser salvo como um novo documento.
+                Importante! Uma página duplicada compartilha alguns recursos do
+                <acronym>PDF</acronym> com uma página template, então ela só pode ser usada no mesmo
+                documento como uma página template. Um documento modificado pode ser salvo como um
+                novo documento.
             </para>
         </caution>
+
+        <para>
+            <code>clone</code> operator may be used to create page which is not attached to any document.
+            It takes more time than duplicating page since it needs to copy all dependent objects
+            (used fonts, images and other resources), but it allows to use pages from different source
+            documents to create new one: 
+        </para>
+
+        <example id="zend.pdf.pages.example-3">
+            <title>Cloning existing page</title>
+
+            <programlisting language="php"><![CDATA[
+$page1 = clone $pdf1->pages[$templatePageIndex1];
+$page2 = clone $pdf2->pages[$templatePageIndex2];
+$page1->drawText('Some text...', $x, $y);
+$page2->drawText('Another text...', $x, $y);
+...
+$pdf = new Zend_Pdf();
+$pdf->pages[] = $page1;
+$pdf->pages[] = $page2;
+]]></programlisting>
+        </example>
+        
+        <para>
+            If several template pages are planned to be used as templates then it could be more efficient 
+            to utilize <classname>Zend_Pdf_Resource_Extractor</classname> class which gives an ability 
+            to share resources between cloned pages - fonts, images, etc. (otherwise new resource copy 
+            will be created for each cloned page):  
+        </para>
+
+        <example id="zend.pdf.pages.example-4">
+            <title>
+                Cloning existing page using <classname>Zend_Pdf_Resource_Extractor</classname> class
+            </title>
+
+            <programlisting language="php"><![CDATA[
+$extractor = new Zend_Pdf_Resource_Extractor();
+....
+$page1 = $extractor->clonePage($pdf->pages[$templatePageIndex1]);
+$page2 = $extractor->clonePage($pdf->pages[$templatePageIndex2]);
+$page1->drawText('Some text...', $x, $y);
+$page2->drawText('Another text...', $x, $y);
+...
+$pdf = new Zend_Pdf();
+$pdf->pages[] = $page1;
+$pdf->pages[] = $page2;
+]]></programlisting>
+        </example>
     </sect2>
 </sect1>
 <!--

documentation/manual/pt-br/module_specs/Zend_Pdf-Properties.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21829 -->
+<!-- EN-Revision: 22745 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.pdf.info">
     <!-- @todo review and revise upon completion of refactoring -->
@@ -13,7 +13,8 @@
     <para>
         Historicamente essas informações são armazenadas com o uso de estruturas especiais. Esta
         estrutura está disponível para leitura e escrita como uma matriz associativa usando a
-        propriedade pública <code>properties</code> dos objetos <classname>Zend_Pdf</classname>:
+        propriedade pública <property>properties</property> dos objetos
+        <classname>Zend_Pdf</classname>:
     </para>
 
     <programlisting language="php"><![CDATA[