path: root/help/manual/cs/cs.po

# Czech translation of gtk-doc.
# Copyright (C) 2009 gtk-doc's COPYRIGHT HOLDER
# This file is distributed under the same license as the gtk-doc package.
# Marek Černocký <marek@manet.cz>, 2009, 2015, 2016, 2017, 2018, 2020.
#
msgid ""
msgstr ""
"Project-Id-Version: gtk-doc master\n"
"POT-Creation-Date: 2019-10-02 10:49+0000\n"
"PO-Revision-Date: 2020-03-08 10:38+0100\n"
"Last-Translator: Marek Černocký <marek@manet.cz>\n"
"Language-Team: čeština <gnome-cs-list@gnome.org>\n"
"Language: cs\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"
"X-Generator: Gtranslator 2.91.7\n"

#. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
msgctxt "_"
msgid "translator-credits"
msgstr "Marek Černocký <marek@manet.cz>"

#. (itstool) path: bookinfo/title
#: C/index.docbook:12
msgid "GTK-Doc Manual"
msgstr "Příručka ke GTK-Doc"

#. (itstool) path: bookinfo/edition
#: C/index.docbook:13
msgid "1.24.1"
msgstr "1.24.1"

#. (itstool) path: abstract/para
#: C/index.docbook:14
msgid "User manual for developers with instructions of GTK-Doc usage."
msgstr "Uživatelská příručka pro vývojáře s instrukcemi k používání 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 "Projekt 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-2019</year> <holder>Stefan Sauer (Kost)</holder>"
msgstr "<year>2007-2019</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 ""
"Je povoleno kopírovat, šířit a/nebo upravovat tento dokument za podmínek "
"<citetitle>GNU Free Documentation License</citetitle> ve verzi 1.1 nebo v "
"jakékoli další verzi vydané nadací Free Software Foundation, s neměnnými "
"oddíly, bez textů předních desek a bez textů zadních desek. Kopie licence je "
"<link linkend=\"fdl\">součástí</link>."

#. (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 ""
"Mnoho názvů použitých firmami k zviditelnění produktů nebo služeb jsou "
"ochranné známky. Na místech, kde jsou tyto názvy v dokumentaci použity a "
"členové Dokumentačního projektu GNOME jsou si vědomi skutečnosti, že se "
"jedná o ochrannou známku, je takovýto název psán velkými písmeny celý nebo s "
"velkým písmenem na začátku."

#. (itstool) path: revhistory/revision
#: C/index.docbook:83
msgid ""
"<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>dev version</revremark>"
msgstr ""
"<revnumber>1.32.1</revnumber> <date>15. srpna 2019</date> "
"<authorinitials>ss</authorinitials> <revremark>vývojová verze</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:89
msgid ""
"<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>hotfix release</revremark>"
msgstr ""
"<revnumber>1.32</revnumber> <date>15. srpna 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>opravné vydání</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:95
msgid ""
"<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>refactorings and more test coverage</revremark>"
msgstr ""
"<revnumber>1.31</revnumber> <date>5. srpna 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>přepracování a větší pokrytí testy</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:101
msgid ""
"<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>more test coverage</revremark>"
msgstr ""
"<revnumber>1.30</revnumber> <date>8. května 2019</date> <authorinitials>ss</"
"authorinitials> <revremark>větší pokrytí testy</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:107
msgid ""
"<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes</revremark>"
msgstr ""
"<revnumber>1.29</revnumber> <date>28. srpna 2018</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:113
msgid ""
"<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes</revremark>"
msgstr ""
"<revnumber>1.28</revnumber> <date>24. března 2018</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:119
msgid ""
"<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
"authorinitials> <revremark>fine tuning of the python port</revremark>"
msgstr ""
"<revnumber>1.27</revnumber> <date>7. prosince 2017</date> "
"<authorinitials>ss</authorinitials> <revremark>detailní vyladění portu v "
"jazyce Python</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:125
msgid ""
"<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
"authorinitials> <revremark>port all tools from perl/bash to python</"
"revremark>"
msgstr ""
"<revnumber>1.26</revnumber> <date>11. srpen 2017</date> <authorinitials>ss</"
"authorinitials> <revremark>přenesení všech nástrojů z jazyků Perl/Bash do "
"jazyka Python</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:131
msgid ""
"<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, test cleanups</revremark>"
msgstr ""
"<revnumber>1.25</revnumber> <date>21. březen 2016</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb, pročištění testů</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:137
msgid ""
"<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fix</revremark>"
msgstr ""
"<revnumber>1.24</revnumber> <date>29. května 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>oprava chyby</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:143
msgid ""
"<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fix</revremark>"
msgstr ""
"<revnumber>1.23</revnumber> <date>17. květen 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>oprava chyby</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:149
msgid ""
"<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes, dropping deprecated features</"
"revremark>"
msgstr ""
"<revnumber>1.22</revnumber> <date>07. květen 2015</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb, odstranění zastaralých věcí</"
"revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:155
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. červenec 2014</date> "
"<authorinitials>ss</authorinitials> <revremark>opravy chyb, odstranění "
"zastaralých věcí</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:161
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. únor 2014</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb, podpora značkovacího jazyka, "
"vylepšení stylů</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:167
msgid ""
"<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
"authorinitials> <revremark>bug fixes</revremark>"
msgstr ""
"<revnumber>1.19</revnumber> <date>05. červen 2013</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:173
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. září 2011</date> <authorinitials>ss</"
"authorinitials> <revremark>opravy chyb, zrychlení, podpora značkovacího "
"jazyka</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:179
msgid ""
"<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>urgent bug fix update</revremark>"
msgstr ""
"<revnumber>1.17</revnumber> <date>26. únor 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>aktualizace kvůli neodkladné opravě chyby</"
"revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:185
msgid ""
"<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>bugfixes, layout improvements</revremark>"
msgstr ""
"<revnumber>1.16</revnumber> <date>14. leden 2011</date> <authorinitials>sk</"
"authorinitials> <revremark>opravy chyb, vylepšení vzhledu</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:191
msgid ""
"<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>bug and regression fixes</revremark>"
msgstr ""
"<revnumber>1.15</revnumber> <date>21. květen 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>opravy chyb a regresí</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:197
msgid ""
"<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>bugfixes and performance improvements</revremark>"
msgstr ""
"<revnumber>1.14</revnumber> <date>28. březen 2010</date> <authorinitials>sk</"
"authorinitials> <revremark>opravy chyb a vylepšení výkonu</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:203
msgid ""
"<revnumber>1.13</revnumber> <date>18 December 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
"revremark>"
msgstr ""
"<revnumber>1.13</revnumber> <date>18. prosinec 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>aktualizace poškozeného "
"balíčku</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:209
msgid ""
"<revnumber>1.12</revnumber> <date>18 December 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>new tool features and "
"bugfixes</revremark>"
msgstr ""
"<revnumber>1.12</revnumber> <date>18. prosinec 2009</date> "
"<authorinitials>sk</authorinitials> <revremark>nové funkce nástroje a opravy "
"chyb</revremark>"

#. (itstool) path: revhistory/revision
#: C/index.docbook:215
msgid ""
"<revnumber>1.11</revnumber> <date>16 November 2008</date> "
"<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
"revremark>"
msgstr ""
"<revnumber>1.11</revnumber> <date>16. listopad 2008</date> "
"<authorinitials>mal</authorinitials> <revremark>přechod na doc-utils z "
"GNOME</revremark>"

#. (itstool) path: chapter/title
#: C/index.docbook:228
msgid "Introduction"
msgstr "Úvod"

#. (itstool) path: chapter/para
#: C/index.docbook:230
msgid ""
"This chapter introduces GTK-Doc and gives an overview of what it is and how "
"it is used."
msgstr ""
"Tato kapitola je úvodem do GTK-Doc a podává přehled o tom, co to je a jak to "
"použít."

#. (itstool) path: sect1/title
#: C/index.docbook:236
msgid "What is GTK-Doc?"
msgstr "Co je to GTK-Doc?"

#. (itstool) path: sect1/para
#: C/index.docbook:238
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 ""
"GTK-Doc se používá k dokumentaci kódu jazyka C. Typické použití je pro "
"dokumentaci veřejného API knihoven, jako jsou knihovny GTK+ a GNOME. Lze jej "
"ale použít i k dokumentaci aplikačního kódu."

#. (itstool) path: sect1/title
#: C/index.docbook:246
msgid "How Does GTK-Doc Work?"
msgstr "Jak GTK-Doc pracuje?"

#. (itstool) path: sect1/para
#: C/index.docbook:248
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 ""
"GTK-Doc pracuje na základě dokumentace funkcí umístěné přímo v souborech se "
"zdrojovým kódem ve speciálně formátovaných komentářových blocích, nebo "
"dokumentace přidané do souborů šablon, které GTK-Doc používá (ačkoliv je "
"nutno poznamenat, že GTK-Doc dokumentuje pouze funkce, které jsou "
"deklarované v hlavičkových souborech; pro statické funkce žádný výstup "
"nevytváří)."

#. (itstool) path: sect1/para
#: C/index.docbook:255
msgid ""
"GTK-Doc consists of a number of python scripts, each performing a different "
"step in the process."
msgstr ""
"GTK-Doc sestává z řady skriptů v jazyce Python, z nichž každý provádí jinou "
"část procesu."

#. (itstool) path: sect1/para
#: C/index.docbook:260
msgid "There are 5 main steps in the process:"
msgstr "Celý proces se skládá z pěti hlavních kroků:"

#. (itstool) path: listitem/para
#: C/index.docbook:267
msgid ""
"<guilabel>Writing the documentation.</guilabel> The author fills in the "
"source files with the documentation for each function, macro, structs or "
"unions, etc."
msgstr ""
"<guilabel>Psaní dokumentace.</guilabel> Autor doplní soubory se zdrojovým "
"kódem s dokumentací pro každou funkci, makro, strukturu, výčet atd."

#. (itstool) path: listitem/para
#: C/index.docbook:276
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>&lt;module&gt;-decl-list.txt</filename> "
"containing a list of the declarations, placing them into sections according "
"to which header file they are in. On the first run this file is copied to "
"<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
"the sections, and the order of the declarations within them, to produce the "
"final desired order. The second file it generates is <filename>&lt;"
"module&gt;-decl.txt</filename>. This file contains the full declarations "
"found by the scanner. If for some reason one would like some symbols to show "
"up in the docs, where the full declaration cannot be found by the scanner or "
"the declaration should appear differently, one can place entities similar to "
"the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
"module&gt;-overrides.txt</filename>."
msgstr ""
"<guilabel>Shromáždění informací o kódu.</guilabel> <application>gtkdoc-scan</"
"application> projde hlavičkové soubory kódu a vyhledá při tom deklarace "
"funkcí, maker, výčtů, struktur a sjednocení. Tím se vytvoří soubor "
"<filename>&lt;module&gt;-decl-list.txt</filename> obsahující seznam "
"deklarací, které jsou rozdělené do oddílů podle hlavičkového souboru, ze "
"kterého pochází. Při prvním spuštění se tento soubor zkopíruje do "
"<filename>&lt;module&gt;-sections.txt</filename>. Autor může změnit "
"uspořádání oddílů a jejich pořadí v rámci deklarací tak, jak to požaduje ve "
"výsledku. Druhý soubor, který se vytvoří, je <filename>&lt;module&gt;-decl."
"txt</filename>. Tento soubor obsahuje úplné deklarace nalezené při "
"procházení. Pokud byste z nějakého důvodu chtěli v dokumentaci zahrnout "
"symbol, který při procházení nebyl nalezen, nebo jeho deklarace vypadá "
"jinak, můžete jej umístit podobně jako v <filename>&lt;module&gt;-decl.txt</"
"filename> do <filename>&lt;module&gt;-overrides.txt</filename>."

#. (itstool) path: listitem/para
#: C/index.docbook:293
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 ""
"Dá se také použít <application>gtkdoc-scanobj</application> k dynamickým "
"dotazům do knihoven na podtřídy objektu GObject, které exportují. Tím se "
"uloží informace o pozici každého objektu v hierarchii tříd a o argumentech a "
"signálech objektu GObject, které poskytují."

#. (itstool) path: listitem/para
#: C/index.docbook:299
msgid ""
"<application>gtkdoc-scanobj</application> should not be used anymore. It was "
"needed in the past when GObject was still GtkObject inside gtk+."
msgstr ""
"<application>gtkdoc-scanobj</application> by se ale již používat nemělo. "
"Bylo zapotřebí v minulosti, kdy byl GObject ještě GtkObject v rámci gtk+."

#. (itstool) path: listitem/para
#: C/index.docbook:306
msgid ""
"<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
"mkdb</application> turns the template files into XML files in the <filename "
"class=\"directory\">xml/</filename> subdirectory. If the source code "
"contains documentation on functions, using the special comment blocks, it "
"gets merged in here. If there are no tmpl files used it only reads docs from "
"sources and introspection data."
msgstr ""
"<guilabel>Generování XML a HTML/PDF.</guilabel> <application>gtkdoc-mkdb</"
"application> přemění soubory šablon na soubory XML v podsložce <filename "
"class=\"directory\">xml/</filename>. Pokud zdrojový kód obsahuje dokumentaci "
"funkcí za použití speciálních komentářových bloků, tak zde se sloučí. V "
"případě, že není použitý žádný soubor šablon, načte se dokumentace pouze ze "
"zdrojového kódu a introspektivních dat."

#. (itstool) path: listitem/para
#: C/index.docbook:315
msgid ""
"<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
"in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
"<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
"document called <filename>&lt;package&gt;.pdf</filename>."
msgstr ""
"<application>gtkdoc-mkhtml</application> převádí soubory XML na soubory HTML "
"v podsložce <filename class=\"directory\">html/</filename>. Obdobně "
"<application>gtkdoc-mkpdf</application> převádí soubory XML na dokument PDF "
"nazvaný <filename>&lt;balíček&gt;.pdf</filename>."

#. (itstool) path: listitem/para
#: C/index.docbook:321
msgid ""
"Files in <filename class=\"directory\">xml/</filename> and <filename class="
"\"directory\">html/</filename> directories are always overwritten. One "
"should never edit them directly."
msgstr ""
"Soubory ve složkách <filename class=\"directory\">xml/</filename> a "
"<filename class=\"directory\">html/</filename> jsou vždy přepsány. Nikdy by "
"neměly být upravovány přímo."

#. (itstool) path: listitem/para
#: C/index.docbook:329
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 ""
"<guilabel>Opravy křížových odkazů mezi dokumenty.</guilabel> Po "
"nainstalování souborů HTML můžete spustit <application>gtkdoc-fixxref</"
"application>, aby se opravily křížové odkazy mezi samostanými dokumenty. "
"Například dokumentace GTK+ obsahuje křížové odkazy na typy zdokumentované v "
"příručce GLib. Když vytváříte zdrojový balíček pro distribuci, "
"<application>gtkdoc-rebase</application> předělá všechny externí odkazy na "
"webové odkazy. Když se distribuovaná (předgenerovaná) dokumentace instaluje, "
"pokusí se tatáž aplikace předělat odkazy zpátky na místní odkazy (na "
"dokumenty, které jsou nainstalované)."

#. (itstool) path: sect1/title
#: C/index.docbook:347
msgid "Getting GTK-Doc"
msgstr "Jak získat GTK-Doc?"

#. (itstool) path: sect2/title
#: C/index.docbook:350
msgid "Requirements"
msgstr "Požadavky"

#. (itstool) path: sect2/para
#: C/index.docbook:351
msgid ""
"<guilabel>python 2/3</guilabel> - the main scripts are written in python."
msgstr "<guilabel>Python 2/3</guilabel> – hlavní skripty jsou v jazyce Python."

#. (itstool) path: sect2/para
#: C/index.docbook:354
msgid ""
"<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
"\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
msgstr ""
"<guilabel>xsltproc</guilabel> – procesor xslt z knihovny libxslt <ulink url="
"\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"

#. (itstool) path: sect2/para
#: C/index.docbook:358
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 ""
"<guilabel>docbook-xsl</guilabel> – stylopisy XSL pro docbook <ulink url="
"\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
"\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"

#. (itstool) path: sect2/para
#: C/index.docbook:362
msgid ""
"One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
"or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
"examples"
msgstr ""
"Něco z <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
"nebo <guilabel>vim</guilabel> – (volitelné) používá se pro zvýraznění "
"syntaxe u příkladů"

#. (itstool) path: sect1/title
#: C/index.docbook:370
msgid "About GTK-Doc"
msgstr "O aplikaci GTK-Doc"

#. (itstool) path: sect1/para
#: C/index.docbook:372
msgid ""
"Historically GTK-Doc was used to generate template files from the sources "
"code. These template files could be used by developers to enter the API "
"documentation. This approach was rather inconvenient because it required to "
"keep the generated files under version control. Since GTK-Doc 1.9 it became "
"possible to place all API information into source comments, which made the "
"template support obsolete. In version 1.26 template support has been removed."
msgstr ""
"Historicky se GTK-Doc používalo ke generování šablonových souborů ze "
"zdrojových kódů. Tyto šablonové soubory pak mohli vývojáři používat ke "
"vkládání dokumentace k API. Tento postup byl dosti nepohodlný, protože "
"vyžadovat udržování vygenerovaných souborů ve správě verzí. Proto od verze "
"1.9 přichází GTK-Doc s možností vkládat všechny informace o API do komentářů "
"ve zdrojových kódech, čímž se podpora šablon stává nadbytečnou. Ve verzi "
"1.26 byla podpora šablon odstraněna."

