Debian Codegraph @

help/manual/sr/sr.po

raw
1 # Serbian translation for gtk-doc.
2 # Copyright (C) 2026 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # Марко Костић <[email protected]>, 2026.
5 #
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: gtk-doc master\n"
9 "POT-Creation-Date: 2026-03-17 20:25+0000\n"
10 "PO-Revision-Date: 2026-03-28 08:47+0100\n"
11 "Last-Translator: Марко М. Костић <[email protected]>\n"
12 "Language-Team: Serbian <Serbian>\n"
13 "Language: sr\n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17 "Plural-Forms: nplurals=4; plural=n==1? 3 : n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
18 "X-Generator: Poedit 3.9\n"
19
20 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
21 msgctxt "_"
22 msgid "translator-credits"
23 msgstr ""
24 "Марко М. Костић <[email protected]>\n"
25 "Превод на српски језик https://гном.срб"
26
27 #. (itstool) path: bookinfo/title
28 #: C/index.docbook:12
29 msgid "GTK-Doc Manual"
30 msgstr "Упутство за ГТК-док"
31
32 #. (itstool) path: bookinfo/edition
33 #: C/index.docbook:13
34 msgid "1.24.1"
35 msgstr "1.24.1"
36
37 #. (itstool) path: abstract/para
38 #: C/index.docbook:14
39 msgid "User manual for developers with instructions of GTK-Doc usage."
40 msgstr "Корисничко упутство за програмере са упутствима за употребу ГТК-дока."
41
42 #. (itstool) path: authorgroup/author
43 #: C/index.docbook:16
44 msgid "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
45 msgstr "<firstname>Крис</firstname> <surname>Лајтл</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
46
47 #. (itstool) path: authorgroup/author
48 #: C/index.docbook:25
49 msgid "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
50 msgstr "<firstname>Ден</firstname> <surname>Мует</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
51
52 #. (itstool) path: authorgroup/author
53 #: C/index.docbook:34
54 msgid "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
55 msgstr "<firstname>Штефан</firstname> <surname>Зауер (Кост)</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
56
57 #. (itstool) path: publisher/publishername
58 #: C/index.docbook:45
59 msgid "GTK-Doc project"
60 msgstr "Пројекат ГТК-док"
61
62 #. (itstool) path: bookinfo/publisher
63 #: C/index.docbook:44
64 msgid "<_:publishername-1/> <address><email>[email protected]</email></address>"
65 msgstr "<_:publishername-1/> <address><email>[email protected]</email></address>"
66
67 #. (itstool) path: bookinfo/copyright
68 #: C/index.docbook:48
69 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
70 msgstr "<year>2000, 2005</year> <holder>Ден Мует и Крис Лајтл</holder>"
71
72 #. (itstool) path: bookinfo/copyright
73 #: C/index.docbook:52
74 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
75 msgstr "<year>2007-2019</year> <holder>Штефан Зауер (Кост)</holder>"
76
77 #. (itstool) path: legalnotice/para
78 #: C/index.docbook:65
79 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>."
80 msgstr "Дозвољено је умножавање, дељење и/или мењање овог документа под условима <citetitle>ГНУ-ове лиценце за слободну документацију</citetitle>, верзије 1.1 или било које новије верзије коју објави Задужбина слободног софтвера без непроменљивих одељака, без текста на насловној страни и без текста на задњој страни. Примерак лиценце је <link linkend=\"fdl\">укључен</link>."
81
82 #. (itstool) path: legalnotice/para
83 #: C/index.docbook:73
84 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."
85 msgstr "Многи називи које компаније користе да би разликовале своје производе и услуге су заштићени као робне марке. На местима где се ти називи појављују у било којој Гномовој документацији, а чланови Гномовог пројекта документације су обавештени о тим робним маркама, називи су штампани великим словима или са почетним великим словом."
86
87 #. (itstool) path: revhistory/revision
88 #: C/index.docbook:83
89 msgid "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</authorinitials> <revremark>gtk4 version</revremark>"
90 msgstr "<revnumber>1.33.0</revnumber> <date>1. окт 2020.</date> <authorinitials>mc</authorinitials> <revremark>издање за гтк4</revremark>"
91
92 #. (itstool) path: revhistory/revision
93 #: C/index.docbook:89
94 msgid "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>dev version</revremark>"
95 msgstr "<revnumber>1.32.1</revnumber> <date>15. авг 2019.</date> <authorinitials>ss</authorinitials> <revremark>развојно издање</revremark>"
96
97 #. (itstool) path: revhistory/revision
98 #: C/index.docbook:95
99 msgid "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>hotfix release</revremark>"
100 msgstr "<revnumber>1.32</revnumber> <date>15. авг 2019.</date> <authorinitials>ss</authorinitials> <revremark>издање са хитном исправком</revremark>"
101
102 #. (itstool) path: revhistory/revision
103 #: C/index.docbook:101
104 msgid "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>refactorings and more test coverage</revremark>"
105 msgstr "<revnumber>1.31</revnumber> <date>5. авг 2019.</date> <authorinitials>ss</authorinitials> <revremark>прераде кода и већа покривеност тестовима</revremark>"
106
107 #. (itstool) path: revhistory/revision
108 #: C/index.docbook:107
109 msgid "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</authorinitials> <revremark>more test coverage</revremark>"
110 msgstr "<revnumber>1.30</revnumber> <date>8. мај 2019.</date> <authorinitials>ss</authorinitials> <revremark>већа покривеност тестовима</revremark>"
111
112 #. (itstool) path: revhistory/revision
113 #: C/index.docbook:113
114 msgid "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
115 msgstr "<revnumber>1.29</revnumber> <date>28. авг 2018.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака</revremark>"
116
117 #. (itstool) path: revhistory/revision
118 #: C/index.docbook:119
119 msgid "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
120 msgstr "<revnumber>1.28</revnumber> <date>24. мар 2018.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака</revremark>"
121
122 #. (itstool) path: revhistory/revision
123 #: C/index.docbook:125
124 msgid "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</authorinitials> <revremark>fine tuning of the python port</revremark>"
125 msgstr "<revnumber>1.27</revnumber> <date>7. дец 2017.</date> <authorinitials>ss</authorinitials> <revremark>фино подешавање преноса на пајтон</revremark>"
126
127 #. (itstool) path: revhistory/revision
128 #: C/index.docbook:131
129 msgid "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>port all tools from perl/bash to python</revremark>"
130 msgstr "<revnumber>1.26</revnumber> <date>11. авг 2017.</date> <authorinitials>ss</authorinitials> <revremark>пренос свих алата са перла/баша на пајтон</revremark>"
131
132 #. (itstool) path: revhistory/revision
133 #: C/index.docbook:137
134 msgid "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, test cleanups</revremark>"
135 msgstr "<revnumber>1.25</revnumber> <date>21. март 2016.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака, чишћење тестова</revremark>"
136
137 #. (itstool) path: revhistory/revision
138 #: C/index.docbook:143
139 msgid "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>"
140 msgstr "<revnumber>1.24</revnumber> <date>29. мај 2015.</date> <authorinitials>ss</authorinitials> <revremark>исправка грешке</revremark>"
141
142 #. (itstool) path: revhistory/revision
143 #: C/index.docbook:149
144 msgid "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>"
145 msgstr "<revnumber>1.23</revnumber> <date>17. мај 2015.</date> <authorinitials>ss</authorinitials> <revremark>исправка грешке</revremark>"
146
147 #. (itstool) path: revhistory/revision
148 #: C/index.docbook:155
149 msgid "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>"
150 msgstr "<revnumber>1.22</revnumber> <date>07. мај 2015.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака, одбацивање застарелих могућности</revremark>"
151
152 #. (itstool) path: revhistory/revision
153 #: C/index.docbook:161
154 msgid "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>"
155 msgstr "<revnumber>1.21</revnumber> <date>17. јул 2014.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака, одбацивање застарелих могућности</revremark>"
156
157 #. (itstool) path: revhistory/revision
158 #: C/index.docbook:167
159 msgid "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, markdown support, style improvements</revremark>"
160 msgstr "<revnumber>1.20</revnumber> <date>16. фебруар 2014.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака, подршка за маркдаун, побољшања стила</revremark>"
161
162 #. (itstool) path: revhistory/revision
163 #: C/index.docbook:173
164 msgid "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
165 msgstr "<revnumber>1.19</revnumber> <date>05. јун 2013.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака</revremark>"
166
167 #. (itstool) path: revhistory/revision
168 #: C/index.docbook:179
169 msgid "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
170 msgstr "<revnumber>1.18</revnumber> <date>14. септембар 2011.</date> <authorinitials>ss</authorinitials> <revremark>исправке грешака, убрзања, подршка за маркдаун</revremark>"
171
172 #. (itstool) path: revhistory/revision
173 #: C/index.docbook:185
174 msgid "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</authorinitials> <revremark>urgent bug fix update</revremark>"
175 msgstr "<revnumber>1.17</revnumber> <date>26. фебруар 2011.</date> <authorinitials>sk</authorinitials> <revremark>хитно ажурирање исправке грешке</revremark>"
176
177 #. (itstool) path: revhistory/revision
178 #: C/index.docbook:191
179 msgid "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</authorinitials> <revremark>bugfixes, layout improvements</revremark>"
180 msgstr "<revnumber>1.16</revnumber> <date>14. јануар 2011.</date> <authorinitials>sk</authorinitials> <revremark>исправке грешака, побољшања распореда</revremark>"
181
182 #. (itstool) path: revhistory/revision
183 #: C/index.docbook:197
184 msgid "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</authorinitials> <revremark>bug and regression fixes</revremark>"
185 msgstr "<revnumber>1.15</revnumber> <date>21. мај 2010.</date> <authorinitials>sk</authorinitials> <revremark>исправке грешака и регресија</revremark>"
186
187 #. (itstool) path: revhistory/revision
188 #: C/index.docbook:203
189 msgid "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</authorinitials> <revremark>bugfixes and performance improvements</revremark>"
190 msgstr "<revnumber>1.14</revnumber> <date>28. март 2010.</date> <authorinitials>sk</authorinitials> <revremark>исправке грешака и побољшања учинка</revremark>"
191
192 #. (itstool) path: revhistory/revision
193 #: C/index.docbook:209
194 msgid "<revnumber>1.13</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>broken tarball update</revremark>"
195 msgstr "<revnumber>1.13</revnumber> <date>18. децембар 2009.</date> <authorinitials>sk</authorinitials> <revremark>ажурирање оштећене тар архиве</revremark>"
196
197 #. (itstool) path: revhistory/revision
198 #: C/index.docbook:215
199 msgid "<revnumber>1.12</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>new tool features and bugfixes</revremark>"
200 msgstr "<revnumber>1.12</revnumber> <date>18. децембар 2009.</date> <authorinitials>sk</authorinitials> <revremark>нове могућности алата и исправке грешака</revremark>"
201
202 #. (itstool) path: revhistory/revision
203 #: C/index.docbook:221
204 msgid "<revnumber>1.11</revnumber> <date>16 November 2008</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</revremark>"
205 msgstr "<revnumber>1.11</revnumber> <date>16. новембар 2008.</date> <authorinitials>mal</authorinitials> <revremark>прелазак на Гномове алатке документације</revremark>"
206
207 #. (itstool) path: chapter/title
208 #: C/index.docbook:234
209 msgid "Introduction"
210 msgstr "Увод"
211
212 #. (itstool) path: chapter/para
213 #: C/index.docbook:236
214 msgid "This chapter introduces GTK-Doc and gives an overview of what it is and how it is used."
215 msgstr "Ово поглавље уводи ГТК-док и даје преглед шта је он и како се користи."
216
217 #. (itstool) path: sect1/title
218 #: C/index.docbook:242
219 msgid "What is GTK-Doc?"
220 msgstr "Шта је ГТК-док?"
221
222 #. (itstool) path: sect1/para
223 #: C/index.docbook:244
224 msgid "GTK-Doc is used to document C code. It is typically used to document the public API of libraries, such as GLib-based libraries, but it can also be used to document application code."
225 msgstr "ГТК-док се користи за документовање Ц кода. Обично се користи за документовање јавног АПИ-ја библиотека, као што су библиотеке засноване на ГЛиб-у, али се такође може користити за документовање кода програма."
226
227 #. (itstool) path: sect1/title
228 #: C/index.docbook:252
229 msgid "How Does GTK-Doc Work?"
230 msgstr "Како ГТК-док ради?"
231
232 #. (itstool) path: sect1/para
233 #: C/index.docbook:254
234 msgid "GTK-Doc works by reading specially-formatted comment blocks placed inside the source files to document symbols such as functions, macros, structs, enums, etc. (though note that for most kind of symbols GTK-Doc will only document the symbols that are declared in header files; for example it won't produce output for static functions)."
235 msgstr "ГТК-док ради тако што чита посебно обликоване блокове коментара постављене унутар изворних датотека ради документовања симбола као што су функције, макрои, структуре, набрајања итд. (иако имајте у виду да ће за већину врста симбола ГТК-док документовати само симболе који су објављени у датотекама заглавља; на пример, неће произвести излаз за статичке функције)."
236
237 #. (itstool) path: sect1/para
238 #: C/index.docbook:262
239 msgid "GTK-Doc also reads template files where documentation can be added there as well."
240 msgstr "ГТК-док такође чита датотеке шаблона где се документација такође може додати."
241
242 #. (itstool) path: sect1/para
243 #: C/index.docbook:267
244 msgid "GTK-Doc consists of a number of programs, each performing a different step in the process."
245 msgstr "ГТК-Док се састоји од низа програма, од којих сваки обавља различит корак у процесу."
246
247 #. (itstool) path: sect1/para
248 #: C/index.docbook:272
249 msgid "The main steps are:"
250 msgstr "Главни кораци су:"
251
252 #. (itstool) path: listitem/para
253 #: C/index.docbook:279
254 msgid "<guilabel>Writing the documentation.</guilabel> The author fills in the source files with the documentation for each function, macro, structs or unions, etc."
255 msgstr "<guilabel>Писање документације.</guilabel> Аутор попуњава изворне датотеке документацијом за сваку функцију, макро, структуру или унију, итд."
256
257 #. (itstool) path: listitem/para
258 #: C/index.docbook:288
259 msgid ""
260 "<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 "
261 "<filename>&lt;module&gt;-overrides.txt</filename>."
262 msgstr "<guilabel>Прикупљање података о коду.</guilabel> <application>gtkdoc-scan</application> прегледа датотеке заглавља кода тражећи декларације функција, макроа, набрајања, структура и унија. Прави датотеку <filename>&lt;module&gt;-decl-list.txt</filename> која садржи списак декларација, смештајући их у одељке према томе у којој се датотеци заглавља налазе. При првом покретању ова датотека се копира у <filename>&lt;module&gt;-sections.txt</filename>. Аутор може преуредити одељке и редослед декларација унутар њих како би добио коначни жељени поредак. Друга датотека коју генерише је <filename>&lt;module&gt;-decl.txt</filename>. Ова датотека садржи потпуне декларације које је пронашао прегледач. Ако из неког разлога желите да се неки симболи појаве у документацији, а прегледач не може да пронађе потпуну декларацију или би декларација требало да изгледа другачије, можете поставити ставке сличне онима у <filename>&lt;module&gt;-decl.txt</filename> у <filename>&lt;module&gt;-overrides.txt</filename>."
263
264 #. (itstool) path: listitem/para
265 #: C/index.docbook:308
266 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."
267 msgstr "<application>gtkdoc-scangobj</application> се такође може користити за динамички упит библиотеци о свим подкласама Г-објекта (GObject) које она извози. Сачуваће податке о положају сваког објекта у хијерархији класа и о свим својствима и сигналима Г-објекта које пружа."
268
269 #. (itstool) path: listitem/para
270 #: C/index.docbook:314
271 msgid "<application>gtkdoc-scanobj</application> should not be used anymore. It was needed in the past when GObject was still GtkObject inside GTK."
272 msgstr "<application>gtkdoc-scanobj</application> више не би требало користити. Био је потребан у прошлости када је GObject још увек био GtkObject унутар ГТК-а."
273
274 #. (itstool) path: listitem/para
275 #: C/index.docbook:322
276 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 for symbols, 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."
277 msgstr "<guilabel>Стварање XML-а и HTML-а/PDF-а.</guilabel> <application>gtkdoc-mkdb</application> претвара датотеке шаблона у XML датотеке у <filename class=\"directory\">xml/</filename> поддиректоријуму. Ако изворни код садржи документацију за симболе, користећи посебне блокове коментара, она се овде стапа. Ако се не користе tmpl датотеке, он само чита документацију из извора и података интроспекције."
278
279 #. (itstool) path: listitem/para
280 #: C/index.docbook:332
281 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>."
282 msgstr "<application>gtkdoc-mkhtml</application> претвара XML датотеке у HTML датотеке у <filename class=\"directory\">html/</filename> поддиректоријуму. Исто тако <application>gtkdoc-mkpdf</application> претвара XML датотеке у PDF документ под називом <filename>&lt;package&gt;.pdf</filename>."
283
284 #. (itstool) path: listitem/para
285 #: C/index.docbook:339
286 msgid "Files in <filename class=\"directory\">xml/</filename> and <filename class=\"directory\">html/</filename> directories are always overwritten. One should never edit them directly."
287 msgstr "Датотеке у <filename class=\"directory\">xml/</filename> и <filename class=\"directory\">html/</filename> директоријумима се увек преписују. Никада их не треба директно уређивати."
288
289 #. (itstool) path: listitem/para
290 #: C/index.docbook:347
291 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."
292 msgstr "<guilabel>Исправљање унакрсних референци између докумената.</guilabel> Након инсталирања HTML датотека, може се покренути <application>gtkdoc-fixxref</application> ради исправљања унакрсних референци између засебних докумената. На пример, ГТК документација садржи многе унакрсне референце на врсте документоване у ГЛиб (GLib) приручнику."
293
294 #. (itstool) path: listitem/para
295 #: C/index.docbook:356
296 msgid "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)."
297 msgstr "Приликом прављења изворне архиве (tarball) за дистрибуцију, <application>gtkdoc-rebase</application> претвара све спољне везе у веб-везе. Приликом инсталирања дистрибуиране (унапред генерисане) документације, исти програм ће покушати да врати везе на локалне везе (тамо где је та документација инсталирана)."
298
299 #. (itstool) path: sect1/title
300 #: C/index.docbook:369
301 msgid "Getting GTK-Doc"
302 msgstr "Набављање ГТК-Дока"
303
304 #. (itstool) path: sect2/title
305 #: C/index.docbook:372
306 msgid "Requirements"
307 msgstr "Захтеви"
308
309 #. (itstool) path: sect2/para
310 #: C/index.docbook:373
311 msgid "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
312 msgstr "<guilabel>пајтон 2/3</guilabel> — главне скрипте су написане у пајтону."
313
314 #. (itstool) path: sect2/para
315 #: C/index.docbook:376
316 msgid "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
317 msgstr "<guilabel>xsltproc</guilabel> — XSLT процесор из libxslt-а <ulink url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
318
319 #. (itstool) path: sect2/para
320 #: C/index.docbook:380
321 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>"
322 msgstr "<guilabel>docbook-xsl</guilabel> — DocBook XSL стилски листови <ulink url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
323
324 #. (itstool) path: sect2/para
325 #: C/index.docbook:384
326 msgid "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> or <guilabel>vim</guilabel> - optional - used for syntax highlighting of examples"
327 msgstr "Један од <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> или <guilabel>vim</guilabel> — опционо — користи се за истицање синтаксе у примерима"
328
329 #. (itstool) path: sect1/title
330 #: C/index.docbook:392
331 msgid "About GTK-Doc"
332 msgstr "О ГТК-Доку"
333
334 #. (itstool) path: sect1/para
335 #: C/index.docbook:394
336 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."
337 msgstr "Историјски гледано, ГТК-Док је коришћен за генерисање датотека шаблона из изворног кода. Ове датотеке шаблона су програмери могли користити за унос АПИ документације. Овај приступ је био прилично незгодан јер је захтевао чување генерисаних датотека под контролом верзија. Од верзије ГТК-Док 1.9 постало је могуће поставити све АПИ податке у изворне коментаре, што је подршку за шаблоне учинило застарелом. У верзији 1.26 подршка за шаблоне је уклоњена."
338
339 #. (itstool) path: sect1/para
340 #: C/index.docbook:404 C/index.docbook:418
341 msgid "(FIXME)"
342 msgstr "(ПОПРАВИМЕ)"
343
344 #. (itstool) path: sect1/para
345 #: C/index.docbook:408
346 msgid "(authors, web pages, mailing list, license, future plans, comparison with other similar systems.)"
347 msgstr "(аутори, веб странице, дописна листа, лиценца, будући планови, поређење са другим сличним системима.)"
348
349 #. (itstool) path: sect1/title
350 #: C/index.docbook:416
351 msgid "About this Manual"
352 msgstr "О овом приручнику"
353
354 #. (itstool) path: sect1/para
355 #: C/index.docbook:422
356 msgid "(who it is meant for, where you can get it, license)"
357 msgstr "(коме је намењен, где га можете набавити, лиценца)"
358
359 #. (itstool) path: chapter/title
360 #: C/index.docbook:431
361 msgid "Project Setup"
362 msgstr "Подешавање пројекта"
363
364 #. (itstool) path: chapter/para
365 #: C/index.docbook:433
366 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:"
367 msgstr "Ово поглавље описује кораке који су неопходни за интегрисање Гтк-документације (GTK-Doc) у ваш пројекат. Интеграција Гтк-документације у пројекат укључује следеће кораке:"
368
369 #. (itstool) path: listitem/para
370 #: C/index.docbook:441
371 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>)."
372 msgstr "Припрема структуре директоријума и стварање потребних датотека подешавања за вашу Гтк-документацију (погледајте <link linkend=\"settingup_docfiles\">Постављање скелета документације</link>)."
373
374 #. (itstool) path: listitem/para
375 #: C/index.docbook:449
376 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>."
377 msgstr "Прилагођавање система изградње за изградњу ваше документације помоћу алата Гтк-документације. Подржано је више система изградње, у овом приручнику описујемо како да интегришете Гтк-документацију са <link linkend=\"settingup_autotools\">Ауто-алатима (Autotools)</link>, <link linkend=\"settingup_cmake\">Ц-мејком (CMake)</link> и <link linkend=\"settingup_plain_makefiles\">обичним Мејк-датотекама (Makefiles)</link>."
378
379 #. (itstool) path: listitem/para
380 #: C/index.docbook:459
381 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>)."
382 msgstr "Додавање датотека специфичних за Гтк-документацију у систем за управљање верзијама и одлучивање о томе које датотеке треба занемарити (погледајте <link linkend=\"settingup_vcs\">Интеграција са системима за управљање верзијама</link>)."
383
384 #. (itstool) path: chapter/para
385 #: C/index.docbook:467
386 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>."
387 msgstr "Следећи одељци претпостављају да радимо на пројекту под називом <code>meep</code>. Овај пројекат садржи два пакета (или модула), библиотеку под називом <code>libmeep</code> и апликацију за крајњег корисника под називом <code>meeper</code>."
388
389 #. (itstool) path: sect1/title
390 #: C/index.docbook:476
391 msgid "Setting up a skeleton documentation"
392 msgstr "Постављање скелета документације"
393
394 #. (itstool) path: sect1/para
395 #: C/index.docbook:478
396 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."
397 msgstr "Уобичајена конвенција је да се документација постави у фасциклу под називом <code>docs</code> унутар главног директоријума вашег пројекта. Обично разликујемо <emphasis>референтну документацију</emphasis> намењену програмерима и <emphasis>кориснички приручник</emphasis> намењен крајњим корисницима. Опет, конвенција је да постоје посебне фасцикле за оба. Обично референтну документацију стављамо у фасциклу под називом <code>reference</code>, а кориснички приручник у фасциклу под називом <code>help</code>. Према горе наведеној конвенцији, документација за наш пакет <code>libmeep</code> била би постављена у: <code>docs/reference/libmeep</code>. За пакете са само једном библиотеком или апликацијом, документација би се такође могла поставити директно у <code>docs/reference</code>. Није обавезно користити горе наведену конвенцију, али ако изаберете другачију структуру директоријума, морате прилагодити подешавања вашег система изградње како би одговарала вашој структури директоријума."
398
399 #. (itstool) path: example/title
400 #: C/index.docbook:509
401 msgid "Example directory structure of <emphasis>meep</emphasis> project"
402 msgstr "Пример структуре директоријума пројекта <emphasis>meep</emphasis>"
403
404 #. (itstool) path: example/programlisting
405 #: C/index.docbook:511
406 #, no-wrap
407 msgid ""
408 "\n"
409 "meep/\n"
410 " docs/\n"
411 " reference/ # reference documentation\n"
412 " libmeep/\n"
413 " meeper/\n"
414 " help/ # optional: user manual\n"
415 " meeper/\n"
416 " src/\n"
417 " libmeep/\n"
418 " meeper/\n"
419 msgstr ""
420 "\n"
421 "meep/\n"
422 " docs/\n"
423 " reference/ # референтна документација\n"
424 " libmeep/\n"
425 " meeper/\n"
426 " help/ # опционо: кориснички приручник\n"
427 " meeper/\n"
428 " src/\n"
429 " libmeep/\n"
430 " meeper/\n"
431
432 #. (itstool) path: sect1/para
433 #: C/index.docbook:503
434 msgid "In the following sections we will assume a directory structure for our <emphasis>meep</emphasis> project that uses the above conventions. <_:example-1/>"
435 msgstr "У следећим одељцима претпоставићемо структуру директоријума за наш пројекат <emphasis>meep</emphasis> који користи горе наведене конвенције. <_:example-1/>"
436
437 #. (itstool) path: sect1/title
438 #: C/index.docbook:528
439 msgid "Integration with Autotools"
440 msgstr "Интеграција са Ауто-алатима (Autotools)"
441
442 #. (itstool) path: sect1/para
443 #: C/index.docbook:529
444 msgid "Integration of GTK-Doc into an autotools-based build system requires the following steps:"
445 msgstr "Интеграција Гтк-документације у систем изградње заснован на Ауто-алатима захтева следеће кораке:"
446
447 #. (itstool) path: listitem/para
448 #: C/index.docbook:535
449 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>."
450 msgstr "Осигурајте да се <application>gtkdocize</application> покрене једном пре скрипте <filename>configure</filename>. Ако је присутна скрипта <filename>autogen.sh</filename>, прилагодите је тако да проверава Гтк-документацију и додајте позив за <application>gtkdocize</application>."
451
452 #. (itstool) path: listitem/para
453 #: C/index.docbook:543
454 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."
455 msgstr "Главна сврха програма <application>gtkdocize</application> је да учини <filename>gtk-doc.make</filename> Мејк-датотеку и <filename>gtk-doc.m4</filename> датотеку дефиниције макроа доступним систему изградње, било копирањем или повезивањем у пројекат."
456
457 #. (itstool) path: listitem/para
458 #: C/index.docbook:552
459 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."
460 msgstr "Додајте неопходне <application>autoconf</application> макрое у <filename>configure.ac</filename> да бисте омогућили ГТК-док у вашем систему изградње и омогућили подешавање ГТК-дока путем генерисане <filename>configure</filename> скрипте."
461
462 #. (itstool) path: listitem/para
463 #: C/index.docbook:558
464 msgid "Among others with registers the <code>--enable-gtk-doc</code> option with the <filename>configure</filename> script."
465 msgstr "Између осталих, региструје опцију <code>--enable-gtk-doc</code> код <filename>configure</filename> скрипте."
466
467 #. (itstool) path: listitem/para
468 #: C/index.docbook:564
469 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>."
470 msgstr "Направите <application>automake</application> скрипту за сваки програм или библиотеку у вашем пројекту. У примеру који се користи у овој документацији, овај корак се односи и на <code>meeper</code> и на <code>libmeep</code>."
471
472 #. (itstool) path: sect1/para
473 #: C/index.docbook:573
474 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."
475 msgstr "У следећим одељцима, извршићемо горе наведене кораке обрнутим редоследом. Почињемо са <application>automake</application> скриптама и настављамо до <filename>configure.ac</filename> и <filename>autogen.sh</filename>. Затим показујемо како да омогућите Гтк-док у систему изградње и како да изградите документацију."
476
477 #. (itstool) path: sect2/title
478 #: C/index.docbook:583
479 msgid "Integration with automake"
480 msgstr "Интеграција са аутомејком"
481
482 #. (itstool) path: sect2/para
483 #: C/index.docbook:585
484 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."
485 msgstr "Прво копирајте <filename>Makefile.am</filename> из поддиректоријума <filename class=\"directory\">examples</filename> са <ulink url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-sources</ulink> у директоријум референтне документације вашег пројекта (нпр. <filename class=\"directory\">docs/reference/&lt;package&gt;</filename>). Локална копија би требало да буде доступна под нпр. <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. Ако имате више пакета, поновите ово за сваки од њих."
486
487 #. (itstool) path: note/simpara
488 #: C/index.docbook:598
489 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>."
490 msgstr "Не заборавите да додате сваки <filename>Makefile.am</filename> у <function>AC_CONFIG_FILES</function> макро у <filename>configure.ac</filename>. За <filename>docs/reference/libmeep/Makefile.am</filename> мораћете да додате унос <filename>docs/reference/libmeep/Makefile</filename> у <function>AC_CONFIG_FILES</function>."
491
492 #. (itstool) path: example/title
493 #: C/index.docbook:610
494 msgid "Example directory structure with <filename>Makefiles.am</filename>"
495 msgstr "Пример структуре директоријума са <filename>Makefiles.am</filename>"
496
497 #. (itstool) path: example/programlisting
498 #: C/index.docbook:613
499 #, no-wrap
500 msgid ""
501 "\n"
502 "meep/\n"
503 " docs/\n"
504 " reference/ # reference documentation\n"
505 " libmeep/\n"
506 " Makefile.am\n"
507 " meeper/\n"
508 " Makefile.am\n"
509 " help/ # optional: user manual\n"
510 " meeper/\n"
511 " src/\n"
512 " libmeep/\n"
513 " meeper/\n"
514 msgstr ""
515 "\n"
516 "meep/\n"
517 " docs/\n"
518 " reference/ # референтна документација\n"
519 " libmeep/\n"
520 " Makefile.am\n"
521 " meeper/\n"
522 " Makefile.am\n"
523 " help/ # опционално: корисничко упутство\n"
524 " meeper/\n"
525 " src/\n"
526 " libmeep/\n"
527 " meeper/\n"
528
529 #. (itstool) path: sect2/para
530 #: C/index.docbook:629
531 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."
532 msgstr "Затим треба да прилагодите копиране датотеке Makefile и обезбедите вредности за различите параметре у сваком <filename>Makefile.am</filename>. Сва подешавања имају коментар изнад који описује њихову сврху и како да их прилагодите. Већина подешавања се користи за достављање додатних опција одговарајућим алатима на које се односе. Сваки алат има променљиву облика <option>&lt;TOOLNAME&gt;_OPTIONS</option> (нпр. алат <application>gtkdoc-mkhtml</application> има опцију под називом <code>MKHTML_OPTIONS</code>). Сви алати подржавају <option>--help</option> за исписивање подржаних опција."
533
534 #. (itstool) path: listitem/para
535 #: C/index.docbook:653
536 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>)."
537 msgstr "<option>DOC_MODULE</option> се користи за навођење назива пакета који се документује (нпр. <code>meeper</code> или <code>libmeep</code>)."
538
539 #. (itstool) path: listitem/para
540 #: C/index.docbook:660
541 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."
542 msgstr "<option>DOC_SOURCE_DIR</option> се користи за навођење путање изворног директоријума у којем ГТК-док тражи вашу АПИ документацију. Ово ће обично бити <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> или поддиректоријум тог директоријума."
543
544 #. (itstool) path: listitem/para
545 #: C/index.docbook:673
546 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."
547 msgstr "<option>HFILE_GLOB</option> и <option>CFILE_GLOB</option> се користе за зависности. Свака опција узима шаблон датотека (нпр. <code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). Документација ће бити поново изграђена ако се било која од подударних датотека промени."
548
549 #. (itstool) path: listitem/para
550 #: C/index.docbook:685
551 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>)."
552 msgstr "<option>EXTRA_HFILES</option> омогућава навођење додатних датотека заглавља које треба укључити приликом скенирања АПИ документације, а које се не налазе под <code>DOC_SOURCE_DIR</code> (нпр. <code> EXTRA_HFILES=$(top_srcdir}/contrib/extra.h</code>)."
553
554 #. (itstool) path: listitem/para
555 #: C/index.docbook:695
556 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>)."
557 msgstr "<option>IGNORE_HFILES</option> омогућава навођење датотека заглавља или директоријума које треба занемарити приликом скенирања АПИ документације. Користите основни назив датотеке или директоријума (нпр. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>)."
558
559 #. (itstool) path: listitem/para
560 #: C/index.docbook:705
561 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>)."
562 msgstr "<option>HTML_IMAGES</option> омогућава навођење датотека слика које ће бити копиране у <filename>html/</filename> директоријум генерисане документације. Ако ваша АПИ документација укључује било какве слике, оне морају бити додате у ову опцију (нпр. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png</code>)."
563
564 #. (itstool) path: listitem/para
565 #: C/index.docbook:718
566 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>)."
567 msgstr "<option>content_files</option> омогућава навођење додатних датотека које су укључене у <code>$(DOC_MAIN_SGML_FILE)</code> (нпр. <code> content_files=running.xml building.xml changes-2.0.xml</code>)."
568
569 #. (itstool) path: listitem/para
570 #: C/index.docbook:729
571 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>)."
572 msgstr "<option>expand_content_files</option> омогућава навођење датотека у којима се <emphasis>gtk-doc скраћенице</emphasis> као што је <code>#GtkWidget</code> проширују (нпр. <code> expand_content_files=running.xml</code>)."
573
574 #. (itstool) path: sect2/para
575 #: C/index.docbook:647
576 msgid "The following list explains the most relevant options. Check the example <filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
577 msgstr "Следећи списак објашњава најрелевантније опције. Погледајте пример <filename>Makefile.am</filename> за додатне опције. <_:itemizedlist-1/>"
578
579 #. (itstool) path: sect2/title
580 #: C/index.docbook:744
581 msgid "Integration with autoconf"
582 msgstr "Интеграција са autoconf-ом"
583
584 #. (itstool) path: sect2/para
585 #: C/index.docbook:746
586 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>."
587 msgstr "Интеграција са <application>autoconf-ом</application> је врло једноставна и укључује један обавезан корак и додатни опциони (али препоручени) корак. Први корак је додавање <function>GTK_DOC_CHECK</function> макроа у вашу <filename>configure.ac</filename> скрипту. Ово региструје неколико опција подешавања за омогућавање ГТК-Документације и омогућава вам да поставите подразумеване аргументе за <application>gtkdocize</application>."
588
589 #. (itstool) path: warning/simpara
590 #: C/index.docbook:758
591 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."
592 msgstr "Уверите се да <code>GTK_DOC_CHECK</code> макро није увучен. Макро мора почети на почетку реда и не би требало да почиње празнином."
593
594 #. (itstool) path: sect2/para
595 #: C/index.docbook:765
596 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."
597 msgstr "Други корак је додавање <code>AC_CONFIG_MACRO_DIR(m4)</code> у ваш <filename>configure.ac</filename>. Ово није обавезно, али помаже <application>gtkdocize-у</application> да аутоматски копира дефиницију макроа (нпр. <filename>gtk-doc.m4</filename>) која садржи <function>GTK_DOC_CHECK</function> макро у директоријум макроа вашег пројекта. Без овога, макро GTK_DOC_CHECK можда неће бити пронађен и морали бисте експлицитно рећи алату <application>aclocal</application> где да пронађе датотеку дефиниције макроа."
598
599 #. (itstool) path: example/title
600 #: C/index.docbook:778
601 msgid "Minimal integration with autoconf"
602 msgstr "Минимална интеграција са autoconf-ом"
603
604 #. (itstool) path: example/programlisting
605 #: C/index.docbook:779
606 #, no-wrap
607 msgid ""
608 "\n"
609 "# recommended: set m4 directory\n"
610 "AC_CONFIG_MACRO_DIR(m4)\n"
611 "# optional: register gtk-doc in configure\n"
612 "GTK_DOC_CHECK([1.28])\n"
613 msgstr ""
614 "\n"
615 "# препоручено: поставите m4 директоријум\n"
616 "AC_CONFIG_MACRO_DIR(m4)\n"
617 "# опционо: региструјте gtk-doc у configure\n"
618 "GTK_DOC_CHECK([1.28])\n"
619
620 #. (itstool) path: example/title
621 #: C/index.docbook:794
622 msgid "Integration with optional gtk-doc dependency"
623 msgstr "Интеграција са опционом gtk-doc зависношћу"
624
625 #. (itstool) path: example/programlisting
626 #: C/index.docbook:795
627 #, no-wrap
628 msgid ""
629 "\n"
630 "m4_ifdef([GTK_DOC_CHECK], [\n"
631 "# recommended: set m4 directory\n"
632 "AC_CONFIG_MACRO_DIR(m4)\n"
633 "# optional: register gtk-doc in configure\n"
634 "GTK_DOC_CHECK([1.28])\n"
635 "],[\n"
636 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
637 "])\n"
638 msgstr ""
639 "\n"
640 "m4_ifdef([GTK_DOC_CHECK], [\n"
641 "# препоручено: поставите m4 директоријум\n"
642 "AC_CONFIG_MACRO_DIR(m4)\n"
643 "# опционо: региструјте gtk-doc у configure\n"
644 "GTK_DOC_CHECK([1.28])\n"
645 "],[\n"
646 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
647 "])\n"
648
649 #. (itstool) path: sect2/para
650 #: C/index.docbook:788
651 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/>"
652 msgstr "Горњи пример ради, али ће захтевати да сви програмери имају инсталиран gtk-doc. Бољи начин је да изградња документације буде опциона као што је приказано у следећем примеру: <_:example-1/>"
653
654 #. (itstool) path: sect2/para
655 #: C/index.docbook:808
656 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:"
657 msgstr "Први аргумент се користи за проверу издања Гтк-Документације у време подешавања. Други, опциони аргумент користи <application>gtkdocize</application>. Макро <symbol>GTK_DOC_CHECK</symbol> такође додаје неколико прекидача подешавања:"
658
659 #. (itstool) path: listitem/para
660 #: C/index.docbook:817
661 msgid "--with-html-dir=PATH : path to installed docs"
662 msgstr "--with-html-dir=ПУТАЊА : путања до инсталиране документације"
663
664 #. (itstool) path: listitem/para
665 #: C/index.docbook:818
666 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
667 msgstr "--enable-gtk-doc : користи gtk-doc за изградњу документације [подразумевано=no]"
668
669 #. (itstool) path: listitem/para
670 #: C/index.docbook:819
671 msgid "--enable-gtk-doc-html : build documentation in html format [default=yes]"
672 msgstr "--enable-gtk-doc-html : изгради документацију у html формату [подразумевано=yes]"
673
674 #. (itstool) path: listitem/para
675 #: C/index.docbook:820
676 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
677 msgstr "--enable-gtk-doc-pdf : изгради документацију у pdf формату [подразумевано=no]"
678
679 #. (itstool) path: important/para
680 #: C/index.docbook:824
681 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)."
682 msgstr "ГТК-Документација је онемогућена по дефолту! Не заборавите да проследите опцију <option>'--enable-gtk-doc'</option> следећем покретању <filename>configure</filename> скрипте. У супротном се инсталира унапред генерисана документација (што има смисла за кориснике, али не и за програмере)."
683
684 #. (itstool) path: sect2/para
685 #: C/index.docbook:832
686 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>."
687 msgstr "Након што су све измене у <filename>configure.ac</filename> направљене, ажурирајте <filename>configure</filename> датотеку. Ово се може урадити поновним покретањем <code>autogen.sh</code>."
688
689 #. (itstool) path: sect2/title
690 #: C/index.docbook:840
691 msgid "Integration with autogen"
692 msgstr "Интеграција са autogen-ом"
693
694 #. (itstool) path: sect2/para
695 #: C/index.docbook:842
696 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."
697 msgstr "Већина пројеката ће имати <filename>autogen.sh</filename> скрипту за подешавање инфраструктуре изградње након што је пројекат преузет из система за контролу верзија (као што су git или svn). ГТК-Документација долази са скриптом званом <application>gtkdocize</application> која се може користити за копирање неопходних датотека потребних Гтк-Документацији у изворни директоријум."
698
699 #. (itstool) path: sect2/para
700 #: C/index.docbook:850
701 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
702 msgstr "Требало би да се покрене пре autoreconf, autoheader, automake или autoconf програма."
703
704 #. (itstool) path: example/title
705 #: C/index.docbook:855
706 msgid "Running gtkdocize from autogen.sh"
707 msgstr "Покретање gtkdocize-а из autogen.sh"
708
709 #. (itstool) path: example/programlisting
710 #: C/index.docbook:856
711 #, no-wrap
712 msgid ""
713 "\n"
714 "gtkdocize || exit 1\n"
715 msgstr ""
716 "\n"
717 "gtkdocize || exit 1\n"
718
719 #. (itstool) path: example/title
720 #: C/index.docbook:864
721 msgid "Conditionally run gtkdocize from autogen.sh"
722 msgstr "Условно покрените gtkdocize из autogen.sh"
723
724 #. (itstool) path: example/programlisting
725 #: C/index.docbook:865
726 #, no-wrap
727 msgid ""
728 "\n"
729 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
730 "if test $? -ne 0; then\n"
731 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
732 "else\n"
733 " $GTKDOCIZE || exit 1\n"
734 "fi\n"
735 msgstr ""
736 "\n"
737 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
738 "if test $? -ne 0; then\n"
739 " echo \"Није пронађена подршка за gtk-doc. Не можете изградити документацију.\"\n"
740 "else\n"
741 " $GTKDOCIZE || exit 1\n"
742 "fi\n"
743
744 #. (itstool) path: sect2/para
745 #: C/index.docbook:876
746 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)."
747 msgstr "Када се покрене <application>gtkdocize</application>, он копира <filename>gtk-doc.make</filename> у корен вашег пројекта (или било који директоријум наведен опцијом <option>--docdir</option>)."
748
749 #. (itstool) path: sect2/para
750 #: C/index.docbook:882
751 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."
752 msgstr "<application>gtkdocize</application> проверава вашу <filename>configure.ac</filename> скрипту за макро <function>GTK_DOC_CHECK</function>. Макро <function>GTK_DOC_CHECK</function> се може користити за прослеђивање додатних аргумената скрипти <application>gtkdocize</application> преко другог параметра у макроу <function>GTK_DOC_CHECK</function>."
753
754 #. (itstool) path: sect2/para
755 #: C/index.docbook:891
756 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>."
757 msgstr "Алтернативно, додатни аргументи се такође могу проследити програму <application>gtkdocize</application> преко променљиве окружења <function>GTKDOCIZE_FLAGS</function>, или директним навођењем у <filename>autogen.sh</filename>."
758
759 #. (itstool) path: sect2/title
760 #: C/index.docbook:902
761 msgid "Executing GTK-Doc from the Build System"
762 msgstr "Извршавање ГТК-документације из система за изградњу"
763
764 #. (itstool) path: sect2/para
765 #: C/index.docbook:904
766 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."
767 msgstr "Након претходних корака, време је за покретање изградње. Прво морамо поново покренути <filename>autogen.sh</filename>. Ако ова скрипта покреће configure уместо вас, тада јој проследите опцију <option>--enable-gtk-doc</option>. У супротном, ручно покрените <filename>configure</filename> са овом опцијом након тога."
768
769 #. (itstool) path: sect2/para
770 #: C/index.docbook:911
771 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>."
772 msgstr "Прво покретање наредбе make генерише неколико додатних датотека у директоријумима документације. Важне су: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (раније .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
773
774 #. (itstool) path: example/title
775 #: C/index.docbook:919
776 msgid "Running the doc build"
777 msgstr "Покретање изградње документације"
778
779 #. (itstool) path: example/programlisting
780 #: C/index.docbook:920
781 #, no-wrap
782 msgid ""
783 "\n"
784 "./autogen.sh --enable-gtk-doc\n"
785 "make\n"
786 msgstr ""
787 "\n"
788 "./autogen.sh --enable-gtk-doc\n"
789 "make\n"
790
791 #. (itstool) path: sect2/para
792 #: C/index.docbook:927
793 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."
794 msgstr "Сада можете усмерити свој веб прегледач на <filename>docs/reference/&lt;package&gt;/index.html</filename>. Са овим почетним подешавањем видећете само врло једноставан документ. Следеће поглавље ће вас научити како да додате АПИ документацију у свој код путем посебних блокова коментара. Поглавље након тога уводи <link linkend=\"metafiles\">додатне датотеке</link> и показује како да уредите <link linkend=\"metafiles_master\">главни шаблон</link> да бисте додали додатна поглавља и одељке својим датотекама документације."
795
796 #. (itstool) path: sect1/title
797 #: C/index.docbook:943
798 msgid "Integration with CMake build systems"
799 msgstr "Интеграција са CMake системима за изградњу"
800
801 #. (itstool) path: sect1/para
802 #: C/index.docbook:945
803 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."
804 msgstr "ГТК-документација сада пружа <filename>GtkDocConfig.cmake</filename> модул (и одговарајући <filename>GtkDocConfigVersion.cmake</filename> модул). Ово омогућава наредбу <literal>gtk_doc_add_module</literal> коју можете поставити у своју <filename>CMakeLists.txt</filename> датотеку."
805
806 #. (itstool) path: example/title
807 #: C/index.docbook:955
808 msgid "Example of using GTK-Doc from CMake"
809 msgstr "Пример коришћења ГТК-документације из CMake-а"
810
811 #. (itstool) path: example/programlisting
812 #: C/index.docbook:956
813 #, no-wrap
814 msgid ""
815 "\n"
816 "find_package(GtkDoc 1.25 REQUIRED)\n"
817 "\n"
818 "# Create the doc-libmeep target.\n"
819 "gtk_doc_add_module(\n"
820 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
821 " XML meep-docs.xml\n"
822 " LIBRARIES libmeep\n"
823 ")\n"
824 "\n"
825 "# Build doc-libmeep as part of the default target. Without this, you would\n"
826 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
827 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
828 "\n"
829 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
830 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
831 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
832 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
833 msgstr ""
834 "\n"
835 "find_package(GtkDoc 1.25 REQUIRED)\n"
836 "\n"
837 "# Create the doc-libmeep target.\n"
838 "gtk_doc_add_module(\n"
839 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
840 " XML meep-docs.xml\n"
841 " LIBRARIES libmeep\n"
842 ")\n"
843 "\n"
844 "# Build doc-libmeep as part of the default target. Without this, you would\n"
845 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
846 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
847 "\n"
848 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
849 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
850 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
851 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
852
853 #. (itstool) path: sect1/para
854 #: C/index.docbook:953
855 msgid "The following example shows how to use this command. <_:example-1/>"
856 msgstr "Следећи пример показује како се користи ова наредба. <_:example-1/>"
857
858 #. (itstool) path: sect1/title
859 #: C/index.docbook:980
860 msgid "Integration with plain makefiles or other build systems"
861 msgstr "Интеграција са обичним make-датотекама или другим системима за изградњу"
862
863 #. (itstool) path: sect1/para
864 #: C/index.docbook:982
865 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)."
866 msgstr "У случају да неко не жели да користи automake, а самим тим ни <filename>gtk-doc.mak</filename>, мораће да позове gtkdoc алате у исправном редоследу у сопственим make-датотекама (или другим алатима за изградњу)."
867
868 #. (itstool) path: example/title
869 #: C/index.docbook:989
870 msgid "Documentation build steps"
871 msgstr "Кораци изградње документације"
872
873 #. (itstool) path: example/programlisting
874 #: C/index.docbook:990
875 #, no-wrap
876 msgid ""
877 "\n"
878 "DOC_MODULE=meep\n"
879 "// sources have changed\n"
880 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
881 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
882 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
883 "// xml files have changed\n"
884 "mkdir html\n"
885 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
886 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
887 msgstr ""
888 "\n"
889 "DOC_MODULE=meep\n"
890 "// извори су измењени\n"
891 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
892 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
893 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
894 "// xml датотеке су измењене\n"
895 "mkdir html\n"
896 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
897 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
898
899 #. (itstool) path: sect1/para
900 #: C/index.docbook:1004
901 msgid "One will need to look at the <filename>Makefile.am</filename> and <filename>gtk-doc.mak</filename> to pick the extra options needed."
902 msgstr "Требаће погледати у <filename>Makefile.am</filename> и <filename>gtk-doc.mak</filename> како бисте одабрали потребне додатне опције."
903
904 #. (itstool) path: sect1/title
905 #: C/index.docbook:1011
906 msgid "Integration with version control systems"
907 msgstr "Интеграција са системима за управљање верзијама"
908
909 #. (itstool) path: sect1/para
910 #: C/index.docbook:1013
911 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>."
912 msgstr "Као опште правило, датотеке које уређујете треба да буду под контролом верзија. За типичне пројекте то су следеће датотеке: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (раније .sgml), <filename>&lt;package&gt;-sections.txt</filename>, <filename>Makefile.am</filename>."
913
914 #. (itstool) path: sect1/para
915 #: C/index.docbook:1021
916 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."
917 msgstr "Датотеке у директоријумима <filename>xml/</filename> и <filename>html/</filename> не би требало да буду под контролом верзија. Исто важи и за било коју од <filename>.stamp</filename> датотека."
918
919 #. (itstool) path: chapter/title
920 #: C/index.docbook:1031
921 msgid "Documenting the code"
922 msgstr "Документовање кода"
923
924 #. (itstool) path: chapter/para
925 #: C/index.docbook:1033
926 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."
927 msgstr "ГТК-Док користи коментаре у изворном коду са посебном синтаксом за документацију кода. Такође, он преузима информације о структури вашег пројекта из других извора. У следећем одељку наћи ћете све информације о синтакси коментара."
928
929 #. (itstool) path: example/title
930 #: C/index.docbook:1044 C/index.docbook:1070
931 msgid "GTK-Doc comment block"
932 msgstr "ГТК-Док блок коментара"
933
934 #. (itstool) path: example/programlisting
935 #: C/index.docbook:1045
936 #, no-wrap
937 msgid ""
938 "\n"
939 "#ifndef __GTK_DOC_IGNORE__\n"
940 "/* unparseable code here */\n"
941 "#endif\n"
942 msgstr ""
943 "\n"
944 "#ifndef __GTK_DOC_IGNORE__\n"
945 "/* код који се не може рашчланити је овде */\n"
946 "#endif\n"
947
948 #. (itstool) path: chapter/para
949 #: C/index.docbook:1040
950 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/>"
951 msgstr "Скенер ГТК-Дока може добро да обради већину Ц заглавља. У случају добијања упозорења од скенера која изгледају као посебан случај, можете наговестити ГТК-Доку да их прескочи. <_:example-1/>"
952
953 #. (itstool) path: note/title
954 #: C/index.docbook:1054
955 msgid "Limitations"
956 msgstr "Ограничења"
957
958 #. (itstool) path: note/para
959 #: C/index.docbook:1055
960 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."
961 msgstr "Имајте на уму да ГТК-Док подржава <code>#ifndef(__GTK_DOC_IGNORE__)</code> али не и <code>#if !defined(__GTK_DOC_IGNORE__)</code> или друге комбинације."
962
963 #. (itstool) path: sect1/title
964 #: C/index.docbook:1065
965 msgid "Documentation comments"
966 msgstr "Коментари документације"
967
968 #. (itstool) path: example/programlisting
969 #: C/index.docbook:1071
970 #, no-wrap
971 msgid ""
972 "\n"
973 "/**\n"
974 " * identifier:\n"
975 " * documentation ...\n"
976 " */\n"
977 msgstr ""
978 "\n"
979 "/**\n"
980 " * идентификатор:\n"
981 " * документација ...\n"
982 " */\n"
983
984 #. (itstool) path: sect1/para
985 #: C/index.docbook:1067
986 msgid "A multiline comment that starts with an additional '*' marks a documentation block that will be processed by the GTK-Doc tools. <_:example-1/>"
987 msgstr "Вишередни коментар који почиње са додатним знаком „*“ означава блок документације који ће обрадити алати ГТК-Дока. <_:example-1/>"
988
989 #. (itstool) path: sect1/para
990 #: C/index.docbook:1080
991 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)"
992 msgstr "„Идентификатор“ је један ред са називом ставке на коју се коментар односи. Синтакса се мало разликује у зависности од ставке. (ДА СЕ УРАДИ: додати табелу која приказује идентификаторе)"
993
994 #. (itstool) path: sect1/para
995 #: C/index.docbook:1086
996 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)."
997 msgstr "Блок „документација“ је такође различит за сваку врсту симбола. Врсте симбола који примају параметре, као што су функције или макрои, имају прво опис параметара након чега следи празан ред (само „*“). Затим следи детаљан опис. Сви редови (изван програмских спискова и CDATA одељака) који садрже само „ *“ (размак-звездица) претварају се у преломе пасуса. Ако не желите прелом пасуса, промените то у „ * “ (размак-звездица-размак-размак). Ово је корисно у преформатираном тексту (спискови кода)."
998
999 #. (itstool) path: listitem/para
1000 #: C/index.docbook:1103
1001 msgid "What it is: The name for a class or function can sometimes be misleading for people coming from a different background."
1002 msgstr "Шта је то: Назив класе или функције понекад може бити обмањујући за људе који долазе из другачијег окружења."
1003
1004 #. (itstool) path: listitem/para
1005 #: C/index.docbook:1109
1006 msgid "What it does: Tell about common uses. Put it in relation with the other API."
1007 msgstr "Шта ради: Реците нешто о уобичајеним употребама. Ставите га у однос са другим АПИ-јем."
1008
1009 #. (itstool) path: tip/para
1010 #: C/index.docbook:1099
1011 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1012 msgstr "Приликом документовања кода, опишите два аспекта: <_:itemizedlist-1/>"
1013
1014 #. (itstool) path: listitem/para
1015 #: C/index.docbook:1124
1016 msgid "Use function() to refer to functions or macros which take arguments."
1017 msgstr "Користите function() за упућивање на функције или макрое који примају аргументе."
1018
1019 #. (itstool) path: listitem/para
1020 #: C/index.docbook:1129
1021 msgid "Use @param to refer to parameters. Also use this when referring to parameters of other functions, related to the one being described."
1022 msgstr "Користите @param за упућивање на параметре. Такође користите ово када упућујете на параметре других функција, који су повезани са оном која се описује."
1023
1024 #. (itstool) path: listitem/para
1025 #: C/index.docbook:1135
1026 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1027 msgstr "Користите %constant за упућивање на константу, нпр. %G_TRAVERSE_LEAFS."
1028
1029 #. (itstool) path: listitem/para
1030 #: C/index.docbook:1140
1031 msgid "Use #symbol to refer to other types of symbol, e.g. structs and enums and macros which don't take arguments."
1032 msgstr "Користите #symbol за упућивање на друге врсте симбола, нпр. структуре и набрајања и макрое који не примају аргументе."
1033
1034 #. (itstool) path: listitem/para
1035 #: C/index.docbook:1146
1036 msgid "Use #Object::signal to refer to a GObject signal."
1037 msgstr "Користите #Object::signal за упућивање на Г-објектни сигнал."
1038
1039 #. (itstool) path: listitem/para
1040 #: C/index.docbook:1151
1041 msgid "Use #Object:property to refer to a GObject property."
1042 msgstr "Користите #Object:property за упућивање на Г-објектно својство."
1043
1044 #. (itstool) path: listitem/para
1045 #: C/index.docbook:1156
1046 msgid "Use #Struct.field to refer to a field inside a structure and #GObjectClass.foo_bar() to refer to a vmethod."
1047 msgstr "Користите #Struct.field за упућивање на поље унутар структуре и #GObjectClass.foo_bar() за упућивање на виртуелну методу."
1048
1049 #. (itstool) path: sect1/para
1050 #: C/index.docbook:1118
1051 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/>"
1052 msgstr "Једна предност хипертекста над обичним текстом је могућност поседовања веза у документу. Писање исправног означавања за везу може бити заморно. Гтк-Док прискаче у помоћ пружајући неколико корисних скраћеница. <_:itemizedlist-1/>"
1053
1054 #. (itstool) path: tip/para
1055 #: C/index.docbook:1165
1056 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 '\\'."
1057 msgstr "Ако треба да користите посебне знакове „&lt;“, „&gt;“, „()“, „@“, „%“ или „#“ у вашој документацији а да их Гтк-Док не промени, можете користити ИксМЛ ентитете „&amp;lt;“, „&amp;gt;“, „&amp;lpar;“, „&amp;rpar;“, „&amp;commat;“, „&amp;percnt;“ и „&amp;num;“ респективно или их заштитити контра косом цртом „\\“."
1058
1059 #. (itstool) path: sect1/para
1060 #: C/index.docbook:1174
1061 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."
1062 msgstr "ДокБук може учинити више од самих веза. Такође се могу имати спискови, примери, заглавља и слике. Од верзије 1.20, пожељан начин је коришћење подскупа основне синтаксе форматирања текста званог <ulink url=\"http://daringfireball.net/projects/markdown/\">Маркдаун</ulink>. На старијим верзијама Гтк-Дока свака документација која укључује Маркдаун биће исцртана онако како јесте. На пример, ставке списка ће се појавити као редови који почињу цртицом."
1063
1064 #. (itstool) path: sect1/para
1065 #: C/index.docbook:1185
1066 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."
1067 msgstr "Иако се маркдаун сада преферира, могу се мешати оба. Једно ограничење овде је да се може користити докбук иксмл унутар маркдауна, али маркдаун унутар докбук иксмла није подржан."
1068
1069 #. (itstool) path: sect1/para
1070 #: C/index.docbook:1191
1071 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>."
1072 msgstr "У старијим издањима Гтк-Дока, ако вам је потребна подршка за додатно форматирање, морали бисте да омогућите коришћење докбук ИксМЛ ознака унутар док-коментара постављањем <option>--xml-mode</option> (или <option>--sgml-mode</option>) у променљиву <symbol>MKDB_OPTIONS</symbol> унутар <filename>Makefile.am</filename>."
1073
1074 #. (itstool) path: example/title
1075 #: C/index.docbook:1200
1076 msgid "GTK-Doc comment block using Markdown"
1077 msgstr "Гтк-Док блок коментара који користи Маркдаун"
1078
1079 #. (itstool) path: example/programlisting
1080 #: C/index.docbook:1201
1081 #, no-wrap
1082 msgid ""
1083 "\n"
1084 "/**\n"
1085 " * identifier:\n"
1086 " *\n"
1087 " * documentation paragraph ...\n"
1088 " *\n"
1089 " * # Sub Heading #\n"
1090 " *\n"
1091 " * ## Second Sub Heading\n"
1092 " *\n"
1093 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1094 " *\n"
1095 " * more documentation:\n"
1096 " *\n"
1097 " * - list item 1\n"
1098 " *\n"
1099 " * Paragraph inside a list item.\n"
1100 " *\n"
1101 " * - list item 2\n"
1102 " *\n"
1103 " * 1. numbered list item\n"
1104 " *\n"
1105 " * 2. another numbered list item\n"
1106 " *\n"
1107 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1108 " *\n"
1109 " * ![an inline image](plot-result.png)\n"
1110 " *\n"
1111 " * [A link to the heading anchor above][heading-two]\n"
1112 " *\n"
1113 " * A C-language example:\n"
1114 " * |[&lt;!-- language=\"C\" --&gt;\n"
1115 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1116 " * ]|\n"
1117 " */\n"
1118 msgstr ""
1119 "\n"
1120 "/**\n"
1121 " * identifier:\n"
1122 " *\n"
1123 " * documentation paragraph ...\n"
1124 " *\n"
1125 " * # Sub Heading #\n"
1126 " *\n"
1127 " * ## Second Sub Heading\n"
1128 " *\n"
1129 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1130 " *\n"
1131 " * more documentation:\n"
1132 " *\n"
1133 " * - list item 1\n"
1134 " *\n"
1135 " * Paragraph inside a list item.\n"
1136 " *\n"
1137 " * - list item 2\n"
1138 " *\n"
1139 " * 1. numbered list item\n"
1140 " *\n"
1141 " * 2. another numbered list item\n"
1142 " *\n"
1143 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1144 " *\n"
1145 " * ![an inline image](plot-result.png)\n"
1146 " *\n"
1147 " * [A link to the heading anchor above][heading-two]\n"
1148 " *\n"
1149 " * A C-language example:\n"
1150 " * |[&lt;!-- language=\"C\" --&gt;\n"
1151 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1152 " * ]|\n"
1153 " */\n"
1154
1155 #. (itstool) path: sect1/para
1156 #: C/index.docbook:1240
1157 msgid "More examples of what markdown tags are supported can be found in the <ulink url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK Documentation Markdown Syntax Reference</ulink>."
1158 msgstr "Више примера о томе које су маркдаун ознаке подржане можете пронаћи у <ulink url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">Референцама синтаксе Маркдауна за ГТК документацију</ulink>."
1159
1160 #. (itstool) path: tip/para
1161 #: C/index.docbook:1246
1162 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."
1163 msgstr "Као што је већ раније поменуто, Гтк-Док је за документовање јавног АПИ-ја. Стога се не може писати документација за статичке симболе. Ипак, добро је коментарисати и те симболе. Ово помаже другим програмерима да разумеју ваш код. Због тога препоручујемо да их коментаришете користећи обичне коментаре (без друге звездице „*“ у првом реду). Ако касније функција треба да постане јавна, све што треба да урадите је да додате још једну звездицу „*“ у блок коментара и уметнете име симбола на право место унутар датотеке одељака."
1164
1165 #. (itstool) path: sect1/title
1166 #: C/index.docbook:1261
1167 msgid "Documenting sections"
1168 msgstr "Документовање одељака"
1169
1170 #. (itstool) path: sect1/para
1171 #: C/index.docbook:1263
1172 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."
1173 msgstr "Сваки одељак документације садржи информације о једној класи или модулу. За увођење компоненте може се написати блок одељка. Кратак опис се такође користи унутар садржаја. Сва @поља су опционална."
1174
1175 #. (itstool) path: example/title
1176 #: C/index.docbook:1271
1177 msgid "Section comment block"
1178 msgstr "Блок коментара одељка"
1179
1180 #. (itstool) path: example/programlisting
1181 #: C/index.docbook:1272
1182 #, no-wrap
1183 msgid ""
1184 "\n"
1185 "/**\n"
1186 " * SECTION:meepapp\n"
1187 " * @short_description: the application class\n"
1188 " * @title: Meep application\n"
1189 " * @section_id:\n"
1190 " * @see_also: #MeepSettings\n"
1191 " * @stability: Stable\n"
1192 " * @include: meep/app.h\n"
1193 " * @image: application.png\n"
1194 " *\n"
1195 " * The application class handles ...\n"
1196 " */\n"
1197 msgstr ""
1198 "\n"
1199 "/**\n"
1200 " * SECTION:meepapp\n"
1201 " * @short_description: the application class\n"
1202 " * @title: Meep application\n"
1203 " * @section_id:\n"
1204 " * @see_also: #MeepSettings\n"
1205 " * @stability: Stable\n"
1206 " * @include: meep/app.h\n"
1207 " * @image: application.png\n"
1208 " *\n"
1209 " * The application class handles ...\n"
1210 " */\n"
1211
1212 #. (itstool) path: varlistentry/term
1213 #: C/index.docbook:1291
1214 msgid "SECTION:&lt;name&gt;"
1215 msgstr "SECTION:&lt;назив&gt;"
1216
1217 #. (itstool) path: listitem/para
1218 #: C/index.docbook:1293
1219 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."
1220 msgstr "Назив повезује документацију одељка са одговарајућим делом у датотеци <filename>&lt;package&gt;-sections.txt</filename>. Овде дати назив треба да се поклапа са ознаком &lt;FILE&gt; у датотеци <filename>&lt;package&gt;-sections.txt</filename>."
1221
1222 #. (itstool) path: varlistentry/term
1223 #: C/index.docbook:1302
1224 msgid "@short_description"
1225 msgstr "@кратак_опис"
1226
1227 #. (itstool) path: listitem/para
1228 #: C/index.docbook:1304
1229 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."
1230 msgstr "Опис одељка у једном реду, који ће се касније појавити након веза у садржају и на врху странице одељка."
1231
1232 #. (itstool) path: varlistentry/term
1233 #: C/index.docbook:1311
1234 msgid "@title"
1235 msgstr "@наслов"
1236
1237 #. (itstool) path: listitem/para
1238 #: C/index.docbook:1313
1239 msgid "The section title defaults to &lt;name&gt; from the SECTION declaration. It can be overridden with the @title field."
1240 msgstr "Наслов одељка је подразумевано &lt;назив&gt; из декларације SECTION. Може се преписати пољем @title."
1241
1242 #. (itstool) path: varlistentry/term
1243 #: C/index.docbook:1320
1244 msgid "@section_id"
1245 msgstr "@ид_одељка"
1246
1247 #. (itstool) path: listitem/para
1248 #: C/index.docbook:1322
1249 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;."
1250 msgstr "Преписује употребу наслова као идентификатора одељка. За Г-објекте (GObjects) се &lt;title&gt; користи као ид_одељка (section_id), а за остале одељке то је &lt;MODULE&gt;-&lt;title&gt;."
1251
1252 #. (itstool) path: varlistentry/term
1253 #: C/index.docbook:1330
1254 msgid "@see_also"
1255 msgstr "@види_такође"
1256
1257 #. (itstool) path: listitem/para
1258 #: C/index.docbook:1332
1259 msgid "A list of symbols that are related to this section."
1260 msgstr "Списак симбола који су повезани са овим одељком."
1261
1262 #. (itstool) path: varlistentry/term
1263 #: C/index.docbook:1338
1264 msgid "@stability"
1265 msgstr "@стабилност"
1266
1267 #. (itstool) path: listitem/para
1268 #: C/index.docbook:1345
1269 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."
1270 msgstr "Стабилно — Намера стабилног прочеља је да омогући произвољним трећим странама да развијају програме за ова прочеља, да их објављују и да буду сигурни да ће радити на свим мањим издањима производа (након оног у којем је прочеље уведено, и унутар истог главног издања). Чак и код главног издања, очекује се да ће некомпатибилне измене бити ретке и да ће имати јака оправдања."
1271
1272 #. (itstool) path: listitem/para
1273 #: C/index.docbook:1357
1274 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."
1275 msgstr "Нестабилно — Нестабилна прочеља су експериментална или прелазна. Обично се користе да би се спољним програмерима омогућио рани приступ новој технологији или технологији која се брзо мења, или да би се пружило привремено решење за проблем за који се предвиђа општије решење. Не дају се никакве тврдње о изворној или бинарној компатибилности између два мања издања."
1276
1277 #. (itstool) path: listitem/para
1278 #: C/index.docbook:1369
1279 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."
1280 msgstr "Приватно — Прочеље које се може користити унутар самог Гномовог стека, али које није документовано за крајње кориснике. Такве функције треба користити само на наведене и документоване начине."
1281
1282 #. (itstool) path: listitem/para
1283 #: C/index.docbook:1378
1284 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."
1285 msgstr "Унутрашње — Прочеље које је унутрашње за модул и не захтева документацију за крајње кориснике. За функције које нису документоване претпоставља се да су унутрашње."
1286
1287 #. (itstool) path: listitem/para
1288 #: C/index.docbook:1340
1289 msgid "An informal description of the stability level this API has. We recommend the use of one of these terms: <_:itemizedlist-1/>"
1290 msgstr "Неформални опис нивоа стабилности који овај АПИ има. Препоручујемо употребу једног од ових термина: <_:itemizedlist-1/>"
1291
1292 #. (itstool) path: varlistentry/term
1293 #: C/index.docbook:1390
1294 msgid "@include"
1295 msgstr "@укључи"
1296
1297 #. (itstool) path: listitem/para
1298 #: C/index.docbook:1392
1299 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."
1300 msgstr "Датотеке <literal>#include</literal> које се приказују у сижеу одељка (списак раздвојен зарезима), што преписује општу вредност из <link linkend=\"metafiles_sections\">датотеке одељка</link> или линије наредби. Ова ставка је опциона."
1301
1302 #. (itstool) path: varlistentry/term
1303 #: C/index.docbook:1401
1304 msgid "@image"
1305 msgstr "@слика"
1306
1307 #. (itstool) path: listitem/para
1308 #: C/index.docbook:1403
1309 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."
1310 msgstr "Слика која се приказује на врху референтне странице за овај одељак. Ово ће често бити нека врста дијаграма који илуструје визуелни изглед класе или дијаграм њеног односа са другим класама. Ова ставка је опциона."
1311
1312 #. (itstool) path: tip/para
1313 #: C/index.docbook:1414
1314 msgid "To avoid unnecessary recompilation after doc-changes put the section docs into the c-source where possible."
1315 msgstr "Да бисте избегли непотребно поновно превођење након измена у документацији, ставите документацију одељака у Ц изворни код где год је то могуће."
1316
1317 #. (itstool) path: sect1/title
1318 #: C/index.docbook:1423
1319 msgid "Documenting symbols"
1320 msgstr "Документовање симбола"
1321
1322 #. (itstool) path: sect1/para
1323 #: C/index.docbook:1425
1324 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."
1325 msgstr "Сваки симбол (функција, макро, структура, набрајање, сигнал и својство) је документован у засебном блоку. Блок је најбоље поставити близу дефиниције симбола како би се лако одржавали усклађеним. Тако се функције обично документују у Ц изворном коду, а макрои, структуре и набрајања у датотеци заглавља."
1326
1327 #. (itstool) path: sect2/title
1328 #. (itstool) path: example/title
1329 #: C/index.docbook:1433 C/index.docbook:1499
1330 msgid "General tags"
1331 msgstr "Опште ознаке"
1332
1333 #. (itstool) path: sect2/para
1334 #: C/index.docbook:1435
1335 msgid "You can add versioning information to all documentation elements to tell when an API was introduced, or when it was deprecated."
1336 msgstr "Можете додати податке о верзионисању свим елементима документације како бисте назначили када је АПИ уведен или када је постао застарео."
1337
1338 #. (itstool) path: variablelist/title
1339 #: C/index.docbook:1440
1340 msgid "Versioning Tags"
1341 msgstr "Ознаке верзионисања"
1342
1343 #. (itstool) path: varlistentry/term
1344 #: C/index.docbook:1441
1345 msgid "Since:"
1346 msgstr "Од:"
1347
1348 #. (itstool) path: listitem/para
1349 #: C/index.docbook:1443
1350 msgid "Description since which version of the code the API is available."
1351 msgstr "Опис од ког издања кода је АПИ доступан."
1352
1353 #. (itstool) path: varlistentry/term
1354 #: C/index.docbook:1448
1355 msgid "Deprecated:"
1356 msgstr "Застарело:"
1357
1358 #. (itstool) path: listitem/para
1359 #: C/index.docbook:1450
1360 msgid "Paragraph denoting that this function should no be used anymore. The description should point the reader to the new API."
1361 msgstr "Пасус који означава да ову функцију више не би требало користити. Опис би требало да упути читаоца на нови АПИ."
1362
1363 #. (itstool) path: sect2/para
1364 #: C/index.docbook:1458
1365 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."
1366 msgstr "Такође можете додати податке о стабилности свим елементима документације како бисте назначили да ли је стабилност АПИ-ја загарантована за њих за сва будућа мања издања пројекта."
1367
1368 #. (itstool) path: sect2/para
1369 #: C/index.docbook:1464
1370 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."
1371 msgstr "Подразумевани ниво стабилности за све елементе документације може се поставити прослеђивањем аргумента <option>--default-stability</option> програму <application>gtkdoc-mkdb</application> са једном од вредности испод."
1372
1373 #. (itstool) path: variablelist/title
1374 #: C/index.docbook:1470
1375 msgid "Stability Tags"
1376 msgstr "Ознаке стабилности"
1377
1378 #. (itstool) path: varlistentry/term
1379 #: C/index.docbook:1471
1380 msgid "Stability: Stable"
1381 msgstr "Стабилност: Стабилно"
1382
1383 #. (itstool) path: listitem/para
1384 #: C/index.docbook:1473
1385 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."
1386 msgstr "Означите елемент као стабилан. Ово је за јавне АПИ-је за које је загарантовано да ће остати стабилни за сва будућа мања издања пројекта."
1387
1388 #. (itstool) path: varlistentry/term
1389 #: C/index.docbook:1480
1390 msgid "Stability: Unstable"
1391 msgstr "Стабилност: Нестабилно"
1392
1393 #. (itstool) path: listitem/para
1394 #: C/index.docbook:1482
1395 msgid "Mark the element as unstable. This is for public APIs which are released as a preview before being stabilised."
1396 msgstr "Означите елемент као нестабилан. Ово је за јавне АПИ-је који су објављени као преглед пре него што буду стабилизовани."
1397
1398 #. (itstool) path: varlistentry/term
1399 #: C/index.docbook:1488
1400 msgid "Stability: Private"
1401 msgstr "Стабилност: Приватно"
1402
1403 #. (itstool) path: listitem/para
1404 #: C/index.docbook:1490
1405 msgid "Mark the element as private. This is for interfaces which can be used by tightly coupled modules, but not by arbitrary third parties."
1406 msgstr "Означите елемент као приватан. Ово је за прочеља која могу користити тесно повезани модули, али не и произвољна трећа лица."
1407
1408 #. (itstool) path: example/programlisting
1409 #: C/index.docbook:1500
1410 #, no-wrap
1411 msgid ""
1412 "\n"
1413 "/**\n"
1414 " * foo_get_bar:\n"
1415 " * @foo: some foo\n"
1416 " *\n"
1417 " * Retrieves @foo's bar.\n"
1418 " *\n"
1419 " * Returns: @foo's bar\n"
1420 " *\n"
1421 " * Since: 2.6\n"
1422 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
1423 " */\n"
1424 "Bar *\n"
1425 "foo_get_bar(Foo *foo)\n"
1426 "{\n"
1427 "...\n"
1428 msgstr ""
1429 "\n"
1430 "/**\n"
1431 " * foo_get_bar:\n"
1432 " * @foo: неки foo\n"
1433 " *\n"
1434 " * Добавља @foo-ов bar.\n"
1435 " *\n"
1436 " * Враћа: @foo-ов bar\n"
1437 " *\n"
1438 " * Од: 2.6\n"
1439 " * Застарело: 2.12: Користите foo_baz_get_bar() уместо овога.\n"
1440 " */\n"
1441 "Bar *\n"
1442 "foo_get_bar(Foo *foo)\n"
1443 "{\n"
1444 "...\n"
1445
1446 #. (itstool) path: sect2/title
1447 #. (itstool) path: example/title
1448 #: C/index.docbook:1520 C/index.docbook:1530
1449 msgid "Annotations"
1450 msgstr "Забелешке"
1451
1452 #. (itstool) path: sect2/para
1453 #: C/index.docbook:1522
1454 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 in the <ulink url=\"https://gi.readthedocs.io/en/latest/annotations/giannotations.html\" type=\"http\">GObject Introspection documentation</ulink>."
1455 msgstr "Блокови документације могу да садрже ознаке забелешки. Ове ознаке ће бити исцртане са облачићима који описују њихово значење. Ознаке користи Гобјект испитивање (GObject Introspection) за стварање везивања за језике. Детаљан списак подржаних ознака можете пронаћи у <ulink url=\"https://gi.readthedocs.io/en/latest/annotations/giannotations.html\" type=\"http\">документацији Гобјект испитивања</ulink>."
1456
1457 #. (itstool) path: example/programlisting
1458 #: C/index.docbook:1531
1459 #, no-wrap
1460 msgid ""
1461 "\n"
1462 "/**\n"
1463 " * foo_get_bar: (annotation)\n"
1464 " * @foo: (annotation): some foo\n"
1465 " *\n"
1466 " * Retrieves @foo's bar.\n"
1467 " *\n"
1468 " * Returns: (annotation): @foo's bar\n"
1469 " */\n"
1470 "...\n"
1471 "/**\n"
1472 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
1473 " * (and another annotation)\n"
1474 " * @foo: (annotation) (another annotation): some foo\n"
1475 " *\n"
1476 " * Sets bar on @foo.\n"
1477 " */\n"
1478 msgstr ""
1479 "\n"
1480 "/**\n"
1481 " * foo_get_bar: (annotation)\n"
1482 " * @foo: (annotation): some foo\n"
1483 " *\n"
1484 " * Retrieves @foo's bar.\n"
1485 " *\n"
1486 " * Returns: (annotation): @foo's bar\n"
1487 " */\n"
1488 "...\n"
1489 "/**\n"
1490 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
1491 " * (and another annotation)\n"
1492 " * @foo: (annotation) (another annotation): some foo\n"
1493 " *\n"
1494 " * Sets bar on @foo.\n"
1495 " */\n"
1496
1497 #. (itstool) path: sect2/title
1498 #. (itstool) path: example/title
1499 #: C/index.docbook:1552 C/index.docbook:1581
1500 msgid "Function comment block"
1501 msgstr "Блок коментара функције"
1502
1503 #. (itstool) path: listitem/para
1504 #: C/index.docbook:1558
1505 msgid "Document whether returned objects, lists, strings, etc, should be freed/unrefed/released."
1506 msgstr "Документујте да ли враћени објекти, спискови, ниске, итд, треба да буду ослобођени/отпуштени."
1507
1508 #. (itstool) path: listitem/para
1509 #: C/index.docbook:1564
1510 msgid "Document whether parameters can be NULL, and what happens if they are."
1511 msgstr "Документујте да ли параметри могу бити NULL, и шта се дешава ако јесу."
1512
1513 #. (itstool) path: listitem/para
1514 #: C/index.docbook:1569
1515 msgid "Mention interesting pre-conditions and post-conditions where appropriate."
1516 msgstr "Спомените занимљиве предуслове и постуслове где је то прикладно."
1517
1518 #. (itstool) path: sect2/para
1519 #: C/index.docbook:1554 C/index.docbook:1640
1520 msgid "Please remember to: <_:itemizedlist-1/>"
1521 msgstr "Запамтите да: <_:itemizedlist-1/>"
1522
1523 #. (itstool) path: sect2/para
1524 #: C/index.docbook:1576
1525 msgid "Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. They are treated like static functions."
1526 msgstr "Гтк-док претпоставља да су сви симболи (макрои, функције) који почињу са „_“ приватни. Они се третирају као статичке функције."
1527
1528 #. (itstool) path: example/programlisting
1529 #: C/index.docbook:1582
1530 #, no-wrap
1531 msgid ""
1532 "\n"
1533 "/**\n"
1534 " * function_name:\n"
1535 " * @par1: description of parameter 1. These can extend over more than\n"
1536 " * one line.\n"
1537 " * @par2: description of parameter 2\n"
1538 " * @...: a %NULL-terminated list of bars\n"
1539 " *\n"
1540 " * The function description goes here. You can use @par1 to refer to parameters\n"
1541 " * so that they are highlighted in the output. You can also use %constant\n"
1542 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
1543 " * other declarations (which may be documented elsewhere).\n"
1544 " *\n"
1545 " * Returns: an integer.\n"
1546 " *\n"
1547 " * Since: 2.2\n"
1548 " * Deprecated: 2.18: Use other_function() instead.\n"
1549 " */\n"
1550 msgstr ""
1551 "\n"
1552 "/**\n"
1553 " * function_name:\n"
1554 " * @par1: description of parameter 1. These can extend over more than\n"
1555 " * one line.\n"
1556 " * @par2: description of parameter 2\n"
1557 " * @...: a %NULL-terminated list of bars\n"
1558 " *\n"
1559 " * The function description goes here. You can use @par1 to refer to parameters\n"
1560 " * so that they are highlighted in the output. You can also use %constant\n"
1561 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
1562 " * other declarations (which may be documented elsewhere).\n"
1563 " *\n"
1564 " * Returns: an integer.\n"
1565 " *\n"
1566 " * Since: 2.2\n"
1567 " * Deprecated: 2.18: Use other_function() instead.\n"
1568 " */\n"
1569
1570 #. (itstool) path: variablelist/title
1571 #: C/index.docbook:1603
1572 msgid "Function tags"
1573 msgstr "Ознаке функције"
1574
1575 #. (itstool) path: varlistentry/term
1576 #: C/index.docbook:1604 C/index.docbook:1811
1577 msgid "Returns:"
1578 msgstr "Враћа:"
1579
1580 #. (itstool) path: listitem/para
1581 #: C/index.docbook:1606
1582 msgid "Paragraph describing the returned result."
1583 msgstr "Пасус који описује враћени резултат."
1584
1585 #. (itstool) path: varlistentry/term
1586 #: C/index.docbook:1611
1587 msgid "@...:"
1588 msgstr "@...:"
1589
1590 #. (itstool) path: listitem/para
1591 #: C/index.docbook:1613
1592 msgid "In case the function has variadic arguments, you should use this tag (@Varargs: does also work for historic reasons)."
1593 msgstr "У случају да функција има варијабилне аргументе, треба да користите ову ознаку (@Varargs: такође ради из историјских разлога)."
1594
1595 #. (itstool) path: sect2/title
1596 #. (itstool) path: example/title
1597 #: C/index.docbook:1623 C/index.docbook:1625
1598 msgid "Property comment block"
1599 msgstr "Блок коментара својства"
1600
1601 #. (itstool) path: example/programlisting
1602 #: C/index.docbook:1626
1603 #, no-wrap
1604 msgid ""
1605 "\n"
1606 "/**\n"
1607 " * SomeWidget:some-property:\n"
1608 " *\n"
1609 " * Here you can document a property.\n"
1610 " */\n"
1611 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
1612 msgstr ""
1613 "\n"
1614 "/**\n"
1615 " * SomeWidget:some-property:\n"
1616 " *\n"
1617 " * Here you can document a property.\n"
1618 " */\n"
1619 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
1620
1621 #. (itstool) path: sect2/title
1622 #. (itstool) path: example/title
1623 #: C/index.docbook:1638 C/index.docbook:1657
1624 msgid "Signal comment block"
1625 msgstr "Блок коментара сигнала"
1626
1627 #. (itstool) path: listitem/para
1628 #: C/index.docbook:1644
1629 msgid "Document when the signal is emitted and whether it is emitted before or after other signals."
1630 msgstr "Документујте када се сигнал емитује и да ли се емитује пре или после других сигнала."
1631
1632 #. (itstool) path: listitem/para
1633 #: C/index.docbook:1650
1634 msgid "Document what an application might do in the signal handler."
1635 msgstr "Документујте шта би апликација могла да уради у руковаоцу сигналом."
1636
1637 #. (itstool) path: example/programlisting
1638 #: C/index.docbook:1658
1639 #, no-wrap
1640 msgid ""
1641 "\n"
1642 "/**\n"
1643 " * FooWidget::foobarized:\n"
1644 " * @widget: the widget that received the signal\n"
1645 " * @foo: some foo\n"
1646 " * @bar: some bar\n"
1647 " *\n"
1648 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
1649 " */\n"
1650 "foo_signals[FOOBARIZED] =\n"
1651 " g_signal_new (\"foobarized\",\n"
1652 " ...\n"
1653 msgstr ""
1654 "\n"
1655 "/**\n"
1656 " * FooWidget::foobarized:\n"
1657 " * @widget: the widget that received the signal\n"
1658 " * @foo: some foo\n"
1659 " * @bar: some bar\n"
1660 " *\n"
1661 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
1662 " */\n"
1663 "foo_signals[FOOBARIZED] =\n"
1664 " g_signal_new (\"foobarized\",\n"
1665 " ...\n"
1666
1667 #. (itstool) path: sect2/title
1668 #. (itstool) path: example/title
1669 #: C/index.docbook:1675 C/index.docbook:1676
1670 msgid "Struct comment block"
1671 msgstr "Блок примедбе структуре"
1672
1673 #. (itstool) path: example/programlisting
1674 #: C/index.docbook:1677
1675 #, no-wrap
1676 msgid ""
1677 "\n"
1678 "/**\n"
1679 " * FooWidget:\n"
1680 " * @bar: some #gboolean\n"
1681 " *\n"
1682 " * This is the best widget, ever.\n"
1683 " */\n"
1684 "typedef struct _FooWidget {\n"
1685 " GtkWidget parent_instance;\n"
1686 "\n"
1687 " gboolean bar;\n"
1688 "} FooWidget;\n"
1689 msgstr ""
1690 "\n"
1691 "/**\n"
1692 " * FooWidget:\n"
1693 " * @bar: неки #gboolean\n"
1694 " *\n"
1695 " * Ово је најбољи елемент, икада.\n"
1696 " */\n"
1697 "typedef struct _FooWidget {\n"
1698 " GtkWidget parent_instance;\n"
1699 "\n"
1700 " gboolean bar;\n"
1701 "} FooWidget;\n"
1702
1703 #. (itstool) path: sect2/para
1704 #: C/index.docbook:1692
1705 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."
1706 msgstr "Користите <code>/*&lt; private &gt;*/</code> пре приватних поља структуре која желите да сакријете. Користите <code>/*&lt; public &gt;*/</code> за обрнуто понашање."
1707
1708 #. (itstool) path: sect2/para
1709 #: C/index.docbook:1698
1710 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."
1711 msgstr "Ако је прво поље „g_iface“, „parent_instance“ или „parent_class“, оно ће се сматрати приватним аутоматски и не мора се наводити у блоку примедбе."
1712
1713 #. (itstool) path: sect2/para
1714 #: C/index.docbook:1704
1715 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)."
1716 msgstr "Блокови примедби структуре се такође могу користити за Г-објекте и Г-класе објеката. Обично је добра идеја додати блок примедбе за класу, ако има в-методе (јер се тако могу документовати). За сам Г-објекат може се користити документација повезаног одељка, а посебан блок за саму инстанцу структуре би био користан ако инстанца има јавна поља. Једна мана овде је што ово ствара два уноса индекса истог назива (структура и одељак)."
1717
1718 #. (itstool) path: sect2/title
1719 #. (itstool) path: example/title
1720 #: C/index.docbook:1716 C/index.docbook:1717
1721 msgid "Enum comment block"
1722 msgstr "Блок примедбе набрајања"
1723
1724 #. (itstool) path: example/programlisting
1725 #: C/index.docbook:1718
1726 #, no-wrap
1727 msgid ""
1728 "\n"
1729 "/**\n"
1730 " * Something:\n"
1731 " * @SOMETHING_FOO: something foo\n"
1732 " * @SOMETHING_BAR: something bar\n"
1733 " *\n"
1734 " * Enum values used for the thing, to specify the thing.\n"
1735 " */\n"
1736 "typedef enum {\n"
1737 " SOMETHING_FOO,\n"
1738 " SOMETHING_BAR,\n"
1739 " /*&lt; private &gt;*/\n"
1740 " SOMETHING_COUNT\n"
1741 "} Something;\n"
1742 msgstr ""
1743 "\n"
1744 "/**\n"
1745 " * Something:\n"
1746 " * @SOMETHING_FOO: нешто foo\n"
1747 " * @SOMETHING_BAR: нешто bar\n"
1748 " *\n"
1749 " * Вредности набрајања које се користе за ствар, да би се навела ствар.\n"
1750 " */\n"
1751 "typedef enum {\n"
1752 " SOMETHING_FOO,\n"
1753 " SOMETHING_BAR,\n"
1754 " /*&lt; private &gt;*/\n"
1755 " SOMETHING_COUNT\n"
1756 "} Something;\n"
1757
1758 #. (itstool) path: sect2/para
1759 #: C/index.docbook:1735
1760 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."
1761 msgstr "Користите <code>/*&lt; private &gt;*/</code> пре приватних вредности набрајања које желите да сакријете. Користите <code>/*&lt; public &gt;*/</code> за обрнуто понашање."
1762
1763 #. (itstool) path: sect1/title
1764 #: C/index.docbook:1746
1765 msgid "Inline program documentation"
1766 msgstr "Унутрашња документација програма"
1767
1768 #. (itstool) path: sect1/para
1769 #: C/index.docbook:1747
1770 msgid "You can document programs and their commandline interface using inline documentation."
1771 msgstr "Можете документовати програме и њихово прочеље линије наредби користећи унутрашњу документацију."
1772
1773 #. (itstool) path: variablelist/title
1774 #: C/index.docbook:1753
1775 msgid "Tags"
1776 msgstr "Ознаке"
1777
1778 #. (itstool) path: varlistentry/term
1779 #: C/index.docbook:1755
1780 msgid "PROGRAM"
1781 msgstr "ПРОГРАМ"
1782
1783 #. (itstool) path: listitem/para
1784 #: C/index.docbook:1758
1785 msgid "Defines the start of a program documentation."
1786 msgstr "Дефинише почетак документације програма."
1787
1788 #. (itstool) path: varlistentry/term
1789 #: C/index.docbook:1765
1790 msgid "@short_description:"
1791 msgstr "@short_description:"
1792
1793 #. (itstool) path: listitem/para
1794 #: C/index.docbook:1767
1795 msgid "Defines a short description of the program. (Optional)"
1796 msgstr "Дефинише кратак опис програма. (Опционо)"
1797
1798 #. (itstool) path: varlistentry/term
1799 #: C/index.docbook:1774
1800 msgid "@synopsis:"
1801 msgstr "@synopsis:"
1802
1803 #. (itstool) path: listitem/para
1804 #: C/index.docbook:1776
1805 msgid "Defines the arguments, or list of arguments that the program can take. (Optional)"
1806 msgstr "Дефинише аргументе, или списак аргумената које програм може да прими. (Опционо)"
1807
1808 #. (itstool) path: varlistentry/term
1809 #: C/index.docbook:1784
1810 msgid "@see_also:"
1811 msgstr "@see_also:"
1812
1813 #. (itstool) path: listitem/para
1814 #: C/index.docbook:1786
1815 msgid "See Also manual page section. (Optional)"
1816 msgstr "Одељак „Такође погледајте“ страница упутства. (Опционо)"
1817
1818 #. (itstool) path: varlistentry/term
1819 #: C/index.docbook:1793
1820 msgid "@arg:"
1821 msgstr "@arg:"
1822
1823 #. (itstool) path: listitem/para
1824 #: C/index.docbook:1795
1825 msgid "Argument(s) passed to the program and their description. (Optional)"
1826 msgstr "Аргумент(и) прослеђени програму и њихов опис. (Опционо)"
1827
1828 #. (itstool) path: varlistentry/term
1829 #: C/index.docbook:1802
1830 msgid "Description:"
1831 msgstr "Опис:"
1832
1833 #. (itstool) path: listitem/para
1834 #: C/index.docbook:1804
1835 msgid "A longer description of the program."
1836 msgstr "Дужи опис програма."
1837
1838 #. (itstool) path: listitem/para
1839 #: C/index.docbook:1813
1840 msgid "Specify what value(s) the program returns. (Optional)"
1841 msgstr "Наведите вредност(и) коју програм враћа. (Опционо)"
1842
1843 #. (itstool) path: sect2/title
1844 #: C/index.docbook:1822
1845 msgid "Example of program documentation."
1846 msgstr "Пример документације програма."
1847
1848 #. (itstool) path: example/title
1849 #: C/index.docbook:1823
1850 msgid "Program documentation block"
1851 msgstr "Блок документације програма"
1852
1853 #. (itstool) path: example/programlisting
1854 #: C/index.docbook:1824
1855 #, no-wrap
1856 msgid ""
1857 "\n"
1858 "/**\n"
1859 " * PROGRAM:test-program\n"
1860 " * @short_description: A test program\n"
1861 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
1862 " * @see_also: test(1)\n"
1863 " * @--arg1 *arg*: set arg1 to *arg*\n"
1864 " * @--arg2 *arg*: set arg2 to *arg*\n"
1865 " * @-v, --version: Print the version number\n"
1866 " * @-h, --help: Print the help message\n"
1867 " *\n"
1868 " * Long description of program.\n"
1869 " *\n"
1870 " * Returns: Zero on success, non-zero on failure\n"
1871 " */\n"
1872 "int main(int argc, char *argv[])\n"
1873 "{\n"
1874 "\treturn 0;\n"
1875 "}\n"
1876 msgstr ""
1877 "\n"
1878 "/**\n"
1879 " * PROGRAM:test-program\n"
1880 " * @short_description: Тест програм\n"
1881 " * @synopsis: test-program [*ОПЦИЈЕ*...] --arg1 *арг* *ДАТОТЕКА*\n"
1882 " * @see_also: test(1)\n"
1883 " * @--arg1 *арг*: постави арг1 на *арг*\n"
1884 " * @--arg2 *арг*: постави арг2 на *арг*\n"
1885 " * @-v, --version: Штампај број издања\n"
1886 " * @-h, --help: Штампај поруку помоћи\n"
1887 " *\n"
1888 " * Дуги опис програма.\n"
1889 " *\n"
1890 " * Returns: Нула у случају успеха, не-нула у случају неуспеха\n"
1891 " */\n"
1892 "int main(int argc, char *argv[])\n"
1893 "{\n"
1894 "\treturn 0;\n"
1895 "}\n"
1896
1897 #. (itstool) path: sect1/title
1898 #: C/index.docbook:1850
1899 msgid "Useful DocBook tags"
1900 msgstr "Корисне ДокБук ознаке"
1901
1902 #. (itstool) path: sect1/para
1903 #: C/index.docbook:1852
1904 msgid "Here are some DocBook tags which are most useful when documenting the code."
1905 msgstr "Ево неких ДокБук ознака које су најкорисније приликом документовања кода."
1906
1907 #. (itstool) path: informalexample/programlisting
1908 #: C/index.docbook:1861
1909 #, no-wrap
1910 msgid ""
1911 "\n"
1912 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
1913 msgstr ""
1914 "\n"
1915 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Хеш табеле&lt;/link&gt;\n"
1916
1917 #. (itstool) path: sect1/para
1918 #: C/index.docbook:1857
1919 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."
1920 msgstr "За повезивање са другим одељком у ГТК документацији: <_:informalexample-1/> „linkend“ је СГМЛ/ИксМЛ ид на горњој ставци странице са којом желите да се повежете. За већину страница ово је тренутно део („gtk“, „gdk“, „glib“), а затим наслов странице („Хеш табеле“). За елементе то је само назив класе. Размаци и доње црте се претварају у „-“ да би били у складу са СГМЛ/ИксМЛ-ом."
1921
1922 #. (itstool) path: informalexample/programlisting
1923 #: C/index.docbook:1874
1924 #, no-wrap
1925 msgid ""
1926 "\n"
1927 "&lt;function&gt;...&lt;/function&gt;\n"
1928 msgstr ""
1929 "\n"
1930 "&lt;function&gt;...&lt;/function&gt;\n"
1931
1932 #. (itstool) path: sect1/para
1933 #: C/index.docbook:1871
1934 msgid "To refer to an external function, e.g. a standard C function: <_:informalexample-1/>"
1935 msgstr "За упућивање на спољну функцију, нпр. стандардну Ц функцију: <_:informalexample-1/>"
1936
1937 #. (itstool) path: informalexample/programlisting
1938 #: C/index.docbook:1883
1939 #, no-wrap
1940 msgid ""
1941 "\n"
1942 "&lt;example&gt;\n"
1943 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
1944 " &lt;programlisting language=\"C\"&gt;\n"
1945 " ...\n"
1946 " &lt;/programlisting&gt;\n"
1947 "&lt;/example&gt;\n"
1948 msgstr ""
1949 "\n"
1950 "&lt;example&gt;\n"
1951 " &lt;title&gt;Коришћење ГХешТабеле.&lt;/title&gt;\n"
1952 " &lt;programlisting language=\"C\"&gt;\n"
1953 " ...\n"
1954 " &lt;/programlisting&gt;\n"
1955 "&lt;/example&gt;\n"
1956
1957 #. (itstool) path: informalexample/programlisting
1958 #: C/index.docbook:1894
1959 #, no-wrap
1960 msgid ""
1961 "\n"
1962 "&lt;informalexample&gt;\n"
1963 " &lt;programlisting language=\"C\"&gt;\n"
1964 " ...\n"
1965 " &lt;/programlisting&gt;\n"
1966 "&lt;/informalexample&gt;\n"
1967 msgstr ""
1968 "\n"
1969 "&lt;informalexample&gt;\n"
1970 " &lt;programlisting language=\"C\"&gt;\n"
1971 " ...\n"
1972 " &lt;/programlisting&gt;\n"
1973 "&lt;/informalexample&gt;\n"
1974
1975 #. (itstool) path: informalexample/programlisting
1976 #: C/index.docbook:1906
1977 #, no-wrap
1978 msgid ""
1979 "\n"
1980 "|[&lt;!-- language=\"C\" --&gt;\n"
1981 " ...\n"
1982 "]|\n"
1983 msgstr ""
1984 "\n"
1985 "|[&lt;!-- language=\"C\" --&gt;\n"
1986 " ...\n"
1987 "]|\n"
1988
1989 #. (itstool) path: sect1/para
1990 #: C/index.docbook:1880
1991 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/>"
1992 msgstr "За укључивање примера кода: <_:informalexample-1/> или можда ово, за веома кратке делове кода којима није потребан наслов: <_:informalexample-2/> У оба случаја, атрибут језика је опционо и користи се као савет покретачу за истицање синтаксе (pygments за хтмл излаз). За ово друго ГТК-Док такође подржава скраћеницу: <_:informalexample-3/>"
1993
1994 #. (itstool) path: informalexample/programlisting
1995 #: C/index.docbook:1917
1996 #, no-wrap
1997 msgid ""
1998 "\n"
1999 "&lt;itemizedlist&gt;\n"
2000 " &lt;listitem&gt;\n"
2001 " &lt;para&gt;\n"
2002 " ...\n"
2003 " &lt;/para&gt;\n"
2004 " &lt;/listitem&gt;\n"
2005 " &lt;listitem&gt;\n"
2006 " &lt;para&gt;\n"
2007 " ...\n"
2008 " &lt;/para&gt;\n"
2009 " &lt;/listitem&gt;\n"
2010 "&lt;/itemizedlist&gt;\n"
2011 msgstr ""
2012 "\n"
2013 "&lt;itemizedlist&gt;\n"
2014 " &lt;listitem&gt;\n"
2015 " &lt;para&gt;\n"
2016 " ...\n"
2017 " &lt;/para&gt;\n"
2018 " &lt;/listitem&gt;\n"
2019 " &lt;listitem&gt;\n"
2020 " &lt;para&gt;\n"
2021 " ...\n"
2022 " &lt;/para&gt;\n"
2023 " &lt;/listitem&gt;\n"
2024 "&lt;/itemizedlist&gt;\n"
2025
2026 #. (itstool) path: sect1/para
2027 #: C/index.docbook:1914
2028 msgid "To include bulleted lists: <_:informalexample-1/>"
2029 msgstr "За укључивање спискова са набрајањем: <_:informalexample-1/>"
2030
2031 #. (itstool) path: informalexample/programlisting
2032 #: C/index.docbook:1937
2033 #, no-wrap
2034 msgid ""
2035 "\n"
2036 "&lt;note&gt;\n"
2037 " &lt;para&gt;\n"
2038 " Make sure you free the data after use.\n"
2039 " &lt;/para&gt;\n"
2040 "&lt;/note&gt;\n"
2041 msgstr ""
2042 "\n"
2043 "&lt;note&gt;\n"
2044 " &lt;para&gt;\n"
2045 " Обавезно ослободите податке након употребе.\n"
2046 " &lt;/para&gt;\n"
2047 "&lt;/note&gt;\n"
2048
2049 #. (itstool) path: sect1/para
2050 #: C/index.docbook:1934
2051 msgid "To include a note which stands out from the text: <_:informalexample-1/>"
2052 msgstr "За укључивање напомене која се издваја из текста: <_:informalexample-1/>"
2053
2054 #. (itstool) path: informalexample/programlisting
2055 #: C/index.docbook:1950
2056 #, no-wrap
2057 msgid ""
2058 "\n"
2059 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
2060 msgstr ""
2061 "\n"
2062 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
2063
2064 #. (itstool) path: sect1/para
2065 #: C/index.docbook:1947
2066 msgid "To refer to a type: <_:informalexample-1/>"
2067 msgstr "За упућивање на врсту: <_:informalexample-1/>"
2068
2069 #. (itstool) path: informalexample/programlisting
2070 #: C/index.docbook:1959
2071 #, no-wrap
2072 msgid ""
2073 "\n"
2074 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
2075 msgstr ""
2076 "\n"
2077 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
2078
2079 #. (itstool) path: sect1/para
2080 #: C/index.docbook:1956
2081 msgid "To refer to an external structure (not one described in the GTK docs): <_:informalexample-1/>"
2082 msgstr "За упућивање на спољну структуру (не ону описану у ГТК документацији): <_:informalexample-1/>"
2083
2084 #. (itstool) path: informalexample/programlisting
2085 #: C/index.docbook:1968
2086 #, no-wrap
2087 msgid ""
2088 "\n"
2089 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
2090 msgstr ""
2091 "\n"
2092 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
2093
2094 #. (itstool) path: sect1/para
2095 #: C/index.docbook:1965
2096 msgid "To refer to a field of a structure: <_:informalexample-1/>"
2097 msgstr "За упућивање на поље структуре: <_:informalexample-1/>"
2098
2099 #. (itstool) path: informalexample/programlisting
2100 #: C/index.docbook:1977
2101 #, no-wrap
2102 msgid ""
2103 "\n"
2104 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
2105 msgstr ""
2106 "\n"
2107 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
2108
2109 #. (itstool) path: sect1/para
2110 #: C/index.docbook:1974
2111 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>)."
2112 msgstr "За упућивање на назив класе, могли бисмо евентуално користити: <_:informalexample-1/> али ћете вероватно користити #GtkWidget уместо тога (за аутоматско прављење везе ка GtkWidget страници — погледајте <link linkend=\"documenting_syntax\">скраћенице</link>)."
2113
2114 #. (itstool) path: informalexample/programlisting
2115 #: C/index.docbook:1988
2116 #, no-wrap
2117 msgid ""
2118 "\n"
2119 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
2120 msgstr ""
2121 "\n"
2122 "&lt;emphasis&gt;Ово је важно&lt;/emphasis&gt;\n"
2123
2124 #. (itstool) path: sect1/para
2125 #: C/index.docbook:1985
2126 msgid "To emphasize text: <_:informalexample-1/>"
2127 msgstr "За истицање текста: <_:informalexample-1/>"
2128
2129 #. (itstool) path: informalexample/programlisting
2130 #: C/index.docbook:1997
2131 #, no-wrap
2132 msgid ""
2133 "\n"
2134 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
2135 msgstr ""
2136 "\n"
2137 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
2138
2139 #. (itstool) path: sect1/para
2140 #: C/index.docbook:1994
2141 msgid "For filenames use: <_:informalexample-1/>"
2142 msgstr "За називе датотека користите: <_:informalexample-1/>"
2143
2144 #. (itstool) path: informalexample/programlisting
2145 #: C/index.docbook:2006
2146 #, no-wrap
2147 msgid ""
2148 "\n"
2149 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
2150 msgstr ""
2151 "\n"
2152 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
2153
2154 #. (itstool) path: sect1/para
2155 #: C/index.docbook:2003
2156 msgid "To refer to keys use: <_:informalexample-1/>"
2157 msgstr "За упућивање на тастере користите: <_:informalexample-1/>"
2158
2159 #. (itstool) path: chapter/title
2160 #: C/index.docbook:2016
2161 msgid "Filling the extra files"
2162 msgstr "Попуњавање додатних датотека"
2163
2164 #. (itstool) path: chapter/para
2165 #: C/index.docbook:2018
2166 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>."
2167 msgstr "Постоји неколико додатних датотека које треба одржавати заједно са напоменама у изворном коду: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (раније .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
2168
2169 #. (itstool) path: sect1/title
2170 #: C/index.docbook:2027
2171 msgid "Editing the types file"
2172 msgstr "Уређивање датотеке врста"
2173
2174 #. (itstool) path: sect1/para
2175 #: C/index.docbook:2029
2176 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."
2177 msgstr "Ако ваша библиотека или програм укључује GObjects, желите да њихови сигнали, аргументи/параметри и положај у хијерархији буду приказани у документацији. Све што треба да урадите јесте да наведете <function>xxx_get_type</function> функције заједно са њиховим укључивањем унутар <filename>&lt;package&gt;.types</filename> датотеке."
2178
2179 #. (itstool) path: example/title
2180 #: C/index.docbook:2038
2181 msgid "Example &lt;package&gt;.types file"
2182 msgstr "Пример &lt;package&gt;.types датотеке"
2183
2184 #. (itstool) path: example/programlisting
2185 #: C/index.docbook:2039
2186 #, no-wrap
2187 msgid ""
2188 "\n"
2189 "#include &lt;gtk/gtk.h&gt;\n"
2190 "\n"
2191 "gtk_accel_label_get_type\n"
2192 "gtk_adjustment_get_type\n"
2193 "gtk_alignment_get_type\n"
2194 "gtk_arrow_get_type\n"
2195 msgstr ""
2196 "\n"
2197 "#include &lt;gtk/gtk.h&gt;\n"
2198 "\n"
2199 "gtk_accel_label_get_type\n"
2200 "gtk_adjustment_get_type\n"
2201 "gtk_alignment_get_type\n"
2202 "gtk_arrow_get_type\n"
2203
2204 #. (itstool) path: sect1/para
2205 #: C/index.docbook:2050
2206 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."
2207 msgstr "Од ГТК-Дока 1.8 <application>gtkdoc-scan</application> може направити овај списак за вас. Само додајте „--rebuild-types“ у SCAN_OPTIONS у <filename>Makefile.am</filename>. Ако користите овај приступ, не би требало да дистрибуирате датотеку врста нити да је држите под управљањем верзијама."
2208
2209 #. (itstool) path: sect1/title
2210 #: C/index.docbook:2059
2211 msgid "Editing the master document"
2212 msgstr "Уређивање главног документа"
2213
2214 #. (itstool) path: sect1/para
2215 #: C/index.docbook:2061
2216 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."
2217 msgstr "GTK-Doc производи документацију у DocBook SGML/XML формату. Приликом обраде унутрашњих коментара изворног кода, GTK-Doc алати генеришу једну страницу документације по класи или модулу као засебну датотеку. Главни документ их укључује и поставља у одређени редослед."
2218
2219 #. (itstool) path: sect1/para
2220 #: C/index.docbook:2068
2221 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."
2222 msgstr "Иако GTK-Doc прави шаблон главног документа за вас, каснија покретања га неће поново мењати. То значи да можете слободно структурирати документацију. То укључује груписање страница и додавање додатних страница. GTK-Doc сада има пакет за тестирање, где се такође главни документ поново прави из почетка. Добра је идеја с времена на време погледати ово како бисте видели да ли су тамо уведене неке нове корисне ствари."
2223
2224 #. (itstool) path: tip/para
2225 #: C/index.docbook:2078
2226 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."
2227 msgstr "Не правите водиче као посебне документе. Само пишите додатна поглавља. Предност директног уграђивања водича за вашу библиотеку у API документацију је та што је лако повезати водич са документацијом симбола. Осим тога, веће су шансе да ће водич бити ажуриран заједно са библиотеком."
2228
2229 #. (itstool) path: sect1/para
2230 #: C/index.docbook:2087
2231 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."
2232 msgstr "Дакле, шта су ствари које треба променити унутар главног документа? За почетак, то је само мало. Тамо постоје неки чувари места (текст у квадратним заградама) о којима треба да се побринете."
2233
2234 #. (itstool) path: example/title
2235 #: C/index.docbook:2094
2236 msgid "Master document header"
2237 msgstr "Заглавље главног документа"
2238
2239 #. (itstool) path: example/programlisting
2240 #: C/index.docbook:2095
2241 #, no-wrap
2242 msgid ""
2243 "\n"
2244 "&lt;bookinfo&gt;\n"
2245 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
2246 " &lt;releaseinfo&gt;\n"
2247 " for MODULENAME [VERSION]\n"
2248 " The latest version of this documentation can be found on-line at\n"
2249 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
2250 " &lt;/releaseinfo&gt;\n"
2251 "&lt;/bookinfo&gt;\n"
2252 "\n"
2253 "&lt;chapter&gt;\n"
2254 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
2255 msgstr ""
2256 "\n"
2257 "&lt;bookinfo&gt;\n"
2258 " &lt;title&gt;Референтни приручник за MODULENAME&lt;/title&gt;\n"
2259 " &lt;releaseinfo&gt;\n"
2260 " за MODULENAME [VERSION]\n"
2261 " Најновије издање ове документације можете наћи на мрежи на\n"
2262 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
2263 " &lt;/releaseinfo&gt;\n"
2264 "&lt;/bookinfo&gt;\n"
2265 "\n"
2266 "&lt;chapter&gt;\n"
2267 " &lt;title&gt;[Овде уметните наслов]&lt;/title&gt;\n"
2268
2269 #. (itstool) path: sect1/para
2270 #: C/index.docbook:2111
2271 msgid "In addition a few option elements are created in commented form. You can review these and enable them as you like."
2272 msgstr "Поред тога, неколико елемената опција је направљено у облику коментара. Можете их прегледати и омогућити их како желите."
2273
2274 #. (itstool) path: example/title
2275 #: C/index.docbook:2117
2276 msgid "Optional part in the master document"
2277 msgstr "Опциони део у главном документу"
2278
2279 #. (itstool) path: example/programlisting
2280 #: C/index.docbook:2118
2281 #, no-wrap
2282 msgid ""
2283 "\n"
2284 " &lt;!-- enable this when you use gobject introspection annotations\n"
2285 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
2286 " --&gt;\n"
2287 msgstr ""
2288 "\n"
2289 " &lt;!-- омогућите ово када користите забелешке Гобјектног испитивања\n"
2290 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
2291 " --&gt;\n"
2292
2293 #. (itstool) path: sect1/para
2294 #: C/index.docbook:2126
2295 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."
2296 msgstr "На крају, потребно је да додате нови одељак кад год га уведете. Алат <link linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> ће вас подсетити на новогенерисане xml датотеке које још нису укључене у документацију."
2297
2298 #. (itstool) path: example/title
2299 #: C/index.docbook:2134 C/index.docbook:2169
2300 msgid "Including generated sections"
2301 msgstr "Укључивање генерисаних одељака"
2302
2303 #. (itstool) path: example/programlisting
2304 #: C/index.docbook:2135
2305 #, no-wrap
2306 msgid ""
2307 "\n"
2308 " &lt;chapter&gt;\n"
2309 " &lt;title&gt;my library&lt;/title&gt;\n"
2310 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
2311 " ...\n"
2312 msgstr ""
2313 "\n"
2314 " &lt;chapter&gt;\n"
2315 " &lt;title&gt;my library&lt;/title&gt;\n"
2316 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
2317 " ...\n"
2318
2319 #. (itstool) path: sect1/title
2320 #: C/index.docbook:2147
2321 msgid "Editing the section file"
2322 msgstr "Уређивање датотеке одељака"
2323
2324 #. (itstool) path: sect1/para
2325 #: C/index.docbook:2149
2326 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)."
2327 msgstr "Датотека одељака се користи за организовање излаза документације коју генерише GTK-Doc. Овде се наводи који симбол припада ком модулу или класи и контролише се видљивост (јавна или приватна)."
2328
2329 #. (itstool) path: sect1/para
2330 #: C/index.docbook:2155
2331 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."
2332 msgstr "Датотека одељака је обична текстуална датотека са ознакама које разграничавају одељке. Празни редови се занемарују, а редови који почињу са „#“ се третирају као коментари."
2333
2334 #. (itstool) path: note/para
2335 #: C/index.docbook:2162
2336 msgid "While the tags make the file look like xml, it is not. Please do not close tags like &lt;SUBSECTION&gt;."
2337 msgstr "Иако ознаке чине да датотека изгледа као xml, она то није. Молимо вас да не затварате ознаке као што је &lt;SUBSECTION&gt;."
2338
2339 #. (itstool) path: example/programlisting
2340 #: C/index.docbook:2170
2341 #, no-wrap
2342 msgid ""
2343 "\n"
2344 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
2345 "\n"
2346 "&lt;SECTION&gt;\n"
2347 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
2348 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
2349 "MeepApp\n"
2350 "&lt;SUBSECTION Standard&gt;\n"
2351 "MEEP_APP\n"
2352 "...\n"
2353 "MeepAppClass\n"
2354 "meep_app_get_type\n"
2355 "&lt;/SECTION&gt;\n"
2356 msgstr ""
2357 "\n"
2358 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
2359 "\n"
2360 "&lt;SECTION&gt;\n"
2361 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
2362 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
2363 "MeepApp\n"
2364 "&lt;SUBSECTION Standard&gt;\n"
2365 "MEEP_APP\n"
2366 "...\n"
2367 "MeepAppClass\n"
2368 "meep_app_get_type\n"
2369 "&lt;/SECTION&gt;\n"
2370
2371 #. (itstool) path: sect1/para
2372 #: C/index.docbook:2187
2373 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)."
2374 msgstr "Ознака &lt;FILE&gt; ... &lt;/FILE&gt; се користи за навођење назива датотеке, без икаквог суфикса. На пример, коришћење „&lt;FILE&gt;gnome-config&lt;/FILE&gt;“ ће довести до тога да декларације одељака буду исписане у датотеци шаблона <filename>tmpl/gnome-config.sgml</filename>, која ће бити претворена у DocBook XML датотеку <filename>xml/gnome-config.sgml</filename> или DocBook XML датотеку <filename>xml/gnome-config.xml</filename>. (Назив HTML датотеке се заснива на називу модула и наслову одељка, или за GObjects се заснива на називу класе GObjects претвореном у мала слова)."
2375
2376 #. (itstool) path: sect1/para
2377 #: C/index.docbook:2199
2378 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."
2379 msgstr "Ознака &lt;TITLE&gt; ... &lt;/TITLE&gt; се користи за навођење наслова одељка. Корисна је само пре него што се шаблони (ако се користе) иницијално направе, пошто наслов постављен у датотеци шаблона преписује овај. Такође, ако се користи коментар SECTION у изворима, ово је застарело."
2380
2381 #. (itstool) path: sect1/para
2382 #: C/index.docbook:2206
2383 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)."
2384 msgstr "Можете груписати ставке у одељку коришћењем ознаке &lt;SUBSECTION&gt;. Тренутно она исписује празну линију између пододељака у одељку сижеа. Такође можете користити &lt;SUBSECTION Standard&gt; за стандардне GObject декларације (нпр. функције као што је g_object_get_type и макрое као што су G_OBJECT(), G_IS_OBJECT() итд.). Тренутно су оне изостављене из документације. Такође можете користити &lt;SUBSECTION Private&gt; за приватне декларације које неће бити исписане (то је згодан начин да избегнете поруке упозорења о некоришћеним декларацијама). Ако ваша библиотека садржи приватне типове за које не желите да се појаве у хијерархији објеката и списку примењених или потребних прочеља, додајте их у пододељак Private. Да ли ћете поставити GObject и GObjectClass налик структурама у јавни или Standard одељак зависи од тога да ли имају јавне уносе (променљиве, виртуелне методе)."
2385
2386 #. (itstool) path: sect1/para
2387 #: C/index.docbook:2225
2388 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."
2389 msgstr "Такође можете користити &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; да наведете #include датотеке које су приказане у одељцима сижеа. Садржи списак #include датотека раздвојених зарезом, без угаоних заграда. Ако га поставите изван било ког одељка, он дејствује на све одељке до краја датотеке. Ако га поставите унутар одељка, примењује се само на тај одељак."
2390
2391 #. (itstool) path: chapter/title
2392 #: C/index.docbook:2239
2393 msgid "Controlling the result"
2394 msgstr "Управљање резултатом"
2395
2396 #. (itstool) path: chapter/para
2397 #: C/index.docbook:2241
2398 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."
2399 msgstr "Покретање ГТК-дока ствара датотеке извештаја унутар директоријума документације. Створене датотеке се зову: <filename>&lt;package&gt;-undocumented.txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> и <filename>&lt;package&gt;-unused.txt</filename>. Све су то обичне текстуалне датотеке које се могу лако прегледати и накнадно обрадити."
2400
2401 #. (itstool) path: chapter/para
2402 #: C/index.docbook:2250
2403 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."
2404 msgstr "Датотека <filename>&lt;package&gt;-undocumented.txt</filename> почиње са сажетком покривености документације. Испод су два одељка раздвојена празним линијама. Први одељак набраја недокументоване или непотпуне симболе. Други одељак чини исто за документацију одељака. Непотпуни уноси су они који имају документацију, али где је нпр. додат нови параметар."
2405
2406 #. (itstool) path: chapter/para
2407 #: C/index.docbook:2259
2408 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."
2409 msgstr "Датотека <filename>&lt;package&gt;-undeclared.txt</filename> набраја симболе наведене у <filename>&lt;package&gt;-sections.txt</filename> али који нису пронађени у изворима. Проверите да ли су уклоњени или им је назив погрешно написан."
2410
2411 #. (itstool) path: chapter/para
2412 #: C/index.docbook:2266
2413 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."
2414 msgstr "Датотека <filename>&lt;package&gt;-unused.txt</filename> набраја називе симбола за које је прегледач ГТК-дока пронашао документацију, али не зна где да је постави. То значи да симбол још увек није додат у датотеку <filename>&lt;package&gt;-sections.txt</filename>."
2415
2416 #. (itstool) path: tip/para
2417 #: C/index.docbook:2274
2418 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."
2419 msgstr "Омогућите или додајте линију <option>TESTS=$(GTKDOC_CHECK)</option> у Makefile.am. Ако је инсталиран барем ГТК-док 1.9, ово ће покренути провере исправности током покретања <command>make check</command>."
2420
2421 #. (itstool) path: chapter/para
2422 #: C/index.docbook:2281
2423 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."
2424 msgstr "Може се погледати и у датотеке које је створио прегледач изворног кода: <filename>&lt;package&gt;-decl-list.txt</filename> и <filename>&lt;package&gt;-decl.txt</filename>. Прва се може упоредити са датотеком одељака ако се она ручно одржава. Друга набраја све декларације из заглавља. Ако симбол недостаје, може се проверити да ли га ова датотека садржи."
2425
2426 #. (itstool) path: chapter/para
2427 #: C/index.docbook:2290
2428 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>."
2429 msgstr "Ако је пројекат заснован на Гобјекту, може се погледати и у датотеке које је створио прегледач објеката: <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> и <filename>&lt;package&gt;.signals.txt</filename>. Ако у било којој од њих недостају симболи, можете затражити од ГТК-дока да задржи међу-датотеку прегледача за даљу анализу, тако што ћете га покренути као <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
2430
2431 #. (itstool) path: chapter/title
2432 #: C/index.docbook:2305
2433 msgid "Modernizing the documentation"
2434 msgstr "Осавремењивање документације"
2435
2436 #. (itstool) path: chapter/para
2437 #: C/index.docbook:2307
2438 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."
2439 msgstr "ГТК-док постоји већ неко време. У овом одељку набрајамо нове могућности заједно са издањем од ког су доступне."
2440
2441 #. (itstool) path: sect1/title
2442 #: C/index.docbook:2313
2443 msgid "GTK-Doc 1.9"
2444 msgstr "ГТК-док 1.9"
2445
2446 #. (itstool) path: sect1/para
2447 #: C/index.docbook:2315
2448 msgid "When using xml instead of sgml, one can actually name the master document <filename>&lt;package&gt;-docs.xml</filename>."
2449 msgstr "Када се користи иксМЛ уместо СГМЛ-а, главни документ се заправо може именовати <filename>&lt;package&gt;-docs.xml</filename>."
2450
2451 #. (itstool) path: sect1/para
2452 #: C/index.docbook:2320
2453 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>."
2454 msgstr "Ово издање подржава <option>SCAN_OPTIONS=--rebuild-sections</option> у <filename>Makefile.am</filename>. Када је ово омогућено, <filename>&lt;package&gt;-sections.txt</filename> се самостално ствара и може се уклонити из система за управљање верзијама. Ово лепо ради само за пројекте који имају врло правилну структуру (нпр. сваки пар .{c,h} ће створити нови одељак). Ако се пројекат организује приближно томе, освежавање ручно одржаване датотеке одељака може бити једноставно као покретање <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>."
2455
2456 #. (itstool) path: sect1/para
2457 #: C/index.docbook:2331
2458 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."
2459 msgstr "Издање 1.8 је већ увело синтаксу за документовање одељака у изворима уместо у засебним датотекама под <filename class=\"directory\">tmpl</filename>. Ово издање додаје опције за пребацивање целог модула документације тако да уопште не користи додатни корак изградње „tmpl“, коришћењем <option>--flavour no-tmpl</option> у <filename>configure.ac</filename>. Ако немате <filename class=\"directory\">tmpl</filename> унешен у ваш систем за управљање верзијама и још нисте пребацили, само додајте заставицу у <filename>configure.ac</filename> и готови сте."
2460
2461 #. (itstool) path: sect1/title
2462 #: C/index.docbook:2343
2463 msgid "GTK-Doc 1.10"
2464 msgstr "ГТК-док 1.10"
2465
2466 #. (itstool) path: sect1/para
2467 #: C/index.docbook:2345
2468 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."
2469 msgstr "Ово издање подржава <option>SCAN_OPTIONS=--rebuild-types</option> у <filename>Makefile.am</filename>. Када је ово омогућено, <filename>&lt;package&gt;.types</filename> се самостално ствара и може се уклонити из система за управљање верзијама. Када користите ову могућност, важно је такође подесити <varname>IGNORE_HFILES</varname> у <filename>Makefile.am</filename> за код који се гради условно."
2470
2471 #. (itstool) path: sect1/title
2472 #: C/index.docbook:2356
2473 msgid "GTK-Doc 1.16"
2474 msgstr "ГТК-док 1.16"
2475
2476 #. (itstool) path: example/title
2477 #: C/index.docbook:2362
2478 msgid "Enable gtkdoc-check"
2479 msgstr "Омогући gtkdoc-check"
2480
2481 #. (itstool) path: example/programlisting
2482 #: C/index.docbook:2363
2483 #, no-wrap
2484 msgid ""
2485 "\n"
2486 "if ENABLE_GTK_DOC\n"
2487 "TESTS_ENVIRONMENT = \\\n"
2488 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
2489 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
2490 "TESTS = $(GTKDOC_CHECK)\n"
2491 "endif\n"
2492 msgstr ""
2493 "\n"
2494 "if ENABLE_GTK_DOC\n"
2495 "TESTS_ENVIRONMENT = \\\n"
2496 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
2497 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
2498 "TESTS = $(GTKDOC_CHECK)\n"
2499 "endif\n"
2500
2501 #. (itstool) path: sect1/para
2502 #: C/index.docbook:2358
2503 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/>"
2504 msgstr "Ово издање укључује нови алат под називом gtkdoc-check. Овај алат може да покрене скуп провера исправности ваше документације. Омогућава се додавањем ових линија на крај датотеке <filename>Makefile.am</filename>. <_:example-1/>"
2505
2506 #. (itstool) path: sect1/title
2507 #: C/index.docbook:2376
2508 msgid "GTK-Doc 1.20"
2509 msgstr "ГТК-Док 1.20"
2510
2511 #. (itstool) path: sect1/para
2512 #: C/index.docbook:2378
2513 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."
2514 msgstr "Издање 1.18 је донело почетну подршку за маркдаун. Коришћење маркдауна у напоменама кода је мање нападно од писања docbook xml-а. Ово издање значајно побољшава ово и додаје много више стилова. Одељак који објашњава <link linkend=\"documenting_syntax\">синтаксу напомена</link> садржи све детаље."
2515
2516 #. (itstool) path: sect1/title
2517 #: C/index.docbook:2388
2518 msgid "GTK-Doc 1.25"
2519 msgstr "ГТК-Док 1.25"
2520
2521 #. (itstool) path: example/title
2522 #: C/index.docbook:2399
2523 msgid "Use pre-generated entities"
2524 msgstr "Коришћење унапред створених ставки"
2525
2526 #. (itstool) path: example/programlisting
2527 #: C/index.docbook:2400
2528 #, no-wrap
2529 msgid ""
2530 "\n"
2531 "&lt;?xml version=\"1.0\"?&gt;\n"
2532 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
2533 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
2534 "[\n"
2535 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
2536 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
2537 " %gtkdocentities;\n"
2538 "]&gt;\n"
2539 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
2540 " &lt;bookinfo&gt;\n"
2541 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
2542 " &lt;releaseinfo&gt;\n"
2543 " for &amp;package_string;.\n"
2544 " The latest version of this documentation can be found on-line at\n"
2545 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
2546 " &lt;/releaseinfo&gt;\n"
2547 " &lt;/bookinfo&gt;\n"
2548 msgstr ""
2549 "\n"
2550 "&lt;?xml version=\"1.0\"?&gt;\n"
2551 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
2552 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
2553 "[\n"
2554 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
2555 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
2556 " %gtkdocentities;\n"
2557 "]&gt;\n"
2558 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
2559 " &lt;bookinfo&gt;\n"
2560 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
2561 " &lt;releaseinfo&gt;\n"
2562 " for &amp;package_string;.\n"
2563 " The latest version of this documentation can be found on-line at\n"
2564 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
2565 " &lt;/releaseinfo&gt;\n"
2566 " &lt;/bookinfo&gt;\n"
2567
2568 #. (itstool) path: sect1/para
2569 #: C/index.docbook:2390
2570 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/>"
2571 msgstr "Датотеке управљања градњом (makefiles) испоручене уз ово издање стварају датотеку ставки у <filename>xml/gtkdocentities.ent</filename>, која садржи ставке за нпр. package_name и package_version. Ово можете користити нпр. у главној xml датотеци како бисте избегли ручно уписивање броја издања. Испод је пример који показује како се датотека ставки укључује у главни шаблон и како се ставке користе. Ставке се такође могу користити у свим створеним датотекама, ГТК-Док ће користити исто xml заглавље у створеним xml датотекама. <_:example-1/>"
2572
2573 #. (itstool) path: chapter/title
2574 #: C/index.docbook:2425
2575 msgid "Documenting other interfaces"
2576 msgstr "Документовање других прочеља"
2577
2578 #. (itstool) path: chapter/para
2579 #: C/index.docbook:2427
2580 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."
2581 msgstr "До сада смо користили ГТК-Док за документовање АПИ-ја кода. Следећи одељци садржи предлоге како се алати могу користити и за документовање других прочеља."
2582
2583 #. (itstool) path: sect1/title
2584 #: C/index.docbook:2434
2585 msgid "Command line options and man pages"
2586 msgstr "Опције линије наредби и man странице"
2587
2588 #. (itstool) path: sect1/para
2589 #: C/index.docbook:2436
2590 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."
2591 msgstr "Како се могу стварати man странице и за docbook refentry, чини се као добра идеја користити га у ту сврху. На тај начин је прочеље део референце и man страница се добија бесплатно."
2592
2593 #. (itstool) path: sect2/title
2594 #: C/index.docbook:2443
2595 msgid "Document the tool"
2596 msgstr "Документовање алата"
2597
2598 #. (itstool) path: sect2/para
2599 #: C/index.docbook:2445
2600 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."
2601 msgstr "Направите једну refentry датотеку по алату. Пратећи <link linkend=\"settingup_docfiles\">наш пример</link> назвали бисмо је <filename>meep/docs/reference/meeper/meep.xml</filename>. За xml ознаке које треба користити можете погледати створену датотеку у xml пододељку као и примере нпр. у glib-у."
2602
2603 #. (itstool) path: sect2/title
2604 #: C/index.docbook:2455
2605 msgid "Adding the extra configure check"
2606 msgstr "Додавање додатне провере подешавања"
2607
2608 #. (itstool) path: example/title
2609 #: C/index.docbook:2458 C/index.docbook:2476
2610 msgid "Extra configure checks"
2611 msgstr "Додатне провере подешавања"
2612
2613 #. (itstool) path: example/programlisting
2614 #: C/index.docbook:2459
2615 #, no-wrap
2616 msgid ""
2617 "\n"
2618 "AC_ARG_ENABLE(man,\n"
2619 " [AC_HELP_STRING([--enable-man],\n"
2620 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
2621 " enable_man=no)\n"
2622 "\n"
2623 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
2624 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
2625 msgstr ""
2626 "\n"
2627 "AC_ARG_ENABLE(man,\n"
2628 " [AC_HELP_STRING([--enable-man],\n"
2629 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
2630 " enable_man=no)\n"
2631 "\n"
2632 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
2633 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
2634
2635 #. (itstool) path: sect2/title
2636 #: C/index.docbook:2473
2637 msgid "Adding the extra makefile rules"
2638 msgstr "Додавање додатних правила датотеке управљања градњом"
2639
2640 #. (itstool) path: example/programlisting
2641 #: C/index.docbook:2477
2642 #, no-wrap
2643 msgid ""
2644 "\n"
2645 "man_MANS = \\\n"
2646 " meeper.1\n"
2647 "\n"
2648 "if ENABLE_GTK_DOC\n"
2649 "if ENABLE_MAN\n"
2650 "\n"
2651 "%.1 : %.xml\n"
2652 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
2653 "\n"
2654 "endif\n"
2655 "endif\n"
2656 "\n"
2657 "BUILT_EXTRA_DIST = $(man_MANS)\n"
2658 "EXTRA_DIST += meep.xml\n"
2659 msgstr ""
2660 "\n"
2661 "man_MANS = \\\n"
2662 " meeper.1\n"
2663 "\n"
2664 "if ENABLE_GTK_DOC\n"
2665 "if ENABLE_MAN\n"
2666 "\n"
2667 "%.1 : %.xml\n"
2668 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
2669 "\n"
2670 "endif\n"
2671 "endif\n"
2672 "\n"
2673 "BUILT_EXTRA_DIST = $(man_MANS)\n"
2674 "EXTRA_DIST += meep.xml\n"
2675
2676 #. (itstool) path: sect1/title
2677 #: C/index.docbook:2499
2678 msgid "DBus interfaces"
2679 msgstr "Д-сабирничка прочеља"
2680
2681 #. (itstool) path: sect1/para
2682 #: C/index.docbook:2501
2683 msgid "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
2684 msgstr "(ПОПРАВИМЕ: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
2685
2686 #. (itstool) path: chapter/title
2687 #: C/index.docbook:2510
2688 msgid "Frequently asked questions"
2689 msgstr "Често постављана питања"
2690
2691 #. (itstool) path: segmentedlist/segtitle
2692 #: C/index.docbook:2514
2693 msgid "Question"
2694 msgstr "Питање"
2695
2696 #. (itstool) path: segmentedlist/segtitle
2697 #: C/index.docbook:2515
2698 msgid "Answer"
2699 msgstr "Одговори"
2700
2701 #. (itstool) path: seglistitem/seg
2702 #: C/index.docbook:2517
2703 msgid "No class hierarchy."
2704 msgstr "Нема хијерархије разреда."
2705
2706 #. (itstool) path: seglistitem/seg
2707 #: C/index.docbook:2518
2708 msgid "The objects <function>xxx_get_type()</function> function has not been entered into the <filename>&lt;package&gt;.types</filename> file."
2709 msgstr "Функција објеката <function>xxx_get_type()</function> није унета у датотеку <filename>&lt;package&gt;.types</filename>."
2710
2711 #. (itstool) path: seglistitem/seg
2712 #: C/index.docbook:2524
2713 msgid "Still no class hierarchy."
2714 msgstr "И даље нема хијерархије разреда."
2715
2716 #. (itstool) path: seglistitem/seg
2717 #: C/index.docbook:2525
2718 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>)."
2719 msgstr "Недостајуће или погрешно именовање у датотеци <filename>&lt;package&gt;-sections.txt</filename> (погледајте <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html\">објашњење</ulink>)."
2720
2721 #. (itstool) path: seglistitem/seg
2722 #: C/index.docbook:2531
2723 msgid "Damn, I have still no class hierarchy."
2724 msgstr "Проклетство, и даље немам хијерархију разреда."
2725
2726 #. (itstool) path: seglistitem/seg
2727 #: C/index.docbook:2532
2728 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)."
2729 msgstr "Да ли је име објекта (име примерка структуре, нпр. <type>GtkWidget</type>) део нормалног одељка (не стављајте ово у Стандардне или Приватне пододељке)."
2730
2731 #. (itstool) path: seglistitem/seg
2732 #: C/index.docbook:2539
2733 msgid "No symbol index."
2734 msgstr "Нема индекса симбола."
2735
2736 #. (itstool) path: seglistitem/seg
2737 #: C/index.docbook:2540
2738 msgid "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a index that xi:includes the generated index?"
2739 msgstr "Да ли <filename>&lt;package&gt;-docs.{xml,sgml}</filename> садржи индекс који xi:include-ује генерисани индекс?"
2740
2741 #. (itstool) path: seglistitem/seg
2742 #: C/index.docbook:2546
2743 msgid "Symbols are not linked to their doc-section."
2744 msgstr "Симболи нису повезани са својим одељком документације."
2745
2746 #. (itstool) path: seglistitem/seg
2747 #: C/index.docbook:2547
2748 msgid "Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs."
2749 msgstr "Да ли коментар документације користи исправно означавање (додато #,% или ())? Проверите да ли gtkdoc-fixxref упозорава на нерешиве унакрсне референце (xrefs)."
2750
2751 #. (itstool) path: seglistitem/seg
2752 #: C/index.docbook:2553
2753 msgid "A new class does not appear in the docs."
2754 msgstr "Нови разред се не појављује у документацији."
2755
2756 #. (itstool) path: seglistitem/seg
2757 #: C/index.docbook:2554
2758 msgid "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
2759 msgstr "Да ли је нова страница xi:included из <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
2760
2761 #. (itstool) path: seglistitem/seg
2762 #: C/index.docbook:2560
2763 msgid "A new symbol does not appear in the docs."
2764 msgstr "Нови симбол се не појављује у документацији."
2765
2766 #. (itstool) path: seglistitem/seg
2767 #: C/index.docbook:2561
2768 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."
2769 msgstr "Да ли је коментар документације правилно обликован. Проверите да ли има правописних грешака на почетку коментара. Проверите да ли gtkdoc-fixxref упозорава на нерешиве унакрсне референце (xrefs). Проверите да ли је симбол исправно наведен у <filename>&lt;package&gt;-sections.txt</filename> у јавном пододељку."
2770
2771 #. (itstool) path: seglistitem/seg
2772 #: C/index.docbook:2569
2773 msgid "A type is missing from the class hierarchy."
2774 msgstr "Врста недостаје у хијерархији разреда."
2775
2776 #. (itstool) path: seglistitem/seg
2777 #: C/index.docbook:2570
2778 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."
2779 msgstr "Ако је врста наведена у <filename>&lt;package&gt;.hierarchy</filename> али не и у <filename>xml/tree_index.sgml</filename>, онда двапут проверите да ли је врста исправно постављена у <filename>&lt;package&gt;-sections.txt</filename>. Ако примерак врсте (нпр. <type>GtkWidget</type>) није наведен или је случајно означен као приватан, неће бити приказан."
2780
2781 #. (itstool) path: seglistitem/seg
2782 #: C/index.docbook:2579
2783 msgid "I get foldoc links for all gobject annotations."
2784 msgstr "Добијам foldoc везе за све gobject забелешке."
2785
2786 #. (itstool) path: seglistitem/seg
2787 #: C/index.docbook:2580
2788 msgid "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
2789 msgstr "Проверите да ли је <filename>xml/annotation-glossary.xml</filename> xi:included из <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
2790
2791 #. (itstool) path: seglistitem/seg
2792 #: C/index.docbook:2588
2793 msgid "Parameter described in source code comment block but does not exist"
2794 msgstr "Параметар је описан у блоку коментара изворног кода али не постоји"
2795
2796 #. (itstool) path: seglistitem/seg
2797 #: C/index.docbook:2589
2798 msgid "Check if the prototype in the header has different parameter names as in the source."
2799 msgstr "Проверите да ли прототип у заглављу има другачије називе параметара него у извору."
2800
2801 #. (itstool) path: seglistitem/seg
2802 #: C/index.docbook:2594
2803 msgid "multiple \"IDs\" for constraint linkend: XYZ"
2804 msgstr "више „ID-ова“ за везу ограничења: XYZ"
2805
2806 #. (itstool) path: seglistitem/seg
2807 #: C/index.docbook:2595
2808 msgid "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</filename> file."
2809 msgstr "Симбол XYZ се појављује два пута у датотеци <filename>&lt;package&gt;-sections.txt</filename>."
2810
2811 #. (itstool) path: seglistitem/seg
2812 #: C/index.docbook:2598
2813 msgid "Element typename in namespace '' encountered in para, but no template matches."
2814 msgstr "Елемент „typename“ у именском простору „“ је наишао у пасусу (para), али се ниједан шаблон не подудара."
2815
2816 #. (itstool) path: chapter/title
2817 #: C/index.docbook:2605
2818 msgid "Tools related to gtk-doc"
2819 msgstr "Алати повезани са gtk-doc-ом"
2820
2821 #. (itstool) path: chapter/para
2822 #: C/index.docbook:2607
2823 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."
2824 msgstr "GtkDocPlugin — <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac GTK-Doc</ulink> прикључак за интеграцију, који додаје API документацију на trac веб сајт и интегрише се са trac претрагом."
2825
2826 #. (itstool) path: chapter/para
2827 #: C/index.docbook:2612
2828 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."
2829 msgstr "Gtkdoc-depscan — алат (део gtk-doc-а) за проверу коришћеног API-ја у односу на ознаке „since“ у API-ју како би се одредило најмање потребно издање."
2830
2831 #. (itstool) path: appendixinfo/releaseinfo
2832 #: C/fdl-appendix.xml:12
2833 msgid "Version 1.1, March 2000"
2834 msgstr "Издање 1.1, март 2000."
2835
2836 #. (itstool) path: copyright/year
2837 #: C/fdl-appendix.xml:16
2838 msgid "2000"
2839 msgstr "2000"
2840
2841 #. (itstool) path: copyright/holder
2842 #: C/fdl-appendix.xml:16
2843 msgid "Free Software Foundation, Inc."
2844 msgstr "Free Software Foundation, Inc."
2845
2846 #. (itstool) path: address/street
2847 #: C/fdl-appendix.xml:20
2848 msgid "51 Franklin Street, Suite 330"
2849 msgstr "51 Franklin Street, Suite 330"
2850
2851 #. (itstool) path: address/city
2852 #: C/fdl-appendix.xml:21
2853 msgid "Boston"
2854 msgstr "Бостон"
2855
2856 #. (itstool) path: address/state
2857 #: C/fdl-appendix.xml:21
2858 msgid "MA"
2859 msgstr "MA"
2860
2861 #. (itstool) path: address/postcode
2862 #: C/fdl-appendix.xml:22
2863 msgid "02110-1301"
2864 msgstr "02110-1301"
2865
2866 #. (itstool) path: address/country
2867 #: C/fdl-appendix.xml:22
2868 msgid "USA"
2869 msgstr "USA"
2870
2871 #. (itstool) path: para/address
2872 #: C/fdl-appendix.xml:20
2873 msgid "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:postcode-4/> <_:country-5/>"
2874 msgstr "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:postcode-4/> <_:country-5/>"
2875
2876 #. (itstool) path: legalnotice/para
2877 #: C/fdl-appendix.xml:19
2878 msgid "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed."
2879 msgstr "<_:address-1/> Свакоме је дозвољено да умножава и расподељује дословне примерке овог документа лиценце, али његово мењање није дозвољено."
2880
2881 #. (itstool) path: appendix/title
2882 #. (itstool) path: para/quote
2883 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
2884 msgid "GNU Free Documentation License"
2885 msgstr "ГНУ-ова Лиценца за слободну документацију"
2886
2887 #. (itstool) path: sect1/title
2888 #: C/fdl-appendix.xml:31
2889 msgid "0. PREAMBLE"
2890 msgstr "0. ПРЕАМБУЛА"
2891
2892 #. (itstool) path: para/quote
2893 #: C/fdl-appendix.xml:34
2894 msgid "free"
2895 msgstr "бесплатно"
2896
2897 #. (itstool) path: sect1/para
2898 #: C/fdl-appendix.xml:32
2899 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."
2900 msgstr "Сврха ове Лиценце је да учини приручник, уџбеник или други писани документ <_:quote-1/> у смислу слободе: да осигура свакоме стварну слободу да га умножава и расподељује, са или без измена, било комерцијално или некомерцијално. Другостепено, ова Лиценца чува аутору и издавачу начин да добију признање за свој рад, док се не сматрају одговорним за измене које су начинили други."
2901
2902 #. (itstool) path: para/quote
2903 #: C/fdl-appendix.xml:44
2904 msgid "copyleft"
2905 msgstr "копилефт"
2906
2907 #. (itstool) path: sect1/para
2908 #: C/fdl-appendix.xml:43
2909 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."
2910 msgstr "Ова лиценца је врста <_:quote-1/>, што значи да изведени радови документа и сами морају бити слободни у истом смислу. Она допуњује ГНУ-ову општу јавну лиценцу, која је лиценца типа копилефт дизајнирана за слободан софтвер."
2911
2912 #. (itstool) path: sect1/para
2913 #: C/fdl-appendix.xml:50
2914 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."
2915 msgstr "Ову лиценцу смо осмислили како бисмо је користили за упутства за слободан софтвер, јер је слободном софтверу потребна слободна документација: слободан програм треба да иде уз упутства која пружају исте слободе као и сам софтвер. Али ова лиценца није ограничена на упутства за софтвер; може се користити за било који текстуални рад, без обзира на предметну материју или на то да ли је објављен као штампана књига. Ову лиценцу препоручујемо првенствено за радове чија је сврха подучавање или референца."
2916
2917 #. (itstool) path: sect1/title
2918 #: C/fdl-appendix.xml:62
2919 msgid "1. APPLICABILITY AND DEFINITIONS"
2920 msgstr "1. ПРИМЕЊИВОСТ И ДЕФИНИЦИЈЕ"
2921
2922 #. (itstool) path: para/quote
2923 #. (itstool) path: para/link
2924 #: 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
2925 msgid "Document"
2926 msgstr "Документујте"
2927
2928 #. (itstool) path: para/quote
2929 #: C/fdl-appendix.xml:69
2930 msgid "you"
2931 msgstr "ви"
2932
2933 #. (itstool) path: sect1/para
2934 #: C/fdl-appendix.xml:63
2935 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/>."
2936 msgstr "Ова лиценца се примењује на било које упутство или други рад који садржи обавештење постављено од стране носиоца ауторских права у којем се наводи да се може дистрибуирати под условима ове лиценце. „Документ“ у даљем тексту се односи на било које такво упутство или рад. Сваки члан јавности је прималац лиценце и њему се обраћа са „ви“."
2937
2938 #. (itstool) path: para/quote
2939 #. (itstool) path: para/link
2940 #: 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
2941 msgid "Modified Version"
2942 msgstr "Измењено издање"
2943
2944 #. (itstool) path: sect1/para
2945 #: C/fdl-appendix.xml:72
2946 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."
2947 msgstr "<_:quote-1/> документа значи било који рад који садржи документ или његов део, било копиран дословно, било са изменама и/или преведен на други језик."
2948
2949 #. (itstool) path: para/quote
2950 #: C/fdl-appendix.xml:80
2951 msgid "Secondary Section"
2952 msgstr "Споредни одељак"
2953
2954 #. (itstool) path: sect1/para
2955 #: C/fdl-appendix.xml:79
2956 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."
2957 msgstr "<_:quote-1/> је именовани додатак или уводни одељак <_:link-2/> који се искључиво бави односом издавача или аутора документа према општој теми документа (или према сродним питањима) и не садржи ништа што би могло директно потпасти под ту општу тему. (На пример, ако је документ делом уџбеник математике, споредни одељак не сме објашњавати математику.) Тај однос може бити питање историјске повезаности са темом или са сродним питањима, или правни, комерцијални, филозофски, етички или политички став у вези са њима."
2958
2959 #. (itstool) path: para/quote
2960 #. (itstool) path: para/link
2961 #: 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
2962 msgid "Invariant Sections"
2963 msgstr "Непроменљиви одељци"
2964
2965 #. (itstool) path: para/link
2966 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
2967 msgid "Secondary Sections"
2968 msgstr "Споредни одељци"
2969
2970 #. (itstool) path: sect1/para
2971 #: C/fdl-appendix.xml:94
2972 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."
2973 msgstr "<_:quote-1/> су одређени <_:link-2/> чији су наслови назначени као наслови непроменљивих одељака у обавештењу које каже да је <_:link-3/> објављен под овом лиценцом."
2974
2975 #. (itstool) path: para/quote
2976 #. (itstool) path: para/link
2977 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328 C/fdl-appendix.xml:458
2978 msgid "Cover Texts"
2979 msgstr "Текстови на корицама"
2980
2981 #. (itstool) path: sect1/para
2982 #: C/fdl-appendix.xml:103
2983 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."
2984 msgstr "<_:quote-1/> су одређени кратки одломци текста који су наведени као текстови на предњој или задњој корици у обавештењу које каже да је <_:link-2/> објављен под овом лиценцом."
2985
2986 #. (itstool) path: para/quote
2987 #. (itstool) path: para/link
2988 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207 C/fdl-appendix.xml:369
2989 msgid "Transparent"
2990 msgstr "Провидно"
2991
2992 #. (itstool) path: para/quote
2993 #. (itstool) path: para/link
2994 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
2995 msgid "Opaque"
2996 msgstr "Непрозирно"
2997
2998 #. (itstool) path: sect1/para
2999 #: C/fdl-appendix.xml:111
3000 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/>."
3001 msgstr "<_:quote-1/> примерак <_:link-2/> значи машински читљив примерак, представљен у формату чија је спецификација доступна јавности, чији се садржај може прегледати и уређивати директно и једноставно помоћу општих уређивача текста или (за слике састављене од пиксела) општих програма за цртање или (за цртеже) неког широко доступног уређивача цртежа, и који је погодан за унос у формате текста или за аутоматско превођење у различите формате погодне за унос у формате текста. Примерак направљен у иначе провидном формату датотеке чије је означавање дизајнирано да онемогући или одврати накнадно мењање од стране читалаца није провидан. Примерак који није <_:quote-3/> назива се <_:quote-4/>."
3002
3003 #. (itstool) path: sect1/para
3004 #: C/fdl-appendix.xml:128
3005 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."
3006 msgstr "Примери погодних формата за провидне примерке укључују обичан ASCII без означавања, Texinfo улазни формат, LaTeX улазни формат, SGML или XML који користе јавно доступан DTD, и једноставан HTML усклађен са стандардима дизајниран за људску измену. Непрозирни формати укључују PostScript, PDF, власничке формате који се могу читати и уређивати само помоћу власничких процесора текста, SGML или XML за које DTD и/или алати за обраду нису опште доступни, и машински генерисан HTML који производе неки процесори текста само за потребе излаза."
3007
3008 #. (itstool) path: para/quote
3009 #. (itstool) path: para/link
3010 #: 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
3011 msgid "Title Page"
3012 msgstr "Насловна страна"
3013
3014 #. (itstool) path: sect1/para
3015 #: C/fdl-appendix.xml:141
3016 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."
3017 msgstr "<_:quote-1/> значи, за штампану књигу, саму насловну страну, плус наредне странице које су потребне да би се читко сместио материјал који ова лиценца захтева да се појави на насловној страни. За радове у форматима који немају насловну страну као такву, <_:quote-2/> означава текст близу најистакнутијег појављивања наслова рада, који претходи почетку самог текста."
3018
3019 #. (itstool) path: sect1/title
3020 #: C/fdl-appendix.xml:153
3021 msgid "2. VERBATIM COPYING"
3022 msgstr "2. ДОСЛОВНО УМНОЖАВАЊЕ"
3023
3024 #. (itstool) path: para/link
3025 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
3026 msgid "section 3"
3027 msgstr "одељак 3"
3028
3029 #. (itstool) path: sect1/para
3030 #: C/fdl-appendix.xml:154
3031 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/>."
3032 msgstr "Можете умножавати и расподељивати <_:link-1/> на било ком медијуму, било комерцијално или некомерцијално, под условом да ова лиценца, напомене о ауторским правима и напомена о лиценци која каже да се ова лиценца примењује на Документ буду репродуковане у свим примерцима, и да не додајете никакве друге услове онима из ове лиценце. Не смете користити техничке мере за ометање или контролу читања или даљег умножавања примерака које направите или расподелите. Међутим, можете прихватити накнаду у замену за примерке. Ако расподељујете довољно велики број примерака, морате такође пратити услове из <_:link-2/>."
3033
3034 #. (itstool) path: sect1/para
3035 #: C/fdl-appendix.xml:169
3036 msgid "You may also lend copies, under the same conditions stated above, and you may publicly display copies."
3037 msgstr "Такође можете позајмљивати примерке, под истим горе наведеним условима, и можете јавно приказивати примерке."
3038
3039 #. (itstool) path: sect1/title
3040 #: C/fdl-appendix.xml:176
3041 msgid "3. COPYING IN QUANTITY"
3042 msgstr "3. УМНОЖАВАЊЕ У ВЕЋЕМ БРОЈУ"
3043
3044 #. (itstool) path: sect1/para
3045 #: C/fdl-appendix.xml:177
3046 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."
3047 msgstr "Ако објавите штампане примерке <_:link-1/> у броју већем од 100, а напомена о лиценци Документа захтева <_:link-2/>, морате приложити примерке в омоте који јасно и читко носе све ове текстове омота: Текстове предњег омота на предњој страни, и Текстове задњег омота на задњој страни. Оба омота морају вас такође јасно и читко идентификовати као издавача ових примерака. Предњи омот мора представити пун наслов са свим речима наслова подједнако истакнутим и видљивим. Можете додати и други материјал на омоте. Умножавање са изменама ограниченим на омоте, све док оне очувају наслов <_:link-3/> и задовољавају ове услове, може се сматрати дословним умножавањем у осталим погледима."
3048
3049 #. (itstool) path: sect1/para
3050 #: C/fdl-appendix.xml:195
3051 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."
3052 msgstr "Ако су захтевани текстови за било који омот превише обимни да би стали читко, треба да ставите прве наведене (колико год разумно стане) на сам омот, а остатак наставите на суседним страницама."
3053
3054 #. (itstool) path: sect1/para
3055 #: C/fdl-appendix.xml:202
3056 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."
3057 msgstr "Ако објавите или расподелите <_:link-1/> примерке <_:link-2/> у броју већем од 100, морате или укључити машински читљив <_:link-3/> примерак уз сваки Непрозиран примерак, или навести у или уз сваки Непрозиран примерак јавно доступну локацију на рачунарској мрежи која садржи потпун Прозиран примерак Документа, без додатог материјала, коме општа јавност која користи мрежу има приступ за анонимно преузимање без накнаде користећи стандардне мрежне протоколе. Ако користите ову последњу опцију, морате предузети разумно опрезне кораке, када започнете расподелу Непрозирних примерака у већем броју, како бисте осигурали да овај Прозиран примерак остане тако доступан на наведеној локацији најмање годину дана након што последњи пут расподелите Непрозиран примерак (директно или преко ваших агената или продаваца) тог издања јавности."
3058
3059 #. (itstool) path: sect1/para
3060 #: C/fdl-appendix.xml:222
3061 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."
3062 msgstr "Захтева се, али није обавезно, да контактирате ауторе <_:link-1/> знатно пре прерасподеле било ког већег броја примерака, како бисте им дали прилику да вам доставе ажурирану верзију Документа."
3063
3064 #. (itstool) path: sect1/title
3065 #: C/fdl-appendix.xml:231
3066 msgid "4. MODIFICATIONS"
3067 msgstr "4. ИЗМЕНЕ"
3068
3069 #. (itstool) path: para/link
3070 #: C/fdl-appendix.xml:236
3071 msgid "2"
3072 msgstr "2"
3073
3074 #. (itstool) path: para/link
3075 #: C/fdl-appendix.xml:237
3076 msgid "3"
3077 msgstr "3"
3078
3079 #. (itstool) path: sect1/para
3080 #: C/fdl-appendix.xml:232
3081 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:"
3082 msgstr "Можете умножавати и расподељивати <_:link-1/> <_:link-2/> под условима из одељака <_:link-3/> и <_:link-4/> изнад, под условом да објавите Измењену верзију под управо овом лиценцом, при чему Измењен верзија преузима улогу Документа, чиме се лиценцира расподела и измена Измењене верзије свакоме ко поседује њен примерак. Поред тога, у Измењеној верзији морате урадити следеће:"
3083
3084 #. (itstool) path: formalpara/title
3085 #: C/fdl-appendix.xml:248
3086 msgid "A"
3087 msgstr "А"
3088
3089 #. (itstool) path: formalpara/para
3090 #: C/fdl-appendix.xml:249
3091 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."
3092 msgstr "Користите у <_:link-1/> (и на омотима, ако их има) наслов који се разликује од наслова <_:link-2/>, и од наслова претходних верзија (које би, ако их је било, требало навести у одељку Историјат Документа). Можете користити исти наслов као у претходној верзији ако првобитни издавач те верзије да дозволу."
3093
3094 #. (itstool) path: formalpara/title
3095 #: C/fdl-appendix.xml:264
3096 msgid "B"
3097 msgstr "Б"
3098
3099 #. (itstool) path: formalpara/para
3100 #: C/fdl-appendix.xml:265
3101 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)."
3102 msgstr "Наведите на <_:link-1/>, као ауторе, једну или више особа или ентитета одговорних за ауторство измена у <_:link-2/>, заједно са најмање пет главних аутора <_:link-3/> (све његове главне ауторе, ако их има мање од пет)."
3103
3104 #. (itstool) path: formalpara/title
3105 #: C/fdl-appendix.xml:279
3106 msgid "C"
3107 msgstr "C"
3108
3109 #. (itstool) path: formalpara/para
3110 #: C/fdl-appendix.xml:280
3111 msgid "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as the publisher."
3112 msgstr "Наведите на <_:link-1/> име издавача <_:link-2/>, као издавача."
3113
3114 #. (itstool) path: formalpara/title
3115 #: C/fdl-appendix.xml:291
3116 msgid "D"
3117 msgstr "Н"
3118
3119 #. (itstool) path: formalpara/para
3120 #: C/fdl-appendix.xml:292
3121 msgid "Preserve all the copyright notices of the <_:link-1/>."
3122 msgstr "Очувајте све напомене о ауторским правима <_:link-1/>."
3123
3124 #. (itstool) path: formalpara/title
3125 #: C/fdl-appendix.xml:301
3126 msgid "E"
3127 msgstr "E"
3128
3129 #. (itstool) path: formalpara/para
3130 #: C/fdl-appendix.xml:302
3131 msgid "Add an appropriate copyright notice for your modifications adjacent to the other copyright notices."
3132 msgstr "Додајте одговарајућу напомену о ауторским правима за ваше измене поред осталих напомена о ауторским правима."
3133
3134 #. (itstool) path: formalpara/title
3135 #: C/fdl-appendix.xml:311
3136 msgid "F"
3137 msgstr "F"
3138
3139 #. (itstool) path: formalpara/para
3140 #: C/fdl-appendix.xml:312
3141 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."
3142 msgstr "Укључите, одмах након напомена о ауторским правима, напомену о лиценци која даје јавности дозволу за коришћење <_:link-1/> под условима ове лиценце, у облику приказаном у Додатку испод."
3143
3144 #. (itstool) path: formalpara/title
3145 #: C/fdl-appendix.xml:324
3146 msgid "G"
3147 msgstr "и"
3148
3149 #. (itstool) path: para/link
3150 #: C/fdl-appendix.xml:330
3151 msgid "Document's"
3152 msgstr "Документа"
3153
3154 #. (itstool) path: formalpara/para
3155 #: C/fdl-appendix.xml:325
3156 msgid "Preserve in that license notice the full lists of <_:link-1/> and required <_:link-2/> given in the <_:link-3/> license notice."
3157 msgstr "Очувајте у тој напомени о лиценци пуне спискове <_:link-1/> и захтеваних <_:link-2/> датих у напомени о лиценци <_:link-3/>."
3158
3159 #. (itstool) path: formalpara/title
3160 #: C/fdl-appendix.xml:337
3161 msgid "H"
3162 msgstr "H"
3163
3164 #. (itstool) path: formalpara/para
3165 #: C/fdl-appendix.xml:338
3166 msgid "Include an unaltered copy of this License."
3167 msgstr "Укључите неизмењен примерак ове лиценце."
3168
3169 #. (itstool) path: formalpara/title
3170 #: C/fdl-appendix.xml:346
3171 msgid "I"
3172 msgstr "I"
3173
3174 #. (itstool) path: para/quote
3175 #: 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
3176 msgid "History"
3177 msgstr "Историја"
3178
3179 #. (itstool) path: formalpara/para
3180 #: C/fdl-appendix.xml:347
3181 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."
3182 msgstr "Сачувајте одељак под насловом <_:quote-1/>, и његов наслов, и додајте му ставку која наводи барем наслов, годину, нове ауторе и издавача <_:link-2/> као што је дато на <_:link-3/>. Ако у <_:link-5/> не постоји одељак под насловом <_:quote-4/>, направите га наводећи наслов, годину, ауторе и издавача документа као што је дато на његовој насловној страни, а затим додајте ставку која описује измењено издање као што је наведено у претходној реченици."
3183
3184 #. (itstool) path: formalpara/title
3185 #: C/fdl-appendix.xml:365
3186 msgid "J"
3187 msgstr "J"
3188
3189 #. (itstool) path: formalpara/para
3190 #: C/fdl-appendix.xml:366
3191 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."
3192 msgstr "Сачувајте мрежну локацију, ако постоји, наведену у <_:link-1/> за јавни приступ <_:link-2/> примерку документа, као и мрежне локације наведене у документу за претходна издања на којима је заснован. Оне могу бити постављене у одељак <_:quote-3/>. Можете изоставити мрежну локацију за дело које је објављено најмање четири године пре самог документа, или ако првобитни издавач издања на које се односи да дозволу."
3193
3194 #. (itstool) path: formalpara/title
3195 #: C/fdl-appendix.xml:383
3196 msgid "K"
3197 msgstr "K"
3198
3199 #. (itstool) path: para/quote
3200 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
3201 msgid "Acknowledgements"
3202 msgstr "Захвалнице"
3203
3204 #. (itstool) path: para/quote
3205 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
3206 msgid "Dedications"
3207 msgstr "Посвете"
3208
3209 #. (itstool) path: formalpara/para
3210 #: C/fdl-appendix.xml:384
3211 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."
3212 msgstr "У било ком одељку под насловом <_:quote-1/> или <_:quote-2/>, сачувајте наслов одељка и сачувајте у одељку сву суштину и тон сваке од захвалница сарадника и/или посвета које су тамо дате."
3213
3214 #. (itstool) path: formalpara/title
3215 #: C/fdl-appendix.xml:396
3216 msgid "L"
3217 msgstr "L"
3218
3219 #. (itstool) path: formalpara/para
3220 #: C/fdl-appendix.xml:397
3221 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."
3222 msgstr "Сачувајте све <_:link-1/> <_:link-2/>, неизмењене у њиховом тексту и насловима. Бројеви одељака или еквиваленти се не сматрају делом наслова одељака."
3223
3224 #. (itstool) path: formalpara/title
3225 #: C/fdl-appendix.xml:409
3226 msgid "M"
3227 msgstr "ц"
3228
3229 #. (itstool) path: para/quote
3230 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
3231 msgid "Endorsements"
3232 msgstr "Одобрења"
3233
3234 #. (itstool) path: formalpara/para
3235 #: C/fdl-appendix.xml:410
3236 msgid "Delete any section entitled <_:quote-1/>. Such a section may not be included in the <_:link-2/>."
3237 msgstr "Обришите сваки одељак под насловом <_:quote-1/>. Такав одељак не сме бити укључен у <_:link-2/>."
3238
3239 #. (itstool) path: formalpara/title
3240 #: C/fdl-appendix.xml:421
3241 msgid "N"
3242 msgstr "Н"
3243
3244 #. (itstool) path: para/link
3245 #: C/fdl-appendix.xml:425
3246 msgid "Invariant Section"
3247 msgstr "Непроменљиви одељак"
3248
3249 #. (itstool) path: formalpara/para
3250 #: C/fdl-appendix.xml:422
3251 msgid "Do not retitle any existing section as <_:quote-1/> or to conflict in title with any <_:link-2/>."
3252 msgstr "Немојте мењати наслов ниједном постојећем одељку у <_:quote-1/> нити да се наслов сукобљава са било којим <_:link-2/>."
3253
3254 #. (itstool) path: sect1/para
3255 #: C/fdl-appendix.xml:432
3256 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."
3257 msgstr "Ако <_:link-1/> укључује нове одељке предговора или додатке који се квалификују као <_:link-2/> и не садрже материјал копиран из документа, можете по свом избору означити неке или све ове одељке као непроменљиве. Да бисте то урадили, додајте њихове наслове на списак <_:link-3/> у обавештењу о лиценци измењеног издања. Ови наслови морају бити различити од свих осталих наслова одељака."
3258
3259 #. (itstool) path: sect1/para
3260 #: C/fdl-appendix.xml:444
3261 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."
3262 msgstr "Можете додати одељак под насловом <_:quote-1/>, под условом да не садржи ништа осим одобрења вашег <_:link-2/> од стране разних страна — на пример, изјаве о стручној рецензији или да је текст одобрила нека организација као меродавну дефиницију стандарда."
3263
3264 #. (itstool) path: para/link
3265 #: C/fdl-appendix.xml:455
3266 msgid "Front-Cover Text"
3267 msgstr "Текст на предњој корици"
3268
3269 #. (itstool) path: para/link
3270 #: C/fdl-appendix.xml:457
3271 msgid "Back-Cover Text"
3272 msgstr "Текст на задњој корици"
3273
3274 #. (itstool) path: sect1/para
3275 #: C/fdl-appendix.xml:453
3276 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."
3277 msgstr "Можете додати одломак од највише пет речи као <_:link-1/>, и одломак од највише 25 речи као <_:link-2/>, на крај списка <_:link-3/> у <_:link-4/>. Само један одломак текста на предњој корици и један на задњој корици може додати (или путем договора који је склопио) било који ентитет. Ако <_:link-5/> већ укључује текст корице за исту корицу, који сте претходно додали ви или према договору који је склопио исти ентитет у чије име наступате, не можете додати други; али можете заменити стари, уз изричиту дозволу претходног издавача који је додао стари."
3278
3279 #. (itstool) path: sect1/para
3280 #: C/fdl-appendix.xml:470
3281 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/>."
3282 msgstr "Аутор(и) и издавач(и) <_:link-1/> овом лиценцом не дају дозволу за коришћење њихових имена ради рекламирања или ради потврђивања или имплицирања одобрења било ког <_:link-2/>."
3283
3284 #. (itstool) path: sect1/title
3285 #: C/fdl-appendix.xml:480
3286 msgid "5. COMBINING DOCUMENTS"
3287 msgstr "5. КОМБИНОВАЊЕ ДОКУМЕНАТА"
3288
3289 #. (itstool) path: para/link
3290 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
3291 msgid "section 4"
3292 msgstr "одељак 4"
3293
3294 #. (itstool) path: sect1/para
3295 #: C/fdl-appendix.xml:481
3296 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."
3297 msgstr "Можете комбиновати <_:link-1/> са другим документима објављеним под овом лиценцом, под условима дефинисаним у <_:link-2/> изнад за измењена издања, под условом да у комбинацију укључите све <_:link-3/> свих оригиналних докумената, неизмењене, и наведете их све као непроменљиве одељке вашег комбинованог дела у његовом обавештењу о лиценци."
3298
3299 #. (itstool) path: sect1/para
3300 #: C/fdl-appendix.xml:492
3301 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."
3302 msgstr "Комбиновано дело треба да садржи само један примерак ове лиценце, а више идентичних <_:link-1/> може бити замењено једним примерком. Ако постоји више непроменљивих одељака са истим именом али различитим садржајем, учините наслов сваког таквог одељка јединственим тако што ћете на његов крај додати, у заградама, име првобитног аутора или издавача тог одељка ако је познато, или у супротном јединствени број. Извршите исто прилагођавање насловима одељака на списку непроменљивих одељака у обавештењу о лиценци комбинованог дела."
3303
3304 #. (itstool) path: para/quote
3305 #: C/fdl-appendix.xml:511
3306 msgid "Endorsements."
3307 msgstr "Одобрења."
3308
3309 #. (itstool) path: sect1/para
3310 #: C/fdl-appendix.xml:505
3311 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/>"
3312 msgstr "У тој комбинацији, морате објединити све одељке под насловом <_:quote-1/> из различитих изворних докумената, формирајући један одељак под насловом <_:quote-2/>; исто тако обједините све одељке под насловом <_:quote-3/>, и све одељке под насловом <_:quote-4/>. Морате обрисати све одељке под насловом <_:quote-5/>"
3313
3314 #. (itstool) path: sect1/title
3315 #: C/fdl-appendix.xml:516
3316 msgid "6. COLLECTIONS OF DOCUMENTS"
3317 msgstr "6. ЗБИРКЕ ДОКУМЕНАТА"
3318
3319 #. (itstool) path: sect1/para
3320 #: C/fdl-appendix.xml:517
3321 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."
3322 msgstr "Можете направити збирку која се састоји од <_:link-1/> и других докумената објављених под овом лиценцом, и заменити појединачне примерке ове лиценце у различитим документима једним примерком који је укључен у збирку, под условом да се у свим осталим погледима придржавате правила ове лиценце за дословно умножавање сваког од тих докумената."
3323
3324 #. (itstool) path: sect1/para
3325 #: C/fdl-appendix.xml:527
3326 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."
3327 msgstr "Можете издвојити појединачни документ из такве збирке и дистрибуисати га појединачно под овом лиценцом, под условом да уметнете примерак ове лиценце у издвојени документ и да се у свим осталим погледима придржавате ове лиценце у вези са дословним умножавањем тог документа."
3328
3329 #. (itstool) path: sect1/title
3330 #: C/fdl-appendix.xml:537
3331 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
3332 msgstr "7. СПАЈАЊЕ СА НЕЗАВИСНИМ РАДОВИМА"
3333
3334 #. (itstool) path: para/quote
3335 #: C/fdl-appendix.xml:546
3336 msgid "aggregate"
3337 msgstr "обједињен"
3338
3339 #. (itstool) path: para/link
3340 #: C/fdl-appendix.xml:550
3341 msgid "Cover Text"
3342 msgstr "Текст насловнице"
3343
3344 #. (itstool) path: sect1/para
3345 #: C/fdl-appendix.xml:538
3346 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."
3347 msgstr "Обједињавање <_:link-1/> или његових деривата са другим засебним и независним документима или радовима, у или на свесци медијума за складиштење или дистрибуцију, не рачуна се као целина као <_:link-2/> Документа, под условом да се не траже ауторска права на обједињавање за то обједињавање. Такво обједињавање се назива <_:quote-3/>, и ова лиценца се не примењује на остале самосталне радове који су тако обједињени са Документом, због тога што су тако обједињени, ако они сами нису дериватни радови Документа. Ако је захтев за <_:link-4/> из <_:link-5/> применљив на ове примерке Документа, онда ако Документ чини мање од једне четвртине целог скупа, текстови насловнице Документа могу бити постављени на омоте који окружују само Документ унутар тог скупа. У супротном, морају се појавити на омотима око целог скупа."
3348
3349 #. (itstool) path: sect1/title
3350 #: C/fdl-appendix.xml:561
3351 msgid "8. TRANSLATION"
3352 msgstr "8. ПРЕВОД"
3353
3354 #. (itstool) path: sect1/para
3355 #: C/fdl-appendix.xml:562
3356 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."
3357 msgstr "Превод се сматра врстом измене, тако да можете дистрибуисати преводе <_:link-1/> под условима из <_:link-2/>. Замена <_:link-3/> преводима захтева посебну дозволу носилаца ауторских права, али можете укључити преводе неких или свих непроменљивих одељака поред изворних верзија тих непроменљивих одељака. Можете укључити превод ове лиценце под условом да такође укључите изворну енглеску верзију ове лиценце. У случају неслагања између превода и изворне енглеске верзије ове лиценце, изворна енглеска верзија ће имати предност."
3358
3359 #. (itstool) path: sect1/title
3360 #: C/fdl-appendix.xml:580
3361 msgid "9. TERMINATION"
3362 msgstr "9. ПРЕСТАНАК ВАЖЕЊА"
3363
3364 #. (itstool) path: sect1/para
3365 #: C/fdl-appendix.xml:581
3366 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."
3367 msgstr "Не смете умножавати, мењати, подлиценцирати или дистрибуисати <_:link-1/> осим како је изричито предвиђено овом лиценцом. Сваки други покушај умножавања, измене, подлиценцирања или дистрибуције Документа је ништаван и аутоматски ће прекинути ваша права под овом лиценцом. Међутим, странама које су од вас примиле примерке или права под овом лиценцом, лиценце неће бити прекинуте све док те стране остану у потпуности усклађене."
3368
3369 #. (itstool) path: sect1/title
3370 #: C/fdl-appendix.xml:594
3371 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
3372 msgstr "10. БУДУЋЕ РЕВИЗИЈЕ ОВЕ ЛИЦЕНЦЕ"
3373
3374 #. (itstool) path: para/ulink
3375 #: C/fdl-appendix.xml:597
3376 msgid "Free Software Foundation"
3377 msgstr "Задужбина за слободан софтвер"
3378
3379 #. (itstool) path: para/ulink
3380 #: C/fdl-appendix.xml:603
3381 msgid "http://www.gnu.org/copyleft/"
3382 msgstr "http://www.gnu.org/copyleft/"
3383
3384 #. (itstool) path: sect1/para
3385 #: C/fdl-appendix.xml:595
3386 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/>."
3387 msgstr "<_:ulink-1/> може с времена на време објављивати нове, ревидиране верзије ГНУ-ове лиценце за слободну документацију. Такве нове верзије ће бити сличне по духу садашњој верзији, али се могу разликовати у детаљима како би се решили нови проблеми или недоумице. Погледајте <_:ulink-2/>."
3388
3389 #. (itstool) path: para/quote
3390 #: C/fdl-appendix.xml:610
3391 msgid "or any later version"
3392 msgstr "или било које касније верзије"
3393
3394 #. (itstool) path: sect1/para
3395 #: C/fdl-appendix.xml:606
3396 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."
3397 msgstr "Свакој верзији лиценце дат је препознатљив број верзије. Ако <_:link-1/> наводи да се на њега примењује одређена нумерисана верзија ове лиценце <_:quote-2/>, имате могућност да се придржавате одредби и услова било те наведене верзије или било које касније верзије коју је објавила (не као нацрт) Задужбина за слободан софтвер. Ако Документ не наводи број верзије ове лиценце, можете изабрати било коју верзију коју је икада објавила (не као нацрт) Задужбина за слободан софтвер."
3398
3399 #. (itstool) path: sect1/title
3400 #: C/fdl-appendix.xml:621
3401 msgid "Addendum"
3402 msgstr "Додатак"
3403
3404 #. (itstool) path: sect1/para
3405 #: C/fdl-appendix.xml:622
3406 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:"
3407 msgstr "Да бисте користили ову лиценцу у документу који сте написали, укључите примерак лиценце у документ и ставите следећа обавештења о ауторским правима и лиценци одмах након насловне стране:"
3408
3409 #. (itstool) path: blockquote/para
3410 #: C/fdl-appendix.xml:629
3411 msgid "Copyright YEAR YOUR NAME."
3412 msgstr "Ауторска права ГОДИНА ВАШЕ ИМЕ."
3413
3414 #. (itstool) path: para/link
3415 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
3416 msgid "Front-Cover Texts"
3417 msgstr "Текстови предњег омота"
3418
3419 #. (itstool) path: para/link
3420 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
3421 msgid "Back-Cover Texts"
3422 msgstr "Текстови задњег омота"
3423
3424 #. (itstool) path: blockquote/para
3425 #: C/fdl-appendix.xml:632
3426 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/>."
3427 msgstr "Дозвољено је умножавање, дељење и/или мењање овог документа под условима ГНУ-ове Слободне документационе лиценце, верзије 1.1 или било које новије верзије коју објави Задужбина слободног софтвера; са <_:link-1/> који су НАВЕДИТЕ ЊИХОВЕ НАСЛОВЕ, са <_:link-2/> који су НАВЕДИТЕ, и са <_:link-3/> који су НАВЕДИТЕ. Примерак лиценце је укључен у одељку под насловом <_:quote-4/>."
3428
3429 #. (itstool) path: para/quote
3430 #: C/fdl-appendix.xml:649
3431 msgid "with no Invariant Sections"
3432 msgstr "без непроменљивих одељака"
3433
3434 #. (itstool) path: para/quote
3435 #: C/fdl-appendix.xml:652
3436 msgid "no Front-Cover Texts"
3437 msgstr "без текстова предњег омота"
3438
3439 #. (itstool) path: para/quote
3440 #: C/fdl-appendix.xml:653
3441 msgid "Front-Cover Texts being LIST"
3442 msgstr "Текстови предњег омота су НАВЕДИТЕ"
3443
3444 #. (itstool) path: sect1/para
3445 #: C/fdl-appendix.xml:647
3446 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/>."
3447 msgstr "Ако немате <_:link-1/>, напишите <_:quote-2/> уместо навођења који су непроменљиви. Ако немате <_:link-3/>, напишите <_:quote-4/> уместо <_:quote-5/>; исто важи и за <_:link-6/>."
3448
3449 #. (itstool) path: para/ulink
3450 #: C/fdl-appendix.xml:661
3451 msgid "GNU General Public License"
3452 msgstr "Гнуова општа јавна лиценца"
3453
3454 #. (itstool) path: sect1/para
3455 #: C/fdl-appendix.xml:657
3456 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."
3457 msgstr "Ако ваш документ садржи нетривијалне примере програмског кода, препоручујемо да ове примере објавите упоредо под слободном софтверском лиценцом по вашем избору, као што је <_:ulink-1/>, како бисте омогућили њихово коришћење у слободном софтверу."