gtk-doc help - en to pt_BR translation catalogue (446 entries)

note: (itstool) path: bookinfo/title
en: GTK-Doc Manual
pt_BR: Manual do GTK-Doc

note: (itstool) path: abstract/para
en: User manual for developers with instructions of GTK-Doc usage.
pt_BR: Manual de usuário para desenvolvedores com instruções do uso do GTK-Doc.

note: (itstool) path: publisher/publishername
en: GTK-Doc project
pt_BR: Projeto GTK-Doc

note: (itstool) path: bookinfo/copyright
en: <year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>
pt_BR: <year>2000, 2005</year> <holder>Dan Mueth e Chris Lyttle</holder>

note: (itstool) path: legalnotice/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the <citetitle>GNU Free Documentation License</citetitle>, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is <link linkend="fdl">included</link>.
pt_BR: Permissão concedida para copiar, distribuir e/ou modificar este documento sob os termos da <citetitle>Licença de Documentação Livre GNU</citetitle> (GNU Free Documentation License), Versão 1.1 ou qualquer versão mais recente publicada pela Free Software Foundation; sem Seções Invariantes, Textos de Capa Frontal, e sem Textos de Contracapa. Você pode encontrar uma cópia da licença está <link linkend="fdl">inclusa</link>.

note: (itstool) path: legalnotice/para
en: Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.
pt_BR: Muitos dos nomes usados por empresas para distinguir seus produtos e serviços são reivindicados como marcas registradas. Onde esses nomes aparecem em qualquer documentação do GNOME e os membros do Projeto de Documentação do GNOME estiverem cientes dessas marcas registradas, os nomes aparecerão impressos em letras maiúsculas ou com iniciais em maiúsculas.

note: (itstool) path: revhistory/revision
en: <revnumber>1.26.1</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>development</revremark>
pt_BR: <revnumber>1.26.1</revnumber> <date>11 Agosto 2017</date> <authorinitials>ss</authorinitials> <revremark>desenvolvimento</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>port all tools from perl/bash to python</revremark>
pt_BR: <revnumber>1.26</revnumber> <date>11 Agosto 2017</date> <authorinitials>ss</authorinitials> <revremark>portadas todas ferramentas de perl/bash para Python</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, test cleanups</revremark>
pt_BR: <revnumber>1.25</revnumber> <date>21 Março 2016</date> <authorinitials>ss</authorinitials> <revremark>correção de erros, limpezas de testes</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
pt_BR: <revnumber>1.24</revnumber> <date>29 Maio 2015</date> <authorinitials>ss</authorinitials> <revremark>correção de erros</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
pt_BR: <revnumber>1.23</revnumber> <date>17 Maio 2015</date> <authorinitials>ss</authorinitials> <revremark>correção de erros</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
pt_BR: <revnumber>1.22</revnumber> <date>07 Maio 2015</date> <authorinitials>ss</authorinitials> <revremark>correção de erros, desativadas funcionalidades obsoletas</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
pt_BR: <revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>correção de erros, desativadas funcionalidades obsoletas</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, markdown support, style improvements</revremark>
pt_BR: <revnumber>1.20</revnumber> <date>14 Fev 2014</date> <authorinitials>ss</authorinitials> <revremark>correção de erros, suporte a markdown, melhorias no estilo</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>
pt_BR: <revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>correção de erros</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>
pt_BR: <revnumber>1.18</revnumber> <date>14 Set 2011</date> <authorinitials>ss</authorinitials> <revremark>correção de erros, aceleração, suporte a markdown</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</authorinitials> <revremark>urgent bug fix update</revremark>
pt_BR: <revnumber>1.17</revnumber> <date>26 Fev 2011</date> <authorinitials>sk</authorinitials> <revremark>atualização de correção de erro urgente</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</authorinitials> <revremark>bugfixes, layout improvements</revremark>
pt_BR: <revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</authorinitials> <revremark>correção de erros, melhorias no layout</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</authorinitials> <revremark>bug and regression fixes</revremark>
pt_BR: <revnumber>1.15</revnumber> <date>21 Maio 2010</date> <authorinitials>sk</authorinitials> <revremark>correção de erros e regressões</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</authorinitials> <revremark>bugfixes and performance improvements</revremark>
pt_BR: <revnumber>1.14</revnumber> <date>28 Mar 2010</date> <authorinitials>sk</authorinitials> <revremark>Correção de erro e melhorias na performance</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.13</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>broken tarball update</revremark>
pt_BR: <revnumber>1.13</revnumber> <date>18 Dez 2009</date> <authorinitials>sk</authorinitials> <revremark>atualização de tarball defeituoso</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.12</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>new tool features and bugfixes</revremark>
pt_BR: <revnumber>1.12</revnumber> <date>18 Dez 2009</date> <authorinitials>sk</authorinitials> <revremark>novas funcionalidades da ferramenta e correção de erros</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.11</revnumber> <date>16 November 2008</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</revremark>
pt_BR: <revnumber>1.11</revnumber> <date>16 Nov 2008</date> <authorinitials>mal</authorinitials> <revremark>migração do GNOME doc-utils</revremark>

note: (itstool) path: chapter/title
en: Introduction
pt_BR: Introdução

note: (itstool) path: chapter/para
en: This chapter introduces GTK-Doc and gives an overview of what it is and how it is used.
pt_BR: Este capítulo introduz GTK-Doc e dá um visão geral do que ele é e como ele é usado.

note: (itstool) path: sect1/title
en: What is GTK-Doc?
pt_BR: O que é GTK-Doc?

note: (itstool) path: sect1/para
en: GTK-Doc is used to document C code. It is typically used to document the public API of libraries, such as the GTK+ and GNOME libraries. But it can also be used to document application code.
pt_BR: GTK-Doc é usado para documentar código C. Ele é tipicamente usado para documentar a API pública das bibliotecas, como as bibliotecas do GTK+ e do GNOME. Mas ele também pode ser usado para documentar código de aplicativos.

note: (itstool) path: sect1/title
en: How Does GTK-Doc Work?
pt_BR: Como o GTK-Doc funciona?

note: (itstool) path: sect1/para
en: GTK-Doc works by using documentation of functions placed inside the source files in specially-formatted comment blocks, or documentation added to the template files which GTK-Doc uses (though note that GTK-Doc will only document functions that are declared in header files; it won't produce output for static functions).
pt_BR: O GTK-Doc funciona usando a documentação de funções colocadas dentro dos arquivos fonte em blocos de comentários especialmente formatados ou documentação adicionada aos arquivos modelo que o GTK-Doc usa (apesar disso, note que o GTK-Doc vai documentar apenas funções que são declaradas em arquivos de cabeçalho; ele não irá produzir saída para funções estáticas).

note: (itstool) path: sect1/para
en: GTK-Doc consists of a number of python scripts, each performing a different step in the process.
pt_BR: GTK-Doc consiste de um número de scripts em Python, cada um executando uma etapa diferente no processo.

note: (itstool) path: sect1/para
en: There are 5 main steps in the process:
pt_BR: Há 5 etapas principais no processo:

note: (itstool) path: listitem/para
en: <guilabel>Writing the documentation.</guilabel> The author fills in the source files with the documentation for each function, macro, union etc. (In the past information was entered in generated template files, which is not recommended anymore).
pt_BR: <guilabel>Escrevendo a documentação.</guilabel> O autor preenche os arquivos fonte com a documentação para cada função, macro, union, etc. (Anteriormente, a informação era inserida em arquivos de modelo gerados, o que não é mais recomendado).

note: (itstool) path: listitem/para
en: <guilabel>Gathering information about the code.</guilabel> <application>gtkdoc-scan</application> scans the header files of the code looking for declarations of functions, macros, enums, structs, and unions. It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> containing a list of the declarations, placing them into sections according to which header file they are in. On the first run this file is copied to <filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange the sections, and the order of the declarations within them, to produce the final desired order. The second file it generates is <filename>&lt;module&gt;-decl.txt</filename>. This file contains the full declarations found by the scanner. If for some reason one would like some symbols to show up in the docs, where the full declaration cannot be found by the scanner or the declaration should appear differently, one can place entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;module&gt;-overrides.txt</filename>.
pt_BR: <guilabel>Juntando informação sobre o código.</guilabel> <application>gtkdoc-scan</application> varre os arquivos de cabeçalho do código buscando por declarações de funções, macros, enums, structs e unions. Ele cria o arquivo <filename>&lt;módulo&gt;-decl-list.txt</filename> contendo uma lista de declarações, inserindo-as em seções da acordo com o arquivo de cabeçalho no qual se encontram. Na primeira execução, este arquivo é copiado para <filename>&lt;módulo&gt;-sections.txt</filename>. O autor pode reorganizar as seções, e a ordem das declarações dentro delas, para produzir a ordem final desejada. O segundo arquivo que ele gera é <filename>&lt;módulo&gt;-decl.txt</filename>. Este arquivo contém as declarações completas encontradas pela varredura. Se por algum motivo se queira que alguns apareçam nos documentos, no qual declarações completas não puderam ser encontradas pela varredura ou a declaração deveria aparecer de outra forma, pode-se colocar entidades similares aos do <filename>&lt;módulo&gt;-decl.txt</filename> no <filename>&lt;módulo&gt;-overrides.txt</filename>.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scangobj</application> can also be used to dynamically query a library about any GObject subclasses it exports. It saves information about each object's position in the class hierarchy and about any GObject properties and signals it provides.
pt_BR: <application>gtkdoc-scangobj</application> também pode ser usado para consultar dinamicamente uma biblioteca sobre qualquer subclasse GObject que ele exporta. Ele salva informações sobre cada posição do objeto na hierarquia de classe e sobre quaisquer propriedades GObject e sinais que ela fornece.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scanobj</application> should not be used anymore. It was needed in the past when GObject was still GtkObject inside gtk+.
pt_BR: <application>gtkdoc-scanobj</application> não deveria mais ser usada. Ele era necessário no passado, quando GObject ainda era GtkObject dentro do gtk+.

note: (itstool) path: listitem/para
en: <guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-mkdb</application> turns the template files into XML files in the <filename class="directory">xml/</filename> subdirectory. If the source code contains documentation on functions, using the special comment blocks, it gets merged in here. If there are no tmpl files used it only reads docs from sources and introspection data.
pt_BR: <guilabel>Gerando o XML e HTML/PDF.</guilabel> <application>gtkdoc-mkdb</application> transforma os arquivos modelos em arquivos XML no subdiretório <filename class="directory">xml/</filename>. Se o código fonte contém documentação nas funções, usando os blocos de comentários especiais, ela é mesclada aqui. Se não há arquivos tmpl sendo usados, ele apenas lê documentos dos dados de introspecção e dos fontes.

note: (itstool) path: listitem/para
en: <application>gtkdoc-mkhtml</application> turns the XML files into HTML files in the <filename class="directory">html/</filename> subdirectory. Likewise <application>gtkdoc-mkpdf</application> turns the XML files into a PDF document called <filename>&lt;package&gt;.pdf</filename>.
pt_BR: <application>gtkdoc-mkhtml</application> transforma os arquivos XML em arquivos HTML no subdiretório <filename class="directory">html/</filename>. Da mesma forma, <application>gtkdoc-mkpdf</application> transforma os arquivos XML em um documento PDF chamado <filename>&lt;pacote&gt;.pdf</filename>.

note: (itstool) path: listitem/para
en: Files in <filename class="directory">xml/</filename> and <filename class="directory">html/</filename> directories are always overwritten. One should never edit them directly.
pt_BR: Arquivos nos diretórios <filename class="directory">xml/</filename> e <filename class="directory">html/</filename> são sempre sobrescritos. Não devem ser editados manualmente.

note: (itstool) path: listitem/para
en: <guilabel>Fixing up cross-references between documents.</guilabel> After installing the HTML files, <application>gtkdoc-fixxref</application> can be run to fix up any cross-references between separate documents. For example, the GTK+ documentation contains many cross-references to types documented in the GLib manual. When creating the source tarball for distribution, <application>gtkdoc-rebase</application> turns all external links into web-links. When installing distributed (pregenerated) docs the same application will try to turn links back to local links (where those docs are installed).
pt_BR: <guilabel>Consertando referências cruzadas entre documentos.</guilabel> Após a instalação dos arquivos HTML, <application>gtkdoc-fixxref</application> pode ser executado para consertar referências cruzadas entre documentos separados. Por exemplo, a documentação do GTK+ contém muitas referências cruzadas a tipos documentados no manual do GLib. Ao criar um tarball fonte para distribuição, <application>gtkdoc-rebase</application> transforma todos os links externos em web-links. Ao instalar documentações distribuídas (geradas previamente), o mesmo aplicativo vai tentar transformar links de volta para links locais (onde aquelas documentações estão instaladas).

note: (itstool) path: sect1/title
en: Getting GTK-Doc
pt_BR: Obtendo GTK-Doc

note: (itstool) path: sect2/title
en: Requirements
pt_BR: Requisitos

note: (itstool) path: sect2/para
en: <guilabel>python 2/3</guilabel> - the main scripts are written in python.
pt_BR: <guilabel>python 2/3</guilabel> - os scripts principais são escritos em Python.

note: (itstool) path: sect2/para
en: <guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="http://xmlsoft.org/XSLT/" type="http">xmlsoft.org/XSLT/</ulink>
pt_BR: <guilabel>xsltproc</guilabel> - o processador de xslt do libxslt <ulink url="http://xmlsoft.org/XSLT/" type="http">xmlsoft.org/XSLT/</ulink>

note: (itstool) path: sect2/para
en: <guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="http://sourceforge.net/projects/docbook/files/docbook-xsl/" type="http">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>
pt_BR: <guilabel>docbook-xsl</guilabel> - as folhas de estilo xsl de docbook <ulink url="http://sourceforge.net/projects/docbook/files/docbook-xsl/" type="http">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>

note: (itstool) path: sect2/para
en: One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> or <guilabel>vim</guilabel> - optional - used for syntax highlighting of examples
pt_BR: Um dentre <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> ou <guilabel>vim</guilabel> - opcional - usado para destaque de sintaxe de exemplos

note: (itstool) path: sect1/title
en: About GTK-Doc
pt_BR: Sobre GTK-Doc

note: (itstool) path: sect1/para
en: (FIXME)
pt_BR: (CORRIJA-ME)

note: (itstool) path: sect1/para
en: (History, authors, web pages, mailing list, license, future plans, comparison with other similar systems.)
pt_BR: (História, autores, páginas web, lista de discussão, licença, planos futuros, comparação com outros sistemas similares.)

note: (itstool) path: sect1/title
en: About this Manual
pt_BR: Sobre este manual

note: (itstool) path: sect1/para
en: (who it is meant for, where you can get it, license)
pt_BR: (pra quem ele serve, onde você pode obtê-lo, licença)

note: (itstool) path: chapter/title
en: Setting up your project
pt_BR: Preparando seu projeto

note: (itstool) path: chapter/para
en: The next sections describe what steps to perform to integrate GTK-Doc into your project. Theses sections assume we work on a project called 'meep'. This project contains a library called 'libmeep' and an end-user app called 'meeper'. We also assume you will be using autoconf and automake. In addition section <link linkend="plain_makefiles">plain makefiles or other build systems</link> will describe the basics needed to work in a different build setup.
pt_BR: As próximas seções descrevem quais as etapas para realizar a integração do GTK-Doc em seu projeto. Estas seções consideram que nós trabalhamos em um projeto chamado “meep”. Este projeto contém uma biblioteca chamada “libmeep” e um aplicativo para usuário final chamado “meeper”. Nós também consideramos que você estará usando autoconf e automake. Além disso, a seção sobre <link linkend="plain_makefiles">makefiles simples ou outros sistemas de compilação</link> vai descrever as necessidades básicas para trabalhar em uma configuração de compilação diferente.

note: (itstool) path: sect1/title
en: Setting up a skeleton documentation
pt_BR: Preparando o esqueleto de uma documentação

note: (itstool) path: sect1/para
en: Under your top-level project directory create folders called docs/reference (this way you can also have docs/help for end-user documentation). It is recommended to create another subdirectory with the name of the doc-package. For packages with just one library this step is not necessary.
pt_BR: No diretório raiz do seu projeto, crie pastas chamadas docs/reference (desta forma, você também pode ter docs/help para documentação para usuário final). É recomendado criar um outro subdiretório com o nome do pacote de documentação. Para pacotes com apenas uma biblioteca, esta etapa não é obrigatória.

note: (itstool) path: example/title
en: Example directory structure
pt_BR: Exemplo de estrutura de diretórios

note: (itstool) path: sect1/para
en: This can then look as shown below: <_:example-1/>
pt_BR: Isto pode, então, parecer como exibido abaixo: <_:example-1/>

note: (itstool) path: sect1/title (itstool) path: example/title
en: Integration with autoconf
pt_BR: Integração com autoconf

note: (itstool) path: sect1/para
en: Very easy! Just add one line to your <filename>configure.ac</filename> script.
pt_BR: Muito fácil! Basta adicionar uma linha ao seu script <filename>configure.ac</filename>.

note: (itstool) path: example/programlisting
en: 
    # check for gtk-doc
    GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
pt_BR: 
    # verifica por gtk-doc
    GTK_DOC_CHECK([1.14],[--flavour no-tmpl])

note: (itstool) path: example/title
en: Keep gtk-doc optional
pt_BR: Mantenha o gtk-doc como opcional

note: (itstool) path: example/programlisting
en: 
    # check for gtk-doc
    m4_ifdef([GTK_DOC_CHECK], [
    GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
    ],[
    AM_CONDITIONAL([ENABLE_GTK_DOC], false)
    ])
pt_BR: 
    # verifica por gtk-doc
    m4_ifdef([GTK_DOC_CHECK], [
    GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
    ],[
    AM_CONDITIONAL([ENABLE_GTK_DOC], false)
    ])

note: (itstool) path: sect1/para
en: This will require all developers to have gtk-doc installed. If it is okay for your project to have optional api-doc build setup, you can solve this as below. Keep it as is, as gtkdocize is looking for <function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>
pt_BR: Isso vai exigir que todos os desenvolvedores tenham o gtk-doc instalado. Se não houver problema para seu projeto ter uma configuração opcional de compilação de documentação de API, você pode resolver isso como mostrado abaixo. Mantenha assim, pois o gtkdocize está procurando por <function>GTK_DOC_CHECK</function> no começo de uma linha. <_:example-1/>

note: (itstool) path: sect1/para
en: The first argument is used to check for the gtkdocversion at configure time. The 2nd, optional argument is used by <application>gtkdocize</application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure switches:
pt_BR: O primeiro argumento é usado para verificar a gtkdocversion em tempo de compilação. O segundo argumento é opcional, sendo usado por <application>gtkdocize</application>. A macro <symbol>GTK_DOC_CHECK</symbol> também adiciona várias opções de configuração:

note: (itstool) path: listitem/para
en: --with-html-dir=PATH : path to installed docs
pt_BR: --with-html-dir=CAMINHO : caminho para as documentações instaladas

note: (itstool) path: listitem/para
en: --enable-gtk-doc : use gtk-doc to build documentation [default=no]
pt_BR: --enable-gtk-doc : usa gtk-doc para compilar documentação [padrão=no]

note: (itstool) path: listitem/para
en: --enable-gtk-doc-html : build documentation in html format [default=yes]
pt_BR: --enable-gtk-doc-html : compila documentação em formato html [padrão=sim]

note: (itstool) path: listitem/para
en: --enable-gtk-doc-pdf : build documentation in pdf format [default=no]
pt_BR: --enable-gtk-doc-pdf : compila documentação em formato pdf [padrão=não]

note: (itstool) path: important/para
en: GTK-Doc is disabled by default! Remember to pass the option <option>'--enable-gtk-doc'</option> to the next <filename>configure</filename> run. Otherwise pregenerated documentation is installed (which makes sense for users but not for developers).
pt_BR: GTK-Doc está desabilitado por padrão! Lembre-se de passar a opção <option>"--enable-gtk-doc"</option> à próxima execução do <filename>configure</filename>. Do contrário, uma documentação gerada previamente é instalada (o que faz sentido para usuários, mas não para desenvolvedores).

note: (itstool) path: sect1/para
en: Furthermore it is recommended that you have the following line inside your <filename>configure.ac</filename> script. This allows <application>gtkdocize</application> to automatically copy the macro definition for <function>GTK_DOC_CHECK</function> to your project.
pt_BR: Além disso, é recomendado que você tenha a seguinte linha dentro do seu script <filename>configure.ac</filename>. Ela permite que <application>gtkdocize</application> copie automaticamente a definição de macro para <function>GTK_DOC_CHECK</function> para o seu projeto.

note: (itstool) path: example/title
en: Preparation for gtkdocize
pt_BR: Preparação para gtkdocize

note: (itstool) path: sect1/para
en: After all changes to <filename>configure.ac</filename> are made, update the <filename>configure</filename> file. This can be done by re-running <code>autoreconf -i</code> or <code>autogen.sh</code>.
pt_BR: Após todas as alterações do <filename>configure.ac</filename> serem feitas, atualize o arquivo <filename>configure</filename>. Isso pode ser feito executando novamente <code>autoreconf -i</code> ou <code>autogen.sh</code>.

note: (itstool) path: sect1/title
en: Integration with automake
pt_BR: Integração com automake

note: (itstool) path: sect1/para
en: First copy the <filename>Makefile.am</filename> from the <filename class="directory">examples</filename> sub directory of the <ulink url="https://git.gnome.org/browse/gtk-doc/tree/examples/Makefile.am">gtkdoc-sources</ulink> to your project's API documentation directory ( <filename class="directory">./docs/reference/&lt;package&gt;</filename>). A local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If you have multiple doc-packages repeat this for each one.
pt_BR: Primeiro copie o <filename>Makefile.am</filename> dos subdiretório do <filename class="directory">exemplo</filename> do <ulink url="https://git.gnome.org/browse/gtk-doc/tree/examples/Makefile.am">gtkdoc-sources</ulink> para o diretório de documentação da API do seu projeto ( <filename class="directory">./docs/reference/&lt;pacote&gt;</filename>). Uma cópia local deveria estar disponível sob, por exemplo, <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. Se você tiver múltiplos pacotes de documentação, repita isso para cada um.

note: (itstool) path: sect1/para
en: The next step is to edit the settings inside the <filename>Makefile.am</filename>. All the settings have a comment above that describes their purpose. Most settings are extra flags passed to the respective tools. Every tool has a variable of the form <option>&lt;TOOLNAME&gt;_OPTIONS</option>. All the tools support <option>--help</option> to list the supported parameters.
pt_BR: A próxima etapa é editar as configurações dentro do <filename>Makefile.am</filename>. Todas as configurações tem um comentário em cima que descreve seu propósito. A maioria das configurações são opções extras passadas para as respectivas ferramentas. Cada ferramenta tem uma variável na forma <option>&lt;NOME-FERRAMENTA&gt;_OPTIONS</option>. Todas as ferramentas têm suporte a <option>--help</option> pra listar os parâmetros disponíveis.

note: (itstool) path: sect1/title
en: Integration with autogen
pt_BR: Integração com autogen

note: (itstool) path: sect1/para
en: Most projects will have an <filename>autogen.sh</filename> script to setup the build infrastructure after a checkout from version control system (such as cvs/svn/git). GTK-Doc comes with a tool called <application>gtkdocize</application> which can be used in such a script. It should be run before autoheader, automake or autoconf.
pt_BR: A maioria dos projetos têm um script <filename>autogen.sh</filename> para configurar a infraestrutura de compilação após baixar do sistema de controle de versão (como cvs/svn/git). GTK-Doc vêm com uma ferramenta chamada <application>gtkdocize</application> que pode ser usada em um script assim. O gtkdocize deveria ser executado antes de autoheader, automake ou autoconf.

note: (itstool) path: example/title
en: Running gtkdocize from autogen.sh
pt_BR: Executando gtkdocize no autogen.sh

note: (itstool) path: sect1/para
en: When running <application>gtkdocize</application> it copies <filename>gtk-doc.make</filename> to your project root (or any directory specified by the <option>--docdir</option> option). It also checks you configure script for the <function>GTK_DOC_CHECK</function> invocation. This macro can be used to pass extra parameters to <application>gtkdocize</application>.
pt_BR: Ao executar <application>gtkdocize</application>, ele copia <filename>gtk-doc.make</filename> para a raiz do seu projeto (ou qualquer diretório especificado pela opção <option>--docdir</option>). Ele também verifica se seu script de configuração pela chamada de <function>GTK_DOC_CHECK</function>. Esta macro pode ser usada para passar parâmetros extras para <application>gtkdocize</application>.

note: (itstool) path: sect1/para
en: Historically GTK-Doc was generating template files where developers entered the docs. This turned out to be not so good (e.g. the need for having generated files under version control). Since GTK-Doc 1.9 the tools can get all the information from source comments and thus the templates can be avoided. We encourage people to keep documentation in the code. <application>gtkdocize</application> supports now a <option>--flavour no-tmpl</option> option that chooses a makefile that skips tmpl usage totally. Besides adding the option directly to the command invocation, they can be added also to an environment variable called <symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in <symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have never changed file in tmpl by hand and migrating from older gtkdoc versions, please remove the directory (e.g. from version control system).
pt_BR: Historicamente, GTK-Doc estava gerando arquivos modelo (template) nos quais os desenvolvedores inseriam as documentações. Isso acabou sendo não tão bom (ex.: a necessidade de serem gerados arquivos sob controle de versão). Desde o GTK-Doc 1.9 as ferramentas podem obter todas as informações dos comentários no fonte e, portanto, os arquivos modelo podem ser evitados. Nós encorajamos as pessoas a manter a documentação no código. O <application>gtkdocize</application> possui agora suporte à opção <option>--flavour no-tmpl</option> que escolhe um makefile que ignora totalmente o uso de tmpl. Além de adicionar a opção diretamente à chamada do comando, elas também podem ser adicionadas a uma variável de ambiente chamada <symbol>GTKDOCIZE_FLAGS</symbol> ou definidas como um segundo parâmetro na macro <symbol>GTK_DOC_CHECK</symbol> no script configure. Se você nunca alterou um arquivo tmpl a mão e está migrando de versões antigas do gtkdoc, por favor remova o diretório (ex.: do sistema de controle de versão).

note: (itstool) path: sect1/title (itstool) path: example/title
en: Running the doc build
pt_BR: Executando a compilação da documentação

note: (itstool) path: sect1/para
en: After the previous steps it's time to run the build. First we need to rerun <filename>autogen.sh</filename>. If this script runs configure for you, then give it the <option>--enable-gtk-doc</option> option. Otherwise manually run <filename>configure</filename> with this option afterwards.
pt_BR: Após as etapas anteriores, é hora de executar a compilação. Primeiro, nós queremos executar novamente o <filename>autogen.sh</filename>. Se este script executa o configure para você, então forneça a este a opção <option>--enable-gtk-doc</option>. Do contrário, execute manualmente <filename>configure</filename> com esta opção em seguida.

note: (itstool) path: sect1/para
en: The first make run generates several additional files in the doc-directories. The important ones are: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
pt_BR: A primeira execução do make cria vários arquivos adicionais nos diretórios de documentação. Os importantes são: <filename>&lt;pacote&gt;.types</filename>, <filename>&lt;pacote&gt;-docs.xml</filename> (no passado, .sgml), <filename>&lt;pacote&gt;-sections.txt</filename>.

note: (itstool) path: sect1/para
en: Now you can point your browser to <filename>docs/reference/&lt;package&gt;/index.html</filename>. Yes, it's a bit disappointing still. But hang-on, during the next chapter we tell you how to fill the pages with life.
pt_BR: Agora você pode apontar seu navegador para <filename>docs/reference/&lt;pacote&gt;/index.html</filename>. Sim, é um pouco desapontador. Mas aguente aí, durante o próximo capítulo nós vamos dizer como você pode preencher as páginas com vida.

note: (itstool) path: sect1/title
en: Integration with version control systems
pt_BR: Integração com sistemas de controle de versão

note: (itstool) path: sect1/para
en: As a rule of thumb, it's the files you edit which should go under version control. For typical projects it's these files: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, <filename>Makefile.am</filename>.
pt_BR: Como uma regra de ouro, são aqueles arquivos que você edita que deveriam entrar no controle de versão. Para projetos normais, esses são os arquivos: <filename>&lt;pacote&gt;.types</filename>, <filename>&lt;pacote&gt;-docs.xml</filename> (no passado, .sgml), <filename>&lt;pacote&gt;-sections.txt</filename>, <filename>Makefile.am</filename>.

note: (itstool) path: sect1/para
en: Files in the <filename>xml/</filename> and <filename>html/</filename> directories should not go under version control. Neither should any of the <filename>.stamp</filename> files.
pt_BR: Arquivos nos diretórios <filename>xml/</filename> e <filename>html/</filename> não deveriam entrar no controle de versão. Da mesma forma, não deveriam entrar arquivos <filename>.stamp</filename>.

note: (itstool) path: sect1/title
en: Integration with plain makefiles or other build systems
pt_BR: Integração com makefiles simples ou outros sistemas de compilação

note: (itstool) path: sect1/para
en: In the case one does not want to use automake and therefore <filename>gtk-doc.mak</filename> one will need to call the gtkdoc tools in the right order in own makefiles (or other build tools).
pt_BR: Neste caso, não se deseja usar o automake e, portanto, <filename>gtk-doc.mak</filename>. Será necessário chamar as ferramentas do gtkdoc na ordem correta nos makefiles devidos (ou outras ferramentas de compilação).

note: (itstool) path: example/title
en: Documentation build steps
pt_BR: Etapas de compilação da documentação

note: (itstool) path: example/programlisting
en: 
    DOC_MODULE=meep
    // sources have changed
    gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;
    gtkdoc-scangobj --module=$(DOC_MODULE)
    gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;
    // xml files have changed
    mkdir html
    cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml
    gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html
pt_BR: 
    DOC_MODULE=meep
    // fontes foram alterados
    gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir=&gt;
    gtkdoc-scangobj --module=$(DOC_MODULE)
    gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;
    // arquivos xml foram alterados 
    mkdir html
    cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml
    gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html

note: (itstool) path: sect1/para
en: One will need to look at the <filename>Makefile.am</filename> and <filename>gtk-doc.mak</filename> to pick the extra options needed.
pt_BR: Será necessário olhar no <filename>Makefile.am</filename> e no <filename>gtk-doc.mak</filename> para obter as opções extras necessárias.

note: (itstool) path: sect1/title
en: Integration with CMake build systems
pt_BR: Integração com sistemas de compilação CMake

note: (itstool) path: sect1/para
en: GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). This provides a <literal>gtk_doc_add_module</literal> command that you can set in your <filename>CMakeLists.txt</filename> file.
pt_BR: GTK-Doc agora fornece um módulo <filename>GtkDocConfig.cmake</filename> (e o module <filename>GtkDocConfigVersion.cmake</filename> correspondente). Ele fornece um comando <literal>gtk_doc_add_module</literal> que você pode usar em seu arquivo <filename>CMakeLists.txt</filename>.