#. (itstool) path: sect1/para
#: C/index.docbook:382 C/index.docbook:396
msgid "(FIXME)"
msgstr "(DOPLNIT)"

#. (itstool) path: sect1/para
#: C/index.docbook:386
msgid ""
"(authors, web pages, mailing list, license, future plans, comparison with "
"other similar systems.)"
msgstr ""
"(autoři, webové stránky, poštovní konference, licence, plány do budoucna, "
"srovnání s ostatními podobnými systémy.)"

#. (itstool) path: sect1/title
#: C/index.docbook:394
msgid "About this Manual"
msgstr "O této příručce"

#. (itstool) path: sect1/para
#: C/index.docbook:400
msgid "(who it is meant for, where you can get it, license)"
msgstr "(k čemu je určená, kde ji můžete získat, licence)"

#. (itstool) path: chapter/title
#: C/index.docbook:409
msgid "Project Setup"
msgstr "Nastavení projektu"

#. (itstool) path: chapter/para
#: C/index.docbook:411
msgid ""
"This Chapter describes the steps that are necessary to integrate GTK-Doc "
"into your project. The integration of GTK-Doc into a project includes the "
"following steps:"
msgstr ""
"Tato kapitola popisuje kroky, které jsou nutné pro integraci GTK-Doc do "
"vašeho projektu. Integrace GTK-Doc do projektu zahrnuje následující kroky:"

#. (itstool) path: listitem/para
#: C/index.docbook:419
msgid ""
"Preparation of the directory structure and creating required configuration "
"files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles"
"\"> Setting up a skeleton documentation</link>)."
msgstr ""
"Přípravu struktury složek a vytvoření požadovaných konfiguračních souborů "
"pro dokumentaci GTK-Doc (viz <link linkend=\"settingup_docfiles\">Nastavení "
"kostry dokumentace</link>)."

#. (itstool) path: listitem/para
#: C/index.docbook:427
msgid ""
"Adjusting the build system to build your documentation using the GTK-Doc "
"tools. Multiple build systems are supported, in this manual we describe how "
"to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
"link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link linkend="
"\"settingup_plain_makefiles\">plain Makefiles</link>."
msgstr ""
"Přizpůsobení sestavovacího systému, aby sestavoval vaši dokumentaci pomocí "
"nástrojů GTK-Doc. Je podporováno více sestavovacích systémů, v této příručce "
"je popsáno, jak integrovat GTK-Doc s <link linkend=\"settingup_autotools"
"\">Autotools</link>, <link linkend=\"settingup_cmake\">CMake</link> a <link "
"linkend=\"settingup_plain_makefiles\">prostými soubory Makefiles</link>."

#. (itstool) path: listitem/para
#: C/index.docbook:437
msgid ""
"Adding GTK-Doc specific files to version control and deciding which files to "
"ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
"control systems</link>)."
msgstr ""
"Přidání souborů specifických pro GTK-Doc do správy verzí a rozhodnutí, které "
"soubory se mají ignorovat (viz <link linkend=\"settingup_vcs\">Integrace se "
"systémem správy verzí</link>)."

#. (itstool) path: chapter/para
#: C/index.docbook:445
msgid ""
"The following sections assume we work on a project called <code>meep</code>. "
"This project contains two packages (or modules), a library called "
"<code>libmeep</code> and an end-user app called <code>meeper</code>."
msgstr ""
"Následující oddíly předpokládají, že pracujeme na projektu nazvaném "
"<code>meep</code>. Tento projekt obsahuje dva balíčky (nebo moduly), "
"knihovnu nazvanou <code>libmeep</code> a uživatelskou aplikaci nazvanou "
"<code>meeper</code>."

#. (itstool) path: sect1/title
#: C/index.docbook:454
msgid "Setting up a skeleton documentation"
msgstr "Nastavení kostry dokumentace"

#. (itstool) path: sect1/para
#: C/index.docbook:456
msgid ""
"A common convention is to place documentation into a folder called "
"<code>docs</code> inside your top-level project directory. We usually "
"distinguish between <emphasis>reference documentation</emphasis> intended "
"for developers and an <emphasis>user manual</emphasis> intended for end-"
"users. Again the convention is to have separate folders for both. We usually "
"place the reference documentation in a folder named <code>reference</code> "
"and the end-user manual in a folder named <code>help</code> as. According to "
"the above convention the documentation for our <code>libmeep</code> package "
"would be placed into: <code>docs/reference/libmeep</code>. For packages with "
"just one library or application the documentation could also be placed "
"directly into <code>docs/reference</code>. It is not mandatory to use the "
"above convention, but if you choose to use a different directory structure "
"you must adjust your build system configuration to match your directory "
"structure."
msgstr ""
"Zaběhnutým zvykem je umístit dokumentaci do složky nazvané <code>docs</code> "
"ve složce nejvyšší úrovně projektu. Obvykle rozlišujeme mezi "
"<emphasis>referenční dokumentací</emphasis> zaměřenou na vývojáře a "
"<emphasis>uživatelskou příručkou</emphasis> zaměřenou na koncového "
"uživatele. Opět je zvykem mít zvláštní složku pro každou z obou zmíněných. "
"Obvykle umisťujeme referenční dokumentaci do složky nazvané <code>reference</"
"code> a uživatelskou příručku do složky nazvané <code>help</code>. V souladu "
"se zmíněnými zvyky by dokumentace pro naši knihovnu <code>libmeep</code> "
"byla umístěna do <code>docs/reference/libmeep</code>. U balíčků s jedinou "
"knihovnou nebo referenční dokumentací by bylo možné ji umístit přímo do "
"<code>docs/reference</code>. Není povinné použít uvedenou konvenci, ale "
"pokud se rozhodnete použít jinou strukturu složek, musíte upravit "
"konfiguraci sestavovacího systému, aby se s ní shodoval."

#. (itstool) path: example/title
#: C/index.docbook:487
msgid "Example directory structure of <emphasis>meep</emphasis> project"
msgstr "Příklad struktury složek projektu <emphasis>meep</emphasis>"

#. (itstool) path: example/programlisting
#: C/index.docbook:489
#, no-wrap
msgid ""
"\n"
"meep/\n"
"  docs/\n"
"    reference/  # reference documentation\n"
"      libmeep/\n"
"      meeper/\n"
"    help/       # optional: user manual\n"
"      meeper/\n"
"  src/\n"
"    libmeep/\n"
"    meeper/\n"
msgstr ""
"\n"
"meep/\n"
"  docs/\n"
"    reference/  # referenční dokumentace\n"
"      libmeep/\n"
"      meeper/\n"
"    help/       # volitelné: uživatelská příručka\n"
"      meeper/\n"
"  src/\n"
"    libmeep/\n"
"    meeper/\n"

#. (itstool) path: sect1/para
#: C/index.docbook:481
msgid ""
"In the following sections we will assume a directory structure for our "
"<emphasis>meep</emphasis> project that uses the above conventions. <_:"
"example-1/>"
msgstr ""
"V následujících oddílech budeme uvažovat strukturu složek pro náš projekt "
"<emphasis>meep</emphasis>, který používá výše uvedené konvence. <_:example-1/"
">"

#. (itstool) path: sect1/title
#: C/index.docbook:506
msgid "Integration with Autotools"
msgstr "Integrace s Autotools"

#. (itstool) path: sect1/para
#: C/index.docbook:507
msgid ""
"Integration of GTK-Doc into an autotools-based build system requires the "
"following steps:"
msgstr ""
"Integrace GTK-Doc do sestavovacího systému založeného na Autotools vyžaduje "
"následující kroky:"

#. (itstool) path: listitem/para
#: C/index.docbook:513
msgid ""
"Ensure that <application>gtkdocize</application> is run once before the "
"<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
"script is present, adjust it to check for GTK-Doc and add a call to "
"<application>gtkdocize</application>."
msgstr ""
"Zajistit, že <application>gtkdocize</application> se spustí právě jednou "
"před skriptem <filename>configure</filename>. Pokud je přítomen skript "
"<filename>autogen.sh</filename>, upravte jej, aby kontroloval GTK-Doc a "
"přidejte volání <application>gtkdocize</application>."

#. (itstool) path: listitem/para
#: C/index.docbook:521
msgid ""
"The main purpose of <application>gtkdocize</application> is to make the "
"<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
"filename> macro definition file available to the build system, either by "
"copying or linking it into the project."
msgstr ""
"Hlavním účelem <application>gtkdocize</application> je vytvořit Makefile "
"<filename>gtk-doc.make</filename> a definici makra <filename>gtk-doc.m4</"
"filename> dostupnou sestavovacímu systému, buď zkopírováním do projektu nebo "
"vytvořením odkazu."

#. (itstool) path: listitem/para
#: C/index.docbook:530
msgid ""
"Add the necessary <application>autoconf</application> macros to "
"<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
"allow configuration of GTK-Doc via the generated <filename>configure</"
"filename> script."
msgstr ""
"Přidat potřebná makra <application>autoconf</application> do "
"<filename>configure.ac</filename>, abyste povolili GTK-Doc v sestavovacím "
"systému a konfigurace GTK-Doc mohla jít přes generovaný skript "
"<filename>configure</filename>."

#. (itstool) path: listitem/para
#: C/index.docbook:536
msgid ""
"Among others with registers the <code>--enable-gtk-doc</code> option with "
"the <filename>configure</filename> script."
msgstr ""
"Mimo jiné pomocí registrace přepínače <code>--enable-gtk-doc</code> ve "
"skriptu <filename>configure</filename>."

#. (itstool) path: listitem/para
#: C/index.docbook:542
msgid ""
"Create an <application>automake</application> script for each application or "
"library in your project. In the example used in this documentation this step "
"applies to both <code>meeper</code> and <code>libmeep</code>."
msgstr ""
"Vytvořit skript <application>automake</application> pro jednotlivé aplikace "
"a knihovny ve svém projektu. V příkladu použitém v této dokumentaci je tento "
"krok použit jak pro <code>meeper</code>, tak pro <code>libmeep</code>."

#. (itstool) path: sect1/para
#: C/index.docbook:551
msgid ""
"In the following sections, we will perform the above steps in reverse order. "
"We start with the <application>automake</application> scripts and work our "
"way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
"filename>. Then we show how enable Gtk-Doc in the build system and how to "
"build the documentation."
msgstr ""
"V následujícím oddíle provedeme výše zmíněné kroky v opačném pořadí. Začneme "
"se skripty <application>automake</application> a budeme postupovat až k "
"<filename>configure.ac</filename> a <filename>autogen.sh</filename>. Pak si "
"ukážeme, jak povolit GTK-Doc v sestavovacím systému a jak sestavit "
"dokumentaci."

#. (itstool) path: sect2/title
#: C/index.docbook:561
msgid "Integration with automake"
msgstr "Integrace s automake"

#. (itstool) path: sect2/para
#: C/index.docbook:563
msgid ""
"First copy the <filename>Makefile.am</filename> from the <filename class="
"\"directory\">examples</filename> sub-directory of the <ulink url=\"https://"
"gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
"sources</ulink> to your project's reference documentation directory (e.g. "
"<filename class=\"directory\">docs/reference/&lt;package&gt;</filename>). A "
"local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-"
"tools/examples/Makefile.am</filename>. If you have multiple packages repeat "
"this for each one."
msgstr ""
"Jako první nakopírujte <filename>Makefile.am</filename> z podsložky "
"<filename class=\"directory\">examples</filename> ve složce <ulink url="
"\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am"
"\">gtkdoc-sources</ulink> do složky s referenční dokumentací svého projektu "
"(např. <filename class=\"directory\">./docs/reference/&lt;package&gt;</"
"filename>). Místní kopie by měla být k dispozici např. pod <filename>/usr/"
"share/doc/gtk-doc-tools/examples/Makefile.am</filename>. Pokud máte více "
"balíčků s dokumentací, opakujte tento krok pro každý z nich."

#. (itstool) path: note/simpara
#: C/index.docbook:576
msgid ""
"Do not forget to add each <filename>Makefile.am</filename> to the "
"<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
"filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
"will need to add the entry <filename>docs/reference/libmeep/Makefile</"
"filename> to <function>AC_CONFIG_FILES</function>."
msgstr ""
"Nezapomeňte přidat jednotlivé <filename>Makefile.am</filename> do makra "
"<function>AC_CONFIG_FILES</function> v <filename>configure.ac</filename>. "
"Pro <filename>docs/reference/libmeep/Makefile.am</filename> budete "
"potřebovat přidat záznam <filename>docs/reference/libmeep/Makefile</"
"filename> do <function>AC_CONFIG_FILES</function>."

#. (itstool) path: example/title
#: C/index.docbook:588
msgid "Example directory structure with <filename>Makefiles.am</filename>"
msgstr "Příklad struktury složek s <filename>Makefiles.am</filename>"

#. (itstool) path: example/programlisting
#: C/index.docbook:591
#, no-wrap
msgid ""
"\n"
"meep/\n"
"  docs/\n"
"    reference/  # reference documentation\n"
"      libmeep/\n"
"        Makefile.am\n"
"      meeper/\n"
"        Makefile.am\n"
"    help/       # optional: user manual\n"
"      meeper/\n"
"  src/\n"
"    libmeep/\n"
"    meeper/\n"
msgstr ""
"\n"
"meep/\n"
"  docs/\n"
"    reference/  # referenční dokumentace\n"
"      libmeep/\n"
"        Makefile.am\n"
"      meeper/\n"
"        Makefile.am\n"
"    help/       # volitelné: uživatelská příručka\n"
"      meeper/\n"
"  src/\n"
"    libmeep/\n"
"    meeper/\n"

#. (itstool) path: sect2/para
#: C/index.docbook:607
msgid ""
"Next, you need to customize the copied Makefiles and provide values for the "
"various parameters in each <filename>Makefile.am</filename>. All settings "
"have a comment above them that describes their purpose and how to customize "
"the setting. Most settings are used to supply extra flags to the respective "
"tools to which they apply. Every tool has a variable of the form <option>&lt;"
"TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</"
"application> has an option named <code>MKHTML_OPTIONS</code>). All the tools "
"support <option>--help</option> to list the supported options."
msgstr ""
"Dále je třeba přizpůsobit zkopírované soubory Makefile a dodat hodnoty pro "
"různé parametry v jednotlivých <filename>Makefile.am</filename>. Všechna "
"nastavení mají komentáře s popisem svého účelu a jak nastavení přizpůsobit. "
"Většina nastavení má doplňující příznaky předávané do dotyčných nástrojů, "
"které je umí použít. Každý nástroj má proměnnou ve formátu <option>&lt;"
"NÁZEVNÁSTROJE&gt;_OPTIONS</option> (např. nástroj <application>gtkdoc-"
"mkhtml</application> má volbu nazvanou <code>MKHTML_OPTIONS</code>). Všechny "
"nástroje podporují <option>--help</option> pro vypsání podporovaných "
"přepínačů."

#. (itstool) path: listitem/para
#: C/index.docbook:631
msgid ""
"<option>DOC_MODULE</option> is used to provide the name of the package that "
"is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
msgstr ""
"<option>DOC_MODULE</option> se používá k poskytnutí názvu balíčku, který je "
"dokumentován (např. <code>meeper</code> nebo <code>libmeep</code>)."

#. (itstool) path: listitem/para
#: C/index.docbook:638
msgid ""
"<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
"directory which GTK-Doc searches for your API documentation. This will "
"usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
"directory of that directory."
msgstr ""
"<option>DOC_SOURCE_DIR</option> se používá k určení umístění zdrojové "
"složky, ve které GTK-Doc hledá dokumentaci API. Obvykle to je "
"<code>DOC_SOURCE_DIR=$(top_srcdir)/src </code> nebo podsložka této složky."

#. (itstool) path: listitem/para
#: C/index.docbook:651
msgid ""
"<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
"dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB="
"$(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
"the matched files change."
msgstr ""
"<option>HFILE_GLOB</option> a <option>CFILE_GLOB</option> se používají pro "
"závislosti. Obě volby přebírají file-glob (např. <code>HFILE_GLOB="
"$(top_srcdir)/src/*.c</code>). Dokumentace se znovu sestaví, když se "
"kterýkoliv z odpovídajících souborů změní."

#. (itstool) path: listitem/para
#: C/index.docbook:663
msgid ""
"<option>EXTRA_HFILES</option> allows to specify extra header files to "
"include when scanning for API documentation, which are not found under "
"<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
"extra.h</code>)."
msgstr ""
"<option>EXTRA_HFILES</option> umožňuje určit dodatečné hlavičkové soubory, "
"které se mají zahrnout při procházení pro dokumentaci k API, a které nejsou "
"k nalezení pod složkou <code>DOC_SOURCE_DIR</code> (např. <code>EXTRA_HFILES="
"$(top_srcdir}/contrib/extra.h</code>)."

