Debian Codegraph @

help/manual/sl/sl.po

raw
1 # Slovenian translation for gtk-doc.
2 # Copyright (C) 2010 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 #
5 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
6 #
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: gtk-doc help master\n"
10 "POT-Creation-Date: 2024-03-14 14:02+0000\n"
11 "PO-Revision-Date: 2024-03-30 18:39+0100\n"
12 "Last-Translator: Martin Srebotnjak <[email protected]>\n"
13 "Language-Team: Slovenian GNOME Translation Team <[email protected]>\n"
14 "Language: sl_SI\n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18 "Plural-Forms: nplurals=4; plural=(n%100==1 ? 1 : n%100==2 ? 2 : n%100==3 || n"
19 "%100==4 ? 3 : 0);\n"
20 "X-Poedit-SourceCharset: utf-8\n"
21 "X-Generator: Poedit 2.2.1\n"
22
23 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
24 msgctxt "_"
25 msgid "translator-credits"
26 msgstr ""
27 "Matej Urbančič <[email protected]>\n"
28 "Martin Srebotnjak <[email protected]>"
29
30 #. (itstool) path: bookinfo/title
31 #: C/index.docbook:12
32 msgid "GTK-Doc Manual"
33 msgstr "Priročnik GTK-Doc"
34
35 #. (itstool) path: bookinfo/edition
36 #: C/index.docbook:13
37 msgid "1.24.1"
38 msgstr "1.24.1"
39
40 #. (itstool) path: abstract/para
41 #: C/index.docbook:14
42 msgid "User manual for developers with instructions of GTK-Doc usage."
43 msgstr "Uporabniški priročnik za razvijalce z navodili za uporabo GTK-Doc."
44
45 #. (itstool) path: authorgroup/author
46 #: C/index.docbook:16
47 msgid ""
48 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
49 "<address> <email>[email protected]</email> </address> </affiliation>"
50 msgstr ""
51 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
52 "<address> <email>[email protected]</email> </address> </affiliation>"
53
54 #. (itstool) path: authorgroup/author
55 #: C/index.docbook:25
56 msgid ""
57 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
58 "<email>[email protected]</email> </address> </affiliation>"
59 msgstr ""
60 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
61 "<email>[email protected]</email> </address> </affiliation>"
62
63 #. (itstool) path: authorgroup/author
64 #: C/index.docbook:34
65 msgid ""
66 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
67 "<address> <email>[email protected]</email> </address> </affiliation>"
68 msgstr ""
69 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
70 "<address> <email>[email protected]</email> </address> </affiliation>"
71
72 #. (itstool) path: publisher/publishername
73 #: C/index.docbook:45
74 msgid "GTK-Doc project"
75 msgstr "Projekt GTK-Doc"
76
77 #. (itstool) path: bookinfo/publisher
78 #: C/index.docbook:44
79 msgid ""
80 "<_:publishername-1/> <address><email>[email protected]</email></address>"
81 msgstr ""
82 "<_:publishername-1/><address><email>[email protected]</email></address>"
83
84 #. (itstool) path: bookinfo/copyright
85 #: C/index.docbook:48
86 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
87 msgstr "<year>2000, 2005</year> <holder>Dan Mueth in Chris Lyttle</holder>"
88
89 #. (itstool) path: bookinfo/copyright
90 #: C/index.docbook:52
91 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
92 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
93
94 #. (itstool) path: legalnotice/para
95 #: C/index.docbook:65
96 #, fuzzy
97 msgid ""
98 "Permission is granted to copy, distribute and/or modify this document under "
99 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
100 "Version 1.1 or any later version published by the Free Software Foundation "
101 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
102 "copy of the license is <link linkend=\"fdl\">included</link>."
103 msgstr ""
104 "Dovoljenje za kopiranje, distribucijo in/ali spreminjanje tega dokumenta je "
105 "podeljeno pod pogoji <citetitle>licence GNU za prosto dokumentacijo</"
106 "citetitle>, različica 1.1 ali katera koli novejša različica, ki jo je "
107 "objavila Free Software Foundation brez nespremenljivih odsekov, besedil na "
108 "sprednji strani in besedil na zadnji platnici. Priložena je <link linkend="
109 "\"fdl\">kopija licence."
110
111 #. (itstool) path: legalnotice/para
112 #: C/index.docbook:73
113 #, fuzzy
114 msgid ""
115 "Many of the names used by companies to distinguish their products and "
116 "services are claimed as trademarks. Where those names appear in any GNOME "
117 "documentation, and those trademarks are made aware to the members of the "
118 "GNOME Documentation Project, the names have been printed in caps or initial "
119 "caps."
120 msgstr ""
121 "Mnoga imena, ki jih podjetja uporabljajo za razlikovanje svojih izdelkov in "
122 "storitev, se uveljavljajo kot blagovne znamke. Če so ta imena navedena v "
123 "kateri koli dokumentaciji GNOME in so te blagovne znamke sporočene članom "
124 "dokumentacijskega projekta GNOME, so bila imena natisnjena z velikimi ali "
125 "začetnimi kapicami."
126
127 #. (itstool) path: revhistory/revision
128 #: C/index.docbook:83
129 #, fuzzy
130 msgid ""
131 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
132 "authorinitials> <revremark>gtk4 version</revremark>"
133 msgstr ""
134 "<revnumber>1.33.0</revnumber> <date>1. oktober 2020</date> "
135 "<authorinitials>mc</authorinitials> <revremark>gtk4 različica</revremark>"
136
137 #. (itstool) path: revhistory/revision
138 #: C/index.docbook:89
139 #, fuzzy
140 msgid ""
141 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
142 "authorinitials> <revremark>dev version</revremark>"
143 msgstr ""
144 "<revnumber>1.32.1</revnumber> <date>15. avgust 2019</date> "
145 "<revremark>Različica za razvijalce</revremark> <authorinitials>ss</"
146 "authorinitials>"
147
148 #. (itstool) path: revhistory/revision
149 #: C/index.docbook:95
150 #, fuzzy
151 msgid ""
152 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
153 "authorinitials> <revremark>hotfix release</revremark>"
154 msgstr ""
155 "<revnumber>1.32</revnumber> <date>15. avgust 2019</date> <revremark>Izdaja "
156 "sprotnega popravka</revremark> <authorinitials>za ss</authorinitials>"
157
158 #. (itstool) path: revhistory/revision
159 #: C/index.docbook:101
160 #, fuzzy
161 msgid ""
162 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
163 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
164 msgstr ""
165 "<revnumber>1.31</revnumber> <date>05 Avgust 2019</date> <authorinitials>SS</"
166 "authorinitials> <revremark>refaktoringi in več pokritosti testov</revremark>"
167
168 #. (itstool) path: revhistory/revision
169 #: C/index.docbook:107
170 #, fuzzy
171 msgid ""
172 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
173 "authorinitials> <revremark>more test coverage</revremark>"
174 msgstr ""
175 "<revnumber>1.30</revnumber> <date>08 maj 2019</date> <authorinitials>ss</"
176 "authorinitials> <revremark>več pokritosti testov</revremark>"
177
178 #. (itstool) path: revhistory/revision
179 #: C/index.docbook:113
180 #, fuzzy
181 msgid ""
182 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
183 "authorinitials> <revremark>bug fixes</revremark>"
184 msgstr ""
185 "<revnumber>1.29</revnumber> <date>28. avgust 2018</date> <revremark>Popravki "
186 "napak</revremark> <authorinitials>ss</authorinitials>"
187
188 #. (itstool) path: revhistory/revision
189 #: C/index.docbook:119
190 #, fuzzy
191 msgid ""
192 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
193 "authorinitials> <revremark>bug fixes</revremark>"
194 msgstr ""
195 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <revremark>Popravki "
196 "napak</revremark> <authorinitials>ss</authorinitials>"
197
198 #. (itstool) path: revhistory/revision
199 #: C/index.docbook:125
200 #, fuzzy
201 msgid ""
202 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
203 "authorinitials> <revremark>fine tuning of the python port</revremark>"
204 msgstr ""
205 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
206 "authorinitials> <revremark>fino nastavitev vrat python</revremark>"
207
208 #. (itstool) path: revhistory/revision
209 #: C/index.docbook:131
210 #, fuzzy
211 msgid ""
212 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
213 "authorinitials> <revremark>port all tools from perl/bash to python</"
214 "revremark>"
215 msgstr ""
216 "<revnumber>1.26</revnumber> <date>11. avgust 2017</date> <authorinitials>SS,"
217 "</authorinitials> <revremark>vrata vsa orodja od Perl/Bash, do Pythona;</"
218 "revremark>"
219
220 #. (itstool) path: revhistory/revision
221 #: C/index.docbook:137
222 #, fuzzy
223 msgid ""
224 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
225 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
226 msgstr ""
227 "<revnumber>1.25</revnumber> <date>21. marec 2016</date> <authorinitials></"
228 "authorinitials> <revremark>Popravki napak SS, Testno čiščenje</revremark>"
229
230 #. (itstool) path: revhistory/revision
231 #: C/index.docbook:143
232 #, fuzzy
233 msgid ""
234 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
235 "authorinitials> <revremark>bug fix</revremark>"
236 msgstr ""
237 "<revnumber>1.24</revnumber> <date>29. maj 2015</date> "
238 "<revremark>Odpravljanje napak</revremark> <authorinitials>ss</authorinitials>"
239
240 #. (itstool) path: revhistory/revision
241 #: C/index.docbook:149
242 #, fuzzy
243 msgid ""
244 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
245 "authorinitials> <revremark>bug fix</revremark>"
246 msgstr ""
247 "<revnumber>1.23</revnumber> <date>17. maj 2015</date> "
248 "<revremark>Odpravljanje napak</revremark> <authorinitials>ss</authorinitials>"
249
250 #. (itstool) path: revhistory/revision
251 #: C/index.docbook:155
252 #, fuzzy
253 msgid ""
254 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
255 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
256 "revremark>"
257 msgstr ""
258 "<revnumber>1.22</revnumber> <date>07 maj 2015</date> <authorinitials></"
259 "authorinitials> <revremark>Popravki napak SS, opustitev zastarelih funkcij</"
260 "revremark>"
261
262 #. (itstool) path: revhistory/revision
263 #: C/index.docbook:161
264 #, fuzzy
265 msgid ""
266 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
267 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
268 "revremark>"
269 msgstr ""
270 "<revnumber>1.21</revnumber> <date>17. julij 2014</date> <authorinitials></"
271 "authorinitials> <revremark>Popravki napak SS, opustitev zastarelih funkcij</"
272 "revremark>"
273
274 #. (itstool) path: revhistory/revision
275 #: C/index.docbook:167
276 #, fuzzy
277 msgid ""
278 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
279 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
280 "revremark>"
281 msgstr ""
282 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials></"
283 "authorinitials> <revremark>Popravki napak SS, podpora za označevanje, "
284 "izboljšave sloga</revremark>"
285
286 #. (itstool) path: revhistory/revision
287 #: C/index.docbook:173
288 #, fuzzy
289 msgid ""
290 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
291 "authorinitials> <revremark>bug fixes</revremark>"
292 msgstr ""
293 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <revremark>Popravki "
294 "napak</revremark> <authorinitials>ss</authorinitials>"
295
296 #. (itstool) path: revhistory/revision
297 #: C/index.docbook:179
298 #, fuzzy
299 msgid ""
300 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
301 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
302 msgstr ""
303 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>SS</"
304 "authorinitials> <revremark>popravki napak, pospešitve, podpora za "
305 "označevanje</revremark>"
306
307 #. (itstool) path: revhistory/revision
308 #: C/index.docbook:185
309 #, fuzzy
310 msgid ""
311 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
312 "authorinitials> <revremark>urgent bug fix update</revremark>"
313 msgstr ""
314 "<revnumber>1.17</revnumber>, <date>26. februar 2011</date> "
315 "<authorinitials>SK</authorinitials> <revremark>nujna posodobitev za "
316 "odpravljanje napak</revremark>"
317
318 #. (itstool) path: revhistory/revision
319 #: C/index.docbook:191
320 #, fuzzy
321 msgid ""
322 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
323 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
324 msgstr ""
325 "<revnumber>1.16</revnumber> <date>14 Jan 2011 sk</date> <authorinitials></"
326 "authorinitials> <revremark>bugfixes, izboljšave postavitve</revremark>"
327
328 #. (itstool) path: revhistory/revision
329 #: C/index.docbook:197
330 #, fuzzy
331 msgid ""
332 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
333 "authorinitials> <revremark>bug and regression fixes</revremark>"
334 msgstr ""
335 "<revnumber>1.15</revnumber> <date>21. maj 2010</date> <authorinitials>SK</"
336 "authorinitials> <revremark>popravki napak in regresije</revremark>"
337
338 #. (itstool) path: revhistory/revision
339 #: C/index.docbook:203
340 #, fuzzy
341 msgid ""
342 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
343 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
344 msgstr ""
345 "<revnumber>1.14</revnumber> <date>28. marec 2010</date> <revremark>Popravki "
346 "napak in izboljšave učinkovitosti delovanja</revremark> <authorinitials>SK</"
347 "authorinitials>"
348
349 #. (itstool) path: revhistory/revision
350 #: C/index.docbook:209
351 #, fuzzy
352 msgid ""
353 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
354 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
355 "revremark>"
356 msgstr ""
357 "<revnumber>1.13</revnumber> <date>18. december 2009</date> "
358 "<authorinitials>SK</authorinitials> <revremark>je prekinil posodobitev "
359 "tarballa</revremark>"
360
361 #. (itstool) path: revhistory/revision
362 #: C/index.docbook:215
363 #, fuzzy
364 msgid ""
365 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
366 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
367 "bugfixes</revremark>"
368 msgstr ""
369 "<revnumber>1.12</revnumber> <date>18. december 2009</date> "
370 "<authorinitials>SK</authorinitials> <revremark>Nove funkcije orodij in "
371 "popravki napak</revremark>"
372
373 #. (itstool) path: revhistory/revision
374 #: C/index.docbook:221
375 #, fuzzy
376 msgid ""
377 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
378 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
379 "revremark>"
380 msgstr ""
381 "<revnumber>1.11</revnumber> <date>16. november 2008</date> "
382 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migracija</"
383 "revremark>"
384
385 #. (itstool) path: chapter/title
386 #: C/index.docbook:234
387 msgid "Introduction"
388 msgstr "Uvod"
389
390 #. (itstool) path: chapter/para
391 #: C/index.docbook:236
392 #, fuzzy
393 msgid ""
394 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
395 "it is used."
396 msgstr ""
397 "To poglavje predstavlja GTK-Doc in podaja pregled, kaj je in kako se "
398 "uporablja."
399
400 #. (itstool) path: sect1/title
401 #: C/index.docbook:242
402 msgid "What is GTK-Doc?"
403 msgstr "Kaj je GTK-Doc?"
404
405 #. (itstool) path: sect1/para
406 #: C/index.docbook:244
407 #, fuzzy
408 msgid ""
409 "GTK-Doc is used to document C code. It is typically used to document the "
410 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
411 "also be used to document application code."
412 msgstr ""
413 "GTK-Doc se uporablja za dokumentiranje kode C. Običajno se uporablja za "
414 "dokumentiranje javnega API-ja knjižnic, kot sta knjižnici GTK+ in GNOME. "
415 "Lahko pa se uporablja tudi za dokumentiranje kode aplikacije."
416
417 #. (itstool) path: sect1/title
418 #: C/index.docbook:252
419 msgid "How Does GTK-Doc Work?"
420 msgstr "Kako deluje GTK-Doc?"
421
422 #. (itstool) path: sect1/para
423 #: C/index.docbook:254
424 #, fuzzy
425 msgid ""
426 "GTK-Doc works by using documentation of functions placed inside the source "
427 "files in specially-formatted comment blocks, or documentation added to the "
428 "template files which GTK-Doc uses (though note that GTK-Doc will only "
429 "document functions that are declared in header files; it won't produce "
430 "output for static functions)."
431 msgstr ""
432 "GTK-Doc deluje tako, da uporablja dokumentacijo funkcij, nameščenih znotraj "
433 "izvornih datotek v posebej oblikovanih blokih komentarjev, ali "
434 "dokumentacijo, dodano datotekam predlog, ki jih uporablja GTK-Doc (čeprav "
435 "upoštevajte, da bo GTK-Doc dokumentiral samo funkcije, ki so deklarirane v "
436 "datotekah z glavo; ne bo ustvaril izhoda za statične funkcije)."
437
438 #. (itstool) path: sect1/para
439 #: C/index.docbook:261
440 #, fuzzy
441 msgid ""
442 "GTK-Doc consists of a number of python scripts, each performing a different "
443 "step in the process."
444 msgstr ""
445 "GTK-Doc je sestavljen iz številnih skriptov python, od katerih vsak izvaja "
446 "drugačen korak v procesu."
447
448 #. (itstool) path: sect1/para
449 #: C/index.docbook:266
450 msgid "There are 5 main steps in the process:"
451 msgstr "Postopek obsega pet glavnih korakov:"
452
453 #. (itstool) path: listitem/para
454 #: C/index.docbook:273
455 #, fuzzy
456 msgid ""
457 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
458 "source files with the documentation for each function, macro, structs or "
459 "unions, etc."
460 msgstr ""
461 "<guilabel>Pisanje dokumentacije.</guilabel> Avtor izpolni izvorne datoteke z "
462 "dokumentacijo za vsako funkcijo, makro, strukture ali združitve itd."
463
464 #. (itstool) path: listitem/para
465 #: C/index.docbook:282
466 #, fuzzy
467 msgid ""
468 "<guilabel>Gathering information about the code.</guilabel> "
469 "<application>gtkdoc-scan</application> scans the header files of the code "
470 "looking for declarations of functions, macros, enums, structs, and unions. "
471 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
472 "containing a list of the declarations, placing them into sections according "
473 "to which header file they are in. On the first run this file is copied to "
474 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
475 "the sections, and the order of the declarations within them, to produce the "
476 "final desired order. The second file it generates is <filename>&lt;"
477 "module&gt;-decl.txt</filename>. This file contains the full declarations "
478 "found by the scanner. If for some reason one would like some symbols to show "
479 "up in the docs, where the full declaration cannot be found by the scanner or "
480 "the declaration should appear differently, one can place entities similar to "
481 "the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
482 "module&gt;-overrides.txt</filename>."
483 msgstr ""
484 "<guilabel>Zbiranje informacij o kodi.</guilabel> <application>GTKDOC-scan</"
485 "application> skenira datoteke glave kode in išče deklaracije funkcij, "
486 "makrov, enumov, struktur in združitev. Ustvari datoteko <filename>&lt;"
487 "modul&gt;-decl-list.txt</filename> ki vsebuje seznam deklaracij, in jih "
488 "razvrsti v razdelke, glede na to, v kateri glavni datoteki so. Ob prvem "
489 "zagonu se ta datoteka kopira v <filename>&lt;modul&gt;-sections.txt</"
490 "filename>. Avtor lahko preuredi odseke in vrstni red deklaracij v njih, da "
491 "izdela končni želeni vrstni red. Druga datoteka, ki jo ustvari, je "
492 "<filename>&lt;modul&gt;-decl.txt</filename>. Ta datoteka vsebuje popolne "
493 "deklaracije, ki jih najde optični bralnik. Če bi iz nekega razloga želeli, "
494 "da se v dokumentih prikažejo nekateri simboli, kjer skener ne more najti "
495 "popolne deklaracije ali bi morala biti deklaracija videti drugače, lahko "
496 "entitete, podobne tistim v <filename>&lt;modulu&gt;-decl.txt</filename> "
497 "postavimo v <filename>&lt;modul&gt;-overrides.txt</filename>."
498
499 #. (itstool) path: listitem/para
500 #: C/index.docbook:299
501 #, fuzzy
502 msgid ""
503 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
504 "query a library about any GObject subclasses it exports. It saves "
505 "information about each object's position in the class hierarchy and about "
506 "any GObject properties and signals it provides."
507 msgstr ""
508 "<application>Gtkdoc-scangobj</application> lahko uporabite tudi za dinamično "
509 "poizvedovanje po knjižnici o vseh podrazredih GObject, ki jih izvaža. "
510 "Shranjuje informacije o položaju vsakega predmeta v hierarhiji razreda ter o "
511 "vseh lastnostih in signalih GObject, ki jih zagotavlja."
512
513 #. (itstool) path: listitem/para
514 #: C/index.docbook:305
515 #, fuzzy
516 msgid ""
517 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
518 "needed in the past when GObject was still GtkObject inside gtk+."
519 msgstr ""
520 "<application>GTKDOC-scanobj</application> se ne sme več uporabljati. "
521 "Potreben je bil v preteklosti, ko je bil GObject še vedno GtkObject znotraj "
522 "gtk +."
523
524 #. (itstool) path: listitem/para
525 #: C/index.docbook:312
526 #, fuzzy
527 msgid ""
528 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
529 "mkdb</application> turns the template files into XML files in the <filename "
530 "class=\"directory\">xml/</filename> subdirectory. If the source code "
531 "contains documentation on functions, using the special comment blocks, it "
532 "gets merged in here. If there are no tmpl files used it only reads docs from "
533 "sources and introspection data."
534 msgstr ""
535 "<guilabel>Ustvarjanje XML in HTML/PDF.</guilabel> <application>gtkdoc-mkdb</"
536 "application> pretvori datoteke predloge v datoteke XML v podimeniku "
537 "<filename class=\"directory\">xml/</filename> . Če izvorna koda vsebuje "
538 "dokumentacijo o funkcijah z uporabo posebnih blokov komentarjev, se tukaj "
539 "združi. Če ni uporabljenih datotek tmpl, bere samo dokumente iz virov in "
540 "podatke introspekcije."
541
542 #. (itstool) path: listitem/para
543 #: C/index.docbook:321
544 #, fuzzy
545 msgid ""
546 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
547 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
548 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
549 "document called <filename>&lt;package&gt;.pdf</filename>."
550 msgstr ""
551 "<application>gtkdoc-mkhtml</application> pretvori datoteke XML v datoteke "
552 "HTML v podimeniku <filename class=\"directory\">html/</filename> . Prav tako "
553 "<application>gtkdoc-mkpdf</application> pretvori datoteke XML v dokument "
554 "PDF, imenovan <filename>&lt;paket&gt;.pdf</filename>."
555
556 #. (itstool) path: listitem/para
557 #: C/index.docbook:327
558 #, fuzzy
559 msgid ""
560 "Files in <filename class=\"directory\">xml/</filename> and <filename class="
561 "\"directory\">html/</filename> directories are always overwritten. One "
562 "should never edit them directly."
563 msgstr ""
564 "Datoteke v <filename class=\"directory\">imenikih xml /</filename> in "
565 "<filename class=\"directory\">html/</filename> so vedno prepisane. Nikoli "
566 "jih ne bi smeli urejati neposredno."
567
568 #. (itstool) path: listitem/para
569 #: C/index.docbook:335
570 #, fuzzy
571 msgid ""
572 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
573 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
574 "run to fix up any cross-references between separate documents. For example, "
575 "the GTK+ documentation contains many cross-references to types documented in "
576 "the GLib manual. When creating the source tarball for distribution, "
577 "<application>gtkdoc-rebase</application> turns all external links into web-"
578 "links. When installing distributed (pregenerated) docs the same application "
579 "will try to turn links back to local links (where those docs are installed)."
580 msgstr ""
581 "<guilabel>Določanje navzkrižnih sklicev med dokumenti.</guilabel> Po "
582 "namestitvi datotek HTML lahko zaženete <application>gtkdoc-fixxref</"
583 "application> , da popravite morebitne navzkrižne sklice med ločenimi "
584 "dokumenti. Dokumentacija GTK+ na primer vsebuje veliko sklicevanj na vrste, "
585 "dokumentirane v priročniku GLib. Pri ustvarjanju izvorne tarball za "
586 "distribucijo <application>gtkdoc-rebase</application> pretvori vse zunanje "
587 "povezave v spletne povezave. Pri nameščanju porazdeljenih (vnaprej "
588 "generiranih) dokumentov bo ista aplikacija poskušala obrniti povezave nazaj "
589 "na lokalne povezave (kjer so ti dokumenti nameščeni)."
590
591 #. (itstool) path: sect1/title
592 #: C/index.docbook:353
593 msgid "Getting GTK-Doc"
594 msgstr "Pridobivanje GTK-Doc"
595
596 #. (itstool) path: sect2/title
597 #: C/index.docbook:356
598 msgid "Requirements"
599 msgstr "Zahteve"
600
601 #. (itstool) path: sect2/para
602 #: C/index.docbook:357
603 #, fuzzy
604 msgid ""
605 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
606 msgstr ""
607 "<guilabel>Python 2/3</guilabel> - glavne skripte so napisane v Pythonu."
608
609 #. (itstool) path: sect2/para
610 #: C/index.docbook:360
611 #, fuzzy
612 msgid ""
613 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
614 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
615 msgstr ""
616 "<guilabel>XSLTPROC</guilabel> - procesor XSLT podjetja Libxslt <ulink url="
617 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
618
619 #. (itstool) path: sect2/para
620 #: C/index.docbook:364
621 #, fuzzy
622 msgid ""
623 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="
624 "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
625 "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
626 msgstr ""
627 "<guilabel>Docbook-XSL</guilabel> - Docbook XSL slogovne predloge <ulink url="
628 "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
629 "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
630
631 #. (itstool) path: sect2/para
632 #: C/index.docbook:368
633 #, fuzzy
634 msgid ""
635 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
636 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
637 "examples"
638 msgstr ""
639 "Eden od <guilabel>označevalcev vira</guilabel>, <guilabel>poudarkov</"
640 "guilabel> ali <guilabel>vim</guilabel> - izbirno - ki se uporablja za "
641 "označevanje primerov v skladnji"
642
643 #. (itstool) path: sect1/title
644 #: C/index.docbook:376
645 msgid "About GTK-Doc"
646 msgstr "O GTK-Doc"
647
648 #. (itstool) path: sect1/para
649 #: C/index.docbook:378
650 #, fuzzy
651 msgid ""
652 "Historically GTK-Doc was used to generate template files from the sources "
653 "code. These template files could be used by developers to enter the API "
654 "documentation. This approach was rather inconvenient because it required to "
655 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
656 "possible to place all API information into source comments, which made the "
657 "template support obsolete. In version 1.26 template support has been removed."
658 msgstr ""
659 "V preteklosti je bil GTK-Doc uporabljen za ustvarjanje datotek predlog iz "
660 "izvorne kode. Razvijalci lahko te datoteke predlog uporabijo za vnos "
661 "dokumentacije API-ja. Ta pristop je bil precej neprimeren, ker je zahteval, "
662 "da ustvarjene datoteke ostanejo pod nadzorom različice. Od GTK-Doc 1.9 je "
663 "bilo mogoče vse informacije o API-ju postaviti v izvorne komentarje, zaradi "
664 "česar je podpora predloge zastarela. V različici 1.26 je bila podpora "
665 "predloge odstranjena."
666
667 #. (itstool) path: sect1/para
668 #: C/index.docbook:388 C/index.docbook:402
669 msgid "(FIXME)"
670 msgstr "(POPRAVIME)"
671
672 #. (itstool) path: sect1/para
673 #: C/index.docbook:392
674 msgid ""
675 "(authors, web pages, mailing list, license, future plans, comparison with "
676 "other similar systems.)"
677 msgstr ""
678 "(avtorji, spletne strani, poštni seznam, dovoljenje, prihodnji načrti, "
679 "primerjava z drugimi podobnimi sistemi)"
680
681 #. (itstool) path: sect1/title
682 #: C/index.docbook:400
683 msgid "About this Manual"
684 msgstr "O tem priročniku"
685
686 #. (itstool) path: sect1/para
687 #: C/index.docbook:406
688 msgid "(who it is meant for, where you can get it, license)"
689 msgstr "(komu je namenjen, kje ga lahko dobite, dovoljenje)"
690
691 #. (itstool) path: chapter/title
692 #: C/index.docbook:415
693 #, fuzzy
694 msgid "Project Setup"
695 msgstr "Nastavitev projekta"
696
697 #. (itstool) path: chapter/para
698 #: C/index.docbook:417
699 #, fuzzy
700 msgid ""
701 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
702 "into your project. The integration of GTK-Doc into a project includes the "
703 "following steps:"
704 msgstr ""
705 "V tem poglavju so opisani koraki, ki so potrebni za integracijo GTK-Doc v "
706 "projekt. Integracija GTK-Doc v projekt vključuje naslednje korake:"
707
708 #. (itstool) path: listitem/para
709 #: C/index.docbook:425
710 #, fuzzy
711 msgid ""
712 "Preparation of the directory structure and creating required configuration "
713 "files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles"
714 "\"> Setting up a skeleton documentation</link>)."
715 msgstr ""
716 "Priprava strukture imenika in ustvarjanje zahtevanih konfiguracijskih "
717 "datotek za dokumentacijo GTK-Doc (glejte <link linkend=\"settingup_docfiles"
718 "\"> Nastavitev skeletne dokumentacije)."
719
720 #. (itstool) path: listitem/para
721 #: C/index.docbook:433
722 #, fuzzy
723 msgid ""
724 "Adjusting the build system to build your documentation using the GTK-Doc "
725 "tools. Multiple build systems are supported, in this manual we describe how "
726 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
727 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link linkend="
728 "\"settingup_plain_makefiles\">plain Makefiles</link>."
729 msgstr ""
730 "Prilagoditev sistema gradnje za izdelavo dokumentacije z orodji GTK-Doc. "
731 "Podprtih je več gradbenih sistemov, v tem priročniku opisujemo, kako "
732 "integrirati GTK-Doc z <link linkend=\"settingup_autotools\">Autotools, <link "
733 "linkend=\"settingup_cmake\">CMake in <link linkend="
734 "\"settingup_plain_makefiles\">navadnimi Makefiles."
735
736 #. (itstool) path: listitem/para
737 #: C/index.docbook:443
738 #, fuzzy
739 msgid ""
740 "Adding GTK-Doc specific files to version control and deciding which files to "
741 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
742 "control systems</link>)."
743 msgstr ""
744 "Dodajanje specifičnih datotek GTK-Doc za nadzor različic in odločanje o tem, "
745 "katere datoteke prezreti (glejte <link linkend=\"settingup_vcs\"> "
746 "Integracija s sistemi za nadzor različic)."
747
748 #. (itstool) path: chapter/para
749 #: C/index.docbook:451
750 #, fuzzy
751 msgid ""
752 "The following sections assume we work on a project called <code>meep</code>. "
753 "This project contains two packages (or modules), a library called "
754 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
755 msgstr ""
756 "Naslednji razdelki predvidevajo, da delamo na projektu, imenovanem "
757 "<code>meep</code>. Ta projekt vsebuje dva paketa (ali modula), knjižnico, "
758 "imenovano <code>libmeep</code> in aplikacijo za končnega uporabnika, "
759 "imenovano <code>meeper</code>."
760
761 #. (itstool) path: sect1/title
762 #: C/index.docbook:460
763 #, fuzzy
764 msgid "Setting up a skeleton documentation"
765 msgstr "Nastavitev skeletne dokumentacije"
766
767 #. (itstool) path: sect1/para
768 #: C/index.docbook:462
769 #, fuzzy
770 msgid ""
771 "A common convention is to place documentation into a folder called "
772 "<code>docs</code> inside your top-level project directory. We usually "
773 "distinguish between <emphasis>reference documentation</emphasis> intended "
774 "for developers and an <emphasis>user manual</emphasis> intended for end-"
775 "users. Again the convention is to have separate folders for both. We usually "
776 "place the reference documentation in a folder named <code>reference</code> "
777 "and the end-user manual in a folder named <code>help</code> as. According to "
778 "the above convention the documentation for our <code>libmeep</code> package "
779 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
780 "just one library or application the documentation could also be placed "
781 "directly into <code>docs/reference</code>. It is not mandatory to use the "
782 "above convention, but if you choose to use a different directory structure "
783 "you must adjust your build system configuration to match your directory "
784 "structure."
785 msgstr ""
786 "Običajen dogovor je, da dokumentacijo vstavite v mapo, ki se imenuje "
787 "<code>docs</code> v imeniku projektov najvišje ravni. Običajno razlikujemo "
788 "med <emphasis>referenčno dokumentacijo</emphasis> , namenjeno razvijalcem, "
789 "in <emphasis>uporabniškim priročnikom</emphasis> , namenjenim končnim "
790 "uporabnikom. Ponovno, konvencija je, da imajo ločene mape za oba. Običajno "
791 "postavimo referenčno dokumentacijo v mapo z imenom <code>reference</code> in "
792 "priročnik za končnega uporabnika v mapo <code>help</code> , imenovano kot. V "
793 "skladu z zgornjo konvencijo bo dokumentacija za naš <code>libmeep</code> "
794 "paket vstavljena v: <code>docs/reference/libmeep</code>. Za pakete s samo "
795 "eno knjižnico ali aplikacijo lahko dokumentacijo postavite tudi neposredno v "
796 "<code>docs/reference</code>. Uporaba zgornjega dogovora ni obvezna, če pa se "
797 "odločite za uporabo druge strukture imenika, morate prilagoditi "
798 "konfiguracijo sistema gradnje, da se ujema s strukturo imenika."
799
800 #. (itstool) path: example/title
801 #: C/index.docbook:493
802 #, fuzzy
803 msgid "Example directory structure of <emphasis>meep</emphasis> project"
804 msgstr "Primer strukture imenika projekta <emphasis>EP</emphasis>"
805
806 #. (itstool) path: example/programlisting
807 #: C/index.docbook:495
808 #, fuzzy, no-wrap
809 msgid ""
810 "\n"
811 "meep/\n"
812 " docs/\n"
813 " reference/ # reference documentation\n"
814 " libmeep/\n"
815 " meeper/\n"
816 " help/ # optional: user manual\n"
817 " meeper/\n"
818 " src/\n"
819 " libmeep/\n"
820 " meeper/\n"
821 msgstr ""
822 "\n"
823 "Poslanec Evropskega parlamenta/\n"
824 " Docs/\n"
825 " Sklic/ # referenčna dokumentacija\n"
826 " libmeep/\n"
827 " Meeper/\n"
828 " pomoč/ # neobvezno: navodila za uporabo\n"
829 " Meeper/\n"
830 " ZRC/\n"
831 " libmeep/\n"
832 " Meeper/\n"
833
834 #. (itstool) path: sect1/para
835 #: C/index.docbook:487
836 #, fuzzy
837 msgid ""
838 "In the following sections we will assume a directory structure for our "
839 "<emphasis>meep</emphasis> project that uses the above conventions. <_:"
840 "example-1/>"
841 msgstr ""
842 "V naslednjih razdelkih bomo prevzeli imeniško strukturo za naš projekt "
843 "<emphasis>EP</emphasis> , ki uporablja zgornje dogovore. <_:example-1/>"
844
845 #. (itstool) path: sect1/title
846 #: C/index.docbook:512
847 #, fuzzy
848 msgid "Integration with Autotools"
849 msgstr "Integracija z avtoorodji"
850
851 #. (itstool) path: sect1/para
852 #: C/index.docbook:513
853 #, fuzzy
854 msgid ""
855 "Integration of GTK-Doc into an autotools-based build system requires the "
856 "following steps:"
857 msgstr ""
858 "Integracija GTK-Doc v sistem gradnje, ki temelji na avtoorodjih, zahteva "
859 "naslednje korake:"
860
861 #. (itstool) path: listitem/para
862 #: C/index.docbook:519
863 #, fuzzy
864 msgid ""
865 "Ensure that <application>gtkdocize</application> is run once before the "
866 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
867 "script is present, adjust it to check for GTK-Doc and add a call to "
868 "<application>gtkdocize</application>."
869 msgstr ""
870 "Prepričajte se, da se <application>gtkdocize</application> zažene enkrat "
871 "pred <filename>konfiguracijo</filename> skripta. Če je prisoten "
872 "<filename>skript autogen.sh</filename> , ga prilagodite, da preverite, ali "
873 "je na voljo GTK-Doc, in dodajte klic <application>v gtkdocize</application>."
874
875 #. (itstool) path: listitem/para
876 #: C/index.docbook:527
877 #, fuzzy
878 msgid ""
879 "The main purpose of <application>gtkdocize</application> is to make the "
880 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
881 "filename> macro definition file available to the build system, either by "
882 "copying or linking it into the project."
883 msgstr ""
884 "Glavni namen <application>gtkdocize</application> je, da je <filename>gtk-"
885 "doc.make</filename> Makefile in datoteka za makro definicijo <filename>gtk-"
886 "doc.m4</filename> na voljo sistemu gradnje, bodisi s kopiranjem ali "
887 "povezovanjem v projekt."
888
889 #. (itstool) path: listitem/para
890 #: C/index.docbook:536
891 #, fuzzy
892 msgid ""
893 "Add the necessary <application>autoconf</application> macros to "
894 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
895 "allow configuration of GTK-Doc via the generated <filename>configure</"
896 "filename> script."
897 msgstr ""
898 "V <filename>configure.ac</filename> dodajte potrebne makre "
899 "<application>samodejnega zmanjševanja</application>, da omogočite GTK-Doc v "
900 "sistemu gradnje, da omogočite konfiguracijo GTK-Doc <filename>prek "
901 "ustvarjenega</filename> konfiguracijskega skripta."
902
903 #. (itstool) path: listitem/para
904 #: C/index.docbook:542
905 #, fuzzy
906 msgid ""
907 "Among others with registers the <code>--enable-gtk-doc</code> option with "
908 "the <filename>configure</filename> script."
909 msgstr ""
910 "Med drugim z registri možnost <code>--enable-gtk-doc</code> s "
911 "<filename>konfiguriranjem</filename> skripta."
912
913 #. (itstool) path: listitem/para
914 #: C/index.docbook:548
915 #, fuzzy
916 msgid ""
917 "Create an <application>automake</application> script for each application or "
918 "library in your project. In the example used in this documentation this step "
919 "applies to both <code>meeper</code> and <code>libmeep</code>."
920 msgstr ""
921 "Ustvarite skript <application>za samodejno izdelavo</application> za vsako "
922 "aplikacijo ali knjižnico v projektu. V primeru, uporabljenem v tej "
923 "dokumentaciji, ta korak velja za oba <code>meeper</code> in <code>libmeep</"
924 "code>."
925
926 #. (itstool) path: sect1/para
927 #: C/index.docbook:557
928 #, fuzzy
929 msgid ""
930 "In the following sections, we will perform the above steps in reverse order. "
931 "We start with the <application>automake</application> scripts and work our "
932 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
933 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
934 "build the documentation."
935 msgstr ""
936 "V naslednjih razdelkih bomo zgornje korake izvedli v obratnem vrstnem redu. "
937 "Začnemo s <application>skripti za samodejno izdelavo</application> in se "
938 "potrudimo do <filename>configure.ac</filename> in <filename>autogen.sh</"
939 "filename>. Nato pokažemo, kako omogočiti Gtk-Doc v sistemu gradnje in kako "
940 "zgraditi dokumentacijo."
941
942 #. (itstool) path: sect2/title
943 #: C/index.docbook:567
944 #, fuzzy
945 msgid "Integration with automake"
946 msgstr "Integracija s samodejno izdelavo"
947
948 #. (itstool) path: sect2/para
949 #: C/index.docbook:569
950 #, fuzzy
951 msgid ""
952 "First copy the <filename>Makefile.am</filename> from the <filename class="
953 "\"directory\">examples</filename> sub-directory of the <ulink url=\"https://"
954 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
955 "sources</ulink> to your project's reference documentation directory (e.g. "
956 "<filename class=\"directory\">docs/reference/&lt;package&gt;</filename>). A "
957 "local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-"
958 "tools/examples/Makefile.am</filename>. If you have multiple packages repeat "
959 "this for each one."
960 msgstr ""
961 "Najprej kopirajte <filename>Makefile.am</filename> iz <filename class="
962 "\"directory\">podimenika primerov</filename> <ulink url=\"https://gitlab."
963 "gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> virov gtkdoc</"
964 "ulink> v imenik referenčne dokumentacije projekta (npr. <filename class="
965 "\"directory\">dokumenti/reference/&lt;paket&gt;</filename>). Lokalna kopija "
966 "bi morala biti na voljo na primer <filename>pod /usr/share/doc/gtk-doc-tools/"
967 "examples/makefile.am</filename>. Če imate več paketov, to ponovite za "
968 "vsakega."
969
970 #. (itstool) path: note/simpara
971 #: C/index.docbook:582
972 #, fuzzy
973 msgid ""
974 "Do not forget to add each <filename>Makefile.am</filename> to the "
975 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
976 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
977 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
978 "filename> to <function>AC_CONFIG_FILES</function>."
979 msgstr ""
980 "Ne pozabite dodati vsakega <filename>Makefile.am</filename> v "
981 "<function>AC_CONFIG_FILES</function> makro v <filename>configure.ac</"
982 "filename>. Za <filename>dokumente / reference/libmeep/Makefile.am</filename> "
983 "boste morali v <function>AC_CONFIG_FILES</function> dodati <filename>vnos "
984 "docs/reference/libmeep/Makefile.</filename>"
985
986 #. (itstool) path: example/title
987 #: C/index.docbook:594
988 #, fuzzy
989 msgid "Example directory structure with <filename>Makefiles.am</filename>"
990 msgstr "Primer strukture imenika s <filename>Makefiles.am</filename>"
991
992 #. (itstool) path: example/programlisting
993 #: C/index.docbook:597
994 #, fuzzy, no-wrap
995 msgid ""
996 "\n"
997 "meep/\n"
998 " docs/\n"
999 " reference/ # reference documentation\n"
1000 " libmeep/\n"
1001 " Makefile.am\n"
1002 " meeper/\n"
1003 " Makefile.am\n"
1004 " help/ # optional: user manual\n"
1005 " meeper/\n"
1006 " src/\n"
1007 " libmeep/\n"
1008 " meeper/\n"
1009 msgstr ""
1010 "\n"
1011 "Poslanec Evropskega parlamenta/\n"
1012 " Docs/\n"
1013 " Sklic/ # referenčna dokumentacija\n"
1014 " libmeep/\n"
1015 " Makefile.am\n"
1016 " Meeper/\n"
1017 " Makefile.am\n"
1018 " pomoč/ # neobvezno: navodila za uporabo\n"
1019 " Meeper/\n"
1020 " ZRC/\n"
1021 " libmeep/\n"
1022 " Meeper/\n"
1023
1024 #. (itstool) path: sect2/para
1025 #: C/index.docbook:613
1026 #, fuzzy
1027 msgid ""
1028 "Next, you need to customize the copied Makefiles and provide values for the "
1029 "various parameters in each <filename>Makefile.am</filename>. All settings "
1030 "have a comment above them that describes their purpose and how to customize "
1031 "the setting. Most settings are used to supply extra flags to the respective "
1032 "tools to which they apply. Every tool has a variable of the form <option>&lt;"
1033 "TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</"
1034 "application> has an option named <code>MKHTML_OPTIONS</code>). All the tools "
1035 "support <option>--help</option> to list the supported options."
1036 msgstr ""
1037 "Nato morate prilagoditi kopirane datoteke Makefiles in navesti vrednosti za "
1038 "različne parametre v vsaki <filename>Makefile.am</filename>. Vse nastavitve "
1039 "imajo nad seboj komentar, ki opisuje njihov namen in kako prilagoditi "
1040 "nastavitev. Večina nastavitev se uporablja za zagotavljanje dodatnih "
1041 "zastavic ustreznim orodjem, na katera se nanašajo. Vsako orodje ima "
1042 "spremenljivko oblike <option>&lt;IME ORODJA&gt;_OPTIONS (npr. orodje "
1043 "<application>gtkdoc-mkhtml</application> ima možnost z imenom "
1044 "<code>MKHTML_OPTIONS</code>). Vsa orodja podpirajo<option>--pomoč pri "
1045 "navajanju podprtih možnosti."
1046
1047 #. (itstool) path: listitem/para
1048 #: C/index.docbook:637
1049 #, fuzzy
1050 msgid ""
1051 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1052 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1053 msgstr ""
1054 "<option>DOC_MODULE se uporablja za navedbo imena paketa, ki se dokumentira "
1055 "(npr. <code>meeper</code>ali <code>libmeep</code>)."
1056
1057 #. (itstool) path: listitem/para
1058 #: C/index.docbook:644
1059 #, fuzzy
1060 msgid ""
1061 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1062 "directory which GTK-Doc searches for your API documentation. This will "
1063 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1064 "directory of that directory."
1065 msgstr ""
1066 "<option>DOC_SOURCE_DIR se uporablja za določanje lokacije izvornega imenika, "
1067 "ki ga GTK-Doc išče za dokumentacijo API-ja. To bo <code> DOC_SOURCE_DIR="
1068 "$(top_srcdir)/src </code> običajno ali podimenik tega imenika."
1069
1070 #. (itstool) path: listitem/para
1071 #: C/index.docbook:657
1072 #, fuzzy
1073 msgid ""
1074 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1075 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB="
1076 "$(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
1077 "the matched files change."
1078 msgstr ""
1079 "<option>HFILE_GLOB in<option>CFILE_GLOB se uporabljajo za odvisnosti. Vsaka "
1080 "možnost ima datoteko-glob (npr. <code>HFILE_GLOB=$(top_srcdir)/src/*.c</"
1081 "code>). Dokumentacija bo obnovljena, če se spremeni katera od ujemajočih se "
1082 "datotek."
1083
1084 #. (itstool) path: listitem/para
1085 #: C/index.docbook:669
1086 #, fuzzy
1087 msgid ""
1088 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1089 "include when scanning for API documentation, which are not found under "
1090 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1091 "extra.h</code>)."
1092 msgstr ""
1093 "<option>EXTRA_HFILES omogoča določitev dodatnih datotek z glavo, ki jih je "
1094 "treba vključiti pri skeniranju dokumentacije API-ja, ki jih ni mogoče najti "
1095 "pod <code>DOC_SOURCE_DIR</code> (npr. <code> EXTRA_HFILES=$(top_srcdir}/"
1096 "contrib/extra.h</code>)."
1097
1098 #. (itstool) path: listitem/para
1099 #: C/index.docbook:679
1100 #, fuzzy
1101 msgid ""
1102 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1103 "to ignore when scanning for API documentation. Use the basename of the file "
1104 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1105 "private_code_folder</code>)."
1106 msgstr ""
1107 "<option>IGNORE_HFILES omogoča, da določite datoteke z glavo ali mape, ki jih "
1108 "lahko prezrete pri skeniranju dokumentacije API. Uporabite osnovno ime "
1109 "datoteke ali imenika (npr. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1110 "private_code_folder</code>)."
1111
1112 #. (itstool) path: listitem/para
1113 #: C/index.docbook:689
1114 #, fuzzy
1115 msgid ""
1116 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1117 "copied into the <filename>html/</filename> directory of the generated "
1118 "documentation. If your API documentation includes any images they need to be "
1119 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1120 "stock_about_24.png</code>)."
1121 msgstr ""
1122 "<option>HTML_IMAGES omogoča, da določite slikovne datoteke, ki bodo kopirane "
1123 "v <filename>html /</filename> imenik ustvarjene dokumentacije. Če "
1124 "dokumentacija API-ja vključuje slike, jih je treba dodati tej možnosti (npr. "
1125 "<code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png</code>)."
1126
1127 #. (itstool) path: listitem/para
1128 #: C/index.docbook:702
1129 #, fuzzy
1130 msgid ""
1131 "<option>content_files</option> allows to specify extra files that are "
1132 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1133 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1134 msgstr ""
1135 "<option>content_files omogoča določitev dodatnih datotek, ki so vključene v "
1136 "<code>$(DOC_MAIN_SGML_FILE)</code> (npr. <code> content_files=running.xml "
1137 "building.xml changes-2.0.xml</code>)."
1138
1139 #. (itstool) path: listitem/para
1140 #: C/index.docbook:713
1141 #, fuzzy
1142 msgid ""
1143 "<option>expand_content_files</option> allows to specify files where "
1144 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1145 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1146 msgstr ""
1147 "<option>expand_content_files omogoča določanje datotek, kjer so "
1148 "<emphasis>razširjene okrajšave gtk-doc,</emphasis> kot <code>#GtkWidget</"
1149 "code> so razširjene (npr. <code> expand_content_files=running.xml</code>)."
1150
1151 #. (itstool) path: sect2/para
1152 #: C/index.docbook:631
1153 #, fuzzy
1154 msgid ""
1155 "The following list explains the most relevant options. Check the example "
1156 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1157 msgstr ""
1158 "Na spodnjem seznamu so razložene najpomembnejše možnosti. Preverite "
1159 "<filename>Makefile.am</filename> primera za dodatne možnosti. <_:"
1160 "itemizedlist-1/>"
1161
1162 #. (itstool) path: sect2/title
1163 #: C/index.docbook:728
1164 #, fuzzy
1165 msgid "Integration with autoconf"
1166 msgstr "Integracija s funkcijo autoconf"
1167
1168 #. (itstool) path: sect2/para
1169 #: C/index.docbook:730
1170 #, fuzzy
1171 msgid ""
1172 "Integration with <application>autoconf</application> is very simple and "
1173 "includes one required step and an additional optional (but recommended) "
1174 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1175 "to your <filename>configure.ac</filename> script. This registers several "
1176 "configure options to enable GTK-Doc and allows you to set default arguments "
1177 "for <application>gtkdocize</application>."
1178 msgstr ""
1179 "Integracija s <application>funkcijo autoconf</application> je zelo preprosta "
1180 "in vključuje en obvezen korak ter dodaten izbirni (vendar priporočen) korak. "
1181 "Prvi korak je, da dodate <function>GTK_DOC_CHECK</function> makro v "
1182 "<filename>skript configure.ac</filename> . S tem registrirate več možnosti "
1183 "konfiguriranja, da omogočite GTK-Doc in omogočite nastavitev privzetih "
1184 "argumentov za <application>gtkdocize</application>."
1185
1186 #. (itstool) path: warning/simpara
1187 #: C/index.docbook:742
1188 #, fuzzy
1189 msgid ""
1190 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1191 "macro must start at the beginning of the line and should not start with "
1192 "whitespace."
1193 msgstr ""
1194 "Prepričajte se, da <code>GTK_DOC_CHECK</code> makro ni zamaknjen. Makro se "
1195 "mora začeti na začetku vrstice in se ne sme začeti z belim prostorom."
1196
1197 #. (itstool) path: sect2/para
1198 #: C/index.docbook:749
1199 #, fuzzy
1200 msgid ""
1201 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1202 "<filename>configure.ac</filename>. This is not required but helps "
1203 "<application>gtkdocize</application> to automatically copy the macro "
1204 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1205 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1206 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1207 "to explicitly tell the <application>aclocal</application> tool where to find "
1208 "the macro definition file."
1209 msgstr ""
1210 "Drugi korak je, da dodate <code>AC_CONFIG_MACRO_DIR(m4)</code> v "
1211 "<filename>configure.ac</filename>. To ni obvezno, vendar pomaga "
1212 "<application>gtkdocize</application> samodejno kopirati definicijo makra "
1213 "(npr <filename>. gtk-doc.m4</filename>), ki vsebuje <function>GTK_DOC_CHECK</"
1214 "function> makro v imenik makrov projekta. Brez tega GTK_DOC_CHECK makra "
1215 "morda ne bo mogoče najti, zato morate orodju <application>aclocal</"
1216 "application> izrecno povedati, kje najti datoteko z definicijami makrov."
1217
1218 #. (itstool) path: example/title
1219 #: C/index.docbook:762
1220 #, fuzzy
1221 msgid "Minimal integration with autoconf"
1222 msgstr "Minimalna integracija s programom autoconf"
1223
1224 #. (itstool) path: example/programlisting
1225 #: C/index.docbook:763
1226 #, fuzzy, no-wrap
1227 msgid ""
1228 "\n"
1229 "# recommended: set m4 directory\n"
1230 "AC_CONFIG_MACRO_DIR(m4)\n"
1231 "# optional: register gtk-doc in configure\n"
1232 "GTK_DOC_CHECK([1.28])\n"
1233 msgstr ""
1234 "\n"
1235 "# Priporočeno: nastavite imenik M4\n"
1236 "AC_CONFIG_MACRO_DIR(m4)\n"
1237 "# neobvezno: registrirajte GTK-doc v konfiguraciji\n"
1238 "GTK_DOC_CHECK([1.28])\n"
1239
1240 #. (itstool) path: example/title
1241 #: C/index.docbook:778
1242 #, fuzzy
1243 msgid "Integration with optional gtk-doc dependency"
1244 msgstr "Integracija z izbirno odvisnostjo gtk-doc"
1245
1246 #. (itstool) path: example/programlisting
1247 #: C/index.docbook:779
1248 #, fuzzy, no-wrap
1249 msgid ""
1250 "\n"
1251 "m4_ifdef([GTK_DOC_CHECK], [\n"
1252 "# recommended: set m4 directory\n"
1253 "AC_CONFIG_MACRO_DIR(m4)\n"
1254 "# optional: register gtk-doc in configure\n"
1255 "GTK_DOC_CHECK([1.28])\n"
1256 "],[\n"
1257 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1258 "])\n"
1259 msgstr ""
1260 "\n"
1261 "m4_ifdef([GTK_DOC_CHECK], [\n"
1262 "# Priporočeno: nastavite imenik M4\n"
1263 "AC_CONFIG_MACRO_DIR(m4)\n"
1264 "# neobvezno: registrirajte GTK-doc v konfiguraciji\n"
1265 "GTK_DOC_CHECK([1.28])\n"
1266 "],[\n"
1267 "AM_CONDITIONAL([ENABLE_GTK_DOC], napačno)\n"
1268 "])\n"
1269
1270 #. (itstool) path: sect2/para
1271 #: C/index.docbook:772
1272 #, fuzzy
1273 msgid ""
1274 "The above example works, but will require all developers to have gtk-doc "
1275 "installed. A better way is to make building the documentation optional as "
1276 "shown in the next example: <_:example-1/>"
1277 msgstr ""
1278 "Zgornji primer deluje, vendar bodo morali vsi razvijalci imeti nameščen gtk-"
1279 "doc. Boljši način je, da je gradnja dokumentacije izbirna, kot je prikazano "
1280 "v naslednjem primeru: <_:example-1/>"
1281
1282 #. (itstool) path: sect2/para
1283 #: C/index.docbook:792
1284 #, fuzzy
1285 msgid ""
1286 "The first argument is used to check for the Gtk-Doc version at configure "
1287 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1288 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1289 "configure switches:"
1290 msgstr ""
1291 "Prvi argument se uporablja za preverjanje različice Gtk-Doc ob času "
1292 "konfiguracije. 2., izbirni argument uporablja <application>gtkdocize</"
1293 "application>. Makro <symbol>GTK_DOC_CHECK</symbol> doda tudi več "
1294 "konfiguracijskih stikal:"
1295
1296 #. (itstool) path: listitem/para
1297 #: C/index.docbook:801
1298 #, fuzzy
1299 msgid "--with-html-dir=PATH : path to installed docs"
1300 msgstr "--with-html-dir=PATH : pot do nameščenih dokumentov"
1301
1302 #. (itstool) path: listitem/para
1303 #: C/index.docbook:802
1304 #, fuzzy
1305 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1306 msgstr ""
1307 "--Enable-GTK-doc: Uporabite GTK-Doc za izdelavo dokumentacije [default=no]"
1308
1309 #. (itstool) path: listitem/para
1310 #: C/index.docbook:803
1311 #, fuzzy
1312 msgid ""
1313 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1314 msgstr ""
1315 "--enable-gtk-doc-html: zgradite dokumentacijo v obliki html [default=yes]"
1316
1317 #. (itstool) path: listitem/para
1318 #: C/index.docbook:804
1319 #, fuzzy
1320 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1321 msgstr "--Enable-GTK-doc-pdf: Gradite dokumentacijo v formatu PDF [default=no]"
1322
1323 #. (itstool) path: important/para
1324 #: C/index.docbook:808
1325 #, fuzzy
1326 msgid ""
1327 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1328 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1329 "Otherwise pregenerated documentation is installed (which makes sense for "
1330 "users but not for developers)."
1331 msgstr ""
1332 "GTK-Doc je privzeto onemogočen! Ne pozabite prenesti možnosti <option>'--"
1333 "Enable-GTK-doc' za naslednjo <filename>konfiguracijo</filename> zagona. V "
1334 "nasprotnem primeru je nameščena vnaprej ustvarjena dokumentacija (kar je "
1335 "smiselno za uporabnike, ne pa tudi za razvijalce)."
1336
1337 #. (itstool) path: sect2/para
1338 #: C/index.docbook:816
1339 #, fuzzy
1340 msgid ""
1341 "After all changes to <filename>configure.ac</filename> are made, update the "
1342 "<filename>configure</filename> file. This can be done by re-running "
1343 "<code>autogen.sh</code>."
1344 msgstr ""
1345 "Ko so izvedene vse spremembe <filename>configure.ac</filename> , posodobite "
1346 "<filename>konfiguracijsko</filename> datoteko. To lahko storite s ponovnim "
1347 "zagonom <code>autogen.sh</code>."
1348
1349 #. (itstool) path: sect2/title
1350 #: C/index.docbook:824
1351 #, fuzzy
1352 msgid "Integration with autogen"
1353 msgstr "Integracija z avtogenom"
1354
1355 #. (itstool) path: sect2/para
1356 #: C/index.docbook:826
1357 #, fuzzy
1358 msgid ""
1359 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1360 "the build infrastructure after the project was checked out from a version "
1361 "control system (such as git or svn). GTK-Doc comes with a script called "
1362 "<application>gtkdocize</application> which can be used to copy the necessary "
1363 "files needed by Gtk-Doc to the source directory."
1364 msgstr ""
1365 "Večina projektov bo imela <filename>autogen.sh</filename> skript za "
1366 "nastavitev infrastrukture gradnje, potem ko je bil projekt rezerviran iz "
1367 "sistema za nadzor različic (kot je git ali svn). GTK-Doc ima skript, "
1368 "imenovan <application>gtkdocize</application> , ki ga lahko uporabite za "
1369 "kopiranje potrebnih datotek, ki jih potrebuje Gtk-Doc, v izvorni imenik."
1370
1371 #. (itstool) path: sect2/para
1372 #: C/index.docbook:834
1373 #, fuzzy
1374 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1375 msgstr ""
1376 "Zagnati ga je treba pred autoreconf, autoheader, automake ali autoconf."
1377
1378 #. (itstool) path: example/title
1379 #: C/index.docbook:839
1380 #, fuzzy
1381 msgid "Running gtkdocize from autogen.sh"
1382 msgstr "Tek gtkdocize iz autogen.sh"
1383
1384 #. (itstool) path: example/programlisting
1385 #: C/index.docbook:840
1386 #, fuzzy, no-wrap
1387 msgid ""
1388 "\n"
1389 "gtkdocize || exit 1\n"
1390 msgstr ""
1391 "\n"
1392 "GTKDOCIZE || izhod 1\n"
1393
1394 #. (itstool) path: example/title
1395 #: C/index.docbook:848
1396 #, fuzzy
1397 msgid "Conditionally run gtkdocize from autogen.sh"
1398 msgstr "Pogojno zaženite gtkdocize iz autogen.sh"
1399
1400 #. (itstool) path: example/programlisting
1401 #: C/index.docbook:849
1402 #, fuzzy, no-wrap
1403 msgid ""
1404 "\n"
1405 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1406 "if test $? -ne 0; then\n"
1407 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1408 "else\n"
1409 " $GTKDOCIZE || exit 1\n"
1410 "fi\n"
1411 msgstr ""
1412 "\n"
1413 "GTKDOCIZE=$(ki gtkdocize 2&gt;/dev/null)\n"
1414 "Če preizkusite $? -ne 0; potem\n"
1415 " odmev »Podpore za gtk-doc ni bilo mogoče najti. Dokumentov ni mogoče ustvariti.«\n"
1416 "Drugega\n"
1417 " $GTKDOCIZE || izhod 1\n"
1418 "Fi\n"
1419
1420 #. (itstool) path: sect2/para
1421 #: C/index.docbook:860
1422 #, fuzzy
1423 msgid ""
1424 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1425 "doc.make</filename> to your project root (or any directory specified by the "
1426 "<option>--docdir</option> option)."
1427 msgstr ""
1428 "Ko zaženete <application>gtkdocize</application> , kopira <filename>gtk-doc."
1429 "make</filename> v koren projekta (ali kateri koli imenik, ki ga določa "
1430 "<option>--docdir možnost)."
1431
1432 #. (itstool) path: sect2/para
1433 #: C/index.docbook:866
1434 #, fuzzy
1435 msgid ""
1436 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1437 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1438 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1439 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1440 "<function>GTK_DOC_CHECK</function> macro."
1441 msgstr ""
1442 "<application>GTKDOCIZE</application> preveri, <filename></filename> ali je v "
1443 "skriptu <function>configure.ac GTK_DOC_CHECK</function> makro. Makro "
1444 "<function>GTK_DOC_CHECK</function> lahko uporabite za posredovanje dodatnih "
1445 "argumentov skriptu <application>gtkdocize</application>. 2. parameter v "
1446 "<function>GTK_DOC_CHECK</function> makro."
1447
1448 #. (itstool) path: sect2/para
1449 #: C/index.docbook:875
1450 #, fuzzy
1451 msgid ""
1452 "Alternatively, additional arguments can also be passed to "
1453 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1454 "function> environment variable, or by directly specifying them to "
1455 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1456 msgstr ""
1457 "Druga možnost je, da se dodatni argumenti posredujejo tudi "
1458 "<application>gtkdocize</application> prek spremenljivke "
1459 "<function>GTKDOCIZE_FLAGS</function> okolja ali z neposrednim določanjem "
1460 "<application>gtkdocize</application> v <filename>autogen.sh</filename>."
1461
1462 #. (itstool) path: sect2/title
1463 #: C/index.docbook:886
1464 #, fuzzy
1465 msgid "Executing GTK-Doc from the Build System"
1466 msgstr "Izvajanje GTK-Doc iz sistema gradnje"
1467
1468 #. (itstool) path: sect2/para
1469 #: C/index.docbook:888
1470 #, fuzzy
1471 msgid ""
1472 "After the previous steps it's time to run the build. First we need to rerun "
1473 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1474 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1475 "<filename>configure</filename> with this option afterwards."
1476 msgstr ""
1477 "Po prejšnjih korakih je čas za zagon gradnje. Najprej moramo ponovno zagnati "
1478 "<filename>autogen.sh</filename>. Če se ta skript zažene, konfigurirajte "
1479 "namesto vas, mu dajte <option>--Omogoči-GTK-doc možnost. V nasprotnem "
1480 "primeru ročno zaženite, <filename>konfigurirajte</filename> s to možnostjo "
1481 "kasneje."
1482
1483 #. (itstool) path: sect2/para
1484 #: C/index.docbook:895
1485 #, fuzzy
1486 msgid ""
1487 "The first make run generates several additional files in the doc-"
1488 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1489 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
1490 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1491 msgstr ""
1492 "Prvi zagon ustvari več dodatnih datotek v imenikih dokumentov. Pomembni so: "
1493 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs."
1494 "xml</filename> (v preteklosti .sgml), <filename>&lt;package&gt;-sections."
1495 "txt</filename>."
1496
1497 #. (itstool) path: example/title
1498 #: C/index.docbook:903
1499 #, fuzzy
1500 msgid "Running the doc build"
1501 msgstr "Zagon gradnje dokumenta"
1502
1503 #. (itstool) path: example/programlisting
1504 #: C/index.docbook:904
1505 #, fuzzy, no-wrap
1506 msgid ""
1507 "\n"
1508 "./autogen.sh --enable-gtk-doc\n"
1509 "make\n"
1510 msgstr ""
1511 "\n"
1512 "./autogen.sh --enable-gtk-doc\n"
1513 "delati\n"
1514
1515 #. (itstool) path: sect2/para
1516 #: C/index.docbook:911
1517 #, fuzzy
1518 msgid ""
1519 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1520 "index.html</filename>. With this initial setup you will only see a very "
1521 "simple document. The next chapter will teach you how to add API "
1522 "documentation to your code via special comment blocks. The Chapter "
1523 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1524 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1525 "template</link> to add additional chapters and sections to your "
1526 "documentation files."
1527 msgstr ""
1528 "Zdaj lahko brskalnik usmerite na <filename>docs/reference/&lt;package&gt;/"
1529 "index.html</filename>. S to začetno nastavitvijo boste videli le zelo "
1530 "preprost dokument. Naslednje poglavje vas bo naučilo, kako dodati "
1531 "dokumentacijo API v svojo kodo prek posebnih blokov komentarjev. V poglavju "
1532 "so nato predstavljene <link linkend=\"metafiles\">dodatne datoteke in "
1533 "prikazano, kako uredite <link linkend=\"metafiles_master\">glavno predlogo, "
1534 "da dodate dodatna poglavja in razdelke v dokumentacijske datoteke."
1535
1536 #. (itstool) path: sect1/title
1537 #: C/index.docbook:927
1538 #, fuzzy
1539 msgid "Integration with CMake build systems"
1540 msgstr "Integracija s CMake gradbenimi sistemi"
1541
1542 #. (itstool) path: sect1/para
1543 #: C/index.docbook:929
1544 #, fuzzy
1545 msgid ""
1546 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1547 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1548 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1549 "set in your <filename>CMakeLists.txt</filename> file."
1550 msgstr ""
1551 "GTK-Doc zdaj ponuja modul <filename>GtkDocConfig.cmake</filename> (in "
1552 "ustrezen modul <filename>GtkDocConfigVersion.cmake</filename> ). S tem "
1553 "dobite <literal>gtk_doc_add_module</literal> ukaz, ki ga lahko nastavite v "
1554 "<filename>CMakeLists.txt</filename> datoteki."
1555
1556 #. (itstool) path: example/title
1557 #: C/index.docbook:939
1558 #, fuzzy
1559 msgid "Example of using GTK-Doc from CMake"
1560 msgstr "Primer uporabe GTK-Doc podjetja CMake"
1561
1562 #. (itstool) path: example/programlisting
1563 #: C/index.docbook:940
1564 #, fuzzy, no-wrap
1565 msgid ""
1566 "\n"
1567 "find_package(GtkDoc 1.25 REQUIRED)\n"
1568 "\n"
1569 "# Create the doc-libmeep target.\n"
1570 "gtk_doc_add_module(\n"
1571 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1572 " XML meep-docs.xml\n"
1573 " LIBRARIES libmeep\n"
1574 ")\n"
1575 "\n"
1576 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1577 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1578 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1579 "\n"
1580 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1581 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1582 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1583 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1584 msgstr ""
1585 "\n"
1586 "find_package(ZAHTEVANO GTKDoc 1.25)\n"
1587 "\n"
1588 "# Ustvarite cilj doc-libmeep.\n"
1589 "gtk_doc_add_module(\n"
1590 " Libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1591 " XML meep-docs.xml\n"
1592 " KNJIŽNICE libmeep\n"
1593 ")\n"
1594 "\n"
1595 "# Zgradite doc-libmeep kot del privzetega cilja. Brez tega bi\n"
1596 "# morajo izrecno zagnati nekaj takega, kot je \"Make Doc-Libmeep\", da zgradite dokumente.\n"
1597 "add_custom_target(dokumentacija VSE ODVISNO od doc-libmeep)\n"
1598 "\n"
1599 "# Namestite dokumente. (To predpostavlja, da uporabljate modul GNUInstallDirs CMake\n"
1600 "#, da pravilno nastavite spremenljivko CMAKE_INSTALL_DOCDIR).\n"
1601 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1602 " CILJ ${CMAKE_INSTALL_DOCDIR})\n"
1603
1604 #. (itstool) path: sect1/para
1605 #: C/index.docbook:937
1606 #, fuzzy
1607 msgid "The following example shows how to use this command. <_:example-1/>"
1608 msgstr "Naslednji primer prikazuje, kako uporabiti ta ukaz. <_:primer-1/>"
1609
1610 #. (itstool) path: sect1/title
1611 #: C/index.docbook:964
1612 #, fuzzy
1613 msgid "Integration with plain makefiles or other build systems"
1614 msgstr "Integracija z navadnimi makefiles ali drugimi sistemi gradnje"
1615
1616 #. (itstool) path: sect1/para
1617 #: C/index.docbook:966
1618 #, fuzzy
1619 msgid ""
1620 "In the case one does not want to use automake and therefore <filename>gtk-"
1621 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1622 "in own makefiles (or other build tools)."
1623 msgstr ""
1624 "V primeru, da ne želite uporabljati samodejne izdelave in zato <filename>gtk-"
1625 "doc.mak</filename> , boste morali poklicati orodja gtkdoc v pravem vrstnem "
1626 "redu v lastnih makefiles (ali drugih orodjih za gradnjo)."
1627
1628 #. (itstool) path: example/title
1629 #: C/index.docbook:973
1630 #, fuzzy
1631 msgid "Documentation build steps"
1632 msgstr "Koraki izdelave dokumentacije"
1633
1634 #. (itstool) path: example/programlisting
1635 #: C/index.docbook:974
1636 #, fuzzy, no-wrap
1637 msgid ""
1638 "\n"
1639 "DOC_MODULE=meep\n"
1640 "// sources have changed\n"
1641 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1642 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1643 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1644 "// xml files have changed\n"
1645 "mkdir html\n"
1646 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1647 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1648 msgstr ""
1649 "\n"
1650 "DOC_MODULE=MEP\n"
1651 "Viri so se spremenili\n"
1652 "gtkdoc-scan --module=$(DOC_MODULE) &lt;vir-dir&gt;\n"
1653 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1654 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1655 "Datoteke XML so se spremenile\n"
1656 "MKDIR HTML\n"
1657 "CD html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) .. /meep-docs.xml\n"
1658 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1659
1660 #. (itstool) path: sect1/para
1661 #: C/index.docbook:988
1662 #, fuzzy
1663 msgid ""
1664 "One will need to look at the <filename>Makefile.am</filename> and "
1665 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1666 msgstr ""
1667 "Za izbiro dodatnih potrebnih možnosti si boste morali ogledati "
1668 "<filename>Makefile.am</filename> in <filename>gtk-doc.mak</filename> ."
1669
1670 #. (itstool) path: sect1/title
1671 #: C/index.docbook:995
1672 #, fuzzy
1673 msgid "Integration with version control systems"
1674 msgstr "Integracija s sistemi za nadzor različic"
1675
1676 #. (itstool) path: sect1/para
1677 #: C/index.docbook:997
1678 #, fuzzy
1679 msgid ""
1680 "As a rule of thumb, it's the files you edit which should go under version "
1681 "control. For typical projects it's these files: <filename>&lt;package&gt;."
1682 "types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1683 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
1684 "<filename>Makefile.am</filename>."
1685 msgstr ""
1686 "Praviloma so datoteke, ki jih urejate, tiste, ki bi morale biti pod nadzorom "
1687 "različice. Za tipične projekte so to te datoteke: <filename>&lt;package&gt;."
1688 "types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (v "
1689 "preteklosti .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
1690 "<filename>Makefile.am</filename>."
1691
1692 #. (itstool) path: sect1/para
1693 #: C/index.docbook:1005
1694 #, fuzzy
1695 msgid ""
1696 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1697 "directories should not go under version control. Neither should any of the "
1698 "<filename>.stamp</filename> files."
1699 msgstr ""
1700 "Datoteke v imenikih <filename>xml /</filename> in <filename>html/</filename> "
1701 "ne smejo biti pod nadzorom različice. Prav tako ne bi smele biti nobene "
1702 "datoteke <filename>.stamp</filename> ."
1703
1704 #. (itstool) path: chapter/title
1705 #: C/index.docbook:1015
1706 #, fuzzy
1707 msgid "Documenting the code"
1708 msgstr "Dokumentiranje kode"
1709
1710 #. (itstool) path: chapter/para
1711 #: C/index.docbook:1017
1712 #, fuzzy
1713 msgid ""
1714 "GTK-Doc uses source code comment with a special syntax for code "
1715 "documentation. Further it retrieves information about your project structure "
1716 "from other sources. During the next section you will find all information "
1717 "about the syntax of the comments."
1718 msgstr ""
1719 "GTK-Doc uporablja komentar izvorne kode s posebno sintakso za dokumentacijo "
1720 "kode. Poleg tega pridobi informacije o strukturi vašega projekta iz drugih "
1721 "virov. V naslednjem razdelku boste našli vse informacije o sintaksi "
1722 "komentarjev."
1723
1724 #. (itstool) path: example/title
1725 #: C/index.docbook:1028 C/index.docbook:1054
1726 #, fuzzy
1727 msgid "GTK-Doc comment block"
1728 msgstr "Blok komentarjev GTK-Doc"
1729
1730 #. (itstool) path: example/programlisting
1731 #: C/index.docbook:1029
1732 #, fuzzy, no-wrap
1733 msgid ""
1734 "\n"
1735 "#ifndef __GTK_DOC_IGNORE__\n"
1736 "/* unparseable code here */\n"
1737 "#endif\n"
1738 msgstr ""
1739 "\n"
1740 "#ifndef __GTK_DOC_IGNORE__\n"
1741 "/* nerazčlenljiva koda tukaj */\n"
1742 "#endif\n"
1743
1744 #. (itstool) path: chapter/para
1745 #: C/index.docbook:1024
1746 #, fuzzy
1747 msgid ""
1748 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1749 "of receiving warnings from the scanner that look like a special case, one "
1750 "can hint GTK-Doc to skip over them. <_:example-1/>"
1751 msgstr ""
1752 "Skener GTK-Doc lahko dobro obravnava večino glav C. V primeru prejemanja "
1753 "opozoril iz optičnega bralnika, ki so videti kot poseben primer, lahko "
1754 "namignemo GTK-Doc, da jih preskoči. <_:primer-1/>"
1755
1756 #. (itstool) path: note/title
1757 #: C/index.docbook:1038
1758 #, fuzzy
1759 msgid "Limitations"
1760 msgstr "Omejitve"
1761
1762 #. (itstool) path: note/para
1763 #: C/index.docbook:1039
1764 #, fuzzy
1765 msgid ""
1766 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1767 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1768 msgstr ""
1769 "Upoštevajte, da GTK-Doc podpira <code>#ifndef(__GTK_DOC_IGNORE__)</code> , "
1770 "vendar ne <code>#if !defined(__GTK_DOC_IGNORE__)</code> ali druge "
1771 "kombinacije."
1772
1773 #. (itstool) path: sect1/title
1774 #: C/index.docbook:1049
1775 #, fuzzy
1776 msgid "Documentation comments"
1777 msgstr "Komentarji dokumentacije"
1778
1779 #. (itstool) path: example/programlisting
1780 #: C/index.docbook:1055
1781 #, fuzzy, no-wrap
1782 msgid ""
1783 "\n"
1784 "/**\n"
1785 " * identifier:\n"
1786 " * documentation ...\n"
1787 " */\n"
1788 msgstr ""
1789 "\n"
1790 "/**\n"
1791 " *Identifikator:\n"
1792 " *dokumentacija...\n"
1793 " */\n"
1794
1795 #. (itstool) path: sect1/para
1796 #: C/index.docbook:1051
1797 #, fuzzy
1798 msgid ""
1799 "A multiline comment that starts with an additional '*' marks a documentation "
1800 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1801 msgstr ""
1802 "Komentar v več vrsticah, ki se začne z dodatnim »*«, označuje "
1803 "dokumentacijski blok, ki ga bodo obdelala orodja GTK-Doc. <_:primer-1/>"
1804
1805 #. (itstool) path: sect1/para
1806 #: C/index.docbook:1064
1807 #, fuzzy
1808 msgid ""
1809 "The 'identifier' is one line with the name of the item the comment is "
1810 "related to. The syntax differs a little depending on the item. (TODO add "
1811 "table showing identifiers)"
1812 msgstr ""
1813 "\"Identifikator\" je ena vrstica z imenom elementa, na katerega se komentar "
1814 "nanaša. Sintaksa se nekoliko razlikuje glede na element. (TODO dodajte "
1815 "tabelo, ki prikazuje identifikatorje)"
1816
1817 #. (itstool) path: sect1/para
1818 #: C/index.docbook:1070
1819 #, fuzzy
1820 msgid ""
1821 "The 'documentation' block is also different for each symbol type. Symbol "
1822 "types that get parameters such as functions or macros have the parameter "
1823 "description first followed by a blank line (just a '*'). Afterwards follows "
1824 "the detailed description. All lines (outside program listings and CDATA "
1825 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1826 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1827 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1828 msgstr ""
1829 "Polje \"dokumentacija\" se razlikuje tudi za vsako vrsto simbola. Vrste "
1830 "simbolov, ki dobijo parametre, kot so funkcije ali makri, imajo najprej opis "
1831 "parametra, ki mu sledi prazna vrstica (le »*«). Nato sledi podroben opis. "
1832 "Vse vrstice (zunaj seznamov programov in razdelkov CDATA), ki vsebujejo samo "
1833 "'*' (prazno zvezdico), se pretvorijo v prelome odstavkov. Če ne želite "
1834 "preloma odstavka, ga spremenite v »*« (prazna zvezdica-prazno). To je "
1835 "uporabno v vnaprej oblikovanem besedilu (seznami kod)."
1836
1837 #. (itstool) path: listitem/para
1838 #: C/index.docbook:1087
1839 #, fuzzy
1840 msgid ""
1841 "What it is: The name for a class or function can sometimes be misleading for "
1842 "people coming from a different background."
1843 msgstr ""
1844 "Kaj je to: Ime razreda ali funkcije je včasih lahko zavajajoče za ljudi iz "
1845 "drugega okolja."
1846
1847 #. (itstool) path: listitem/para
1848 #: C/index.docbook:1093
1849 #, fuzzy
1850 msgid ""
1851 "What it does: Tell about common uses. Put it in relation with the other API."
1852 msgstr "Kaj počne: Povejte o pogostih uporabah. Povejte ga z drugim API-jem."
1853
1854 #. (itstool) path: tip/para
1855 #: C/index.docbook:1083
1856 #, fuzzy
1857 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1858 msgstr "Pri dokumentiranju kode opišite dva vidika: <_:itemizedlist-1/>"
1859
1860 #. (itstool) path: listitem/para
1861 #: C/index.docbook:1108
1862 #, fuzzy
1863 msgid "Use function() to refer to functions or macros which take arguments."
1864 msgstr ""
1865 "Uporabite funkcijo (), če se želite sklicevati na funkcije ali makre, ki "
1866 "zagovarjajo argumente."
1867
1868 #. (itstool) path: listitem/para
1869 #: C/index.docbook:1113
1870 #, fuzzy
1871 msgid ""
1872 "Use @param to refer to parameters. Also use this when referring to "
1873 "parameters of other functions, related to the one being described."
1874 msgstr ""
1875 "Uporabite @param za sklicevanje na parametre. To uporabite tudi pri "
1876 "sklicevanju na parametre drugih funkcij, povezanih z opisanim."
1877
1878 #. (itstool) path: listitem/para
1879 #: C/index.docbook:1119
1880 #, fuzzy
1881 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1882 msgstr ""
1883 "Uporabite %constant, da se sklicujete na konstanto, npr. %G_TRAVERSE_LEAFS."
1884
1885 #. (itstool) path: listitem/para
1886 #: C/index.docbook:1124
1887 #, fuzzy
1888 msgid ""
1889 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1890 "macros which don't take arguments."
1891 msgstr ""
1892 "Uporabite #symbol za sklicevanje na druge vrste simbolov, npr. strukture, "
1893 "enume in makre, ki ne sprejemajo argumentov."
1894
1895 #. (itstool) path: listitem/para
1896 #: C/index.docbook:1130
1897 #, fuzzy
1898 msgid "Use #Object::signal to refer to a GObject signal."
1899 msgstr "Uporabite signal #Object::, da se sklicujete na signal GObject."
1900
1901 #. (itstool) path: listitem/para
1902 #: C/index.docbook:1135
1903 #, fuzzy
1904 msgid "Use #Object:property to refer to a GObject property."
1905 msgstr "Uporabite #Object:property za sklicevanje na lastnost GObject."
1906
1907 #. (itstool) path: listitem/para
1908 #: C/index.docbook:1140
1909 #, fuzzy
1910 msgid ""
1911 "Use #Struct.field to refer to a field inside a structure and #GObjectClass."
1912 "foo_bar() to refer to a vmethod."
1913 msgstr ""
1914 "Uporabite #Struct.field za sklicevanje na polje znotraj strukture in "
1915 "#GObjectClass.foo_bar() za sklicevanje na vmetodo."
1916
1917 #. (itstool) path: sect1/para
1918 #: C/index.docbook:1102
1919 #, fuzzy
1920 msgid ""
1921 "One advantage of hyper-text over plain-text is the ability to have links in "
1922 "the document. Writing the correct markup for a link can be tedious though. "
1923 "GTK-Doc comes to help by providing several useful abbreviations. <_:"
1924 "itemizedlist-1/>"
1925 msgstr ""
1926 "Ena od prednosti hiperbesedila pred navadnim besedilom je možnost povezav v "
1927 "dokumentu. Pisanje pravilne oznake za povezavo pa je lahko dolgočasno. GTK-"
1928 "Doc vam pomaga z zagotavljanjem več uporabnih okrajšav. <_:itemizedlist-1/>"
1929
1930 #. (itstool) path: tip/para
1931 #: C/index.docbook:1149
1932 #, fuzzy
1933 msgid ""
1934 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1935 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1936 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
1937 "commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
1938 "with a backslash '\\'."
1939 msgstr ""
1940 "Če morate v dokumentaciji uporabiti posebne znake '&lt;', '&gt;', '()', '@', "
1941 "'%' ali '#', ne da bi jih GTK-Doc spremenil, lahko uporabite entitete XML "
1942 "\"&lt;\", \"&gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;commat;\", \"&amp;"
1943 "percnt;\" in \"&amp;num;\" ali pa se jim izognete s poševnico nazaj '\\'."
1944
1945 #. (itstool) path: sect1/para
1946 #: C/index.docbook:1158
1947 #, fuzzy
1948 msgid ""
1949 "DocBook can do more than just links. One can also have lists, examples, "
1950 "headings, and images. As of version 1.20, the preferred way is to use a "
1951 "subset of the basic text formatting syntax called <ulink url=\"http://"
1952 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1953 "versions any documentation that includes Markdown will be rendered as is. "
1954 "For example, list items will appear as lines starting with a dash."
1955 msgstr ""
1956 "DocBook lahko naredi več kot le povezave. Imate lahko tudi sezname, primere, "
1957 "naslove in slike. Od različice 1.20 je najprimernejši način uporaba "
1958 "podnabora osnovne sintakse oblikovanja besedila, imenovane <ulink url="
1959 "\"http://daringfireball.net/projects/markdown/\">Markdown</ulink>. V "
1960 "starejših različicah GTK-Doc bo vsa dokumentacija, ki vključuje Markdown, "
1961 "upodobljena takšna, kot je. Elementi seznama bodo na primer prikazani kot "
1962 "vrstice, ki se začnejo s pomišljajem."
1963
1964 #. (itstool) path: sect1/para
1965 #: C/index.docbook:1169
1966 #, fuzzy
1967 msgid ""
1968 "While markdown is now preferred one can mix both. One limitation here is "
1969 "that one can use docbook xml within markdown, but markdown within docbook "
1970 "xml is not supported."
1971 msgstr ""
1972 "Medtem ko je markdown zdaj prednosten, lahko mešamo oboje. Ena od omejitev "
1973 "je, da lahko uporabite docbook xml znotraj markdowna, vendar označevanje v "
1974 "docbook xml ni podprto."
1975
1976 #. (itstool) path: sect1/para
1977 #: C/index.docbook:1175
1978 #, fuzzy
1979 msgid ""
1980 "In older GTK-Doc releases, if you need support for additional formatting, "
1981 "you would need to enable the usage of docbook XML tags inside doc-comments "
1982 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1983 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1984 "filename>."
1985 msgstr ""
1986 "Če v starejših izdajah GTK-Doc potrebujete podporo za dodatno oblikovanje, "
1987 "morate omogočiti uporabo oznak XML docbook znotraj doc-komentarjev tako, da "
1988 "vstavite <option>--xml-način (ali<option>--sgml-način) v spremenljivi "
1989 "<symbol>MKDB_OPTIONS</symbol> znotraj <filename>Makefile.am</filename>."
1990
1991 #. (itstool) path: example/title
1992 #: C/index.docbook:1184
1993 #, fuzzy
1994 msgid "GTK-Doc comment block using Markdown"
1995 msgstr "Blok komentarjev GTK-Doc z uporabo Markdowna"
1996
1997 #. (itstool) path: example/programlisting
1998 #: C/index.docbook:1185
1999 #, fuzzy, no-wrap
2000 msgid ""
2001 "\n"
2002 "/**\n"
2003 " * identifier:\n"
2004 " *\n"
2005 " * documentation paragraph ...\n"
2006 " *\n"
2007 " * # Sub Heading #\n"
2008 " *\n"
2009 " * ## Second Sub Heading\n"
2010 " *\n"
2011 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
2012 " *\n"
2013 " * more documentation:\n"
2014 " *\n"
2015 " * - list item 1\n"
2016 " *\n"
2017 " * Paragraph inside a list item.\n"
2018 " *\n"
2019 " * - list item 2\n"
2020 " *\n"
2021 " * 1. numbered list item\n"
2022 " *\n"
2023 " * 2. another numbered list item\n"
2024 " *\n"
2025 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
2026 " *\n"
2027 " * ![an inline image](plot-result.png)\n"
2028 " *\n"
2029 " * [A link to the heading anchor above][heading-two]\n"
2030 " *\n"
2031 " * A C-language example:\n"
2032 " * |[&lt;!-- language=\"C\" --&gt;\n"
2033 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
2034 " * ]|\n"
2035 " */\n"
2036 msgstr ""
2037 "\n"
2038 "/**\n"
2039 " *Identifikator:\n"
2040 " *\n"
2041 " * dokumentacijski odstavek ...\n"
2042 " *\n"
2043 " * # Podnaslov #\n"
2044 " *\n"
2045 " * ## Drugi podnaslov\n"
2046 " *\n"
2047 " * # Podnaslov s sidrom povezave # {#heading-two}\n"
2048 " *\n"
2049 " * Več dokumentacije:\n"
2050 " *\n"
2051 " * - postavka seznama 1\n"
2052 " *\n"
2053 " * Odstavek znotraj elementa seznama.\n"
2054 " *\n"
2055 " * - postavka seznama 2\n"
2056 " *\n"
2057 " * 1. Element oštevilčenega seznama\n"
2058 " *\n"
2059 " * 2. Še en element oštevilčenega seznama\n"
2060 " *\n"
2061 " * Še en odstavek. [Povezava do spletne strani GNOME] (http://www.gnome.org/)\n"
2062 " *\n"
2063 " * ! [slika v vrstici] (plot-result.png)\n"
2064 " *\n"
2065 " * [Povezava do sidra naslova zgoraj][naslov dva]\n"
2066 " *\n"
2067 " * Primer jezika C:\n"
2068 " * |[&lt;!-- language=\"C\" --&gt;\n"
2069 " * GtkWidget *label = gtk_label_new (\"Čudovito!\");\n"
2070 " * ]|\n"
2071 " */\n"
2072
2073 #. (itstool) path: sect1/para
2074 #: C/index.docbook:1224
2075 #, fuzzy
2076 msgid ""
2077 "More examples of what markdown tags are supported can be found in the <ulink "
2078 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
2079 "Documentation Markdown Syntax Reference</ulink>."
2080 msgstr ""
2081 "Več primerov, katere oznake so podprte, najdete v <ulink url=\"https://wiki."
2082 "gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">sklicu sintakse "
2083 "sintakse oznake dokumentacije GTK</ulink>."
2084
2085 #. (itstool) path: tip/para
2086 #: C/index.docbook:1230
2087 #, fuzzy
2088 msgid ""
2089 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
2090 "cannot write documentation for static symbols. Nevertheless it is good to "
2091 "comment those symbols too. This helps other developers to understand your "
2092 "code. Therefore we recommend to comment these using normal comments (without "
2093 "the 2nd '*' in the first line). If later the function needs to be made "
2094 "public, all one needs to do is to add another '*' in the comment block and "
2095 "insert the symbol name at the right place inside the sections file."
2096 msgstr ""
2097 "Kot smo že omenili, je GTK-Doc namenjen dokumentiranju javnega API-ja. Tako "
2098 "ne moremo pisati dokumentacije za statične simbole. Kljub temu je dobro "
2099 "komentirati tudi te simbole. Tako bodo drugi razvijalci lažje razumeli vašo "
2100 "kodo. Zato priporočamo, da jih komentirate z običajnimi komentarji (brez 2. "
2101 "\"*\" v prvi vrstici). Če je pozneje treba funkcijo objaviti, morate le "
2102 "dodati še en '*' v blok komentarjev in vstaviti ime simbola na pravo mesto v "
2103 "datoteki razdelkov."
2104
2105 #. (itstool) path: sect1/title
2106 #: C/index.docbook:1245
2107 #, fuzzy
2108 msgid "Documenting sections"
2109 msgstr "Dokumentiranje odsekov"
2110
2111 #. (itstool) path: sect1/para
2112 #: C/index.docbook:1247
2113 #, fuzzy
2114 msgid ""
2115 "Each section of the documentation contains information about one class or "
2116 "module. To introduce the component one can write a section block. The short "
2117 "description is also used inside the table of contents. All the @fields are "
2118 "optional."
2119 msgstr ""
2120 "Vsak razdelek dokumentacije vsebuje informacije o enem razredu ali modulu. "
2121 "Za uvedbo komponente lahko napišemo blok odsekov. Kratek opis se uporablja "
2122 "tudi znotraj kazala. Vse @fields so neobvezne."
2123
2124 #. (itstool) path: example/title
2125 #: C/index.docbook:1255
2126 #, fuzzy
2127 msgid "Section comment block"
2128 msgstr "Razdelek blok komentarjev"
2129
2130 #. (itstool) path: example/programlisting
2131 #: C/index.docbook:1256
2132 #, fuzzy, no-wrap
2133 msgid ""
2134 "\n"
2135 "/**\n"
2136 " * SECTION:meepapp\n"
2137 " * @short_description: the application class\n"
2138 " * @title: Meep application\n"
2139 " * @section_id:\n"
2140 " * @see_also: #MeepSettings\n"
2141 " * @stability: Stable\n"
2142 " * @include: meep/app.h\n"
2143 " * @image: application.png\n"
2144 " *\n"
2145 " * The application class handles ...\n"
2146 " */\n"
2147 msgstr ""
2148 "\n"
2149 "/**\n"
2150 " * ODDELEK:meepapp\n"
2151 " * @short_description: razred aplikacije\n"
2152 " * @title: Prijava Meep\n"
2153 " * @section_id:\n"
2154 " * @see_also: #MeepSettings\n"
2155 " * @stability: Stabilen\n"
2156 " * @include: meep/app.h\n"
2157 " * @image: application.png\n"
2158 " *\n"
2159 " * Razred aplikacije obravnava ...\n"
2160 " */\n"
2161
2162 #. (itstool) path: varlistentry/term
2163 #: C/index.docbook:1275
2164 #, fuzzy
2165 msgid "SECTION:&lt;name&gt;"
2166 msgstr "ODDELEK:&lt;ime&gt;"
2167
2168 #. (itstool) path: listitem/para
2169 #: C/index.docbook:1277
2170 #, fuzzy
2171 msgid ""
2172 "The name links the section documentation to the respective part in the "
2173 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2174 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
2175 "txt</filename> file."
2176 msgstr ""
2177 "Ime poveže dokumentacijo razdelka z ustreznim delom v datoteki <filename>&lt;"
2178 "paket&gt;-sections.txt</filename> . Tukaj navedeno ime se mora ujemati z "
2179 "oznako &lt;FILE&gt; v datoteki <filename>&lt;package&gt;-sections.txt</"
2180 "filename> ."
2181
2182 #. (itstool) path: varlistentry/term
2183 #: C/index.docbook:1286
2184 #, fuzzy
2185 msgid "@short_description"
2186 msgstr "Kratek opis"
2187
2188 #. (itstool) path: listitem/para
2189 #: C/index.docbook:1288
2190 #, fuzzy
2191 msgid ""
2192 "A one line description of the section, that later will appear after the "
2193 "links in the TOC and at the top of the section page."
2194 msgstr ""
2195 "Opis odseka v eni vrstici, ki se bo kasneje pojavil za povezavami v TOC in "
2196 "na vrhu strani razdelka."
2197
2198 #. (itstool) path: varlistentry/term
2199 #: C/index.docbook:1295
2200 #, fuzzy
2201 msgid "@title"
2202 msgstr "_Naziv"
2203
2204 #. (itstool) path: listitem/para
2205 #: C/index.docbook:1297
2206 #, fuzzy
2207 msgid ""
2208 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2209 "can be overridden with the @title field."
2210 msgstr ""
2211 "Naslov razdelka je privzeto nastavljen na &lt;ime&gt; iz izjave SECTION. "
2212 "Lahko ga preglasite s poljem @title."
2213
2214 #. (itstool) path: varlistentry/term
2215 #: C/index.docbook:1304
2216 #, fuzzy
2217 msgid "@section_id"
2218 msgstr "@section_id"
2219
2220 #. (itstool) path: listitem/para
2221 #: C/index.docbook:1306
2222 #, fuzzy
2223 msgid ""
2224 "Overrides the use of title as a section identifier. For GObjects the &lt;"
2225 "title&gt; is used as a section_id and for other sections it is &lt;"
2226 "MODULE&gt;-&lt;title&gt;."
2227 msgstr ""
2228 "Preglasi uporabo naslova kot identifikatorja razdelka. Za GObjects se &lt;"
2229 "naslov&gt; uporablja kot section_id, za druge razdelke pa &lt;MODULE&gt;-&lt;"
2230 "naslov&gt;."
2231
2232 #. (itstool) path: varlistentry/term
2233 #: C/index.docbook:1314
2234 #, fuzzy
2235 msgid "@see_also"
2236 msgstr "Poglejte tudi:"
2237
2238 #. (itstool) path: listitem/para
2239 #: C/index.docbook:1316
2240 #, fuzzy
2241 msgid "A list of symbols that are related to this section."
2242 msgstr "Seznam simbolov, ki so povezani s tem razdelkom."
2243
2244 #. (itstool) path: varlistentry/term
2245 #: C/index.docbook:1322
2246 #, fuzzy
2247 msgid "@stability"
2248 msgstr "stabilnost"
2249
2250 #. (itstool) path: listitem/para
2251 #: C/index.docbook:1329
2252 #, fuzzy
2253 msgid ""
2254 "Stable - The intention of a Stable interface is to enable arbitrary third "
2255 "parties to develop applications to these interfaces, release them, and have "
2256 "confidence that they will run on all minor releases of the product (after "
2257 "the one in which the interface was introduced, and within the same major "
2258 "release). Even at a major release, incompatible changes are expected to be "
2259 "rare, and to have strong justifications."
2260 msgstr ""
2261 "Stabilen - Namen stabilnega vmesnika je omogočiti poljubnim tretjim osebam, "
2262 "da razvijejo aplikacije za te vmesnike, jih sprostijo in zaupajo, da bodo "
2263 "delovale na vseh manjših izdajah izdelka (po tistem, v katerem je bil "
2264 "vmesnik uveden, in v isti večji izdaji). Tudi ob večji izdaji se pričakuje, "
2265 "da bodo nezdružljive spremembe redke in bodo imele močne utemeljitve."
2266
2267 #. (itstool) path: listitem/para
2268 #: C/index.docbook:1341
2269 #, fuzzy
2270 msgid ""
2271 "Unstable - Unstable interfaces are experimental or transitional. They are "
2272 "typically used to give outside developers early access to new or rapidly "
2273 "changing technology, or to provide an interim solution to a problem where a "
2274 "more general solution is anticipated. No claims are made about either source "
2275 "or binary compatibility from one minor release to the next."
2276 msgstr ""
2277 "Nestabilni - nestabilni vmesniki so eksperimentalni ali prehodni. Običajno "
2278 "se uporabljajo za zgodnji dostop zunanjih razvijalcev do nove ali hitro "
2279 "spreminjajoče se tehnologije ali za zagotavljanje začasne rešitve problema, "
2280 "pri katerem se pričakuje splošnejša rešitev. Od ene manjše izdaje do druge "
2281 "niso podane nobene trditve o izvorni ali binarni združljivosti."
2282
2283 #. (itstool) path: listitem/para
2284 #: C/index.docbook:1353
2285 #, fuzzy
2286 msgid ""
2287 "Private - An interface that can be used within the GNOME stack itself, but "
2288 "that is not documented for end-users. Such functions should only be used in "
2289 "specified and documented ways."
2290 msgstr ""
2291 "Zasebno - Vmesnik, ki se lahko uporablja znotraj samega sklada GNOME, vendar "
2292 "ni dokumentiran za končne uporabnike. Takšne funkcije bi bilo treba "
2293 "uporabljati le na določene in dokumentirane načine."
2294
2295 #. (itstool) path: listitem/para
2296 #: C/index.docbook:1362
2297 #, fuzzy
2298 msgid ""
2299 "Internal - An interface that is internal to a module and does not require "
2300 "end-user documentation. Functions that are undocumented are assumed to be "
2301 "Internal."
2302 msgstr ""
2303 "Notranji – vmesnik, ki je znotraj modula in ne zahteva dokumentacije "
2304 "končnega uporabnika. Za nedokumentirane funkcije se predpostavlja, da so "
2305 "notranje."
2306
2307 #. (itstool) path: listitem/para
2308 #: C/index.docbook:1324
2309 #, fuzzy
2310 msgid ""
2311 "An informal description of the stability level this API has. We recommend "
2312 "the use of one of these terms: <_:itemizedlist-1/>"
2313 msgstr ""
2314 "Neformalni opis ravni stabilnosti, ki jo ima ta API. Priporočamo uporabo "
2315 "enega od teh izrazov: <_:itemizedlist-1/>"
2316
2317 #. (itstool) path: varlistentry/term
2318 #: C/index.docbook:1374
2319 #, fuzzy
2320 msgid "@include"
2321 msgstr "Vključi"
2322
2323 #. (itstool) path: listitem/para
2324 #: C/index.docbook:1376
2325 #, fuzzy
2326 msgid ""
2327 "The <literal>#include</literal> files to show in the section synopsis (a "
2328 "comma separated list), overriding the global value from the <link linkend="
2329 "\"metafiles_sections\">section file</link> or command line. This item is "
2330 "optional."
2331 msgstr ""
2332 "<literal>#include</literal> datotek, ki bodo prikazane v povzetku odseka "
2333 "(seznam, ločen z vejico), ki preglasi globalno vrednost iz datoteke odseka "
2334 "<link linkend=\"metafiles_sections\">ali ukazne vrstice. Ta postavka ni "
2335 "obvezna."
2336
2337 #. (itstool) path: varlistentry/term
2338 #: C/index.docbook:1385
2339 #, fuzzy
2340 msgid "@image"
2341 msgstr "Ni slike."
2342
2343 #. (itstool) path: listitem/para
2344 #: C/index.docbook:1387
2345 #, fuzzy
2346 msgid ""
2347 "The image to display at the top of the reference page for this section. This "
2348 "will often be some sort of a diagram to illustrate the visual appearance of "
2349 "a class or a diagram of its relationship to other classes. This item is "
2350 "optional."
2351 msgstr ""
2352 "Slika, ki bo prikazana na vrhu referenčne strani za ta razdelek. To je "
2353 "pogosto nekakšen diagram, ki ponazarja vizualni videz razreda ali diagram "
2354 "njegovega odnosa do drugih razredov. Ta postavka ni obvezna."
2355
2356 #. (itstool) path: tip/para
2357 #: C/index.docbook:1398
2358 #, fuzzy
2359 msgid ""
2360 "To avoid unnecessary recompilation after doc-changes put the section docs "
2361 "into the c-source where possible."
2362 msgstr ""
2363 "Da bi se izognili nepotrebnemu ponovnemu prevajanju po spremembah "
2364 "dokumentov, vstavite dokumente razdelkov v c-vir, kjer je to mogoče."
2365
2366 #. (itstool) path: sect1/title
2367 #: C/index.docbook:1407
2368 #, fuzzy
2369 msgid "Documenting symbols"
2370 msgstr "Dokumentiranje simbolov"
2371
2372 #. (itstool) path: sect1/para
2373 #: C/index.docbook:1409
2374 #, fuzzy
2375 msgid ""
2376 "Each symbol (function, macro, struct, enum, signal and property) is "
2377 "documented in a separate block. The block is best placed close to the "
2378 "definition of the symbols so that it is easy to keep them in sync. Thus "
2379 "functions are usually documented in the c-source and macros, structs and "
2380 "enums in the header file."
2381 msgstr ""
2382 "Vsak simbol (funkcija, makro, struktura, enum, signal in lastnost) je "
2383 "dokumentiran v ločenem bloku. Blok je najbolje namestiti blizu definicije "
2384 "simbolov, tako da jih je enostavno sinhronizirati. Tako so funkcije običajno "
2385 "dokumentirane v c-viru in makrih, strukturah in enumih v datoteki glave."
2386
2387 #. (itstool) path: sect2/title
2388 #. (itstool) path: example/title
2389 #: C/index.docbook:1417 C/index.docbook:1483
2390 msgid "General tags"
2391 msgstr "Splošne oznake"
2392
2393 #. (itstool) path: sect2/para
2394 #: C/index.docbook:1419
2395 #, fuzzy
2396 msgid ""
2397 "You can add versioning information to all documentation elements to tell "
2398 "when an API was introduced, or when it was deprecated."
2399 msgstr ""
2400 "Informacije o različicah lahko dodate vsem elementom dokumentacije, da "
2401 "ugotovite, kdaj je bil API uveden ali kdaj zastarel."
2402
2403 #. (itstool) path: variablelist/title
2404 #: C/index.docbook:1424
2405 #, fuzzy
2406 msgid "Versioning Tags"
2407 msgstr "Oznake za shranjevanje različic"
2408
2409 #. (itstool) path: varlistentry/term
2410 #: C/index.docbook:1425
2411 #, fuzzy
2412 msgid "Since:"
2413 msgstr "Največje število dni, ki so minili od zaznave"
2414
2415 #. (itstool) path: listitem/para
2416 #: C/index.docbook:1427
2417 #, fuzzy
2418 msgid "Description since which version of the code the API is available."
2419 msgstr "Opis, od katere različice kode je API na voljo."
2420
2421 #. (itstool) path: varlistentry/term
2422 #: C/index.docbook:1432
2423 #, fuzzy
2424 msgid "Deprecated:"
2425 msgstr "Zastarelo"
2426
2427 #. (itstool) path: listitem/para
2428 #: C/index.docbook:1434
2429 #, fuzzy
2430 msgid ""
2431 "Paragraph denoting that this function should no be used anymore. The "
2432 "description should point the reader to the new API."
2433 msgstr ""
2434 "Odstavek, ki označuje, da se ta funkcija ne sme več uporabljati. Opis mora "
2435 "bralca usmeriti na nov API."
2436
2437 #. (itstool) path: sect2/para
2438 #: C/index.docbook:1442
2439 #, fuzzy
2440 msgid ""
2441 "You can also add stability information to all documentation elements to "
2442 "indicate whether API stability is guaranteed for them for all future minor "
2443 "releases of the project."
2444 msgstr ""
2445 "Vsem dokumentacijskim elementom lahko dodate tudi informacije o stabilnosti, "
2446 "da označite, ali je zanje zagotovljena stabilnost API-ja za vse prihodnje "
2447 "manjše izdaje projekta."
2448
2449 #. (itstool) path: sect2/para
2450 #: C/index.docbook:1448
2451 #, fuzzy
2452 msgid ""
2453 "The default stability level for all documentation elements can be set by "
2454 "passing the <option>--default-stability</option> argument to "
2455 "<application>gtkdoc-mkdb</application> with one of the values below."
2456 msgstr ""
2457 "Privzeto raven stabilnosti za vse elemente dokumentacije lahko nastavite "
2458 "tako, da prenesete <option>--Argument privzete stabilnosti za "
2459 "<application>GTKDOC-MKDB</application> z eno od spodnjih vrednosti."
2460
2461 #. (itstool) path: variablelist/title
2462 #: C/index.docbook:1454
2463 #, fuzzy
2464 msgid "Stability Tags"
2465 msgstr "Oznake stabilnosti"
2466
2467 #. (itstool) path: varlistentry/term
2468 #: C/index.docbook:1455
2469 #, fuzzy
2470 msgid "Stability: Stable"
2471 msgstr "Stabilnost: stabilna"
2472
2473 #. (itstool) path: listitem/para
2474 #: C/index.docbook:1457
2475 #, fuzzy
2476 msgid ""
2477 "Mark the element as stable. This is for public APIs which are guaranteed to "
2478 "remain stable for all future minor releases of the project."
2479 msgstr ""
2480 "Označite element kot stabilen. To velja za javne vmesnike aplikacijskih "
2481 "programov, za katere je zagotovljeno, da bodo ostali stabilni pri vseh "
2482 "prihodnjih manjših objavah projekta."
2483
2484 #. (itstool) path: varlistentry/term
2485 #: C/index.docbook:1464
2486 #, fuzzy
2487 msgid "Stability: Unstable"
2488 msgstr "Stabilnost: nestabilna"
2489
2490 #. (itstool) path: listitem/para
2491 #: C/index.docbook:1466
2492 #, fuzzy
2493 msgid ""
2494 "Mark the element as unstable. This is for public APIs which are released as "
2495 "a preview before being stabilised."
2496 msgstr ""
2497 "Označite element kot nestabilen. To velja za javne API-je, ki so izdani kot "
2498 "predogled, preden se stabilizirajo."
2499
2500 #. (itstool) path: varlistentry/term
2501 #: C/index.docbook:1472
2502 #, fuzzy
2503 msgid "Stability: Private"
2504 msgstr "Stabilnost: zasebna"
2505
2506 #. (itstool) path: listitem/para
2507 #: C/index.docbook:1474
2508 #, fuzzy
2509 msgid ""
2510 "Mark the element as private. This is for interfaces which can be used by "
2511 "tightly coupled modules, but not by arbitrary third parties."
2512 msgstr ""
2513 "Označite element kot zaseben. To velja za vmesnike, ki jih lahko uporabljajo "
2514 "tesno povezani moduli, ne pa poljubne tretje osebe."
2515
2516 #. (itstool) path: example/programlisting
2517 #: C/index.docbook:1484
2518 #, fuzzy, no-wrap
2519 msgid ""
2520 "\n"
2521 "/**\n"
2522 " * foo_get_bar:\n"
2523 " * @foo: some foo\n"
2524 " *\n"
2525 " * Retrieves @foo's bar.\n"
2526 " *\n"
2527 " * Returns: @foo's bar\n"
2528 " *\n"
2529 " * Since: 2.6\n"
2530 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2531 " */\n"
2532 "Bar *\n"
2533 "foo_get_bar(Foo *foo)\n"
2534 "{\n"
2535 "...\n"
2536 msgstr ""
2537 "\n"
2538 "/**\n"
2539 " * foo_get_bar:\n"
2540 " * @foo: nekaj foo\n"
2541 " *\n"
2542 " * Pridobi vrstico @foo.\n"
2543 " *\n"
2544 " * Vrne: vrstica @foo\n"
2545 " *\n"
2546 " * Ker: 2.6\n"
2547 " * Zastarelo: 2.12: namesto tega uporabite foo_baz_get_bar().\n"
2548 " */\n"
2549 "Bar*\n"
2550 "foo_get_bar(Foo *foo)\n"
2551 "{\n"
2552 "...\n"
2553
2554 #. (itstool) path: sect2/title
2555 #. (itstool) path: example/title
2556 #: C/index.docbook:1504 C/index.docbook:1514
2557 msgid "Annotations"
2558 msgstr "Pripombe"
2559
2560 #. (itstool) path: sect2/para
2561 #: C/index.docbook:1506
2562 #, fuzzy
2563 msgid ""
2564 "Documentation blocks can contain annotation-tags. These tags will be "
2565 "rendered with tooltips describing their meaning. The tags are used by "
2566 "gobject-introspection to generate language bindings. A detailed list of the "
2567 "supported tags can be found on <ulink url=\"https://gi.readthedocs.io/en/"
2568 "latest/annotations/giannotations.html\" type=\"http\">the wiki</ulink>."
2569 msgstr ""
2570 "Dokumentacijski bloki lahko vsebujejo oznake za opombe. Te oznake bodo "
2571 "upodobljene z opisi orodij, ki opisujejo njihov pomen. Oznake se uporabljajo "
2572 "z introspekcijo predmetov za ustvarjanje jezikovnih vezi. Podroben seznam "
2573 "podprtih oznak najdete na <ulink url=\"https://gi.readthedocs.io/en/latest/"
2574 "annotations/giannotations.html\" type=\"http\">wikiju</ulink>."
2575
2576 #. (itstool) path: example/programlisting
2577 #: C/index.docbook:1515
2578 #, fuzzy, no-wrap
2579 msgid ""
2580 "\n"
2581 "/**\n"
2582 " * foo_get_bar: (annotation)\n"
2583 " * @foo: (annotation): some foo\n"
2584 " *\n"
2585 " * Retrieves @foo's bar.\n"
2586 " *\n"
2587 " * Returns: (annotation): @foo's bar\n"
2588 " */\n"
2589 "...\n"
2590 "/**\n"
2591 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2592 " * (and another annotation)\n"
2593 " * @foo: (annotation) (another annotation): some foo\n"
2594 " *\n"
2595 " * Sets bar on @foo.\n"
2596 " */\n"
2597 msgstr ""
2598 "\n"
2599 "/**\n"
2600 " * foo_get_bar: (opomba)\n"
2601 " * @foo: (opomba): nekaj foo\n"
2602 " *\n"
2603 " * Pridobi vrstico @foo.\n"
2604 " *\n"
2605 " * Vračila: (opomba): vrstica @foo\n"
2606 " */\n"
2607 "...\n"
2608 "/**\n"
2609 " * foo_set_bar_using_the_frobnicator: (opomba) (druga opomba)\n"
2610 " * (in druga opomba)\n"
2611 " * @foo: (opomba) (druga opomba): nekaj foo\n"
2612 " *\n"
2613 " * Nastavi vrstico na @foo.\n"
2614 " */\n"
2615
2616 #. (itstool) path: sect2/title
2617 #. (itstool) path: example/title
2618 #: C/index.docbook:1536 C/index.docbook:1565
2619 #, fuzzy
2620 msgid "Function comment block"
2621 msgstr "Funkcija blok komentarjev"
2622
2623 #. (itstool) path: listitem/para
2624 #: C/index.docbook:1542
2625 #, fuzzy
2626 msgid ""
2627 "Document whether returned objects, lists, strings, etc, should be freed/"
2628 "unrefed/released."
2629 msgstr ""
2630 "Dokumentirajte, ali naj bodo vrnjeni predmeti, seznami, nizi itd. osvobojeni/"
2631 "nezavrnjeni/sproščeni."
2632
2633 #. (itstool) path: listitem/para
2634 #: C/index.docbook:1548
2635 #, fuzzy
2636 msgid "Document whether parameters can be NULL, and what happens if they are."
2637 msgstr "Dokumentirajte, ali so parametri lahko NULL in kaj se zgodi, če so."
2638
2639 #. (itstool) path: listitem/para
2640 #: C/index.docbook:1553
2641 #, fuzzy
2642 msgid ""
2643 "Mention interesting pre-conditions and post-conditions where appropriate."
2644 msgstr "Navedite zanimive predpogoje in postpogoje, kjer je to primerno."
2645
2646 #. (itstool) path: sect2/para
2647 #: C/index.docbook:1538 C/index.docbook:1624
2648 #, fuzzy
2649 msgid "Please remember to: <_:itemizedlist-1/>"
2650 msgstr "Ne pozabite: <_:itemizedlist-1/>"
2651
2652 #. (itstool) path: sect2/para
2653 #: C/index.docbook:1560
2654 #, fuzzy
2655 msgid ""
2656 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2657 "private. They are treated like static functions."
2658 msgstr ""
2659 "Gtk-doc predvideva, da so vsi simboli (makri, funkcije), ki se začnejo z "
2660 "'_', zasebni. Obravnavajo se kot statične funkcije."
2661
2662 #. (itstool) path: example/programlisting
2663 #: C/index.docbook:1566
2664 #, fuzzy, no-wrap
2665 msgid ""
2666 "\n"
2667 "/**\n"
2668 " * function_name:\n"
2669 " * @par1: description of parameter 1. These can extend over more than\n"
2670 " * one line.\n"
2671 " * @par2: description of parameter 2\n"
2672 " * @...: a %NULL-terminated list of bars\n"
2673 " *\n"
2674 " * The function description goes here. You can use @par1 to refer to parameters\n"
2675 " * so that they are highlighted in the output. You can also use %constant\n"
2676 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2677 " * other declarations (which may be documented elsewhere).\n"
2678 " *\n"
2679 " * Returns: an integer.\n"
2680 " *\n"
2681 " * Since: 2.2\n"
2682 " * Deprecated: 2.18: Use other_function() instead.\n"
2683 " */\n"
2684 msgstr ""
2685 "\n"
2686 "/**\n"
2687 " * function_name:\n"
2688 " * @par1: opis parametra 1. Te lahko obsegajo več kot\n"
2689 " * Ena vrstica.\n"
2690 " * @par2: opis parametra 2\n"
2691 " * @...: seznam vrstic s končnico %NULL\n"
2692 " *\n"
2693 " * Opis funkcije gre tukaj. Za sklicevanje na parametre lahko uporabite @par1\n"
2694 " * tako, da so označeni v izhodu. Uporabite lahko tudi %constant\n"
2695 " * za konstante, function_name2() za funkcije in #GtkWidget za povezave do\n"
2696 " * druge izjave (ki se lahko dokumentirajo drugje).\n"
2697 " *\n"
2698 " * Vrne se: celo število.\n"
2699 " *\n"
2700 " * Ker: 2.2\n"
2701 " * Zastarelo: 2.18: Namesto tega uporabite other_function().\n"
2702 " */\n"
2703
2704 #. (itstool) path: variablelist/title
2705 #: C/index.docbook:1587
2706 #, fuzzy
2707 msgid "Function tags"
2708 msgstr "Funkcijske oznake"
2709
2710 #. (itstool) path: varlistentry/term
2711 #: C/index.docbook:1588 C/index.docbook:1795
2712 #, fuzzy
2713 msgid "Returns:"
2714 msgstr "vrne"
2715
2716 #. (itstool) path: listitem/para
2717 #: C/index.docbook:1590
2718 #, fuzzy
2719 msgid "Paragraph describing the returned result."
2720 msgstr "Odstavek, ki opisuje vrnjeni rezultat."
2721
2722 #. (itstool) path: varlistentry/term
2723 #: C/index.docbook:1595
2724 #, fuzzy
2725 msgid "@...:"
2726 msgstr "@...:"
2727
2728 #. (itstool) path: listitem/para
2729 #: C/index.docbook:1597
2730 #, fuzzy
2731 msgid ""
2732 "In case the function has variadic arguments, you should use this tag "
2733 "(@Varargs: does also work for historic reasons)."
2734 msgstr ""
2735 "Če ima funkcija variadične argumente, uporabite to oznako (@Varargs: deluje "
2736 "tudi iz zgodovinskih razlogov)."
2737
2738 #. (itstool) path: sect2/title
2739 #. (itstool) path: example/title
2740 #: C/index.docbook:1607 C/index.docbook:1609
2741 #, fuzzy
2742 msgid "Property comment block"
2743 msgstr "Blok komentarjev znamke"
2744
2745 #. (itstool) path: example/programlisting
2746 #: C/index.docbook:1610
2747 #, fuzzy, no-wrap
2748 msgid ""
2749 "\n"
2750 "/**\n"
2751 " * SomeWidget:some-property:\n"
2752 " *\n"
2753 " * Here you can document a property.\n"
2754 " */\n"
2755 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2756 msgstr ""
2757 "\n"
2758 "/**\n"
2759 " * SomeWidget:some-property:\n"
2760 " *\n"
2761 " * Tukaj lahko dokumentirate nepremičnino.\n"
2762 " */\n"
2763 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2764
2765 #. (itstool) path: sect2/title
2766 #. (itstool) path: example/title
2767 #: C/index.docbook:1622 C/index.docbook:1641
2768 #, fuzzy
2769 msgid "Signal comment block"
2770 msgstr "Blok komentarjev signala"
2771
2772 #. (itstool) path: listitem/para
2773 #: C/index.docbook:1628
2774 #, fuzzy
2775 msgid ""
2776 "Document when the signal is emitted and whether it is emitted before or "
2777 "after other signals."
2778 msgstr ""
2779 "Dokumentirajte, kdaj je signal oddan in ali se oddaja pred drugimi signali "
2780 "ali za njimi."
2781
2782 #. (itstool) path: listitem/para
2783 #: C/index.docbook:1634
2784 #, fuzzy
2785 msgid "Document what an application might do in the signal handler."
2786 msgstr ""
2787 "Dokumentirajte, kaj lahko aplikacija naredi v rutini za obravnavo signala."
2788
2789 #. (itstool) path: example/programlisting
2790 #: C/index.docbook:1642
2791 #, fuzzy, no-wrap
2792 msgid ""
2793 "\n"
2794 "/**\n"
2795 " * FooWidget::foobarized:\n"
2796 " * @widget: the widget that received the signal\n"
2797 " * @foo: some foo\n"
2798 " * @bar: some bar\n"
2799 " *\n"
2800 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2801 " */\n"
2802 "foo_signals[FOOBARIZED] =\n"
2803 " g_signal_new (\"foobarized\",\n"
2804 " ...\n"
2805 msgstr ""
2806 "\n"
2807 "/**\n"
2808 " * FooWidget::foobarized:\n"
2809 " * @widget: pripomoček, ki je prejel signal\n"
2810 " * @foo: nekaj foo\n"
2811 " * @bar: nekaj bara\n"
2812 " *\n"
2813 " * Foobariziran signal se oddaja vsakič, ko nekdo poskuša prevarati @widget.\n"
2814 " */\n"
2815 "foo_signals[FOOBARIZED] =\n"
2816 " g_signal_new (\"foobariziran\",\n"
2817 " ...\n"
2818
2819 #. (itstool) path: sect2/title
2820 #. (itstool) path: example/title
2821 #: C/index.docbook:1659 C/index.docbook:1660
2822 #, fuzzy
2823 msgid "Struct comment block"
2824 msgstr "Strukturiranje bloka komentarjev"
2825
2826 #. (itstool) path: example/programlisting
2827 #: C/index.docbook:1661
2828 #, fuzzy, no-wrap
2829 msgid ""
2830 "\n"
2831 "/**\n"
2832 " * FooWidget:\n"
2833 " * @bar: some #gboolean\n"
2834 " *\n"
2835 " * This is the best widget, ever.\n"
2836 " */\n"
2837 "typedef struct _FooWidget {\n"
2838 " GtkWidget parent_instance;\n"
2839 "\n"
2840 " gboolean bar;\n"
2841 "} FooWidget;\n"
2842 msgstr ""
2843 "\n"
2844 "/**\n"
2845 " * FooWidget:\n"
2846 " * @bar: nekaj #gboolean\n"
2847 " *\n"
2848 " * To je najboljši pripomoček doslej.\n"
2849 " */\n"
2850 "vrstni def struktura _FooWidget {\n"
2851 " GtkWidget parent_instance;\n"
2852 "\n"
2853 "gboolenova palica;\n"
2854 "} FooWidget;\n"
2855
2856 #. (itstool) path: sect2/para
2857 #: C/index.docbook:1676
2858 #, fuzzy
2859 msgid ""
2860 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2861 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2862 "behaviour."
2863 msgstr ""
2864 "Uporabite <code>/*&lt; private &gt;*/</code> pred zasebnimi polji za "
2865 "strukturiranje, ki jih želite skriti. Uporaba <code>/*&lt; public &gt;*/</"
2866 "code> za obratno vedenje."
2867
2868 #. (itstool) path: sect2/para
2869 #: C/index.docbook:1682
2870 #, fuzzy
2871 msgid ""
2872 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2873 "it will be considered private automatically and doesn't need to be mentioned "
2874 "in the comment block."
2875 msgstr ""
2876 "Če je prvo polje »g_iface«, »parent_instance« ali »parent_class«, bo "
2877 "samodejno obravnavano kot zasebno in ga ni treba omeniti v bloku komentarjev."
2878
2879 #. (itstool) path: sect2/para
2880 #: C/index.docbook:1688
2881 #, fuzzy
2882 msgid ""
2883 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2884 "is usually a good idea to add a comment block for a class, if it has "
2885 "vmethods (as this is how they can be documented). For the GObject itself one "
2886 "can use the related section docs, having a separate block for the instance "
2887 "struct would be useful if the instance has public fields. One disadvantage "
2888 "here is that this creates two index entries of the same name (the structure "
2889 "and the section)."
2890 msgstr ""
2891 "Bloke komentarjev Struct lahko uporabite tudi za GObjects in GObjectClasses. "
2892 "Običajno je dobro dodati blok komentarjev za razred, če ima vmetode (saj jih "
2893 "je tako mogoče dokumentirati). Za sam GObject lahko uporabimo povezane "
2894 "dokumente razdelkov, če bi bil ločen blok za strukturo primerka koristen, če "
2895 "ima primerek javna polja. Ena pomanjkljivost je, da to ustvari dva vnosa "
2896 "indeksa z istim imenom (strukturo in oddelek)."
2897
2898 #. (itstool) path: sect2/title
2899 #. (itstool) path: example/title
2900 #: C/index.docbook:1700 C/index.docbook:1701
2901 #, fuzzy
2902 msgid "Enum comment block"
2903 msgstr "Blok komentarjev Enum"
2904
2905 #. (itstool) path: example/programlisting
2906 #: C/index.docbook:1702
2907 #, fuzzy, no-wrap
2908 msgid ""
2909 "\n"
2910 "/**\n"
2911 " * Something:\n"
2912 " * @SOMETHING_FOO: something foo\n"
2913 " * @SOMETHING_BAR: something bar\n"
2914 " *\n"
2915 " * Enum values used for the thing, to specify the thing.\n"
2916 " */\n"
2917 "typedef enum {\n"
2918 " SOMETHING_FOO,\n"
2919 " SOMETHING_BAR,\n"
2920 " /*&lt; private &gt;*/\n"
2921 " SOMETHING_COUNT\n"
2922 "} Something;\n"
2923 msgstr ""
2924 "\n"
2925 "/**\n"
2926 " *Nekaj:\n"
2927 " * @SOMETHING_FOO: nekaj foo\n"
2928 " * @SOMETHING_BAR: nekaj vrstice\n"
2929 " *\n"
2930 " * Enum vrednosti, uporabljene za stvar, za določitev stvari.\n"
2931 " */\n"
2932 "typedef enum {\n"
2933 " SOMETHING_FOO,\n"
2934 " SOMETHING_BAR,\n"
2935 " /*&lt; zasebni &gt;*/\n"
2936 " SOMETHING_COUNT\n"
2937 "} Nekaj;\n"
2938
2939 #. (itstool) path: sect2/para
2940 #: C/index.docbook:1719
2941 #, fuzzy
2942 msgid ""
2943 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2944 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2945 "behaviour."
2946 msgstr ""
2947 "Uporabite <code>/*&lt; private &gt;*/</code> pred zasebnimi vrednostmi "
2948 "enuma, ki jih želite skriti. Uporaba <code>/*&lt; public &gt;*/</code> za "
2949 "obratno vedenje."
2950
2951 #. (itstool) path: sect1/title
2952 #: C/index.docbook:1730
2953 #, fuzzy
2954 msgid "Inline program documentation"
2955 msgstr "Dokumentacija programa v vrstici"
2956
2957 #. (itstool) path: sect1/para
2958 #: C/index.docbook:1731
2959 #, fuzzy
2960 msgid ""
2961 "You can document programs and their commandline interface using inline "
2962 "documentation."
2963 msgstr ""
2964 "Programe in njihov vmesnik ukazne vrstice lahko dokumentirate z "
2965 "dokumentacijo v vrstici."
2966
2967 #. (itstool) path: variablelist/title
2968 #: C/index.docbook:1737
2969 msgid "Tags"
2970 msgstr "Oznake"
2971
2972 #. (itstool) path: varlistentry/term
2973 #: C/index.docbook:1739
2974 #, fuzzy
2975 msgid "PROGRAM"
2976 msgstr "_Program:"
2977
2978 #. (itstool) path: listitem/para
2979 #: C/index.docbook:1742
2980 #, fuzzy
2981 msgid "Defines the start of a program documentation."
2982 msgstr "Določa začetek programske dokumentacije."
2983
2984 #. (itstool) path: varlistentry/term
2985 #: C/index.docbook:1749
2986 #, fuzzy
2987 msgid "@short_description:"
2988 msgstr "Kratek opis"
2989
2990 #. (itstool) path: listitem/para
2991 #: C/index.docbook:1751
2992 #, fuzzy
2993 msgid "Defines a short description of the program. (Optional)"
2994 msgstr "Določa kratek opis programa. (Neobvezno)"
2995
2996 #. (itstool) path: varlistentry/term
2997 #: C/index.docbook:1758
2998 #, fuzzy
2999 msgid "@synopsis:"
3000 msgstr "@synopsis:"
3001
3002 #. (itstool) path: listitem/para
3003 #: C/index.docbook:1760
3004 #, fuzzy
3005 msgid ""
3006 "Defines the arguments, or list of arguments that the program can take. "
3007 "(Optional)"
3008 msgstr ""
3009 "Določa argumente ali seznam argumentov, ki jih program lahko sprejme. "
3010 "(Neobvezno)"
3011
3012 #. (itstool) path: varlistentry/term
3013 #: C/index.docbook:1768
3014 #, fuzzy
3015 msgid "@see_also:"
3016 msgstr "Poglejte tudi:"
3017
3018 #. (itstool) path: listitem/para
3019 #: C/index.docbook:1770
3020 #, fuzzy
3021 msgid "See Also manual page section. (Optional)"
3022 msgstr "Glejte tudi razdelek Ročna stran. (Neobvezno)"
3023
3024 #. (itstool) path: varlistentry/term
3025 #: C/index.docbook:1777
3026 msgid "@arg:"
3027 msgstr "@arg:"
3028
3029 #. (itstool) path: listitem/para
3030 #: C/index.docbook:1779
3031 #, fuzzy
3032 msgid "Argument(s) passed to the program and their description. (Optional)"
3033 msgstr ""
3034 "Argument(-i), posredovan(-i) programu(-om), in njihov opis. (Neobvezno)"
3035
3036 #. (itstool) path: varlistentry/term
3037 #: C/index.docbook:1786
3038 msgid "Description:"
3039 msgstr "Opis:"
3040
3041 #. (itstool) path: listitem/para
3042 #: C/index.docbook:1788
3043 #, fuzzy
3044 msgid "A longer description of the program."
3045 msgstr "Daljši opis programa."
3046
3047 #. (itstool) path: listitem/para
3048 #: C/index.docbook:1797
3049 #, fuzzy
3050 msgid "Specify what value(s) the program returns. (Optional)"
3051 msgstr "Določite, katere vrednosti vrne program. (Neobvezno)"
3052
3053 #. (itstool) path: sect2/title
3054 #: C/index.docbook:1806
3055 #, fuzzy
3056 msgid "Example of program documentation."
3057 msgstr "Primer programske dokumentacije."
3058
3059 #. (itstool) path: example/title
3060 #: C/index.docbook:1807
3061 #, fuzzy
3062 msgid "Program documentation block"
3063 msgstr "Blok dokumentacije programa"
3064
3065 #. (itstool) path: example/programlisting
3066 #: C/index.docbook:1808
3067 #, fuzzy, no-wrap
3068 msgid ""
3069 "\n"
3070 "/**\n"
3071 " * PROGRAM:test-program\n"
3072 " * @short_description: A test program\n"
3073 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
3074 " * @see_also: test(1)\n"
3075 " * @--arg1 *arg*: set arg1 to *arg*\n"
3076 " * @--arg2 *arg*: set arg2 to *arg*\n"
3077 " * @-v, --version: Print the version number\n"
3078 " * @-h, --help: Print the help message\n"
3079 " *\n"
3080 " * Long description of program.\n"
3081 " *\n"
3082 " * Returns: Zero on success, non-zero on failure\n"
3083 " */\n"
3084 "int main(int argc, char *argv[])\n"
3085 "{\n"
3086 "\treturn 0;\n"
3087 "}\n"
3088 msgstr ""
3089 "\n"
3090 "/**\n"
3091 " * PROGRAM: testni program\n"
3092 " * @short_description: Testni program\n"
3093 " * @synopsis: testni program [*MOŽNOSTI*...] --arg1 *arg* *DATOTEKA*\n"
3094 " * @see_also: test(1)\n"
3095 " * @--arg1 *arg*: nastavite arg1 na *arg*\n"
3096 " * @--arg2 *arg*: nastavite arg2 na *arg*\n"
3097 " * @-v, --version: Natisnite številko različice\n"
3098 " * @-h, --pomoč: Natisnite sporočilo pomoči\n"
3099 " *\n"
3100 " * Dolg opis programa.\n"
3101 " *\n"
3102 " * Donos: nič pri uspehu, nič pri neuspehu\n"
3103 " */\n"
3104 "Int Main(Int ArgC, Char * ArgV[])\n"
3105 "{\n"
3106 "\tvrnitev 0;\n"
3107 "}\n"
3108
3109 #. (itstool) path: sect1/title
3110 #: C/index.docbook:1834
3111 #, fuzzy
3112 msgid "Useful DocBook tags"
3113 msgstr "Uporabne oznake DocBook"
3114
3115 #. (itstool) path: sect1/para
3116 #: C/index.docbook:1836
3117 #, fuzzy
3118 msgid ""
3119 "Here are some DocBook tags which are most useful when documenting the code."
3120 msgstr ""
3121 "Tukaj je nekaj oznak DocBook, ki so najbolj uporabne pri dokumentiranju kode."
3122
3123 #. (itstool) path: informalexample/programlisting
3124 #: C/index.docbook:1845
3125 #, fuzzy, no-wrap
3126 msgid ""
3127 "\n"
3128 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
3129 msgstr ""
3130 "\n"
3131 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
3132
3133 #. (itstool) path: sect1/para
3134 #: C/index.docbook:1841
3135 #, fuzzy
3136 msgid ""
3137 "To link to another section in the GTK docs: <_:informalexample-1/> The "
3138 "linkend is the SGML/XML id on the top item of the page you want to link to. "
3139 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
3140 "then the page title (\"Hash Tables\"). For widgets it is just the class "
3141 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
3142 msgstr ""
3143 "Če se želite povezati z drugim razdelkom v dokumentih GTK: <_:"
3144 "informalexample-1/> Povezava je ID SGML/XML na zgornjem elementu strani, do "
3145 "katere želite vzpostaviti povezavo. Za večino strani je to trenutno del "
3146 "(\"gtk\", \"gdk\", \"glib\") in nato naslov strani (\"Hash tabele\"). Za "
3147 "pripomočke je to samo ime razreda. Presledki in podčrtaji se pretvorijo v "
3148 "»-«, da ustrezajo SGML/XML."
3149
3150 #. (itstool) path: informalexample/programlisting
3151 #: C/index.docbook:1858
3152 #, fuzzy, no-wrap
3153 msgid ""
3154 "\n"
3155 "&lt;function&gt;...&lt;/function&gt;\n"
3156 msgstr ""
3157 "\n"
3158 "&lt;funkcija&gt;... &lt;/funkcija&gt;\n"
3159
3160 #. (itstool) path: sect1/para
3161 #: C/index.docbook:1855
3162 #, fuzzy
3163 msgid ""
3164 "To refer to an external function, e.g. a standard C function: <_:"
3165 "informalexample-1/>"
3166 msgstr ""
3167 "Če se želite sklicevati na zunanjo funkcijo, npr. standardno funkcijo C: <_:"
3168 "informalexample-1/>"
3169
3170 #. (itstool) path: informalexample/programlisting
3171 #: C/index.docbook:1867
3172 #, fuzzy, no-wrap
3173 msgid ""
3174 "\n"
3175 "&lt;example&gt;\n"
3176 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3177 " &lt;programlisting language=\"C\"&gt;\n"
3178 " ...\n"
3179 " &lt;/programlisting&gt;\n"
3180 "&lt;/example&gt;\n"
3181 msgstr ""
3182 "\n"
3183 "&lt;primer&gt;\n"
3184 " &lt;naslov&gt;Uporaba tabele GHashTable.&lt;/naslov&gt;\n"
3185 " &lt;programsseznamski jezik=\"C\"&gt;\n"
3186 " ...\n"
3187 " &lt;/programiranje&gt;\n"
3188 "&lt;/primer&gt;\n"
3189
3190 #. (itstool) path: informalexample/programlisting
3191 #: C/index.docbook:1878
3192 #, fuzzy, no-wrap
3193 msgid ""
3194 "\n"
3195 "&lt;informalexample&gt;\n"
3196 " &lt;programlisting language=\"C\"&gt;\n"
3197 " ...\n"
3198 " &lt;/programlisting&gt;\n"
3199 "&lt;/informalexample&gt;\n"
3200 msgstr ""
3201 "\n"
3202 "&lt;neformalno&gt;\n"
3203 " &lt;programsseznamski jezik=\"C\"&gt;\n"
3204 " ...\n"
3205 " &lt;/programiranje&gt;\n"
3206 "&lt;/neformalni primer&gt;\n"
3207
3208 #. (itstool) path: informalexample/programlisting
3209 #: C/index.docbook:1890
3210 #, fuzzy, no-wrap
3211 msgid ""
3212 "\n"
3213 "|[&lt;!-- language=\"C\" --&gt;\n"
3214 " ...\n"
3215 "]|\n"
3216 msgstr ""
3217 "\n"
3218 "|[&lt;!-- language=\"C\" --&gt;\n"
3219 " ...\n"
3220 "]|\n"
3221
3222 #. (itstool) path: sect1/para
3223 #: C/index.docbook:1864
3224 #, fuzzy
3225 msgid ""
3226 "To include example code: <_:informalexample-1/> or possibly this, for very "
3227 "short code fragments which don't need a title: <_:informalexample-2/> In "
3228 "both cases, the language attribute is optional and is used as a hint to the "
3229 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3230 "Doc also supports an abbreviation: <_:informalexample-3/>"
3231 msgstr ""
3232 "Če želite vključiti vzorčno kodo: <_:informalexample-1/> ali morda to, za "
3233 "zelo kratke fragmente kode, ki ne potrebujejo naslova: <_:informalexample-2/"
3234 "> V obeh primerih je atribut jezika izbiren in se uporablja kot namig na "
3235 "mehanizem za označevanje sintakse (pygments za izhod html). Za slednje GTK-"
3236 "Doc podpira tudi okrajšavo: <_:informalexample-3/>"
3237
3238 #. (itstool) path: informalexample/programlisting
3239 #: C/index.docbook:1901
3240 #, fuzzy, no-wrap
3241 msgid ""
3242 "\n"
3243 "&lt;itemizedlist&gt;\n"
3244 " &lt;listitem&gt;\n"
3245 " &lt;para&gt;\n"
3246 " ...\n"
3247 " &lt;/para&gt;\n"
3248 " &lt;/listitem&gt;\n"
3249 " &lt;listitem&gt;\n"
3250 " &lt;para&gt;\n"
3251 " ...\n"
3252 " &lt;/para&gt;\n"
3253 " &lt;/listitem&gt;\n"
3254 "&lt;/itemizedlist&gt;\n"
3255 msgstr ""
3256 "\n"
3257 "&lt;razčlenjeni seznam&gt;\n"
3258 " &lt;listitem&gt;\n"
3259 " &lt;odst&gt;\n"
3260 " ...\n"
3261 " &lt;/odst&gt;\n"
3262 " &lt;/listitem&gt;\n"
3263 " &lt;listitem&gt;\n"
3264 " &lt;odst&gt;\n"
3265 " ...\n"
3266 " &lt;/odst&gt;\n"
3267 " &lt;/listitem&gt;\n"
3268 "&lt;/razčlenjeni seznam&gt;\n"
3269
3270 #. (itstool) path: sect1/para
3271 #: C/index.docbook:1898
3272 #, fuzzy
3273 msgid "To include bulleted lists: <_:informalexample-1/>"
3274 msgstr "Če želite vključiti označene sezname: <_:informalexample-1/>"
3275
3276 #. (itstool) path: informalexample/programlisting
3277 #: C/index.docbook:1921
3278 #, fuzzy, no-wrap
3279 msgid ""
3280 "\n"
3281 "&lt;note&gt;\n"
3282 " &lt;para&gt;\n"
3283 " Make sure you free the data after use.\n"
3284 " &lt;/para&gt;\n"
3285 "&lt;/note&gt;\n"
3286 msgstr ""
3287 "\n"
3288 "&lt;Opomba&gt;\n"
3289 " &lt;odst&gt;\n"
3290 " Po uporabi poskrbite, da boste podatke sprostili.\n"
3291 " &lt;/odst&gt;\n"
3292 "&lt;/opomba&gt;\n"
3293
3294 #. (itstool) path: sect1/para
3295 #: C/index.docbook:1918
3296 #, fuzzy
3297 msgid ""
3298 "To include a note which stands out from the text: <_:informalexample-1/>"
3299 msgstr ""
3300 "Če želite vključiti opombo, ki izstopa iz besedila: <_:informalexample-1/>"
3301
3302 #. (itstool) path: informalexample/programlisting
3303 #: C/index.docbook:1934
3304 #, fuzzy, no-wrap
3305 msgid ""
3306 "\n"
3307 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3308 msgstr ""
3309 "\n"
3310 "&lt;vrsta&gt;nepodpisani char&lt;/type&gt;\n"
3311
3312 #. (itstool) path: sect1/para
3313 #: C/index.docbook:1931
3314 #, fuzzy
3315 msgid "To refer to a type: <_:informalexample-1/>"
3316 msgstr "Če se želite sklicevati na vrsto: <_:informalexample-1/>"
3317
3318 #. (itstool) path: informalexample/programlisting
3319 #: C/index.docbook:1943
3320 #, fuzzy, no-wrap
3321 msgid ""
3322 "\n"
3323 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3324 msgstr ""
3325 "\n"
3326 "&lt;ime strukture&gt;XFontStruct&lt;/structname&gt;\n"
3327
3328 #. (itstool) path: sect1/para
3329 #: C/index.docbook:1940
3330 #, fuzzy
3331 msgid ""
3332 "To refer to an external structure (not one described in the GTK docs): <_:"
3333 "informalexample-1/>"
3334 msgstr ""
3335 "Če se želite sklicevati na zunanjo strukturo (ki ni opisana v dokumentih "
3336 "GTK): <_:neformalni primer-1/>"
3337
3338 #. (itstool) path: informalexample/programlisting
3339 #: C/index.docbook:1952
3340 #, fuzzy, no-wrap
3341 msgid ""
3342 "\n"
3343 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3344 msgstr ""
3345 "\n"
3346 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3347
3348 #. (itstool) path: sect1/para
3349 #: C/index.docbook:1949
3350 #, fuzzy
3351 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3352 msgstr "Če se želite sklicevati na polje strukture: <_:neformalni primer-1/>"
3353
3354 #. (itstool) path: informalexample/programlisting
3355 #: C/index.docbook:1961
3356 #, fuzzy, no-wrap
3357 msgid ""
3358 "\n"
3359 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3360 msgstr ""
3361 "\n"
3362 "&lt;priimek&gt;GtkWidget&lt;/priimek&gt;\n"
3363
3364 #. (itstool) path: sect1/para
3365 #: C/index.docbook:1958
3366 #, fuzzy
3367 msgid ""
3368 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3369 "you'll probably be using #GtkWidget instead (to automatically create a link "
3370 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3371 "abbreviations</link>)."
3372 msgstr ""
3373 "Za sklicevanje na ime razreda bi morda lahko uporabili: <_:informalexample-1/"
3374 "> vendar boste verjetno uporabili #GtkWidget namesto tega (za samodejno "
3375 "ustvarjanje povezave do strani GtkWidget - glej <link linkend="
3376 "\"documenting_syntax\">okrajšave)."
3377
3378 #. (itstool) path: informalexample/programlisting
3379 #: C/index.docbook:1972
3380 #, fuzzy, no-wrap
3381 msgid ""
3382 "\n"
3383 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3384 msgstr ""
3385 "\n"
3386 "&lt;poudarek&gt;To je pomembno&lt;/poudarek&gt;\n"
3387
3388 #. (itstool) path: sect1/para
3389 #: C/index.docbook:1969
3390 #, fuzzy
3391 msgid "To emphasize text: <_:informalexample-1/>"
3392 msgstr "Če želite poudariti besedilo: <_:informalexample-1/>"
3393
3394 #. (itstool) path: informalexample/programlisting
3395 #: C/index.docbook:1981
3396 #, fuzzy, no-wrap
3397 msgid ""
3398 "\n"
3399 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3400 msgstr ""
3401 "\n"
3402 "&lt;ime datoteke&gt;/home/uporabnik/dokumenti&lt;/ime datoteke&gt;\n"
3403
3404 #. (itstool) path: sect1/para
3405 #: C/index.docbook:1978
3406 #, fuzzy
3407 msgid "For filenames use: <_:informalexample-1/>"
3408 msgstr "Za uporabo imen datotek: <_:informalexample-1/>"
3409
3410 #. (itstool) path: informalexample/programlisting
3411 #: C/index.docbook:1990
3412 #, fuzzy, no-wrap
3413 msgid ""
3414 "\n"
3415 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3416 msgstr ""
3417 "\n"
3418 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3419
3420 #. (itstool) path: sect1/para
3421 #: C/index.docbook:1987
3422 #, fuzzy
3423 msgid "To refer to keys use: <_:informalexample-1/>"
3424 msgstr "Če se želite sklicevati na uporabo ključev: <_:informalexample-1/>"
3425
3426 #. (itstool) path: chapter/title
3427 #: C/index.docbook:2000
3428 #, fuzzy
3429 msgid "Filling the extra files"
3430 msgstr "Polnjenje dodatnih datotek"
3431
3432 #. (itstool) path: chapter/para
3433 #: C/index.docbook:2002
3434 #, fuzzy
3435 msgid ""
3436 "There are a couple of extra files, that need to be maintained along with the "
3437 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3438 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3439 "<filename>&lt;package&gt;-sections.txt</filename>."
3440 msgstr ""
3441 "Obstaja nekaj dodatnih datotek, ki jih je treba vzdrževati skupaj s "
3442 "komentarji izvorne kode v vrstici: <filename>&lt;package&gt;.types</"
3443 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (v preteklosti ."
3444 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
3445
3446 #. (itstool) path: sect1/title
3447 #: C/index.docbook:2011
3448 #, fuzzy
3449 msgid "Editing the types file"
3450 msgstr "Urejanje datoteke z vrstami"
3451
3452 #. (itstool) path: sect1/para
3453 #: C/index.docbook:2013
3454 #, fuzzy
3455 msgid ""
3456 "If your library or application includes GObjects, you want their signals, "
3457 "arguments/parameters and position in the hierarchy to be shown in the "
3458 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3459 "function> functions together with their include inside the <filename>&lt;"
3460 "package&gt;.types</filename> file."
3461 msgstr ""
3462 "Če vaša knjižnica ali aplikacija vključuje GObjects, želite, da so njihovi "
3463 "signali, argumenti/parametri in položaj v hierarhiji prikazani v "
3464 "dokumentaciji. Vse kar morate storiti je, da navedete "
3465 "<function>xxx_get_type</function> funkcije skupaj z njihovo vključitvijo v "
3466 "datoteko <filename>&lt;package&gt;.types</filename> ."
3467
3468 #. (itstool) path: example/title
3469 #: C/index.docbook:2022
3470 #, fuzzy
3471 msgid "Example &lt;package&gt;.types file"
3472 msgstr "Primer datoteke &lt;package&gt;.types"
3473
3474 #. (itstool) path: example/programlisting
3475 #: C/index.docbook:2023
3476 #, fuzzy, no-wrap
3477 msgid ""
3478 "\n"
3479 "#include &lt;gtk/gtk.h&gt;\n"
3480 "\n"
3481 "gtk_accel_label_get_type\n"
3482 "gtk_adjustment_get_type\n"
3483 "gtk_alignment_get_type\n"
3484 "gtk_arrow_get_type\n"
3485 msgstr ""
3486 "\n"
3487 "#include &lt;gtk/gtk.h&gt;\n"
3488 "\n"
3489 "gtk_accel_label_get_type\n"
3490 "gtk_adjustment_get_type\n"
3491 "gtk_alignment_get_type\n"
3492 "gtk_arrow_get_type\n"
3493
3494 #. (itstool) path: sect1/para
3495 #: C/index.docbook:2034
3496 #, fuzzy
3497 msgid ""
3498 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3499 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3500 "<filename>Makefile.am</filename>. If you use this approach you should not "
3501 "dist the types file nor have it under version control."
3502 msgstr ""
3503 "Ker lahko GTK-Doc 1.8 <application>gtkdoc-scan</application> ustvari ta "
3504 "seznam za vas. Samo dodajte \"--rebuild-types\", da <filename>SCAN_OPTIONS v "
3505 "Makefile.am</filename>. Če uporabite ta pristop, ne smete distirati datotek "
3506 "vrst niti jih imeti pod nadzorom različice."
3507
3508 #. (itstool) path: sect1/title
3509 #: C/index.docbook:2043
3510 #, fuzzy
3511 msgid "Editing the master document"
3512 msgstr "Urejanje glavnega dokumenta"
3513
3514 #. (itstool) path: sect1/para
3515 #: C/index.docbook:2045
3516 #, fuzzy
3517 msgid ""
3518 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3519 "inline source comments, the GTK-Doc tools generate one documentation page "
3520 "per class or module as a separate file. The master document includes them "
3521 "and place them in an order."
3522 msgstr ""
3523 "GTK-Doc izdeluje dokumentacijo v DocBook SGML/XML. Pri obdelavi izvornih "
3524 "komentarjev v vrstici orodja GTK-Doc ustvarijo eno stran dokumentacije na "
3525 "razred ali modul kot ločeno datoteko. Glavni dokument jih vključuje in jih "
3526 "odda v naročilo."
3527
3528 #. (itstool) path: sect1/para
3529 #: C/index.docbook:2052
3530 #, fuzzy
3531 msgid ""
3532 "While GTK-Doc creates a template master document for you, later runs will "
3533 "not touch it again. This means that one can freely structure the "
3534 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3535 "has now a test suite, where also the master-document is recreated from "
3536 "scratch. Its a good idea to look at this from time to time to see if there "
3537 "are some new goodies introduced there."
3538 msgstr ""
3539 "Medtem ko GTK-Doc za vas ustvari glavni dokument predloge, se ga poznejši "
3540 "zagoni ne bodo več dotaknili. To pomeni, da lahko dokumentacijo prosto "
3541 "strukturiramo. To vključuje združevanje strani in dodajanje dodatnih strani. "
3542 "GTK-Doc ima zdaj testni paket, kjer je tudi glavni dokument ponovno "
3543 "ustvarjen iz nič. Dobro je, da to občasno pogledamo, da vidimo, ali je tam "
3544 "uvedenih nekaj novih dobrot."
3545
3546 #. (itstool) path: tip/para
3547 #: C/index.docbook:2062
3548 #, fuzzy
3549 msgid ""
3550 "Do not create tutorials as extra documents. Just write extra chapters. The "
3551 "benefit of directly embedding the tutorial for your library into the API "
3552 "documentation is that it is easy to link for the tutorial to symbol "
3553 "documentation. Apart chances are higher that the tutorial gets updates along "
3554 "with the library."
3555 msgstr ""
3556 "Vadnic ne ustvarjajte kot dodatne dokumente. Samo napišite dodatna poglavja. "
3557 "Prednost neposredne vdelave vadnice za vašo knjižnico v dokumentacijo API "
3558 "je, da je vadnico enostavno povezati z dokumentacijo simbolov. Poleg tega so "
3559 "večje možnosti, da vadnica dobi posodobitve skupaj s knjižnico."
3560
3561 #. (itstool) path: sect1/para
3562 #: C/index.docbook:2071
3563 #, fuzzy
3564 msgid ""
3565 "So what are the things to change inside the master document? For a start is "
3566 "only a little. There are some placeholders (text in square brackets) there "
3567 "which you should take care of."
3568 msgstr ""
3569 "Kaj je torej treba spremeniti v glavnem dokumentu? Za začetek je le malo. "
3570 "Obstaja nekaj označb mesta (besedilo v oglatih oklepajih), za katere morate "
3571 "poskrbeti."
3572
3573 #. (itstool) path: example/title
3574 #: C/index.docbook:2078
3575 #, fuzzy
3576 msgid "Master document header"
3577 msgstr "Glava glavnega dokumenta"
3578
3579 #. (itstool) path: example/programlisting
3580 #: C/index.docbook:2079
3581 #, fuzzy, no-wrap
3582 msgid ""
3583 "\n"
3584 "&lt;bookinfo&gt;\n"
3585 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3586 " &lt;releaseinfo&gt;\n"
3587 " for MODULENAME [VERSION]\n"
3588 " The latest version of this documentation can be found on-line at\n"
3589 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3590 " &lt;/releaseinfo&gt;\n"
3591 "&lt;/bookinfo&gt;\n"
3592 "\n"
3593 "&lt;chapter&gt;\n"
3594 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3595 msgstr ""
3596 "\n"
3597 "&lt;Bookinfo&gt;\n"
3598 " &lt;naslov&gt;MODULENAME Referenčni priročnik&lt;/naslov&gt;\n"
3599 " &lt;Releaseinfo&gt;\n"
3600 " za IME MODULA [RAZLIČICA]\n"
3601 " Najnovejšo različico te dokumentacije lahko najdete na spletni strani\n"
3602 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3603 " &lt;/releaseinfo&gt;\n"
3604 "&lt;/bookinfo&gt;\n"
3605 "\n"
3606 "&lt;poglavje&gt;\n"
3607 " &lt;naslov&gt;[Vstavite naslov tukaj]&lt;/naslov&gt;\n"
3608
3609 #. (itstool) path: sect1/para
3610 #: C/index.docbook:2095
3611 #, fuzzy
3612 msgid ""
3613 "In addition a few option elements are created in commented form. You can "
3614 "review these and enable them as you like."
3615 msgstr ""
3616 "Poleg tega je v komentirani obliki ustvarjenih nekaj elementov možnosti. Te "
3617 "lahko pregledate in omogočite, kot želite."
3618
3619 #. (itstool) path: example/title
3620 #: C/index.docbook:2101
3621 #, fuzzy
3622 msgid "Optional part in the master document"
3623 msgstr "Izbirni del glavnega dokumenta"
3624
3625 #. (itstool) path: example/programlisting
3626 #: C/index.docbook:2102
3627 #, fuzzy, no-wrap
3628 msgid ""
3629 "\n"
3630 " &lt;!-- enable this when you use gobject introspection annotations\n"
3631 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3632 " --&gt;\n"
3633 msgstr ""
3634 "\n"
3635 "&lt;!-- to omogočite, ko uporabljate opombe introspekcije Gobject\n"
3636 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3637 " --&gt;\n"
3638
3639 #. (itstool) path: sect1/para
3640 #: C/index.docbook:2110
3641 #, fuzzy
3642 msgid ""
3643 "Finally you need to add new section whenever you introduce one. The <link "
3644 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3645 "you of newly generated xml files that are not yet included into the doc."
3646 msgstr ""
3647 "Na koncu morate dodati nov razdelek, kadar koli ga predstavite. Orodje <link "
3648 "linkend=\"modernizing-gtk-doc-1-16\">za preverjanje gtkdoc vas bo spomnilo "
3649 "na novo ustvarjene datoteke xml, ki še niso vključene v dokument."
3650
3651 #. (itstool) path: example/title
3652 #: C/index.docbook:2118 C/index.docbook:2153
3653 #, fuzzy
3654 msgid "Including generated sections"
3655 msgstr "Vključno z ustvarjenimi odseki"
3656
3657 #. (itstool) path: example/programlisting
3658 #: C/index.docbook:2119
3659 #, fuzzy, no-wrap
3660 msgid ""
3661 "\n"
3662 " &lt;chapter&gt;\n"
3663 " &lt;title&gt;my library&lt;/title&gt;\n"
3664 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3665 " ...\n"
3666 msgstr ""
3667 "\n"
3668 "&lt;poglavje&gt;\n"
3669 " &lt;naslov&gt;Moja knjižnica&lt;/naslov&gt;\n"
3670 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3671 " ...\n"
3672
3673 #. (itstool) path: sect1/title
3674 #: C/index.docbook:2131
3675 #, fuzzy
3676 msgid "Editing the section file"
3677 msgstr "Urejanje datoteke odseka"
3678
3679 #. (itstool) path: sect1/para
3680 #: C/index.docbook:2133
3681 #, fuzzy
3682 msgid ""
3683 "The section file is used to organise the documentation output by GTK-Doc. "
3684 "Here one specifies which symbol belongs to which module or class and control "
3685 "the visibility (public or private)."
3686 msgstr ""
3687 "Datoteka razdelka se uporablja za organizacijo dokumentacije, ki jo pripravi "
3688 "GTK-Doc. Tukaj določimo, kateri simbol pripada kateremu modulu ali razredu "
3689 "in nadzorujemo vidljivost (javno ali zasebno)."
3690
3691 #. (itstool) path: sect1/para
3692 #: C/index.docbook:2139
3693 #, fuzzy
3694 msgid ""
3695 "The section file is a plain text file with tags delimiting sections. Blank "
3696 "lines are ignored and lines starting with a '#' are treated as comment lines."
3697 msgstr ""
3698 "Datoteka odseka je datoteka z navadnim besedilom z oznakami, ki razmejujejo "
3699 "odseke. Prazne vrstice se prezrejo, vrstice, ki se začnejo z '#', pa se "
3700 "obravnavajo kot vrstice s komentarji."
3701
3702 #. (itstool) path: note/para
3703 #: C/index.docbook:2146
3704 #, fuzzy
3705 msgid ""
3706 "While the tags make the file look like xml, it is not. Please do not close "
3707 "tags like &lt;SUBSECTION&gt;."
3708 msgstr ""
3709 "Čeprav oznake omogočajo, da je datoteka videti kot xml, ni. Ne zapirajte "
3710 "oznak, kot je &lt;PODODDELEK&gt;."
3711
3712 #. (itstool) path: example/programlisting
3713 #: C/index.docbook:2154
3714 #, fuzzy, no-wrap
3715 msgid ""
3716 "\n"
3717 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3718 "\n"
3719 "&lt;SECTION&gt;\n"
3720 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3721 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3722 "MeepApp\n"
3723 "&lt;SUBSECTION Standard&gt;\n"
3724 "MEEP_APP\n"
3725 "...\n"
3726 "MeepAppClass\n"
3727 "meep_app_get_type\n"
3728 "&lt;/SECTION&gt;\n"
3729 msgstr ""
3730 "\n"
3731 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3732 "\n"
3733 "&lt;ODDELEK&gt;\n"
3734 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3735 "&lt;NASLOV&gt;MeepApp&lt;/NASLOV&gt;\n"
3736 "MeepApp\n"
3737 "&lt;PODODDELEK Standard&gt;\n"
3738 "MEEP_APP\n"
3739 "...\n"
3740 "MeepAppClass\n"
3741 "meep_app_get_type\n"
3742 "&lt;/ODDELEK&gt;\n"
3743
3744 #. (itstool) path: sect1/para
3745 #: C/index.docbook:2171
3746 #, fuzzy
3747 msgid ""
3748 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3749 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3750 "FILE&gt;' will result in the section declarations being output in the "
3751 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3752 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3753 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3754 "(The name of the HTML file is based on the module name and the section "
3755 "title, or for GObjects it is based on the GObjects class name converted to "
3756 "lower case)."
3757 msgstr ""
3758 "&lt;DATOTEKA&gt; ... Oznaka &lt;/FILE&gt; se uporablja za določanje imena "
3759 "datoteke brez pripone. Če na primer uporabite »&lt;FILE&gt;gnome-config&lt;/"
3760 "FILE&gt;\", se deklaracije razdelkov vnesejo v datoteko predloge "
3761 "<filename>tmpl/gnome-config.sgml</filename>, ki bo pretvorjena v datoteko "
3762 "DocBook XML <filename>xml/gnome-config.sgml</filename> ali datoteko DocBook "
3763 "XML <filename>xml/gnome-config.xml</filename>. (Ime datoteke HTML temelji na "
3764 "imenu modula in naslovu razdelka, za GObjects pa na imenu razreda GObjects, "
3765 "pretvorjenem v male črke)."
3766
3767 #. (itstool) path: sect1/para
3768 #: C/index.docbook:2183
3769 #, fuzzy
3770 msgid ""
3771 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3772 "section. It is only useful before the templates (if used) are initially "
3773 "created, since the title set in the template file overrides this. Also if "
3774 "one uses SECTION comment in the sources, this is obsolete."
3775 msgstr ""
3776 "&lt;NASLOV&gt; ... Oznaka &lt;/TITLE&gt; se uporablja za določanje naslova "
3777 "razdelka. Uporabno je le, preden so predloge (če so uporabljene) prvotno "
3778 "ustvarjene, saj nabor naslovov v datoteki predloge to preglasi. Tudi če v "
3779 "virih uporabimo komentar SECTION, je to zastarelo."
3780
3781 #. (itstool) path: sect1/para
3782 #: C/index.docbook:2190
3783 #, fuzzy
3784 msgid ""
3785 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3786 "Currently it outputs a blank line between subsections in the synopsis "
3787 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3788 "declarations (e.g. the functions like g_object_get_type and macros like "
3789 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3790 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3791 "declarations which will not be output (it is a handy way to avoid warning "
3792 "messages about unused declarations). If your library contains private types "
3793 "which you don't want to appear in the object hierarchy and the list of "
3794 "implemented or required interfaces, add them to a Private subsection. "
3795 "Whether you would place GObject and GObjectClass like structs in public or "
3796 "Standard section depends if they have public entries (variables, vmethods)."
3797 msgstr ""
3798 "Elemente v razdelku lahko združite z oznako &lt;PODODDELEK&gt;. Trenutno "
3799 "izpiše prazno črto med podpododseki v razdelku sinopsis. Standard &lt;"
3800 "PODODDELEK&gt; lahko uporabite tudi za standardne deklaracije GObject (npr. "
3801 "funkcije, kot so g_object_get_type in makri, kot so G_OBJECT(), "
3802 "G_IS_OBJECT() itd.). Trenutno so ti izpuščeni iz dokumentacije. &lt;"
3803 "PODODDELEK Zasebno&gt; lahko uporabite tudi za zasebne izjave, ki ne bodo "
3804 "objavljene (to je priročen način, da se izognete opozorilnim sporočilom o "
3805 "neuporabljenih deklaracijah). Če so v knjižnici zasebne vrste, ki jih ne "
3806 "želite prikazati v hierarhiji predmetov, in seznamu izvedenih ali zahtevanih "
3807 "vmesnikov, jih dodajte v zasebni pododdelek. Ali bi postavili GObject in "
3808 "GObjectClass podobne strukture v javni ali standardni razdelek, je odvisno, "
3809 "ali imajo javne vnose (spremenljivke, vmetode)."
3810
3811 #. (itstool) path: sect1/para
3812 #: C/index.docbook:2209
3813 #, fuzzy
3814 msgid ""
3815 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3816 "#include files which are shown in the synopsis sections. It contains a comma-"
3817 "separate list of #include files, without the angle brackets. If you set it "
3818 "outside of any sections, it acts for all sections until the end of the file. "
3819 "If you set it within a section, it only applies to that section."
3820 msgstr ""
3821 "Uporabite lahko tudi &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; da določite "
3822 "#include datoteke, ki so prikazane v povzetkih. Vsebuje seznam #include "
3823 "datotek, ločen z vejico, brez kotnih oklepajev. Če jo nastavite zunaj "
3824 "katerega koli odseka, deluje za vse odseke do konca datoteke. Če ga "
3825 "nastavite v odseku, velja le za ta razdelek."
3826
3827 #. (itstool) path: chapter/title
3828 #: C/index.docbook:2223
3829 #, fuzzy
3830 msgid "Controlling the result"
3831 msgstr "Nadzor nad rezultatom"
3832
3833 #. (itstool) path: chapter/para
3834 #: C/index.docbook:2225
3835 #, fuzzy
3836 msgid ""
3837 "A GTK-Doc run generates report files inside the documentation directory. The "
3838 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3839 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3840 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3841 "files that can be viewed and postprocessed easily."
3842 msgstr ""
3843 "Zagon GTK-Doc ustvari datoteke poročil v imeniku dokumentacije. Ustvarjene "
3844 "datoteke se imenujejo: <filename>&lt;paket&gt;-undocumented.txt</filename>, "
3845 "<filename>&lt;paket&gt;-undeclared.txt</filename> in <filename>&lt;paket&gt;-"
3846 "unused.txt</filename>. Vse to so navadne besedilne datoteke, ki si jih je "
3847 "mogoče enostavno ogledati in naknadno obdelati."
3848
3849 #. (itstool) path: chapter/para
3850 #: C/index.docbook:2234
3851 #, fuzzy
3852 msgid ""
3853 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3854 "the documentation coverage summary. Below are two sections divided by blank "
3855 "lines. The first section lists undocumented or incomplete symbols. The "
3856 "second section does the same for section docs. Incomplete entries are those, "
3857 "which have documentation, but where e.g. a new parameter has been added."
3858 msgstr ""
3859 "Datoteka <filename>&lt;paketa&gt;-undocumented.txt</filename> se začne s "
3860 "povzetkom pokritosti dokumentacije. Spodaj sta dva razdelka, deljena s "
3861 "praznimi vrsticami. V prvem razdelku so navedeni nedokumentirani ali "
3862 "nepopolni simboli. Drugi razdelek naredi enako za dokumente razdelkov. "
3863 "Nepopolni vnosi so tisti, ki imajo dokumentacijo, vendar je bil npr. dodan "
3864 "nov parameter."
3865
3866 #. (itstool) path: chapter/para
3867 #: C/index.docbook:2243
3868 #, fuzzy
3869 msgid ""
3870 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3871 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3872 "in the sources. Check if they have been removed or if they are misspelled."
3873 msgstr ""
3874 "V datoteki <filename>&lt;paket&gt;-undeclared.txt</filename> so navedeni "
3875 "simboli, ki so navedeni v <filename>paketu &lt;&gt;-sections.txt</filename> "
3876 "vendar jih ni mogoče najti v virih. Preverite, ali so bili odstranjeni ali "
3877 "napačno črkovani."
3878
3879 #. (itstool) path: chapter/para
3880 #: C/index.docbook:2250
3881 #, fuzzy
3882 msgid ""
3883 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3884 "where the GTK-Doc scanner has found documentation, but does not know where "
3885 "to put it. This means that the symbol has not yet been added to the "
3886 "<filename>&lt;package&gt;-sections.txt</filename> file."
3887 msgstr ""
3888 "V datoteki <filename>&lt;paket&gt;-unused.txt</filename> so navedena imena "
3889 "simbolov, kjer je skener GTK-Doc našel dokumentacijo, vendar ne ve, kam bi "
3890 "jo dal. To pomeni, da simbol še ni bil dodan v datoteko <filename>&lt;"
3891 "paket&gt;-sections.txt</filename> ."
3892
3893 #. (itstool) path: tip/para
3894 #: C/index.docbook:2258
3895 #, fuzzy
3896 msgid ""
3897 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
3898 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
3899 "<command>make check</command> run."
3900 msgstr ""
3901 "Omogočanje ali dodajanje <option>TESTI=$(GTKDOC_CHECK) vrstica v Makefile."
3902 "am. Če je nameščen vsaj GTK-Doc 1.9, bo to izvajalo preverjanje razumnosti "
3903 "med<command>Preverite</command> teči."
3904
3905 #. (itstool) path: chapter/para
3906 #: C/index.docbook:2265
3907 #, fuzzy
3908 msgid ""
3909 "One can also look at the files produced by the source code scanner: "
3910 "<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
3911 "package&gt;-decl.txt</filename>. The first one can be compared with the "
3912 "section file if that is manually maintained. The second lists all "
3913 "declarations from the headers. If a symbol is missing one could check if "
3914 "this file contains it."
3915 msgstr ""
3916 "Ogledate si lahko tudi datoteke, ki jih ustvari skener izvorne kode: "
3917 "<filename>&lt;paket&gt;-decl-list.txt</filename> in <filename>&lt;paket&gt;-"
3918 "decl.txt</filename>. Prvo je mogoče primerjati z datoteko odseka, če jo "
3919 "ročno vzdržujete. V drugem so navedene vse deklaracije iz glav. Če simbol "
3920 "manjka, lahko preverite, ali ga ta datoteka vsebuje."
3921
3922 #. (itstool) path: chapter/para
3923 #: C/index.docbook:2274
3924 #, fuzzy
3925 msgid ""
3926 "If the project is GObject based, one can also look into the files produced "
3927 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3928 "<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
3929 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
3930 "prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
3931 "filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
3932 "to keep the intermediate scanner file for further analysis, by running it as "
3933 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3934 msgstr ""
3935 "Če projekt temelji na GObject, si lahko ogledate tudi datoteke, ki jih "
3936 "ustvari skener predmetov: <filename>&lt;paket&gt;.args.txt</filename>, "
3937 "<filename>&lt;paket&gt;.hierarchy.txt</filename>, <filename>&lt;paket&gt;."
3938 "interfaces.txt</filename>, <filename>&lt;paket&gt;.prerequisites.txt</"
3939 "filename> in <filename>&lt;paket&gt;.signals.txt</filename>. Če v katerem od "
3940 "teh simbolov manjkajo, lahko od GTK-Doc zahtevamo, da datoteko vmesnega "
3941 "optičnega bralnika obdrži za nadaljnjo analizo, tako da jo zažene kot "
3942 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 znamka</command>."
3943
3944 #. (itstool) path: chapter/title
3945 #: C/index.docbook:2289
3946 #, fuzzy
3947 msgid "Modernizing the documentation"
3948 msgstr "Posodobitev dokumentacije"
3949
3950 #. (itstool) path: chapter/para
3951 #: C/index.docbook:2291
3952 #, fuzzy
3953 msgid ""
3954 "GTK-Doc has been around for quite some time. In this section we list new "
3955 "features together with the version since when it is available."
3956 msgstr ""
3957 "GTK-Doc obstaja že kar nekaj časa. V tem razdelku navajamo nove funkcije "
3958 "skupaj z različico, odkar je na voljo."
3959
3960 #. (itstool) path: sect1/title
3961 #: C/index.docbook:2297
3962 msgid "GTK-Doc 1.9"
3963 msgstr "GTK-Doc 1.9"
3964
3965 #. (itstool) path: sect1/para
3966 #: C/index.docbook:2299
3967 #, fuzzy
3968 msgid ""
3969 "When using xml instead of sgml, one can actually name the master document "
3970 "<filename>&lt;package&gt;-docs.xml</filename>."
3971 msgstr ""
3972 "Če namesto sgml uporabljate xml, lahko glavni dokument dejansko poimenujete "
3973 "<filename>&lt;paket&gt;-docs.xml</filename>."
3974
3975 #. (itstool) path: sect1/para
3976 #: C/index.docbook:2304
3977 #, fuzzy
3978 msgid ""
3979 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3980 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3981 "package&gt;-sections.txt</filename> is autogenerated and can be removed from "
3982 "the vcs. This only works nicely for projects that have a very regular "
3983 "structure (e.g. each .{c,h} pair will create new section). If one organize a "
3984 "project close to that updating a manually maintained section file can be as "
3985 "simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
3986 "sections.txt</code>."
3987 msgstr ""
3988 "Ta različica podpira <option>SCAN_OPTIONS=--obnovitveni odseki v "
3989 "<filename>Makefile.am</filename>. Ko je to omogočeno, se <filename>&lt;"
3990 "paket&gt;-sections.txt</filename> samodejno generira in ga je mogoče "
3991 "odstraniti iz vc-jev. To lepo deluje le pri projektih, ki imajo zelo "
3992 "pravilno strukturo (npr. vsak .{ C,h} par bo ustvaril nov odsek). Če "
3993 "organizirate projekt, ki je blizu temu, je lahko posodabljanje ročno "
3994 "vzdrževane datoteke odseka tako preprosto kot zagon <code>meld &lt;"
3995 "package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>."
3996
3997 #. (itstool) path: sect1/para
3998 #: C/index.docbook:2315
3999 #, fuzzy
4000 msgid ""
4001 "Version 1.8 already introduced the syntax for documenting sections in the "
4002 "sources instead of the separate files under <filename class=\"directory"
4003 "\">tmpl</filename>. This version adds options to switch the whole doc module "
4004 "to not use the extra tmpl build step at all, by using <option>--flavour no-"
4005 "tmpl</option> in <filename>configure.ac</filename>. If you don't have a "
4006 "<filename class=\"directory\">tmpl</filename> checked into your source "
4007 "control system and haven't yet switched, just add the flag to "
4008 "<filename>configure.ac</filename> and you are done."
4009 msgstr ""
4010 "Različica 1.8 je že uvedla sintakso za dokumentiranje odsekov v virih "
4011 "namesto ločenih datotek v <filename class=\"directory\">tmpl</filename>. Ta "
4012 "različica dodaja možnosti za preklop celotnega modula doc, da sploh ne "
4013 "uporabite dodatnega koraka gradnje tmpl, tako da uporabite <option>--okus "
4014 "brez TMPL v <filename>configure.ac</filename>. Če v izvornem nadzornem "
4015 "sistemu nimate preverjenega <filename class=\"directory\">tmpl</filename> in "
4016 "še niste preklopili, dodajte zastavico <filename>configure.ac</filename> in "
4017 "končali ste."
4018
4019 #. (itstool) path: sect1/title
4020 #: C/index.docbook:2327
4021 msgid "GTK-Doc 1.10"
4022 msgstr "GTK-Doc 1.10"
4023
4024 #. (itstool) path: sect1/para
4025 #: C/index.docbook:2329
4026 #, fuzzy
4027 msgid ""
4028 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
4029 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
4030 "package&gt;.types</filename> is autogenerated and can be removed from the "
4031 "vcs. When using this feature it is important to also setup the "
4032 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
4033 "code that is build conditionally."
4034 msgstr ""
4035 "Ta različica podpira <option>SCAN_OPTIONS=--rebuild-types v "
4036 "<filename>Makefile.am</filename>. Ko je to omogočeno, se <filename>&lt;"
4037 "package&gt;.types</filename> samodejno generira in ga je mogoče odstraniti "
4038 "iz vc-jev. Pri uporabi te funkcije je pomembno, da <varname>IGNORE_HFILES</"
4039 "varname> nastavite tudi v <filename>Makefile.am</filename> za pogojno "
4040 "zgrajeno kodo."
4041
4042 #. (itstool) path: sect1/title
4043 #: C/index.docbook:2340
4044 msgid "GTK-Doc 1.16"
4045 msgstr "GTK-Doc 1.16"
4046
4047 #. (itstool) path: example/title
4048 #: C/index.docbook:2346
4049 #, fuzzy
4050 msgid "Enable gtkdoc-check"
4051 msgstr "Omogočite gtkdoc-check"
4052
4053 #. (itstool) path: example/programlisting
4054 #: C/index.docbook:2347
4055 #, fuzzy, no-wrap
4056 msgid ""
4057 "\n"
4058 "if ENABLE_GTK_DOC\n"
4059 "TESTS_ENVIRONMENT = \\\n"
4060 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
4061 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
4062 "TESTS = $(GTKDOC_CHECK)\n"
4063 "endif\n"
4064 msgstr ""
4065 "\n"
4066 "če ENABLE_GTK_DOC\n"
4067 "TESTS_ENVIRONMENT = \\\n"
4068 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
4069 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
4070 "TESTI = $(GTKDOC_CHECK)\n"
4071 "Endif\n"
4072
4073 #. (itstool) path: sect1/para
4074 #: C/index.docbook:2342
4075 #, fuzzy
4076 msgid ""
4077 "This version includes a new tool called gtkdoc-check. This tool can run a "
4078 "set of sanity checks on your documentation. It is enabled by adding these "
4079 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
4080 msgstr ""
4081 "Ta različica vključuje novo orodje, imenovano gtkdoc-check. To orodje lahko "
4082 "izvede niz preverjanj razumnosti vaše dokumentacije. Omogoči se z dodajanjem "
4083 "teh vrstic na konec <filename>Makefile.am</filename>. <_:example-1/>"
4084
4085 #. (itstool) path: sect1/title
4086 #: C/index.docbook:2360
4087 msgid "GTK-Doc 1.20"
4088 msgstr "GTK-Doc 1.20"
4089
4090 #. (itstool) path: sect1/para
4091 #: C/index.docbook:2362
4092 #, fuzzy
4093 msgid ""
4094 "Version 1.18 brought some initial markdown support. Using markdown in doc "
4095 "comments is less intrusive than writing docbook xml. This version improves a "
4096 "lot on this and add a lot more styles. The section that explains the <link "
4097 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
4098 msgstr ""
4099 "Različica 1.18 je prinesla nekaj začetne podpore za označevanje. Uporaba "
4100 "markdowna v komentarjih doc je manj vsiljiva kot pisanje docbook xml. Ta "
4101 "različica se pri tem zelo izboljša in doda veliko več stilov. V razdelku, v "
4102 "katerem je razložena sintaksa komentarja<link linkend=\"documenting_syntax"
4103 "\">, so vse podrobnosti."
4104
4105 #. (itstool) path: sect1/title
4106 #: C/index.docbook:2372
4107 msgid "GTK-Doc 1.25"
4108 msgstr "GTK-Doc 1.25"
4109
4110 #. (itstool) path: example/title
4111 #: C/index.docbook:2383
4112 #, fuzzy
4113 msgid "Use pre-generated entities"
4114 msgstr "Uporaba vnaprej ustvarjenih entitet"
4115
4116 #. (itstool) path: example/programlisting
4117 #: C/index.docbook:2384
4118 #, fuzzy, no-wrap
4119 msgid ""
4120 "\n"
4121 "&lt;?xml version=\"1.0\"?&gt;\n"
4122 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
4123 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
4124 "[\n"
4125 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
4126 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
4127 " %gtkdocentities;\n"
4128 "]&gt;\n"
4129 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
4130 " &lt;bookinfo&gt;\n"
4131 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
4132 " &lt;releaseinfo&gt;\n"
4133 " for &amp;package_string;.\n"
4134 " The latest version of this documentation can be found on-line at\n"
4135 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
4136 " &lt;/releaseinfo&gt;\n"
4137 " &lt;/bookinfo&gt;\n"
4138 msgstr ""
4139 "\n"
4140 "&lt;?xml version=\"1.0\"?&gt;\n"
4141 "&lt;! DOCTYPE knjiga JAVNO \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
4142 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
4143 "[\n"
4144 " &lt;! ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
4145 " &lt;! ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
4146 " %gTkdocentities;\n"
4147 "]&gt;\n"
4148 "&lt;id knjige = \"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
4149 " &lt;Bookinfo&gt;\n"
4150 " &lt;naslov&gt;&amp;package_name; Referenčni priročnik&lt;/naslov&gt;\n"
4151 " &lt;Releaseinfo&gt;\n"
4152 " za &amp;package_string;.\n"
4153 " Najnovejšo različico te dokumentacije lahko najdete na spletni strani\n"
4154 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
4155 " &lt;/releaseinfo&gt;\n"
4156 " &lt;/bookinfo&gt;\n"
4157
4158 #. (itstool) path: sect1/para
4159 #: C/index.docbook:2374
4160 #, fuzzy
4161 msgid ""
4162 "The makefiles shipped with this version generate an entity file at "
4163 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
4164 "package_name and package_version. You can use this e.g. in the main xml file "
4165 "to avoid hardcoding the version number. Below is an example that shows how "
4166 "the entity file is included in the master template and how the entities are "
4167 "used. The entities can also be used in all generated files, GTK-Doc will use "
4168 "the same xml header in generated xml files. <_:example-1/>"
4169 msgstr ""
4170 "Datoteke makefiles, dobavljene s to različico, ustvarijo datoteko entitete "
4171 "na <filename>spletnem mestu xml/gtkdocentities.ent</filename>, ki vsebuje "
4172 "entitete za npr. package_name in package_version. To lahko uporabite npr. v "
4173 "glavni datoteki xml, da se izognete kodiranju številke različice. Spodaj je "
4174 "primer, ki prikazuje, kako je datoteka entitete vključena v glavno predlogo "
4175 "in kako so entitete uporabljene. Entitete lahko uporabite tudi v vseh "
4176 "ustvarjenih datotekah, GTK-Doc bo uporabil isto glavo xml v ustvarjenih "
4177 "datotekah xml. <_:example-1/>"
4178
4179 #. (itstool) path: chapter/title
4180 #: C/index.docbook:2409
4181 #, fuzzy
4182 msgid "Documenting other interfaces"
4183 msgstr "Dokumentiranje drugih vmesnikov"
4184
4185 #. (itstool) path: chapter/para
4186 #: C/index.docbook:2411
4187 #, fuzzy
4188 msgid ""
4189 "So far we have been using GTK-Doc to document the API of code. The next "
4190 "sections contain suggestions how the tools can be used to document other "
4191 "interfaces too."
4192 msgstr ""
4193 "Doslej smo uporabljali GTK-Doc za dokumentiranje API-ja kode. Naslednji "
4194 "razdelki vsebujejo predloge, kako lahko orodja uporabite tudi za "
4195 "dokumentiranje drugih vmesnikov."
4196
4197 #. (itstool) path: sect1/title
4198 #: C/index.docbook:2418
4199 #, fuzzy
4200 msgid "Command line options and man pages"
4201 msgstr "Možnosti ukazne vrstice in strani človeka"
4202
4203 #. (itstool) path: sect1/para
4204 #: C/index.docbook:2420
4205 #, fuzzy
4206 msgid ""
4207 "As one can generate man pages for a docbook refentry as well, it sounds like "
4208 "a good idea to use it for that purpose. This way the interface is part of "
4209 "the reference and one gets the man-page for free."
4210 msgstr ""
4211 "Ker lahko ustvarite moške strani tudi za refentry dokumenta, se sliši kot "
4212 "dobra ideja, da ga uporabite v ta namen. Na ta način je vmesnik del "
4213 "reference in človek-stran dobite brezplačno."
4214
4215 #. (itstool) path: sect2/title
4216 #: C/index.docbook:2427
4217 msgid "Document the tool"
4218 msgstr "Dokumentirajte orodje"
4219
4220 #. (itstool) path: sect2/para
4221 #: C/index.docbook:2429
4222 #, fuzzy
4223 msgid ""
4224 "Create one refentry file per tool. Following <link linkend="
4225 "\"settingup_docfiles\">our example</link> we would call it <filename>meep/"
4226 "docs/reference/meeper/meep.xml</filename>. For the xml tags that should be "
4227 "used and can look at generated file in the xml subdirectory as well as "
4228 "examples e.g. in glib."
4229 msgstr ""
4230 "Ustvarite eno datoteko ponovnega vnosa na orodje. Po <link linkend="
4231 "\"settingup_docfiles\">našem zgledu bi ga imenovali <filename>meep/docs/"
4232 "reference/meeper/meep.xml</filename>. Za oznake xml, ki jih je treba "
4233 "uporabiti in si lahko ogledate ustvarjeno datoteko v podimeniku xml, pa tudi "
4234 "primere, npr. v glibu."
4235
4236 #. (itstool) path: sect2/title
4237 #: C/index.docbook:2439
4238 #, fuzzy
4239 msgid "Adding the extra configure check"
4240 msgstr "Dodajanje dodatnega preverjanja konfiguracije"
4241
4242 #. (itstool) path: example/title
4243 #: C/index.docbook:2442 C/index.docbook:2460
4244 #, fuzzy
4245 msgid "Extra configure checks"
4246 msgstr "Dodatna konfiguracija preverjanj"
4247
4248 #. (itstool) path: example/programlisting
4249 #: C/index.docbook:2443
4250 #, fuzzy, no-wrap
4251 msgid ""
4252 "\n"
4253 "AC_ARG_ENABLE(man,\n"
4254 " [AC_HELP_STRING([--enable-man],\n"
4255 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4256 " enable_man=no)\n"
4257 "\n"
4258 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4259 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4260 msgstr ""
4261 "\n"
4262 "AC_ARG_ENABLE(človek,\n"
4263 " [AC_HELP_STRING([--omogoči-človek],\n"
4264 " [regeneriranje strani mož iz Docbooka [default=no]])],enable_man=yes,\n"
4265 " enable_man=ne)\n"
4266 "\n"
4267 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4268 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4269
4270 #. (itstool) path: sect2/title
4271 #: C/index.docbook:2457
4272 #, fuzzy
4273 msgid "Adding the extra makefile rules"
4274 msgstr "Dodajanje dodatnih pravil makefile"
4275
4276 #. (itstool) path: example/programlisting
4277 #: C/index.docbook:2461
4278 #, fuzzy, no-wrap
4279 msgid ""
4280 "\n"
4281 "man_MANS = \\\n"
4282 " meeper.1\n"
4283 "\n"
4284 "if ENABLE_GTK_DOC\n"
4285 "if ENABLE_MAN\n"
4286 "\n"
4287 "%.1 : %.xml\n"
4288 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4289 "\n"
4290 "endif\n"
4291 "endif\n"
4292 "\n"
4293 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4294 "EXTRA_DIST += meep.xml\n"
4295 msgstr ""
4296 "\n"
4297 "man_MANS = \\\n"
4298 " Meeper.1\n"
4299 "\n"
4300 "če ENABLE_GTK_DOC\n"
4301 "Če ENABLE_MAN\n"
4302 "\n"
4303 "%.1 : %.xml\n"
4304 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl &lt; $\n"
4305 "\n"
4306 "Endif\n"
4307 "Endif\n"
4308 "\n"
4309 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4310 "EXTRA_DIST += meep.xml\n"
4311
4312 #. (itstool) path: sect1/title
4313 #: C/index.docbook:2483
4314 #, fuzzy
4315 msgid "DBus interfaces"
4316 msgstr "Vmesniki DBus"
4317
4318 #. (itstool) path: sect1/para
4319 #: C/index.docbook:2485
4320 #, fuzzy
4321 msgid ""
4322 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4323 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4324 msgstr ""
4325 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4326 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4327
4328 #. (itstool) path: chapter/title
4329 #: C/index.docbook:2494
4330 #, fuzzy
4331 msgid "Frequently asked questions"
4332 msgstr "_Pogosto zastavljena vprašanja"
4333
4334 #. (itstool) path: segmentedlist/segtitle
4335 #: C/index.docbook:2498
4336 msgid "Question"
4337 msgstr "Vprašanje"
4338
4339 #. (itstool) path: segmentedlist/segtitle
4340 #: C/index.docbook:2499
4341 msgid "Answer"
4342 msgstr "Odgovor"
4343
4344 #. (itstool) path: seglistitem/seg
4345 #: C/index.docbook:2501
4346 #, fuzzy
4347 msgid "No class hierarchy."
4348 msgstr "Brez hierarhije razreda."
4349
4350 #. (itstool) path: seglistitem/seg
4351 #: C/index.docbook:2502
4352 #, fuzzy
4353 msgid ""
4354 "The objects <function>xxx_get_type()</function> function has not been "
4355 "entered into the <filename>&lt;package&gt;.types</filename> file."
4356 msgstr ""
4357 "Funkcija <function>predmetov xxx_get_type()</function> ni bila vnesena v "
4358 "datoteko <filename>&lt;package&gt;.types</filename> ."
4359
4360 #. (itstool) path: seglistitem/seg
4361 #: C/index.docbook:2508
4362 #, fuzzy
4363 msgid "Still no class hierarchy."
4364 msgstr "Še vedno ni razredne hierarhije."
4365
4366 #. (itstool) path: seglistitem/seg
4367 #: C/index.docbook:2509
4368 #, fuzzy
4369 msgid ""
4370 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4371 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4372 "October/msg00006.html\">explanation</ulink>)."
4373 msgstr ""
4374 "Manjkajoče ali napačno poimenovanje v datoteki <filename>&lt;paket&gt;-"
4375 "sections.txt</filename> (glejte <ulink url=\"http://mail.gnome.org/archives/"
4376 "gtk-doc-list/2003-October/msg00006.html\">razlago</ulink>)."
4377
4378 #. (itstool) path: seglistitem/seg
4379 #: C/index.docbook:2515
4380 #, fuzzy
4381 msgid "Damn, I have still no class hierarchy."
4382 msgstr "Prekleto, še vedno nimam razredne hierarhije."
4383
4384 #. (itstool) path: seglistitem/seg
4385 #: C/index.docbook:2516
4386 #, fuzzy
4387 msgid ""
4388 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4389 "type>) part of the normal section (don't put this into Standard or Private "
4390 "subsections)."
4391 msgstr ""
4392 "Ali je ime predmeta (ime zgradbe primerka, npr. <type>GtkWidget</type>) del "
4393 "običajnega odseka (tega ne vstavljajte v standardna ali zasebna podpodročja)."
4394
4395 #. (itstool) path: seglistitem/seg
4396 #: C/index.docbook:2523
4397 #, fuzzy
4398 msgid "No symbol index."
4399 msgstr "Brez indeksa simbolov."
4400
4401 #. (itstool) path: seglistitem/seg
4402 #: C/index.docbook:2524
4403 #, fuzzy
4404 msgid ""
4405 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4406 "index that xi:includes the generated index?"
4407 msgstr ""
4408 "Naredi <filename>&lt;paket&gt;-dokumente.{ XML,SGML}</filename> vsebujejo "
4409 "indeks, ki xi:vključuje ustvarjeni indeks?"
4410
4411 #. (itstool) path: seglistitem/seg
4412 #: C/index.docbook:2530
4413 #, fuzzy
4414 msgid "Symbols are not linked to their doc-section."
4415 msgstr "Simboli niso povezani z njihovim razdelkom dokumentov."
4416
4417 #. (itstool) path: seglistitem/seg
4418 #: C/index.docbook:2531
4419 #, fuzzy
4420 msgid ""
4421 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4422 "gtkdoc-fixxref warns about unresolvable xrefs."
4423 msgstr ""
4424 "Ali doc-komentar uporablja pravilno oznako (dodano #,% or ()))? Preverite, "
4425 "ali gtkdoc-fixxref opozarja na nerešljive xrefs."
4426
4427 #. (itstool) path: seglistitem/seg
4428 #: C/index.docbook:2537
4429 #, fuzzy
4430 msgid "A new class does not appear in the docs."
4431 msgstr "V dokumentih ni prikazan nov razred."
4432
4433 #. (itstool) path: seglistitem/seg
4434 #: C/index.docbook:2538
4435 #, fuzzy
4436 msgid ""
4437 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4438 "filename>."
4439 msgstr ""
4440 "Ali je nova stran xi:vključena iz <filename>&lt;package&gt;-docs.{ xml,sgml}"
4441 "</filename>."
4442
4443 #. (itstool) path: seglistitem/seg
4444 #: C/index.docbook:2544
4445 #, fuzzy
4446 msgid "A new symbol does not appear in the docs."
4447 msgstr "V dokumentih ni prikazan nov simbol."
4448
4449 #. (itstool) path: seglistitem/seg
4450 #: C/index.docbook:2545
4451 #, fuzzy
4452 msgid ""
4453 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4454 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4455 "xrefs. Check if the symbol is correctly listed in the <filename>&lt;"
4456 "package&gt;-sections.txt</filename> in a public subsection."
4457 msgstr ""
4458 "Ali je dokument-komentar pravilno oblikovan? Preverite, ali so na začetku "
4459 "komentarja črkovalne napake. Preverite, ali gtkdoc-fixxref opozarja na "
4460 "nerešljive xrefs. Preverite, ali je simbol pravilno naveden v <filename>&lt;"
4461 "paketu&gt;-sections.txt</filename> v javnem pododdelku."
4462
4463 #. (itstool) path: seglistitem/seg
4464 #: C/index.docbook:2553
4465 #, fuzzy
4466 msgid "A type is missing from the class hierarchy."
4467 msgstr "V hierarhiji razreda manjka vrsta."
4468
4469 #. (itstool) path: seglistitem/seg
4470 #: C/index.docbook:2554
4471 #, fuzzy
4472 msgid ""
4473 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4474 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4475 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4476 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4477 "or incidentally marked private it will not be shown."
4478 msgstr ""
4479 "Če je vrsta navedena v <filename>hierarhiji &lt;package&gt;.hierarchy</"
4480 "filename> , ne pa tudi v <filename>xml/tree_index.sgml</filename> , še "
4481 "enkrat preverite, ali je vrsta pravilno postavljena v <filename>&lt;"
4482 "paket&gt;-sections.txt</filename>. Če primerek vrste (npr. <type>GtkWidget</"
4483 "type>) ni naveden ali slučajno označen kot zaseben, ne bo prikazan."
4484
4485 #. (itstool) path: seglistitem/seg
4486 #: C/index.docbook:2563
4487 #, fuzzy
4488 msgid "I get foldoc links for all gobject annotations."
4489 msgstr "Dobim zložljive povezave za vse opombe gobject."
4490
4491 #. (itstool) path: seglistitem/seg
4492 #: C/index.docbook:2564
4493 #, fuzzy
4494 msgid ""
4495 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4496 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4497 msgstr ""
4498 "Preverite, ali je <filename>xml/annotation-glossary.xml</filename> xi:"
4499 "vključeno iz <filename>&lt;package&gt;-docs.{ xml,sgml}</filename>."
4500
4501 #. (itstool) path: seglistitem/seg
4502 #: C/index.docbook:2572
4503 #, fuzzy
4504 msgid "Parameter described in source code comment block but does not exist"
4505 msgstr "Parameter, opisan v bloku komentarjev izvorne kode, vendar ne obstaja"
4506
4507 #. (itstool) path: seglistitem/seg
4508 #: C/index.docbook:2573
4509 #, fuzzy
4510 msgid ""
4511 "Check if the prototype in the header has different parameter names as in the "
4512 "source."
4513 msgstr ""
4514 "Preverite, ali ima prototip v glavi drugačna imena parametrov kot v viru."
4515
4516 #. (itstool) path: seglistitem/seg
4517 #: C/index.docbook:2578
4518 #, fuzzy
4519 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4520 msgstr "več \"ID-jev\" za omejitev povezave: XYZ"
4521
4522 #. (itstool) path: seglistitem/seg
4523 #: C/index.docbook:2579
4524 #, fuzzy
4525 msgid ""
4526 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4527 "filename> file."
4528 msgstr ""
4529 "Simbol XYZ se v datoteki <filename>&lt;paket&gt;-sections.txt</filename> "
4530 "prikaže dvakrat."
4531
4532 #. (itstool) path: seglistitem/seg
4533 #: C/index.docbook:2582
4534 #, fuzzy
4535 msgid ""
4536 "Element typename in namespace '' encountered in para, but no template "
4537 "matches."
4538 msgstr ""
4539 "Ime vrste elementa v imenskem prostoru '' je naletelo na para, vendar se "
4540 "predloga ne ujema."
4541
4542 #. (itstool) path: chapter/title
4543 #: C/index.docbook:2589
4544 #, fuzzy
4545 msgid "Tools related to gtk-doc"
4546 msgstr "Orodja, povezana z gtk-doc"
4547
4548 #. (itstool) path: chapter/para
4549 #: C/index.docbook:2591
4550 #, fuzzy
4551 msgid ""
4552 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4553 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4554 "integrates with the trac search."
4555 msgstr ""
4556 "GtkDocPlugin - integracijski vtičnik <ulink url=\"http://trac-hacks.org/wiki/"
4557 "GtkDocPlugin\">Trac GTK-Doc</ulink> , ki dodaja dokumente API na spletno "
4558 "mesto trac in se integrira z iskanjem traca."
4559
4560 #. (itstool) path: chapter/para
4561 #: C/index.docbook:2596
4562 #, fuzzy
4563 msgid ""
4564 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4565 "tags in the API to determine the minimum required version."
4566 msgstr ""
4567 "Gtkdoc-depscan - orodje (del gtk-doc) za preverjanje uporabljenega API-ja od "
4568 "oznak v API-ju, da se določi najmanjša zahtevana različica."
4569
4570 #. (itstool) path: appendixinfo/releaseinfo
4571 #: C/fdl-appendix.xml:12
4572 #, fuzzy
4573 msgid "Version 1.1, March 2000"
4574 msgstr "Različica 1.1, marec 2000"
4575
4576 #. (itstool) path: copyright/year
4577 #: C/fdl-appendix.xml:16
4578 msgid "2000"
4579 msgstr "2000"
4580
4581 #. (itstool) path: copyright/holder
4582 #: C/fdl-appendix.xml:16
4583 #, fuzzy
4584 msgid "Free Software Foundation, Inc."
4585 msgstr "Free Software Foundation, Inc."
4586
4587 #. (itstool) path: address/street
4588 #: C/fdl-appendix.xml:20
4589 #, fuzzy
4590 msgid "51 Franklin Street, Suite 330"
4591 msgstr "51 Franklinova ulica, suita 330"
4592
4593 #. (itstool) path: address/city
4594 #: C/fdl-appendix.xml:21
4595 msgid "Boston"
4596 msgstr "Boston"
4597
4598 #. (itstool) path: address/state
4599 #: C/fdl-appendix.xml:21
4600 #, fuzzy
4601 msgid "MA"
4602 msgstr "Dolžina g_lavnih oznak:"
4603
4604 #. (itstool) path: address/postcode
4605 #: C/fdl-appendix.xml:22
4606 #, fuzzy
4607 msgid "02110-1301"
4608 msgstr "02110-1301"
4609
4610 #. (itstool) path: address/country
4611 #: C/fdl-appendix.xml:22
4612 msgid "USA"
4613 msgstr "ZDA"
4614
4615 #. (itstool) path: para/address
4616 #: C/fdl-appendix.xml:20
4617 #, fuzzy
4618 msgid ""
4619 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
4620 "postcode-4/> <_:country-5/>"
4621 msgstr ""
4622 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
4623 "postcode-4/> <_:country-5/>"
4624
4625 #. (itstool) path: legalnotice/para
4626 #: C/fdl-appendix.xml:19
4627 #, fuzzy
4628 msgid ""
4629 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4630 "of this license document, but changing it is not allowed."
4631 msgstr ""
4632 "<_:naslov-1/> Vsakdo lahko kopira in distribuira dobesedne kopije tega "
4633 "licenčnega dokumenta, vendar njegovo spreminjanje ni dovoljeno."
4634
4635 #. (itstool) path: appendix/title
4636 #. (itstool) path: para/quote
4637 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4638 #, fuzzy
4639 msgid "GNU Free Documentation License"
4640 msgstr "Licenca za prosto dokumentacijo GNU"
4641
4642 #. (itstool) path: sect1/title
4643 #: C/fdl-appendix.xml:31
4644 #, fuzzy
4645 msgid "0. PREAMBLE"
4646 msgstr "0. PREAMBULA"
4647
4648 #. (itstool) path: para/quote
4649 #: C/fdl-appendix.xml:34
4650 #, fuzzy
4651 msgid "free"
4652 msgstr "Sprosti"
4653
4654 #. (itstool) path: sect1/para
4655 #: C/fdl-appendix.xml:32
4656 #, fuzzy
4657 msgid ""
4658 "The purpose of this License is to make a manual, textbook, or other written "
4659 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4660 "effective freedom to copy and redistribute it, with or without modifying it, "
4661 "either commercially or noncommercially. Secondarily, this License preserves "
4662 "for the author and publisher a way to get credit for their work, while not "
4663 "being considered responsible for modifications made by others."
4664 msgstr ""
4665 "Namen te licence je izdelava priročnika, učbenika ali drugega pisnega "
4666 "dokumenta <_:quote-1/> v smislu svobode: zagotoviti vsakomur dejansko "
4667 "svobodo kopiranja in nadaljnje distribucije z ali brez spreminjanja, bodisi "
4668 "komercialno bodisi nekomercialno. Drugič, ta licenca ohranja avtorju in "
4669 "založniku način, kako pridobiti zasluge za svoje delo, ne da bi bila "
4670 "odgovorna za spremembe, ki so jih naredili drugi."
4671
4672 #. (itstool) path: para/quote
4673 #: C/fdl-appendix.xml:44
4674 #, fuzzy
4675 msgid "copyleft"
4676 msgstr "copyleft"
4677
4678 #. (itstool) path: sect1/para
4679 #: C/fdl-appendix.xml:43
4680 #, fuzzy
4681 msgid ""
4682 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4683 "the document must themselves be free in the same sense. It complements the "
4684 "GNU General Public License, which is a copyleft license designed for free "
4685 "software."
4686 msgstr ""
4687 "Ta licenca je neke vrste <_:quote-1/>, kar pomeni, da morajo biti izpeljana "
4688 "dela iz dokumenta sama po sebi prosta v istem smislu. Dopolnjuje GNU General "
4689 "Public License, ki je licenca copyleft, zasnovana za prosto programje."
4690
4691 #. (itstool) path: sect1/para
4692 #: C/fdl-appendix.xml:50
4693 #, fuzzy
4694 msgid ""
4695 "We have designed this License in order to use it for manuals for free "
4696 "software, because free software needs free documentation: a free program "
4697 "should come with manuals providing the same freedoms that the software does. "
4698 "But this License is not limited to software manuals; it can be used for any "
4699 "textual work, regardless of subject matter or whether it is published as a "
4700 "printed book. We recommend this License principally for works whose purpose "
4701 "is instruction or reference."
4702 msgstr ""
4703 "To licenco smo zasnovali tako, da jo uporabljamo za priročnike za prosto "
4704 "programje, saj prosto programje potrebuje brezplačno dokumentacijo: prost "
4705 "program mora biti opremljen s priročniki, ki zagotavljajo enake svoboščine "
4706 "kot programska oprema. Vendar ta licenca ni omejena na priročnike za "
4707 "programsko opremo; Uporablja se lahko za katero koli tekstovno delo, ne "
4708 "glede na vsebino ali pa je objavljeno kot tiskana knjiga. To licenco "
4709 "priporočamo predvsem za dela, katerih namen je navodilo ali sklicevanje."
4710
4711 #. (itstool) path: sect1/title
4712 #: C/fdl-appendix.xml:62
4713 #, fuzzy
4714 msgid "1. APPLICABILITY AND DEFINITIONS"
4715 msgstr "1. UPORABA IN OPREDELITVE POJMOV"
4716
4717 #. (itstool) path: para/quote
4718 #. (itstool) path: para/link
4719 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4720 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4721 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4722 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4723 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4724 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4725 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4726 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4727 #: C/fdl-appendix.xml:608
4728 msgid "Document"
4729 msgstr "Dokument"
4730
4731 #. (itstool) path: para/quote
4732 #: C/fdl-appendix.xml:69
4733 msgid "you"
4734 msgstr "vi"
4735
4736 #. (itstool) path: sect1/para
4737 #: C/fdl-appendix.xml:63
4738 #, fuzzy
4739 msgid ""
4740 "This License applies to any manual or other work that contains a notice "
4741 "placed by the copyright holder saying it can be distributed under the terms "
4742 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4743 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4744 msgstr ""
4745 "Ta licenca velja za vsako ročno ali drugo delo, ki vsebuje obvestilo "
4746 "imetnika avtorskih pravic, da ga je mogoče distribuirati pod pogoji te "
4747 "licence. Spodnji <_:quote-1/> se nanaša na vsak tak priročnik ali delo. Vsak "
4748 "posameznik je pridobitelj licence in je naslovljen kot <_:quote-2/>."
4749
4750 #. (itstool) path: para/quote
4751 #. (itstool) path: para/link
4752 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4753 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4754 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4755 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4756 #, fuzzy
4757 msgid "Modified Version"
4758 msgstr "Spremenjena različica"
4759
4760 #. (itstool) path: sect1/para
4761 #: C/fdl-appendix.xml:72
4762 #, fuzzy
4763 msgid ""
4764 "A <_:quote-1/> of the Document means any work containing the Document or a "
4765 "portion of it, either copied verbatim, or with modifications and/or "
4766 "translated into another language."
4767 msgstr ""
4768 "<_:citat-1/> dokumenta pomeni vsako delo, ki vsebuje dokument ali njegov "
4769 "del, bodisi dobesedno kopirano bodisi s spremembami in/ali prevedeno v drug "
4770 "jezik."
4771
4772 #. (itstool) path: para/quote
4773 #: C/fdl-appendix.xml:80
4774 #, fuzzy
4775 msgid "Secondary Section"
4776 msgstr "Sekundarni del"
4777
4778 #. (itstool) path: sect1/para
4779 #: C/fdl-appendix.xml:79
4780 #, fuzzy
4781 msgid ""
4782 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:"
4783 "link-2/> that deals exclusively with the relationship of the publishers or "
4784 "authors of the Document to the Document's overall subject (or to related "
4785 "matters) and contains nothing that could fall directly within that overall "
4786 "subject. (For example, if the Document is in part a textbook of mathematics, "
4787 "a Secondary Section may not explain any mathematics.) The relationship could "
4788 "be a matter of historical connection with the subject or with related "
4789 "matters, or of legal, commercial, philosophical, ethical or political "
4790 "position regarding them."
4791 msgstr ""
4792 "<_:quote-1/> je imenovani dodatek ali prvi del <_:link-2/>, ki obravnava "
4793 "izključno odnos založnikov ali avtorjev dokumenta do celotne teme dokumenta "
4794 "(ali sorodnih zadev) in ne vsebuje ničesar, kar bi lahko neposredno spadalo "
4795 "v to celotno temo. (Če je na primer dokument delno učbenik matematike, "
4796 "sekundarni del morda ne bo razložil nobene matematike.) Odnos je lahko stvar "
4797 "zgodovinske povezave s subjektom ali sorodnimi zadevami ali pravnega, "
4798 "komercialnega, filozofskega, etičnega ali političnega stališča v zvezi z "
4799 "njimi."
4800
4801 #. (itstool) path: para/quote
4802 #. (itstool) path: para/link
4803 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4804 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4805 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4806 #, fuzzy
4807 msgid "Invariant Sections"
4808 msgstr "Invariantni odseki"
4809
4810 #. (itstool) path: para/link
4811 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4812 #, fuzzy
4813 msgid "Secondary Sections"
4814 msgstr "Sekundarni oddelki"
4815
4816 #. (itstool) path: sect1/para
4817 #: C/fdl-appendix.xml:94
4818 #, fuzzy
4819 msgid ""
4820 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
4821 "being those of Invariant Sections, in the notice that says that the <_:"
4822 "link-3/> is released under this License."
4823 msgstr ""
4824 "<_:quote-1/> so določeni <_:link-2/>, katerih naslovi so označeni kot "
4825 "naslovi odsekov Invariant, v obvestilu, ki pravi, da je <_:link-3/> "
4826 "objavljen pod to licenco."
4827
4828 #. (itstool) path: para/quote
4829 #. (itstool) path: para/link
4830 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4831 #: C/fdl-appendix.xml:458
4832 #, fuzzy
4833 msgid "Cover Texts"
4834 msgstr "Naslovna besedila"
4835
4836 #. (itstool) path: sect1/para
4837 #: C/fdl-appendix.xml:103
4838 #, fuzzy
4839 msgid ""
4840 "The <_:quote-1/> are certain short passages of text that are listed, as "
4841 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:"
4842 "link-2/> is released under this License."
4843 msgstr ""
4844 "<_:quote-1/> so nekateri kratki odlomki besedila, ki so navedeni kot "
4845 "besedila na sprednji platnici ali besedila zadnje platnice v obvestilu, ki "
4846 "pravi, da je <_:link-2/> objavljen pod to licenco."
4847
4848 #. (itstool) path: para/quote
4849 #. (itstool) path: para/link
4850 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4851 #: C/fdl-appendix.xml:369
4852 msgid "Transparent"
4853 msgstr "Prosojno"
4854
4855 #. (itstool) path: para/quote
4856 #. (itstool) path: para/link
4857 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4858 msgid "Opaque"
4859 msgstr "Neprozorno"
4860
4861 #. (itstool) path: sect1/para
4862 #: C/fdl-appendix.xml:111
4863 #, fuzzy
4864 msgid ""
4865 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4866 "represented in a format whose specification is available to the general "
4867 "public, whose contents can be viewed and edited directly and "
4868 "straightforwardly with generic text editors or (for images composed of "
4869 "pixels) generic paint programs or (for drawings) some widely available "
4870 "drawing editor, and that is suitable for input to text formatters or for "
4871 "automatic translation to a variety of formats suitable for input to text "
4872 "formatters. A copy made in an otherwise Transparent file format whose markup "
4873 "has been designed to thwart or discourage subsequent modification by readers "
4874 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
4875 msgstr ""
4876 "Kopija <_:quote-1/> <_:link-2/> je strojno berljiva kopija, predstavljena v "
4877 "formatu, katerega specifikacija je na voljo širši javnosti, katere vsebino "
4878 "si je mogoče neposredno in enostavno ogledati in urejati s splošnimi "
4879 "urejevalniki besedil ali (za slike, sestavljene iz slikovnih pik) "
4880 "generičnimi barvnimi programi ali (za risbe) kakšnim splošno dostopnim "
4881 "urejevalnikom risb, in ki je primerna za vnos v besedilo formatters ali za "
4882 "samodejni prevod v različne formate, primerne za vnos v besedilo za zadeve. "
4883 "Kopija, izdelana v sicer prosojni obliki zapisa datoteke, katere oznaka je "
4884 "bila zasnovana tako, da bralcem preprečuje ali odvrača od naknadnih "
4885 "sprememb, ni pregledna. Kopija, ki ni <_:quote-3/>, se imenuje <_:quote-4/>."
4886
4887 #. (itstool) path: sect1/para
4888 #: C/fdl-appendix.xml:128
4889 #, fuzzy
4890 msgid ""
4891 "Examples of suitable formats for Transparent copies include plain ASCII "
4892 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4893 "a publicly available DTD, and standard-conforming simple HTML designed for "
4894 "human modification. Opaque formats include PostScript, PDF, proprietary "
4895 "formats that can be read and edited only by proprietary word processors, "
4896 "SGML or XML for which the DTD and/or processing tools are not generally "
4897 "available, and the machine-generated HTML produced by some word processors "
4898 "for output purposes only."
4899 msgstr ""
4900 "Primeri primernih formatov za prosojne kopije vključujejo navaden ASCII brez "
4901 "oznake, vnosni format Texinfo, vhodni format LaTexx, SGML ali XML z javno "
4902 "dostopnim DTD in preprost HTML, ki ustreza standardom in je zasnovan za "
4903 "človeško spreminjanje. Neprozorni formati vključujejo PostScript, PDF, "
4904 "lastniške formate, ki jih lahko berejo in urejajo samo lastniški "
4905 "urejevalniki besedil, SGML ali XML, za katere DTD in / ali orodja za "
4906 "obdelavo niso splošno dostopna, in strojno ustvarjen HTML, ki ga ustvarijo "
4907 "nekateri urejevalniki besedil samo za izhodne namene."
4908
4909 #. (itstool) path: para/quote
4910 #. (itstool) path: para/link
4911 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4912 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4913 #, fuzzy
4914 msgid "Title Page"
4915 msgstr "Naslovna stran"
4916
4917 #. (itstool) path: sect1/para
4918 #: C/fdl-appendix.xml:141
4919 #, fuzzy
4920 msgid ""
4921 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4922 "following pages as are needed to hold, legibly, the material this License "
4923 "requires to appear in the title page. For works in formats which do not have "
4924 "any title page as such, <_:quote-2/> means the text near the most prominent "
4925 "appearance of the work's title, preceding the beginning of the body of the "
4926 "text."
4927 msgstr ""
4928 "<_:quote-1/> za tiskano knjigo pomeni samo naslovno stran in naslednje "
4929 "strani, ki so potrebne za čitljivo shranjevanje gradiva, ki ga ta licenca "
4930 "potrebuje, da se pojavi na naslovni strani. Za dela v formatih, ki nimajo "
4931 "naslovne strani kot take, <_:quote-2/> pomeni besedilo blizu najvidnejšega "
4932 "videza naslova dela pred začetkom telesa besedila."
4933
4934 #. (itstool) path: sect1/title
4935 #: C/fdl-appendix.xml:153
4936 #, fuzzy
4937 msgid "2. VERBATIM COPYING"
4938 msgstr "2. DOBESEDNO KOPIRANJE"
4939
4940 #. (itstool) path: para/link
4941 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4942 #, fuzzy
4943 msgid "section 3"
4944 msgstr "Oddelek 3"
4945
4946 #. (itstool) path: sect1/para
4947 #: C/fdl-appendix.xml:154
4948 #, fuzzy
4949 msgid ""
4950 "You may copy and distribute the <_:link-1/> in any medium, either "
4951 "commercially or noncommercially, provided that this License, the copyright "
4952 "notices, and the license notice saying this License applies to the Document "
4953 "are reproduced in all copies, and that you add no other conditions "
4954 "whatsoever to those of this License. You may not use technical measures to "
4955 "obstruct or control the reading or further copying of the copies you make or "
4956 "distribute. However, you may accept compensation in exchange for copies. If "
4957 "you distribute a large enough number of copies you must also follow the "
4958 "conditions in <_:link-2/>."
4959 msgstr ""
4960 "<_:link-1/> lahko kopirate in distribuirate v katerem koli mediju, "
4961 "komercialno ali nekomercialno, pod pogojem, da so ta licenca, obvestila o "
4962 "avtorskih pravicah in obvestilo o licenci, ki pravi, da ta licenca velja za "
4963 "dokument, reproducirani v vseh izvodih in da tem v tej licenci ne dodate "
4964 "nobenih drugih pogojev. Tehničnih ukrepov ne smete uporabljati za oviranje "
4965 "ali nadzor branja ali nadaljnjega kopiranja kopij, ki jih izdelujete ali "
4966 "distribuirate. Vendar pa lahko prejmete odškodnino v zameno za kopije. Če "
4967 "distribuirate dovolj veliko število izvodov, morate upoštevati tudi pogoje v "
4968 "<_:link-2/>."
4969
4970 #. (itstool) path: sect1/para
4971 #: C/fdl-appendix.xml:169
4972 #, fuzzy
4973 msgid ""
4974 "You may also lend copies, under the same conditions stated above, and you "
4975 "may publicly display copies."
4976 msgstr ""
4977 "Kopije si lahko izposodite tudi pod enakimi pogoji, kot so navedeni zgoraj, "
4978 "kopije pa lahko javno objavite."
4979
4980 #. (itstool) path: sect1/title
4981 #: C/fdl-appendix.xml:176
4982 #, fuzzy
4983 msgid "3. COPYING IN QUANTITY"
4984 msgstr "3. KOPIRANJE KOLIČINE"
4985
4986 #. (itstool) path: sect1/para
4987 #: C/fdl-appendix.xml:177
4988 #, fuzzy
4989 msgid ""
4990 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
4991 "and the Document's license notice requires <_:link-2/>, you must enclose the "
4992 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
4993 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
4994 "cover. Both covers must also clearly and legibly identify you as the "
4995 "publisher of these copies. The front cover must present the full title with "
4996 "all words of the title equally prominent and visible. You may add other "
4997 "material on the covers in addition. Copying with changes limited to the "
4998 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
4999 "these conditions, can be treated as verbatim copying in other respects."
5000 msgstr ""
5001 "Če objavite natisnjene izvode <_:link-1/>, ki štejejo več kot 100, in "
5002 "obvestilo o licenci dokumenta zahteva <_:link-2/>, morate priložiti kopije "
5003 "na platnicah, ki jasno in čitljivo nosijo vsa ta naslovna besedila: besedila "
5004 "na sprednji platnici in besedila na zadnji platnici na zadnji platnici. Obe "
5005 "platnici vas morata tudi jasno in čitljivo identificirati kot založnika teh "
5006 "kopij. Na sprednjem ovitku mora biti polni naslov, pri čemer so vse besede "
5007 "naslova enako vidne in vidne. Poleg tega lahko na platnice dodate še drug "
5008 "material. Kopiranje s spremembami, omejenimi na platnice, če ohranjajo "
5009 "naslov <_:link-3/> in izpolnjujejo te pogoje, se lahko v drugih pogledih "
5010 "obravnava kot dobesedno kopiranje."
5011
5012 #. (itstool) path: sect1/para
5013 #: C/fdl-appendix.xml:195
5014 #, fuzzy
5015 msgid ""
5016 "If the required texts for either cover are too voluminous to fit legibly, "
5017 "you should put the first ones listed (as many as fit reasonably) on the "
5018 "actual cover, and continue the rest onto adjacent pages."
5019 msgstr ""
5020 "Če so zahtevana besedila za obe naslovnici preveč obsežna, da bi se čitljivo "
5021 "prilegala, postavite prva navedena besedila (kolikor se razumno prilega) na "
5022 "dejansko platnico, ostalo pa nadaljujte na sosednje strani."
5023
5024 #. (itstool) path: sect1/para
5025 #: C/fdl-appendix.xml:202
5026 #, fuzzy
5027 msgid ""
5028 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
5029 "more than 100, you must either include a machine-readable <_:link-3/> copy "
5030 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
5031 "accessible computer-network location containing a complete Transparent copy "
5032 "of the Document, free of added material, which the general network-using "
5033 "public has access to download anonymously at no charge using public-standard "
5034 "network protocols. If you use the latter option, you must take reasonably "
5035 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
5036 "ensure that this Transparent copy will remain thus accessible at the stated "
5037 "location until at least one year after the last time you distribute an "
5038 "Opaque copy (directly or through your agents or retailers) of that edition "
5039 "to the public."
5040 msgstr ""
5041 "Če objavite ali distribuirate <_:link-1/> kopije <_:link-2/>, ki oštevilčijo "
5042 "več kot 100, morate poleg vsake neprozorne kopije priložiti strojno berljivo "
5043 "kopijo <_:link-3/> ali v vsaki neprozorni kopiji navesti javno dostopno "
5044 "računalniško omrežno mesto, ki vsebuje popolno pregledno kopijo dokumenta "
5045 "brez dodanega gradiva, ki ga lahko splošna javnost, ki uporablja omrežje, "
5046 "brezplačno anonimno prenese z uporabo omrežnih protokolov javnega standarda. "
5047 "Če uporabite slednjo možnost, morate ob začetku distribucije neprozornih "
5048 "kopij v količini sprejeti razumno preudarne ukrepe, da zagotovite, da bo ta "
5049 "prozorna kopija ostala dostopna na navedenem mestu vsaj eno leto po zadnji "
5050 "distribuciji neprozorne kopije (neposredno ali prek vaših zastopnikov ali "
5051 "prodajalcev) javnosti."
5052
5053 #. (itstool) path: sect1/para
5054 #: C/fdl-appendix.xml:222
5055 #, fuzzy
5056 msgid ""
5057 "It is requested, but not required, that you contact the authors of the <_:"
5058 "link-1/> well before redistributing any large number of copies, to give them "
5059 "a chance to provide you with an updated version of the Document."
5060 msgstr ""
5061 "Zahteva se, vendar ni obvezno, da se obrnete na avtorje <_:link-1/> veliko "
5062 "pred nadaljnjo distribucijo večjega števila izvodov in jim omogočite, da vam "
5063 "zagotovijo posodobljeno različico dokumenta."
5064
5065 #. (itstool) path: sect1/title
5066 #: C/fdl-appendix.xml:231
5067 #, fuzzy
5068 msgid "4. MODIFICATIONS"
5069 msgstr "4. SPREMEMBE"
5070
5071 #. (itstool) path: para/link
5072 #: C/fdl-appendix.xml:236
5073 msgid "2"
5074 msgstr "2"
5075
5076 #. (itstool) path: para/link
5077 #: C/fdl-appendix.xml:237
5078 msgid "3"
5079 msgstr "3"
5080
5081 #. (itstool) path: sect1/para
5082 #: C/fdl-appendix.xml:232
5083 #, fuzzy
5084 msgid ""
5085 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
5086 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
5087 "release the Modified Version under precisely this License, with the Modified "
5088 "Version filling the role of the Document, thus licensing distribution and "
5089 "modification of the Modified Version to whoever possesses a copy of it. In "
5090 "addition, you must do these things in the Modified Version:"
5091 msgstr ""
5092 "Kopirate in distribuirate lahko <_:link-1/> <_:link-2/> pod pogoji razdelkov "
5093 "<_:link-3/> in <_:link-4/> zgoraj, pod pogojem, da spremenjeno različico "
5094 "izdate prav pod to licenco, pri čemer spremenjena različica zapolni vlogo "
5095 "dokumenta in tako licencira distribucijo in spreminjanje spremenjene "
5096 "različice tistemu, ki ima njegovo kopijo. Poleg tega morate v spremenjeni "
5097 "različici narediti naslednje:"
5098
5099 #. (itstool) path: formalpara/title
5100 #: C/fdl-appendix.xml:248
5101 msgid "A"
5102 msgstr "A"
5103
5104 #. (itstool) path: formalpara/para
5105 #: C/fdl-appendix.xml:249
5106 #, fuzzy
5107 msgid ""
5108 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
5109 "that of the <_:link-2/>, and from those of previous versions (which should, "
5110 "if there were any, be listed in the History section of the Document). You "
5111 "may use the same title as a previous version if the original publisher of "
5112 "that version gives permission."
5113 msgstr ""
5114 "V <_:link-1/> (in na naslovnicah, če obstajajo) uporabite naslov, ki se "
5115 "razlikuje od naslova <_:link-2/> in od tistih iz prejšnjih različic (ki bi "
5116 "morale biti, če obstajajo, navedene v razdelku Zgodovina dokumenta). Isti "
5117 "naslov kot prejšnja različica lahko uporabite, če izvirni založnik te "
5118 "različice to dovoli."
5119
5120 #. (itstool) path: formalpara/title
5121 #: C/fdl-appendix.xml:264
5122 msgid "B"
5123 msgstr "B"
5124
5125 #. (itstool) path: formalpara/para
5126 #: C/fdl-appendix.xml:265
5127 #, fuzzy
5128 msgid ""
5129 "List on the <_:link-1/>, as authors, one or more persons or entities "
5130 "responsible for authorship of the modifications in the <_:link-2/>, together "
5131 "with at least five of the principal authors of the <_:link-3/> (all of its "
5132 "principal authors, if it has less than five)."
5133 msgstr ""
5134 "Na <_:link-1/> kot avtorji navedite eno ali več oseb ali subjektov, "
5135 "odgovornih za avtorstvo sprememb v <_:link-2/>, skupaj z vsaj petimi "
5136 "glavnimi avtorji <_:link-3/> (vsi njegovi glavni avtorji, če jih ima manj "
5137 "kot pet)."
5138
5139 #. (itstool) path: formalpara/title
5140 #: C/fdl-appendix.xml:279
5141 msgid "C"
5142 msgstr "C"
5143
5144 #. (itstool) path: formalpara/para
5145 #: C/fdl-appendix.xml:280
5146 #, fuzzy
5147 msgid ""
5148 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
5149 "the publisher."
5150 msgstr "Na <_:link-1/> navedite ime založnika <_:link-2/> kot založnika."
5151
5152 #. (itstool) path: formalpara/title
5153 #: C/fdl-appendix.xml:291
5154 msgid "D"
5155 msgstr "M"
5156
5157 #. (itstool) path: formalpara/para
5158 #: C/fdl-appendix.xml:292
5159 #, fuzzy
5160 msgid "Preserve all the copyright notices of the <_:link-1/>."
5161 msgstr "Ohranite vsa obvestila o avtorskih pravicah <_:link-1/>."
5162
5163 #. (itstool) path: formalpara/title
5164 #: C/fdl-appendix.xml:301
5165 msgid "E"
5166 msgstr "V"
5167
5168 #. (itstool) path: formalpara/para
5169 #: C/fdl-appendix.xml:302
5170 #, fuzzy
5171 msgid ""
5172 "Add an appropriate copyright notice for your modifications adjacent to the "
5173 "other copyright notices."
5174 msgstr ""
5175 "Dodajte ustrezno obvestilo o avtorskih pravicah za spremembe, ki so povezane "
5176 "z drugimi obvestili o avtorskih pravicah."
5177
5178 #. (itstool) path: formalpara/title
5179 #: C/fdl-appendix.xml:311
5180 msgid "F"
5181 msgstr "P"
5182
5183 #. (itstool) path: formalpara/para
5184 #: C/fdl-appendix.xml:312
5185 #, fuzzy
5186 msgid ""
5187 "Include, immediately after the copyright notices, a license notice giving "
5188 "the public permission to use the <_:link-1/> under the terms of this "
5189 "License, in the form shown in the Addendum below."
5190 msgstr ""
5191 "Takoj po obvestilu o avtorskih pravicah vključite obvestilo o licenci, ki "
5192 "javno dovoljuje uporabo <_:link-1/> pod pogoji te licence, v obliki, "
5193 "prikazani v spodnjem dodatku."
5194
5195 #. (itstool) path: formalpara/title
5196 #: C/fdl-appendix.xml:324
5197 msgid "G"
5198 msgstr "G"
5199
5200 #. (itstool) path: para/link
5201 #: C/fdl-appendix.xml:330
5202 #, fuzzy
5203 msgid "Document's"
5204 msgstr "Ta dokument ..."
5205
5206 #. (itstool) path: formalpara/para
5207 #: C/fdl-appendix.xml:325
5208 #, fuzzy
5209 msgid ""
5210 "Preserve in that license notice the full lists of <_:link-1/> and required "
5211 "<_:link-2/> given in the <_:link-3/> license notice."
5212 msgstr ""
5213 "V tem obvestilu o licenci ohranite celotne sezname <_:link-1/> in zahtevane "
5214 "<_:link-2/>, navedene v obvestilu o licenci <_:link-3/>."
5215
5216 #. (itstool) path: formalpara/title
5217 #: C/fdl-appendix.xml:337
5218 msgid "H"
5219 msgstr "H"
5220
5221 #. (itstool) path: formalpara/para
5222 #: C/fdl-appendix.xml:338
5223 #, fuzzy
5224 msgid "Include an unaltered copy of this License."
5225 msgstr "Vključite nespremenjeno kopijo te licence."
5226
5227 #. (itstool) path: formalpara/title
5228 #: C/fdl-appendix.xml:346
5229 msgid "I"
5230 msgstr "I"
5231
5232 #. (itstool) path: para/quote
5233 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
5234 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
5235 msgid "History"
5236 msgstr "Zgodovina"
5237
5238 #. (itstool) path: formalpara/para
5239 #: C/fdl-appendix.xml:347
5240 #, fuzzy
5241 msgid ""
5242 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
5243 "item stating at least the title, year, new authors, and publisher of the <_:"
5244 "link-2/> as given on the <_:link-3/>. If there is no section entitled <_:"
5245 "quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
5246 "and publisher of the Document as given on its Title Page, then add an item "
5247 "describing the Modified Version as stated in the previous sentence."
5248 msgstr ""
5249 "Ohranite razdelek z naslovom <_:quote-1/> in njegov naslov ter dodajte "
5250 "element, v katerem so navedeni vsaj naslov, leto, novi avtorji in založnik "
5251 "<_:link-2/>, kot je navedeno na <_:link-3/>. Če v <_:link-5/> ni razdelka z "
5252 "naslovom <_:quote-4/>, ustvarite razdelek, v katerem so navedeni naslov, "
5253 "leto, avtorji in založnik dokumenta, kot je navedeno na naslovni strani, "
5254 "nato dodajte element, ki opisuje spremenjeno različico, kot je navedeno v "
5255 "prejšnjem stavku."
5256
5257 #. (itstool) path: formalpara/title
5258 #: C/fdl-appendix.xml:365
5259 #, fuzzy
5260 msgid "J"
5261 msgstr "j"
5262
5263 #. (itstool) path: formalpara/para
5264 #: C/fdl-appendix.xml:366
5265 #, fuzzy
5266 msgid ""
5267 "Preserve the network location, if any, given in the <_:link-1/> for public "
5268 "access to a <_:link-2/> copy of the Document, and likewise the network "
5269 "locations given in the Document for previous versions it was based on. These "
5270 "may be placed in the <_:quote-3/> section. You may omit a network location "
5271 "for a work that was published at least four years before the Document "
5272 "itself, or if the original publisher of the version it refers to gives "
5273 "permission."
5274 msgstr ""
5275 "Ohranite morebitno omrežno mesto, navedeno v <_:link-1/> za javni dostop do "
5276 "kopije dokumenta <_:link-2/>, in tudi omrežna mesta, navedena v dokumentu za "
5277 "prejšnje različice, na katerih je temeljila. Te lahko uvrstite v razdelek <_:"
5278 "quote-3/>. Omrežno mesto lahko izpustite za delo, ki je bilo objavljeno vsaj "
5279 "štiri leta pred samim dokumentom ali če izvirni založnik različice, na "
5280 "katero se sklicuje, to dovoli."
5281
5282 #. (itstool) path: formalpara/title
5283 #: C/fdl-appendix.xml:383
5284 #, fuzzy
5285 msgid "K"
5286 msgstr "_Črnilo"
5287
5288 #. (itstool) path: para/quote
5289 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5290 #, fuzzy
5291 msgid "Acknowledgements"
5292 msgstr "Priznanj"
5293
5294 #. (itstool) path: para/quote
5295 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5296 msgid "Dedications"
5297 msgstr "Posvetila"
5298
5299 #. (itstool) path: formalpara/para
5300 #: C/fdl-appendix.xml:384
5301 #, fuzzy
5302 msgid ""
5303 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5304 "title, and preserve in the section all the substance and tone of each of the "
5305 "contributor acknowledgements and/or dedications given therein."
5306 msgstr ""
5307 "V katerem koli razdelku z naslovom <_:quote-1/> ali <_:quote-2/> ohranite "
5308 "naslov rubrike in v razdelku ohranite vso vsebino in ton vsakega od avtorjev "
5309 "prispevkov, ki so v njem navedeni."
5310
5311 #. (itstool) path: formalpara/title
5312 #: C/fdl-appendix.xml:396
5313 msgid "L"
5314 msgstr "L"
5315
5316 #. (itstool) path: formalpara/para
5317 #: C/fdl-appendix.xml:397
5318 #, fuzzy
5319 msgid ""
5320 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5321 "in their titles. Section numbers or the equivalent are not considered part "
5322 "of the section titles."
5323 msgstr ""
5324 "Ohranite vse <_:link-1/> <_:link-2/>, nespremenjene v besedilu in naslovih. "
5325 "Številke razdelkov ali enakovredne številke se ne štejejo za del naslovov "
5326 "razdelkov."
5327
5328 #. (itstool) path: formalpara/title
5329 #: C/fdl-appendix.xml:409
5330 msgid "M"
5331 msgstr "P"
5332
5333 #. (itstool) path: para/quote
5334 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5335 #, fuzzy
5336 msgid "Endorsements"
5337 msgstr "Zaznamkov"
5338
5339 #. (itstool) path: formalpara/para
5340 #: C/fdl-appendix.xml:410
5341 #, fuzzy
5342 msgid ""
5343 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5344 "in the <_:link-2/>."
5345 msgstr ""
5346 "Izbrišite kateri koli razdelek z naslovom <_:quote-1/>. Tak razdelek ne sme "
5347 "biti vključen v <_:link-2/>."
5348
5349 #. (itstool) path: formalpara/title
5350 #: C/fdl-appendix.xml:421
5351 msgid "N"
5352 msgstr "N"
5353
5354 #. (itstool) path: para/link
5355 #: C/fdl-appendix.xml:425
5356 #, fuzzy
5357 msgid "Invariant Section"
5358 msgstr "Invariantni odsek"
5359
5360 #. (itstool) path: formalpara/para
5361 #: C/fdl-appendix.xml:422
5362 #, fuzzy
5363 msgid ""
5364 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5365 "with any <_:link-2/>."
5366 msgstr ""
5367 "Nobenega obstoječega razdelka ne preimenujte v <_:quote-1/> ali v spor v "
5368 "naslovu s katerim koli <_:link-2/>."
5369
5370 #. (itstool) path: sect1/para
5371 #: C/fdl-appendix.xml:432
5372 #, fuzzy
5373 msgid ""
5374 "If the <_:link-1/> includes new front-matter sections or appendices that "
5375 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5376 "may at your option designate some or all of these sections as invariant. To "
5377 "do this, add their titles to the list of <_:link-3/> in the Modified "
5378 "Version's license notice. These titles must be distinct from any other "
5379 "section titles."
5380 msgstr ""
5381 "Če <_:link-1/> vključuje nove razdelke ali dodatke na fronti, ki "
5382 "izpolnjujejo pogoje <_:link-2/> in ne vsebujejo nobenega gradiva, kopiranega "
5383 "iz dokumenta, lahko nekatere ali vse te razdelke po vaši izbiri označite kot "
5384 "nespremenljive. Če želite to narediti, dodajte njihove naslove na seznam <_:"
5385 "link-3/> v obvestilu o licenci spremenjene različice. Ti naslovi se morajo "
5386 "razlikovati od vseh drugih naslovov razdelkov."
5387
5388 #. (itstool) path: sect1/para
5389 #: C/fdl-appendix.xml:444
5390 #, fuzzy
5391 msgid ""
5392 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5393 "but endorsements of your <_:link-2/> by various parties--for example, "
5394 "statements of peer review or that the text has been approved by an "
5395 "organization as the authoritative definition of a standard."
5396 msgstr ""
5397 "Dodate lahko razdelek z naslovom <_:quote-1/>, če ne vsebuje nič drugega kot "
5398 "priporočila vaših <_:link-2/> s strani različnih strank - na primer izjave o "
5399 "medsebojnem strokovnem pregledu ali če je besedilo odobrila organizacija kot "
5400 "verodostojno opredelitev standarda."
5401
5402 #. (itstool) path: para/link
5403 #: C/fdl-appendix.xml:455
5404 #, fuzzy
5405 msgid "Front-Cover Text"
5406 msgstr "Besedilo sprednje platnice"
5407
5408 #. (itstool) path: para/link
5409 #: C/fdl-appendix.xml:457
5410 #, fuzzy
5411 msgid "Back-Cover Text"
5412 msgstr "Besedilo na zadnji platnici"
5413
5414 #. (itstool) path: sect1/para
5415 #: C/fdl-appendix.xml:453
5416 #, fuzzy
5417 msgid ""
5418 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5419 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5420 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5421 "Text may be added by (or through arrangements made by) any one entity. If "
5422 "the <_:link-5/> already includes a cover text for the same cover, previously "
5423 "added by you or by arrangement made by the same entity you are acting on "
5424 "behalf of, you may not add another; but you may replace the old one, on "
5425 "explicit permission from the previous publisher that added the old one."
5426 msgstr ""
5427 "Na konec seznama <_:link-3/> v <_:link-4/> lahko dodate odlomek z največ "
5428 "petimi besedami kot <_:link-1/> in odlomek z največ 25 besedami kot <_:"
5429 "link-2/>. Kateri koli subjekt lahko doda samo en odlomek besedila na "
5430 "sprednji platnici in enega od besedil na zadnji platnici (ali z dogovori, ki "
5431 "jih sklene). Če <_:link-5/> že vsebuje naslovnico za isto naslovnico, ki ste "
5432 "jo prej dodali vi ali po dogovoru iste entitete, v imenu katere delujete, ne "
5433 "morete dodati druge; lahko pa zamenjate staro na izrecno dovoljenje "
5434 "prejšnjega založnika, ki je dodal staro."
5435
5436 #. (itstool) path: sect1/para
5437 #: C/fdl-appendix.xml:470
5438 #, fuzzy
5439 msgid ""
5440 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5441 "give permission to use their names for publicity for or to assert or imply "
5442 "endorsement of any <_:link-2/>."
5443 msgstr ""
5444 "Avtor(ji) in založnik(-i) <_:link-1/> s to licenco ne dovoljujejo uporabe "
5445 "svojih imen za oglaševanje, uveljavljanje ali namigovanje na podporo katere "
5446 "koli <_:link-2/>."
5447
5448 #. (itstool) path: sect1/title
5449 #: C/fdl-appendix.xml:480
5450 #, fuzzy
5451 msgid "5. COMBINING DOCUMENTS"
5452 msgstr "5. ZDRUŽEVANJE DOKUMENTOV"
5453
5454 #. (itstool) path: para/link
5455 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5456 #, fuzzy
5457 msgid "section 4"
5458 msgstr "Oddelek 4"
5459
5460 #. (itstool) path: sect1/para
5461 #: C/fdl-appendix.xml:481
5462 #, fuzzy
5463 msgid ""
5464 "You may combine the <_:link-1/> with other documents released under this "
5465 "License, under the terms defined in <_:link-2/> above for modified versions, "
5466 "provided that you include in the combination all of the <_:link-3/> of all "
5467 "of the original documents, unmodified, and list them all as Invariant "
5468 "Sections of your combined work in its license notice."
5469 msgstr ""
5470 "<_:link-1/> lahko kombinirate z drugimi dokumenti, izdanimi na podlagi te "
5471 "licence, pod pogoji, opredeljenimi v <_:link-2/> zgoraj za spremenjene "
5472 "različice, pod pogojem, da v kombinacijo vključite vse nespremenjene <_:"
5473 "link-3/> vseh izvirnih dokumentov in jih v obvestilu o licenci navedete kot "
5474 "nespremenljive odseke vašega kombiniranega dela."
5475
5476 #. (itstool) path: sect1/para
5477 #: C/fdl-appendix.xml:492
5478 #, fuzzy
5479 msgid ""
5480 "The combined work need only contain one copy of this License, and multiple "
5481 "identical <_:link-1/> may be replaced with a single copy. If there are "
5482 "multiple Invariant Sections with the same name but different contents, make "
5483 "the title of each such section unique by adding at the end of it, in "
5484 "parentheses, the name of the original author or publisher of that section if "
5485 "known, or else a unique number. Make the same adjustment to the section "
5486 "titles in the list of Invariant Sections in the license notice of the "
5487 "combined work."
5488 msgstr ""
5489 "Kombinirano delo mora vsebovati samo en izvod te licence, več enakih <_:"
5490 "link-1/> pa je mogoče nadomestiti z enim izvodom. Če obstaja več razdelkov z "
5491 "enakim imenom, vendar različno vsebino, naredite naslov vsakega takega "
5492 "razdelka edinstven tako, da na koncu dodate v oklepajih ime izvirnega "
5493 "avtorja ali založnika tega razdelka, če je znano, ali pa enolično številko. "
5494 "Enako prilagodite naslove razdelkov na seznamu nespremenljivih odsekov v "
5495 "obvestilu o licenci kombiniranega dela."
5496
5497 #. (itstool) path: para/quote
5498 #: C/fdl-appendix.xml:511
5499 #, fuzzy
5500 msgid "Endorsements."
5501 msgstr "Zaznamkov."
5502
5503 #. (itstool) path: sect1/para
5504 #: C/fdl-appendix.xml:505
5505 #, fuzzy
5506 msgid ""
5507 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5508 "the various original documents, forming one section entitled <_:quote-2/>; "
5509 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5510 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5511 msgstr ""
5512 "V kombinaciji morate združiti vse razdelke z naslovom <_:quote-1/> v "
5513 "različnih izvirnih dokumentih, ki tvorijo en razdelek z naslovom <_:quote-2/"
5514 ">; prav tako združiti vse razdelke z naslovom <_:quote-3/> in vse razdelke z "
5515 "naslovom <_:quote-4/>. Izbrisati morate vse razdelke z naslovom <_:quote-5/>"
5516
5517 #. (itstool) path: sect1/title
5518 #: C/fdl-appendix.xml:516
5519 #, fuzzy
5520 msgid "6. COLLECTIONS OF DOCUMENTS"
5521 msgstr "6. ZBIRKE DOKUMENTOV"
5522
5523 #. (itstool) path: sect1/para
5524 #: C/fdl-appendix.xml:517
5525 #, fuzzy
5526 msgid ""
5527 "You may make a collection consisting of the <_:link-1/> and other documents "
5528 "released under this License, and replace the individual copies of this "
5529 "License in the various documents with a single copy that is included in the "
5530 "collection, provided that you follow the rules of this License for verbatim "
5531 "copying of each of the documents in all other respects."
5532 msgstr ""
5533 "Ustvarite lahko zbirko, ki jo sestavljajo <_:link-1/> in drugi dokumenti, "
5534 "izdani na podlagi te licence, ter posamezne kopije te licence v različnih "
5535 "dokumentih zamenjate z enim izvodom, ki je vključen v zbirko, pod pogojem, "
5536 "da upoštevate pravila te licence za dobesedno kopiranje vsakega od "
5537 "dokumentov v vseh drugih pogledih."
5538
5539 #. (itstool) path: sect1/para
5540 #: C/fdl-appendix.xml:527
5541 #, fuzzy
5542 msgid ""
5543 "You may extract a single document from such a collection, and distribute it "
5544 "individually under this License, provided you insert a copy of this License "
5545 "into the extracted document, and follow this License in all other respects "
5546 "regarding verbatim copying of that document."
5547 msgstr ""
5548 "Iz takšne zbirke lahko izvlečete en dokument in ga posamično distribuirate v "
5549 "okviru te licence, pod pogojem, da v izvlečeni dokument vstavite kopijo te "
5550 "licence in sledite tej licenci v vseh drugih pogledih glede dobesednega "
5551 "kopiranja tega dokumenta."
5552
5553 #. (itstool) path: sect1/title
5554 #: C/fdl-appendix.xml:537
5555 #, fuzzy
5556 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5557 msgstr "7. ZDRUŽEVANJE Z NEODVISNIMI DELI"
5558
5559 #. (itstool) path: para/quote
5560 #: C/fdl-appendix.xml:546
5561 #, fuzzy
5562 msgid "aggregate"
5563 msgstr "Agregat"
5564
5565 #. (itstool) path: para/link
5566 #: C/fdl-appendix.xml:550
5567 #, fuzzy
5568 msgid "Cover Text"
5569 msgstr "Besedilo naslovnice"
5570
5571 #. (itstool) path: sect1/para
5572 #: C/fdl-appendix.xml:538
5573 #, fuzzy
5574 msgid ""
5575 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5576 "independent documents or works, in or on a volume of a storage or "
5577 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5578 "Document, provided no compilation copyright is claimed for the compilation. "
5579 "Such a compilation is called an <_:quote-3/>, and this License does not "
5580 "apply to the other self-contained works thus compiled with the Document , on "
5581 "account of their being thus compiled, if they are not themselves derivative "
5582 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5583 "applicable to these copies of the Document, then if the Document is less "
5584 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5585 "placed on covers that surround only the Document within the aggregate. "
5586 "Otherwise they must appear on covers around the whole aggregate."
5587 msgstr ""
5588 "Zbirka <_:link-1/> ali njenih izpeljank z drugimi ločenimi in neodvisnimi "
5589 "dokumenti ali deli v ali na nosilcu pomnilniškega ali distribucijskega "
5590 "medija se kot celota ne šteje kot <_:link-2/> dokumenta, če se za "
5591 "kompilacijo ne zahtevajo avtorske pravice za kompilacijo. Takšna kompilacija "
5592 "se imenuje <_:quote-3/> in ta licenca ne velja za druga samostojna dela, ki "
5593 "so tako sestavljena z dokumentom, ker so tako sestavljena, če sama niso "
5594 "izpeljana dela iz dokumenta. Če za te kopije dokumenta velja zahteva <_:"
5595 "link-4/> iz <_:link-5/>, se lahko spremna besedila dokumenta postavijo na "
5596 "platnice, ki obkrožajo samo dokument v celoti, če je dokument manjši od ene "
5597 "četrtine celotnega dokumenta. V nasprotnem primeru se morajo pojaviti na "
5598 "pokrovih okoli celotnega agregata."
5599
5600 #. (itstool) path: sect1/title
5601 #: C/fdl-appendix.xml:561
5602 #, fuzzy
5603 msgid "8. TRANSLATION"
5604 msgstr "8. PREVAJANJE"
5605
5606 #. (itstool) path: sect1/para
5607 #: C/fdl-appendix.xml:562
5608 #, fuzzy
5609 msgid ""
5610 "Translation is considered a kind of modification, so you may distribute "
5611 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:"
5612 "link-3/> with translations requires special permission from their copyright "
5613 "holders, but you may include translations of some or all Invariant Sections "
5614 "in addition to the original versions of these Invariant Sections. You may "
5615 "include a translation of this License provided that you also include the "
5616 "original English version of this License. In case of a disagreement between "
5617 "the translation and the original English version of this License, the "
5618 "original English version will prevail."
5619 msgstr ""
5620 "Prevajanje se šteje za nekakšno spremembo, zato lahko prevode <_:link-1/> "
5621 "distribuirate pod pogoji <_:link-2/>. Za zamenjavo <_:link-3/> s prevodi je "
5622 "potrebno posebno dovoljenje njihovih imetnikov avtorskih pravic, vendar "
5623 "lahko poleg izvirnih različic teh razdelkov Invariant vključite tudi prevode "
5624 "nekaterih ali vseh razdelkov Invariant. Vključite lahko prevod te licence, "
5625 "če vključite tudi izvirno angleško različico te licence. V primeru "
5626 "nesoglasja med prevodom in izvirno angleško različico te licence prevlada "
5627 "izvirna angleška različica."
5628
5629 #. (itstool) path: sect1/title
5630 #: C/fdl-appendix.xml:580
5631 #, fuzzy
5632 msgid "9. TERMINATION"
5633 msgstr "9. PRENEHANJE"
5634
5635 #. (itstool) path: sect1/para
5636 #: C/fdl-appendix.xml:581
5637 #, fuzzy
5638 msgid ""
5639 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5640 "as expressly provided for under this License. Any other attempt to copy, "
5641 "modify, sublicense or distribute the Document is void, and will "
5642 "automatically terminate your rights under this License. However, parties who "
5643 "have received copies, or rights, from you under this License will not have "
5644 "their licenses terminated so long as such parties remain in full compliance."
5645 msgstr ""
5646 "Prepovedano je kopirati, spreminjati, podlicencirati ali distribuirati <_:"
5647 "link-1/>, razen kot je izrecno določeno v tej licenci. Vsak drug poskus "
5648 "kopiranja, spreminjanja, podlicenciranja ali distribucije dokumenta je ničen "
5649 "in samodejno preneha veljati vaše pravice iz te licence. Vendar pa strankam, "
5650 "ki so od vas prejele kopije ali pravice na podlagi te licence, licence ne "
5651 "bodo prekinjene, dokler te stranke v celoti izpolnjujejo zahteve."
5652
5653 #. (itstool) path: sect1/title
5654 #: C/fdl-appendix.xml:594
5655 #, fuzzy
5656 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5657 msgstr "10. PRIHODNJE SPREMEMBE TE LICENCE"
5658
5659 #. (itstool) path: para/ulink
5660 #: C/fdl-appendix.xml:597
5661 msgid "Free Software Foundation"
5662 msgstr "Free Software Foundation"
5663
5664 #. (itstool) path: para/ulink
5665 #: C/fdl-appendix.xml:603
5666 #, fuzzy
5667 msgid "http://www.gnu.org/copyleft/"
5668 msgstr "http://www.gnu.org/copyleft/"
5669
5670 #. (itstool) path: sect1/para
5671 #: C/fdl-appendix.xml:595
5672 #, fuzzy
5673 msgid ""
5674 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5675 "Documentation License from time to time. Such new versions will be similar "
5676 "in spirit to the present version, but may differ in detail to address new "
5677 "problems or concerns. See <_:ulink-2/>."
5678 msgstr ""
5679 "<_:ulink-1/> lahko občasno objavi nove, spremenjene različice licence GNU za "
5680 "prosto dokumentacijo. Takšne nove različice bodo po duhu podobne sedanji "
5681 "različici, vendar se lahko glede na nove težave ali pomisleke zelo "
5682 "razlikujejo. Glej <_:ulink-2/>."
5683
5684 #. (itstool) path: para/quote
5685 #: C/fdl-appendix.xml:610
5686 #, fuzzy
5687 msgid "or any later version"
5688 msgstr "ali katera koli novejša različica"
5689
5690 #. (itstool) path: sect1/para
5691 #: C/fdl-appendix.xml:606
5692 #, fuzzy
5693 msgid ""
5694 "Each version of the License is given a distinguishing version number. If the "
5695 "<_:link-1/> specifies that a particular numbered version of this License <_:"
5696 "quote-2/> applies to it, you have the option of following the terms and "
5697 "conditions either of that specified version or of any later version that has "
5698 "been published (not as a draft) by the Free Software Foundation. If the "
5699 "Document does not specify a version number of this License, you may choose "
5700 "any version ever published (not as a draft) by the Free Software Foundation."
5701 msgstr ""
5702 "Vsaka različica licence dobi razlikovalno številko različice. Če <_:link-1/> "
5703 "določa, da zanjo velja določena oštevilčena različica te licence <_:quote-2/"
5704 ">, lahko upoštevate pogoje in določila te določene različice ali katere koli "
5705 "novejše različice, ki jo je objavila (ne kot osnutek) fundacije Free "
5706 "Software Foundation. Če dokument ne določa številke različice te licence, "
5707 "lahko izberete katero koli različico, ki jo je kdaj koli objavila (ne kot "
5708 "osnutek) fundacije Free Software Foundation."
5709
5710 #. (itstool) path: sect1/title
5711 #: C/fdl-appendix.xml:621
5712 #, fuzzy
5713 msgid "Addendum"
5714 msgstr "Dopolnilo"
5715
5716 #. (itstool) path: sect1/para
5717 #: C/fdl-appendix.xml:622
5718 #, fuzzy
5719 msgid ""
5720 "To use this License in a document you have written, include a copy of the "
5721 "License in the document and put the following copyright and license notices "
5722 "just after the title page:"
5723 msgstr ""
5724 "Če želite uporabiti to licenco v dokumentu, ki ste ga napisali, v dokument "
5725 "vključite kopijo licence in takoj za naslovno stranjo vnesite naslednja "
5726 "obvestila o avtorskih pravicah in licencah:"
5727
5728 #. (itstool) path: blockquote/para
5729 #: C/fdl-appendix.xml:629
5730 #, fuzzy
5731 msgid "Copyright YEAR YOUR NAME."
5732 msgstr "Avtorske pravice LETNICA VAŠE IME."
5733
5734 #. (itstool) path: para/link
5735 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5736 #, fuzzy
5737 msgid "Front-Cover Texts"
5738 msgstr "Besedila na sprednji platnici"
5739
5740 #. (itstool) path: para/link
5741 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5742 #, fuzzy
5743 msgid "Back-Cover Texts"
5744 msgstr "Besedila z zadnje platnice"
5745
5746 #. (itstool) path: blockquote/para
5747 #: C/fdl-appendix.xml:632
5748 #, fuzzy
5749 msgid ""
5750 "Permission is granted to copy, distribute and/or modify this document under "
5751 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5752 "version published by the Free Software Foundation; with the <_:link-1/> "
5753 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:"
5754 "link-3/> being LIST. A copy of the license is included in the section "
5755 "entitled <_:quote-4/>."
5756 msgstr ""
5757 "Dovoljenje za kopiranje, distribucijo in/ali spreminjanje tega dokumenta je "
5758 "podeljeno pod pogoji licence GNU za prosto dokumentacijo, različice 1.1 ali "
5759 "katere koli novejše različice, ki jo je objavila fundacija Free Software "
5760 "Foundation; pri <_:link-1/> NAVEDITE SVOJE NASLOVE, pri čemer je <_:link-2/> "
5761 "SEZNAM, <_:link-3/> pa SEZNAM. Kopija licence je vključena v razdelek z "
5762 "naslovom <_:quote-4/>."
5763
5764 #. (itstool) path: para/quote
5765 #: C/fdl-appendix.xml:649
5766 #, fuzzy
5767 msgid "with no Invariant Sections"
5768 msgstr "brez invariantnih odsekov"
5769
5770 #. (itstool) path: para/quote
5771 #: C/fdl-appendix.xml:652
5772 #, fuzzy
5773 msgid "no Front-Cover Texts"
5774 msgstr "brez besedil na naslovnici"
5775
5776 #. (itstool) path: para/quote
5777 #: C/fdl-appendix.xml:653
5778 #, fuzzy
5779 msgid "Front-Cover Texts being LIST"
5780 msgstr "Besedila na sprednji strani so SEZNAM"
5781
5782 #. (itstool) path: sect1/para
5783 #: C/fdl-appendix.xml:647
5784 #, fuzzy
5785 msgid ""
5786 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5787 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:"
5788 "quote-5/>; likewise for <_:link-6/>."
5789 msgstr ""
5790 "Če nimate <_:link-1/>, napišite <_:quote-2/>, namesto da bi povedali, katere "
5791 "so nespremenljive. Če nimate <_:link-3/>, napišite <_:quote-4/> namesto <_:"
5792 "quote-5/>; prav tako za <_:link-6/>."
5793
5794 #. (itstool) path: para/ulink
5795 #: C/fdl-appendix.xml:661
5796 msgid "GNU General Public License"
5797 msgstr "Splošno javno dovoljenje GNU"
5798
5799 #. (itstool) path: sect1/para
5800 #: C/fdl-appendix.xml:657
5801 msgid ""
5802 "If your document contains nontrivial examples of program code, we recommend "
5803 "releasing these examples in parallel under your choice of free software "
5804 "license, such as the <_:ulink-1/>, to permit their use in free software."
5805 msgstr ""
5806 "Če vaš dokument vsebuje netrivialne primere programske kode, priporočamo, da "
5807 "te primere vzporedno objavite pod vašim izbranim dovoljenjem za prosto "
5808 "programsko opremo, kot je <_:ulink-1/>, da dovolite njihovo uporabo v prosti "
5809 "programski opremi."