note: (itstool) path: example/title
en: Example of using GTK-Doc from CMake
pt_BR: Exemplo de uso do GTK-Doc no CMake

note: (itstool) path: example/programlisting
en: 
    find_package(GtkDoc 1.25 REQUIRED)
    
    # Create the doc-libmeep target.
    gtk_doc_add_module(
       libmeep ${CMAKE_SOURCE_DIR}/libmeep
          XML meep-docs.xml
          LIBRARIES libmeep
    )
    
    # Build doc-libmeep as part of the default target. Without this, you would
    # have to explicitly run something like `make doc-libmeep` to build the docs.
    add_custom_target(documentation ALL DEPENDS doc-libmeep)
    
    # Install the docs. (This assumes you're using the GNUInstallDirs CMake module
    # to set the CMAKE_INSTALL_DOCDIR variable correctly).
    install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html
            DESTINATION ${CMAKE_INSTALL_DOCDIR})
pt_BR: 
    find_package(GtkDoc 1.25 REQUIRED)
    
    # Cria o alvo doc-libmeep.
    gtk_doc_add_module(
       libmeep ${CMAKE_SOURCE_DIR}/libmeep
          XML meep-docs.xml
          LIBRARIES libmeep
    )
    
    # Compila doc-libmeep como parte do alvo padrão. Sem isso, você precisaria
    # executar explicitamente algo como `make doc-libmeep` para compilar os
    # documentos.
    add_custom_target(documentation ALL DEPENDS doc-libmeep)
    
    # Install the docs. (This assumes you're using the GNUInstallDirs CMake module
    # to set the CMAKE_INSTALL_DOCDIR variable correctly).
    install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html
            DESTINATION ${CMAKE_INSTALL_DOCDIR})

note: (itstool) path: sect1/para
en: The following example shows how to use this command. <_:example-1/>
pt_BR: O exemplo a seguir mostra como usar este comando. <_:example-1/>

note: (itstool) path: chapter/title
en: Documenting the code
pt_BR: Documentando o código

note: (itstool) path: chapter/para
en: GTK-Doc uses source code comment with a special syntax for code documentation. Further it retrieves information about your project structure from other sources. During the next section you will find all information about the syntax of the comments.
pt_BR: GTK-Doc usa comentários do código fonte com uma sintaxe especial para documentação do código. Além disso, ele obtém informações sobre a estrutura do seu projeto a partir de outros fontes. Na próxima seção, você vai descobrir todas as informações sobre a sintaxe dos comentários.

note: (itstool) path: note/title
en: Documentation placement
pt_BR: Localização da documentação

note: (itstool) path: note/para
en: In the past most documentation had to be filled into files residing inside the <filename>tmpl</filename> directory. This has the disadvantages that the information is often not updated and also that the file tend to cause conflicts with version control systems.
pt_BR: Antigamente, a maioria das documentações tinha que ser preenchida em arquivos residentes dentro do diretório <filename>tmpl</filename>. Isso tem as desvantagens das informações frequentemente não serem atualizadas e também que o arquivo tende a causar conflitos com sistemas de controle de versão.

note: (itstool) path: note/para
en: The avoid the aforementioned problems we suggest putting the documentation inside the sources. This manual will only describe this way of documenting code.
pt_BR: Para evitar os problemas mencionados a seguir nós sugerimos que a documentação seja colocada dentro das fontes. Este manual vai apenas descrever esta forma de documentar código.

note: (itstool) path: example/title
en: GTK-Doc comment block
pt_BR: Bloco de comentário do GTK-Doc

note: (itstool) path: example/programlisting
en: 
    #ifndef __GTK_DOC_IGNORE__
    /* unparseable code here */
    #endif
pt_BR: 
    #ifndef __GTK_DOC_IGNORE__
    /* código não analisável arqui */
    #endif

note: (itstool) path: chapter/para
en: The scanner can handle the majority of C headers fine. In the case of receiving warnings from the scanner that look like a special case, one can hint GTK-Doc to skip over them. <_:example-1/>
pt_BR: A varredura sabe lidar com a maioria dos cabeçalhos de C sem problemas. Caso se receba avisos (warnings) na varredura que pareça ser um caso especial, pode-se informar ao GTK-Doc para ignorá-los. <_:example-1/>

note: (itstool) path: note/title
en: Limitations
pt_BR: Limitações

note: (itstool) path: note/para
en: Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations.
pt_BR: Note que o GTK-Doc oferece suporte a <code>#ifndef(__GTK_DOC_IGNORE__)</code>, mas não a <code>#if !defined(__GTK_DOC_IGNORE__)</code> ou outras combinações.

note: (itstool) path: sect1/title
en: Documentation comments
pt_BR: Comentários de documentação

note: (itstool) path: example/programlisting
en: 
    /**
     * identifier:
     * documentation ...
     */
pt_BR: 
    /**
     * identificador:
     * documentação ...
     */

note: (itstool) path: sect1/para
en: A multiline comment that starts with an additional '*' marks a documentation block that will be processed by the GTK-Doc tools. <_:example-1/>
pt_BR: Um comentário multilinha que começa com um “*” adicional marca um bloco de documentação que será processado pelas ferramentas do GTK-Doc. <_:example-1/>

note: (itstool) path: sect1/para
en: The 'identifier' is one line with the name of the item the comment is related to. The syntax differs a little depending on the item. (TODO add table showing identifiers)
pt_BR: O “identificador” é uma linha com o nome do item ao qual o comentário está relacionado. A sintaxe difere um pouco dependendo do item.

note: (itstool) path: sect1/para
en: The 'documentation' block is also different for each symbol type. Symbol types that get parameters such as functions or macros have the parameter description first followed by a blank line (just a '*'). Afterwards follows the detailed description. All lines (outside program listings and CDATA sections) just containing a ' *' (blank-asterisk) are converted to paragraph breaks. If you don't want a paragraph break, change that into ' * ' (blank-asterisk-blank-blank). This is useful in preformatted text (code listings).
pt_BR: O bloco “documentação” também é diferente para cada tipo de símbolo. Tipos de símbolos que levam parâmetros, como funções e macros, têm a descrição de parâmetro começando com uma linha vazia (apenas com um “*”). Posteriormente, segue com a descrição detalhada. Todas as linhas (fora das listagens do programa e seções CDATA) contendo apenas um “ *” (espaço em branco e asterisco) são convertidas para quebras de parágrafos. Se você não quiser uma quebra de parágrafo, altere isso para “ * “ (espaço, asterisco, espaço e espaço). Isso é útil em textos pré-formatados (listagens de código).

note: (itstool) path: listitem/para
en: What it is: The name for a class or function can sometimes be misleading for people coming from a different background.
pt_BR: O que é: O nome de uma classe ou função pode, em alguns casos, levar a um entendimento equivocado pessoas com experiências diferentes.

note: (itstool) path: listitem/para
en: What it does: Tell about common uses. Put it in relation with the other API.
pt_BR: O que isso faz: Fale sobre usos comuns. Coloque em relação com a outra API.

note: (itstool) path: tip/para
en: When documenting code, describe two aspects: <_:itemizedlist-1/>
pt_BR: Ao documentar um código, descreva dois aspectos: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: Use function() to refer to functions or macros which take arguments.
pt_BR: Use function() para referir às funções ou macros que levam argumentos.

note: (itstool) path: listitem/para
en: Use @param to refer to parameters. Also use this when referring to parameters of other functions, related to the one being described.
pt_BR: Use @param para se referir a parâmetros. Também, use isso ao se referir a parâmetros de outras funções, relacionadas àquele sendo descrito.

note: (itstool) path: listitem/para
en: Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS.
pt_BR: Use %constant para se referir a uma constante, ex.: %G_TRAVERSE_LEAFS.

note: (itstool) path: listitem/para
en: Use #symbol to refer to other types of symbol, e.g. structs and enums and macros which don't take arguments.
pt_BR: Use #symbol para se referir a outros tipos de símbolos, ex.: structs, enums e macros que não levam argumentos.

note: (itstool) path: listitem/para
en: Use #Object::signal to refer to a GObject signal.
pt_BR: Use #Object::signal para se referir a um sinal de GObject.

note: (itstool) path: listitem/para
en: Use #Object:property to refer to a GObject property.
pt_BR: Use #Object:property para se referir a uma propriedade de GObject.

note: (itstool) path: listitem/para
en: Use #Struct.field to refer to a field inside a structure and #GObjectClass.foo_bar() to refer to a vmethod.
pt_BR: Use #Struct.field para se referir a um campo dentro de uma estrutura e #GObjectClass.foo_bar() para se referir a um vmethod.

note: (itstool) path: sect1/para
en: One advantage of hyper-text over plain-text is the ability to have links in the document. Writing the correct markup for a link can be tedious though. GTK-Doc comes to help by providing several useful abbreviations. <_:itemizedlist-1/>
pt_BR: Uma vantagem do hipertexto de texto simples é a habilidade de ter links no documento. Porém, escrever a marcação correta para cada link pode ser entediante. GTK-Doc vem para ajudar fornecendo abreviações úteis. <_:itemizedlist-1/>