#. (itstool) path: listitem/para
#: C/index.docbook:673
msgid ""
"<option>IGNORE_HFILES</option> allows to specify header files or directories "
"to ignore when scanning for API documentation. Use the basename of the file "
"or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
"private_code_folder</code>)."
msgstr ""
"<option>IGNORE_HFILES</option> umožňuje určit dodatečné hlavičkové soubory "
"nebo složky, které se mají ignorovat při procházení pro dokumentaci k API. "
"Použijte základní název ze souboru nebo složky (např. "
"<code>IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>)."

#. (itstool) path: listitem/para
#: C/index.docbook:683
msgid ""
"<option>HTML_IMAGES</option> allows to specify images files which will be "
"copied into the <filename>html/</filename> directory of the generated "
"documentation. If your API documentation includes any images they need to be "
"added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
"stock_about_24.png</code>)."
msgstr ""
"<option>HTML_IMAGES</option> umožňuje určit soubory s obrázky, které se "
"zkopírují do složky <option>html/</option> s generovanou dokumentací. Pokud "
"jsou součástí vaší dokumentace API nějaké obrázky, je třeba je přidat do "
"této volby (např. <code>HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
"stock_about_24.png</code>)."

#. (itstool) path: listitem/para
#: C/index.docbook:696
msgid ""
"<option>content_files</option> allows to specify extra files that are "
"included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
"content_files=running.xml building.xml changes-2.0.xml</code>)."
msgstr ""
"<option>content_files</option> umožňuje určit dodatečné soubory, které se "
"mají vložit pomocí <code>$(DOC_MAIN_SGML_FILE)</code> (např. "
"<code>content_files=running.xml building.xml changes-2.0.xml</code>)."

#. (itstool) path: listitem/para
#: C/index.docbook:707
msgid ""
"<option>expand_content_files</option> allows to specify files where "
"<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
"are expanded (e.g. <code> expand_content_files=running.xml</code>)."
msgstr ""
"<option>expand_content_files</option> umožňuje určit soubory, ve kterých "
"jsou rozvinuty <emphasis>zkratky gtk-doc</emphasis>, jako je třeba "
"<code>#GtkWidget</code> (např. <code>expand_content_files=running.xml</"
"code>)."

#. (itstool) path: sect2/para
#: C/index.docbook:625
msgid ""
"The following list explains the most relevant options. Check the example "
"<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
msgstr ""
"Následující seznam vysvětluje nejpodstatnější volby. Na další volby se "
"podívejte do ukázkového <filename>Makefile.am</filename>. <_:itemizedlist-1/>"

#. (itstool) path: sect2/title
#: C/index.docbook:722
msgid "Integration with autoconf"
msgstr "Integrace s autoconf"

#. (itstool) path: sect2/para
#: C/index.docbook:724
msgid ""
"Integration with <application>autoconf</application> is very simple and "
"includes one required step and an additional optional (but recommended) "
"step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
"to your <filename>configure.ac</filename> script. This registers several "
"configure options to enable GTK-Doc and allows you to set default arguments "
"for <application>gtkdocize</application>."
msgstr ""
"Integrace s <application>autoconf</application> je velmi jednoduchá a skládá "
"se z jednoho povinného kroku a dalšího volitelného (ale doporučeného) kroku. "
"Prvním krokem je přidat makro <function>GTK_DOC_CHECK</function> do skriptu "
"<filename>configure.ac</filename>. Tím se zaregistruje několik "
"konfiguračních voleb, které povolí GTK-Doc a umožní vám nastavit výchozí "
"argumenty pro <application>gtkdocize</application>."

#. (itstool) path: warning/simpara
#: C/index.docbook:736
msgid ""
"Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
"macro must start at the beginning of the line and should not start with "
"whitespace."
msgstr ""
"Ujistěte se, že makro <code>GTK_DOC_CHECK</code> není odsazené od kraje. "
"Makro musí začínat na začátku řádku a nesmí začínat bílými znaky."

#. (itstool) path: sect2/para
#: C/index.docbook:743
msgid ""
"The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
"<filename>configure.ac</filename>. This is not required but helps "
"<application>gtkdocize</application> to automatically copy the macro "
"definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
"<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
"Without this, the GTK_DOC_CHECK macro might not be found and you would need "
"to explicitly tell the <application>aclocal</application> tool where to find "
"the macro definition file."
msgstr ""
"Druhým krokem je přidat do <filename>configure.ac</filename> makro "
"<code>AC_CONFIG_MACRO_DIR(m4)</code>. Není to sice nutné, ale pomůže to "
"<application>gtkdocize</application> automaticky zkopírovat definici makra "
"(např. <filename>gtk-doc.m4</filename>), která obsahuje makro "
"<function>GTK_DOC_CHECK</function>, do složky s makry ve vašem projektu. Bez "
"toho se může stát, že makro <function>GTK_DOC_CHECK</function> nemusí být "
"nalezeno a budete muset nástroji <application>aclocal</application> výslovně "
"uvést, kde soubor s definicí makra najít."

#. (itstool) path: example/title
#: C/index.docbook:756
msgid "Minimal integration with autoconf"
msgstr "Minimální integrace s autoconf"

#. (itstool) path: example/programlisting
#: C/index.docbook:757
#, no-wrap
msgid ""
"\n"
"# recommended: set m4 directory\n"
"AC_CONFIG_MACRO_DIR(m4)\n"
"# optional: register gtk-doc in configure\n"
"GTK_DOC_CHECK([1.28])\n"
msgstr ""
"\n"
"# doporučeno: nastaví složku m4\n"
"AC_CONFIG_MACRO_DIR(m4)\n"
"# volitelné: zaregistruje gtk-doc v configure\n"
"GTK_DOC_CHECK([1.28])\n"

#. (itstool) path: example/title
#: C/index.docbook:772
msgid "Integration with optional gtk-doc dependency"
msgstr "Integrace s volitelnými závislostttmi gtk-doc"

#. (itstool) path: example/programlisting
#: C/index.docbook:773
#, no-wrap
msgid ""
"\n"
"m4_ifdef([GTK_DOC_CHECK], [\n"
"# recommended: set m4 directory\n"
"AC_CONFIG_MACRO_DIR(m4)\n"
"# optional: register gtk-doc in configure\n"
"GTK_DOC_CHECK([1.28])\n"
"],[\n"
"AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
"])\n"
msgstr ""
"\n"
"m4_ifdef([GTK_DOC_CHECK], [\n"
"# doporučeno: nastaví složku m4\n"
"AC_CONFIG_MACRO_DIR(m4)\n"
"# volitelné: zaregistruje gtk-doc v configure\n"
"GTK_DOC_CHECK([1.28])\n"
"],[\n"
"AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
"])\n"

#. (itstool) path: sect2/para
#: C/index.docbook:766
msgid ""
"The above example works, but will require all developers to have gtk-doc "
"installed. A better way is to make building the documentation optional as "
"shown in the next example: <_:example-1/>"
msgstr ""
"Výše uvedený příklad funguje, ale vyžaduje, aby všichni vývojáři měli "
"nainstalováno gtk-doc. Lepším způsobem je zařídit, aby sestavení dokumentace "
"bylo volitelné, jak je ukázáno v následujícím příkladu: <_:example-1/>"

#. (itstool) path: sect2/para
#: C/index.docbook:786
msgid ""
"The first argument is used to check for the Gtk-Doc version 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 ""
"První argument se používá ke kontrole verze GTK-Doc v průběhu konfigurace. "
"Druhý, volitelný argument používá nástroj <application>gtkdocize</"
"application>. Makro <symbol>GTK_DOC_CHECK</symbol> také přidává několik "
"přepínačů pro configure:"

#. (itstool) path: listitem/para
#: C/index.docbook:795
msgid "--with-html-dir=PATH : path to installed docs"
msgstr "--with-html-dir=CESTA: cesta, kam se má dokumentace nainstalovat"

#. (itstool) path: listitem/para
#: C/index.docbook:796
msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
msgstr ""
"--enable-gtk-doc: použít k sestavení dokumentace gtk-doc [výchozí je ne]"

#. (itstool) path: listitem/para
#: C/index.docbook:797
msgid ""
"--enable-gtk-doc-html : build documentation in html format [default=yes]"
msgstr ""
"--enable-gtk-doc-html: sestavit dokumentaci ve formátu HTML [výchozí je ano]"

#. (itstool) path: listitem/para
#: C/index.docbook:798
msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
msgstr ""
"--enable-gtk-doc-pdf: sestavit dokumentaci ve formátu PDF [výchozí je ne]"

#. (itstool) path: important/para
#: C/index.docbook:802
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 ""
"GTK-Doc je standardně vypnuté! Nezapomeňte zadat přepínač „<option>--enable-"
"gtk-doc</option>“ při dalším spuštění <filename>configure</filename>. Jinak "
"se nainstaluje předgenerovaná dokumentace (která může mít význam pro "
"uživatele, ale ne pro vývojáře)."

#. (itstool) path: sect2/para
#: C/index.docbook:810
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>autogen.sh</code>."
msgstr ""
"Po provedení změn v <filename>configure.ac</filename> aktualizujte soubor "
"<filename>configure</filename>. To se dá udělat opětovným spuštěním "
"<code>autogen.sh</code>."

#. (itstool) path: sect2/title
#: C/index.docbook:818
msgid "Integration with autogen"
msgstr "Integrace s autogen"

#. (itstool) path: sect2/para
#: C/index.docbook:820
msgid ""
"Most projects will have an <filename>autogen.sh</filename> script to setup "
"the build infrastructure after the project was checked out from a version "
"control system (such as git or svn). GTK-Doc comes with a script called "
"<application>gtkdocize</application> which can be used to copy the necessary "
"files needed by Gtk-Doc to the source directory."
msgstr ""
"Většina projektů má skript <filename>autogen.sh</filename>, který po stažení "
"projektu ze systému pro správu verzí (jako je Git nebo SVN), nastaví "
"infrastrukturu pro sestavení. GTK-Doc se dodává se skriptem nazvaným "
"<application>gtkdocize</application>, který lze použít ke zkopírování "
"nezbytných souborů požadovaných GTK-Doc do zdrojové složky."

#. (itstool) path: sect2/para
#: C/index.docbook:828
msgid "It should be run before autoreconf, autoheader, automake or autoconf."
msgstr "Měl by být spuštěn před autoheader, automake nebo autoconf."

#. (itstool) path: example/title
#: C/index.docbook:833
msgid "Running gtkdocize from autogen.sh"
msgstr "Spuštění gtkdocize z autogen.sh"

#. (itstool) path: example/programlisting
#: C/index.docbook:834
#, no-wrap
msgid ""
"\n"
"gtkdocize || exit 1\n"
msgstr ""
"\n"
"gtkdocize || exit 1\n"

#. (itstool) path: example/title
#: C/index.docbook:842
msgid "Conditionally run gtkdocize from autogen.sh"
msgstr "Podmíněné spuštění gtkdocize z autogen.sh"

#. (itstool) path: example/programlisting
#: C/index.docbook:843
#, no-wrap
msgid ""
"\n"
"GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
"if test $? -ne 0; then\n"
"  echo \"No gtk-doc support found. You can't build the docs.\"\n"
"else\n"
"  $GTKDOCIZE || exit 1\n"
"fi\n"
msgstr ""
"\n"
"GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
"if test $? -ne 0; then\n"
"  echo \"No gtk-doc support found. You can't build the docs.\"\n"
"else\n"
"  $GTKDOCIZE || exit 1\n"
"fi\n"

#. (itstool) path: sect2/para
#: C/index.docbook:854
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)."
msgstr ""
"Když spustíte <filename>gtkdocize</filename>, tak nakopíruje do kořenové "
"složky vašeho projektu (nebo složky určené přepínačem <option>--docdir</"
"option>) soubor <filename>gtk-doc.make</filename>."

#. (itstool) path: sect2/para
#: C/index.docbook:860
msgid ""
"<application>gtkdocize</application> checks your <filename>configure.ac</"
"filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
"<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
"to the <application>gtkdocize</application> script. the 2nd parameter in the "
"<function>GTK_DOC_CHECK</function> macro."
msgstr ""
"<filename>gtkdocize</filename> kontroluje váš skript <filename>configure.ac</"
"filename> ohledně makra <function>GTK_DOC_CHECK</function>. Toto makro "
"můžete použít k předání dalších parametrů do skriptu <application>gtkdocize</"
"application>. Konkrétně k tomu slouží druhý argument makra."

#. (itstool) path: sect2/para
#: C/index.docbook:869
msgid ""
"Alternatively, additional arguments can also be passed to "
"<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
"function> environment variable, or by directly specifying them to "
"<application>gtkdocize</application> in <filename>autogen.sh</filename>."
msgstr ""
"Alternativně lze další argumenty skriptu <application>gtkdocize</"
"application> předat přes proměnnou prostředí <function>GTKDOCIZE_FLAGS</"
"function> nebo je zadat přímo za volání <application>gtkdocize</application> "
"v <filename>autogen.sh</filename>."

#. (itstool) path: sect2/title
#: C/index.docbook:880
msgid "Executing GTK-Doc from the Build System"
msgstr "Spouštění GTK-Doc ze sestavovacího systému"

#. (itstool) path: sect2/para
#: C/index.docbook:882
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 ""
"Po dokončení předchozích kroků nastal čas spustit sestavení. Nejdříve musíte "
"znovu spustit <filename>autogen.sh</filename>. Pokud tento skript pro vás "
"provádí nastavení, předejte mu přepínač <option>--enable-gtk-doc</option>. "
"Jinak potom ručně spusťte <filename>configure</filename> s tímto přepínačem."

#. (itstool) path: sect2/para
#: C/index.docbook:889
msgid ""
"The first make run generates several additional files in the doc-"
"directories. The important ones are: <filename>&lt;package&gt;.types</"
"filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
"sgml), <filename>&lt;package&gt;-sections.txt</filename>."
msgstr ""
"První make spustí vygenerování několika doplňujících souborů ve složkách "
"doc. Podstatné jsou tyto: <filename>&lt;package&gt;.types</filename>, "
"<filename>&lt;package&gt;-docs.xml</filename> (dříve .sgml) a <filename>&lt;"
"package&gt;-sections.txt</filename>."

#. (itstool) path: example/title
#: C/index.docbook:897
msgid "Running the doc build"
msgstr "Sestavení dokumentace"

#. (itstool) path: example/programlisting
#: C/index.docbook:898
#, no-wrap
msgid ""
"\n"
"./autogen.sh --enable-gtk-doc\n"
"make\n"
msgstr ""
"\n"
"./autogen.sh --enable-gtk-doc\n"
"make\n"

#. (itstool) path: sect2/para
#: C/index.docbook:905
msgid ""
"Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
"index.html</filename>. With this initial setup you will only see a very "
"simple document. The next chapter will teach you how to add API "
"documentation to your code via special comment blocks. The Chapter "
"afterwards introduces <link linkend=\"metafiles\">additional files</link> "
"and shows how to edit the <link linkend=\"metafiles_master\">master "
"template</link> to add additional chapters and sections to your "
"documentation files."
msgstr ""
"Nyní si můžete ve svém webovém prohlížeči zobrazit <filename>docs/reference/"
"&lt;package&gt;/index.html</filename>. S tímto počátečním nastavením uvidíte "
"jen velmi jednoduchý dokument. Následující kapitola vás naučí, jak do svého "
"zdrojového kódu přidat dokumentaci k API pomocí speciálních komentářových "
"bloků. Dále pak kapitola seznamuje s <link linkend=\"metafiles\">dodatečnými "
"soubory</link> a ukazuje, jak upravit <link linkend=\"metafiles_master"
"\">hlavní šablonu</link>, abyste do svých souborů s dokumentací dostali "
"doplňující kapitoly a oddíly."

#. (itstool) path: sect1/title
#: C/index.docbook:921
msgid "Integration with CMake build systems"
msgstr "Integrace se sestavovacím systémem CMake"

#. (itstool) path: sect1/para
#: C/index.docbook:923
msgid ""
"GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
"the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
"This provides a <literal>gtk_doc_add_module</literal> command that you can "
"set in your <filename>CMakeLists.txt</filename> file."
msgstr ""
"GTK-Doc nyní nabízí modul <filename>GtkDocConfig.cmake</filename> (a "
"příslušný modul <filename>GtkDocConfigVersion.cmake</filename>). Ten "
"poskytuje příkaz <literal>gtk_doc_add_module</literal>, který můžete "
"nastavit ve svém souboru <filename>CMakeLists.txt</filename>."

#. (itstool) path: example/title
#: C/index.docbook:933
msgid "Example of using GTK-Doc from CMake"
msgstr "Příklad použití GTK-Doc z CMake"

#. (itstool) path: example/programlisting
#: C/index.docbook:934
#, no-wrap
msgid ""
"\n"
"find_package(GtkDoc 1.25 REQUIRED)\n"
"\n"
"# Create the doc-libmeep target.\n"
"gtk_doc_add_module(\n"
"   libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
"      XML meep-docs.xml\n"
"      LIBRARIES libmeep\n"
")\n"
"\n"
"# Build doc-libmeep as part of the default target. Without this, you would\n"
"# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
"add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
"\n"
"# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
"# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
"install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
"        DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
msgstr ""
"\n"
"find_package(GtkDoc 1.25 REQUIRED)\n"
"\n"
"# Vytvoření cíle doc-libmeep.\n"
"gtk_doc_add_module(\n"
"   libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
"      XML meep-docs.xml\n"
"      LIBRARIES libmeep\n"
")\n"
"\n"
"# Sestavení doc-libmeep jako součásti výchozího cíle. Bez tohoto byste museli\n"
"# ručně spouštět něco jako `make doc-libmeep`, aby se dokumentace sestavila.\n"
"add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
"\n"
"# Instalace dokumentace. (Předpokládá to, že používáte modul CMake GNUInstallDirs\n"
"# ke správnému nastavení proměnné CMAKE_INSTALL_DOCDIR).\n"
"install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
"        DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"

