[MANUAL] Brazilian Portuguese:

- manual fixes
- sync to r20854, r20872


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

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

@@ -6,12 +6,12 @@
 
     <para>
         A classe <classname>Zend_Pdf</classname> representa os documentos <acronym>PDF</acronym> e
-        provê funcionalidades para manupulação do documento.
+        provê funcionalidades para manipulação do documento.
     </para>
 
     <para>
-        Para criar um novo documento, um novo objeto <code>Zend_Pdf</code> deve ser instanciado
-        primeiro.
+        Para criar um novo documento, um novo objeto <classname>Zend_Pdf</classname> deve ser
+        instanciado primeiro.
     </para>
 
     <para>

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

@@ -305,8 +305,9 @@ public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);
         <para>
             Documentos <acronym>PDF</acronym> suportam as fontes PostScript Type 1 e TrueType, assim
             como dois tipos especiais do <acronym>PDF</acronym>, o Type 3 e as fontes compostas.
-            Existem também 14 fontes padrão Type 1 inclusas em todos os visualizadores de PDF:
-            Courier (4 estilos), Helvetica (4 estilos), Times (4 estilos), Symbol, e Zapf Dingbats.
+            Existem também 14 fontes padrão Type 1 inclusas em todos os visualizadores de
+            <acronym>PDF</acronym>: Courier (4 estilos), Helvetica (4 estilos), Times (4 estilos),
+            Symbol, e Zapf Dingbats.
         </para>
 
         <para>
@@ -314,7 +315,8 @@ public function setFont(Zend_Pdf_Resource_Font $font, $fontSize);
             <acronym>PDF</acronym> padrão, assim como às suas fontes personalizadas TrueType.
             Objetos do tipo Font são obtidos via um dos dois métodos fábrica:
             <methodname>Zend_Pdf_Font::fontWithName($fontName)</methodname> para as 14 fontes padrão
-            ou <methodname>Zend_Pdf_Font::fontWithPath($filePath)</methodname> para fontes
+            do <acronym>PDF</acronym> ou
+            <methodname>Zend_Pdf_Font::fontWithPath($filePath)</methodname> para fontes
             personalizadas.
         </para>
 
@@ -356,7 +358,7 @@ $pdfPage->setFont($font, 36);
 
         <para>
             Você também pode usar qualquer fonte individual TrueType (que normalmente possui a
-            extensão '.ttf') ou uma fonte OpenType (de extansão '.otf') se ela contiver o mesmo
+            extensão '.ttf') ou uma fonte OpenType (de extensão '.otf') se ela contiver o mesmo
             contorno das TrueType. Atualmente sem suporte, mas planejadas para um lançamento futuro
             são os arquivos .dfont do Mac OS X e os arquivos Microsoft TrueType Collection (extensão
             '.ttc').
@@ -684,9 +686,10 @@ $pdfPage->drawImage($image, 100, 100, 400, 300);
         </example>
 
         <para>
-            <emphasis>Importante! O suporte a JPEG requer que a extensão PHP GD esteja
-                configurada.</emphasis> <emphasis>Importante! O suporte a PNG requer que extensão
-                ZLIB esteja configurada para trabalhar com imagens com canal Alpha.</emphasis>
+            <emphasis>Importante! O suporte a JPEG requer que a extensão <acronym>PHP</acronym> GD
+                esteja configurada.</emphasis> <emphasis>Importante! O suporte a PNG requer que
+                extensão ZLIB esteja configurada para trabalhar com imagens com canal
+                Alpha.</emphasis>
         </para>
 
         <para>
@@ -787,10 +790,10 @@ public function setLineDashingPattern($pattern, $phase = 0);
                             os envolvem caminhos complexos ou com auto-intersecção, como os que são
                             apresentados na Figura 4.10 (na Referência do <acronym>PDF</acronym>).
                             Para um caminho que consiste em uma estrela de cinco pontas, desenhada