note: (itstool) path: tip/para
en: If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or '#' in your documentation without GTK-Doc changing them you can use the XML entities "&amp;lt;", "&amp;gt;", "&amp;lpar;", "&amp;rpar;", "&amp;commat;", "&amp;percnt;" and "&amp;num;" respectively or escape them with a backslash '\'.
pt_BR: Se você precisar usar os caracteres especiais “&lt;”, “&gt;”, “()”, “@”, “%” ou “#” em sua documentação sem GTK-Doc alterando-os, você pode usar as entidades XML “&amp;lt;”, “&amp;gt;”, “&amp;lpar;”, “&amp;rpar;”, “&amp;commat;”, “&amp;percnt;” e “&amp;num;”, respectivamente, ou escapá-los com uma contrabarra “\”.

note: (itstool) path: sect1/para
en: DocBook can do more than just links. One can also have lists, examples, headings, and images. As of version 1.20, the preferred way is to use a subset of the basic text formatting syntax called <ulink url="http://daringfireball.net/projects/markdown/">Markdown</ulink>. On older GTK-Doc versions any documentation that includes Markdown will be rendered as is. For example, list items will appear as lines starting with a dash.
pt_BR: DocBook pode fazer mais do que apenas links. Ele também pode ter listas, exemplos, títulos e imagens. A partir da versão 1.20, a forma preferível é usar um subconjunto de sintaxe de formatação de texto básica chamada <ulink url="http://daringfireball.net/projects/markdown/">Markdown</ulink>. Em versões mais antigas do GTK-Doc, qualquer documentação que inclui Markdown será renderizada como está. Por exemplo, itens de lista aparecerão como linhas começando com um traço.

note: (itstool) path: sect1/para
en: While markdown is now preferred one can mix both. One limitation here is that one can use docbook xml within markdown, but markdown within docbook xml is not supported.
pt_BR: Enquanto markdown é agora preferível, é possível misturar ambos. Uma limitação aqui é que é possível usar docbook xml no markdown, mas não há suporte a markdown no docbook xml.

note: (itstool) path: sect1/para
en: In older GTK-Doc releases, if you need support for additional formatting, you would need to enable the usage of docbook XML tags inside doc-comments by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</filename>.
pt_BR: Em versões mais antigas do GTK-Doc, se você precisasse de suporte para formatação adicional, você precisaria de habilitar o uso de tags de XML de docbook dentro de comentários de documentação colocando <option>--xml-mode</option> (ou <option>--sgml-mode</option>) na variável <symbol>MKDB_OPTIONS</symbol> dentro de <filename>Makefile.am</filename>.

note: (itstool) path: example/title
en: GTK-Doc comment block using Markdown
pt_BR: Bloco de comentário do GTK-Doc usando Markdown

note: (itstool) path: example/programlisting
en: 
    /**
     * identifier:
     *
     * documentation paragraph ...
     *
     * # Sub Heading #
     *
     * ## Second Sub Heading
     *
     * # Sub Heading With a Link Anchor # {#heading-two}
     *
     * more documentation:
     *
     * - list item 1
     *
     *   Paragraph inside a list item.
     *
     * - list item 2
     *
     * 1. numbered list item
     *
     * 2. another numbered list item
     *
     * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)
     *
     * ![an inline image](plot-result.png)
     *
     * [A link to the heading anchor above][heading-two]
     *
     * A C-language example:
     * |[&lt;!-- language="C" --&gt;
     * GtkWidget *label = gtk_label_new ("Gorgeous!");
     * ]|
     */
pt_BR: 
    /**
     * identificador:
     *
     * parágrafo de documentação ...
     *
     * # Subtítulo #
     *
     * ## Segundo subtítulo
     *
     * # Subtítulo com um link âncora # {#titulo-dois}
     *
     * mais documentação:
     *
     * - item 1 da lista
     *
     *   Parágrafo dentro de um item de lista.
     *
     * - item 2 da lista
     *
     * 1. item numerado da lista
     *
     * 2. outro item numerado da lista
     *
     * Outro parágrafo. [Um link para o site do GNOME](http://www.gnome.org/)
     *
     * ![uma imagem embutida](plot-result.png)
     *
     * [Um link para um título acima][titulo-dois]
     *
     * Um exemplo em linguagem C:
     * |[&lt;!-- language="C" --&gt;
     * GtkWidget *label = gtk_label_new ("Esplêndido!");
     * ]|
     */

note: (itstool) path: sect1/para
en: More examples of what markdown tags are supported can be found in the <ulink url="https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown">GTK+ Documentation Markdown Syntax Reference</ulink>.
pt_BR: Mais exemplos do quais tags de markdown tags tem suporte pode ser encontrado na <ulink url="https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown">Referência de sintaxe de markdown de documentação</ulink>.

note: (itstool) path: tip/para
en: As already mentioned earlier GTK-Doc is for documenting public API. Thus one cannot write documentation for static symbols. Nevertheless it is good to comment those symbols too. This helps other to understand you code. Therefore we recommend to comment these using normal comments (without the 2nd '*' in the first line). If later the function needs to be made public, all one needs to do is to add another '*' in the comment block and insert the symbol name at the right place inside the sections file.
pt_BR: Como já mencionado anteriormente, GTK-Doc serve para documentar API pública. Portanto, não é possível escrever documentação para símbolos estáticos. Não obstante, é bom comentar estes símbolos também. Isso ajuda outros a entender seu código. Portanto, é recomendado comentá-los usando comentários normais (sem o segundo “*” na primeira linha). Se, posteriormente, a função precisar ser publicada, tudo que precisa ser feito é adicionar outro “*” no bloco de comentário e inserir o nome do símbolo no lugar correto do arquivo e seções.

note: (itstool) path: sect1/title
en: Documenting sections
pt_BR: Documentando seções

note: (itstool) path: sect1/para
en: Each section of the documentation contains information about one class or module. To introduce the component one can write a section block. The short description is also used inside the table of contents. All the @fields are optional.
pt_BR: Cada seção da documentação contém informações sobre uma classe ou um módulo. Para introduzir o componente, pode-se escrever um bloco de seção. A descrição curta também é usada dentro da tabela de conteúdo (sumário). Todos os @fields são opcionais.

note: (itstool) path: example/title
en: Section comment block
pt_BR: Bloco de comentário de sessão

note: (itstool) path: example/programlisting
en: 
    /**
     * SECTION:meepapp
     * @short_description: the application class
     * @title: Meep application
     * @section_id:
     * @see_also: #MeepSettings
     * @stability: Stable
     * @include: meep/app.h
     * @image: application.png
     *
     * The application class handles ...
     */
pt_BR: 
    /**
     * SECTION:meepapp
     * @short_description: A classe do aplicativo
     * @title: Aplicativo Meep
     * @section_id:
     * @see_also: #MeepSettings
     * @stability: Estável
     * @include: meep/app.h
     * @image: aplicativo.png
     *
     * A classe do aplicativo cuida de ...
     */

note: (itstool) path: varlistentry/term
en: SECTION:&lt;name&gt;
pt_BR: SECTION:&lt;nome&gt;

note: (itstool) path: listitem/para
en: The name links the section documentation to the respective part in the <filename>&lt;package&gt;-sections.txt</filename> file. The name given here should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections.txt</filename> file.
pt_BR: O nome vincula a documentação da seção à respectiva parte do arquivo <filename>&lt;pacote&gt;-sections.txt</filename>. O nome informado aqui deve corresponder à tag &lt;FILE&gt; no arquivo <filename>&lt;pacote&gt;-sections.txt</filename>.

note: (itstool) path: listitem/para
en: A one line description of the section, that later will appear after the links in the TOC and at the top of the section page.
pt_BR: Uma descrição de uma linha da sessão,que mais tarde aparecerá após os links no TOC (sumário) no topo da página da sessão.

note: (itstool) path: listitem/para
en: The section title defaults to &lt;name&gt; from the SECTION declaration. It can be overridden with the @title field.
pt_BR: O padrão para título de seção é &lt;nome&gt; da declaração da SECTION. Ele pode ser sobrescrito com o campo @title.

note: (itstool) path: listitem/para
en: Overrides the use of title as a section identifier. For GObjects the &lt;title&gt; is used as a section_id and for other sections it is &lt;MODULE&gt;-&lt;title&gt;.
pt_BR: Sobrescreve o uso do título como um identificador de seção. Para GObjects, o &lt;title&gt; é usado como um section_id e para outras seções ele é &lt;MÓDULO&gt;-&lt;title&gt;.

note: (itstool) path: listitem/para
en: A list of symbols that are related to this section.
pt_BR: Uma lista de símbolos que estão relacionados a esta sessão.

note: (itstool) path: listitem/para
en: Stable - The intention of a Stable interface is to enable arbitrary third parties to develop applications to these interfaces, release them, and have confidence that they will run on all minor releases of the product (after the one in which the interface was introduced, and within the same major release). Even at a major release, incompatible changes are expected to be rare, and to have strong justifications.
pt_BR: Estável - A intenção de uma interface estável é permitir terceiros arbitrários desenvolverem aplicativos para essas interfaces, lançá-los e ter a confiança de que eles vão funcionar em todos os lançamentos menores do produto (após aquele no qual a interface foi introduzida e naquele mesmo lançamento maior). Atém mesmo em um lançamento maior, espera-se que alterações incompatíveis sejam raras e que tenham fortes justificativas.

note: (itstool) path: listitem/para
en: Unstable - Unstable interfaces are experimental or transitional. They are typically used to give outside developers early access to new or rapidly changing technology, or to provide an interim solution to a problem where a more general solution is anticipated. No claims are made about either source or binary compatibility from one minor release to the next.
pt_BR: Instável - Interfaces instáveis são experimentais ou transicionais. Elas são normalmente usadas para dar a desenvolvedores externos um acesso prévio a nova tecnologia ou em rápida alteração, ou para fornecer uma solução interina para um problema que uma solução mais genérica foi antecipada. Nenhuma responsabilidade é assumida pela compatbilidade dos binários ou dos fontes de uma versão menor para a próxima.

note: (itstool) path: listitem/para
en: Private - An interface that can be used within the GNOME stack itself, but that is not documented for end-users. Such functions should only be used in specified and documented ways.
pt_BR: Privado - Uma interface que pode ser usada dentro da própria pilha do GNOME, mas que não está documentada para usuários finais. Tais funções deveriam ser usadas nas formas especificadas e documentadas.

note: (itstool) path: listitem/para
en: Internal - An interface that is internal to a module and does not require end-user documentation. Functions that are undocumented are assumed to be Internal.
pt_BR: Interna - Uma interface que é interna a um módulo e não requer documentação para o usuário final. Funções que não estão documentadas são presumidas como sendo “Interna”.

note: (itstool) path: listitem/para
en: An informal description of the stability level this API has. We recommend the use of one of these terms: <_:itemizedlist-1/>
pt_BR: Uma descrição informal do nível de estabilidade que esta API tem. Nós recomendamos o uso de um desses termos: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: The <literal>#include</literal> files to show in the section synopsis (a comma separated list), overriding the global value from the <link linkend="metafiles_sections">section file</link> or command line. This item is optional.
pt_BR: Os arquivos <literal>#include</literal> a ser mostrado na sinopse da seção (uma lista separada por vírgulas), sobrescrevendo o valor global do <link linkend="metafiles_sections">arquivo de seção</link> ou linha de comando. Este item é opcional.

note: (itstool) path: listitem/para
en: The image to display at the top of the reference page for this section. This will often be some sort of a diagram to illustrate the visual appearance of a class or a diagram of its relationship to other classes. This item is optional.
pt_BR: A imagem a ser exibida no topo da página de referência desta seção. Isso frequentemente será um tipo de diagrama para ilustrar a aparência visual de uma classe ou uma diagrama de suas relações a outras classes. Este item é opcional.

note: (itstool) path: tip/para
en: To avoid unnecessary recompilation after doc-changes put the section docs into the c-source where possible.
pt_BR: Para evitar recompilação desnecessária após alterações de documentação inseridas nas documentações de seção no fonte em C onde possível.

note: (itstool) path: sect1/title
en: Documenting symbols
pt_BR: Documentando símbolos

note: (itstool) path: sect1/para
en: Each symbol (function, macro, struct, enum, signal and property) is documented in a separate block. The block is best placed close to the definition of the symbols so that it is easy to keep them in sync. Thus functions are usually documented in the c-source and macros, structs and enums in the header file.
pt_BR: Cada símbolo (função, macro, struct, enum, signal e property) é documentado em uma bloco separado. O bloco é melhor localizado perto da definição dos símbolos, de forma que seja fácil de mantê-los em sincronia. Portanto, as funções são normalmente documentadas no fonte em C e macros, scructs e enums no arquivo de header.

note: (itstool) path: sect2/title (itstool) path: example/title
en: General tags
pt_BR: Tags gerais

note: (itstool) path: sect2/para
en: You can add versioning information to all documentation elements to tell when an API was introduced, or when it was deprecated.
pt_BR: Você pode adicionar informação sobre versionamento em todos os elementos de documentação para informar quando uma API foi introduzida ou quando ela se tornou obsoleta.

note: (itstool) path: variablelist/title
en: Versioning Tags
pt_BR: Tags de versionamento

note: (itstool) path: listitem/para
en: Description since which version of the code the API is available.
pt_BR: Descrição de desde qual versão do código a API está disponível.

note: (itstool) path: listitem/para
en: Paragraph denoting that this function should no be used anymore. The description should point the reader to the new API.
pt_BR: Parágrafo denotando que esta função deveria não mais ser usada. A descrição deveria apontar o leitor para a nova API.

note: (itstool) path: sect2/para
en: You can also add stability information to all documentation elements to indicate whether API stability is guaranteed for them for all future minor releases of the project.
pt_BR: Você também pode adicionar informação sobre estabilidade em todos os elementos de documentação para indicar se a estabilidade de uma API é garantida para eles para futuros lançamentos menores do projeto.

note: (itstool) path: sect2/para
en: The default stability level for all documentation elements can be set by passing the <option>--default-stability</option> argument to <application>gtkdoc-mkdb</application> with one of the values below.
pt_BR: O nível de estabilidade padrão para todos os elementos de documentação pode ser definido passando o argumento <option>--default-stability</option> para <application>gtkdoc-mkdb</application> com um dos balores abaixo.

note: (itstool) path: variablelist/title
en: Stability Tags
pt_BR: Tags de estabilidade

note: (itstool) path: listitem/para
en: Mark the element as stable. This is for public APIs which are guaranteed to remain stable for all future minor releases of the project.
pt_BR: Marca o elemento como estável. Isto é para APIs públicas cuja estabilidade é garantida para todos os próximos lançamentos menores do projeto.

note: (itstool) path: listitem/para
en: Mark the element as unstable. This is for public APIs which are released as a preview before being stabilised.
pt_BR: Marca o elemento como instável. Isto é para APIs públicas que são publicados como versão de desenvolvimento antes de se tornar estável.

note: (itstool) path: listitem/para
en: Mark the element as private. This is for interfaces which can be used by tightly coupled modules, but not by arbitrary third parties.
pt_BR: Marca o elemento como privado. Isto é para interfaces que podem ser usadas por um conjunto pequeno de módulos, mas não por terceiros.