#. (itstool) path: sect1/para
#: C/index.docbook:931
msgid "The following example shows how to use this command. <_:example-1/>"
msgstr "Následující příklad ukazuje, jak tento příkaz použít: <_:example-1/>"

#. (itstool) path: sect1/title
#: C/index.docbook:958
msgid "Integration with plain makefiles or other build systems"
msgstr ""
"Integrace s prostými soubory Makefile nebo jinými sestavovacími systémy"

#. (itstool) path: sect1/para
#: C/index.docbook:960
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 ""
"Když někdo nechce používat automake, a tím pádem <filename>gtk-doc.mak</"
"filename>, bude muset volat nástroje gtkdoc ve správném pořadí ve vlastních "
"souborech make (nebo jiných nástrojích)."

#. (itstool) path: example/title
#: C/index.docbook:967
msgid "Documentation build steps"
msgstr "Kroky sestavení dokumentace"

#. (itstool) path: example/programlisting
#: C/index.docbook:968
#, no-wrap
msgid ""
"\n"
"DOC_MODULE=meep\n"
"// sources have changed\n"
"gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
"gtkdoc-scangobj --module=$(DOC_MODULE)\n"
"gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
"// xml files have changed\n"
"mkdir html\n"
"cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
"gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
msgstr ""
"\n"
"DOC_MODULE=meep\n"
"// sources have changed\n"
"gtkdoc-scan --module=$(DOC_MODULE) &lt;zdrojová-složka&gt;\n"
"gtkdoc-scangobj --module=$(DOC_MODULE)\n"
"gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;zdrojová-složka&gt;\n"
"// xml files have changed\n"
"mkdir html\n"
"cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
"gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"

#. (itstool) path: sect1/para
#: C/index.docbook:982
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 ""
"Na výběr dalších potřebných voleb se musíte se podívat do <filename>Makefile."
"am</filename> a <filename>gtk-doc.mak</filename>."

#. (itstool) path: sect1/title
#: C/index.docbook:989
msgid "Integration with version control systems"
msgstr "Integrace se systémem pro správu verzí"

#. (itstool) path: sect1/para
#: C/index.docbook:991
msgid ""
"As a rule of thumb, it's the files you edit which should go under version "
"control. For typical projects it's these files: <filename>&lt;package&gt;."
"types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
"past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
"<filename>Makefile.am</filename>."
msgstr ""
"Podle nepsaných pravidel byste soubory, které upravujete, měli udržovat ve "
"správě verzí. U typických projektů to jsou tyto soubory: <filename>&lt;"
"balíček&gt;.types</filename>, <filename>&lt;balíček&gt;-docs.xml</filename> "
"(dříve .sgml), <filename>&lt;balíček&gt;-sections.txt</filename> a "
"<filename>Makefile.am</filename>."

#. (itstool) path: sect1/para
#: C/index.docbook:999
msgid ""
"Files in the <filename>xml/</filename> and <filename>html/</filename> "
"directories should not go under version control. Neither should any of the "
"<filename>.stamp</filename> files."
msgstr ""
"Soubory ze složek <filename>xml/</filename> a <filename>html/</filename> by "
"neměly být zařazeny do správy verzí. A ani žádné soubory <filename>.stamp</"
"filename>."

#. (itstool) path: chapter/title
#: C/index.docbook:1009
msgid "Documenting the code"
msgstr "Dokumentování v kódu"

#. (itstool) path: chapter/para
#: C/index.docbook:1011
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 ""
"GTK-Doc používá pro kód dokumentace komentáře se speciální syntaxí ve "
"zdrojovém kódu. K tomu se ještě získávají informace o struktuře vašeho "
"projektu z dalších zdrojů. V následujícím oddílu najdete všechny informace o "
"syntaxi komentářů."

#. (itstool) path: example/title
#: C/index.docbook:1022 C/index.docbook:1048
msgid "GTK-Doc comment block"
msgstr "Komentářový blok GTK-Doc"

#. (itstool) path: example/programlisting
#: C/index.docbook:1023
#, no-wrap
msgid ""
"\n"
"#ifndef __GTK_DOC_IGNORE__\n"
"/* unparseable code here */\n"
"#endif\n"
msgstr ""
"\n"
"#ifndef __GTK_DOC_IGNORE__\n"
"/* kód zde se nezpracovává */\n"
"#endif\n"

#. (itstool) path: chapter/para
#: C/index.docbook:1018
msgid ""
"The GTK-Doc 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 ""
"Skener GTK-Doc zvládá dobře většinu hlavičkových souborů C. V případě, že od "
"něj obdržíte varování, které vypadá jako speciální případ, můžete GTK-Doc "
"poradit, aby jej přeskakovala. <_:example-1/>"

#. (itstool) path: note/title
#: C/index.docbook:1032
msgid "Limitations"
msgstr "Omezení"

#. (itstool) path: note/para
#: C/index.docbook:1033
msgid ""
"Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
"not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
msgstr ""
"Uvědomte si, že GTK-Doc podporuje <code>#ifndef(__GTK_DOC_IGNORE__)</code>, "
"ale ne <code>#if !defined(__GTK_DOC_IGNORE__)</code> nebo jiné kombinace."

#. (itstool) path: sect1/title
#: C/index.docbook:1043
msgid "Documentation comments"
msgstr "Dokumentační komentáře"

#. (itstool) path: example/programlisting
#: C/index.docbook:1049
#, no-wrap
msgid ""
"\n"
"/**\n"
" * identifier:\n"
" * documentation ...\n"
" */\n"
msgstr ""
"\n"
"/**\n"
" * identifikátor:\n"
" * dokumentace …\n"
" */\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1045
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 ""
"Každý víceřádkový komentář, který je označený další „*“ navíc, je "
"dokumentačním blokem a bude zpracovaný nástroji GTK-Doc. <_:example-1/>"

#. (itstool) path: sect1/para
#: C/index.docbook:1058
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 ""
"„identifikátor“ je jeden řádek s názvem položky, ke které se komentář "
"vztahuje. Syntaxe se částečně liší podle položky. (DOPLNIT: přidat tabulku "
"se seznamem identifikátorů)"

#. (itstool) path: sect1/para
#: C/index.docbook:1064
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 ""
"Blok „dokumentace“ se rovněž liší pro různé typy symbolů. Symboly, které "
"přebírají parametry, jako jsou funkce nebo makra, mají nejdříve popsané "
"parametry, za kterými následuje prázdný řádek (pouze „*“). Za ním pak "
"následuje podrobný popis. Všechny řádky (mimo seznamu programů a oddílu "
"CDATA), které obsahují „ *“ (mezera hvězdička) se převedou na zalomení "
"odstavce. Pokud zalomení odstavce nechcete, změňte to na „ *  “ (mezera "
"hvězdička mezera mezera). To se hodí na text s pevným formátem (výpis kódu)."

#. (itstool) path: listitem/para
#: C/index.docbook:1081
msgid ""
"What it is: The name for a class or function can sometimes be misleading for "
"people coming from a different background."
msgstr ""
"Co to je: Název třídy nebo funkce může být občas matoucí pro lidi, kteří "
"používají něco jiného."

#. (itstool) path: listitem/para
#: C/index.docbook:1087
msgid ""
"What it does: Tell about common uses. Put it in relation with the other API."
msgstr ""
"K čemu to je: Uveďte běžném použití. Dejte ho do souvislosti se zbytkem API."

#. (itstool) path: tip/para
#: C/index.docbook:1077
msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
msgstr ""
"Když píšete dokumentaci ke kódu, popište dva aspekty: <_:itemizedlist-1/>"

#. (itstool) path: listitem/para
#: C/index.docbook:1102
msgid "Use function() to refer to functions or macros which take arguments."
msgstr ""
"Použijte funkce() pro odkaz na funkci nebo makro, které mají argumenty."

#. (itstool) path: listitem/para
#: C/index.docbook:1107
msgid ""
"Use @param to refer to parameters. Also use this when referring to "
"parameters of other functions, related to the one being described."
msgstr ""
"Použijte @parametr pro odkaz na parametry. Použijte to rovněž, když se "
"odkazujete na parametry jiných funkcí, vztahujících se k popisované funkci."

#. (itstool) path: listitem/para
#: C/index.docbook:1113
msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
msgstr "Použijte %konstanta pro odkaz na konstantu, např. %G_TRAVERSE_LEAFS."

#. (itstool) path: listitem/para
#: C/index.docbook:1118
msgid ""
"Use #symbol to refer to other types of symbol, e.g. structs and enums and "
"macros which don't take arguments."
msgstr ""
"Použijte #symbol pro odkaz na jiný typ symbolu, např. strukturu, výčet a "
"makro, který nemá argumenty."

#. (itstool) path: listitem/para
#: C/index.docbook:1124
msgid "Use #Object::signal to refer to a GObject signal."
msgstr "Použijte #Objekt::signál pro odkaz na signál objektu GObject."

#. (itstool) path: listitem/para
#: C/index.docbook:1129
msgid "Use #Object:property to refer to a GObject property."
msgstr "Použijte #Objekt:vlastnost pro odkaz na vlastnost objektu GObject."

#. (itstool) path: listitem/para
#: C/index.docbook:1134
msgid ""
"Use #Struct.field to refer to a field inside a structure and #GObjectClass."
"foo_bar() to refer to a vmethod."
msgstr ""
"Použijte #Struktura.pole pro odkaz na pole uvnitř struktury a #GObjectTřída."
"neco() pro odkaz na virtuální metodu."

#. (itstool) path: sect1/para
#: C/index.docbook:1096
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 ""
"Jednou z výhod hypertextu, oproti prostému textu, je možnost mít v dokumentu "
"odkazy. Zápis správných značek pro odkazy může být úmorná práce. GTK-Doc se "
"vám snaží pomoci několika užitečnými zkratkami. <_:itemizedlist-1/>"

#. (itstool) path: tip/para
#: C/index.docbook:1143
msgid ""
"If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
"'#' in your documentation without GTK-Doc changing them you can use the XML "
"entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
"commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
"with a backslash '\\'."
msgstr ""
"V případě, že potřebujete ve své dokumentaci použít speciální znaky „&lt;“, "
"„&gt;“, „()“, „@“, „%“ nebo „#“, aniž by je GTK-Doc změnilo, můžete místo "
"nich použít použít entity XML „&amp;lt;“, „&amp;gt;“, „&amp;lpar;“, „&amp;"
"rpar;“, „&amp;commat;“, „&amp;percnt;“ a „&amp;num;“ nebo únikovou sekvenci "
"se zpětným lomítkem „\\“."

#. (itstool) path: sect1/para
#: C/index.docbook:1152
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 ""
"DocBook toho ale umí více, než jen odkazy. Může mít také seznamy, příklady, "
"nadpisy a obrázky. Od verze 1.20 je dána přednost použití jen podmnožiny ze "
"základní syntaxe formátování textu. Tato podmnožina se nazývá <ulink url="
"\"http://daringfireball.net/projects/markdown/\">Markdown</ulink>. "
"Dokumentace ze starší verze GTK-Doc, která obsahuje Markdown, bude "
"vygenerována tak, jak je. Například položky seznamu se objeví s pomlčkou na "
"začátku."

#. (itstool) path: sect1/para
#: C/index.docbook:1163
msgid ""
"While markdown is now preferred one can mix both. One limitation here is "
"that one can use docbook xml within markdown, but markdown within docbook "
"xml is not supported."
msgstr ""
"I když je markdown v současnosti preferovaný, můžete míchat oba dohromady. "
"Má to jediné omezení v tom, že můžete použít docbook xml v markdown, ale "
"markdown v docbook xml podporován není."

#. (itstool) path: sect1/para
#: C/index.docbook:1169
msgid ""
"In older GTK-Doc releases, if you need support for additional formatting, "
"you would need to enable the usage of docbook XML tags inside doc-comments "
"by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
"the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
"filename>."
msgstr ""
"Když ve starších vydáních GTK-Doc potřebujete podporu pro dodatečné "
"formátování, musíte zapnout použití značek XML pro DocBook uvnitř "
"dokumentačních komentářů pomocí <option>--xml-mode</option> (nebo <option>--"
"sgml-mode</option>) v proměnné <symbol>MKDB_OPTIONS</symbol> v souboru "
"<filename>Makefile.am</filename>."

#. (itstool) path: example/title
#: C/index.docbook:1178
msgid "GTK-Doc comment block using Markdown"
msgstr "Komentářový blok GTK-Doc používající značkovací jazyk"

#. (itstool) path: example/programlisting
#: C/index.docbook:1179
#, 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"
" * |[&lt;!-- language=\"C\" --&gt;\n"
" * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
" * ]|\n"
" */\n"
msgstr ""
"\n"
"/**\n"
" * identifikátor:\n"
" *\n"
" * odstavec dokumentace…\n"
" *\n"
" * # Podnadpis #\n"
" *\n"
" * ## Podnadpis druhé úrovně\n"
" *\n"
" * # Podnadpis s kotvou pro odkazy # {#heading-two}\n"
" *\n"
" * další dokumentace:\n"
" *\n"
" * - položka seznamu 1\n"
" *\n"
" *   Odstavec v rámci položky seznamu.\n"
" *\n"
" * - položka seznamu 2\n"
" *\n"
" * 1. číslovaná položka seznamu\n"
" *\n"
" * 2. další číslovaná položka seznamu\n"
" *\n"
" * Další odstavec. [Odkazy na webové stránky GNOME](http://www.gnome.org/)\n"
" *\n"
" * ![vložený obrázek](plot-result.png)\n"
" *\n"
" * [Odkaz na nadpis pomocí kotvy uvedené výše][heading-two]\n"
" *\n"
" * Příklad v jazyce C:\n"
" * |[&lt;!-- language=\"C\" --&gt;\n"
" * GtkWidget *label = gtk_label_new (\"Paráda!\");\n"
" * ]|\n"
" */\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1218
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 ""
"Více příkladů k podporovaným značkám Markdown můžete najít v <ulink url="
"\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown"
"\">Referenční příručce k syntaxi Markdown pro dokumentaci GTK+</ulink>."

#. (itstool) path: tip/para
#: C/index.docbook:1224
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 developers to understand your "
"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 ""
"Jak již bylo zmíněno dříve, slouží GTK-Doc pro dokumentování veřejného API. "
"Tím pádem nemůžete psát dokumentaci pro statické symboly. Nicméně je vhodné "
"komentovat i tyto symboly. Pomůže to ostatním vývojářům porozumět vašemu "
"kódu. Proto doporučujeme komentovat je pomocí normálních komentářů (bez "
"druhé „*“ na prvním řádku). Pokud je budete v budoucnu chtít předělat na "
"veřejné, jediné co budete muset udělat, je přidat do komentářového bloku "
"jednu „*“ a na správné místo v souboru oddílů vložit název symbolu."

#. (itstool) path: sect1/title
#: C/index.docbook:1239
msgid "Documenting sections"
msgstr "Dokumentování oddílů"

#. (itstool) path: sect1/para
#: C/index.docbook:1241
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 ""
"Každý oddíl dokumentace obsahuje informaci o jedné třídě nebo modulu. Můžete "
"do oddílu napsat blok, ve kterém je představíte. Stručný popis se rovněž "
"použije v rámci tabulky s obsahem. Všechna @pole jsou volitelná."

#. (itstool) path: example/title
#: C/index.docbook:1249
msgid "Section comment block"
msgstr "Komentářový blok oddílu"

#. (itstool) path: example/programlisting
#: C/index.docbook:1250
#, 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 ""
"\n"
"/**\n"
" * SECTION:meepapp\n"
" * @short_description: třída plikace\n"
" * @title: Aplikace Meep\n"
" * @section_id:\n"
" * @see_also: #MeepSettings\n"
" * @stability: Stable\n"
" * @include: meep/app.h\n"
" * @image: application.png\n"
" *\n"
" * Třída aplikace starající se o…\n"
" */\n"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1269
msgid "SECTION:&lt;name&gt;"
msgstr "SECTION:&lt;název&gt;"

#. (itstool) path: listitem/para
#: C/index.docbook:1271
msgid ""
"The name links the section documentation to the respective part in the "
"<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
"should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
"txt</filename> file."
msgstr ""
"Název prováže oddíl dokumentace s příslušnou částí v souboru <filename>&lt;"
"package&gt;-sections.txt</filename>. Zde zadaný název musí odpovídat značce "
"&lt;SOUBOR&gt; v souboru <filename>&lt;package&gt;-sections.txt</filename>."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1280
msgid "@short_description"
msgstr "@short_description"