-                            com cinco linhas retas conectadas interseccionando-se, a regra considera
-                            como sendo o interior toda a área delimitada pela estrela, incluindo o
-                            pentágono no centro. Para um caminho composto de dois círculos
-                            concêntricos, as áreas delimitadas por ambos os círculos são
+                            com cinco linhas retas conectadas se inter-seccionando, a regra
+                            considera como sendo o interior toda a área delimitada pela estrela,
+                            incluindo o pentágono no centro. Para um caminho composto de dois
+                            círculos concêntricos, as áreas delimitadas por ambos os círculos são
                             consideradas como sendo o interior, desde que ambos os círculos sejam
                             desenhados na mesma direção. Se os círculos forem desenhados em direções
                             opostas, apenas a forma da "rosquinha" entre eles está no interior, de
@@ -923,7 +926,7 @@ public function skew($x, $y, $xAngle, $yAngle);
 
         <para>
             A qualquer hora os estados gráficos de uma página (fonte atual, tamanho da fonte, cor
-            das linhas, cor de preenchimento, estilo de linha, rotação da página, e área de clip)
+            das linhas, cor de preenchimento, estilo de linha, rotação da página, e área de corte)
             podem ser salvos e então restaurados. Operações "Salvar" colocam os dados em uma pilha,
             as restaurações recuperam os estados da pilha.
         </para>

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

