[gtk-doc] Updated Galician translations
- From: Francisco Diéguez Souto <frandieguez src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk-doc] Updated Galician translations
- Date: Tue, 23 Sep 2014 00:12:13 +0000 (UTC)
commit c9580b6be16331df71b93c41e9606da8adb69385
Author: Fran Diéguez <fran dieguez mabishu com>
Date: Tue Sep 23 02:11:42 2014 +0200
Updated Galician translations
help/manual/Makefile.am | 2 +-
help/manual/gl/gl.po | 3842 +++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 3843 insertions(+), 1 deletions(-)
---
diff --git a/help/manual/Makefile.am b/help/manual/Makefile.am
index b5a7480..ae8af76 100644
--- a/help/manual/Makefile.am
+++ b/help/manual/Makefile.am
@@ -8,7 +8,7 @@ HELP_FILES = \
index.docbook \
fdl-appendix.xml
-HELP_LINGUAS = bn_IN de el en_GB es fr gu pt_BR sl sv ta te zh_CN
+HELP_LINGUAS = bn_IN de el en_GB es fr gl gu pt_BR sl sv ta te zh_CN
CLEANFILES = $(_HELP_LC_FILES) $(_HELP_LC_STAMPS) $(_HELP_MOFILES)
diff --git a/help/manual/gl/gl.po b/help/manual/gl/gl.po
new file mode 100644
index 0000000..ffcb946
--- /dev/null
+++ b/help/manual/gl/gl.po
@@ -0,0 +1,3842 @@
+# Galician translation for gtk-doc.
+# Copyright (C) 2014 gtk-doc's COPYRIGHT HOLDER
+# This file is distributed under the same license as the gtk-doc package.
+# Fran Dieguez <frandieguez gnome org>, 2014.
+msgid ""
+msgstr ""
+"Project-Id-Version: gtk-doc master\n"
+"POT-Creation-Date: 2014-09-22 21:18+0000\n"
+"PO-Revision-Date: 2014-09-23 02:11+0200\n"
+"Last-Translator: Fran Dieguez <frandieguez gnome org>\n"
+"Language-Team: gnome-l10n-gl gnome org\n"
+"Language: gl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"X-Generator: Virtaal 0.7.1\n"
+
+#. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
+msgctxt "_"
+msgid "translator-credits"
+msgstr "Fran Diéguez <frandieguez gnome org>, 2014."
+
+#. (itstool) path: bookinfo/title
+#: C/index.docbook:12
+msgid "GTK-Doc Manual"
+msgstr "Manual de GTK-Doc"
+
+#. (itstool) path: bookinfo/edition
+#: C/index.docbook:13
+msgid "1.20"
+msgstr "1.20"
+
+#. (itstool) path: abstract/para
+#: C/index.docbook:14
+msgid "User manual for developers with instructions of GTK-Doc usage."
+msgstr ""
+"Manual de usuarios para desenvolvedores con instrucións do uso de GTK-Doc."
+
+#. (itstool) path: authorgroup/author
+#: C/index.docbook:16
+msgid ""
+"<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
+"<address> <email>chris wilddev net</email> </address> </affiliation>"
+msgstr ""
+"<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
+"<address> <email>chris wilddev net</email> </address> </affiliation>"
+
+#. (itstool) path: authorgroup/author
+#: C/index.docbook:25
+msgid ""
+"<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
+"<email>d-mueth uchicago edu</email> </address> </affiliation>"
+msgstr ""
+"<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
+"<email>d-mueth uchicago edu</email> </address> </affiliation>"
+
+#. (itstool) path: authorgroup/author
+#: C/index.docbook:34
+msgid ""
+"<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
+"<address> <email>ensonic users sf net</email> </address> </affiliation>"
+msgstr ""
+"<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
+"<address> <email>ensonic users sf net</email> </address> </affiliation>"
+
+#. (itstool) path: publisher/publishername
+#: C/index.docbook:45
+msgid "GTK-Doc project"
+msgstr "Proxecto GTK-Doc"
+
+#. (itstool) path: bookinfo/publisher
+#: C/index.docbook:44
+msgid ""
+"<_:publishername-1/> <address><email>gtk-doc-list gnome org</email></address>"
+msgstr ""
+"<_:publishername-1/> <address><email>gtk-doc-list gnome org</email></address>"
+
+#. (itstool) path: bookinfo/copyright
+#: C/index.docbook:48
+msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
+msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
+
+#. (itstool) path: bookinfo/copyright
+#: C/index.docbook:52
+msgid "<year>2007-2014</year> <holder>Stefan Sauer (Kost)</holder>"
+msgstr "<year>2007-2014</year> <holder>Stefan Sauer (Kost)</holder>"
+
+#. (itstool) path: legalnotice/para
+#: C/index.docbook:65
+msgid ""
+"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>."
+msgstr ""
+"Pode copiar, distribuír e modificar este documento baixo os termos da "
+"<citetitle>Licenza de Documentación Libre GNU</citetitle>, na súa versión "
+"1.1 ou posterior, publicada pola Free Software Foundation, sen seccións "
+"invariantes e sen textos de portada ou de contraportada. <link linkend=\""
+"fdl\">Inclúese</link> unha cópida da licenza."
+
+#. (itstool) path: legalnotice/para
+#: C/index.docbook:73
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:83
+msgid ""
+"<revnumber>1.21.1</revnumber> <date>18 Jul 2014</date> <authorinitials>ss</"
+"authorinitials> <revremark>development version</revremark>"
+msgstr ""
+"<revnumber>1.21.1</revnumber> <date>18 de Xullo de 2014</date> "
+"<authorinitials>ss</authorinitials> <revremark>versión de "
+"desenvolvemento</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:89
+msgid ""
+"<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
+"authorinitials> <revremark>bug fixes, dropping deprecated features</"
+"revremark>"
+msgstr ""
+"<revnumber>1.21</revnumber> <date>17 de Xullo de 2014</date> "
+"<authorinitials>ss</authorinitials> <revremark>arranxos de erros, retirado "
+"de características obsoletas</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:95
+msgid ""
+"<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
+"authorinitials> <revremark>bug fixes, markdown support, style improvements</"
+"revremark>"
+msgstr ""
+"<revnumber>1.20</revnumber> <date>16 de Febreiro de 2014</date> "
+"<authorinitials>ss</authorinitials> <revremark>arranxos de erros, "
+"compatibilidade de markdown, melloras de estilo</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:101
+msgid ""
+"<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
+"authorinitials> <revremark>bug fixes</revremark>"
+msgstr ""
+"<revnumber>1.19</revnumber> <date>05 de Xuño de 2013</date> "
+"<authorinitials>ss</authorinitials> <revremark>arranxos de erros</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:107
+msgid ""
+"<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
+"authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
+msgstr ""
+"<revnumber>1.18</revnumber> <date>14 de Setembro de 2011</date> "
+"<authorinitials>ss</authorinitials> <revremark>arranxos de erros, melloras "
+"de velocidade, compatibilidade de markdown</revremark>"
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:113
+msgid ""
+"<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
+"authorinitials> <revremark>urgent bug fix update</revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:119
+msgid ""
+"<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
+"authorinitials> <revremark>bugfixes, layout improvements</revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:125
+msgid ""
+"<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
+"authorinitials> <revremark>bug and regression fixes</revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:131
+msgid ""
+"<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
+"authorinitials> <revremark>bugfixes and performance improvements</revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:137
+msgid ""
+"<revnumber>1.13</revnumber> <date>18 December 2009</date> "
+"<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
+"revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:143
+msgid ""
+"<revnumber>1.12</revnumber> <date>18 December 2009</date> "
+"<authorinitials>sk</authorinitials> <revremark>new tool features and "
+"bugfixes</revremark>"
+msgstr ""
+
+#. (itstool) path: revhistory/revision
+#: C/index.docbook:149
+msgid ""
+"<revnumber>1.11</revnumber> <date>16 November 2008</date> "
+"<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
+"revremark>"
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:162
+msgid "Introduction"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:164
+msgid ""
+"This chapter introduces GTK-Doc and gives an overview of what it is and how "
+"it is used."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:170
+msgid "What is GTK-Doc?"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:172
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:180
+msgid "How Does GTK-Doc Work?"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:182
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:189
+msgid ""
+"GTK-Doc consists of a number of perl scripts, each performing a different "
+"step in the process."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:194
+msgid "There are 5 main steps in the process:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:201
+msgid ""
+"<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)."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:211
+msgid ""
+"<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><module>-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><module>-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><"
+"module>-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><module>-decl.txt</filename> into <filename><"
+"module>-overrides.txt</filename>."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:228
+msgid ""
+"<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."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:234
+msgid ""
+"<application>gtkdoc-scanobj</application> should not be used anymore. It was "
+"needed in the past when GObject was still GtkObject inside gtk+."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:241
+msgid ""
+"<guilabel>Generating the \"template\" files.</guilabel> <application>gtkdoc-"
+"mktmpl</application> creates a number of files in the <filename class="
+"\"directory\">tmpl/</filename> subdirectory, using the information gathered "
+"in the first step. (Note that this can be run repeatedly. It will try to "
+"ensure that no documentation is ever lost.)"
+msgstr ""
+
+#. (itstool) path: note/para
+#: C/index.docbook:250
+msgid ""
+"Since GTK-Doc 1.9 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. If you have never changed file in tmpl by hand, "
+"please remove the directory (e.g. from version control system)."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:262
+msgid ""
+"<guilabel>Generating the SGML/XML and HTML/PDF.</guilabel> "
+"<application>gtkdoc-mkdb</application> turns the template files into SGML or "
+"XML files in the <filename class=\"directory\">sgml/</filename> or <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. We recommend to use Docbook XML."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:273
+msgid ""
+"<application>gtkdoc-mkhtml</application> turns the SGML/XML files into HTML "
+"files in the <filename class=\"directory\">html/</filename> subdirectory. "
+"Likewise <application>gtkdoc-mkpdf</application> turns the SGML/XML files "
+"into a PDF document called <filename><package>.pdf</filename>."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:279
+msgid ""
+"Files in <filename class=\"directory\">sgml/</filename> or <filename class="
+"\"directory\">xml/</filename> and <filename class=\"directory\">html/</"
+"filename> directories are always overwritten. One should never edit them "
+"directly."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:287
+msgid ""
+"<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)."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:305
+msgid "Getting GTK-Doc"
+msgstr ""
+
+#. (itstool) path: sect2/title
+#: C/index.docbook:308
+msgid "Requirements"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:309
+msgid "<guilabel>Perl v5</guilabel> - the main scripts are in Perl."
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:312
+msgid ""
+"<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
+"\"http://xmlsoft.org/XSLT/\"; type=\"http\">xmlsoft.org/XSLT/</ulink>"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:316
+msgid ""
+"<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>"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:320
+msgid "<guilabel>Python</guilabel> - optional - for gtkdoc-depscan"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:323
+msgid ""
+"One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
+"or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
+"examples"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:331
+msgid "About GTK-Doc"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:333 C/index.docbook:347
+msgid "(FIXME)"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:337
+msgid ""
+"(History, authors, web pages, mailing list, license, future plans, "
+"comparison with other similar systems.)"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:345
+msgid "About this Manual"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:351
+msgid "(who it is meant for, where you can get it, license)"
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:360
+msgid "Setting up your project"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:362
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:373
+msgid "Setting up a skeleton documentation"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:375
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:384
+msgid "Example directory structure"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:385
+#, no-wrap
+msgid ""
+"\n"
+"meep/\n"
+" docs/\n"
+" reference/\n"
+" libmeep/\n"
+" meeper/\n"
+" src/\n"
+" libmeep/\n"
+" meeper/\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:382
+msgid "This can then look as shown below: <_:example-1/>"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#. (itstool) path: example/title
+#: C/index.docbook:400 C/index.docbook:407
+msgid "Integration with autoconf"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:402
+msgid ""
+"Very easy! Just add one line to your <filename>configure.ac</filename> "
+"script."
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:408
+#, no-wrap
+msgid ""
+"\n"
+"# check for gtk-doc\n"
+"GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:420
+msgid "Keep gtk-doc optional"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:421
+#, no-wrap
+msgid ""
+"\n"
+"# check for gtk-doc\n"
+"m4_ifdef([GTK_DOC_CHECK], [\n"
+"GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
+"],[\n"
+"AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
+"])\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:415
+msgid ""
+"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/>"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:432
+msgid ""
+"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:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:438
+msgid "--with-html-dir=PATH : path to installed docs"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:439
+msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:440
+msgid ""
+"--enable-gtk-doc-html : build documentation in html format [default=yes]"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:441
+msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
+msgstr ""
+
+#. (itstool) path: important/para
+#: C/index.docbook:445
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:453
+msgid ""
+"Furthermore it is recommended that you have the following line inside you "
+"<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."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:461
+msgid "Preparation for gtkdocize"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:462
+#, no-wrap
+msgid ""
+"\n"
+"AC_CONFIG_MACRO_DIR(m4)\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:467
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:475
+msgid "Integration with automake"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:477
+msgid ""
+"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/<package></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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:488
+msgid ""
+"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><TOOLNAME>_OPTIONS</option>. "
+"All the tools support <option>--help</option> to list the supported "
+"parameters."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:502
+msgid "Integration with autogen"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:504
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:513
+msgid "Running gtkdocize from autogen.sh"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:514
+#, no-wrap
+msgid ""
+"\n"
+"gtkdocize || exit 1\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:520
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:529
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#. (itstool) path: example/title
+#: C/index.docbook:546 C/index.docbook:563
+msgid "Running the doc build"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:548
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:555
+msgid ""
+"The first make run generates several additional files in the doc-"
+"directories. The important ones are: <filename><package>.types</"
+"filename>, <filename><package>-docs.xml</filename> (in the past ."
+"sgml), <filename><package>-sections.txt</filename>."
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:564
+#, no-wrap
+msgid ""
+"\n"
+"./autogen.sh --enable-gtk-doc\n"
+"make\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:570
+msgid ""
+"Now you can point your browser to <filename>docs/reference/<package>/"
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:578
+msgid "Integration with version control systems"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:580
+msgid ""
+"As a rule of the thumb, it's those files you edit, that should go under "
+"version control. For typical projects it's these files: <filename><"
+"package>.types</filename>, <filename><package>-docs.xml</filename> "
+"(in the past .sgml), <filename><package>-sections.txt</filename>, "
+"<filename>Makefile.am</filename>"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:591
+msgid "Integration with plain makefiles or other build systems"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:593
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:600
+msgid "Documentation build steps"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:601
+#, no-wrap
+msgid ""
+"\n"
+"DOC_MODULE=meep\n"
+"// sources have changed\n"
+"gtkdoc-scan --module=$(DOC_MODULE) --source-dir=...\n"
+"gtkdoc-scangobj --module=$(DOC_MODULE)\n"
+"gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml\n"
+"// xml files have changed\n"
+"mkdir html\n"
+"cd html && gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
+"gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:615
+msgid ""
+"One will need to look at the <filename>Makefile.am</filename> and "
+"<filename>gtk-doc.mak</filename> to pick the extra options needed."
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:624
+msgid "Documenting the code"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:626
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: note/title
+#: C/index.docbook:634
+msgid "Documentation placement"
+msgstr ""
+
+#. (itstool) path: note/para
+#: C/index.docbook:635
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: note/para
+#: C/index.docbook:641
+msgid ""
+"The avoid the aforementioned problems we suggest putting the documentation "
+"inside the sources. This manual will only describe this way of documenting "
+"code."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:652 C/index.docbook:669
+msgid "GTK-Doc comment block"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:653
+#, no-wrap
+msgid ""
+"\n"
+"#ifndef __GTK_DOC_IGNORE__\n"
+"/* unparseable code here */\n"
+"#endif\n"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:648
+msgid ""
+"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/>"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:664
+msgid "Documentation comments"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:670
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * identifier:\n"
+" * documentation ...\n"
+" */\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:666
+msgid ""
+"A multiline comment that starts with an additional '*' marks a documentation "
+"block that will be processed by the GTK-Doc tools. <_:example-1/>"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:679
+msgid ""
+"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)"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:685
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:702
+msgid ""
+"What it is: The name for a class or function can sometimes be misleading for "
+"people coming from a different background."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:708
+msgid ""
+"What it does: Tell about common uses. Put it in relation with the other API."
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:698
+msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:723
+msgid "Use function() to refer to functions or macros which take arguments."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:728
+msgid ""
+"Use @param to refer to parameters. Also use this when referring to "
+"parameters of other functions, related to the one being described."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:734
+msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:739
+msgid ""
+"Use #symbol to refer to other types of symbol, e.g. structs and enums and "
+"macros which don't take arguments."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:745
+msgid "Use #Object::signal to refer to a GObject signal."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:750
+msgid "Use #Object:property to refer to a GObject property."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:755
+msgid ""
+"Use #Struct.field to refer to a field inside a structure and #GObjectClass."
+"foo_bar() to refer to a vmethod."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:717
+msgid ""
+"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/>"
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:764
+msgid ""
+"If you need to use the special characters '<', '>', '()', '@', '%', or "
+"'#' in your documentation without GTK-Doc changing them you can use the XML "
+"entities \"&lt;\", \"&gt;\", \"&lpar;\", \"&rpar;\", \"&"
+"commat;\", \"&percnt;\" and \"&num;\" respectively or escape them "
+"with a backslash '\\'."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:773
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:784
+msgid ""
+"In older GTK-Doc releases, if you need support for additional formatting, "
+"you would need to enable the usage of docbook SGML/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>."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:794
+msgid "GTK-Doc comment block using Markdown"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:795
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * identifier:\n"
+" *\n"
+" * documentation paragraph ...\n"
+" *\n"
+" * # Sub Heading #\n"
+" *\n"
+" * ## Second Sub Heading\n"
+" *\n"
+" * # Sub Heading With a Link Anchor # {#heading-two}\n"
+" *\n"
+" * more documentation:\n"
+" *\n"
+" * - list item 1\n"
+" *\n"
+" * Paragraph inside a list item.\n"
+" *\n"
+" * - list item 2\n"
+" *\n"
+" * 1. numbered list item\n"
+" *\n"
+" * 2. another numbered list item\n"
+" *\n"
+" * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
+" *\n"
+" * ![an inline image][plot-result.png]\n"
+" *\n"
+" * [A link to the heading anchor above][heading-two]\n"
+" *\n"
+" * A C-language example:\n"
+" * |[<!-- language=\"C\" -->\n"
+" * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
+" * ]|\n"
+" */\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:834
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:840
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:854
+msgid "Documenting sections"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:856
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:864
+msgid "Section comment block"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:865
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * SECTION:meepapp\n"
+" * @short_description: the application class\n"
+" * @title: Meep application\n"
+" * @section_id:\n"
+" * @see_also: #MeepSettings\n"
+" * @stability: Stable\n"
+" * @include: meep/app.h\n"
+" * @image: application.png\n"
+" *\n"
+" * The application class handles ...\n"
+" */\n"
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:884
+msgid "SECTION:<name>"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:886
+msgid ""
+"The name links the section documentation to the respective part in the "
+"<filename><package>-sections.txt</filename> file. The name give here "
+"should match the <FILE> tag in the <filename><package>-sections."
+"txt</filename> file."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:895
+msgid "@short_description"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:897
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:904
+msgid "@title"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:906
+msgid ""
+"The section title defaults to <name> from the SECTION declaration. It "
+"can be overridden with the @title field."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:913
+msgid "@section_id"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:915
+msgid ""
+"Overrides the use of title as a section identifier. For GObjects the <"
+"title> is used as a section_id and for other sections it is <"
+"MODULE>-<title>."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:923
+msgid "@see_also"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:925
+msgid "A list of symbols that are related to this section."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:931
+msgid "@stability"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:938
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:950
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:962
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:971
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:933
+msgid ""
+"An informal description of the stability level this API has. We recommend "
+"the use of one of these terms: <_:itemizedlist-1/>"
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:983
+msgid "@include"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:985
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:994
+msgid "@image"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:996
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:1007
+msgid ""
+"To avoid unnecessary recompilation after doc-changes put the section docs "
+"into the c-source where possible."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1016
+msgid "Documenting symbols"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1018
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1026 C/index.docbook:1055
+msgid "General tags"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1028
+msgid ""
+"You can add versioning information to all documentation elements to tell "
+"when an API was introduced, or when it was deprecated."
+msgstr ""
+
+#. (itstool) path: variablelist/title
+#: C/index.docbook:1033
+msgid "Versioning Tags"
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:1034
+msgid "Since:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1036
+msgid "Description since which version of the code the API is available."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:1041
+msgid "Deprecated:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1043
+msgid ""
+"Paragraph denoting that this function should no be used anymore. The "
+"description should point the reader to the new API."
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1051
+msgid "(FIXME : Stability information)"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1056
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * foo_get_bar:\n"
+" * @foo: some foo\n"
+" *\n"
+" * Retrieves @foo's bar.\n"
+" *\n"
+" * Returns: @foo's bar\n"
+" *\n"
+" * Since: 2.6\n"
+" * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
+" */\n"
+"Bar *\n"
+"foo_get_bar(Foo *foo)\n"
+"{\n"
+"...\n"
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1076 C/index.docbook:1112
+msgid "Function comment block"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1082
+msgid ""
+"Document whether returned objects, lists, strings, etc, should be freed/"
+"unrefed/released."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1088
+msgid "Document whether parameters can be NULL, and what happens if they are."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1093
+msgid ""
+"Mention interesting pre-conditions and post-conditions where appropriate."
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1078 C/index.docbook:1171
+msgid "Please remember to: <_:itemizedlist-1/>"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1100
+msgid ""
+"Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
+"private. They are treated like static functions."
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1105
+msgid ""
+"Also, take a look at GObject Introspection annotation tags: http://live.";
+"gnome.org/GObjectIntrospection/Annotations"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1113
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * function_name:\n"
+" * @par1: description of parameter 1. These can extend over more than\n"
+" * one line.\n"
+" * @par2: description of parameter 2\n"
+" * @...: a %NULL-terminated list of bars\n"
+" *\n"
+" * The function description goes here. You can use @par1 to refer to parameters\n"
+" * so that they are highlighted in the output. You can also use %constant\n"
+" * for constants, function_name2() for functions and #GtkWidget for links to\n"
+" * other declarations (which may be documented elsewhere).\n"
+" *\n"
+" * Returns: an integer.\n"
+" *\n"
+" * Since: 2.2\n"
+" * Deprecated: 2.18: Use other_function() instead.\n"
+" */\n"
+msgstr ""
+
+#. (itstool) path: variablelist/title
+#: C/index.docbook:1134
+msgid "Function tags"
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:1135
+msgid "Returns:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1137
+msgid "Paragraph describing the returned result."
+msgstr ""
+
+#. (itstool) path: varlistentry/term
+#: C/index.docbook:1142
+msgid "@...:"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1144
+msgid ""
+"In case the function has variadic arguments, you should use this tag "
+"(@Varargs: does also work for historic reasons)."
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1154 C/index.docbook:1156
+msgid "Property comment block"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1157
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * SomeWidget:some-property:\n"
+" *\n"
+" * Here you can document a property.\n"
+" */\n"
+"g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1169 C/index.docbook:1188
+msgid "Signal comment block"
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1175
+msgid ""
+"Document when the signal is emitted and whether it is emitted before or "
+"after other signals."
+msgstr ""
+
+#. (itstool) path: listitem/para
+#: C/index.docbook:1181
+msgid "Document what an application might do in the signal handler."
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1189
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * FooWidget::foobarized:\n"
+" * @widget: the widget that received the signal\n"
+" * @foo: some foo\n"
+" * @bar: some bar\n"
+" *\n"
+" * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
+" */\n"
+"foo_signals[FOOBARIZE] =\n"
+" g_signal_new (\"foobarize\",\n"
+" ...\n"
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1206 C/index.docbook:1207
+msgid "Struct comment block"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1208
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * FooWidget:\n"
+" * @bar: some #gboolean\n"
+" *\n"
+" * This is the best widget, ever.\n"
+" */\n"
+"typedef struct _FooWidget {\n"
+" /*< private >*/\n"
+" GtkWidget parent;\n"
+"\n"
+" /*< public >*/\n"
+" gboolean bar;\n"
+"} FooWidget;\n"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1225
+msgid ""
+"Use <code>/*< private >*/</code> before the private struct fields you "
+"want to hide. Use <code>/*< public >*/</code> for the reverse "
+"behaviour."
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1231
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: sect2/title
+#. (itstool) path: example/title
+#: C/index.docbook:1243 C/index.docbook:1244
+msgid "Enum comment block"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1245
+#, no-wrap
+msgid ""
+"\n"
+"/**\n"
+" * Something:\n"
+" * @SOMETHING_FOO: something foo\n"
+" * @SOMETHING_BAR: something bar\n"
+" *\n"
+" * Enum values used for the thing, to specify the thing.\n"
+" */\n"
+"typedef enum {\n"
+" SOMETHING_FOO,\n"
+" SOMETHING_BAR,\n"
+" /*< private >*/\n"
+" SOMETHING_COUNT\n"
+"} Something;\n"
+msgstr ""
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1262
+msgid ""
+"Use <code>/*< private >*/</code> before the private enum values you "
+"want to hide. Use <code>/*< public >*/</code> for the reverse "
+"behaviour."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1272
+msgid "Useful DocBook tags"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1274
+msgid ""
+"Here are some DocBook tags which are most useful when documenting the code."
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1283
+#, no-wrap
+msgid ""
+"\n"
+"<link linkend=\"glib-Hash-Tables\">Hash Tables</link>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1279
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1296
+#, no-wrap
+msgid ""
+"\n"
+"<function>...</function>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1293
+msgid ""
+"To refer to an external function, e.g. a standard C function: <_:"
+"informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1305
+#, no-wrap
+msgid ""
+"\n"
+"<example>\n"
+" <title>Using a GHashTable.</title>\n"
+" <programlisting>\n"
+" ...\n"
+" </programlisting>\n"
+"</example>\n"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1316
+#, no-wrap
+msgid ""
+"\n"
+"<informalexample>\n"
+" <programlisting>\n"
+" ...\n"
+" </programlisting>\n"
+"</informalexample>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1302
+msgid ""
+"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: |[ ... ]|"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1335
+#, no-wrap
+msgid ""
+"\n"
+"<itemizedlist>\n"
+" <listitem>\n"
+" <para>\n"
+" ...\n"
+" </para>\n"
+" </listitem>\n"
+" <listitem>\n"
+" <para>\n"
+" ...\n"
+" </para>\n"
+" </listitem>\n"
+"</itemizedlist>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1332
+msgid "To include bulleted lists: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1355
+#, no-wrap
+msgid ""
+"\n"
+"<note>\n"
+" <para>\n"
+" Make sure you free the data after use.\n"
+" </para>\n"
+"</note>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1352
+msgid ""
+"To include a note which stands out from the text: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1368
+#, no-wrap
+msgid ""
+"\n"
+"<type>unsigned char</type>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1365
+msgid "To refer to a type: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1377
+#, no-wrap
+msgid ""
+"\n"
+"<structname>XFontStruct</structname>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1374
+msgid ""
+"To refer to an external structure (not one described in the GTK docs): <_:"
+"informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1386
+#, no-wrap
+msgid ""
+"\n"
+"<structfield>len</structfield>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1383
+msgid "To refer to a field of a structure: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1395
+#, no-wrap
+msgid ""
+"\n"
+"<classname>GtkWidget</classname>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1392
+msgid ""
+"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>)."
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1406
+#, no-wrap
+msgid ""
+"\n"
+"<emphasis>This is important</emphasis>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1403
+msgid "To emphasize text: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1415
+#, no-wrap
+msgid ""
+"\n"
+"<filename>/home/user/documents</filename>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1412
+msgid "For filenames use: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: informalexample/programlisting
+#: C/index.docbook:1424
+#, no-wrap
+msgid ""
+"\n"
+"<keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1421
+msgid "To refer to keys use: <_:informalexample-1/>"
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1434
+msgid "Filling the extra files"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1436
+msgid ""
+"There are a couple of extra files, that need to be maintained along with the "
+"inline source code comments: <filename><package>.types</filename>, "
+"<filename><package>-docs.xml</filename> (in the past .sgml), "
+"<filename><package>-sections.txt</filename>."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1445
+msgid "Editing the types file"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1447
+msgid ""
+"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><"
+"package>.types</filename> file."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:1456
+msgid "Example types file snippet"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1457
+#, no-wrap
+msgid ""
+"\n"
+"#include <gtk/gtk.h>\n"
+"\n"
+"gtk_accel_label_get_type\n"
+"gtk_adjustment_get_type\n"
+"gtk_alignment_get_type\n"
+"gtk_arrow_get_type\n"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1468
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1477
+msgid "Editing the master document"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1479
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1486
+msgid ""
+"While GTK-Doc creates a template master document for you, later run 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."
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:1496
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1505
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:1512
+msgid "Master document header"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1513
+#, no-wrap
+msgid ""
+"\n"
+"<bookinfo>\n"
+" <title>MODULENAME Reference Manual</title>\n"
+" <releaseinfo>\n"
+" for MODULENAME [VERSION]\n"
+" The latest version of this documentation can be found on-line at\n"
+" <ulink role=\"online-location\"
url=\"http://[SERVER]/MODULENAME/index.html\">http://[SERVER]/MODULENAME/</ulink>.\n";
+" </releaseinfo>\n"
+"</bookinfo>\n"
+"\n"
+"<chapter>\n"
+" <title>[Insert title here]</title>\n"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1532
+msgid "Editing the section file"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1534
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1540
+msgid ""
+"The section file is a plain text file with XML-like syntax (using tags). "
+"Blank lines are ignored and lines starting with a '#' are treated as comment "
+"lines."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1546
+msgid ""
+"The <FILE> ... </FILE> tag is used to specify the file name, "
+"without any suffix. For example, using '<FILE>gnome-config</"
+"FILE>' 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 SGML/XML file <filename>sgml/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)."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1558
+msgid ""
+"The <TITLE> ... </TITLE> 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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1565
+msgid ""
+"You can group items in the section by using the <SUBSECTION> tag. "
+"Currently it outputs a blank line between subsections in the synopsis "
+"section. You can also use <SUBSECTION Standard> 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 <SUBSECTION Private> 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)."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1584
+msgid ""
+"You can also use <INCLUDE> ... </INCLUDE> 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."
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1598
+msgid "Controlling the result"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1600
+msgid ""
+"A GTK-Doc run generates report files inside the documentation directory. The "
+"generated files are named: <filename><package>-undocumented.txt</"
+"filename>, <filename><package>-undeclared.txt</filename> and "
+"<filename><package>-unused.txt</filename>. All those are plain text "
+"files that can be viewed and postprocessed easily."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1609
+msgid ""
+"The <filename><package>-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."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1618
+msgid ""
+"The <filename><package>-undeclared.txt</filename> file lists symbols "
+"given in the <filename><package>-sections.txt</filename> but not found "
+"in the sources. Check if they have been removed or if they are misspelled."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1625
+msgid ""
+"The <filename><package>-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><package>-sections.txt</filename> file."
+msgstr ""
+
+#. (itstool) path: tip/para
+#: C/index.docbook:1633
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1640
+msgid ""
+"One can also look at the files produced by the source code scanner: "
+"<filename><package>-decl-list.txt</filename> and <filename><"
+"package>-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."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1649
+msgid ""
+"If the project is GObject based, one can also look into the files produced "
+"by the object scanner: <filename><package>.args.txt</filename>, "
+"<filename><package>.hierarchy.txt</filename>, <filename><"
+"package>.interfaces.txt</filename>, <filename><package>."
+"prerequisites.txt</filename> and <filename><package>.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>."
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1664
+msgid "Modernizing the documentation"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1666
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1672
+msgid "GTK-Doc 1.9"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1674
+msgid ""
+"When using xml instead of sgml, one can actually name the master document "
+"<filename><package>-docs.xml</filename>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1679
+msgid ""
+"This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
+"<filename>Makefile.am</filename>. When this is enabled, the <filename><"
+"package>-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 <package>-decl-list.txt <package>-"
+"sections.txt</code>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1690
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1700
+msgid "GTK-Doc 1.10"
+msgstr "GTK-Doc 1.10"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1702
+msgid ""
+"This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
+"<filename>Makefile.am</filename>. When this is enabled, the <filename><"
+"package>.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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1713
+msgid "GTK-Doc 1.16"
+msgstr "GTK-Doc 1.16"
+
+#. (itstool) path: example/title
+#: C/index.docbook:1719
+msgid "Enable gtkdoc-check"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1720
+#, no-wrap
+msgid ""
+"\n"
+"if ENABLE_GTK_DOC\n"
+"TESTS_ENVIRONMENT = \\\n"
+" DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
+" SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
+"TESTS = $(GTKDOC_CHECK)\n"
+"endif\n"
+msgstr ""
+"\n"
+"if ENABLE_GTK_DOC\n"
+"TESTS_ENVIRONMENT = \\\n"
+" DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
+" SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
+"TESTS = $(GTKDOC_CHECK)\n"
+"endif\n"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1715
+msgid ""
+"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/>"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1733
+msgid "GTK-Doc 1.20"
+msgstr "GTK-Doc 1.20"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1735
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1746
+msgid "Documenting other interfaces"
+msgstr "Documentando outras interfaces"
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1748
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1755
+msgid "Command line options and man pages"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1757
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect2/title
+#: C/index.docbook:1764
+msgid "Document the tool"
+msgstr "Documente a ferramenta"
+
+#. (itstool) path: sect2/para
+#: C/index.docbook:1766
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect2/title
+#: C/index.docbook:1776
+msgid "Adding the extra configure check"
+msgstr ""
+
+#. (itstool) path: example/title
+#: C/index.docbook:1779 C/index.docbook:1797
+msgid "Extra configure checks"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1780
+#, no-wrap
+msgid ""
+"\n"
+"AC_ARG_ENABLE(man,\n"
+" [AC_HELP_STRING([--enable-man],\n"
+" [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
+" enable_man=no)\n"
+"\n"
+"AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
+"AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
+msgstr ""
+
+#. (itstool) path: sect2/title
+#: C/index.docbook:1794
+msgid "Adding the extra makefile rules"
+msgstr ""
+
+#. (itstool) path: example/programlisting
+#: C/index.docbook:1798
+#, no-wrap
+msgid ""
+"\n"
+"man_MANS = \\\n"
+" meeper.1\n"
+"\n"
+"if ENABLE_GTK_DOC\n"
+"if ENABLE_MAN\n"
+"\n"
+"%.1 : %.xml\n"
+" @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<\n"
+"\n"
+"endif\n"
+"endif\n"
+"\n"
+"BUILT_EXTRA_DIST = $(man_MANS)\n"
+"EXTRA_DIST += meep.xml\n"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:1820
+msgid "DBus interfaces"
+msgstr "Intefaces de DBus"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:1822
+msgid ""
+"(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://";
+"cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1831
+msgid "Frequently asked questions"
+msgstr "Preguntas frecuentes"
+
+#. (itstool) path: segmentedlist/segtitle
+#: C/index.docbook:1835
+msgid "Question"
+msgstr "Pregunta"
+
+#. (itstool) path: segmentedlist/segtitle
+#: C/index.docbook:1836
+msgid "Answer"
+msgstr "Resposta"
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1838
+msgid "No class hierarchy."
+msgstr "Non hai herdanza de clases."
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1839
+msgid ""
+"The objects <function>xxx_get_type()</function> function has not been "
+"entered into the <filename><package>.types</filename> file."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1845
+msgid "Still no class hierarchy."
+msgstr "Aínda non hai herdanza de clases."
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1846
+msgid ""
+"Missing or wrong naming in <filename><package>-sections.txt</filename> "
+"file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-";
+"October/msg00006.html\">explanation</ulink>)."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1852
+msgid "Damn, I have still no class hierarchy."
+msgstr "Redemo, aínda non hai herdanza de clase."
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1853
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1860
+msgid "No symbol index."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1861
+msgid ""
+"Does the <filename><package>-docs.{xml,sgml}</filename> contain a "
+"index that xi:includes the generated index?"
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1867
+msgid "Symbols are not linked to their doc-section."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1868
+msgid ""
+"Is the doc-comment using the correct markup (added #,% or ())? Check if the "
+"gtkdoc-fixxref warns about unresolvable xrefs."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1874
+msgid "A new class does not appear in the docs."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1875
+msgid ""
+"Is the new page xi:included from <filename><package>-docs.{xml,sgml}</"
+"filename>."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1881
+msgid "A new symbol does not appear in the docs."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1882
+msgid ""
+"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><"
+"package>-sections.txt</filename> in a public subsection."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1890
+msgid "A type is missing from the class hierarchy."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1891
+msgid ""
+"If the type is listed in <filename><package>.hierarchy</filename> but "
+"not in <filename>xml/tree_index.sgml</filename> then double check that the "
+"type is correctly placed in the <filename><package>-sections.txt</"
+"filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
+"or incidentialy makred private it will not be shown."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1900
+msgid "I get foldoc links for all gobject annotations."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1901
+msgid ""
+"Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
+"from <filename><package>-docs.{xml,sgml}</filename>."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1909
+msgid "Parameter described in source code comment block but does not exist"
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1910
+msgid ""
+"Check if the prototype in the header has different parameter names as in the "
+"source."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1915
+msgid "multiple \"IDs\" for constraint linkend: XYZ"
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1916
+msgid ""
+"Symbol XYZ appears twice in <filename><package>-sections.txt</"
+"filename> file."
+msgstr ""
+
+#. (itstool) path: seglistitem/seg
+#: C/index.docbook:1919
+msgid ""
+"Element typename in namespace '' encountered in para, but no template "
+"matches."
+msgstr ""
+
+#. (itstool) path: chapter/title
+#: C/index.docbook:1926
+msgid "Tools related to gtk-doc"
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1928
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: chapter/para
+#: C/index.docbook:1933
+msgid ""
+"Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
+"tags in the API to determine the minimum required version."
+msgstr ""
+
+#. (itstool) path: appendixinfo/releaseinfo
+#: C/index.docbook:12 C/fdl-appendix.xml:12
+msgid "Version 1.1, March 2000"
+msgstr ""
+
+#. (itstool) path: appendixinfo/copyright
+#: C/index.docbook:15
+msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
+msgstr ""
+
+#. (itstool) path: para/address
+#: C/index.docbook:20
+#, no-wrap
+msgid ""
+"Free Software Foundation, Inc. <street>51 Franklin Street, \n"
+" Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
+" <postcode>02110-1301</postcode> <country>USA</country>"
+msgstr ""
+
+#. (itstool) path: legalnotice/para
+#: C/index.docbook:19 C/fdl-appendix.xml:19
+msgid ""
+"<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
+"of this license document, but changing it is not allowed."
+msgstr ""
+
+#. (itstool) path: appendix/title
+#. (itstool) path: para/quote
+#: C/index.docbook:28 C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
+msgid "GNU Free Documentation License"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:31 C/fdl-appendix.xml:31
+msgid "0. PREAMBLE"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:32
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:43
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:50 C/fdl-appendix.xml:50
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:62 C/fdl-appendix.xml:62
+msgid "1. APPLICABILITY AND DEFINITIONS"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:63
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:72
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:79
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:94
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:103
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:111
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:128 C/fdl-appendix.xml:128
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:141
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:153 C/fdl-appendix.xml:153
+msgid "2. VERBATIM COPYING"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:154
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:169 C/fdl-appendix.xml:169
+msgid ""
+"You may also lend copies, under the same conditions stated above, and you "
+"may publicly display copies."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:176 C/fdl-appendix.xml:176
+msgid "3. COPYING IN QUANTITY"
+msgstr "3. COPIANDO EN CANTIDADE"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:177
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:195 C/fdl-appendix.xml:195
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:202
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:222
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:231 C/fdl-appendix.xml:231
+msgid "4. MODIFICATIONS"
+msgstr "4. MODIFICACIÓNS"
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:232
+msgid ""
+"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:"
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:248 C/fdl-appendix.xml:248
+msgid "A"
+msgstr "A"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:249
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:264 C/fdl-appendix.xml:264
+msgid "B"
+msgstr "B"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:265
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:279 C/fdl-appendix.xml:279
+msgid "C"
+msgstr "C"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:280
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:291 C/fdl-appendix.xml:291
+msgid "D"
+msgstr "D"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:292
+msgid ""
+"Preserve all the copyright notices of the <link linkend=\"fdl-document"
+"\">Document</link>."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:301 C/fdl-appendix.xml:301
+msgid "E"
+msgstr "E"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:302 C/fdl-appendix.xml:302
+msgid ""
+"Add an appropriate copyright notice for your modifications adjacent to the "
+"other copyright notices."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:311 C/fdl-appendix.xml:311
+msgid "F"
+msgstr "F"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:312
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:324 C/fdl-appendix.xml:324
+msgid "G"
+msgstr "G"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:325
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:337 C/fdl-appendix.xml:337
+msgid "H"
+msgstr "H"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:338 C/fdl-appendix.xml:338
+msgid "Include an unaltered copy of this License."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:346 C/fdl-appendix.xml:346
+msgid "I"
+msgstr "I"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:347
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:365 C/fdl-appendix.xml:365
+msgid "J"
+msgstr "J"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:366
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:383 C/fdl-appendix.xml:383
+msgid "K"
+msgstr "K"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:384
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:396 C/fdl-appendix.xml:396
+msgid "L"
+msgstr "L"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:397
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:409 C/fdl-appendix.xml:409
+msgid "M"
+msgstr "M"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:410
+msgid ""
+"Delete any section entitled <quote>Endorsements</quote>. Such a section may "
+"not be included in the <link linkend=\"fdl-modified\">Modified Version</"
+"link>."
+msgstr ""
+
+#. (itstool) path: formalpara/title
+#: C/index.docbook:421 C/fdl-appendix.xml:421
+msgid "N"
+msgstr "N"
+
+#. (itstool) path: formalpara/para
+#: C/index.docbook:422
+msgid ""
+"Do not retitle any existing section as <quote>Endorsements</quote> or to "
+"conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
+"Section</link>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:432
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:444
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:453
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:470
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:480 C/fdl-appendix.xml:480
+msgid "5. COMBINING DOCUMENTS"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:481
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:492
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:505
+msgid ""
+"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>"
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:516 C/fdl-appendix.xml:516
+msgid "6. COLLECTIONS OF DOCUMENTS"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:517
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:527 C/fdl-appendix.xml:527
+msgid ""
+"You may extract a single document from such a collection, and dispbibute 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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:537 C/fdl-appendix.xml:537
+msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:538
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:561 C/fdl-appendix.xml:561
+msgid "8. TRANSLATION"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:562
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:580 C/fdl-appendix.xml:580
+msgid "9. TERMINATION"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:581
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:594 C/fdl-appendix.xml:594
+msgid "10. FUTURE REVISIONS OF THIS LICENSE"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:595
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:606
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/title
+#: C/index.docbook:621 C/fdl-appendix.xml:621
+msgid "Addendum"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:622 C/fdl-appendix.xml:622
+msgid ""
+"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:"
+msgstr ""
+
+#. (itstool) path: blockquote/para
+#: C/index.docbook:629 C/fdl-appendix.xml:629
+msgid "Copyright YEAR YOUR NAME."
+msgstr ""
+
+#. (itstool) path: blockquote/para
+#: C/index.docbook:632
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:647
+msgid ""
+"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>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/index.docbook:657
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: copyright/year
+#: C/fdl-appendix.xml:16
+msgid "2000"
+msgstr "2000"
+
+#. (itstool) path: copyright/holder
+#: C/fdl-appendix.xml:16
+msgid "Free Software Foundation, Inc."
+msgstr "Free Software Foundation, Inc."
+
+#. (itstool) path: address/street
+#: C/fdl-appendix.xml:20
+msgid "51 Franklin Street, Suite 330"
+msgstr "51 Franklin Street, Suite 330"
+
+#. (itstool) path: address/city
+#: C/fdl-appendix.xml:21
+msgid "Boston"
+msgstr "Boston"
+
+#. (itstool) path: address/state
+#: C/fdl-appendix.xml:21
+msgid "MA"
+msgstr "MA"
+
+#. (itstool) path: address/postcode
+#: C/fdl-appendix.xml:22
+msgid "02110-1301"
+msgstr "02110-1301"
+
+#. (itstool) path: address/country
+#: C/fdl-appendix.xml:22
+msgid "USA"
+msgstr "USA"
+
+#. (itstool) path: para/address
+#: C/fdl-appendix.xml:20
+msgid ""
+"Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
+"postcode-4/> <_:country-5/>"
+msgstr ""
+"Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
+"<_:postcode-4/> <_:country-5/>"
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:34
+msgid "free"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:32
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:44
+msgid "copyleft"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:43
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
+#: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
+#: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
+#: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
+#: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
+#: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
+#: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
+#: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
+#: C/fdl-appendix.xml:608
+msgid "Document"
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:69
+msgid "you"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:63
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
+#: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
+#: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
+#: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
+msgid "Modified Version"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:72
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:80
+msgid "Secondary Section"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:79
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
+#: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
+#: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
+msgid "Invariant Sections"
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
+msgid "Secondary Sections"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:94
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
+#: C/fdl-appendix.xml:458
+msgid "Cover Texts"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:103
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
+#: C/fdl-appendix.xml:369
+msgid "Transparent"
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
+msgid "Opaque"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:111
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/quote
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
+#: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
+msgid "Title Page"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:141
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
+msgid "section 3"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:154
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:177
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:202
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:222
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:236
+msgid "2"
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:237
+msgid "3"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:232
+msgid ""
+"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:"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:249
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:265
+msgid ""
+"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)."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:280
+msgid ""
+"State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
+"the publisher."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:292
+msgid "Preserve all the copyright notices of the <_:link-1/>."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:312
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:330
+msgid "Document's"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:325
+msgid ""
+"Preserve in that license notice the full lists of <_:link-1/> and required "
+"<_:link-2/> given in the <_:link-3/> license notice."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
+#: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
+msgid "History"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:347
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:366
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
+msgid "Acknowledgements"
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
+msgid "Dedications"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:384
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:397
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
+msgid "Endorsements"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:410
+msgid ""
+"Delete any section entitled <_:quote-1/>. Such a section may not be included "
+"in the <_:link-2/>."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:425
+msgid "Invariant Section"
+msgstr ""
+
+#. (itstool) path: formalpara/para
+#: C/fdl-appendix.xml:422
+msgid ""
+"Do not retitle any existing section as <_:quote-1/> or to conflict in title "
+"with any <_:link-2/>."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:432
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:444
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:455
+msgid "Front-Cover Text"
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:457
+msgid "Back-Cover Text"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:453
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:470
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
+msgid "section 4"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:481
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:492
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:511
+msgid "Endorsements."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:505
+msgid ""
+"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/>"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:517
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:546
+msgid "aggregate"
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:550
+msgid "Cover Text"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:538
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:562
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:581
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/ulink
+#: C/fdl-appendix.xml:597
+msgid "Free Software Foundation"
+msgstr ""
+
+#. (itstool) path: para/ulink
+#: C/fdl-appendix.xml:603
+msgid "http://www.gnu.org/copyleft/";
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:595
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:610
+msgid "or any later version"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:606
+msgid ""
+"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."
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
+msgid "Front-Cover Texts"
+msgstr ""
+
+#. (itstool) path: para/link
+#: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
+msgid "Back-Cover Texts"
+msgstr ""
+
+#. (itstool) path: blockquote/para
+#: C/fdl-appendix.xml:632
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:649
+msgid "with no Invariant Sections"
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:652
+msgid "no Front-Cover Texts"
+msgstr ""
+
+#. (itstool) path: para/quote
+#: C/fdl-appendix.xml:653
+msgid "Front-Cover Texts being LIST"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:647
+msgid ""
+"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/>."
+msgstr ""
+
+#. (itstool) path: para/ulink
+#: C/fdl-appendix.xml:661
+msgid "GNU General Public License"
+msgstr ""
+
+#. (itstool) path: sect1/para
+#: C/fdl-appendix.xml:657
+msgid ""
+"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."
+msgstr ""
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