#. (itstool) path: listitem/para
#: C/index.docbook:1282
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 ""
"Jednořádkový popis oddílu, který se později objeví za odkazy v tabulce s "
"obsahem a na začátku stránky oddílu."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1289
msgid "@title"
msgstr "@title"

#. (itstool) path: listitem/para
#: C/index.docbook:1291
msgid ""
"The section title defaults to &lt;name&gt; from the SECTION declaration. It "
"can be overridden with the @title field."
msgstr ""
"Název oddílu se standardně zvolí podle &lt;name&gt; v deklaraci SECTION. Lze "
"jej ale určit i přímo v poli @title."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1298
msgid "@section_id"
msgstr "@section_id"

#. (itstool) path: listitem/para
#: C/index.docbook:1300
msgid ""
"Overrides the use of title as a section identifier. For GObjects the &lt;"
"title&gt; is used as a section_id and for other sections it is &lt;"
"MODULE&gt;-&lt;title&gt;."
msgstr ""
"Přepíše použití názvu jako identifikátoru oddílu. Pro objekty GObject se "
"jako section_id použije &lt;title&gt; a pro ostatní oddíly to je &lt;"
"MODULE&gt;-&lt;title&gt;."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1308
msgid "@see_also"
msgstr "@see_also"

#. (itstool) path: listitem/para
#: C/index.docbook:1310
msgid "A list of symbols that are related to this section."
msgstr "Seznam symbolů, které se vztahují k tomuto oddílu."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1316
msgid "@stability"
msgstr "@stability"

#. (itstool) path: listitem/para
#: C/index.docbook:1323
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 ""
"Stable (stabilní) – Záměrem stabilního rozhraní je umožnit libovolné třetí "
"straně vyvinout aplikace využívající toto rozhraní, vydat je a moci se "
"spolehnout, že poběží na všech podružných vydáních produktu (po té, co je "
"rozhraní vydáno a v rámci stejné hlavní verze). I mezi hlavními vydáními se "
"nekompatibilní změny očekávají zřídka v opravdu odůvodněných případech."

#. (itstool) path: listitem/para
#: C/index.docbook:1335
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 ""
"Unstable (nestabilní) – Nestabilní rozhraní je experimentální a přechodné. "
"Typicky bývá dáno vývojářům k dispozici kvůli včasnému přístupu k novým a "
"rychle se měnícím technologiím nebo kvůli poskytnutí provizorního řešení "
"problému, kdy je předpokládané více obecné řešení. Není žádná záruka ohledně "
"zdrojové či binární kompatibility při přechodu z jedné podružné verze na "
"následujíc."

#. (itstool) path: listitem/para
#: C/index.docbook:1347
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 ""
"Private (soukromé) – Rozhraní, které může být použité v rámci zásobníku "
"GNOME, ale není dokumentované pro koncového uživatele. Takové funkce by se "
"měly používat jen určeným a dokumentovaným způsobem."

#. (itstool) path: listitem/para
#: C/index.docbook:1356
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 ""
"Internal (interní) – Rozhraní, které je určené pro interní potřeby modulu a "
"nevyžaduje dokumentaci pro koncového uživatele. Funkce, které jsou "
"nedokumentované, jsou považované za interní."

#. (itstool) path: listitem/para
#: C/index.docbook:1318
msgid ""
"An informal description of the stability level this API has. We recommend "
"the use of one of these terms: <_:itemizedlist-1/>"
msgstr ""
"Informační popis úrovně stability tohoto API. Doporučujeme použít jeden z "
"těchto termínů: <_:itemizedlist-1/>"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1368
msgid "@include"
msgstr "@include"

#. (itstool) path: listitem/para
#: C/index.docbook:1370
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 ""
"Seznam souborů z <literal>#include</literal> oddělených čárkou, aby se "
"zobrazily v oddílu anotace. Přepisuje globální hodnotu ze <link linkend="
"\"metafiles_sections\">souboru oddílů</link> nebo příkazové řádky. Tato "
"položka je volitelná."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1379
msgid "@image"
msgstr "@image"

#. (itstool) path: listitem/para
#: C/index.docbook:1381
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 ""
"Obrázek, který se má zobrazit na začátku referenční stránky k tomuto oddílu. "
"Často se jedná o nějaký nákres, který schématicky znázorňuje podobu třídy "
"nebo nákres se vztahy vůči jiným třídám. Tato položka je volitelná."

#. (itstool) path: tip/para
#: C/index.docbook:1392
msgid ""
"To avoid unnecessary recompilation after doc-changes put the section docs "
"into the c-source where possible."
msgstr ""
"Aby se po změně dokumentace předešlo rekompilacím, které nejsou nutné, "
"vložte, kde je to možné, dokumentaci oddílu do zdrojového kódu c."

#. (itstool) path: sect1/title
#: C/index.docbook:1401
msgid "Documenting symbols"
msgstr "Dokumentování symbolů"

#. (itstool) path: sect1/para
#: C/index.docbook:1403
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 ""
"Každý symbol (funkce, makro, struktura, výčet, signál a vlastnost) se "
"dokumentuje v odděleném bloku. Blok je nejlepší umístit v rámci definice "
"symbolu, protože se tak snadno udržuje synchronizovaný. Z tohoto důvodu se "
"funkce obvykle dokumentují ve zdrojovém kódu C a makra, struktury a výčty v "
"hlavičkovém souboru."

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1411 C/index.docbook:1477
msgid "General tags"
msgstr "Obecné značky"

#. (itstool) path: sect2/para
#: C/index.docbook:1413
msgid ""
"You can add versioning information to all documentation elements to tell "
"when an API was introduced, or when it was deprecated."
msgstr ""
"Informace o verzích můžete přidat ke všem prvkům dokumentace, abyste "
"sdělili, kdy bylo API zavedeno, nebo kdy bylo označeno za zastaralé."

#. (itstool) path: variablelist/title
#: C/index.docbook:1418
msgid "Versioning Tags"
msgstr "Značky pro verzování"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1419
msgid "Since:"
msgstr "Since:"

#. (itstool) path: listitem/para
#: C/index.docbook:1421
msgid "Description since which version of the code the API is available."
msgstr "Popisuje, od které verze kódu je API dostupné."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1426
msgid "Deprecated:"
msgstr "Deprecated:"

#. (itstool) path: listitem/para
#: C/index.docbook:1428
msgid ""
"Paragraph denoting that this function should no be used anymore. The "
"description should point the reader to the new API."
msgstr ""
"Odstavec upozorňující, že by se tato funkce neměla nadále používat. Popis by "
"měl čtenáře odkazovat na nové API."

#. (itstool) path: sect2/para
#: C/index.docbook:1436
msgid ""
"You can also add stability information to all documentation elements to "
"indicate whether API stability is guaranteed for them for all future minor "
"releases of the project."
msgstr ""
"Můžete také ke všem prvkům dokumentace přidat informaci o stabilitě, abyste "
"dali najevo, že je u API zaručena stabilita pro všechna následující "
"minoritní vydání projektu."

#. (itstool) path: sect2/para
#: C/index.docbook:1442
msgid ""
"The default stability level for all documentation elements can be set by "
"passing the <option>--default-stability</option> argument to "
"<application>gtkdoc-mkdb</application> with one of the values below."
msgstr ""
"Výchozí stabilitu pro všechny prvky dokumentace můžete pomocí argumentu "
"<option>--default-stability</option> s jednou u níže uvedených hodnot předat "
"do <application>gtkdoc-mkdb</application>."

#. (itstool) path: variablelist/title
#: C/index.docbook:1448
msgid "Stability Tags"
msgstr "Značky pro stabilitu"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1449
msgid "Stability: Stable"
msgstr "Stability: Stable"

#. (itstool) path: listitem/para
#: C/index.docbook:1451
msgid ""
"Mark the element as stable. This is for public APIs which are guaranteed to "
"remain stable for all future minor releases of the project."
msgstr ""
"Označuje prvek jako stabilní. Je to určeno pro veřejná API, která zaručují, "
"že zůstanou stabilní po všechna minoritní vydání projektu."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1458
msgid "Stability: Unstable"
msgstr "Stability: Unstable"

#. (itstool) path: listitem/para
#: C/index.docbook:1460
msgid ""
"Mark the element as unstable. This is for public APIs which are released as "
"a preview before being stabilised."
msgstr ""
"Označuje prvek jako nestabilní. Je to určeno pro veřejná API, která jsou "
"vydána jako ukázky před tím, než jsou stabilizována."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1466
msgid "Stability: Private"
msgstr "Stability: Private"

#. (itstool) path: listitem/para
#: C/index.docbook:1468
msgid ""
"Mark the element as private. This is for interfaces which can be used by "
"tightly coupled modules, but not by arbitrary third parties."
msgstr ""
"Označuje prvek jako soukromý. Je to určeno pro rozhraní, která mohou být "
"použita přímo v modulu, ale ne kterýmikoliv třetími stranami."

#. (itstool) path: example/programlisting
#: C/index.docbook:1478
#, 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 ""
"\n"
"/**\n"
" * foo_get_bar:\n"
" * @foo: nějaké něco\n"
" *\n"
" * Získá @foo něčeho.\n"
" *\n"
" * Returns: @foo něčeho\n"
" *\n"
" * Since: 2.6\n"
" * Deprecated: 2.12: Místo toho použijte foo_baz_get_bar().\n"
" */\n"
"Bar *\n"
"foo_get_bar(Foo *foo)\n"
"{\n"
"...\n"

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1498 C/index.docbook:1508
msgid "Annotations"
msgstr "Anotace"

#. (itstool) path: sect2/para
#: C/index.docbook:1500
msgid ""
"Documentation blocks can contain annotation-tags. These tags will be "
"rendered with tooltips describing their meaning. The tags are used by "
"gobject-introspection to generate language bindings. A detailed list of the "
"supported tags can be found on <ulink url=\"http://live.gnome.org/"
"GObjectIntrospection/Annotations\" type=\"http\">the wiki</ulink>."
msgstr ""
"Dokumentační bloky mohou obsahovat anotační štítky. Tyto štítky budou "
"zpracovány jako vysvětlivky popisující jejich význam. Používají se "
"introspekcí objektu GObjekt k vygenerování vazby na další jazyky. Podrobný "
"seznam podporovaných štítků můžete najít na <ulink url=\"http://live.gnome."
"org/GObjectIntrospection/Annotations\" type=\"http\">wiki</ulink>."

#. (itstool) path: example/programlisting
#: C/index.docbook:1509
#, no-wrap
msgid ""
"\n"
"/**\n"
" * foo_get_bar: (annotation)\n"
" * @foo: (annotation): some foo\n"
" *\n"
" * Retrieves @foo's bar.\n"
" *\n"
" * Returns: (annotation): @foo's bar\n"
" */\n"
"...\n"
"/**\n"
" * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
" *                                    (and another annotation)\n"
" * @foo: (annotation) (another annotation): some foo\n"
" *\n"
" * Sets bar on @foo.\n"
" */\n"
msgstr ""
"\n"
"/**\n"
" * foo_get_bar: (annotation)\n"
" * @foo: (annotation): nějaké něco\n"
" *\n"
" * Získá @foo něčeho.\n"
" *\n"
" * Returns: (annotation): @foo něčeho\n"
" */\n"
"...\n"
"/**\n"
" * foo_set_bar_using_the_frobnicator: (annotation) (annotation)\n"
" *                                    (annotation) …\n"
" * @foo: (annotation) (annotation) …: nějaké něco\n"
" *\n"
" * Nastaví něco na @foo.\n"
" */\n"

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1530 C/index.docbook:1559
msgid "Function comment block"
msgstr "Komentářový blok pro funkci"

#. (itstool) path: listitem/para
#: C/index.docbook:1536
msgid ""
"Document whether returned objects, lists, strings, etc, should be freed/"
"unrefed/released."
msgstr ""
"Zdokumentovat, jestli je třeba vracené objekty, seznamy, řetězce apod. "
"uvolnit z paměti."

#. (itstool) path: listitem/para
#: C/index.docbook:1542
msgid "Document whether parameters can be NULL, and what happens if they are."
msgstr ""
"Zdokumentovat, jestli může parametr být NULL a co se stane, když tomu tak je."

#. (itstool) path: listitem/para
#: C/index.docbook:1547
msgid ""
"Mention interesting pre-conditions and post-conditions where appropriate."
msgstr "Kde je to vhodné, zmínit úvodní a koncové podmínky."

#. (itstool) path: sect2/para
#: C/index.docbook:1532 C/index.docbook:1618
msgid "Please remember to: <_:itemizedlist-1/>"
msgstr "Nezapomeňte prosím: <_:itemizedlist-1/>"

#. (itstool) path: sect2/para
#: C/index.docbook:1554
msgid ""
"Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
"private. They are treated like static functions."
msgstr ""
"Gtk-doc předpokládá, že všechny symboly (makra, funkce) začínající znakem "
"„_“, jsou soukromé. Potom se s nimi zachází jako se statickými funkcemi."

#. (itstool) path: example/programlisting
#: C/index.docbook:1560
#, 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 ""
"\n"
"/**\n"
" * function_name:\n"
" * @par1:  popis parametru 1. Může zabírat více jak\n"
" * jeden řádek.\n"
" * @par2:  popis parametru 2\n"
" * @...:  seznam proměnných parametrů zakončených NULL\n"
" *\n"
" * Zde pokračuje popis funkce. K odkazu na parametr můžete použit @par1,\n"
" * takže bude ve výstupu zvýrazněný. Můžete také použít %constant pro\n"
" * konstanty, function_name() pro funkce a #GtkWidget pro odkazy na jiné\n"
" * deklarace (které mohou být zdokumentované jinde).\n"
" *\n"
" * Returns: celé číslo.\n"
" *\n"
" * Since: 2.2\n"
" * Deprecated: 2.18: Místo toho použijte other_function().\n"
" */\n"

#. (itstool) path: variablelist/title
#: C/index.docbook:1581
msgid "Function tags"
msgstr "Značky pro funkce"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1582 C/index.docbook:1789
msgid "Returns:"
msgstr "Returns:"

#. (itstool) path: listitem/para
#: C/index.docbook:1584
msgid "Paragraph describing the returned result."
msgstr "Odstavec popisující vracený výsledek."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1589
msgid "@...:"
msgstr "@…:"

#. (itstool) path: listitem/para
#: C/index.docbook:1591
msgid ""
"In case the function has variadic arguments, you should use this tag "
"(@Varargs: does also work for historic reasons)."
msgstr ""
"Když má funkce proměnný počet argumentů, měli byste použít tuto značku (z "
"historických důvodů funguje i @Varargs:)."

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1601 C/index.docbook:1603
msgid "Property comment block"
msgstr "Komentářový blok pro vlastnost"

#. (itstool) path: example/programlisting
#: C/index.docbook:1604
#, 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 ""
"\n"
"/**\n"
" * SomeWidget:some-property:\n"
" *\n"
" * Zde vlastnost zdokumentujte.\n"
" */\n"
"g_object_class_install_property (object_class, PROP_SOME_PROPERTY, …);\n"

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1616 C/index.docbook:1635
msgid "Signal comment block"
msgstr "Komentářový blok pro signál"

#. (itstool) path: listitem/para
#: C/index.docbook:1622
msgid ""
"Document when the signal is emitted and whether it is emitted before or "
"after other signals."
msgstr ""
"Zdokumentovat, kdy je signál vyslán a jestli je vyslána před nebo po "
"ostatních signálech."

#. (itstool) path: listitem/para
#: C/index.docbook:1628
msgid "Document what an application might do in the signal handler."
msgstr "Zdokumentovat, co aplikace smí v obsluze signálu provádět."

#. (itstool) path: example/programlisting
#: C/index.docbook:1636
#, 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[FOOBARIZED] =\n"
"  g_signal_new (\"foobarized\",\n"
"                ...\n"
msgstr ""
"\n"
"/**\n"
" * FooWidget::foobarized:\n"
" * @widget: widget, který signál přijímá\n"
" * @foo: nějaké něco\n"
" * @bar: jiné něco\n"
" *\n"
" * Signál ::foobarized je vyslán pokaždé, když někdo zkusí něco s @widget.\n"
" */\n"
"foo_signals[FOOBARIZED] =\n"
"  g_signal_new (\"foobarized\",\n"
"                ...\n"

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1653 C/index.docbook:1654
msgid "Struct comment block"
msgstr "Komentářový blok pro strukturu"

#. (itstool) path: example/programlisting
#: C/index.docbook:1655
#, no-wrap
msgid ""
"\n"
"/**\n"
" * FooWidget:\n"
" * @bar: some #gboolean\n"
" *\n"
" * This is the best widget, ever.\n"
" */\n"
"typedef struct _FooWidget {\n"
"  GtkWidget parent_instance;\n"
"\n"
"  gboolean bar;\n"
"} FooWidget;\n"
msgstr ""
"\n"
"/**\n"
" * FooWidget:\n"
" * @bar: nějaká #gboolean\n"
" *\n"
" * Tohle je ten nejlepší widget.\n"
" */\n"
"typedef struct _FooWidget {\n"
"  GtkWidget parent_instance;\n"
"\n"
"  gboolean bar;\n"
"} FooWidget;\n"