@@ -1,67 +1,86 @@
-<sect1 id="zend.pdf.introduction">
-    <!-- @todo review and revise upon completion of refactoring -->
-    <title>Introdução.</title>
-    <para>
-    O módulo Zend_Pdf é um motor para manipulação de PDF (Portable Document Format) totalmente escrito em PHP 5.
-    Ele pode carregar documentos existentes, criar novos documentos, modificar e salvar documentos modificados.
-    Dessa forma, este módulo pode ajudar qualquer aplicação baseada em PHP a preparar dinamicamente documentos
-    em PDF através da modificação de um template já existente ou pela geração de um documento a partir de rabiscos.
-
-    O módulo Zend_Pdf dá suporte às seguintes características:
-    <itemizedlist>
-        <listitem>
-            <para>
-            Criação de um novo documento ou carregar um já existente.
-            <footnote>
-                <para>
-                Documentos PDF V1.4 (Acrobat 5) agora tem suporte para carga (loading).
-                </para>
-            </footnote>
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Recuperação de revisão específica do documento.
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Manipulação das páginas do documento. Mudança de ordem, adição de novas páginas e remoção de páginas do documento.
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Diferentes formas primitivas de desenho (linhas, retângulos, polígonos, círculos, elipses e áreas).
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Desenho de texto usando qualquer uma das 14 fontes padrões (built-in) ou suas próprias fontes TrueType personalizadas.
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Rotações.
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-            Desenho de imagens.
-            <footnote>
-                <para>
-                Imagens nos formatos JPG, PNG [até 8bit por canal+Alpha] e TIFF são suportadas.
-                </para>
-            </footnote>
-            </para>
-        </listitem>
-        <listitem>
-            <para>
-             Atualização incremental dos arquivos PFD.
-            </para>
-        </listitem>
-    </itemizedlist>
-    </para>
-</sect1>
-<!--
-vim:se ts=4 sw=4 et:
--->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20854 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.pdf.introduction">
+    <!-- @todo review and revise upon completion of refactoring -->
+    <title>Introdução</title>
+
+    <para>
+        O componente <classname>Zend_Pdf</classname> é um motor para manipulação de
+        <acronym>PDF</acronym> (Portable Document Format). Ele pode carregar, criar, modificar e
+        salvar documentos. Dessa forma, ele pode ajudar qualquer aplicação em <acronym>PHP</acronym>
+        a criar documentos <acronym>PDF</acronym> dinamicamente através da modificação de documentos
+        existentes ou gerando novos documentos a partir do zero. <classname>Zend_Pdf</classname>
+        oferece as seguintes características:
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    Criar um novo documento ou carregar um já existente.
+
+                    <footnote>
+                        <para>
+                            O carregamento de documentos <acronym>PDF</acronym> V1.4 (Acrobat 5)
+                            já é suportado.
+                        </para>
+                    </footnote>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Recuperar uma revisão específica do documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Manipular páginas dentro de um documento. Alterar ordem, adicionar e remover
+                    páginas de um documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Diferentes formas primitivas de desenho (linhas, retângulos, polígonos,
+                    círculos, elipses e áreas).
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Escrever texto usando qualquer uma das 14 fontes padrões (built-in) ou suas
+                    próprias fontes TrueType personalizadas.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Rotações.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Desenho de imagens.
+
+                    <footnote>
+                        <para>
+                            Imagens nos formatos JPG, PNG [até 8bit por canal+Alpha] e TIFF são
+                            suportadas.
+                        </para>
+                    </footnote>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Atualização incremental dos arquivos <acronym>PDF</acronym>.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </para>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -1,120 +1,129 @@
-<sect1 id="zend.pdf.pages">
-    <title>Document pages.</title>
-    <sect2 id="zend.pdf.pages.creation">
-        <title>Page creation.</title>
-        <para>
-            A abstração da página de um documento PDF é representada pela classe <code>Zend_Pdf_Page</code>.
-        </para>
-
-        <para>
-            Páginas PDF podem ser carregadas de um PDF existente, ou criadas.
-        </para>
-
-        <para>
-            Uma nova página pode ser obtida através da criação de um novo objeto <code>Zend_Pdf_Page</code> ou pela chamada
-            ao método <code>Zend_Pdf::newPage()</code>, que retorna um objeto <code>Zend_Pdf_Page</code>. A diferença é que
-            o método <code>Zend_Pdf::newPage()</code> cria uma nova página já anexada ao documento. Isso faz com que,
-            diferentemente das páginas não anexadas, a página criada por este método não possa ser usada em outros documentos
-            PDF. Entretanto, ela tem uma performance um pouco melhor.
-            <footnote>
-                <para>
-                Esta é uma limitação da versão 1.0 do módulo Zend_Pdf. Esta limitação será eliminada nas versões futuras, mas
-                páginas não anexadas sempre terão um desempenho melhor no compartilhamento de páginas entre diversos
-                documentos.
-                </para>
-            </footnote>. A escolha sobre qual abordagem utilizar é sua.
-        </para>
-
-        <para>
-        O método <code>Zend_Pdf::newPage()</code> e o construtor <code>Zend_Pdf_Page</code> recebem o mesmo conjunto de
-        parâmetros de definição do tamanho da página. Os parâmetros são ou o tamanho da página ($x, $y) em pontos (1/72 inch),
-        ou uma constante prédefinida, que é tratada como um tipo de página:
-            <itemizedlist>
-                <listitem>
-                    <para>Zend_Pdf_Page::SIZE_A4</para>
-                </listitem>
-                <listitem>
-                    <para>Zend_Pdf_Page::SIZE_A4_LANDSCAPE</para>
-                </listitem>
-                <listitem>
-                    <para>Zend_Pdf_Page::SIZE_LETTER</para>
-                </listitem>
-                <listitem>
-                    <para>Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE</para>
-                </listitem>
-            </itemizedlist>
-        </para>
-
-        <para>
-            As páginas de um documento são armazenadas na variável pública <code>$pages</code> da classe <code>Zend_Pdf</code>.
-            Este atributo é sempre um array de objetos <code>Zend_Pdf_Page</code>. Ele define completamente o conjunto e a ordem
-            das páginas do documento e pode ser manipulado como qualquer array:
-        </para>
-
-        <example id="zend.pdf.pages.example-1">
-            <title>Gerenciamento de páginas de documentos PDF.</title>
-            <programlisting role="php"><![CDATA[<?php
-    ...
-    // Reverse page order
-    $pdf->pages = array_reverse($pdf->pages);
-    ...
-    // Add new page
-    $pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);
-    // Add new page
-    $pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);
-
-    // Remove specified page.
-    unset($pdf->pages[$id]);
-
-    ...]]>
-            </programlisting>
-        </example>
-    </sect2>
-
-    <sect2 id="zend.pdf.pages.cloning">
-        <title>Clonde de Páginas.</title>
-        <para>
-            Páginas PDF podem ser clonadas através da criação de um novo objeto <code>Zend_Pdf_Page</code> com uma página
-            já existente como parâmetro:
-        </para>
-
-        <example id="zend.pdf.pages.example-2">
-            <title>Clonando páginas existentes.</title>
-            <programlisting role="php"><![CDATA[<?php
-    ...
-    // Store template page in a separate variable
-    $template = $pdf->pages[$templatePageIndex];
-    ...
-    // Add new page
-    $page1 = new Zend_Pdf_Page($template);
-    $pdf->pages[] = $page1;
-    ...
-
-    // Add another page
-    $page2 = new Zend_Pdf_Page($template);
-    $pdf->pages[] = $page2;
-    ...
-
-    // Remove source template page from the documents.
-    unset($pdf->pages[$templatePageIndex]);
-
-    ...]]>
-            </programlisting>
-        </example>
-
-        <para>
-            É útil caso você precisa criar diversas páginas usando um template.
-        </para>
-
-        <caution>
-            <para>
-               Importante! Uma página clonada compartilha alguns recursos do PDF com a 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>
-    </sect2>
-</sect1>
-<!--
-vim:se ts=4 sw=4 et:
--->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20872 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.pdf.pages">
+    <title>Trabalhando com Páginas</title>
+
+    <sect2 id="zend.pdf.pages.creation">
+        <title>Criação de Página</title>
+
+        <para>
+            As páginas em um documento <acronym>PDF</acronym> são representadas como instâncias de
+            <classname>Zend_Pdf_Page</classname> em <classname>Zend_Pdf</classname>.
+        </para>
+
+        <para>
+            Páginas <acronym>PDF</acronym> podem ser carregadas de um <acronym>PDF</acronym>
+            existente ou criadas usando a <acronym>API</acronym> de <classname>Zend_Pdf</classname>.
+        </para>
+
+        <para>
+            Novas páginas podem ser criadas instanciando novos objetos
+            <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>
+        </para>
+
+        <para>
+            O método <methodname>Zend_Pdf::newPage()</methodname> e o construtor
+            <classname>Zend_Pdf_Page</classname> recebem os mesmos parâmetros de definição do
+            tamanho da página. Eles podem receber tanto o tamanho da página ($x, $y) em pontos
+            (1/72 polegadas) quanto uma constante pré-definida representando um tipo de página:
+
+            <itemizedlist>
+                <listitem><para>Zend_Pdf_Page::SIZE_A4</para></listitem>
+                <listitem><para>Zend_Pdf_Page::SIZE_A4_LANDSCAPE</para></listitem>
+                <listitem><para>Zend_Pdf_Page::SIZE_LETTER</para></listitem>
+                <listitem><para>Zend_Pdf_Page::SIZE_LETTER_LANDSCAPE</para></listitem>
+            </itemizedlist>
+        </para>
+
+        <para>
+            As páginas de um documento são armazenadas no atributo público <varname>$pages</varname>
+            da classe <classname>Zend_Pdf</classname>. O atributo contém uma matriz de objetos
+            <classname>Zend_Pdf_Page</classname> e define completamente as instâncias e ordem das
+            páginas. Esta matriz pode ser manipulada como qualquer outra matriz do
+            <acronym>PHP</acronym>:
+        </para>
+
+        <example id="zend.pdf.pages.example-1">
+            <title>Gerenciamento de páginas de documentos PDF</title>
+
+            <programlisting language="php"><![CDATA[
+...
+// Inverte a ordem das páginas
+$pdf->pages = array_reverse($pdf->pages);
+...
+// Adiciona nova página
+$pdf->pages[] = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);
+// Adiciona nova página
+$pdf->pages[] = $pdf->newPage(Zend_Pdf_Page::SIZE_A4);
+
+// Remove uma página específica
+unset($pdf->pages[$id]);
+
+...
+]]></programlisting>
+        </example>
+    </sect2>
+
+    <sect2 id="zend.pdf.pages.cloning">
+        <title>Clonagem de Página</title>
+
+        <para>
+            Páginas <acronym>PDF</acronym> podem ser clonadas 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>
+
+            <programlisting language="php"><![CDATA[
+...
+// Armazena a página template em uma variável separada
+$template = $pdf->pages[$templatePageIndex];
+...
+// Adiciona nova página
+$page1 = new Zend_Pdf_Page($template);
+$pdf->pages[] = $page1;
+...
+
+// Adiciona outra página
+$page2 = new Zend_Pdf_Page($template);
+$pdf->pages[] = $page2;
+...
+
+// Remove a fonte da página template dos documentos
+unset($pdf->pages[$templatePageIndex]);
+
+...
+]]></programlisting>
+        </example>
+
+        <para>
+            É útil caso você precise criar diversas páginas usando um template.
+        </para>
+
+        <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.
+            </para>
+        </caution>
+    </sect2>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -1,199 +1,238 @@
-<sect1 id="zend.pdf.info">
-    <!-- @todo review and revise upon completion of refactoring -->
-    <title>Informação do Documento e Metadados.</title>
-    <para>
-        Um documento PDF deve incluir informações gerais como o título do documento, autor, e datas de criação e modificação.
-    </para>
-    <para>
-        Historicamente essas informações são armazenadas com o uso de estruturas especiais. Esta estrutura está
-        disponível para leitura e escrita como um array associativo usando a propriedade pública <code>properties</code>
-        dos obejtos Zend_Pdf:
-            <programlisting role="php"><![CDATA[<?php
-$pdf = Zend_Pdf::load($pdfPath);
-
-echo $pdf->properties['Title'] . "\n";
-echo $pdf->properties['Author'] . "\n";
-
-$pdf->properties['Title'] = 'New Title.';
-$pdf->save($pdfPath);
-]]>
-            </programlisting>
-
-    </para>
-    <para>
-
-        As seguintes chaves são definidas pelo padrão PDF v1.4 (Acrobat 5):
-
-        <itemizedlist>
-            <listitem>
-                <para>
-                    <emphasis>Title</emphasis> - texto, opcional, o título do documento.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Author</emphasis> - texto, opcional, o nome da pessoa que criou o documento.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Subject</emphasis> - texto, opcional, o assunto do documento.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Keywords</emphasis> -  texto, opcional, palavras-chave associadas ao documento.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Creator</emphasis> -  texto, opcional, se o documento foi convertido para o formato PDF a
-                    partir de outro formato, o nome da aplicação (por exemplo, Adobe FrameMaker®) que criou o documento original.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Producer</emphasis> -  texto, opcional, se o documento foi convertido para o formato PDF a
-                    partir de outro formato, o nome da aplicação (por exemplo, Adobe Distiller®) que converteu o converteu.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>CreationDate</emphasis> -  texto, opcional, a data e a hora na qual o documento foi criado, na seguinte forma:
-                    "D:YYYYMMDDHHmmSSOHH'mm'", onde:
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <emphasis>YYYY</emphasis> é o ano.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>MM</emphasis> é o mês.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>DD</emphasis> é o dia (01–31).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>HH</emphasis> é a hora (00–23).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>mm</emphasis> é o minuto(00–59).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>SS</emphasis> é o segundo (00–59).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>O</emphasis> é a relação da hora local com a hora Universal(UT),
-                                denotada pelos caracteres +, −, ou Z (veja abaixo).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>HH</emphasis> seguido por ' é o valor absoluto da diferença da hora Universal
-                                em horas (00–23).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>mm</emphasis>  seguido por ' é o valor absoluto da diferença da hora Universal
-                                em minutos (00–59).
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                    O apóstrofo (') depois do HH e do  mm é parte da sintaxe. Todos os campos depois do ano
-                    são opcionais . (O préfixo D:, embora também seja opcional, é fortemente recomendado.)
-                    Os valores padrões para MM e DD são, para ambos, 01; todos os outros campos numéricos
-                    têm valor padrão zero. Um sinal positivo(+) no valor de um campo significa que a hora local
-                    é mais tarde que a hora Universal, e um sinal negativo(−) indica que é mais cedo. A letra Z
-                    indica que a hora é igual a hora Universal. Se nenhuma informação for específicada, a relação
-                    da hora com a hora Universal é considerada desconhecida. Sendo ou não conhecido o fuso
-                    horário, o resto da data deve ser especificado em "local time".
-                </para>
-                <para>
-                    Por exemplo, 23 de Dezembro de 1998, 7:52 da noite, U.S. Pacific Standard Time, é
-                    representado pela string "D:199812231952−08'00'".
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>ModDate</emphasis> - texto, opcional, a data e a hora da atualização mais recente no
-                    documento, na mesma forma de <emphasis>CreationDate</emphasis>.
-                </para>
-            </listitem>
-            <listitem>
-                <para>
-                    <emphasis>Trapped</emphasis> - boolean, opcional, indica se o documento foi modificado para a
-                    inclusão de informações "trapped".
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <emphasis>true</emphasis> - The document has been fully trapped; no further trapping is needed.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>false</emphasis> - The document has not yet been trapped; any desired trapping must still be done.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <emphasis>null</emphasis> - Either it is unknown whether the document has been
-                                trapped or it has been partly but not yet fully trapped; some
-                                additional trapping may still be needed.
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                </para>
-            </listitem>
-        </itemizedlist>
-    </para>
-
-    <para>
-        Desde a versão de PDF v 1.6 os metadados podem ser armazenados no documento XML especial anexado
-        ao documento PDF
-        (XMP - <ulink url="http://www.adobe.com/products/xmp/">Extensible Metadata Platform</ulink>).
-    </para>
-
-    <para>
-        Este documento XML pode ser recuperado e anexado ao PDF com os métodos <code>Zend_Pdf::getMetadata()</code> e
-        <code>Zend_Pdf::setMetadata($metadata)</code>:
-            <programlisting role="php"><![CDATA[<?php
-$pdf = Zend_Pdf::load($pdfPath);
-$metadata = $pdf->getMetadata();
-$metadataDOM = new DOMDocument();
-$metadataDOM->loadXML($metadata);
-
-$xpath = new DOMXPath($metadataDOM);
-$pdfPreffixNamespaceURI = $xpath->query('/rdf:RDF/rdf:Description')->item(0)->lookupNamespaceURI('pdf');
-$xpath->registerNamespace('pdf', $pdfPreffixNamespaceURI);
-
-$titleNode = $xpath->query('/rdf:RDF/rdf:Description/pdf:Title')->item(0);
-$title = $titleNode->nodeValue;
-...
-
-$titleNode->nodeValue = 'New title';
-$pdf->setMetadata($metadataDOM->saveXML());
-$pdf->save($pdfPath);
-]]>
-            </programlisting>
-    </para>
-
-    <para>
-        Propriedades comuns são duplicadas na estrutura Info e nos Metadados do documento (se presente).
-        Agora é responsabilidade  da aplicação do usuário mantê-los sincronizados.
-    </para>
-</sect1>
-<!--
-vim:se ts=4 sw=4 et:
--->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20872 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.pdf.info">
+    <!-- @todo review and revise upon completion of refactoring -->
+    <title>Informação do Documento e Metadados</title>
+
+    <para>
+        Um documento <acronym>PDF</acronym> deve incluir informações gerais como o título do
+        documento, autor, e datas de criação e modificação.
+    </para>
+
+    <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>:
+
+        <programlisting language="php"><![CDATA[
+$pdf = Zend_Pdf::load($pdfPath);
+
+echo $pdf->properties['Title'] . "\n";
+echo $pdf->properties['Author'] . "\n";
+
+$pdf->properties['Title'] = 'Novo Título.';
+$pdf->save($pdfPath);
+]]></programlisting>
+    </para>
+
+    <para>
+        As seguintes chaves são definidas pelo padrão <acronym>PDF</acronym> v1.4 (Acrobat 5):
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Title</emphasis> - string, opcional, o título do documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Author</emphasis> - string, opcional, o nome da pessoa que criou o
+                    documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Subject</emphasis> - string, opcional, o assunto do documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Keywords</emphasis> - string, opcional, palavras-chave associadas ao
+                    documento.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Creator</emphasis> - string, opcional, se o documento foi convertido
+                    para <acronym>PDF</acronym> a partir de outro formato, o nome da aplicação (por
+                    exemplo, Adobe FrameMaker®) que criou o documento original.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Producer</emphasis> - string, opcional, se o documento foi convertido
+                    para <acronym>PDF</acronym> a partir de outro formato, o nome da aplicação (por
+                    exemplo, Acrobat Distiller) que o converteu para <acronym>PDF</acronym>.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>CreationDate</emphasis> - string, opcional, a data e a hora na qual o
+                    documento foi criado, na seguinte forma: "D:YYYYMMDDHHmmSSOHH'mm'", onde:
+
+                    <itemizedlist>
+                        <listitem>
+                            <para>
+                                <emphasis>YYYY</emphasis> é o ano.
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>MM</emphasis> é o mês.
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>DD</emphasis> é o dia (01–31).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>HH</emphasis> é a hora (00–23).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>mm</emphasis> é o minuto (00–59).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>SS</emphasis> é o segundo (00–59).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>O</emphasis> é a relação da hora local com a Hora
+                                Universal (UT), denotada por um dos caracteres +, −, ou Z (veja
+                                abaixo).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>HH</emphasis> seguido por ' é o valor absoluto da
+                                diferença da Hora Universal em horas (00–23).
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis>mm</emphasis> seguido por ' é o valor absoluto da
+                                diferença da Hora Universal em minutos (00–59).
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+
+                    O apóstrofo (') depois do HH e do mm é parte da sintaxe. Todos os campos depois
+                    do ano são opcionais. (O prefixo D:, embora também seja opcional, é fortemente
+                    recomendado.) Os valores padrões para MM e DD são, para ambos, 01; todos os
+                    outros campos numéricos têm valor padrão zero. Um sinal positivo (+) no valor de
+                    um campo significa que a hora local é mais tarde que a Hora Universal, e um
+                    sinal negativo (−) indica que é mais cedo, e a letra Z indica que a hora é igual
+                    à Hora Universal. Se nenhuma informação sobre à Hora Universal for específicada,
+                    a relação da hora com a Hora Universal é considerada desconhecida. Sendo ou não
+                    conhecido o fuso horário, o resto da data deve ser especificado na hora local.
+                </para>
+
+                <para>
+                    Por exemplo, 23 de Dezembro de 1998, 7:52 da noite, U.S. Pacific Standard Time,
+                    é representado pela string "D:199812231952−08'00'".
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>ModDate</emphasis> - string, opcional, a data e a hora da atualização
+                    mais recente no documento, na mesma forma de <emphasis>CreationDate</emphasis>.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Trapped</emphasis> - booleano, opcional, indica se o documento foi
+                    modificado para a inclusão de informações "trapped".
+
+                    <itemizedlist>
+                        <listitem>
+                            <para>
+                                <emphasis><constant>TRUE</constant></emphasis> - The document has
+                                been fully trapped; no further trapping is needed.
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis><constant>FALSE</constant></emphasis> - The document has
+                                not yet been trapped; any desired trapping must still be done.
+                            </para>
+                        </listitem>
+
+                        <listitem>
+                            <para>
+                                <emphasis><constant>NULL</constant></emphasis> - Either it is
+                                unknown whether the document has been trapped or it has been partly
+                                but not yet fully trapped; some additional trapping may still be
+                                needed.
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+                </para>
+            </listitem>
+        </itemizedlist>
+    </para>
+
+    <para>
+        Desde a versão 1.6 do <acronym>PDF</acronym>, os metadados podem ser armazenados em um
+        documento <acronym>XML</acronym> especial anexado ao <acronym>PDF</acronym> (XMP - <ulink
+            url="http://www.adobe.com/products/xmp/">Extensible Metadata Platform</ulink>).
+    </para>
+
+    <para>
+        Este documento XML pode ser recuperado e anexado ao PDF com os métodos
+        <methodname>Zend_Pdf::getMetadata()</methodname> e
+        <methodname>Zend_Pdf::setMetadata($metadata)</methodname>:
+
+        <programlisting language="php"><![CDATA[
+$pdf = Zend_Pdf::load($pdfPath);
+$metadata = $pdf->getMetadata();
+$metadataDOM = new DOMDocument();
+$metadataDOM->loadXML($metadata);
+
+$xpath = new DOMXPath($metadataDOM);
+$pdfPreffixNamespaceURI = $xpath->query('/rdf:RDF/rdf:Description')
+                                ->item(0)
+                                ->lookupNamespaceURI('pdf');
+$xpath->registerNamespace('pdf', $pdfPreffixNamespaceURI);
+
+$titleNode = $xpath->query('/rdf:RDF/rdf:Description/pdf:Title')->item(0);
+$title = $titleNode->nodeValue;
+...
+
+$titleNode->nodeValue = 'Novo título';
+$pdf->setMetadata($metadataDOM->saveXML());
+$pdf->save($pdfPath);
+]]></programlisting>
+    </para>
+
+    <para>
+        Propriedades comuns são duplicadas na estrutura Info e nos Metadados do documento (se
+        presente). Agora é responsabilidade da aplicação do usuário mantê-los sincronizados.
+    </para>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -1,40 +1,48 @@
-<sect1 id="zend.pdf.save">
-    <title>Salvar mudanças no documento PDF.</title>
-    <para>
-    Existem dois métodos que fornecem a persistência para mudanças feitas no documento PDF. Eles são os métodos
-    <code>Zend_Pdf::save()</code>e o <code>Zend_Pdf::render()</code>.
-    </para>
-
-    <para>
-    O <code>Zend_Pdf::save($filename, $updateOnly = false)</code> salva do documento PDF em um arquivo. Se o argumento $updateOnly
-    for verdadeiro, então apenas os novos segmentos do PDF serão acrescentados ao arquivo. De outra forma, o arquivo é sobrescrito.
-    </para>
-
-    <para>
-    O <code>Zend_Pdf::render($newSegmentOnly = false)</code> retorna o documento PDF como um texto(string). Se
-    $newSegmentOnly for verdadeiro, então apenas os novos segmentos do PDF serão retornados.
-    </para>
-
-    <example id="zend.pdf.save.example-1">
-        <title>Salvar um documento PDF.</title>
-        <programlisting role="php"><![CDATA[<?php
-...
-// Load PDF document.
-$pdf = Zend_Pdf::load($fileName);
-...
-// Update document
-$pdf->save($fileName, true);
-// Save document as a new file
-$pdf->save($newFileName);
-
-// Return PDF document as a string.
-$pdfString = $pdf->render();
-
-...]]>
-        </programlisting>
-    </example>
-
-</sect1>
-<!--
-vim:se ts=4 sw=4 et:
--->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20854 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.pdf.save">
+    <title>Salvar Mudanças em Documentos PDF</title>
+
+    <para>
+        Existem dois métodos que salvam as mudanças feitas em documentos <acronym>PDF</acronym>: os
+        métodos <methodname>Zend_Pdf::save()</methodname> e
+        <methodname>Zend_Pdf::render()</methodname>.
+    </para>
+
+    <para>
+        <methodname>Zend_Pdf::save($filename, $updateOnly = false)</methodname> salva o documento
+        <acronym>PDF</acronym> em um arquivo. Se $updateOnly for
+        <constant>TRUE</constant>, então apenas o novo segmento do arquivo <acronym>PDF</acronym>
+        será acrescentado ao arquivo. De outra forma, o arquivo é sobrescrito.
+    </para>
+
+    <para>
+        <methodname>Zend_Pdf::render($newSegmentOnly = false)</methodname> retorna o documento
+        <acronym>PDF</acronym> como uma string. Se $newSegmentOnly for <constant>TRUE</constant>,
+        então apenas o novo segmento do arquivo <acronym>PDF</acronym> será retornado.
+    </para>
+
+    <example id="zend.pdf.save.example-1">
+        <title>Salvando Documentos PDF</title>
+
+        <programlisting language="php"><![CDATA[
+...
+// Carrega o documento PDF
+$pdf = Zend_Pdf::load($fileName);
+...
+// Atualiza o documento PDF
+$pdf->save($fileName, true);
+// Salva o documento como um novo arquivo
+$pdf->save($newFileName);
+
+// Retorna o documento PDF como uma string
+$pdfString = $pdf->render();
+
+...
+]]></programlisting>
+    </example>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->