note: (itstool) path: example/programlisting
en: 
    /**
     * foo_get_bar:
     * @foo: some foo
     *
     * Retrieves @foo's bar.
     *
     * Returns: @foo's bar
     *
     * Since: 2.6
     * Deprecated: 2.12: Use foo_baz_get_bar() instead.
     */
    Bar *
    foo_get_bar(Foo *foo)
    {
    ...
pt_BR: 
    /**
     * foo_get_bar:
     * @foo: Um foo
     *
     * Obtém o bar do @foo.
     *
     * Returns: bar do @foo
     *
     * Since: 2.6
     * Deprecated: 2.12: Use foo_baz_get_bar() no seu lugar.
     */
    Bar *
    foo_get_bar(Foo *foo)
    {
    ...

note: (itstool) path: sect2/title (itstool) path: example/title
en: Annotations
pt_BR: Anotações

note: (itstool) path: sect2/para
en: Documentation blocks can contain annotation-tags. These tags will be rendered with tooltips describing their meaning. The tags are used by gobject-introspection to generate language bindings. A detailed list of the supported tags can be found on <ulink url="http://live.gnome.org/GObjectIntrospection/Annotations" type="http">the wiki</ulink>.
pt_BR: Blocos de documentação podem conter tags de anotação. Essas tags serão renderizadas com dicas de ferramentas descrevendo seu significados. As tags são usadas pelo gobject-introspection para garantir associações (bindings) de linguagens. Uma lista detalhada tags aceitas podem ser encontrada <ulink url="http://live.gnome.org/GObjectIntrospection/Annotations" type="http">no wiki</ulink>.

note: (itstool) path: example/programlisting
en: 
    /**
     * foo_get_bar: (annotation)
     * @foo: (annotation): some foo
     *
     * Retrieves @foo's bar.
     *
     * Returns: (annotation): @foo's bar
     */
    ...
    /**
     * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)
     *                                    (and another annotation)
     * @foo: (annotation) (another annotation): some foo
     *
     * Sets bar on @foo.
     */
pt_BR: 
    /**
     * foo_get_bar: (anotação)
     * @foo: (anotação): algum foo
     *
     * Obtém bar do @foo.
     *
     * Returns: (anotação): bar do @foo
     */
    ...
    /**
     * foo_set_bar_using_the_frobnicator: (anotação) (outra anotação)
     *                                    (e uma outra anotação)
     * @foo: (anotação) (uma outra anotação): algum foo
     *
     * Define bar no @foo.
     */

note: (itstool) path: sect2/title (itstool) path: example/title
en: Function comment block
pt_BR: Bloco de comentário de função

note: (itstool) path: listitem/para
en: Document whether returned objects, lists, strings, etc, should be freed/unrefed/released.
pt_BR: Documente se objetos, listas, strings, etc. retornados devem ser não usados/não referenciados/liberada.

note: (itstool) path: listitem/para
en: Document whether parameters can be NULL, and what happens if they are.
pt_BR: Documente se parâmetros pode ser NULL e o que acontece se eles o forem.

note: (itstool) path: listitem/para
en: Mention interesting pre-conditions and post-conditions where appropriate.
pt_BR: Mencione pré-condições e pós-condições interessantes onde for apropriado.

note: (itstool) path: sect2/para
en: Please remember to: <_:itemizedlist-1/>
pt_BR: Por favor, lembre-se de: <_:itemizedlist-1/>

note: (itstool) path: sect2/para
en: Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. They are treated like static functions.
pt_BR: Gtk-doc presume que todos os símbolos (macros, funções) começando com “_” são privadas. Elas são tratadas como funções estáticas.

note: (itstool) path: example/programlisting
en: 
    /**
     * function_name:
     * @par1:  description of parameter 1. These can extend over more than
     * one line.
     * @par2:  description of parameter 2
     * @...: a %NULL-terminated list of bars
     *
     * The function description goes here. You can use @par1 to refer to parameters
     * so that they are highlighted in the output. You can also use %constant
     * for constants, function_name2() for functions and #GtkWidget for links to
     * other declarations (which may be documented elsewhere).
     *
     * Returns: an integer.
     *
     * Since: 2.2
     * Deprecated: 2.18: Use other_function() instead.
     */
pt_BR: 
    /**
     * nome_da_função:
     * @par1:  descrição do parâmetro 1. Esta pode se estender por mais de
     * uma linha.
     * @par2:  descrição do parâmetro 2
     * @...: uma lista de bars terminada em %NULL
     *
     * A descrição da função vai aqui. Você pode usar @par1 para se referir a parâmetros
     * de forma que eles ficam em destaque na saída. Você também pode usar %constant
     * para constantes, nome_da_função2() para funções e #GtkWidget para links para
     * outras declarações (que pode ser documentada em outro lugar).
     *
     * Returns: um inteiro.
     *
     * Since: 2.2
     * Deprecated: 2.18: Use outra_função() em seu lugar.
     */

note: (itstool) path: variablelist/title
en: Function tags
pt_BR: Tags de função

note: (itstool) path: listitem/para
en: Paragraph describing the returned result.
pt_BR: Parágrafo descrevendo o resultado retornado.

note: (itstool) path: listitem/para
en: In case the function has variadic arguments, you should use this tag (@Varargs: does also work for historic reasons).
pt_BR: No caso da função possuir argumentos variados, você deveria usar esta tag (@Varargs: também funciona por motivos de histórico).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Property comment block
pt_BR: Bloco de comentário de propriedade

note: (itstool) path: example/programlisting
en: 
    /**
     * SomeWidget:some-property:
     *
     * Here you can document a property.
     */
    g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);
pt_BR: 
    /**
     * AlgumWidget:alguma-propriedade:
     *
     * Aqui você pode documentar uma propriedade.
     */
    g_object_propriedade_install_classe (object_classe, PROP_ALGUMA_PROPRIEDADE, ...);

note: (itstool) path: sect2/title (itstool) path: example/title
en: Signal comment block
pt_BR: Bloco de comentário de sinal

note: (itstool) path: listitem/para
en: Document when the signal is emitted and whether it is emitted before or after other signals.
pt_BR: Documente quando o sinal é emitido e se ele é emitido antes ou após outros sinais.

note: (itstool) path: listitem/para
en: Document what an application might do in the signal handler.
pt_BR: Documente o que um aplicativo pode fazer no manipulador do sinal.

note: (itstool) path: example/programlisting
en: 
    /**
     * FooWidget::foobarized:
     * @widget: the widget that received the signal
     * @foo: some foo
     * @bar: some bar
     *
     * The ::foobarized signal is emitted each time someone tries to foobarize @widget.
     */
    foo_signals[FOOBARIZE] =
      g_signal_new ("foobarize",
                    ...
pt_BR: 
    /**
     * FooWidget::foobarizado:
     * @widget: o widget que recebeu o sinal
     * @foo: algum foo
     * @bar: algum bar
     *
     * O sinal ::foobarized é emitido cada vez que alguém tenta foobarizar @widget.
     */
    foo_sinais[FOOBARIZAR] =
      g_signal_novo ("foobarizar",
                    ...

note: (itstool) path: sect2/title (itstool) path: example/title
en: Struct comment block
pt_BR: Bloco de comentário de struct

note: (itstool) path: example/programlisting
en: 
    /**
     * FooWidget:
     * @bar: some #gboolean
     *
     * This is the best widget, ever.
     */
    typedef struct _FooWidget {
      GtkWidget parent_instance;
    
      gboolean bar;
    } FooWidget;
pt_BR: 
    /**
     * FooWidget:
     * @bar: algum #gboolean
     *
     * Este é o melhor widget, já mais visto.
     */
    typedef struct _FooWidget {
      GtkWidget parent_intance;
    
      gboolean bar;
    } FooWidget;

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private struct fields you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
pt_BR: Use <code>/*&lt; private &gt;*/</code> antes dos campos da struct privada que você deseja esconder. Use <code>/*&lt; public &gt;*/</code> para o comportamento inverso.

note: (itstool) path: sect2/para
en: If the first field is "g_iface", "parent_instance" or "parent_class" it will be considered private automatically and doesn't need to be mentioned in the comment block.
pt_BR: Se o primeiro campo for “g_iface”, “parent_instance” ou “parent_class”, ele será automaticamente considerado como privado e não precisará ser mencionado no bloco de comentário.

note: (itstool) path: sect2/para
en: Struct comment blocks can also be used for GObjects and GObjectClasses. It is usually a good idea to add a comment block for a class, if it has vmethods (as this is how they can be documented). For the GObject itself one can use the related section docs, having a separate block for the instance struct would be useful if the instance has public fields. One disadvantage here is that this creates two index entries of the same name (the structure and the section).
pt_BR: Blocos de comentário de struct também podem ser usados para GObjects e GObjectClasses. É normalmente uma boa ideia adicionar um bloco de comentário para uma classe, se ela possui vmethods (pois assim é como elas podem ser documentadas). Para o próprio GOBject pode-se usar os documentos de seção relacionados, tendo um bloco separado para a instância do struct seria útil se a instância possui campos públicos. Uma desvantagem aqui é que isso cria duas entradas no índice do mesmo nome (a estrutura e a seção).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Enum comment block
pt_BR: Bloco de comentário de enum

note: (itstool) path: example/programlisting
en: 
    /**
     * Something:
     * @SOMETHING_FOO: something foo
     * @SOMETHING_BAR: something bar
     *
     * Enum values used for the thing, to specify the thing.
     */
    typedef enum {
      SOMETHING_FOO,
      SOMETHING_BAR,
      /*&lt; private &gt;*/
      SOMETHING_COUNT
    } Something;
pt_BR: 
    /**
     * Alguma coisa:
     * @ALGUMACOISA_FOO: alguma coisa foo
     * @ALGUMCAOISA_BAR: alguma coisa bar
     *
     * Valores de enum usados para a coisa, para especificar a coisa.
     */
    typedef enum {
      ALGUMACOISA_FOO,
      ALGUMACOISA_BAR,
      /*&lt; private &gt;*/
      ALGUMACOISA_CONTAGEM
    } Alguma coisa;

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private enum values you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
pt_BR: Use <code>/*&lt; private &gt;*/</code> antes de valores privados de enum que você deseja ocultar. Use <code>/*&lt; public &gt;*/</code> para o comportamento inverso.

note: (itstool) path: sect1/title
en: Inline program documentation
pt_BR: Documentação de programa em-linha

note: (itstool) path: sect1/para
en: You can document programs and their commandline interface using inline documentation.
pt_BR: Você pode documentar programas e sua interface de linha de comando usando documentação em-linha.

note: (itstool) path: listitem/para
en: Defines the start of a program documentation.
pt_BR: Define o início da documentação de um programa.

note: (itstool) path: listitem/para
en: Defines a short description of the program. (Optional)
pt_BR: Define uma descrição breve do programa. (Opcional)

note: (itstool) path: listitem/para
en: Defines the arguments, or list of arguments that the program can take. (Optional)
pt_BR: Define os argumentos, ou lista de argumentos, que o programa pode receber. (Opcional)

note: (itstool) path: listitem/para
en: See Also manual page section. (Optional)
pt_BR: A seção “Veja Também” (See Also) de páginas de manual. (Opcional)

note: (itstool) path: listitem/para
en: Argument(s) passed to the program and their description. (Optional)
pt_BR: Argumento(s) passado(s) para o programa e sua descrição. (Opcional)

note: (itstool) path: listitem/para
en: A longer description of the program.
pt_BR: Um descrição mais longa do programa.

note: (itstool) path: listitem/para
en: Specificy what value(s) the program returns. (Optional)
pt_BR: Especifique quais valor(es) o programa retorna. (Opcional)

note: (itstool) path: sect2/title
en: Example of program documentation.
pt_BR: Exemplo de documentação de programa.

note: (itstool) path: example/title
en: Program documentation block
pt_BR: Bloco de documentação de programa

note: (itstool) path: example/programlisting
en: 
    /**
     * PROGRAM:test-program
     * @short_description: A test program
     * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*
     * @see_also: test(1)
     * @--arg1 *arg*: set arg1 to *arg*
     * @--arg2 *arg*: set arg2 to *arg*
     * @-v, --version: Print the version number
     * @-h, --help: Print the help message
     *
     * Long description of program.
     *
     * Returns: Zero on success, non-zero on failure
     */
    int main(int argc, char *argv[])
    {
    	return 0;
    }
pt_BR: 
    /**
     * PROGRAM:programa-teste
     * @short_description: Um programa teste
     * @synopsis: programa-teste [*OPÇÕES*...] --arg1 *arg* *ARQUIVO*
     * @see_also: teste(1)
     * @--arg1 *arg*: define arg1 para *arg*
     * @--arg2 *arg*: define arg2 para *arg*
     * @-v, --version: Exibe o número da versão
     * @-h, --help: Exibe a mensagem de ajuda
     *
     * Descrição longa do programa.
     *
     * Returns: Zero no caso de sucesso, não-zero no caso de falha
     */
    int main(int argc, char *argv[])
    {
    	return 0;
    }

note: (itstool) path: sect1/title
en: Useful DocBook tags
pt_BR: Tags úteis do DocBook

note: (itstool) path: sect1/para
en: Here are some DocBook tags which are most useful when documenting the code.
pt_BR: Aqui estão algumas tags de DocBook que são muito úteis quando se está documentado o código.

note: (itstool) path: informalexample/programlisting
en: 
    &lt;link linkend="glib-Hash-Tables"&gt;Hash Tables&lt;/link&gt;
pt_BR: 
    &lt;link linkend="glib-Hash-Tables"&gt;Tabela de hashes&lt;/link&gt;

note: (itstool) path: sect1/para
en: To link to another section in the GTK docs: <_:informalexample-1/> The linkend is the SGML/XML id on the top item of the page you want to link to. For most pages this is currently the part ("gtk", "gdk", "glib") and then the page title ("Hash Tables"). For widgets it is just the class name. Spaces and underscores are converted to '-' to conform to SGML/XML.
pt_BR: Para vincular a outra seção nas documentações do GTK: <_:informalexample-1/> O fim do link é o ID do SGML/XML no item superior da página a qual você deseja vincular. Para a maioria das páginas isto é atualmente a parte (“gtk”, “gdk”, “glib”) e, então, o título da página (“Hash Tables”). Para os widgets isso é apenas o nome da classe. Espaços e sublinhados são convertidos em '-' para estar em conformidade com SGML/XML.

note: (itstool) path: sect1/para
en: To refer to an external function, e.g. a standard C function: <_:informalexample-1/>
pt_BR: Para se referir a uma função externa, como, por exemplo, uma função padrão do C: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;example&gt;
      &lt;title&gt;Using a GHashTable.&lt;/title&gt;
      &lt;programlisting&gt;
          ...
      &lt;/programlisting&gt;
    &lt;/example&gt;
pt_BR: 
    &lt;example&gt;
      &lt;title&gt;Usando uma GHashTable.&lt;/title&gt;
      &lt;programlisting&gt;
          ...
      &lt;/programlisting&gt;
    &lt;/example&gt;

note: (itstool) path: sect1/para
en: To include example code: <_:informalexample-1/> or possibly this, for very short code fragments which don't need a title: <_:informalexample-2/> For the latter GTK-Doc also supports an abbreviation: |[ ... ]|
pt_BR: Para incluir um código de exemplo: <_:informalexample-1/> ou possivelmente este, para fragmentos de código bem curtos que não precisam de um título: <_:informalexample-2/> Para este último, GTK-Doc também possui suporte a uma abreviação: |[ ... ]|

note: (itstool) path: sect1/para
en: To include bulleted lists: <_:informalexample-1/>
pt_BR: Para incluir listas com marcadores: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;note&gt;
      &lt;para&gt;
        Make sure you free the data after use.
      &lt;/para&gt;
    &lt;/note&gt;
pt_BR: 
    &lt;note&gt;
      &lt;para&gt;
        Certifique-se de que você liberou os dados após usá-los.
      &lt;/para&gt;
    &lt;/note&gt;

note: (itstool) path: sect1/para
en: To include a note which stands out from the text: <_:informalexample-1/>
pt_BR: Para incluir uma nota que fique fora do texto: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a type: <_:informalexample-1/>
pt_BR: Para se referir a um tipo: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to an external structure (not one described in the GTK docs): <_:informalexample-1/>
pt_BR: Para se referir a uma estrutura externa (não uma descrita nos documentos do GTK): <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a field of a structure: <_:informalexample-1/>
pt_BR: Para se referir a um campo de uma estrutura: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a class name, we could possibly use: <_:informalexample-1/> but you'll probably be using #GtkWidget instead (to automatically create a link to the GtkWidget page - see <link linkend="documenting_syntax">the abbreviations</link>).
pt_BR: Para se referir a um nome de classe, nós possivelmente poderíamos usar: <_:informalexample-1/> mas você provavelmente vai estar usando #GtkWidget em vez disso (para criar automaticamente um link para a página do GtkWidget - veja <link linkend="documenting_syntax">as abreviações</link>).

note: (itstool) path: informalexample/programlisting
en: 
    &lt;emphasis&gt;This is important&lt;/emphasis&gt;
pt_BR: 
    &lt;emphasis&gt;Isso é importante&lt;/emphasis&gt;

note: (itstool) path: sect1/para
en: To emphasize text: <_:informalexample-1/>
pt_BR: Para enfatizar um texto: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;filename&gt;/home/user/documents&lt;/filename&gt;
pt_BR: 
    &lt;filename&gt;/home/usuario/documentos&lt;/filename&gt;

note: (itstool) path: sect1/para
en: For filenames use: <_:informalexample-1/>
pt_BR: Para nome de arquivos use: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to keys use: <_:informalexample-1/>
pt_BR: Para se referir a chaves use: <_:informalexample-1/>

note: (itstool) path: chapter/title
en: Filling the extra files
pt_BR: Preenchendo os arquivos extras

note: (itstool) path: chapter/para
en: There are a couple of extra files, that need to be maintained along with the inline source code comments: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
pt_BR: Há alguns poucos arquivos extras, que precisam ser mantidos junto com os comentários inseridos no código fonte: <filename>&lt;pacote&gt;.types</filename>, <filename>&lt;pacote&gt;-docs.xml</filename> (no passado, .sgml), <filename>&lt;pacote&gt;-sections.txt</filename>.

note: (itstool) path: sect1/title
en: Editing the types file
pt_BR: Editando o arquivo de tipos

note: (itstool) path: sect1/para
en: If your library or application includes GObjects, you want their signals, arguments/parameters and position in the hierarchy to be shown in the documentation. All you need to do, is to list the <function>xxx_get_type</function> functions together with their include inside the <filename>&lt;package&gt;.types</filename> file.
pt_BR: Se sua biblioteca ou aplicativo inclui GObjects, você deseja que seus sinais, argumentos/parâmetros e posição na hierarquia sejam mostrados na documentação. Tudo que você precisa fazer é listar as funções <function>xxx_get_type</function> junto com seus include dentro do arquivo <filename>&lt;pacote&gt;.types</filename>.

note: (itstool) path: example/title
en: Example types file snippet
pt_BR: Trecho de exemplo de arquivo de tipos

note: (itstool) path: sect1/para
en: Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this list for you. Just add "--rebuild-types" to SCAN_OPTIONS in <filename>Makefile.am</filename>. If you use this approach you should not dist the types file nor have it under version control.
pt_BR: Desde o GTK-Doc 1.8, o <application>gtkdoc-scan</application> pode gerar esta lista para você. Basta adicionar “--rebuild-types” a SCAN_OPTIONS no <filename>Makefile.am</filename>. Se você usar esta abordagem, você não deveria distribuir o arquivo de tipos nem tê-lo sob um controle de versão.

note: (itstool) path: sect1/title
en: Editing the master document
pt_BR: Editando o documento mestre

note: (itstool) path: sect1/para
en: GTK-Doc produces documentation in DocBook SGML/XML. When processing the inline source comments, the GTK-Doc tools generate one documentation page per class or module as a separate file. The master document includes them and place them in an order.
pt_BR: O Gtk-Doc produz documentação em DocBook SGML/XML. Ao processar os comentários inseridos nos fontes, as ferramentas do GTK-Doc geram uma página de documentação por classe ou módulo como um arquivo separado. O documento mestre os inclui e os coloca em uma ordem.

note: (itstool) path: sect1/para
en: While GTK-Doc creates a template master document for you, later runs will not touch it again. This means that one can freely structure the documentation. That includes grouping pages and adding extra pages. GTK-Doc has now a test suite, where also the master-document is recreated from scratch. Its a good idea to look at this from time to time to see if there are some new goodies introduced there.
pt_BR: Enquanto o Gtk-Doc cria um modelo de documento mestre para você, execuções posteriores não vão tocá-lo novamente. Isso significa que se pode estruturar a documentação livremente. Isso inclui agrupamento de páginas e adição de páginas extras. O Gtk-Doc agora possui uma suíte de teste, na qual também o documento mestre é recriado do zero. É uma boa ideia verificar isso de tempo em tempo para ver se há itens a serem introduzidos lá.

note: (itstool) path: tip/para
en: Do not create tutorials as extra documents. Just write extra chapters. The benefit of directly embedding the tutorial for your library into the API documentation is that it is easy to link for the tutorial to symbol documentation. Apart chances are higher that the tutorial gets updates along with the library.
pt_BR: Não crie tutoriais como documentos extras. Apenas escreva capítulos extras. O benefício de embutir diretamente o tutorial para sua biblioteca na documentação da API é que é mais fácil vincular o tutorial a um símbolo da documentação. Além disso, as chances são mais altas que o tutorial obtenha atualizações junto com a biblioteca.

note: (itstool) path: sect1/para
en: So what are the things to change inside the master document? For a start is only a little. There are some placeholders (text in square brackets) there which you should take care of.
pt_BR: Então, quais são as coisas para se alterar dentro do documento mestre? Para começar é apenas um pouco. Existem alguns mantedores de espaço (texto em colchetes) que você deve cuidar.

note: (itstool) path: example/title
en: Master document header
pt_BR: Cabeçalho do documento mestre

note: (itstool) path: example/programlisting
en: 
    &lt;bookinfo&gt;
      &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;
      &lt;releaseinfo&gt;
        for MODULENAME [VERSION]
        The latest version of this documentation can be found on-line at
        &lt;ulink role="online-location" url="http://[SERVER]/MODULENAME/index.html"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.
      &lt;/releaseinfo&gt;
    &lt;/bookinfo&gt;
    
    &lt;chapter&gt;
      &lt;title&gt;[Insert title here]&lt;/title&gt;
pt_BR: 
    &lt;bookinfo&gt;
      &lt;title&gt;Manual de referência do NOMEDOMÓDULO&lt;/title&gt;
      &lt;releaseinfo&gt;
        for NOMEDOMÓDULO [VERSÃO]
        A última versão desta documentação também pode ser encontrada on-line em
        &lt;ulink role="online-location" url="http://[SERVIDOR]/NOMEDOMÓDULO/index.html"&gt;http://[SERVIDOR]/NOMEDOMÓDULO/&lt;/ulink&gt;.
      &lt;/releaseinfo&gt;
    &lt;/bookinfo&gt;
    
    &lt;chapter&gt;
      &lt;title&gt;[Insira o título aqui]&lt;/title&gt;

note: (itstool) path: sect1/para
en: In addition a few option elements are created in commented form. You can review these and enable them as you like.
pt_BR: Além disso, alguns elementos de opção são criados na forma comentada. Você pode revisá-los e habilitá-los como preferir.

note: (itstool) path: example/title
en: Optional part in the master document
pt_BR: Parte opcional do documento mestre

note: (itstool) path: example/programlisting
en: 
      &lt;!-- enable this when you use gobject introspection annotations
      &lt;xi:include href="xml/annotation-glossary.xml"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;
      --&gt;
pt_BR: 
      &lt;!-- habilite isso se você usa anotações do gobject introspection
      &lt;xi:include href="xml/annotation-glossary.xml"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;
      --&gt;

note: (itstool) path: sect1/para
en: Finally you need to add new section whenever you introduce one. The <link linkend="modernizing-gtk-doc-1-16">gtkdoc-check</link> tool will remind you of newly generated xml files that are not yet included into the doc.
pt_BR: Finalmente você precisa adicionar nova seção sempre que você a introduzir. A ferramenta <link linkend="modernizing-gtk-doc-1-16">gtkdoc-check</link> vai lembrar você de arquivos xml recentemente gerados que ainda não foram incluídos na documentação.

note: (itstool) path: example/title
en: Including generated sections
pt_BR: Incluindo seções geradas

note: (itstool) path: example/programlisting
en: 
      &lt;chapter&gt;
        &lt;title&gt;my library&lt;/title&gt;
          &lt;xi:include href="xml/object.xml"/&gt;
          ...
pt_BR: 
      &lt;chapter&gt;
        &lt;title&gt;minha biblioteca&lt;/title&gt;
          &lt;xi:include href="xml/object.xml"/&gt;
          ...

note: (itstool) path: sect1/title
en: Editing the section file
pt_BR: Editando o arquivo de seção

note: (itstool) path: sect1/para
en: The section file is used to organise the documentation output by GTK-Doc. Here one specifies which symbol belongs to which module or class and control the visibility (public or private).
pt_BR: O arquivo de seção é usado para organizar a saída da documentação pelo GTK-Doc. Aqui pode-se especificar qual símbolo pertence a qual módulo ou classe e controla a visibilidade (pública ou privada).

note: (itstool) path: sect1/para
en: The section file is a plain text file with tags delimiting sections. Blank lines are ignored and lines starting with a '#' are treated as comment lines.
pt_BR: O arquivo de seção é uma arquivo texto simples com seções delimitadas por tags. Linhas em branco são ignoradas e linhas começando com um “#” são tratadas como linhas de comentários.

note: (itstool) path: note/para
en: While the tags make the file look like xml, it is not. Please do not close tags like &lt;SUBSECTION&gt;.
pt_BR: Enquanto as tags fazem o arquivo se parecer xml, ele não é. Por favor, não feche tags como &lt;SUBSECTION&gt;.

note: (itstool) path: sect1/para
en: The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/FILE&gt;' will result in the section declarations being output in the template file <filename>tmpl/gnome-config.sgml</filename>, which will be converted into the DocBook XML file <filename>xml/gnome-config.sgml</filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. (The name of the HTML file is based on the module name and the section title, or for GObjects it is based on the GObjects class name converted to lower case).
pt_BR: A tag &lt;FILE&gt; ... &lt;/FILE&gt; é usada para especificar o nome de arquivo, sem qualquer sufixo. Por exemplo, ao usar “&lt;FILE&gt;gnome-config&lt;/FILE&gt;” resultará nas declarações da seção serem retornadas no arquivo modelo <filename>tmpl/gnome-config.sgml</filename>, o qual será convertido no arquivo DocBook XML <filename>xml/gnome-config.sgml</filename> ou no arquivo DocBook XML <filename>xml/gnome-config.xml</filename>. (O nome do arquivo HTML é baseado no nome do módulo e no título da seção ou, para GObjects, é baseado no nome da classe GObjects convertidos os caracteres para minúsculos).

note: (itstool) path: sect1/para
en: The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the section. It is only useful before the templates (if used) are initially created, since the title set in the template file overrides this. Also if one uses SECTION comment in the sources, this is obsolete.
pt_BR: A tag &lt;TITLE&gt; ... &lt;/TITLE&gt; é usada para especificar o título da seção. Ela é usada apenas antes do modelo (se usado) ser criado inicialmente, já que o título definido no arquivo de modelo sobrescreve este. Também, se for usado o comentário SECTION nos fontes, isso está obsoleto.

note: (itstool) path: sect1/para
en: You can group items in the section by using the &lt;SUBSECTION&gt; tag. Currently it outputs a blank line between subsections in the synopsis section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject declarations (e.g. the functions like g_object_get_type and macros like G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the documentation. You can also use &lt;SUBSECTION Private&gt; for private declarations which will not be output (it is a handy way to avoid warning messages about unused declarations). If your library contains private types which you don't want to appear in the object hierarchy and the list of implemented or required interfaces, add them to a Private subsection. Whether you would place GObject and GObjectClass like structs in public or Standard section depends if they have public entries (variables, vmethods).
pt_BR: Você pode agrupar itens na seção usando a tag &lt;SUBSECTION&gt;. Atualmente, ela retorna uma linha em branco entre as subseções na seção de sinopse. Você também pode usar &lt;SUBSECTION Standard&gt; para declarações padrão do GObject (ex.: as funções como g_object_get_type e macros como G_OBJECT(), G_IS_OBJECT() etc.). Atualmente, estas são deixadas fora da documentação. Você também pode usar &lt;SUBSECTION Private&gt; para declarações privadas que não serão retornadas (é uma forma prática de evitar mensagens de aviso sobre declarações não usadas). Se sua biblioteca contém tipos privados que você não deseja que apareçam na hierarquia do objeto e a linha de classes implementadas ou exigidas, adicione-as a uma subseção privada. Se você colocaria o GObject e GObjectClass como structs numa seção padrão ou pública depende se há entradas públicas (variáveis, vmethods).

note: (itstool) path: sect1/para
en: You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the #include files which are shown in the synopsis sections. It contains a comma-separate list of #include files, without the angle brackets. If you set it outside of any sections, it acts for all sections until the end of the file. If you set it within a section, it only applies to that section.
pt_BR: Você também pode usar &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; para especificar os arquivos #include que são mostrados nas seções de sinopse. Ela contém uma lista separada por vírgula de arquivos #include, sem os sinais de maior que e menor que. Se você define-a fora de quaisquer seções, ela age para todas as seções até o fim do arquivo. Se você define-a em uma seção, ela só vai se aplicar àquela seção.

note: (itstool) path: chapter/title
en: Controlling the result
pt_BR: Controlando o resultado

note: (itstool) path: chapter/para
en: A GTK-Doc run generates report files inside the documentation directory. The generated files are named: <filename>&lt;package&gt;-undocumented.txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and <filename>&lt;package&gt;-unused.txt</filename>. All those are plain text files that can be viewed and postprocessed easily.
pt_BR: Uma execução do GTK-Doc gera arquivos de relatórios dentro do diretório de documentação. Os arquivos gerados são chamados: <filename>&lt;pacote&gt;-undocumented.txt</filename>, <filename>&lt;pacote&gt;-undeclared.txt</filename> e <filename>&lt;pacote&gt;-unused.txt</filename>. Todos eles são arquivos texto simples que podem ser facilmente visualizados e pós-processados.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with the documentation coverage summary. Below are two sections divided by blank lines. The first section lists undocumented or incomplete symbols. The second section does the same for section docs. Incomplete entries are those, which have documentation, but where e.g. a new parameter has been added.
pt_BR: O arquivo <filename>&lt;pacote&gt;-undocumented.txt</filename> começa com um sumário de cobertura da documentação. Abaixo estão duas seções divididas por linhas brancas. A primeira seção lista símbolos não documentados e incompletos. A segunda seção faz o mesmo para os documentos de seção. Entradas incompletas são aquelas que foram documentadas, mas nas quais, por exemplo, um novo parâmetro foi adicionado.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols given in the <filename>&lt;package&gt;-sections.txt</filename> but not found in the sources. Check if they have been removed or if they are misspelled.
pt_BR: O arquivo <filename>&lt;pacote&gt;-undeclared.txt</filename> lista símbolos dados no <filename>&lt;pacote&gt;-sections.txt</filename>, mas não encontrados nos fontes. Verifique se eles foram removidos ou se eles foram escritos incorretamente.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, where the GTK-Doc scanner has found documentation, but does not know where to put it. This means that the symbol has not yet been added to the <filename>&lt;package&gt;-sections.txt</filename> file.
pt_BR: O arquivo <filename>&lt;pacote&gt;-unused.txt</filename> lista nomes de símbolo cuja documentação foi localizada na varredura do GTK-Doc, mas que não sabe onde colocá-los. Isso significa que o símbolo não foi adicionado ainda ao arquivo <filename>&lt;pacote&gt;-sections.txt</filename>.

note: (itstool) path: tip/para
en: Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during <command>make check</command> run.
pt_BR: Habilite ou adicione a linha <option>TESTS=$(GTKDOC_CHECK)</option> no Makefile.am. Se pelo menos GTK-Doc 1.9 estiver instalado, isso vai executar verificações de sanidade durante a execução de <command>make check</command>.

note: (itstool) path: chapter/para
en: One can also look at the files produced by the source code scanner: <filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared with the section file if that is manually maintained. The second lists all declarations from the headers. If a symbol is missing one could check if this file contains it.
pt_BR: Também pode-se buscar nos arquivos produzidos pela varredura do código aberto: <filename>&lt;pacote&gt;-decl-list.txt</filename> e <filename>&lt;pacote&gt;-decl.txt</filename>. O primeiro pode ser comparado com o arquivo de seção, se ele for mantido manualmente. O segundo lista todas as declarações de cabeçalhos. Se um símbolo está faltando, pode-se verificar se este arquivo o contém.

note: (itstool) path: chapter/para
en: If the project is GObject based, one can also look into the files produced by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, <filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;.prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</filename>. If there are missing symbols in any of those, one can ask GTK-Doc to keep the intermediate scanner file for further analysis, by running it as <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>.
pt_BR: Se o projeto é baseado em GObject, pode-se também procurar nos arquivos produzidos pela varredura de objetos: <filename>&lt;pacote&gt;.args.txt</filename>, <filename>&lt;pacote&gt;.hierarchy.txt</filename>, <filename>&lt;pacote&gt;.interfaces.txt</filename>, <filename>&lt;pacote&gt;.prerequisites.txt</filename> e <filename>&lt;pacote&gt;.signals.txt</filename>. Se há símbolos faltando em qualquer um deles, pode-se exigir que o GTK-Doc mantenha o arquivo intermediário de varredura para análise posterior, executando <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>.

note: (itstool) path: chapter/title
en: Modernizing the documentation
pt_BR: Modernizando a documentação

note: (itstool) path: chapter/para
en: GTK-Doc has been around for quite some time. In this section we list new features together with the version since when it is available.
pt_BR: GTK-Doc está por aí já faz um tempo. Nesta seção, nós listamos novas funcionalidades juntamente da versão desde a qual está disponível.

note: (itstool) path: sect1/para
en: When using xml instead of sgml, one can actually name the master document <filename>&lt;package&gt;-docs.xml</filename>.
pt_BR: Ao usar xml em vez de sgml, na verdade, é possível nomear o documento mestre <filename>&lt;pacote&gt;-docs.xml</filename>.

note: (itstool) path: sect1/para
en: This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in <filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can be removed from the vcs. This only works nicely for projects that have a very regular structure (e.g. each .{c,h} pair will create new section). If one organize a project close to that updating a manually maintained section file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>.
pt_BR: Essa versão provê suporte <option>SCAN_OPTIONS=--rebuild-sections</option> em <filename>Makefile.am</filename>. Quando esta opção está habilitada, o <filename>&lt;package&gt;-sections.txt</filename> é auto-gerado e pode ser removido a partir do VCS. Isso só funciona corretamente para projetos que têm uma estrutura muito regular (ex.: cada par .{c,h} vai criar uma nova seção). Se uma pessoa organiza um projeto próximo a isso atualizando um arquivo de seção mantido manualmente pode ser tão simples quanto executando <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>.

note: (itstool) path: sect1/para
en: Version 1.8 already introduced the syntax for documenting sections in the sources instead of the separate files under <filename class="directory">tmpl</filename>. This version adds options to switch the whole doc module to not use the extra tmpl build step at all, by using <option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If you don't have a <filename class="directory">tmpl</filename> checked into your source control system and haven't yet switched, just add the flag to <filename>configure.ac</filename> and you are done.
pt_BR: A versão 1.8 já introduziu a sintaxe para documentação seções nos fontes em vez dos arquivos separados sob <filename class="directory">tmpl</filename>. Essa versão adiciona opções para alternar todo o módulo de documentação para não usar a etapa de compilação extra do tmpl, usando <option>--flavour no-tmpl</option> no <filename>configure.ac</filename>. Se você não possui um <filename class="directory">tmpl</filename> no seu sistema de controle de versão e ainda não trocou, basta adicionar uma opção ao <filename>configure.ac</filename> e está resolvido.

note: (itstool) path: sect1/para
en: This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in <filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;package&gt;.types</filename> is autogenerated and can be removed from the vcs. When using this feature it is important to also setup the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for code that is build conditionally.
pt_BR: Essa versão provê suporte <option>SCAN_OPTIONS=--rebuild-types</option> no <filename>Makefile.am</filename>. Quando isso está habilitado, o <filename>&lt;package&gt;.types</filename> é auto-gerado e pode ser removido do VCS. Quando usando essa funcionalidade é importante também configurar o <varname>IGNORE_HFILES</varname> no <filename>Makefile.am</filename> para código que é compilado condicionalmente.

note: (itstool) path: example/title
en: Enable gtkdoc-check
pt_BR: Habilitar gtkdoc-check

note: (itstool) path: sect1/para
en: This version includes a new tool called gtkdoc-check. This tool can run a set of sanity checks on your documentation. It is enabled by adding these lines to the end of <filename>Makefile.am</filename>. <_:example-1/>
pt_BR: Essa versão inclui uma nova ferramenta chamada gtkdoc-check. Essa ferramenta pode executar um conjunto de verificações de sanidade na sua documentação. Ela é habilitada adicionando essas linhas ao final do <filename>Makefile.am</filename>. <_:example-1/>

note: (itstool) path: sect1/para
en: Version 1.18 brought some initial markdown support. Using markdown in doc comments is less intrusive than writing docbook xml. This version improves a lot on this and add a lot more styles. The section that explains the <link linkend="documenting_syntax">comment syntax</link> has all the details.
pt_BR: A versão 1.18 trouxe algum suporte inicial a markdown. O uso de markdown em comentários de documentação é menos intrusiva do que escrever xml de docbook. Essa versão melhora em muito nisso e adiciona muito mais estilos. A seção que explica a <link linkend="documenting_syntax">sintaxe de comentário</link> tem todos os detalhes.

note: (itstool) path: example/title
en: Use pre-generated entities
pt_BR: Usando entradas geradas previamente

note: (itstool) path: example/programlisting
en: 
    &lt;?xml version="1.0"?&gt;
    &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
    [
      &lt;!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'"&gt;
      &lt;!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent"&gt;
      %gtkdocentities;
    ]&gt;
    &lt;book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"&gt;
      &lt;bookinfo&gt;
        &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;
        &lt;releaseinfo&gt;
          for &amp;package_string;.
          The latest version of this documentation can be found on-line at
          &lt;ulink role="online-location" url="http://[SERVER]/&amp;package_name;/index.html"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.
        &lt;/releaseinfo&gt;
      &lt;/bookinfo&gt;
pt_BR: 
    &lt;?xml version="1.0"?&gt;
    &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
    [
      &lt;!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'"&gt;
      &lt;!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent"&gt;
      %gtkdocentities;
    ]&gt;
    &lt;book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"&gt;
      &lt;bookinfo&gt;
        &lt;title&gt;Manual de referência do &amp;nome-pacote;&lt;/title&gt;
        &lt;releaseinfo&gt;
          para &amp;versão-pacote;.
          A última versão desta documentação pode ser encontra on-line em
          &lt;ulink role="online-location" url="http://[SERVIDOR]/&amp;nome-pacote;/index.html"&gt;http://[SERVIDOR]/&amp;nome-pacote;/&lt;/ulink&gt;.
        &lt;/releaseinfo&gt;
      &lt;/bookinfo&gt;

note: (itstool) path: sect1/para
en: The makefiles shipped with this version generate an entity file at <filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. package_name and package_version. You can use this e.g. in the main xml file to avoid hardcoding the version number. Below is an example that shows how the entity file is included and how the entities are used. The entities can also be used in all generated files, GTK-Doc will use the same xml header in generated xml files. <_:example-1/>
pt_BR: Os makefiles fornecidos com esta versão geram um arquivo de entidade em <filename>xml/gtkdocentities.ent</filename>, contendo entidades para, por exemplo, nome-pacote e versão-pacote. Você pode usar isto, por exemplo, no arquivo xml principal para evitar ter que inserir diretamente o número de versão. Logo abaixo encontra-se um exemplo que mostra como o arquivo de entidade é incluído e como as entidades são usadas. As entidades também podem ser usadas em todos arquivos gerados, GTK-Doc usará o mesmo cabeçalho xml nos arquivos xml gerados. <_:example-1/>

note: (itstool) path: chapter/title
en: Documenting other interfaces
pt_BR: Documentando outras interfaces

note: (itstool) path: chapter/para
en: So far we have been using GTK-Doc to document the API of code. The next sections contain suggestions how the tools can be used to document other interfaces too.
pt_BR: Até agora nós temos usado o GTK-Doc para documentar a API de um código. As próximas sessões contêm sugestões de como as ferramentas podem ser usadas para documentar outras interfaces, também.

note: (itstool) path: sect1/title
en: Command line options and man pages
pt_BR: Opções de linha de comando e de páginas man

note: (itstool) path: sect1/para
en: As one can generate man pages for a docbook refentry as well, it sounds like a good idea to use it for that purpose. This way the interface is part of the reference and one gets the man-page for free.
pt_BR: Já que também é possível gerar páginas man para um refentry do docbook, soa como uma boa ideia usá-lo para este propósito. Desta forma, a interface é parte da referência e é possível obter a página man de graça.

note: (itstool) path: sect2/title
en: Document the tool
pt_BR: Documentar a ferramenta

note: (itstool) path: sect2/para
en: Create one refentry file per tool. Following <link linkend="settingup_docfiles">our example</link> we would call it <filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags that should be used and can look at generated file in the xml subdirectory as well as examples e.g. in glib.
pt_BR: Crie um arquivo refentry por ferramenta. Segundo <link linkend="settingup_docfiles">nosso exemplo</link> nós chamaríamos ele de <filename>meep/docs/reference/meeper/meep.xml</filename>. Para as tags xml que devem ser usadas e podem parecer no arquivo gerado no subdiretório xml assim como exemplos, por exemplo, em glib.

note: (itstool) path: sect2/title
en: Adding the extra configure check
pt_BR: Adicionando a verificação extra ao configure

note: (itstool) path: example/title
en: Extra configure checks
pt_BR: Verificações extra no configure

note: (itstool) path: sect2/title
en: Adding the extra makefile rules
pt_BR: Adicionando as regras extras ao makefile

note: (itstool) path: sect1/title
en: DBus interfaces
pt_BR: Interfaces DBus

note: (itstool) path: sect1/para
en: (FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)
pt_BR: (CORRIJA-ME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)

note: (itstool) path: chapter/title
en: Frequently asked questions
pt_BR: Perguntas frequentes

note: (itstool) path: segmentedlist/segtitle
en: Question
pt_BR: Questão

note: (itstool) path: segmentedlist/segtitle
en: Answer
pt_BR: Resposta

note: (itstool) path: seglistitem/seg
en: No class hierarchy.
pt_BR: Sem hierarquia de classe.

note: (itstool) path: seglistitem/seg
en: The objects <function>xxx_get_type()</function> function has not been entered into the <filename>&lt;package&gt;.types</filename> file.
pt_BR: A função de objetos <function>xxx_get_type()</function> não foi inserida no arquivo <filename>&lt;pacote&gt;.types</filename>.

note: (itstool) path: seglistitem/seg
en: Still no class hierarchy.
pt_BR: Ainda sem hierarquia.

note: (itstool) path: seglistitem/seg
en: Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> file (see <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">explanation</ulink>).
pt_BR: Nomenclatura faltando ou incorreta no arquivo <filename>&lt;pacote&gt;-sections.txt</filename> (veja a <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">explicação</ulink>).

note: (itstool) path: seglistitem/seg
en: Damn, I have still no class hierarchy.
pt_BR: Droga. Eu ainda não tenho hierarquia de classes.

note: (itstool) path: seglistitem/seg
en: Is the object name (name of the instance struct, e.g. <type>GtkWidget</type>) part of the normal section (don't put this into Standard or Private subsections).
pt_BR: Por acaso o nome do objeto (nome da struct da instância, ex. <type>GtkWidget</type>) faz parte da seção normal (não coloque isso em subseções Standard ou Private)?

note: (itstool) path: seglistitem/seg
en: No symbol index.
pt_BR: Nenhum símbolo de índice.

note: (itstool) path: seglistitem/seg
en: Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a index that xi:includes the generated index?
pt_BR: O <filename>&lt;pacote&gt;-docs.{xml,sgml}</filename> contém um índice que “xi:inclui” o índice gerado?

note: (itstool) path: seglistitem/seg
en: Symbols are not linked to their doc-section.
pt_BR: Símbolos não estão vinculados ao seus doc-section.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.
pt_BR: O doc-comment está usando a marcação correta (adicionado #,% or ())? Verifique se o gtkdoc-fixxref avisa sobre xrefs não resolvidos.

note: (itstool) path: seglistitem/seg
en: A new class does not appear in the docs.
pt_BR: Uma nova classe não aparece nos documentos.

note: (itstool) path: seglistitem/seg
en: Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
pt_BR: A nova página foi “xi:incluída” do <filename>&lt;pacote&gt;-docs.{xml,sgml}</filename>?

note: (itstool) path: seglistitem/seg
en: A new symbol does not appear in the docs.
pt_BR: Um novo símbolo não aparece nos documentos.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment properly formatted. Check for spelling mistakes in the begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable xrefs. Check if the symbol is correctly listed in the <filename>&lt;package&gt;-sections.txt</filename> in a public subsection.
pt_BR: O doc-comment está formatado adequadamente? Verifique erros de escrita no começo do comentário. Verifique se o gtkdoc-fixxref avisa sobre xrefs não resolvíveis. Verifique se o símbolo está listado corretamente no <filename>&lt;pacote&gt;-sections.txt</filename> em uma subseção pública.

note: (itstool) path: seglistitem/seg
en: A type is missing from the class hierarchy.
pt_BR: Um tipo está faltando da hierarquia de classe.

note: (itstool) path: seglistitem/seg
en: If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but not in <filename>xml/tree_index.sgml</filename> then double check that the type is correctly placed in the <filename>&lt;package&gt;-sections.txt</filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed or incidentally marked private it will not be shown.
pt_BR: Se o tipo está listado no <filename>&lt;pacote&gt;.hierarchy</filename>, mas não em <filename>xml/tree_index.sgml</filename>, então certifique-se de que o tipo está colocado corretamente no <filename>&lt;pacote&gt;-sections.txt</filename>. Se a instância do tipo (ex.: <type>GtkWidget</type>) não está listada ou incidentalmente marcada como privada, ela não será mostrada.

note: (itstool) path: seglistitem/seg
en: I get foldoc links for all gobject annotations.
pt_BR: Obtenho links de seguimento de documentos para todas as anotações gobject.

note: (itstool) path: seglistitem/seg
en: Check that <filename>xml/annotation-glossary.xml</filename> is xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
pt_BR: Verifique se <filename>xml/annotation-glossary.xml</filename> está “xi:incluído” de <filename>&lt;pacote&gt;-docs.{xml,sgml}</filename>.

note: (itstool) path: seglistitem/seg
en: Parameter described in source code comment block but does not exist
pt_BR: Parâmetro descrito no bloco de comentário do código fonte não existe

note: (itstool) path: seglistitem/seg
en: Check if the prototype in the header has different parameter names as in the source.
pt_BR: Verifique se o protótipo no cabeçalho tem nomes de parâmetros diferentes da fonte.

note: (itstool) path: seglistitem/seg
en: multiple "IDs" for constraint linkend: XYZ
pt_BR: múltiplos “IDs” para restrições do fim do link XYZ

note: (itstool) path: seglistitem/seg
en: Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</filename> file.
pt_BR: O símbolo XYZ aparece duas vezes no arquivo <filename>&lt;pacote&gt;-sections.txt</filename>.

note: (itstool) path: seglistitem/seg
en: Element typename in namespace '' encountered in para, but no template matches.
pt_BR: Elemento typename no espaço de nome '' encontrado em para, mas nenhum modelo correspondeu.

note: (itstool) path: chapter/title
en: Tools related to gtk-doc
pt_BR: Ferramentas relacionadas ao gtk-doc

note: (itstool) path: chapter/para
en: GtkDocPlugin - a <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and integrates with the trac search.
pt_BR: GtkDocPlugin - um plug-in de integração com <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink>, que adiciona documentos de API a um site trac e integra com a pesquisa do trac.

note: (itstool) path: chapter/para
en: Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since tags in the API to determine the minimum required version.
pt_BR: Gtkdoc-depscan - uma ferramenta (parte do gtk-doc) para verificar APIs usadas, a partir de suas tags, para determinar a versão mínima necessária.

note: (itstool) path: appendixinfo/releaseinfo
en: Version 1.1, March 2000
pt_BR: Versão 1.1, Março de 2000

note: (itstool) path: legalnotice/para
en: <_:address-1/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
pt_BR: <_:address-1/> É permitido a qualquer um copiar e distribuir cópias exatas deste documento de licença, embora não seja permitido alterá-lo.

note: (itstool) path: appendix/title (itstool) path: para/quote
en: GNU Free Documentation License
pt_BR: Licença de Documentação Livre GNU

note: (itstool) path: sect1/title
en: 0. PREAMBLE
pt_BR: 0. INTRODUÇÃO

note: (itstool) path: sect1/para
en: The purpose of this License is to make a manual, textbook, or other written document <quote>free</quote> in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
pt_BR: O propósito desta Licença é fazer um manual, livro-texto, ou outro documento escrito <quote>livre</quote> em seu sentido de liberdade: para garantir a todos a liberdade efetiva de copiá-lo e redistribui-lo, com ou sem modificações, tanto comercialmente como não comercialmente. Em segundo lugar, esta Licença preserva ao autor e ao editor uma forma de obter crédito pelo seu trabalho, enquanto não é considerado responsável por modificações feitas por outros.

note: (itstool) path: sect1/para
en: This License is a kind of <quote>copyleft</quote>, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
pt_BR: Esta licença é um tipo de <quote>copyleft</quote>, que significa que trabalhos derivados do documento precisam ser, por sua vez, livres no mesmo sentido. Ela complementa a Licença Pública Geral GNU (GNU General Public License), que é uma licença copyleft projetada para softwares livres.

note: (itstool) path: sect1/para
en: We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
pt_BR: Nós projetamos esta Licença a fim de ser utilizada em manuais de software livre, já que softwares livres precisam de documentações livres: um programa livre deveria vir com manuais que ofereçam as mesmas liberdades que o software proporciona. Mas esta Licença não é limitada a manuais de software; ela pode ser usada para qualquer trabalho de texto, independente do assunto ou se é publicado como um livro impresso. Nós recomendamos esta Licença principalmente para trabalhos cujo propósito seja instrução ou referência.

note: (itstool) path: sect1/title
en: 1. APPLICABILITY AND DEFINITIONS
pt_BR: 1. APLICABILIDADE E DEFINIÇÕES

note: (itstool) path: sect1/para
en: This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The <quote>Document</quote>, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as <quote>you</quote>.
pt_BR: Esta Licença se aplica a qualquer manual ou outro trabalho que contenha um aviso colocado pelo detentor dos direitos autorais dizendo que o documento pode ser distribuído sob os termos desta. O <quote>Documento</quote>, abaixo, refere-se a qualquer manual ou trabalho. Qualquer membro do público é um licenciado, e será referenciado como <quote>você</quote>.

note: (itstool) path: sect1/para
en: A <quote>Modified Version</quote> of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
pt_BR: Uma <quote>Versão Modificada</quote> do Documento significa qualquer trabalho contendo o Documento ou uma porção deste, seja uma cópia literal ou com modificações e/ou traduzido em outro idioma.

note: (itstool) path: sect1/para
en: A <quote>Secondary Section</quote> is a named appendix or a front-matter section of the <link linkend="fdl-document">Document</link> that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
pt_BR: Uma <quote>Seção Secundária</quote> é um apêndice com nome ou uma seção inicial do <link linkend="fdl-document">Documento</link> que trata exclusivamente da relação dos editores ou autores do Documento com seu assunto geral (ou temas relacionados) e não contém nada que possa estar diretamente dentro do assunto geral. (Por exemplo, se o Documento é em parte um livro-texto de matemática, uma Seção Secundária não pode explicar nada de matemática). Tal relação pode ser uma questão de conexão histórica com o assunto ou com temas relacionados, ou tratar de questões legais, comerciais, filosóficas, éticas ou políticas com relação a eles.

note: (itstool) path: sect1/para
en: The <quote>Invariant Sections</quote> are certain <link linkend="fdl-secondary"> Secondary Sections</link> whose titles are designated, as being those of Invariant Sections, in the notice that says that the <link linkend="fdl-document">Document</link> is released under this License.
pt_BR: As <quote>Seções Invariantes</quote> são certas <link linkend="fdl-secondary">Seções Secundárias</link> cujos títulos são designados como sendo de Seções Invariantes na nota que afirma que o <link linkend="fdl-document">Documento</link> é publicado sob esta Licença.

note: (itstool) path: sect1/para
en: The <quote>Cover Texts</quote> are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the <link linkend="fdl-document">Document</link> is released under this License.
pt_BR: Os <quote>Textos de Capa</quote> são certas passagens de texto curtas que são listadas, como Textos de Capa Frontal ou Texto de Contra Capa, na nota que afirma que o <link linkend="fdl-document">Documento</link> é publicado sob esta Licença.

note: (itstool) path: sect1/para
en: A <quote>Transparent</quote> copy of the <link linkend="fdl-document"> Document</link> means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not <quote>Transparent</quote> is called <quote>Opaque</quote>.
pt_BR: Uma cópia <quote>Transparente</quote> do <link linkend="fdl-document">Documento</link> significa uma cópia legível por máquina, representada em um formato cuja especificação esteja disponível ao público geral e que cujo conteúdo possa ser visualizado e editado de forma clara e direta por editores de texto genéricos ou programas genéricos de desenho (para imagens compostas de pixels) ou para alguns dos editores de desenho amplamente disponíveis (para desenhos) e que seja apropriado para inclusão em formatadores de texto ou para a tradução automática em uma variedade de formatos apropriados de entrada em formatadores de texto. Uma cópia feita em outro formato de arquivo Transparente cuja marcação, ou ausência desta, tenha sido manipulada para impedir ou desencorajar modificação subsequente pelos leitores não é Transparente. Uma cópia que não é <quote>Transparente</quote> é chamada <quote>Opaca</quote>.

note: (itstool) path: sect1/para
en: Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only.
pt_BR: Exemplos de formatos apropriados para cópias Transparentes incluem ASCII puro sem marcação, formato de entrada Texinfo, formato de entrada LaTex, SGML ou XML usando um DTD publicamente disponível, e HTML simples em conformidade padrão projetado para modificação por humanos. Formatos Opacos incluem PostScript, PDF, formatos proprietários que podem ser lidos ou editados somente por processadores de texto proprietários, SGML ou XML cujos DTD e/ou ferramenta de processamento não estão largamente disponibilizados, e o HTML gerado por máquina produzido por algum processador de texto com propósito apenas de saída.

note: (itstool) path: sect1/para
en: The <quote>Title Page</quote> means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, <quote>Title Page</quote> means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
pt_BR: A <quote>Página de Título</quote> significa, para um livro impresso, a própria página do título, além das páginas subsequentes necessárias para conter, de forma legível, o material que esta Licença requer que apareça na página do título. Para trabalhos em formatos que não possuem qualquer página de título semelhante, <quote>Página de Título</quote> significa o texto próximo à ocorrência mais proeminente do título do trabalho, precedendo o início do corpo do texto.

note: (itstool) path: sect1/title
en: 2. VERBATIM COPYING
pt_BR: 2. CÓPIA ESCRITA

note: (itstool) path: sect1/para
en: You may copy and distribute the <link linkend="fdl-document">Document</link> in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in <link linkend="fdl-section3">section 3</link>.
pt_BR: Você pode copiar e distribuir o <link linkend="fdl-document">Documento</link> em qualquer meio, seja este de forma comercial ou não, desde que esta licença, as notas de direitos autorais (copyright), e a nota de licença afirmando que esta Licença se aplica ao Documento sejam reproduzidas em todas as cópias, e que você não inclua outras condições, quaisquer que sejam, às condições desta Licença. Você não pode usar de medidas técnicas para obstruir ou controlar a leitura ou cópia futura das cópias que você fizer ou distribuir. Contudo, você pode aceitar compensação em troca das cópias. Se você distribuir um número suficientemente grande de cópias, você deve também respeitar as condições descritas na <link linkend="fdl-section3">seção 3</link>.

note: (itstool) path: sect1/para
en: You may also lend copies, under the same conditions stated above, and you may publicly display copies.
pt_BR: Você também pode emprestar cópias, sob as mesmas condições relacionadas acima, e você pode publicamente exibir cópias.

note: (itstool) path: sect1/title
en: 3. COPYING IN QUANTITY
pt_BR: 3. COPIANDO EM QUANTIDADE

note: (itstool) path: sect1/para
en: If you publish printed copies of the <link linkend="fdl-document">Document</link> numbering more than 100, and the Document's license notice requires <link linkend="fdl-cover-texts">Cover Texts</link>, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the <link linkend="fdl-document">Document</link> and satisfy these conditions, can be treated as verbatim copying in other respects.
pt_BR: Se você publicar cópias impressas do <link linkend="fdl-document">Documento</link>, em número maior que 100, e a nota de licença do Documento exigir <link linkend="fdl-cover-texts">Textos de Capa</link>, você deve encadernar as cópias em capas que carreguem, de forma clara e legível, todos estes Textos de Capa: Textos de Capa Frontal na capa frontal e Textos de Contracapa na contracapa. Ambas as capas devem também identificar, de forma clara e legível, você como o editor das cópias. A capa frontal deve apresentar o título completo com todas as palavras deste igualmente proeminentes e visíveis. Além disso, você pode adicionar outro material nas capas. As cópias com mudanças limitadas às capas, desde que preservem o título do <link linkend="fdl-document">Documento</link> e satisfaçam estas condições podem ser tratadas como cópias literais em outros aspectos.

note: (itstool) path: sect1/para
en: If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
pt_BR: Se os textos necessários a qualquer uma das capas forem muito volumosos para serem incluídos de forma legível, você deve colocar os primeiros textos listados (quantos couberem razoavelmente) na própria capa, e continuar o resto em páginas adjacentes.

note: (itstool) path: sect1/para
en: If you publish or distribute <link linkend="fdl-transparent">Opaque</link> copies of the <link linkend="fdl-document">Document</link> numbering more than 100, you must either include a machine-readable <link linkend="fdl-transparent">Transparent</link> copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
pt_BR: Se você publicar ou distribuir cópias <link linkend="fdl-transparent">Opacas</link> do <link linkend="fdl-document">Documento</link> em número maior que 100, você deve incluir uma cópia <link linkend="fdl-transparent">Transparente</link> legível por máquina juntamente com cada cópia Opaca, ou dizer em (ou juntamente com) cada cópia Opaca, um endereço de rede a partir do qual o público geral de usuários possam acessar e obter de forma anônima e sob nenhum custo, usando protocolos de rede públicos padrão, uma cópia Transparente completa do Documento, livre de materiais adicionados. Se você decidir pela segunda opção, você deve seguir passos com certa prudência ao começar a distribuir as cópias Opacas em quantidade, a fim de garantir que esta cópia transparente permanecerá acessível no local indicado por pelo menos um ano após a última vez que você distribuir uma cópia Opaca (diretamente ou através de seus agentes ou distribuidores) desta edição ao público.

note: (itstool) path: sect1/para
en: It is requested, but not required, that you contact the authors of the <link linkend="fdl-document">Document</link> well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
pt_BR: É solicitado, mas não exigido, que você contate os autores do <link linkend="fdl-document">Documento</link> muito antes de redistribuir qualquer grande número de cópias, para dar a eles uma chance de lhe fornecer uma versão atualizada do Documento.

note: (itstool) path: sect1/title
en: 4. MODIFICATIONS
pt_BR: 4. MODIFICAÇÕES

note: (itstool) path: sect1/para
en: You may copy and distribute a <link linkend="fdl-modified">Modified Version</link> of the <link linkend="fdl-document">Document</link> under the conditions of sections <link linkend="fdl-section2">2</link> and <link linkend="fdl-section3">3</link> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
pt_BR: Você pode copiar e distribuir uma <link linkend="fdl-modified">Versão Modificada</link> do <link linkend="fdl-document">Documento</link> sob as condições das seções <link linkend="fdl-section2">2</link> e <link linkend="fdl-section3">3</link> acima, desde que você forneça a Versão Modificada estritamente sob esta Licença, com a Versão Modificada preenchendo a função de Documento, permitindo assim a distribuição e modificação da Versão Modificada a quem quer que possua uma cópia desta. Além disso, você deve executar os seguintes procedimentos na Versão Modificada:

note: (itstool) path: formalpara/para
en: Use in the <link linkend="fdl-title-page">Title Page</link> (and on the covers, if any) a title distinct from that of the <link linkend="fdl-document">Document</link>, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
pt_BR: Usar na <link linkend="fdl-title-page">Página de Título</link> (e nas capas, se existirem) um título distinto em relação ao do <link linkend="fdl-document">Documento</link>, e daqueles de versões anteriores (os quais devem, na existência de algum, ser listados na seção “Histórico” do Documento). Você pode usar o mesmo título de uma versão anterior se o editor original daquela versão conceder-lhe permissão.

note: (itstool) path: formalpara/para
en: List on the <link linkend="fdl-title-page">Title Page</link>, as authors, one or more persons or entities responsible for authorship of the modifications in the <link linkend="fdl-modified">Modified Version</link>, together with at least five of the principal authors of the <link linkend="fdl-document">Document</link> (all of its principal authors, if it has less than five).
pt_BR: Listar na <link linkend="fdl-title-page">Página de Título</link> como autores, uma ou mais pessoas ou entidades responsáveis pela autoria das modificações na <link linkend="fdl-modified">Versão Modificada</link>, juntamente com pelo menos cinco autores principais do <link linkend="fdl-document">Documento</link> (todos seus autores principais, se houver menos que cinco).

note: (itstool) path: formalpara/para
en: State on the <link linkend="fdl-title-page">Title Page</link> the name of the publisher of the <link linkend="fdl-modified">Modified Version</link>, as the publisher.
pt_BR: Declarar na <link linkend="fdl-title-page">Página de Título</link> o nome do editor da <link linkend="fdl-modified">Versão Modificada</link>, como seu editor.

note: (itstool) path: formalpara/para
en: Preserve all the copyright notices of the <link linkend="fdl-document">Document</link>.
pt_BR: Preservar todas as notas de direitos autorais (copyright) do <link linkend="fdl-document">Documento</link>.

note: (itstool) path: formalpara/para
en: Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
pt_BR: Adicionar uma nota apropriada de direitos autorais para suas modificações, adjacente às outras notas de direitos autorais.

note: (itstool) path: formalpara/para
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the <link linkend="fdl-modified">Modified Version</link> under the terms of this License, in the form shown in the Addendum below.
pt_BR: Incluir, imediatamente após as notas de direitos autorais, uma nota de licença concedendo permissão pública para o uso da <link linkend="fdl-modified">Versão Modificada</link> sob os termos desta Licença, na forma mostrada no Adendo abaixo.

note: (itstool) path: formalpara/para
en: Preserve in that license notice the full lists of <link linkend="fdl-invariant"> Invariant Sections</link> and required <link linkend="fdl-cover-texts">Cover Texts</link> given in the <link linkend="fdl-document">Document's</link> license notice.
pt_BR: Preservar na referida nota de licença a lista completa de <link linkend="fdl-invariant">Seções Invariantes</link> e <link linkend="fdl-cover-texts">Textos de Capa</link> obrigatórios, dados na nota de licença do <link linkend="fdl-document">Documento</link>.

note: (itstool) path: formalpara/para
en: Include an unaltered copy of this License.
pt_BR: Inclua uma cópia inalterada desta Licença.

note: (itstool) path: formalpara/para
en: Preserve the section entitled <quote>History</quote>, and its title, and add to it an item stating at least the title, year, new authors, and publisher of the <link linkend="fdl-modified">Modified Version</link> as given on the <link linkend="fdl-title-page">Title Page</link>. If there is no section entitled <quote>History</quote> in the <link linkend="fdl-document">Document</link>, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
pt_BR: Preservar a seção intitulada <quote>Histórico</quote>, preservar seu título, e adicionar a esta um item declarando ao menos o título, o ano, novos autores, e o editor da <link linkend="fdl-modified">Versão Modificada</link> conforme incluído na <link linkend="fdl-title-page">Página de Título</link>. Se nenhuma seção intitulada <quote>Histórico</quote> estiver presente no <link linkend="fdl-document">Documento</link>, crie uma informando o título, o ano, os autores e o editor do Documento como evidenciado na Página de Título, em seguida adicione um item descrevendo a Versão Modificada como mencionado na sentença anterior.

note: (itstool) path: formalpara/para
en: Preserve the network location, if any, given in the <link linkend="fdl-document">Document</link> for public access to a <link linkend="fdl-transparent">Transparent</link> copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the <quote>History</quote> section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
pt_BR: Preservar o endereço de rede, se existir algum, informado pelo <link linkend="fdl-document">Documento</link> para acesso público a uma cópia <link linkend="fdl-transparent">Transparente</link> deste e, da mesma maneira, os endereços de rede dados no Documento para versões anteriores nas quais este se baseia. Estes podem ser colocados na seção <quote>Histórico</quote>. Você pode omitir um endereço de rede para um trabalho que foi publicado pelo menos quatro anos antes do Documento em si, ou se o editor original da versão à qual o endereço se refere der permissão.

note: (itstool) path: formalpara/para
en: In any section entitled <quote>Acknowledgements</quote> or <quote>Dedications</quote>, preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
pt_BR: Preservar o título da seção para qualquer seção intitulada <quote>Agradecimentos</quote> ou <quote>Dedicatórias</quote> e preservar dentro da seção toda a substância e tom de cada um dos agradecimentos e/ou dedicatórias lá mencionados.

note: (itstool) path: formalpara/para
en: Preserve all the <link linkend="fdl-invariant">Invariant Sections</link> of the <link linkend="fdl-document">Document</link>, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
pt_BR: Preservar todas as <link linkend="fdl-invariant">Seções Invariantes</link> do <link linkend="fdl-document">Documento</link>, sem alterações em seus textos e títulos. Números de seção ou o equivalente não são considerados parte dos títulos das seções.

note: (itstool) path: formalpara/para
en: Delete any section entitled <quote>Endorsements</quote>. Such a section may not be included in the <link linkend="fdl-modified">Modified Version</link>.
pt_BR: Apagar qualquer seção intitulada <quote>Apoio</quote>. Tal seção não deve ser incluída na <link linkend="fdl-modified">Versão Modificada</link>.

note: (itstool) path: formalpara/para
en: Do not retitle any existing section as <quote>Endorsements</quote> or to conflict in title with any <link linkend="fdl-invariant">Invariant Section</link>.
pt_BR: Não renomear o título de qualquer seção existente como <quote>Apoio</quote> ou que resulte em conflito com o título de qualquer <link linkend="fdl-invariant">Seção Invariante</link>.

note: (itstool) path: sect1/para
en: If the <link linkend="fdl-modified">Modified Version</link> includes new front-matter sections or appendices that qualify as <link linkend="fdl-secondary">Secondary Sections</link> and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of <link linkend="fdl-invariant">Invariant Sections</link> in the Modified Version's license notice. These titles must be distinct from any other section titles.
pt_BR: Se a <link linkend="fdl-modified">Versão Modificada</link> incluir novas seções iniciais ou apêndices que sejam qualificados como <link linkend="fdl-secondary">Seções Secundárias</link>, e não contiver material copiado do Documento, você pode, a seu critério, tornar algumas dessas ou todas essas seções em invariantes. Para fazer isso, adicione seus títulos à lista de <link linkend="fdl-invariant">Seções Invariantes</link> na nota de licença da Versão Modificada. Estes títulos devem ser distintos de quaisquer outros títulos de seções.

note: (itstool) path: sect1/para
en: You may add a section entitled <quote>Endorsements</quote>, provided it contains nothing but endorsements of your <link linkend="fdl-modified">Modified Version</link> by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
pt_BR: Você pode incluir uma seção intitulada <quote>Apoio</quote>, desde que esta contenha apenas apoios recebidos limitados a sua <link linkend="fdl-modified">Versão Modificada</link> por várias fontes -- por exemplo, notas do revisor ou de que o texto foi aprovado por uma organização como a definição oficial de um padrão.

note: (itstool) path: sect1/para
en: You may add a passage of up to five words as a <link linkend="fdl-cover-texts">Front-Cover Text</link>, and a passage of up to 25 words as a <link linkend="fdl-cover-texts">Back-Cover Text</link>, to the end of the list of <link linkend="fdl-cover-texts">Cover Texts</link> in the <link linkend="fdl-modified">Modified Version</link>. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the <link linkend="fdl-document">Document</link> already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
pt_BR: Você pode adicionar uma passagem de até cinco palavras como <link linkend="fdl-cover-texts">Texto de Capa Frontal</link>, e uma passagem de até 25 palavras como <link linkend="fdl-cover-texts">Texto de Contracapa</link>, ao fim da lista de <link linkend="fdl-cover-texts">Textos de Capa</link> na <link linkend="fdl-modified">Versão Modificada</link>. Somente uma passagem de Texto de Capa Frontal e uma de Texto de Contracapa podem ser adicionados por (ou através de arranjos feitos por) uma entidade qualquer. Caso o <link linkend="fdl-document">Documento</link> já incluir um texto de capa para a mesma capa, previamente incluído por você ou pelo arranjo feito pela mesma entidade em cujo nome você está agindo, você não poderá adicionar outro; mas você poderá substituir o antigo, com a permissão explícita do editor anterior, que o incluiu.

note: (itstool) path: sect1/para
en: The author(s) and publisher(s) of the <link linkend="fdl-document">Document</link> do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any <link linkend="fdl-modified">Modified Version </link>.
pt_BR: O(s) autor(es) e editor(es) do <link linkend="fdl-document">Documento</link>, por esta Licença, não concedem permissão para que seus nomes sejam usados a fins de publicidade, para defesa ou para apoio implícito de qualquer <link linkend="fdl-modified">Versão Modificada</link>.

note: (itstool) path: sect1/title
en: 5. COMBINING DOCUMENTS
pt_BR: 5. COMBINANDO DOCUMENTOS

note: (itstool) path: sect1/para
en: You may combine the <link linkend="fdl-document">Document</link> with other documents released under this License, under the terms defined in <link linkend="fdl-section4">section 4</link> above for modified versions, provided that you include in the combination all of the <link linkend="fdl-invariant">Invariant Sections</link> of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
pt_BR: Você pode combinar o <link linkend="fdl-document">Documento</link> com outros documentos publicados sob esta Licença, sob os termos definidos na <link linkend="fdl-section4">seção 4</link> acima para versões modificadas, desde que você inclua na combinação todas as <link linkend="fdl-invariant">Seções Invariantes</link> de todos os documentos originais, sem modificações, e as liste como Seções Invariantes de seu trabalho combinado, na sua nota de licença.

note: (itstool) path: sect1/para
en: The combined work need only contain one copy of this License, and multiple identical <link linkend="fdl-invariant">Invariant Sections</link> may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
pt_BR: O trabalho combinado precisa conter somente uma cópia desta Licença, e várias <link linkend="fdl-invariant">Seções Invariantes</link> idênticas podem ser substituídas por uma única cópia. Se existirem várias Seções Invariantes de mesmo nome, porém com conteúdos diferentes, você deve tornar o título de cada uma destas seções único, adicionando ao fim destes, entre parênteses, o nome do autor ou, se conhecido, o editor original desta seção, ou ainda um número único. Faça o mesmo ajuste nos títulos de seção na lista de Seções Invariantes na nota de licença do trabalho combinado.

note: (itstool) path: sect1/para
en: In the combination, you must combine any sections entitled <quote>History</quote> in the various original documents, forming one section entitled <quote>History</quote>; likewise combine any sections entitled <quote>Acknowledgements</quote>, and any sections entitled <quote>Dedications</quote>. You must delete all sections entitled <quote>Endorsements.</quote>
pt_BR: Na combinação, você deve combinar quaisquer seções intituladas <quote>Histórico</quote> nos vários documentos originais, formando uma seção intitulada <quote>Histórico</quote>; do mesmo modo, combine quaisquer seções intituladas <quote>Agradecimentos</quote>, e quaisquer seções intituladas <quote>Dedicatórias</quote>. Você deve apagar todas as seções intituladas <quote>Apoio</quote>.

note: (itstool) path: sect1/title
en: 6. COLLECTIONS OF DOCUMENTS
pt_BR: 6. COLEÇÕES DE DOCUMENTOS

note: (itstool) path: sect1/para
en: You may make a collection consisting of the <link linkend="fdl-document">Document</link> and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
pt_BR: Você pode fazer uma coleção que consiste do <link linkend="fdl-document">Documento</link> e outros documentos publicados sob esta Licença, e substituir as cópias individuais desta Licença, nos vários documentos, por uma única cópia a ser incluída na coleção, desde que você siga as regras desta Licença para cópias literais de cada documento em todos os outros aspectos.

note: (itstool) path: sect1/para
en: You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
pt_BR: Você pode extrair um único documento desta coleção, e distribuí-lo individualmente sob esta Licença, desde que você insira uma cópia desta Licença no documento extraído, e siga esta Licença em todos os outros aspectos com relação à cópia literal do documento.

note: (itstool) path: sect1/title
en: 7. AGGREGATION WITH INDEPENDENT WORKS
pt_BR: 7. AGREGAÇÃO COM TRABALHOS INDEPENDENTES

note: (itstool) path: sect1/para
en: A compilation of the <link linkend="fdl-document">Document</link> or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a <link linkend="fdl-modified">Modified Version</link> of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an <quote>aggregate</quote>, and this License does not apply to the other self-contained works thus compiled with the Document , on account of their being thus compiled, if they are not themselves derivative works of the Document. If the <link linkend="fdl-cover-texts">Cover Text</link> requirement of <link linkend="fdl-section3">section 3</link> is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
pt_BR: Uma compilação do <link linkend="fdl-document">Documento</link> ou seus derivados com outros documentos ou trabalhos separados e independentes, dentro de ou sob um volume de um meio de armazenamento ou distribuição, não conta como um todo para uma <link linkend="fdl-modified">Versão Modificada</link> do Documento, contanto que nenhum direito autoral de compilação seja reivindicado para esta compilação. Tal compilação configura um <quote>agregado</quote> e esta Licença não se aplica aos outros trabalhos contidos na compilação do Documento, levando em conta serem compilados, caso eles mesmos não forem trabalhos derivados do Documento. Se o requisito de <link linkend="fdl-cover-texts">Texto da Capa</link> da <link linkend="fdl-section3">seção 3</link> é aplicável a estas cópias do Documento, e ainda se o Documento é menor do que um quarto do agregado inteiro, os Textos de Capa do Documento podem ser inseridos nas capas que envolvem somente o Documento no agregado. Caso contrário, eles devem aparecer em capas em volta do agregado como um todo.

note: (itstool) path: sect1/title
en: 8. TRANSLATION
pt_BR: 8. TRADUÇÃO

note: (itstool) path: sect1/para
en: Translation is considered a kind of modification, so you may distribute translations of the <link linkend="fdl-document">Document</link> under the terms of <link linkend="fdl-section4">section 4</link>. Replacing <link linkend="fdl-invariant"> Invariant Sections</link> with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
pt_BR: Uma tradução é considerada como sendo um tipo de modificação, desta forma você pode distribuir traduções do <link linkend="fdl-document">Documento</link> sob os termos da <link linkend="fdl-section4">seção 4</link>. A substituição das <link linkend="fdl-invariant">Seções Invariantes</link> por traduções requer permissão especial dos detentores dos direitos autorais, embora você possa incluir traduções de algumas ou todas as Seções Invariantes juntamente às versões originais destas. Você pode incluir uma tradução desta Licença, desde que você também inclua a versão original em Inglês desta Licença. Em caso de discordância entre a tradução e a versão original desta Licença ou nota de licença, a versão original em inglês prevalecerá.

note: (itstool) path: sect1/title
en: 9. TERMINATION
pt_BR: 9. TÉRMINO

note: (itstool) path: sect1/para
en: You may not copy, modify, sublicense, or distribute the <link linkend="fdl-document">Document</link> except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
pt_BR: Você não pode copiar, modificar, sublicenciar, ou distribuir o <link linkend="fdl-document">Documento</link> com exceção do que foi expressamente previsto sob esta Licença. Qualquer outra tentativa de cópia, modificação, sublicenciamento ou distribuição do Documento é nula, e implicará na rescisão automática de seus direitos sob esta Licença. Contudo, as partes que receberam as cópias, ou direitos, de você sob esta Licença não terão suas licenças rescindidas enquanto tais partes permanecerem em total acordo com a Licença.

note: (itstool) path: sect1/title
en: 10. FUTURE REVISIONS OF THIS LICENSE
pt_BR: 10. FUTURAS REVISÕES DESTA LICENÇA

note: (itstool) path: sect1/para
en: The <ulink type="http" url="http://www.gnu.org/fsf/fsf.html">Free Software Foundation</ulink> may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <ulink type="http" url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink>.
pt_BR: A <ulink type="http" url="http://www.gnu.org/fsf/fsf.html">Free Software Foundation</ulink> pode publicar novas versões, revisadas, da Licença de Documentação Livre GNU de tempos em tempos. Tais versões posteriores terão ideologia similar à presente versão, embora possam diferir em detalhes a fim de abordar novos problemas ou preocupações. Consulte: <ulink type="http" url="http://www.gnu.org/copyleft">http://www.gnu.org/copyleft/</ulink>.

note: (itstool) path: sect1/para
en: Each version of the License is given a distinguishing version number. If the <link linkend="fdl-document">Document</link> specifies that a particular numbered version of this License <quote>or any later version</quote> applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
pt_BR: É dado, a cada versão da Licença, um número de versão distinto. Se o <link linkend="fdl-document">Documento</link> especificar que um número de versão em específico desta Licença <quote>ou qualquer versão posterior</quote> se aplica a ele, você tem a opção de seguir os termos e condições tanto da versão especificada quanto de qualquer versão posterior que tenha sido publicada (não como rascunho) pela Free Software Foundation. Se o documento não especificar um número de versão desta Licença, você pode escolher qualquer versão já publicada (não como rascunho) pela Free Software Foundation.

note: (itstool) path: sect1/title
en: Addendum
pt_BR: Adendo

note: (itstool) path: sect1/para
en: To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
pt_BR: Para usar esta Licença em um documento que você escreveu, inclua uma cópia desta no documento e adicione as seguintes notas de direitos autorais e licença logo após a página de título:

note: (itstool) path: blockquote/para
en: Copyright YEAR YOUR NAME.
pt_BR: Copyright ANO SEU NOME.

note: (itstool) path: blockquote/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the <link linkend="fdl-invariant">Invariant Sections</link> being LIST THEIR TITLES, with the <link linkend="fdl-cover-texts">Front-Cover Texts</link> being LIST, and with the <link linkend="fdl-cover-texts">Back-Cover Texts</link> being LIST. A copy of the license is included in the section entitled <quote>GNU Free Documentation License</quote>.
pt_BR: Permissão concedida para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU (GNU Free Documentation License), Versão 1.1 ou qualquer versão mais recente publicada pela Free Software Foundation; com as <link linkend="fdl-invariant">Seções Invariantes</link>, sendo LISTADO SEUS TÍTULOS, com os <link linkend="fdl-cover-texts">Textos de Capa Frontal</link> sendo LISTADOS, e com os <link linkend="fdl-cover-texts">Textos de Contracapa</link> sendo LISTADOS. Uma cópia da licença está inclusa na seção entitulada <quote>Licença de Documentação Livre GNU (GNU Free Documentation License)</quote>.

note: (itstool) path: sect1/para
en: If you have no <link linkend="fdl-invariant">Invariant Sections</link>, write <quote>with no Invariant Sections</quote> instead of saying which ones are invariant. If you have no <link linkend="fdl-cover-texts">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="fdl-cover-texts">Back-Cover Texts</link>.
pt_BR: Se você não tiver qualquer <link linkend="fdl-invariant">Seção Invariante</link>, escreva <quote>sem Seções Invariantes</quote> ao invés de afirmar quais são invariantes. Se você não tem <link linkend="fdl-cover-texts">Textos de Capa Frontal</link>, escreva <quote>sem Textos de Capa Frontal</quote> ao invés de <quote>Textos de Capa Frontal sendo LISTADOS</quote>; O mesmo se aplica a <link linkend="fdl-cover-texts">Textos de Contracapa</link>.

note: (itstool) path: sect1/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the <ulink type="http" url="http://www.gnu.org/copyleft/gpl.html"> GNU General Public License</ulink>, to permit their use in free software.
pt_BR: Se seu documento contiver exemplos não-triviais de código de programação, recomendamos publicar estes exemplos paralelamente, sob a licença de software livre que você escolher, como por exemplo a <ulink type="http" url="http://www.gnu.org/copyleft/gpl.html">Licença Pública Geral GNU</ulink> (GNU General Public License), para permitir seu uso em software livre.

note: (itstool) path: para/quote
en: free
pt_BR: livre

note: (itstool) path: sect1/para
en: The purpose of this License is to make a manual, textbook, or other written document <_:quote-1/> in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
pt_BR: O propósito desta Licença é fazer um manual, livro-texto, ou outro documento escrito <_:quote-1/> em seu sentido de liberdade: para garantir a todos a liberdade efetiva de copiá-lo e redistribui-lo, com ou sem modificações, tanto comercialmente como não comercialmente. Em segundo lugar, esta Licença preserva ao autor e ao editor uma forma de obter crédito pelo seu trabalho, enquanto não é considerado responsável por modificações feitas por outros.

note: (itstool) path: sect1/para
en: This License is a kind of <_:quote-1/>, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
pt_BR: Esta licença é um tipo de <_:quote-1/>, que significa que trabalhos derivados do documento precisam ser, por sua vez, livres no mesmo sentido. Ela complementa a Licença Pública Geral GNU (GNU General Public License), que é uma licença copyleft projetada para softwares livres.

note: (itstool) path: para/quote (itstool) path: para/link
en: Document
pt_BR: Documento

note: (itstool) path: para/quote
en: you
pt_BR: você

note: (itstool) path: sect1/para
en: This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The <_:quote-1/>, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as <_:quote-2/>.
pt_BR: Esta Licença se aplica a qualquer manual ou outro trabalho que contenha um aviso colocado pelo detentor dos direitos autorais dizendo que o documento pode ser distribuído sob os termos desta. O <_:quote-1/>, abaixo, refere-se a qualquer manual ou trabalho. Qualquer membro do público é um licenciado, e será referenciado como <_:quote-2/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Modified Version
pt_BR: Versão modificada

note: (itstool) path: sect1/para
en: A <_:quote-1/> of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
pt_BR: Uma <_:quote-1/> do Documento significa qualquer trabalho contendo o Documento ou uma porção deste, seja uma cópia literal ou com modificações e/ou traduzido em outro idioma.

note: (itstool) path: para/quote
en: Secondary Section
pt_BR: Seção da secundária

note: (itstool) path: sect1/para
en: A <_:quote-1/> is a named appendix or a front-matter section of the <_:link-2/> that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
pt_BR: Uma <_:quote-1/> é um apêndice com nome ou uma seção inicial do <_:link-2/> que trata exclusivamente da relação dos editores ou autores do Documento com seu assunto geral (ou temas relacionados) e não contém nada que possa estar diretamente dentro do assunto geral. (Por exemplo, se o Documento é em parte um livro-texto de matemática, uma Seção Secundária não pode explicar nada de matemática). Tal relação pode ser uma questão de conexão histórica com o assunto ou com temas relacionados, ou tratar de questões legais, comerciais, filosóficas, éticas ou políticas com relação a eles.

note: (itstool) path: para/quote (itstool) path: para/link
en: Invariant Sections
pt_BR: Sessões invariantes

note: (itstool) path: para/link
en: Secondary Sections
pt_BR: Sessões secundárias

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as being those of Invariant Sections, in the notice that says that the <_:link-3/> is released under this License.
pt_BR: As <_:quote-1/> são certas <_:link-2/> cujos títulos são designados como sendo de Seções Invariantes na nota que afirma que o <_:link-3/> é publicado sob esta Licença.

note: (itstool) path: para/quote (itstool) path: para/link
en: Cover Texts
pt_BR: Textos de Capa

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:link-2/> is released under this License.
pt_BR: Os <_:quote-1/> são certas passagens de texto curtas que são listadas, como Textos de Capa Frontal ou Texto de Contra Capa, na nota que afirma que o <_:link-2/> é publicado sob esta Licença.

note: (itstool) path: para/quote (itstool) path: para/link
en: Transparent
pt_BR: Transparente

note: (itstool) path: para/quote (itstool) path: para/link
en: Opaque
pt_BR: Opaco

note: (itstool) path: sect1/para
en: A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>.
pt_BR: Uma cópia <_:quote-1/> do <_:link-2/> significa uma cópia legível por máquina, representada em um formato cuja especificação esteja disponível ao público geral e que cujo conteúdo possa ser visualizado e editado de forma clara e direta por editores de texto genéricos ou programas genéricos de desenho (para imagens compostas de pixels) ou para alguns dos editores de desenho amplamente disponíveis (para desenhos) e que seja apropriado para inclusão em formatadores de texto ou para a tradução automática em uma variedade de formatos apropriados de entrada em formatadores de texto. Uma cópia feita em outro formato de arquivo Transparente cuja marcação, ou ausência desta, tenha sido manipulada para impedir ou desencorajar modificação subsequente pelos leitores não é Transparente. Uma cópia que não é <_:quote-3/> é chamada <_:quote-4/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Title Page
pt_BR: Título da página

note: (itstool) path: sect1/para
en: The <_:quote-1/> means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, <_:quote-2/> means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
pt_BR: A <_:quote-1/> significa, para um livro impresso, a própria página do título, além das páginas subsequentes necessárias para conter, de forma legível, o material que esta Licença requer que apareça na página do título. Para trabalhos em formatos que não possuem qualquer página de título semelhante, <_:quote-2/> significa o texto próximo à ocorrência mais proeminente do título do trabalho, precedendo o início do corpo do texto.

note: (itstool) path: para/link
en: section 3
pt_BR: seção 3

note: (itstool) path: sect1/para
en: You may copy and distribute the <_:link-1/> in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in <_:link-2/>.
pt_BR: Você pode copiar e distribuir o <_:link-1/> em qualquer meio, seja este de forma comercial ou não, desde que esta licença, as notas de direitos autorais (copyright), e a nota de licença afirmando que esta Licença se aplica ao Documento sejam reproduzidas em todas as cópias, e que você não inclua outras condições, quaisquer que sejam, às condições desta Licença. Você não pode usar de medidas técnicas para obstruir ou controlar a leitura ou cópia futura das cópias que você fizer ou distribuir. Contudo, você pode aceitar compensação em troca das cópias. Se você distribuir um número suficientemente grande de cópias, você deve também respeitar as condições descritas na <_:link-2/>.

note: (itstool) path: sect1/para
en: If you publish printed copies of the <_:link-1/> numbering more than 100, and the Document's license notice requires <_:link-2/>, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the <_:link-3/> and satisfy these conditions, can be treated as verbatim copying in other respects.
pt_BR: Se você publicar cópias impressas do <_:link-1/>, em número maior que 100, e a nota de licença do Documento exigir <_:link-2/>, você deve encadernar as cópias em capas que carreguem, de forma clara e legível, todos estes Textos de Capa: Textos de Capa Frontal na capa frontal e Textos de Contracapa na contracapa. Ambas as capas devem também identificar, de forma clara e legível, você como o editor das cópias. A capa frontal deve apresentar o título completo com todas as palavras deste igualmente proeminentes e visíveis. Além disso, você pode adicionar outro material nas capas. As cópias com mudanças limitadas às capas, desde que preservem o título do <_:link-3/> e satisfaçam estas condições podem ser tratadas como cópias literais em outros aspectos.

note: (itstool) path: sect1/para
en: If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering more than 100, you must either include a machine-readable <_:link-3/> copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
pt_BR: Se você publicar ou distribuir cópias <_:link-1/> do <_:link-2/> em número maior que 100, você deve incluir uma cópia <_:link-3/> legível por máquina juntamente com cada cópia Opaca, ou dizer em (ou juntamente com) cada cópia Opaca, um endereço de rede a partir do qual o público geral de usuários possam acessar e obter de forma anônima e sob nenhum custo, usando protocolos de rede públicos padrão, uma cópia Transparente completa do Documento, livre de materiais adicionados. Se você decidir pela segunda opção, você deve seguir passos com certa prudência ao começar a distribuir as cópias Opacas em quantidade, a fim de garantir que esta cópia transparente permanecerá acessível no local indicado por pelo menos um ano após a última vez que você distribuir uma cópia Opaca (diretamente ou através de seus agentes ou distribuidores) desta edição ao público.

note: (itstool) path: sect1/para
en: It is requested, but not required, that you contact the authors of the <_:link-1/> well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
pt_BR: É solicitado, mas não exigido, que você contate os autores do <_:link-1/> muito antes de redistribuir qualquer grande número de cópias, para dar a eles uma chance de lhe fornecer uma versão atualizada do Documento.

note: (itstool) path: sect1/para
en: You may copy and distribute a <_:link-1/> of the <_:link-2/> under the conditions of sections <_:link-3/> and <_:link-4/> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
pt_BR: Você pode copiar e distribuir uma <_:link-1/> do <_:link-2/> sob as condições das seções <_:link-3/> e <_:link-4/> acima, desde que você forneça a Versão Modificada estritamente sob esta Licença, com a Versão Modificada preenchendo a função de Documento, permitindo assim a distribuição e modificação da Versão Modificada a quem quer que possua uma cópia desta. Além disso, você deve executar os seguintes procedimentos na Versão Modificada:

note: (itstool) path: formalpara/para
en: Use in the <_:link-1/> (and on the covers, if any) a title distinct from that of the <_:link-2/>, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
pt_BR: Usar na <_:link-1/> (e nas capas, se existirem) um título distinto em relação ao do <_:link-2/>, e daqueles de versões anteriores (os quais devem, na existência de algum, ser listados na seção “Histórico” do Documento). Você pode usar o mesmo título de uma versão anterior se o editor original daquela versão conceder-lhe permissão.

note: (itstool) path: formalpara/para
en: List on the <_:link-1/>, as authors, one or more persons or entities responsible for authorship of the modifications in the <_:link-2/>, together with at least five of the principal authors of the <_:link-3/> (all of its principal authors, if it has less than five).
pt_BR: Listar na <_:link-1/> como autores, uma ou mais pessoas ou entidades responsáveis pela autoria das modificações na <_:link-2/>, juntamente com pelo menos cinco autores principais do <_:link-3/> (todos seus autores principais, se houver menos que cinco).

note: (itstool) path: formalpara/para
en: State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as the publisher.
pt_BR: Declarar na <_:link-1/> o nome do editor da <_:link-2/>, como seu editor.

note: (itstool) path: formalpara/para
en: Preserve all the copyright notices of the <_:link-1/>.
pt_BR: Preservar todas as notas de direitos autorais (copyright) do <_:link-1/>.

note: (itstool) path: formalpara/para
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the <_:link-1/> under the terms of this License, in the form shown in the Addendum below.
pt_BR: Incluir, imediatamente após as notas de direitos autorais, uma nota de licença concedendo permissão pública para o uso da <_:link-1/> sob os termos desta Licença, na forma mostrada no Adendo abaixo.

note: (itstool) path: para/link
en: Document's
pt_BR: do Documento

note: (itstool) path: formalpara/para
en: Preserve in that license notice the full lists of <_:link-1/> and required <_:link-2/> given in the <_:link-3/> license notice.
pt_BR: Preservar na referida nota de licença a lista completa de <_:link-1/> e <_:link-2/> obrigatórios, dados na nota de licença do <_:link-3/>.

note: (itstool) path: para/quote
en: History
pt_BR: Histórico

note: (itstool) path: formalpara/para
en: Preserve the section entitled <_:quote-1/>, and its title, and add to it an item stating at least the title, year, new authors, and publisher of the <_:link-2/> as given on the <_:link-3/>. If there is no section entitled <_:quote-4/> in the <_:link-5/>, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
pt_BR: Preservar a seção intitulada <_:quote-1/>, preservar seu título, e adicionar a esta um item declarando ao menos o título, o ano, novos autores, e o editor da <_:link-2/> conforme incluído na <_:link-3/>. Se nenhuma seção intitulada <_:quote-4/> estiver presente no <_:link-5/>, crie uma informando o título, o ano, os autores e o editor do Documento como evidenciado na Página de Título, em seguida adicione um item descrevendo a Versão Modificada como mencionado na sentença anterior.

note: (itstool) path: formalpara/para
en: Preserve the network location, if any, given in the <_:link-1/> for public access to a <_:link-2/> copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the <_:quote-3/> section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
pt_BR: Preservar o endereço de rede, se existir algum, informado pelo <_:link-1/> para acesso público a uma cópia <_:link-2/> deste e, da mesma maneira, os endereços de rede dados no Documento para versões anteriores nas quais este se baseia. Estes podem ser colocados na seção <_:quote-3/>. Você pode omitir um endereço de rede para um trabalho que foi publicado pelo menos quatro anos antes do Documento em si, ou se o editor original da versão à qual o endereço se refere der permissão.

note: (itstool) path: para/quote
en: Acknowledgements
pt_BR: Agradecimentos

note: (itstool) path: para/quote
en: Dedications
pt_BR: Dedicatórias

note: (itstool) path: formalpara/para
en: In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
pt_BR: Preservar o título da seção para qualquer seção intitulada <_:quote-1/> ou <_:quote-2/> e preservar dentro da seção toda a substância e tom de cada um dos agradecimentos e/ou dedicatórias lá mencionados.

note: (itstool) path: formalpara/para
en: Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
pt_BR: Preservar todas as <_:link-1/> do <_:link-2/>, sem alterações em seus textos e títulos. Números de seção ou o equivalente não são considerados parte dos títulos das seções.

note: (itstool) path: para/quote
en: Endorsements
pt_BR: Apoio

note: (itstool) path: formalpara/para
en: Delete any section entitled <_:quote-1/>. Such a section may not be included in the <_:link-2/>.
pt_BR: Apagar qualquer seção intitulada <_:quote-1/>. Tal seção não deve ser incluída na <_:link-2/>.

note: (itstool) path: para/link
en: Invariant Section
pt_BR: Seção invariante

note: (itstool) path: formalpara/para
en: Do not retitle any existing section as <_:quote-1/> or to conflict in title with any <_:link-2/>.
pt_BR: Não renomear o título de qualquer seção existente como <_:quote-1/> ou que resulte em conflito com o título de qualquer <_:link-2/>.

note: (itstool) path: sect1/para
en: If the <_:link-1/> includes new front-matter sections or appendices that qualify as <_:link-2/> and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of <_:link-3/> in the Modified Version's license notice. These titles must be distinct from any other section titles.
pt_BR: Se a <_:link-1/> incluir novas seções iniciais ou apêndices que sejam qualificados como <_:link-2/>, e não contiver material copiado do Documento, você pode, a seu critério, tornar algumas dessas ou todas essas seções em invariantes. Para fazer isso, adicione seus títulos à lista de <_:link-3/> na nota de licença da Versão Modificada. Estes títulos devem ser distintos de quaisquer outros títulos de seções.

note: (itstool) path: sect1/para
en: You may add a section entitled <_:quote-1/>, provided it contains nothing but endorsements of your <_:link-2/> by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
pt_BR: Você pode incluir uma seção intitulada <_:quote-1/>, desde que esta contenha apenas apoios recebidos limitados a sua <_:link-2/> por várias fontes -- por exemplo, notas do revisor ou de que o texto foi aprovado por uma organização como a definição oficial de um padrão.

note: (itstool) path: para/link
en: Front-Cover Text
pt_BR: Texto de Capa Frontal

note: (itstool) path: para/link
en: Back-Cover Text
pt_BR: Texto de Contracapa

note: (itstool) path: sect1/para
en: You may add a passage of up to five words as a <_:link-1/>, and a passage of up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the <_:link-5/> already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
pt_BR: Você pode adicionar uma passagem de até cinco palavras como <_:link-1/>, e uma passagem de até 25 palavras como <_:link-2/>, ao fim da lista de <_:link-3/> na <_:link-4/>. Somente uma passagem de Texto de Capa Frontal e uma de Texto de Contracapa podem ser adicionados por (ou através de arranjos feitos por) uma entidade qualquer. Caso o <_:link-5/> já incluir um texto de capa para a mesma capa, previamente incluído por você ou pelo arranjo feito pela mesma entidade em cujo nome você está agindo, você não poderá adicionar outro; mas você poderá substituir o antigo, com a permissão explícita do editor anterior, que o incluiu.

note: (itstool) path: sect1/para
en: The author(s) and publisher(s) of the <_:link-1/> do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any <_:link-2/>.
pt_BR: O(s) autor(es) e editor(es) do <_:link-1/>, por esta Licença, não concedem permissão para que seus nomes sejam usados a fins de publicidade, para defesa ou para apoio implícito de qualquer <_:link-2/>.

note: (itstool) path: para/link
en: section 4
pt_BR: seção 4

note: (itstool) path: sect1/para
en: You may combine the <_:link-1/> with other documents released under this License, under the terms defined in <_:link-2/> above for modified versions, provided that you include in the combination all of the <_:link-3/> of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
pt_BR: Você pode combinar o <_:link-1/> com outros documentos publicados sob esta Licença, sob os termos definidos na <_:link-2/> acima para versões modificadas, desde que você inclua na combinação todas as <_:link-3/> de todos os documentos originais, sem modificações, e as liste como Seções Invariantes de seu trabalho combinado, na sua nota de licença.

note: (itstool) path: sect1/para
en: The combined work need only contain one copy of this License, and multiple identical <_:link-1/> may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
pt_BR: O trabalho combinado precisa conter somente uma cópia desta Licença, e várias <_:link-1/> idênticas podem ser substituídas por uma única cópia. Se existirem várias Seções Invariantes de mesmo nome, porém com conteúdos diferentes, você deve tornar o título de cada uma destas seções único, adicionando ao fim destes, entre parênteses, o nome do autor ou, se conhecido, o editor original desta seção, ou ainda um número único. Faça o mesmo ajuste nos títulos de seção na lista de Seções Invariantes na nota de licença do trabalho combinado.

note: (itstool) path: para/quote
en: Endorsements.
pt_BR: Apoios.

note: (itstool) path: sect1/para
en: In the combination, you must combine any sections entitled <_:quote-1/> in the various original documents, forming one section entitled <_:quote-2/>; likewise combine any sections entitled <_:quote-3/>, and any sections entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>
pt_BR: Na combinação, você deve combinar quaisquer seções intituladas <_:quote-1/> nos vários documentos originais, formando uma seção intitulada <_:quote-2/>; do mesmo modo, combine quaisquer seções intituladas <_:quote-3/>, e quaisquer seções intituladas <_:quote-4/>. Você deve apagar todas as seções intituladas <_:quote-5/>.

note: (itstool) path: sect1/para
en: You may make a collection consisting of the <_:link-1/> and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
pt_BR: Você pode fazer uma coleção que consiste do <_:link-1/> e outros documentos publicados sob esta Licença, e substituir as cópias individuais desta Licença, nos vários documentos, por uma única cópia a ser incluída na coleção, desde que você siga as regras desta Licença para cópias literais de cada documento em todos os outros aspectos.

note: (itstool) path: para/quote
en: aggregate
pt_BR: agregação

note: (itstool) path: para/link
en: Cover Text
pt_BR: Capa de Texto

note: (itstool) path: sect1/para
en: A compilation of the <_:link-1/> or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a <_:link-2/> of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an <_:quote-3/>, and this License does not apply to the other self-contained works thus compiled with the Document , on account of their being thus compiled, if they are not themselves derivative works of the Document. If the <_:link-4/> requirement of <_:link-5/> is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
pt_BR: Uma compilação do <_:link-1/> ou seus derivados com outros documentos ou trabalhos separados e independentes, dentro de ou sob um volume de um meio de armazenamento ou distribuição, não conta como um todo para uma <_:link-2/> do Documento, contanto que nenhum direito autoral de compilação seja reivindicado para esta compilação. Tal compilação configura um <_:quote-3/> e esta Licença não se aplica aos outros trabalhos contidos na compilação do Documento, levando em conta serem compilados, caso eles mesmos não forem trabalhos derivados do Documento. Se o requisito de <_:link-4/> da <_:link-5/> é aplicável a estas cópias do Documento, e ainda se o Documento é menor do que um quarto do agregado inteiro, os Textos de Capa do Documento podem ser inseridos nas capas que envolvem somente o Documento no agregado. Caso contrário, eles devem aparecer em capas em volta do agregado como um todo.

note: (itstool) path: sect1/para
en: Translation is considered a kind of modification, so you may distribute translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:link-3/> with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
pt_BR: Uma tradução é considerada como sendo um tipo de modificação, desta forma você pode distribuir traduções do <_:link-1/> sob os termos da <_:link-2/>. A substituição das <_:link-3/> por traduções requer permissão especial dos detentores dos direitos autorais, embora você possa incluir traduções de algumas ou todas as Seções Invariantes juntamente às versões originais destas. Você pode incluir uma tradução desta Licença, desde que você também inclua a versão original em Inglês desta Licença. Em caso de discordância entre a tradução e a versão original desta Licença ou nota de licença, a versão original em inglês prevalecerá.

note: (itstool) path: sect1/para
en: You may not copy, modify, sublicense, or distribute the <_:link-1/> except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
pt_BR: Você não pode copiar, modificar, sublicenciar, ou distribuir o <_:link-1/> com exceção do que foi expressamente previsto sob esta Licença. Qualquer outra tentativa de cópia, modificação, sublicenciamento ou distribuição do Documento é nula, e implicará na rescisão automática de seus direitos sob esta Licença. Contudo, as partes que receberam as cópias, ou direitos, de você sob esta Licença não terão suas licenças rescindidas enquanto tais partes permanecerem em total acordo com a Licença.

note: (itstool) path: sect1/para
en: The <_:ulink-1/> may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <_:ulink-2/>.
pt_BR: A <_:ulink-1/> pode publicar novas versões, revisadas, da Licença de Documentação Livre GNU de tempos em tempos. Tais versões posteriores terão ideologia similar à presente versão, embora possam diferir em detalhes a fim de abordar novos problemas ou preocupações. Consulte: <_:ulink-2/>.

note: (itstool) path: para/quote
en: or any later version
pt_BR: ou qualquer versão posterior

note: (itstool) path: sect1/para
en: Each version of the License is given a distinguishing version number. If the <_:link-1/> specifies that a particular numbered version of this License <_:quote-2/> applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
pt_BR: É dado, a cada versão da Licença, um número de versão distinto. Se o <_:link-1/> especificar que um número de versão em específico desta Licença <_:quote-2/> se aplica a ele, você tem a opção de seguir os termos e condições tanto da versão especificada quanto de qualquer versão posterior que tenha sido publicada (não como rascunho) pela Free Software Foundation. Se o documento não especificar um número de versão desta Licença, você pode escolher qualquer versão já publicada (não como rascunho) pela Free Software Foundation.

note: (itstool) path: para/link
en: Front-Cover Texts
pt_BR: Textos de Capa Frontal

note: (itstool) path: para/link
en: Back-Cover Texts
pt_BR: Textos de Contracapa

note: (itstool) path: blockquote/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the <_:link-1/> being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:link-3/> being LIST. A copy of the license is included in the section entitled <_:quote-4/>.
pt_BR: Permissão concedida para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU (GNU Free Documentation License), Versão 1.1 ou qualquer versão mais recente publicada pela Free Software Foundation; com as <_:link-1/>, sendo LISTADO SEUS TÍTULOS, com os <_:link-2/> sendo LISTADOS, e com os <_:link-3/> sendo LISTADOS. Uma cópia da licença está inclusa na seção intitulada <_:quote-4/>.

note: (itstool) path: para/quote
en: with no Invariant Sections
pt_BR: sem Seções Invariantes

note: (itstool) path: para/quote
en: no Front-Cover Texts
pt_BR: sem Textos de Capa Frontal

note: (itstool) path: para/quote
en: Front-Cover Texts being LIST
pt_BR: Textos de Capa Frontal sendo LISTADOS

note: (itstool) path: sect1/para
en: If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:quote-5/>; likewise for <_:link-6/>.
pt_BR: Se você não tiver qualquer <_:link-1/>, escreva <_:quote-2/> ao invés de afirmar quais são invariantes. Se você não tem <_:link-3/>, escreva <_:quote-4/> ao invés de <_:quote-5/>; O mesmo se aplica a <_:link-6/>.

note: (itstool) path: para/ulink
en: GNU General Public License
pt_BR: Licença Pública Geral GNU (GPL)

note: (itstool) path: sect1/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the <_:ulink-1/>, to permit their use in free software.
pt_BR: Se seu documento contiver exemplos não-triviais de código de programação, recomendamos publicar estes exemplos paralelamente, sob a licença de software livre que você escolher, como, por exemplo, a <_:ulink-1/>, para permitir seu uso em software livre.