#. (itstool) path: sect2/para
#: C/index.docbook:1670
msgid ""
"Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
"want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
"behaviour."
msgstr ""
"Před privátními poli struktury použijte <code>/*&lt; private &gt;*/</code>, "
"abyste je skryli. K přesně opačnému účelu se používá <code>/*&lt; public &gt;"
"*/</code>."

#. (itstool) path: sect2/para
#: C/index.docbook:1676
msgid ""
"If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
"it will be considered private automatically and doesn't need to be mentioned "
"in the comment block."
msgstr ""
"Pokud je prvním polem „g_iface“, „parent_instance“ nebo „parent_class“, bude "
"za privátní považováno automaticky a není to zapotřebí zmiňovat v "
"komentářovém bloku."

#. (itstool) path: sect2/para
#: C/index.docbook:1682
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 ""
"Komentářové bloky struktur můžete použít také pro objekty GObject a třídy "
"GObjectClass. Obvykle je rozumné přidat komentářový blok pro třídu, pokud má "
"virtuální metody (protože to je způsob, jakým je lze zdokumentovat). Pro "
"vlastní GObject je možné použít příslušnou dokumentaci oddílu, který bude "
"mít samostatný blok pro strukturu instance, což se může hodit, když má "
"instance veřejná pole. Jedinou nevýhodou je, že se tím vytvoří dvě položky v "
"rejstříku se stejným názvem (struktura a oddíl)."

#. (itstool) path: sect2/title
#. (itstool) path: example/title
#: C/index.docbook:1694 C/index.docbook:1695
msgid "Enum comment block"
msgstr "Komentářový blok pro výčty"

#. (itstool) path: example/programlisting
#: C/index.docbook:1696
#, 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"
"  /*&lt; private &gt;*/\n"
"  SOMETHING_COUNT\n"
"} Something;\n"
msgstr ""
"\n"
"/**\n"
" * Something:\n"
" * @SOMETHING_FOO: nějaké něco\n"
" * @SOMETHING_BAR: jiné něco\n"
" *\n"
" * Výčtové hodnoty používané pro určení věci.\n"
" */\n"
"typedef enum {\n"
"  SOMETHING_FOO,\n"
"  SOMETHING_BAR,\n"
"  /*&lt; private &gt;*/\n"
"  SOMETHING_COUNT\n"
"} Something;\n"

#. (itstool) path: sect2/para
#: C/index.docbook:1713
msgid ""
"Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
"want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
"behaviour."
msgstr ""
"Před privátními výčtovými hodnotami použijte <code>/*&lt; private &gt;*/</"
"code>, abyste je skryli. K přesně opačnému účelu se používá <code>/*&lt; "
"public &gt;*/</code>."

#. (itstool) path: sect1/title
#: C/index.docbook:1724
msgid "Inline program documentation"
msgstr "Dokumentaci k vloženým programům"

#. (itstool) path: sect1/para
#: C/index.docbook:1725
msgid ""
"You can document programs and their commandline interface using inline "
"documentation."
msgstr ""
"Programy a jejich rozhraní příkazového řádku můžete zdokumentovat pomocí "
"vložené dokumentace."

#. (itstool) path: variablelist/title
#: C/index.docbook:1731
msgid "Tags"
msgstr "Značky"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1733
msgid "PROGRAM"
msgstr "PROGRAM"

#. (itstool) path: listitem/para
#: C/index.docbook:1736
msgid "Defines the start of a program documentation."
msgstr "Definuje začátek dokumentace k programu."

#. (itstool) path: varlistentry/term
#: C/index.docbook:1743
msgid "@short_description:"
msgstr "@short_description:"

#. (itstool) path: listitem/para
#: C/index.docbook:1745
msgid "Defines a short description of the program. (Optional)"
msgstr "Definuje krátký popis programu. (volitelné)"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1752
msgid "@synopsis:"
msgstr "@synopsis:"

#. (itstool) path: listitem/para
#: C/index.docbook:1754
msgid ""
"Defines the arguments, or list of arguments that the program can take. "
"(Optional)"
msgstr ""
"Definuje argumenty nebo seznam argumentů, které program přebírá. (volitelné)"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1762
msgid "@see_also:"
msgstr "@see_also:"

#. (itstool) path: listitem/para
#: C/index.docbook:1764
msgid "See Also manual page section. (Optional)"
msgstr "Část stránky oddílu „Viz také“. (volitelné)"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1771
msgid "@arg:"
msgstr "@arg:"

#. (itstool) path: listitem/para
#: C/index.docbook:1773
msgid "Argument(s) passed to the program and their description. (Optional)"
msgstr "Argument(y) předávané do programu a jejich popis. (volitelné)"

#. (itstool) path: varlistentry/term
#: C/index.docbook:1780
msgid "Description:"
msgstr "Description:"

#. (itstool) path: listitem/para
#: C/index.docbook:1782
msgid "A longer description of the program."
msgstr "Úplný popis programu."

#. (itstool) path: listitem/para
#: C/index.docbook:1791
msgid "Specify what value(s) the program returns. (Optional)"
msgstr "Specifikuje, jakou hodnotu či více hodnot program vrací. (volitelné)"

#. (itstool) path: sect2/title
#: C/index.docbook:1800
msgid "Example of program documentation."
msgstr "Příklad dokumentace k programu."

#. (itstool) path: example/title
#: C/index.docbook:1801
msgid "Program documentation block"
msgstr "Komentářový blok pro program"

#. (itstool) path: example/programlisting
#: C/index.docbook:1802
#, no-wrap
msgid ""
"\n"
"/**\n"
" * PROGRAM:test-program\n"
" * @short_description: A test program\n"
" * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
" * @see_also: test(1)\n"
" * @--arg1 *arg*: set arg1 to *arg*\n"
" * @--arg2 *arg*: set arg2 to *arg*\n"
" * @-v, --version: Print the version number\n"
" * @-h, --help: Print the help message\n"
" *\n"
" * Long description of program.\n"
" *\n"
" * Returns: Zero on success, non-zero on failure\n"
" */\n"
"int main(int argc, char *argv[])\n"
"{\n"
"\treturn 0;\n"
"}\n"
msgstr ""
"\n"
"/**\n"
" * PROGRAM:test-program\n"
" * @short_description: Testovací program\n"
" * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
" * @see_also: test(1)\n"
" * @--arg1 *arg*: nastaví arg1 do *arg*\n"
" * @--arg2 *arg*: nastaví arg2 do *arg*\n"
" * @-v, --version: Vypíše verzi programu\n"
" * @-h, --help: Vypíše nápovědu k programu\n"
" *\n"
" * Úplný popis programu.\n"
" *\n"
" * Returns: Vrací nulu při úspěchu, nenulovou hodnotu při selhání.\n"
" */\n"
"int main(int argc, char *argv[])\n"
"{\n"
"\treturn 0;\n"
"}\n"

#. (itstool) path: sect1/title
#: C/index.docbook:1828
msgid "Useful DocBook tags"
msgstr "Užitečné značky DocBook"

#. (itstool) path: sect1/para
#: C/index.docbook:1830
msgid ""
"Here are some DocBook tags which are most useful when documenting the code."
msgstr ""
"Zde jsou některé značky DocBook, které mají pro dokumentaci kódu největší "
"význam."

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1839
#, no-wrap
msgid ""
"\n"
"&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
msgstr ""
"\n"
"&lt;link linkend=\"glib-Hash-Tables\"&gt;Hašovací tabulky&lt;/link&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1835
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 ""
"Odkaz na jiný oddíl v dokumentaci GTK: <_:informalexample-1/> Odkazem je id "
"SGML/XML v první položce stránky, na kterou chcete odkazovat. Pro většinu "
"stránek je to v současnosti část („gtk“, „gdk“, „glib“) a potom název "
"stránky („Hašovací tabulka“). Pro ovládací prvky je to název třídy. Mezery a "
"podtržítka se převedou na „-“, aby to vyhovovalo SGML/XML."

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1852
#, no-wrap
msgid ""
"\n"
"&lt;function&gt;...&lt;/function&gt;\n"
msgstr ""
"\n"
"&lt;function&gt;…&lt;/function&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1849
msgid ""
"To refer to an external function, e.g. a standard C function: <_:"
"informalexample-1/>"
msgstr ""
"Odkaz na externí funkci, například standardní funkci C: <_:informalexample-1/"
">"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1861
#, no-wrap
msgid ""
"\n"
"&lt;example&gt;\n"
"  &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
"  &lt;programlisting language=\"C\"&gt;\n"
"      ...\n"
"  &lt;/programlisting&gt;\n"
"&lt;/example&gt;\n"
msgstr ""
"\n"
"&lt;example&gt;\n"
"  &lt;title&gt;Používání GHashTable.&lt;/title&gt;\n"
"  &lt;programlisting language=\"C\"&gt;\n"
"      ...\n"
"  &lt;/programlisting&gt;\n"
"&lt;/example&gt;\n"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1872
#, no-wrap
msgid ""
"\n"
"&lt;informalexample&gt;\n"
"  &lt;programlisting language=\"C\"&gt;\n"
"  ...\n"
"  &lt;/programlisting&gt;\n"
"&lt;/informalexample&gt;\n"
msgstr ""
"\n"
"&lt;informalexample&gt;\n"
"  &lt;programlisting language=\"C\"&gt;\n"
"  ...\n"
"  &lt;/programlisting&gt;\n"
"&lt;/informalexample&gt;\n"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1884
#, no-wrap
msgid ""
"\n"
"|[&lt;!-- language=\"C\" --&gt;\n"
"  ...\n"
"]|\n"
msgstr ""
"\n"
"|[&lt;!-- language=\"C\" --&gt;\n"
"  ...\n"
"]|\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1858
msgid ""
"To include example code: <_:informalexample-1/> or possibly this, for very "
"short code fragments which don't need a title: <_:informalexample-2/> In "
"both cases, the language attribute is optional and is used as a hint to the "
"syntax highlighting engine (pygments for html output). For the latter GTK-"
"Doc also supports an abbreviation: <_:informalexample-3/>"
msgstr ""
"Vložení ukázky kódu: <_:informalexample-1/> nebo pro velmi krátké úseky "
"kódu, které nepotřebují nadpisy, je případně možné i: <_:informalexample-2/> "
"V obou případech je atribut language volitelnáý a je používán jako rada pro "
"program provádějící zvýrazňování syntaxe (pygments pro výstup v html).V "
"novějších verzích GTK-Doc je také podporované zkracování: "
"<_:informalexample-3/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1895
#, no-wrap
msgid ""
"\n"
"&lt;itemizedlist&gt;\n"
"  &lt;listitem&gt;\n"
"    &lt;para&gt;\n"
"      ...\n"
"    &lt;/para&gt;\n"
"  &lt;/listitem&gt;\n"
"  &lt;listitem&gt;\n"
"    &lt;para&gt;\n"
"      ...\n"
"    &lt;/para&gt;\n"
"  &lt;/listitem&gt;\n"
"&lt;/itemizedlist&gt;\n"
msgstr ""
"\n"
"&lt;itemizedlist&gt;\n"
"  &lt;listitem&gt;\n"
"    &lt;para&gt;\n"
"      …\n"
"    &lt;/para&gt;\n"
"  &lt;/listitem&gt;\n"
"  &lt;listitem&gt;\n"
"    &lt;para&gt;\n"
"      …\n"
"    &lt;/para&gt;\n"
"  &lt;/listitem&gt;\n"
"&lt;/itemizedlist&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1892
msgid "To include bulleted lists: <_:informalexample-1/>"
msgstr "Vložení seznamu s odrážkami: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1915
#, no-wrap
msgid ""
"\n"
"&lt;note&gt;\n"
"  &lt;para&gt;\n"
"    Make sure you free the data after use.\n"
"  &lt;/para&gt;\n"
"&lt;/note&gt;\n"
msgstr ""
"\n"
"&lt;note&gt;\n"
"  &lt;para&gt;\n"
"    Ujistěte se, že data po použití uvolníte.\n"
"  &lt;/para&gt;\n"
"&lt;/note&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1912
msgid ""
"To include a note which stands out from the text: <_:informalexample-1/>"
msgstr "Vložení poznámky, která se objeví mimo text: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1928
#, no-wrap
msgid ""
"\n"
"&lt;type&gt;unsigned char&lt;/type&gt;\n"
msgstr ""
"\n"
"&lt;type&gt;unsigned char&lt;/type&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1925
msgid "To refer to a type: <_:informalexample-1/>"
msgstr "Odkaz na typ: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1937
#, no-wrap
msgid ""
"\n"
"&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
msgstr ""
"\n"
"&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1934
msgid ""
"To refer to an external structure (not one described in the GTK docs): <_:"
"informalexample-1/>"
msgstr ""
"Odkaz na externí strukturu (která není popsaná v dokumentaci GTK): <_:"
"informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1946
#, no-wrap
msgid ""
"\n"
"&lt;structfield&gt;len&lt;/structfield&gt;\n"
msgstr ""
"\n"
"&lt;structfield&gt;len&lt;/structfield&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1943
msgid "To refer to a field of a structure: <_:informalexample-1/>"
msgstr "Odkaz na pole struktury: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1955
#, no-wrap
msgid ""
"\n"
"&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
msgstr ""
"\n"
"&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1952
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 ""
"Pro odkaz na název třídy by se dal nejspíše použít: <_:informalexample-1/> "
"ale pravděpodobně místo toho použijete #GtkWidget (aby se automaticky "
"vytvořil odkaz na stránku ovládacího prvku, viz <link linkend="
"\"documenting_syntax\">zkratky</link>)."

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1966
#, no-wrap
msgid ""
"\n"
"&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
msgstr ""
"\n"
"&lt;emphasis&gt;Toto je důležité&lt;/emphasis&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1963
msgid "To emphasize text: <_:informalexample-1/>"
msgstr "Zvýrazněný text: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1975
#, no-wrap
msgid ""
"\n"
"&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
msgstr ""
"\n"
"&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1972
msgid "For filenames use: <_:informalexample-1/>"
msgstr "Pro název souboru použijte: <_:informalexample-1/>"

#. (itstool) path: informalexample/programlisting
#: C/index.docbook:1984
#, no-wrap
msgid ""
"\n"
"&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
msgstr ""
"\n"
"&lt;keycombo&gt;&lt;keycap&gt;Ctrl&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:1981
msgid "To refer to keys use: <_:informalexample-1/>"
msgstr "Odkaz na použití klávesy: <_:informalexample-1/>"

#. (itstool) path: chapter/title
#: C/index.docbook:1994
msgid "Filling the extra files"
msgstr "Vyplňování dodatečných souborů"

#. (itstool) path: chapter/para
#: C/index.docbook:1996
msgid ""
"There are a couple of extra files, that need to be maintained along with the "
"inline source code comments: <filename>&lt;package&gt;.types</filename>, "
"<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
"<filename>&lt;package&gt;-sections.txt</filename>."
msgstr ""
"Mimo komentářů vložených ve zdrojovém kódu je zde ještě pár dodatečných "
"souborů, které je potřeba udržovat:<filename>&lt;balíček&gt;.types</"
"filename>, <filename>&lt;balíček&gt;-docs.xml</filename> (dříve .sgml) a "
"<filename>&lt;balíček&gt;-sections.txt</filename>."

#. (itstool) path: sect1/title
#: C/index.docbook:2005
msgid "Editing the types file"
msgstr "Úprava souboru s typy"

#. (itstool) path: sect1/para
#: C/index.docbook:2007
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>&lt;"
"package&gt;.types</filename> file."
msgstr ""
"Pokud vaše knihovna nebo aplikace vkládá objekty GObject, chcete jejich "
"signály, argumenty/parametry a pozici v hierarchii ukázat v dokumentaci. "
"Vše, co pro to potřebujete udělat, je vypsat funkce <function>xxx_get_type</"
"function> spolu s jejich include v souboru <filename>&lt;balíček&gt;.types</"
"filename>."

#. (itstool) path: example/title
#: C/index.docbook:2016
msgid "Example &lt;package&gt;.types file"
msgstr "Příklad souboru &lt;balíček&gt;.types"

#. (itstool) path: example/programlisting
#: C/index.docbook:2017
#, no-wrap
msgid ""
"\n"
"#include &lt;gtk/gtk.h&gt;\n"
"\n"
"gtk_accel_label_get_type\n"
"gtk_adjustment_get_type\n"
"gtk_alignment_get_type\n"
"gtk_arrow_get_type\n"
msgstr ""
"\n"
"#include &lt;gtk/gtk.h&gt;\n"
"\n"
"gtk_accel_label_get_type\n"
"gtk_adjustment_get_type\n"
"gtk_alignment_get_type\n"
"gtk_arrow_get_type\n"

#. (itstool) path: sect1/para
#: C/index.docbook:2028
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 ""
"Od GTK-Doc verze 1.8 vám tento seznam vygeneruje <application>gtkdoc-scan</"
"application>. Stačí jen přidat „--rebuild-types“ do SCAN_OPTIONS v "
"<filename>Makefile.am</filename>. Pokud tento přístup použijete, neměli "
"byste soubor s typy šířit do správy verzí."

#. (itstool) path: sect1/title
#: C/index.docbook:2037
msgid "Editing the master document"
msgstr "Úprava hlavního dokumentu"

#. (itstool) path: sect1/para
#: C/index.docbook:2039
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 ""
"GTK-Doc produkuje dokumentaci v SGML/XML standardu DocBook. Když se "
"zpracovávají komentáře vložené ve zdrojovém kódu, generují nástroje GTK-Doc "
"pro každou třídu nebo modul jednu stránku dokumentace jako samostatný "
"soubor. Všechny jsou pak uvedené seřazené v hlavním dokumentu."

#. (itstool) path: sect1/para
#: C/index.docbook:2046
msgid ""
"While GTK-Doc creates a template master document for you, later runs will "
"not touch it again. This means that one can freely structure the "
"documentation. That includes grouping pages and adding extra pages. GTK-Doc "
"has now a test suite, where also the master-document is recreated from "
"scratch. Its a good idea to look at this from time to time to see if there "
"are some new goodies introduced there."
msgstr ""
"Jakmile pro vás GTK-Doc vytvoří šablonu hlavního dokumentu, při pozdějším "
"spuštění již do ní nezasahuje. To znamená, že můžete dokumentaci bez omezení "
"strukturovat. A to včetně seskupování stránek a přidávání doplňujících "
"stránek. GTK-Doc má v současnosti testovací sadu, ve které je také hlavní "
"dokument vytvořen znovu od začátku. Je dobré se čas od času do něj "
"nahlédnout, jestli se v něm neobjevily nějaké nové věci."

#. (itstool) path: tip/para
#: C/index.docbook:2056
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 ""
"Nevytvářejte výukové dokumenty (tutorial) jako zvláštní dokumenty. Napište "
"je jako zvláštní kapitolu. Výhodou přímého spojení výukového dokumentu k "
"vaší knihovně s dokumentací API je snadné vytváření odkazů pro symboly. "
"Zvyšuje se tím také šance, že výukový dokument bude reflektovat aktualizace "
"v knihovně."

#. (itstool) path: sect1/para
#: C/index.docbook:2065
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 ""
"Nyní se podívejme, které věci můžete v hlavním dokumentu měnit. Pro začátek "
"je to pouze název. Je zde několik zástupných hodnot (text v hranatých "
"závorkách), o které byste se měli postarat."

#. (itstool) path: example/title
#: C/index.docbook:2072
msgid "Master document header"
msgstr "Hlavička hlavního dokumentu"

#. (itstool) path: example/programlisting
#: C/index.docbook:2073
#, no-wrap
msgid ""
"\n"
"&lt;bookinfo&gt;\n"
"  &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
"  &lt;releaseinfo&gt;\n"
"    for MODULENAME [VERSION]\n"
"    The latest version of this documentation can be found on-line at\n"
"    &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
"  &lt;/releaseinfo&gt;\n"
"&lt;/bookinfo&gt;\n"
"\n"
"&lt;chapter&gt;\n"
"  &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
msgstr ""
"\n"
"&lt;bookinfo&gt;\n"
"  &lt;title&gt;Referenční příručka k NÁZEV_MODULU&lt;/title&gt;\n"
"  &lt;releaseinfo&gt;\n"
"    pro NÁZEV_MODULU [VERSION]\n"
"    Nejvnovější verzi tohoto dokumentu můžete najít on-line na\n"
"    &lt;ulink role=\"online-location\" url=\"http://[SERVER]/NÁZEV_MODULU/index.html\"&gt;http://[SERVER]/NÁZEV_MODULU/&lt;/ulink&gt;.\n"
"  &lt;/releaseinfo&gt;\n"
"&lt;/bookinfo&gt;\n"
"\n"
"&lt;chapter&gt;\n"
"  &lt;title&gt;[Insert title here]&lt;/title&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:2089
msgid ""
"In addition a few option elements are created in commented form. You can "
"review these and enable them as you like."
msgstr ""
"Navíc se vytvoří pár volitelných prvků ve formě komentáře. Můžete si je "
"projít a případně povolit."

#. (itstool) path: example/title
#: C/index.docbook:2095
msgid "Optional part in the master document"
msgstr "Volitelná část hlavního dokumentu"

#. (itstool) path: example/programlisting
#: C/index.docbook:2096
#, no-wrap
msgid ""
"\n"
"  &lt;!-- enable this when you use gobject introspection annotations\n"
"  &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
"  --&gt;\n"
msgstr ""
"\n"
"  &lt;!-- enable this when you use gobject introspection annotations\n"
"  &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
"  --&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:2104
msgid ""
"Finally you need to add new section whenever you introduce one. The <link "
"linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
"you of newly generated xml files that are not yet included into the doc."
msgstr ""
"Nakonec musíte přidat nový oddíl, kdekoliv chcete. Nástroj <link linkend="
"\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> vás upozorní na nově "
"vygenerované soubory XML, které zatím nejsou v dokumentaci zahrnuté."

#. (itstool) path: example/title
#: C/index.docbook:2112 C/index.docbook:2147
msgid "Including generated sections"
msgstr "Vkládání generovaných oddílů"

#. (itstool) path: example/programlisting
#: C/index.docbook:2113
#, no-wrap
msgid ""
"\n"
"  &lt;chapter&gt;\n"
"    &lt;title&gt;my library&lt;/title&gt;\n"
"      &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
"      ...\n"
msgstr ""
"\n"
"  &lt;chapter&gt;\n"
"    &lt;title&gt;moje knihovna&lt;/title&gt;\n"
"      &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
"      …\n"

#. (itstool) path: sect1/title
#: C/index.docbook:2125
msgid "Editing the section file"
msgstr "Úprava souboru oddílů"

#. (itstool) path: sect1/para
#: C/index.docbook:2127
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 ""
"Soubor oddílů se používá k organizování výstupu dokumentace z GTK-Doc. Zde "
"se určuje, který symbol náleží ke kterému modulu nebo třídě, a řídí se "
"viditelnost (jestli je veřejný nebo soukromý)."

#. (itstool) path: sect1/para
#: C/index.docbook:2133
msgid ""
"The section file is a plain text file with tags delimiting sections. Blank "
"lines are ignored and lines starting with a '#' are treated as comment lines."
msgstr ""
"Soubor oddílů je prostý textový soubor, ve kterém jsou oddíly oddělené "
"značkami. Prázdné řádky se ignorují a s řádky začínajícími „#“ se zachází "
"jako s komentářovými řádky."

#. (itstool) path: note/para
#: C/index.docbook:2140
msgid ""
"While the tags make the file look like xml, it is not. Please do not close "
"tags like &lt;SUBSECTION&gt;."
msgstr ""
"Přestože díky značkám vypadá soubor podobně jako XML, není tomu tak. "
"Neuzavírejte prosím značky jako je &lt;SUBSECTION&gt;."

#. (itstool) path: example/programlisting
#: C/index.docbook:2148
#, no-wrap
msgid ""
"\n"
"&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
"\n"
"&lt;SECTION&gt;\n"
"&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
"&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
"MeepApp\n"
"&lt;SUBSECTION Standard&gt;\n"
"MEEP_APP\n"
"...\n"
"MeepAppClass\n"
"meep_app_get_type\n"
"&lt;/SECTION&gt;\n"
msgstr ""
"\n"
"&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
"\n"
"&lt;SECTION&gt;\n"
"&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
"&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
"MeepApp\n"
"&lt;SUBSECTION Standard&gt;\n"
"MEEP_APP\n"
"...\n"
"MeepAppClass\n"
"meep_app_get_type\n"
"&lt;/SECTION&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:2165
msgid ""
"The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
"without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
"FILE&gt;' will result in the section declarations being output in the "
"template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
"converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
"filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
"(The name of the HTML file is based on the module name and the section "
"title, or for GObjects it is based on the GObjects class name converted to "
"lower case)."
msgstr ""
"Značka &lt;FILE&gt; … &lt;/FILE&gt; se používá k určení názvu souboru bez "
"přípony. Například použití „&lt;FILE&gt;gnome-config&lt;/FILE&gt;“ bude mít "
"v deklaracích oddílu za následek výstup do souboru šablony <filename>tmpl/"
"gnome-config.sgml</filename>, který bude převeden do souboru <filename>sgml/"
"gnome-config.sgml</filename> ve formátu DocBook SGML nebo do souboru "
"<filename>xml/gnome-config.xml</filename> ve formátu DocBook XML. (Název "
"souboru HTML vychází z názvu modulu a názvu oddílu, případně pro GObject z "
"názvu třídy GObject převedeného na malá písmena.)"

#. (itstool) path: sect1/para
#: C/index.docbook:2177
msgid ""
"The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
"section. It is only useful before the templates (if used) are initially "
"created, since the title set in the template file overrides this. Also if "
"one uses SECTION comment in the sources, this is obsolete."
msgstr ""
"Značka &lt;TITLE&gt; … &lt;/TITLE&gt; se používá k určení názvu oddílu. To "
"je použitelné pouze dříve, než je poprvé vytvořena šablona (pokud se "
"používá), protože název nastavený v šabloně tento název přepíše. Navíc je "
"považována za zastaralou v případě, že se používá komentář SECTION ve "
"zdrojovém kódu."

#. (itstool) path: sect1/para
#: C/index.docbook:2184
msgid ""
"You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
"Currently it outputs a blank line between subsections in the synopsis "
"section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
"declarations (e.g. the functions like g_object_get_type and macros like "
"G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
"documentation. You can also use &lt;SUBSECTION Private&gt; for private "
"declarations which will not be output (it is a handy way to avoid warning "
"messages about unused declarations). If your library contains private types "
"which you don't want to appear in the object hierarchy and the list of "
"implemented or required interfaces, add them to a Private subsection. "
"Whether you would place GObject and GObjectClass like structs in public or "
"Standard section depends if they have public entries (variables, vmethods)."
msgstr ""
"Můžete také seskupovat položky v oddílu pomocí značky &lt;SUBSECTION&gt;. V "
"současnosti způsobí prázdný řádek mezi pododdíly v souhrnné části. Můžete "
"také použít &lt;SUBSECTION Standard&gt; pro standardní deklarace GObject "
"(například funkce jako je g_object_get_type, makra jako G_OBJECT(), "
"G_IS_OBJECT() atd.). V současnosti jsou tyto v dokumentaci vynechané. Můžete "
"také použít &lt;SUBSECTION Private&gt; pro privátní deklarace, které ve "
"výsledku nebudou (jedná se o ruční způsob, jak zabránit varovným hlášením o "
"nepoužitých deklaracích). Pokud vaše knihovna obsahuje privátní typy, u "
"kterých nechcete, aby se objevily v hierarchii objektů a v seznamu "
"implementovaných nebo vyžadovaných rozhraní, přidejte je do pododdílu "
"Private. Jestli umístit struktury jako GObject a GObjectClass do veřejné "
"nebo standardní části záleží na tom, jestli mají veřejné položky (proměnné, "
"virtuální metody)."

#. (itstool) path: sect1/para
#: C/index.docbook:2203
msgid ""
"You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
"#include files which are shown in the synopsis sections. It contains a comma-"
"separate list of #include files, without the angle brackets. If you set it "
"outside of any sections, it acts for all sections until the end of the file. "
"If you set it within a section, it only applies to that section."
msgstr ""
"Můžete také použít &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; k určení #include "
"souborů, které jsou zobrazené v souhrnné části. Obsahuje čárkami oddělený "
"seznam jednotlivých #include souborů, bez lomených závorek. Když je "
"nastavíte mimo kterýkoliv oddíl, budou fungovat pro všechny oddíly až do "
"konce souboru. Když je nastavíte v konkrétním oddílu, použijí se jen pro něj."

#. (itstool) path: chapter/title
#: C/index.docbook:2217
msgid "Controlling the result"
msgstr "Ovlivnění výsledku"

#. (itstool) path: chapter/para
#: C/index.docbook:2219
msgid ""
"A GTK-Doc run generates report files inside the documentation directory. The "
"generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
"filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
"<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
"files that can be viewed and postprocessed easily."
msgstr ""
"Spuštění GTK-Doc vygeneruje ve složkách pro dokumentaci soubory s výstupními "
"sestavami. Generované soubory jsou nazvané: <filename>&lt;balíček&gt;-"
"undocumented.txt</filename>, <filename>&lt;balíček&gt;-undeclared.txt</"
"filename> a <filename>&lt;balíček&gt;-unused.txt</filename>. Všechno to jsou "
"prosté textové soubory, které si lze jednoduše prohlížet a zpracovávat je."

#. (itstool) path: chapter/para
#: C/index.docbook:2228
msgid ""
"The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
"the documentation coverage summary. Below are two sections divided by blank "
"lines. The first section lists undocumented or incomplete symbols. The "
"second section does the same for section docs. Incomplete entries are those, "
"which have documentation, but where e.g. a new parameter has been added."
msgstr ""
"Soubor <filename>&lt;balíček&gt;-undocumented.txt</filename> začíná "
"souhrnnými údaji o dokumentaci. Následují dva oddíly oddělené prázdnými "
"řádky. První oddíl je seznam nezdokumentovaných nebo neúplných symbolů. "
"Druhý oddíl je to stejné, ale pro dokumentace oddílů. Neúplné položky jsou "
"takové, které mají dokumentaci, ale u kterých byl například přidán nový "
"parametr."

#. (itstool) path: chapter/para
#: C/index.docbook:2237
msgid ""
"The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
"given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
"in the sources. Check if they have been removed or if they are misspelled."
msgstr ""
"Soubor <filename>&lt;balíček&gt;-undeclared.txt</filename> uvádí symboly, "
"které jsou zadané v <filename>&lt;balíček&gt;-section.txt</filename>, ale "
"nebyly nalezené ve zdrojových kódech. Ověřte, jestli nebyly odstraněny, nebo "
"v nich není překlep."

#. (itstool) path: chapter/para
#: C/index.docbook:2244
msgid ""
"The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
"where the GTK-Doc scanner has found documentation, but does not know where "
"to put it. This means that the symbol has not yet been added to the "
"<filename>&lt;package&gt;-sections.txt</filename> file."
msgstr ""
"Soubor  <filename>&lt;balíček&gt;-unused.txt</filename> uvádí názvy symbolů, "
"které GTK-Doc při procházení dokumentace nalezl, ale neví, kam je zařadit. "
"To znamená, že tyto symboly nejsou zatím zařazené v souboru <filename>&lt;"
"balíček&gt;-section.txt</filename>."

#. (itstool) path: tip/para
#: C/index.docbook:2252
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 ""
"Povolte nebo přidejte řádek <option>TESTS=($GTKDOC_CHECK)</option> v "
"Makefile.am. Pokud máte nainstalované GTK-Doc ve verzi minimálně 1.9, bude "
"se díky tomu při spuštění <command>make check</command> provádět kontrola "
"správnosti údajů."

#. (itstool) path: chapter/para
#: C/index.docbook:2259
msgid ""
"One can also look at the files produced by the source code scanner: "
"<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
"package&gt;-decl.txt</filename>. The first one can be compared with the "
"section file if that is manually maintained. The second lists all "
"declarations from the headers. If a symbol is missing one could check if "
"this file contains it."
msgstr ""
"Můžete se také podívat do souborů vytvořených skenerem zdrojového kódu: "
"<filename>&lt;package&gt;-decl-list.txt</filename> a <filename>&lt;"
"package&gt;-decl.txt</filename>. První můžete porovnat se souborem s oddíly, "
"pokud je ručně spravován. Ve druhém jsou uvedené všechny deklarace z "
"hlavičkových souborů. Pokud v dokumentaci schází některý symbol, můžete "
"zkontrolovat, jestli se vyskytuje v tomto souboru."

#. (itstool) path: chapter/para
#: C/index.docbook:2268
msgid ""
"If the project is GObject based, one can also look into the files produced "
"by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
"<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
"package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
"prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
"filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
"to keep the intermediate scanner file for further analysis, by running it as "
"<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
msgstr ""
"Pokud je základem projektu GObject, můžete se také podívat do souborů "
"vytvořených skenerem objektů: <filename>&lt;package&gt;.args.txt</filename>, "
"<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
"package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
"prerequisites.txt</filename> a <filename>&lt;package&gt;.signals.txt</"
"filename>. Jestliže v kterémkoliv z nich jsou chybějící symboly, můžete "
"spuštěním <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command> požádat GTK-"
"Doc, aby přechodně zachovat soubor pro pozdější analýzu."

#. (itstool) path: chapter/title
#: C/index.docbook:2283
msgid "Modernizing the documentation"
msgstr "Modernizace dokumentu"

#. (itstool) path: chapter/para
#: C/index.docbook:2285
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 ""
"GTK-Doc existuje již nějakou dobu. V této části je uveden seznam nových "
"funkcí spolu s číslem verze, od které je tato funkčnost k dispozici."

#. (itstool) path: sect1/title
#: C/index.docbook:2291
msgid "GTK-Doc 1.9"
msgstr "GTK-Doc 1.9"

#. (itstool) path: sect1/para
#: C/index.docbook:2293
msgid ""
"When using xml instead of sgml, one can actually name the master document "
"<filename>&lt;package&gt;-docs.xml</filename>."
msgstr ""
"Když používáte XML namísto SGML, můžete ve skutečnosti pojmenovat hlavní "
"dokument <filename>&lt;package&gt;-docs.xml</filename>."

#. (itstool) path: sect1/para
#: C/index.docbook:2298
msgid ""
"This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
"<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
"package&gt;-sections.txt</filename> is autogenerated and can be removed from "
"the vcs. This only works nicely for projects that have a very regular "
"structure (e.g. each .{c,h} pair will create new section). If one organize a "
"project close to that updating a manually maintained section file can be as "
"simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
"sections.txt</code>."
msgstr ""
"Tato verze podporuje <option>SCAN_OPTIONS=--rebuild-sections</option> v "
"<filename>Makefile.am</filename>. Když je tato volba zapnutá, je "
"<filename>&lt;package&gt;-sections.txt</filename> generován automaticky a "
"můžete jej odstranit ze správy verzí. To funguje hezky je u projektů, které "
"mají pravidelnou strukturu (například jednotlivé páry souboru .c a .h "
"vytvoří nový oddíl). Pokud máte projekt takto pečlivě organizovaný, vystačí "
"si aktualizace ručně spravovaného souboru s oddíly s prostým spuštěním "
"<code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>."

#. (itstool) path: sect1/para
#: C/index.docbook:2309
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>. If you don't have a "
"<filename class=\"directory\">tmpl</filename> checked into your source "
"control system and haven't yet switched, just add the flag to "
"<filename>configure.ac</filename> and you are done."
msgstr ""
"Již verze 1.18 zavedla syntax pro dokumentování oddílů ve zdrojovém kódu "
"namísto zvláštních souborů ve složce <filename class=\"directory\">tmpl</"
"filename>. Tato verze přidává pomocí <option>--flavour no-tmpl</option> in "
"<filename>configure.ac</filename> volbu pro přepnutí celého modulu "
"dokumentace, aby nepoužíval speciální složku tmp během sestavení. Jestliže "
"nepotřebujete udržovat <filename class=\"directory\">tmpl</filename> v "
"systému pro správu verzí ještě jste zatím přepnutí neprovedli, stačí přidat "
"tuto volbu do <filename>configure.ac</filename> a je to."

#. (itstool) path: sect1/title
#: C/index.docbook:2321
msgid "GTK-Doc 1.10"
msgstr "GTK-Doc 1.10"

#. (itstool) path: sect1/para
#: C/index.docbook:2323
msgid ""
"This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
"<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
"package&gt;.types</filename> is autogenerated and can be removed from the "
"vcs. When using this feature it is important to also setup the "
"<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
"code that is build conditionally."
msgstr ""
"Tato verze podporuje <option>SCAN_OPTIONS=--rebuild-types</option> v "
"<filename>Makefile.am</filename>. Když je tato volba zapnutá, je "
"<filename>&lt;package&gt;.types</filename> generován automaticky a můžete "
"jej odstranit ze správy verzí. Jestliže tuto funkci využíváte, je důležité "
"nastavit také <varname>IGNORE_HFILES</varname> v <filename>Makefile.am</"
"filename> pro kód, který je sestavován podmíněně."

#. (itstool) path: sect1/title
#: C/index.docbook:2334
msgid "GTK-Doc 1.16"
msgstr "GTK-Doc 1.16"

#. (itstool) path: example/title
#: C/index.docbook:2340
msgid "Enable gtkdoc-check"
msgstr "Povolení gtkdoc-check"

#. (itstool) path: example/programlisting
#: C/index.docbook:2341
#, 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:2336
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 ""
"Součástí této verze je nový nástroj s názvem gtkdoc-check. Jeho spuštěním se "
"provede kontrola správnosti vašeho dokumentu. Povolit jej můžete přidáním "
"těchto řádků na konec souboru <filename>Makefile.am</filename>. <_:example-1/"
">"

#. (itstool) path: sect1/title
#: C/index.docbook:2354
msgid "GTK-Doc 1.20"
msgstr "GTK-Doc 1.20"

#. (itstool) path: sect1/para
#: C/index.docbook:2356
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 ""
"Verze 1.18 přinesla počáteční podporu pro Markdown. Jeho použití v "
"dokumentačních komentářích je méně rušivé, než zápis XML z DocBook. Tato "
"verze jeho podporu značně vylepšuje a přidává mnohem více stylů. Více "
"podrobností je uvedeno v oddílu, který vysvětluje <link linkend="
"\"documenting_syntax\">syntax komentářů</link>."

#. (itstool) path: sect1/title
#: C/index.docbook:2366
msgid "GTK-Doc 1.25"
msgstr "GTK-Doc 1.25"

#. (itstool) path: example/title
#: C/index.docbook:2377
msgid "Use pre-generated entities"
msgstr "Používání předgenerovaných entit"

#. (itstool) path: example/programlisting
#: C/index.docbook:2378
#, no-wrap
msgid ""
"\n"
"&lt;?xml version=\"1.0\"?&gt;\n"
"&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
"               \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
"[\n"
"  &lt;!ENTITY % local.common.attrib \"xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
"  &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
"  %gtkdocentities;\n"
"]&gt;\n"
"&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
"  &lt;bookinfo&gt;\n"
"    &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
"    &lt;releaseinfo&gt;\n"
"      for &amp;package_string;.\n"
"      The latest version of this documentation can be found on-line at\n"
"      &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
"    &lt;/releaseinfo&gt;\n"
"  &lt;/bookinfo&gt;\n"
msgstr ""
"\n"
"&lt;?xml version=\"1.0\"?&gt;\n"
"&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
"               \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
"[\n"
"  &lt;!ENTITY % local.common.attrib \"xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
"  &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
"  %gtkdocentities;\n"
"]&gt;\n"
"&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
"  &lt;bookinfo&gt;\n"
"    &lt;title&gt;&amp;Referenční příručka k package_name;&lt;/title&gt;\n"
"    &lt;releaseinfo&gt;\n"
"      for &amp;package_string;.\n"
"      Nejnovější verzi této dokumentace můžete najít on-line na\n"
"      &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
"    &lt;/releaseinfo&gt;\n"
"  &lt;/bookinfo&gt;\n"

#. (itstool) path: sect1/para
#: C/index.docbook:2368
msgid ""
"The makefiles shipped with this version generate an entity file at "
"<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
"package_name and package_version. You can use this e.g. in the main xml file "
"to avoid hardcoding the version number. Below is an example that shows how "
"the entity file is included in the master template and how the entities are "
"used. The entities can also be used in all generated files, GTK-Doc will use "
"the same xml header in generated xml files. <_:example-1/>"
msgstr ""
"Soubory Makefile dodávané s touto verzí generují do <filename>xml/"
"gtkdocentities.ent</filename> soubor s entitami, který obsahuje entity "
"například pro package_name a package_version. Můžete je použít třeba v "
"hlavním souboru XML, abyste nemuseli mít číslo verze zapsané natvrdo. Níže "
"je uveden příklad, jak soubor s entitami vložit do hlavní šablony a jak "
"entity použít. Použít je lze také ve všech generovaných souborech, GTK-Doc "
"bude používat tu samou hlavičku XML v generovaných souborech XML. <_:"
"example-1/>"

#. (itstool) path: chapter/title
#: C/index.docbook:2403
msgid "Documenting other interfaces"
msgstr "Dokumentování ostatních rozhraní"

#. (itstool) path: chapter/para
#: C/index.docbook:2405
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 ""
"Doposud jsme pomocí GTK-Doc dokumentovali API kódu. Následující oddíl "
"obsahuje doporučení, jak se dají nástroje použít také k dokumentování "
"dalších rozhraní."

#. (itstool) path: sect1/title
#: C/index.docbook:2412
msgid "Command line options and man pages"
msgstr "Přepínače příkazového řádku a manuálové stránky"

#. (itstool) path: sect1/para
#: C/index.docbook:2414
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 ""
"Protože je stejně možné generovat manuálové stránky pro referenční položky "
"DocBook, zní jako dobrý nápad použít to pro tento účel. Tímto způsobem se "
"rozhraní stane součástí referenční příručky a získáte tak bez námahy "
"manuálovou stránku."

#. (itstool) path: sect2/title
#: C/index.docbook:2421
msgid "Document the tool"
msgstr "Dokumentování nástrojů"

#. (itstool) path: sect2/para
#: C/index.docbook:2423
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 ""
"Vytvořte jeden soubor s referenční příručkou pro každý z nástrojů. V <link "
"linkend=\"settingup_docfiles\">našem příkladu</link> by se měl nazývat "
"<filename>meep/docs/reference/meeper/meep.xml</filename>. Na značky XML, "
"který by se měly použít, se podívejte do nějakého ukázkového vygenerovaného "
"souboru v podsložce XML, například v glib."

#. (itstool) path: sect2/title
#: C/index.docbook:2433
msgid "Adding the extra configure check"
msgstr "Přidání doplňkových kontrol do configure"

#. (itstool) path: example/title
#: C/index.docbook:2436 C/index.docbook:2454
msgid "Extra configure checks"
msgstr "Dodatečné kontroly nastavení"

#. (itstool) path: example/programlisting
#: C/index.docbook:2437
#, 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 ""
"\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"

#. (itstool) path: sect2/title
#: C/index.docbook:2451
msgid "Adding the extra makefile rules"
msgstr "Přidání doplňkových pravidel do Makefile"

#. (itstool) path: example/programlisting
#: C/index.docbook:2455
#, 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 $&lt;\n"
"\n"
"endif\n"
"endif\n"
"\n"
"BUILT_EXTRA_DIST = $(man_MANS)\n"
"EXTRA_DIST += meep.xml\n"
msgstr ""
"\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 $&lt;\n"
"\n"
"endif\n"
"endif\n"
"\n"
"BUILT_EXTRA_DIST = $(man_MANS)\n"
"EXTRA_DIST += meep.xml\n"

#. (itstool) path: sect1/title
#: C/index.docbook:2477
msgid "DBus interfaces"
msgstr "Rozhraní D-Bus"

#. (itstool) path: sect1/para
#: C/index.docbook:2479
msgid ""
"(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
"cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
msgstr ""
"(OPRAVIT: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
"cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"

#. (itstool) path: chapter/title
#: C/index.docbook:2488
msgid "Frequently asked questions"
msgstr "Často kladené dotazy"

#. (itstool) path: segmentedlist/segtitle
#: C/index.docbook:2492
msgid "Question"
msgstr "Dotaz"

#. (itstool) path: segmentedlist/segtitle
#: C/index.docbook:2493
msgid "Answer"
msgstr "Odpověď"

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2495
msgid "No class hierarchy."
msgstr "Schází hierarchie třídy."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2496
msgid ""
"The objects <function>xxx_get_type()</function> function has not been "
"entered into the <filename>&lt;package&gt;.types</filename> file."
msgstr ""
"Do souboru <filename>&lt;balíček&gt;.types</filename> nebyla vložena funkce "
"objektu <function>xxx_get_type()</function>."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2502
msgid "Still no class hierarchy."
msgstr "Stále schází hierarchie třídy."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2503
msgid ""
"Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
"file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
"October/msg00006.html\">explanation</ulink>)."
msgstr ""
"Chybějící nebo nesprávné pojmenování souboru <filename>&lt;balíček&gt;-"
"sections.txt</filename> (viz <ulink url=\"http://mail.gnome.org/archives/gtk-"
"doc-list/2003-October/msg00006.html\">vysvětlení</ulink>)."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2509
msgid "Damn, I have still no class hierarchy."
msgstr "Do háje, pořád nemám hierarchii třídy."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2510
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 ""
"Je název objektu (název struktury instance, například <type>GtkWidget</"
"type>) součástí normálního oddílu? (Nedávejte je do pododdílu Standard nebo "
"Private)."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2517
msgid "No symbol index."
msgstr "Chybí rejstřík symbolů."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2518
msgid ""
"Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
"index that xi:includes the generated index?"
msgstr ""
"Obsahuje <filename>&lt;package&gt;-docs.{xml,sgml}</filename> rejstřík, "
"který vloží pomocí xi:include vygenerovaný rejstřík?"

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2524
msgid "Symbols are not linked to their doc-section."
msgstr "Symbol nemá odkaz do svého oddílu dokumentace."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2525
msgid ""
"Is the doc-comment using the correct markup (added #,% or ())? Check if the "
"gtkdoc-fixxref warns about unresolvable xrefs."
msgstr ""
"Používá dokumentační komentář správnou značku (přidané znaky #,% nebo ())? "
"Podívejte se na varování gtkdoc-fixxref o nevyřešených křížových odkazech."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2531
msgid "A new class does not appear in the docs."
msgstr "Nová třída se neobjevila v dokumentaci."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2532
msgid ""
"Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
"filename>."
msgstr ""
"Je nový balíček vložený pomocí xi:include z <filename>&lt;package&gt;-docs."
"{xml,sgml}</filename>."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2538
msgid "A new symbol does not appear in the docs."
msgstr "Nový symbol se neobjevil v dokumentaci."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2539
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>&lt;"
"package&gt;-sections.txt</filename> in a public subsection."
msgstr ""
"Je dokumentační komentář správně naformátovaný? Zkontrolujte překlepy na "
"začátku komentáře. Podívejte se po varováních gtkdoc-fixxref o nevyřešených "
"křížových odkazech. Zkontrolujte, jestli je symbol správně uvedený v "
"<filename>&lt;package&gt;-sections.txt</filename> ve veřejném pododdíle."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2547
msgid "A type is missing from the class hierarchy."
msgstr "V hierarchii třídy schází typ."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2548
msgid ""
"If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
"not in <filename>xml/tree_index.sgml</filename> then double check that the "
"type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
"filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
"or incidentally marked private it will not be shown."
msgstr ""
"Jestliže je typ uvedený v <filename>&lt;package&gt;.hierarchy</filename>, "
"ale není v <filename>xml/tree_index.sgml</filename>, tak raději dvakrát "
"zkontrolujte, jestli je typ správně uvedený v <filename>&lt;package&gt;-"
"sections.txt</filename>. Jestliže instance typu (například <type>GtkWidget</"
"type>) není uvedená, nebo je nedopatřením označení jako privátní, nebude "
"zobrazena."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2557
msgid "I get foldoc links for all gobject annotations."
msgstr ""
"Vytvořily se mi odkazy na složku s dokumentací pro všechny anotace k GObject"

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2558
msgid ""
"Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
"from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
msgstr ""
"Zkontrolujte, že <filename>xml/annotation-glossary.xml</filename> je vložené "
"pomocí xi:include z <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2566
msgid "Parameter described in source code comment block but does not exist"
msgstr ""
"Parametr je v komentářovém bloku zdrojového kódu popsaný, ale neexistuje."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2567
msgid ""
"Check if the prototype in the header has different parameter names as in the "
"source."
msgstr ""
"Zkontrolujte, za nemá prototyp v hlavičkovém souboru jiné názvy parametrů, "
"než ve zdrojovém kódu."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2572
msgid "multiple \"IDs\" for constraint linkend: XYZ"
msgstr "Více „ID“ pro tentýž cíl odkazu: XYZ"

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2573
msgid ""
"Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
"filename> file."
msgstr ""
"Symbol XYZ se v souboru <filename>&lt;package&gt;-sections.txt</filename> "
"objevuje dvakrát."

#. (itstool) path: seglistitem/seg
#: C/index.docbook:2576
msgid ""
"Element typename in namespace '' encountered in para, but no template "
"matches."
msgstr ""
"Element typename ve jmenném prostoru '' je uvedený v rodiči, ale neodpovídá "
"mu žádná šablona."

#. (itstool) path: chapter/title
#: C/index.docbook:2583
msgid "Tools related to gtk-doc"
msgstr "Nástroje související s GTK-Doc"

#. (itstool) path: chapter/para
#: C/index.docbook:2585
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 ""
"GtkDocPlugin – zásuvný modul pro integraci <ulink url=\"http://trac-hacks."
"org/wiki/GtkDocPlugin\">GTK-Doc do systému Track</ulink>, který přidává "
"dokumentaci k API na sledovací web a integruje ji do vyhledávání."

#. (itstool) path: chapter/para
#: C/index.docbook:2590
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 ""
"Gtkdoc-depscan – nástroj (součást GTK-Doc), který kontroluje použité API "
"vůči štítku since v API, aby určil minimální požadovanou verzi."

#. (itstool) path: appendixinfo/releaseinfo
#: C/index.docbook:12 C/fdl-appendix.xml:12
msgid "Version 1.1, March 2000"
msgstr "Verze 1.1, březen 2000"

#. (itstool) path: appendixinfo/copyright
#: C/index.docbook:15
msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"

#. (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 ""
"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>"

#. (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 ""
"<_:address-1/> Kdokoliv je oprávněn kopírovat a šířit doslovné kopie tohoto "
"dokumentu s licencí, ale nesmí v něm provádět žádné změny."

#. (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 "GNU Free Documentation License"

#. (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 ""

#. (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 ""

#. (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 distribute it "
"individually under this License, provided you insert a copy of this License "
"into the extracted document, and follow this License in all other respects "
"regarding verbatim copying of that document."
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 ""

#. (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 "2"

#. (itstool) path: para/link
#: C/fdl-appendix.xml:237
msgid "3"
msgstr "3"

#. (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 "Free Software Foundation"

#. (itstool) path: para/ulink
#: C/fdl-appendix.xml:603
msgid "http://www.gnu.org/copyleft/"
msgstr "http://www.gnu.org/copyleft/"

#. (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 "GNU General Public License"

#. (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 ""