Debian Codegraph @

help/manual/hu/hu.po

raw
1 # Hungarian translation for gtk-doc.
2 # Copyright (C) 2023, 2024, 2026 Free Software Foundation, Inc.
3 # This file is distributed under the same license as the gtk-doc package.
4 #
5 # Balázs Úr <ur.balazs at fsf dot hu>, 2023, 2024, 2026.
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: gtk-doc master\n"
9 "POT-Creation-Date: 2026-03-10 19:37+0000\n"
10 "PO-Revision-Date: 2026-03-11 01:42+0100\n"
11 "Last-Translator: Balázs Úr <ur.balazs at fsf dot hu>\n"
12 "Language-Team: Hungarian <openscope at fsf dot hu>\n"
13 "Language: hu\n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
18 "X-Generator: Lokalize 25.08.1\n"
19
20 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
21 msgctxt "_"
22 msgid "translator-credits"
23 msgstr "Úr Balázs <ur dot balazs at fsf dot hu>, 2023, 2024, 2026."
24
25 #. (itstool) path: bookinfo/title
26 #: C/index.docbook:12
27 msgid "GTK-Doc Manual"
28 msgstr "GTK-Doc kézikönyv"
29
30 #. (itstool) path: bookinfo/edition
31 #: C/index.docbook:13
32 msgid "1.24.1"
33 msgstr "1.24.1"
34
35 #. (itstool) path: abstract/para
36 #: C/index.docbook:14
37 msgid "User manual for developers with instructions of GTK-Doc usage."
38 msgstr ""
39 "Felhasználói kézikönyv fejlesztők számára a GTK-Doc használatára vonatkozó "
40 "utasításokkal."
41
42 #. (itstool) path: authorgroup/author
43 #: C/index.docbook:16
44 msgid ""
45 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
46 "<address> <email>[email protected]</email> </address> </affiliation>"
47 msgstr ""
48 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
49 "<address> <email>[email protected]</email> </address> </affiliation>"
50
51 #. (itstool) path: authorgroup/author
52 #: C/index.docbook:25
53 msgid ""
54 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
55 "<email>[email protected]</email> </address> </affiliation>"
56 msgstr ""
57 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
58 "<email>[email protected]</email> </address> </affiliation>"
59
60 #. (itstool) path: authorgroup/author
61 #: C/index.docbook:34
62 msgid ""
63 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
64 "<address> <email>[email protected]</email> </address> </affiliation>"
65 msgstr ""
66 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
67 "<address> <email>[email protected]</email> </address> </affiliation>"
68
69 #. (itstool) path: publisher/publishername
70 #: C/index.docbook:45
71 msgid "GTK-Doc project"
72 msgstr "GTK-Doc projekt"
73
74 #. (itstool) path: bookinfo/publisher
75 #: C/index.docbook:44
76 msgid ""
77 "<_:publishername-1/> <address><email>[email protected]</email></address>"
78 msgstr ""
79 "<_:publishername-1/> <address><email>[email protected]</email></address>"
80
81 #. (itstool) path: bookinfo/copyright
82 #: C/index.docbook:48
83 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
84 msgstr "<year>2000, 2005</year> <holder>Dan Mueth és Chris Lyttle</holder>"
85
86 #. (itstool) path: bookinfo/copyright
87 #: C/index.docbook:52
88 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
89 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
90
91 #. (itstool) path: legalnotice/para
92 #: C/index.docbook:65
93 msgid ""
94 "Permission is granted to copy, distribute and/or modify this document under "
95 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
96 "Version 1.1 or any later version published by the Free Software Foundation "
97 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
98 "copy of the license is <link linkend=\"fdl\">included</link>."
99 msgstr ""
100 "Engedélyt adunk Önnek a jelen dokumentum sokszorosítására, terjesztésére és/"
101 "vagy módosítására a Free Software Foundation által kiadott <citetitle>GNU "
102 "Free Documentation License</citetitle> 1.2-es, vagy bármely azt követő "
103 "verziójának feltételei alapján. Nincs Nem Változtatható szakasz, nincs "
104 "Címlapszöveg, nincs Hátlapszöveg. A jelen licenc egy példányát <link "
105 "linkend=\"fdl\">mellékelve</link> találja."
106
107 #. (itstool) path: legalnotice/para
108 #: C/index.docbook:73
109 msgid ""
110 "Many of the names used by companies to distinguish their products and "
111 "services are claimed as trademarks. Where those names appear in any GNOME "
112 "documentation, and those trademarks are made aware to the members of the "
113 "GNOME Documentation Project, the names have been printed in caps or initial "
114 "caps."
115 msgstr ""
116 "A vállalatok által termékeik és szolgáltatásaik megkülönböztetésére használt "
117 "nevek közül sokan védjegyként vannak bejegyezve. Ahol ezek a nevek "
118 "megjelennek a GNOME dokumentációban, és a GNOME dokumentációs projekt "
119 "tagjainak tudomásuk van ezekről a védjegyekről, ott a nevek nagybetűvel vagy "
120 "nagy kezdőbetűvel vannak kiírva."
121
122 #. (itstool) path: revhistory/revision
123 #: C/index.docbook:83
124 msgid ""
125 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
126 "authorinitials> <revremark>gtk4 version</revremark>"
127 msgstr ""
128 "<revnumber>1.33.0</revnumber> <date>2020. október 1.</date> "
129 "<authorinitials>mc</authorinitials> <revremark>gtk4 verzió</revremark>"
130
131 #. (itstool) path: revhistory/revision
132 #: C/index.docbook:89
133 msgid ""
134 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
135 "authorinitials> <revremark>dev version</revremark>"
136 msgstr ""
137 "<revnumber>1.32.1</revnumber> <date>2019. augusztus 15.</date> "
138 "<authorinitials>ss</authorinitials> <revremark>fejlesztői verzió</revremark>"
139
140 #. (itstool) path: revhistory/revision
141 #: C/index.docbook:95
142 msgid ""
143 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
144 "authorinitials> <revremark>hotfix release</revremark>"
145 msgstr ""
146 "<revnumber>1.32</revnumber> <date>2019. augusztus 15.</date> "
147 "<authorinitials>ss</authorinitials> <revremark>gyorsjavítási kiadás</"
148 "revremark>"
149
150 #. (itstool) path: revhistory/revision
151 #: C/index.docbook:101
152 msgid ""
153 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
154 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
155 msgstr ""
156 "<revnumber>1.31</revnumber> <date>2019. augusztus 5.</date> "
157 "<authorinitials>ss</authorinitials> <revremark>újratervezések és jobb "
158 "tesztlefedettség</revremark>"
159
160 #. (itstool) path: revhistory/revision
161 #: C/index.docbook:107
162 msgid ""
163 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
164 "authorinitials> <revremark>more test coverage</revremark>"
165 msgstr ""
166 "<revnumber>1.30</revnumber> <date>2019. május 8.</date> <authorinitials>ss</"
167 "authorinitials> <revremark>jobb tesztlefedettség</revremark>"
168
169 #. (itstool) path: revhistory/revision
170 #: C/index.docbook:113
171 msgid ""
172 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
173 "authorinitials> <revremark>bug fixes</revremark>"
174 msgstr ""
175 "<revnumber>1.29</revnumber> <date>2018. augusztus 28.</date> "
176 "<authorinitials>ss</authorinitials> <revremark>hibajavítások</revremark>"
177
178 #. (itstool) path: revhistory/revision
179 #: C/index.docbook:119
180 msgid ""
181 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
182 "authorinitials> <revremark>bug fixes</revremark>"
183 msgstr ""
184 "<revnumber>1.28</revnumber> <date>2018. március 24.</date> "
185 "<authorinitials>ss</authorinitials> <revremark>hibajavítások</revremark>"
186
187 #. (itstool) path: revhistory/revision
188 #: C/index.docbook:125
189 msgid ""
190 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
191 "authorinitials> <revremark>fine tuning of the python port</revremark>"
192 msgstr ""
193 "<revnumber>1.27</revnumber> <date>2017. december 7.</date> "
194 "<authorinitials>ss</authorinitials> <revremark>a Pythonra történő átírás "
195 "finomhangolása</revremark>"
196
197 #. (itstool) path: revhistory/revision
198 #: C/index.docbook:131
199 msgid ""
200 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
201 "authorinitials> <revremark>port all tools from perl/bash to python</"
202 "revremark>"
203 msgstr ""
204 "<revnumber>1.26</revnumber> <date>2017. augusztus 11.</date> "
205 "<authorinitials>ss</authorinitials> <revremark>az összes eszköz átírása Perl "
206 "és Bash nyelvekről Pythonra</revremark>"
207
208 #. (itstool) path: revhistory/revision
209 #: C/index.docbook:137
210 msgid ""
211 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
212 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
213 msgstr ""
214 "<revnumber>1.25</revnumber> <date>2016. március 21.</date> "
215 "<authorinitials>ss</authorinitials> <revremark>hibajavítások, "
216 "teszttisztítások</revremark>"
217
218 #. (itstool) path: revhistory/revision
219 #: C/index.docbook:143
220 msgid ""
221 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
222 "authorinitials> <revremark>bug fix</revremark>"
223 msgstr ""
224 "<revnumber>1.24</revnumber> <date>2015. május 29.</date> <authorinitials>ss</"
225 "authorinitials> <revremark>hibajavítás</revremark>"
226
227 #. (itstool) path: revhistory/revision
228 #: C/index.docbook:149
229 msgid ""
230 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
231 "authorinitials> <revremark>bug fix</revremark>"
232 msgstr ""
233 "<revnumber>1.23</revnumber> <date>2015. május 17.</date> <authorinitials>ss</"
234 "authorinitials> <revremark>hibajavítás</revremark>"
235
236 #. (itstool) path: revhistory/revision
237 #: C/index.docbook:155
238 msgid ""
239 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
240 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
241 "revremark>"
242 msgstr ""
243 "<revnumber>1.22</revnumber> <date>2015. május 7.</date> <authorinitials>ss</"
244 "authorinitials> <revremark>hibajavítások, elavult funkciók kidobása</"
245 "revremark>"
246
247 #. (itstool) path: revhistory/revision
248 #: C/index.docbook:161
249 msgid ""
250 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
251 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
252 "revremark>"
253 msgstr ""
254 "<revnumber>1.21</revnumber> <date>2014. július 17.</date> "
255 "<authorinitials>ss</authorinitials> <revremark>hibajavítások, elavult "
256 "funkciók kidobása</revremark>"
257
258 #. (itstool) path: revhistory/revision
259 #: C/index.docbook:167
260 msgid ""
261 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
262 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
263 "revremark>"
264 msgstr ""
265 "<revnumber>1.20</revnumber> <date>2014. február 16.</date> "
266 "<authorinitials>ss</authorinitials> <revremark>hibajavítások, Markdown-"
267 "támogatás, stílusjavítások</revremark>"
268
269 #. (itstool) path: revhistory/revision
270 #: C/index.docbook:173
271 msgid ""
272 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
273 "authorinitials> <revremark>bug fixes</revremark>"
274 msgstr ""
275 "<revnumber>1.19</revnumber> <date>2013. június 5.</date> <authorinitials>ss</"
276 "authorinitials> <revremark>hibajavítások</revremark>"
277
278 #. (itstool) path: revhistory/revision
279 #: C/index.docbook:179
280 msgid ""
281 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
282 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
283 msgstr ""
284 "<revnumber>1.18</revnumber> <date>2011. szeptember 14.</date> "
285 "<authorinitials>ss</authorinitials> <revremark>hibajavítások, gyorsítások, "
286 "Markdown-támogatás</revremark>"
287
288 #. (itstool) path: revhistory/revision
289 #: C/index.docbook:185
290 msgid ""
291 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
292 "authorinitials> <revremark>urgent bug fix update</revremark>"
293 msgstr ""
294 "<revnumber>1.17</revnumber> <date>2011. február 26.</date> "
295 "<authorinitials>sk</authorinitials> <revremark>sürgős hibajavító frissítés</"
296 "revremark>"
297
298 #. (itstool) path: revhistory/revision
299 #: C/index.docbook:191
300 msgid ""
301 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
302 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
303 msgstr ""
304 "<revnumber>1.16</revnumber> <date>2011. január 14.</date> "
305 "<authorinitials>sk</authorinitials> <revremark>hibajavítások, elrendezési "
306 "továbbfejlesztések</revremark>"
307
308 #. (itstool) path: revhistory/revision
309 #: C/index.docbook:197
310 msgid ""
311 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
312 "authorinitials> <revremark>bug and regression fixes</revremark>"
313 msgstr ""
314 "<revnumber>1.15</revnumber> <date>2010. május 21.</date> <authorinitials>sk</"
315 "authorinitials> <revremark>hibajavítások és regressziójavítások</revremark>"
316
317 #. (itstool) path: revhistory/revision
318 #: C/index.docbook:203
319 msgid ""
320 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
321 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
322 msgstr ""
323 "<revnumber>1.14</revnumber> <date>2010. március 28.</date> "
324 "<authorinitials>sk</authorinitials> <revremark>hibajavítások és "
325 "teljesítményjavítások</revremark>"
326
327 #. (itstool) path: revhistory/revision
328 #: C/index.docbook:209
329 msgid ""
330 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
331 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
332 "revremark>"
333 msgstr ""
334 "<revnumber>1.13</revnumber> <date>2009. december 18.</date> "
335 "<authorinitials>sk</authorinitials> <revremark>törött forráscsomag-"
336 "frissítés</revremark>"
337
338 #. (itstool) path: revhistory/revision
339 #: C/index.docbook:215
340 msgid ""
341 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
342 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
343 "bugfixes</revremark>"
344 msgstr ""
345 "<revnumber>1.12</revnumber> <date>2009. december 18.</date> "
346 "<authorinitials>sk</authorinitials> <revremark>új eszközfunkciók és "
347 "hibajavítások</revremark>"
348
349 #. (itstool) path: revhistory/revision
350 #: C/index.docbook:221
351 msgid ""
352 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
353 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
354 "revremark>"
355 msgstr ""
356 "<revnumber>1.11</revnumber> <date>2008. november 16.</date> "
357 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils költöztetés</"
358 "revremark>"
359
360 #. (itstool) path: chapter/title
361 #: C/index.docbook:234
362 msgid "Introduction"
363 msgstr "Bevezetés"
364
365 #. (itstool) path: chapter/para
366 #: C/index.docbook:236
367 msgid ""
368 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
369 "it is used."
370 msgstr ""
371 "Ez a fejezet bemutatja a GTK-Doc dokumentációs eszközt, és áttekintést ad "
372 "arról, hogy mi is ez, és hogyan használják."
373
374 #. (itstool) path: sect1/title
375 #: C/index.docbook:242
376 msgid "What is GTK-Doc?"
377 msgstr "Mi a GTK-Doc?"
378
379 #. (itstool) path: sect1/para
380 #: C/index.docbook:244
381 #| msgid ""
382 #| "GTK-Doc is used to document C code. It is typically used to document the "
383 #| "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
384 #| "also be used to document application code."
385 msgid ""
386 "GTK-Doc is used to document C code. It is typically used to document the "
387 "public API of libraries, such as GLib-based libraries, but it can also be "
388 "used to document application code."
389 msgstr ""
390 "A GTK-Doc a C kód dokumentálására szolgál. Általában programkönyvtárak "
391 "nyilvános API-jának dokumentálására használják, mint például a GLib-alapú "
392 "programkönyvtárak, de használható az alkalmazás kódjának dokumentálására is."
393
394 #. (itstool) path: sect1/title
395 #: C/index.docbook:252
396 msgid "How Does GTK-Doc Work?"
397 msgstr "Hogyan működik a GTK-Doc?"
398
399 #. (itstool) path: sect1/para
400 #: C/index.docbook:254
401 #| msgid ""
402 #| "GTK-Doc works by using documentation of functions placed inside the "
403 #| "source files in specially-formatted comment blocks, or documentation "
404 #| "added to the template files which GTK-Doc uses (though note that GTK-Doc "
405 #| "will only document functions that are declared in header files; it won't "
406 #| "produce output for static functions)."
407 msgid ""
408 "GTK-Doc works by reading specially-formatted comment blocks placed inside "
409 "the source files to document symbols such as functions, macros, structs, "
410 "enums, etc. (though note that for most kind of symbols GTK-Doc will only "
411 "document the symbols that are declared in header files; for example it won't "
412 "produce output for static functions)."
413 msgstr ""
414 "A GTK-Doc úgy működik, hogy beolvassa a forrásfájlokon belül elhelyezett "
415 "különlegesen formázott megjegyzésblokkokat, hogy dokumentálja a "
416 "szimbólumokat, mint például a függvényeket, makrókat, struktúrákat, "
417 "felsorolásokat stb. (habár ne feledje, hogy a legtöbb szimbólumtípusnál a "
418 "GTK-Doc csak a fejlécfájlokban deklarált szimbólumokat fogja dokumentálni, "
419 "például nem fog kimenetet előállítani statikus függvényekhez)."
420
421 #. (itstool) path: sect1/para
422 #: C/index.docbook:262
423 msgid ""
424 "GTK-Doc also reads template files where documentation can be added there as "
425 "well."
426 msgstr ""
427 "A GTK-Doc a sablonfájlokat is olvassa, amelyekbe dokumentáció is hozzáadható."
428
429 #. (itstool) path: sect1/para
430 #: C/index.docbook:267
431 #| msgid ""
432 #| "GTK-Doc consists of a number of python scripts, each performing a "
433 #| "different step in the process."
434 msgid ""
435 "GTK-Doc consists of a number of programs, each performing a different step "
436 "in the process."
437 msgstr ""
438 "A GTK-Doc számos programból áll, amelyek mindegyike más-más lépést hajt "
439 "végre a folyamatban."
440
441 #. (itstool) path: sect1/para
442 #: C/index.docbook:272
443 #| msgid "There are 5 main steps in the process:"
444 msgid "The main steps are:"
445 msgstr "A fő lépések a következők:"
446
447 #. (itstool) path: listitem/para
448 #: C/index.docbook:279
449 msgid ""
450 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
451 "source files with the documentation for each function, macro, structs or "
452 "unions, etc."
453 msgstr ""
454 "<guilabel>A dokumentáció megírása.</guilabel> A szerző kitölti a "
455 "forrásfájlokat minden egyes függvény, makró, struktúra, unió és egyéb "
456 "szerkezetek dokumentációjával."
457
458 #. (itstool) path: listitem/para
459 #: C/index.docbook:288
460 msgid ""
461 "<guilabel>Gathering information about the code.</guilabel> "
462 "<application>gtkdoc-scan</application> scans the header files of the code "
463 "looking for declarations of functions, macros, enums, structs, and unions. "
464 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
465 "containing a list of the declarations, placing them into sections according "
466 "to which header file they are in. On the first run this file is copied to "
467 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
468 "the sections, and the order of the declarations within them, to produce the "
469 "final desired order. The second file it generates is "
470 "<filename>&lt;module&gt;-decl.txt</filename>. This file contains the full "
471 "declarations found by the scanner. If for some reason one would like some "
472 "symbols to show up in the docs, where the full declaration cannot be found "
473 "by the scanner or the declaration should appear differently, one can place "
474 "entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> "
475 "into <filename>&lt;module&gt;-overrides.txt</filename>."
476 msgstr ""
477 "<guilabel>Információgyűjtés a kódról.</guilabel> A <application>gtkdoc-scan</"
478 "application> átvizsgálja a kód fejlécfájljait függvények, makrók, "
479 "felsorolások, struktúrák és uniók deklarációit keresve. Létrehozza a "
480 "deklarációk listáját tartalmazó <filename>&lt;modul&gt;-decl-list.txt</"
481 "filename> fájlt, és szakaszokba helyezi azokat aszerint, hogy melyik "
482 "fejlécfájlban vannak. Az első futáskor ez a fájl a <filename>&lt;modul&gt;-"
483 "sections.txt</filename> fájlba lesz másolva. A szerző átrendezheti a "
484 "szakaszokat és az azokon belüli deklarációk sorrendjét, hogy a kívánt végső "
485 "sorrendet állítsa elő. A második fájl, amelyet előállít, a "
486 "<filename>&lt;modul&gt;-decl.txt</filename>. Ez a fájl tartalmazza az "
487 "átvilágító által talált összes deklarációt. Ha valamilyen oknál fogva valaki "
488 "azt szeretné, hogy néhány szimbólum megjelenjen a dokumentációban, ahol a "
489 "teljes deklarációt nem találja meg az átvizsgáló, vagy a deklarációnak "
490 "másképp kellene megjelennie, akkor a <filename>&lt;modul&gt;-decl.txt</"
491 "filename> fájlban lévőhöz hasonló entitásokat helyezhet el a "
492 "<filename>&lt;modul&gt;-overrides.txt</filename> fájlba."
493
494 #. (itstool) path: listitem/para
495 #: C/index.docbook:308
496 msgid ""
497 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
498 "query a library about any GObject subclasses it exports. It saves "
499 "information about each object's position in the class hierarchy and about "
500 "any GObject properties and signals it provides."
501 msgstr ""
502 "A <application>gtkdoc-scangobj</application> arra is használható, hogy "
503 "dinamikusan lekérdezzen egy programkönyvtárat az általa exportált GObject "
504 "alosztályokról. Információt tárol az egyes objektumok osztályhierarchiában "
505 "elfoglalt pozíciójáról, valamint az általa biztosított GObject-"
506 "tulajdonságokról és szignálokról."
507
508 #. (itstool) path: listitem/para
509 #: C/index.docbook:314
510 #| msgid ""
511 #| "<application>gtkdoc-scanobj</application> should not be used anymore. It "
512 #| "was needed in the past when GObject was still GtkObject inside gtk+."
513 msgid ""
514 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
515 "needed in the past when GObject was still GtkObject inside GTK."
516 msgstr ""
517 "A <application>gtkdoc-scanobj</application> függvényt nem szabad többé "
518 "használni. Régebben volt rá szükség, amikor a GObject még GtkObject volt a "
519 "GTK-n belül."
520
521 #. (itstool) path: listitem/para
522 #: C/index.docbook:322
523 #| msgid ""
524 #| "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
525 #| "mkdb</application> turns the template files into XML files in the "
526 #| "<filename class=\"directory\">xml/</filename> subdirectory. If the source "
527 #| "code contains documentation on functions, using the special comment "
528 #| "blocks, it gets merged in here. If there are no tmpl files used it only "
529 #| "reads docs from sources and introspection data."
530 msgid ""
531 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
532 "mkdb</application> turns the template files into XML files in the <filename "
533 "class=\"directory\">xml/</filename> subdirectory. If the source code "
534 "contains documentation for symbols, using the special comment blocks, it "
535 "gets merged in here. If there are no tmpl files used it only reads docs from "
536 "sources and introspection data."
537 msgstr ""
538 "<guilabel>Az XML és a HTML/PDF előállítása.</guilabel> A <application>gtkdoc-"
539 "mkdb</application> átalakítja a sablonfájlokat XML-fájlokká az <filename "
540 "class=\"directory\">xml/</filename> alkönyvtárban. Ha a forráskód tartalmaz "
541 "dokumentációt a szimbólumokhoz a különleges megjegyzésblokkok használatával, "
542 "akkor az beolvasztásra kerül ide. Ha nem használnak tmpl-fájlokat, akkor "
543 "csak a forrásokból és a betekintési adatokból olvassa be a dokumentációt."
544
545 #. (itstool) path: listitem/para
546 #: C/index.docbook:332
547 msgid ""
548 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
549 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
550 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
551 "document called <filename>&lt;package&gt;.pdf</filename>."
552 msgstr ""
553 "A <application>gtkdoc-mkhtml</application> átalakítja az XML-fájlokat HTML-"
554 "fájlokká a <filename class=\"directory\">html/</filename> alkönyvtárban. "
555 "Hasonlóképpen a <application>gtkdoc-mkpdf</application> átalakítja az XML-"
556 "fájlokat <filename>&lt;csomag&gt;.pdf</filename> nevű PDF-dokumentummá."
557
558 #. (itstool) path: listitem/para
559 #: C/index.docbook:339
560 msgid ""
561 "Files in <filename class=\"directory\">xml/</filename> and <filename "
562 "class=\"directory\">html/</filename> directories are always overwritten. One "
563 "should never edit them directly."
564 msgstr ""
565 "Az <filename class=\"directory\">xml/</filename> és a <filename "
566 "class=\"directory\">html/</filename> könyvtárakban lévő fájlok mindig "
567 "felülírásra kerülnek. Soha sem szabad közvetlenül szerkeszteni azokat."
568
569 #. (itstool) path: listitem/para
570 #: C/index.docbook:347
571 #| msgid ""
572 #| "<guilabel>Fixing up cross-references between documents.</guilabel> After "
573 #| "installing the HTML files, <application>gtkdoc-fixxref</application> can "
574 #| "be run to fix up any cross-references between separate documents. For "
575 #| "example, the GTK+ documentation contains many cross-references to types "
576 #| "documented in the GLib manual. When creating the source tarball for "
577 #| "distribution, <application>gtkdoc-rebase</application> turns all external "
578 #| "links into web-links. When installing distributed (pregenerated) docs the "
579 #| "same application will try to turn links back to local links (where those "
580 #| "docs are installed)."
581 msgid ""
582 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
583 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
584 "run to fix up any cross-references between separate documents. For example, "
585 "the GTK documentation contains many cross-references to types documented in "
586 "the GLib manual."
587 msgstr ""
588 "<guilabel>A dokumentumok közötti kereszthivatkozások javítása.</guilabel> A "
589 "HTML-fájlok telepítése után a <application>gtkdoc-fixxref</application> "
590 "futtatható a különálló dokumentumok közötti kereszthivatkozások javításához. "
591 "Például a GTK dokumentáció számos kereszthivatkozást tartalmaz a GLib "
592 "kézikönyvben dokumentált típusokra."
593
594 #. (itstool) path: listitem/para
595 #: C/index.docbook:356
596 #| msgid ""
597 #| "<guilabel>Fixing up cross-references between documents.</guilabel> After "
598 #| "installing the HTML files, <application>gtkdoc-fixxref</application> can "
599 #| "be run to fix up any cross-references between separate documents. For "
600 #| "example, the GTK+ documentation contains many cross-references to types "
601 #| "documented in the GLib manual. When creating the source tarball for "
602 #| "distribution, <application>gtkdoc-rebase</application> turns all external "
603 #| "links into web-links. When installing distributed (pregenerated) docs the "
604 #| "same application will try to turn links back to local links (where those "
605 #| "docs are installed)."
606 msgid ""
607 "When creating the source tarball for distribution, <application>gtkdoc-"
608 "rebase</application> turns all external links into web-links. When "
609 "installing distributed (pregenerated) docs the same application will try to "
610 "turn links back to local links (where those docs are installed)."
611 msgstr ""
612 "A terjesztésre szánt forráscsomag létrehozásakor a <application>gtkdoc-"
613 "rebase</application> az összes külső hivatkozást webes hivatkozásokká "
614 "alakítja. A terjesztett (előre előállított) dokumentumok telepítésekor "
615 "ugyanez az alkalmazás megpróbálja a hivatkozásokat visszaalakítani helyi "
616 "hivatkozásokká (ahová az adott dokumentumok telepítve vannak)."
617
618 #. (itstool) path: sect1/title
619 #: C/index.docbook:369
620 msgid "Getting GTK-Doc"
621 msgstr "A GTK-Doc beszerzése"
622
623 #. (itstool) path: sect2/title
624 #: C/index.docbook:372
625 msgid "Requirements"
626 msgstr "Követelmények"
627
628 #. (itstool) path: sect2/para
629 #: C/index.docbook:373
630 msgid ""
631 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
632 msgstr ""
633 "<guilabel>python 2/3</guilabel> – a fő parancsfájlok Python nyelven lettek "
634 "írva."
635
636 #. (itstool) path: sect2/para
637 #: C/index.docbook:376
638 msgid ""
639 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
640 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
641 msgstr ""
642 "<guilabel>xsltproc</guilabel> – az XSLT-feldolgozó a libxslt csomagból, "
643 "<ulink url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</"
644 "ulink>"
645
646 #. (itstool) path: sect2/para
647 #: C/index.docbook:380
648 msgid ""
649 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
650 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
651 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
652 msgstr ""
653 "<guilabel>docbook-xsl</guilabel> – a Docbook XSL-stíluslapjai, <ulink "
654 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
655 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
656
657 #. (itstool) path: sect2/para
658 #: C/index.docbook:384
659 msgid ""
660 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
661 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
662 "examples"
663 msgstr ""
664 "A <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> vagy "
665 "<guilabel>vim</guilabel> egyike – nem kötelező – a példák szintaxis-"
666 "kiemeléséhez van használva"
667
668 #. (itstool) path: sect1/title
669 #: C/index.docbook:392
670 msgid "About GTK-Doc"
671 msgstr "A GTK-Doc története"
672
673 #. (itstool) path: sect1/para
674 #: C/index.docbook:394
675 msgid ""
676 "Historically GTK-Doc was used to generate template files from the sources "
677 "code. These template files could be used by developers to enter the API "
678 "documentation. This approach was rather inconvenient because it required to "
679 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
680 "possible to place all API information into source comments, which made the "
681 "template support obsolete. In version 1.26 template support has been removed."
682 msgstr ""
683 "Történetileg a GTK-Doc programot arra használták, hogy sablonfájlokat "
684 "állítsanak elő a forráskódból. Ezeket a sablonfájlokat a fejlesztők "
685 "használhatták az API-dokumentáció bevitelére. Ez a megközelítés meglehetősen "
686 "kényelmetlen volt, mivel az előállított fájlokat verziókövetés alatt kellett "
687 "tartani. A GTK-Doc 1.9 óta lehetővé vált, hogy az összes API-információ "
688 "forrásmegjegyzésekbe kerüljön, ami elavulttá tette a sablontámogatást. Az "
689 "1.26-os verzióban a sablontámogatás eltávolításra került."
690
691 #. (itstool) path: sect1/para
692 #: C/index.docbook:404 C/index.docbook:418
693 msgid "(FIXME)"
694 msgstr "(JAVÍTS KI)"
695
696 #. (itstool) path: sect1/para
697 #: C/index.docbook:408
698 msgid ""
699 "(authors, web pages, mailing list, license, future plans, comparison with "
700 "other similar systems.)"
701 msgstr ""
702 "(szerzők, weboldalak, levelezőlista, licenc, jövőbeli tervek, "
703 "összehasonlítás más, hasonló rendszerekkel)"
704
705 #. (itstool) path: sect1/title
706 #: C/index.docbook:416
707 msgid "About this Manual"
708 msgstr "Erről a kézikönyvről"
709
710 #. (itstool) path: sect1/para
711 #: C/index.docbook:422
712 msgid "(who it is meant for, where you can get it, license)"
713 msgstr "(kinek szánják, hol lehet hozzájutni, licenc)"
714
715 #. (itstool) path: chapter/title
716 #: C/index.docbook:431
717 msgid "Project Setup"
718 msgstr "Projekt beállítása"
719
720 #. (itstool) path: chapter/para
721 #: C/index.docbook:433
722 msgid ""
723 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
724 "into your project. The integration of GTK-Doc into a project includes the "
725 "following steps:"
726 msgstr ""
727 "Ez a fejezet azokat a lépéseket írja le, amelyek a GTK-Doc projektbe való "
728 "integrálásához szükségesek. A GTK-Doc projektbe való integrálása a következő "
729 "lépéseket tartalmazza:"
730
731 #. (itstool) path: listitem/para
732 #: C/index.docbook:441
733 msgid ""
734 "Preparation of the directory structure and creating required configuration "
735 "files for your GTK-Doc documentation (see <link "
736 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
737 msgstr ""
738 "A könyvtárszerkezet előkészítése és a GTK-Doc dokumentációhoz szükséges "
739 "beállítási fájlok létrehozása (nézze meg a <link "
740 "linkend=\"settingup_docfiles\">Dokumentációvázlat beállítása</link> "
741 "szakaszt)."
742
743 #. (itstool) path: listitem/para
744 #: C/index.docbook:449
745 msgid ""
746 "Adjusting the build system to build your documentation using the GTK-Doc "
747 "tools. Multiple build systems are supported, in this manual we describe how "
748 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
749 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link "
750 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
751 msgstr ""
752 "Az összeállítási rendszer beállítása a dokumentáció összeállításához a GTK-"
753 "Doc eszközök használatával. Több összeállítási rendszer is támogatott, ebben "
754 "a kézikönyvben azt mutatjuk be, hogy hogyan integrálható a GTK-Doc az <link "
755 "linkend=\"settingup_autotools\">Autotools</link>, a <link "
756 "linkend=\"settingup_cmake\">CMake</link> és az <link "
757 "linkend=\"settingup_plain_makefiles\">egyszerű Makefile</link> megoldásokkal."
758
759 #. (itstool) path: listitem/para
760 #: C/index.docbook:459
761 msgid ""
762 "Adding GTK-Doc specific files to version control and deciding which files to "
763 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
764 "control systems</link>)."
765 msgstr ""
766 "GTK-Doc specifikus fájlok hozzáadása a verziókövetéshez és annak eldöntése, "
767 "hogy mely fájlokat kell figyelmen kívül hagyni (nézze meg az <link "
768 "linkend=\"settingup_vcs\">Integráció verziókövető rendszerekkel</link> "
769 "szakaszt)."
770
771 #. (itstool) path: chapter/para
772 #: C/index.docbook:467
773 msgid ""
774 "The following sections assume we work on a project called <code>meep</code>. "
775 "This project contains two packages (or modules), a library called "
776 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
777 msgstr ""
778 "A következő szakaszok azt feltételezik, hogy egy <code>meep</code> nevű "
779 "projekten dolgozunk. Ez a projekt két csomagot (vagy modult) tartalmaz, egy "
780 "<code>libmeep</code> nevű programkönyvtárat és egy <code>meeper</code> nevű "
781 "végfelhasználói alkalmazást."
782
783 #. (itstool) path: sect1/title
784 #: C/index.docbook:476
785 msgid "Setting up a skeleton documentation"
786 msgstr "Dokumentációvázlat beállítása"
787
788 #. (itstool) path: sect1/para
789 #: C/index.docbook:478
790 msgid ""
791 "A common convention is to place documentation into a folder called "
792 "<code>docs</code> inside your top-level project directory. We usually "
793 "distinguish between <emphasis>reference documentation</emphasis> intended "
794 "for developers and an <emphasis>user manual</emphasis> intended for end-"
795 "users. Again the convention is to have separate folders for both. We usually "
796 "place the reference documentation in a folder named <code>reference</code> "
797 "and the end-user manual in a folder named <code>help</code> as. According to "
798 "the above convention the documentation for our <code>libmeep</code> package "
799 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
800 "just one library or application the documentation could also be placed "
801 "directly into <code>docs/reference</code>. It is not mandatory to use the "
802 "above convention, but if you choose to use a different directory structure "
803 "you must adjust your build system configuration to match your directory "
804 "structure."
805 msgstr ""
806 "Általános gyakorlat, hogy a dokumentáció a <code>docs</code> nevű mappába "
807 "kerül a legfelső szintű projektkönyvtáron belül. Általában különbséget "
808 "teszünk a fejlesztőknek szánt <emphasis>hivatkozási dokumentáció</emphasis> "
809 "és a végfelhasználóknak szánt <emphasis>felhasználói kézikönyv</emphasis> "
810 "között. Megint csak az a gyakorlat, hogy mindkettőhöz külön mappák "
811 "tartoznak. A hivatkozási dokumentációt általában a <code>reference</code> "
812 "nevű mappába, a végfelhasználói kézikönyvet pedig a <code>help</code> nevű "
813 "mappába tesszük. A fenti gyakorlat szerint a <code>libmeep</code> csomagunk "
814 "dokumentációja a következő helyre kerülne: <code>docs/reference/libmeep</"
815 "code>. A csak egy programkönyvtárat vagy alkalmazást tartalmazó csomagok "
816 "esetében a dokumentációt közvetlenül a <code>docs/reference</code> mappában "
817 "is elhelyezhetjük. Nem kötelező a fenti gyakorlatot használni, de ha más "
818 "könyvtárszerkezet használatát választja, akkor a könyvtárszerkezetnek "
819 "megfelelően kell beállítania az összeállítási rendszer beállításait."
820
821 #. (itstool) path: example/title
822 #: C/index.docbook:509
823 msgid "Example directory structure of <emphasis>meep</emphasis> project"
824 msgstr "A <emphasis>meep</emphasis> projekt könyvtárszerkezeti példája"
825
826 #. (itstool) path: example/programlisting
827 #: C/index.docbook:511
828 #, no-wrap
829 msgid ""
830 "\n"
831 "meep/\n"
832 " docs/\n"
833 " reference/ # reference documentation\n"
834 " libmeep/\n"
835 " meeper/\n"
836 " help/ # optional: user manual\n"
837 " meeper/\n"
838 " src/\n"
839 " libmeep/\n"
840 " meeper/\n"
841 msgstr ""
842 "\n"
843 "meep/\n"
844 " docs/\n"
845 " reference/ # hivatkozási dokumentáció\n"
846 " libmeep/\n"
847 " meeper/\n"
848 " help/ # elhagyható: felhasználói kézikönyv\n"
849 " meeper/\n"
850 " src/\n"
851 " libmeep/\n"
852 " meeper/\n"
853
854 #. (itstool) path: sect1/para
855 #: C/index.docbook:503
856 msgid ""
857 "In the following sections we will assume a directory structure for our "
858 "<emphasis>meep</emphasis> project that uses the above conventions. "
859 "<_:example-1/>"
860 msgstr ""
861 "A következő szakaszokban olyan könyvtárszerkezetet feltételezünk a "
862 "<emphasis>meep</emphasis> projektünkhöz, amely a fenti gyakorlatokat "
863 "használja. <_:example-1/>"
864
865 #. (itstool) path: sect1/title
866 #: C/index.docbook:528
867 msgid "Integration with Autotools"
868 msgstr "Integráció az Autotools programmal"
869
870 #. (itstool) path: sect1/para
871 #: C/index.docbook:529
872 msgid ""
873 "Integration of GTK-Doc into an autotools-based build system requires the "
874 "following steps:"
875 msgstr ""
876 "A GTK-Doc integrálása egy autotools alapú összeállítási rendszerbe a "
877 "következő lépéseket igényli:"
878
879 #. (itstool) path: listitem/para
880 #: C/index.docbook:535
881 msgid ""
882 "Ensure that <application>gtkdocize</application> is run once before the "
883 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
884 "script is present, adjust it to check for GTK-Doc and add a call to "
885 "<application>gtkdocize</application>."
886 msgstr ""
887 "Győződjön meg arról, hogy a <application>gtkdocize</application> egyszer "
888 "lefusson a <filename>configure</filename> parancsfájl előtt. Ha egy "
889 "<filename>autogen.sh</filename> parancsfájl is jelen van, akkor állítsa be "
890 "úgy, hogy ellenőrizze a GTK-Doc eszközt, és adjon hozzá egy "
891 "<application>gtkdocize</application> hívást."
892
893 #. (itstool) path: listitem/para
894 #: C/index.docbook:543
895 msgid ""
896 "The main purpose of <application>gtkdocize</application> is to make the "
897 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
898 "filename> macro definition file available to the build system, either by "
899 "copying or linking it into the project."
900 msgstr ""
901 "A <application>gtkdocize</application> fő célja, hogy elkészítse az "
902 "összeállítási rendszerhez elérhető <filename>gtk-doc.make</filename> "
903 "Makefile-t és <filename>gtk-doc.m4</filename> makródefiníciós fájlt a "
904 "projektbe történő másolással vagy a projekthez történő kapcsolással."
905
906 #. (itstool) path: listitem/para
907 #: C/index.docbook:552
908 msgid ""
909 "Add the necessary <application>autoconf</application> macros to "
910 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
911 "allow configuration of GTK-Doc via the generated <filename>configure</"
912 "filename> script."
913 msgstr ""
914 "Adja hozzá a szükséges <application>autoconf</application> makrókat a "
915 "<filename>configure.ac</filename> fájlhoz, hogy engedélyezze a GTK-Doc "
916 "eszközt az összeállítási rendszerben a GTK-Doc beállításainak az előállított "
917 "<filename>configure</filename> parancsfájl általi engedélyezéséhez."
918
919 #. (itstool) path: listitem/para
920 #: C/index.docbook:558
921 msgid ""
922 "Among others with registers the <code>--enable-gtk-doc</code> option with "
923 "the <filename>configure</filename> script."
924 msgstr ""
925 "Többek között a <code>--enable-gtk-doc</code> kapcsoló regisztrálásával a "
926 "<filename>configure</filename> parancsfájlban."
927
928 #. (itstool) path: listitem/para
929 #: C/index.docbook:564
930 msgid ""
931 "Create an <application>automake</application> script for each application or "
932 "library in your project. In the example used in this documentation this step "
933 "applies to both <code>meeper</code> and <code>libmeep</code>."
934 msgstr ""
935 "Hozzon létre egy <application>automake</application> parancsfájlt a projekt "
936 "minden egyes alkalmazásához vagy programkönyvtárához. Az ebben a "
937 "dokumentációban használt példában ez a lépés mind a <code>meeper</code> "
938 "alkalmazásra, mind a <code>libmeep</code> programkönyvtárra vonatkozik."
939
940 #. (itstool) path: sect1/para
941 #: C/index.docbook:573
942 msgid ""
943 "In the following sections, we will perform the above steps in reverse order. "
944 "We start with the <application>automake</application> scripts and work our "
945 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
946 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
947 "build the documentation."
948 msgstr ""
949 "A következő szakaszokban a fenti lépéseket fordított sorrendben hajtjuk "
950 "végre. Az <application>automake</application> parancsfájlokkal kezdjük, és "
951 "folytatjuk a munkát a <filename>configure.ac</filename> és "
952 "<filename>autogen.sh</filename> parancsfájlokig. Ezután megmutatjuk, hogyan "
953 "engedélyezzük a GTK-Doc használatát az összeállítási rendszerben, és hogyan "
954 "állítsuk össze a dokumentációt."
955
956 #. (itstool) path: sect2/title
957 #: C/index.docbook:583
958 msgid "Integration with automake"
959 msgstr "Integráció az automake programmal"
960
961 #. (itstool) path: sect2/para
962 #: C/index.docbook:585
963 msgid ""
964 "First copy the <filename>Makefile.am</filename> from the <filename "
965 "class=\"directory\">examples</filename> sub-directory of the <ulink "
966 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
967 "Makefile.am\"> gtkdoc-sources</ulink> to your project's reference "
968 "documentation directory (e.g. <filename class=\"directory\">docs/reference/"
969 "&lt;package&gt;</filename>). A local copy should be available under e.g. "
970 "<filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If "
971 "you have multiple packages repeat this for each one."
972 msgstr ""
973 "Először másolja át a <filename>Makefile.am</filename> fájlt a <ulink "
974 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
975 "Makefile.am\">gtkdoc-sources</ulink> <filename class=\"directory\">examples</"
976 "filename> alkönyvtárából a projektje hivatkozási dokumentációs könyvtárába "
977 "(például <filename class=\"directory\">docs/reference/&lt;csomag&gt;</"
978 "filename>). Egy helyi másolatnak az <filename>/usr/share/doc/gtk-doc-tools/"
979 "examples/Makefile.am</filename> alatt kell elérhetőnek lennie. Ha több "
980 "csomagja van, akkor ezt ismételje meg mindegyiknél."
981
982 #. (itstool) path: note/simpara
983 #: C/index.docbook:598
984 msgid ""
985 "Do not forget to add each <filename>Makefile.am</filename> to the "
986 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
987 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
988 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
989 "filename> to <function>AC_CONFIG_FILES</function>."
990 msgstr ""
991 "Ne felejtsen el hozzáadni minden <filename>Makefile.am</filename> fájlt az "
992 "<function>AC_CONFIG_FILES</function> makróhoz a <filename>configure.ac</"
993 "filename> fájlban. A <filename>docs/reference/libmeep/Makefile.am</filename> "
994 "esetén a <filename>docs/reference/libmeep/Makefile</filename> bejegyzést "
995 "kell hozzáadnia az <function>AC_CONFIG_FILES</function> makróhoz."
996
997 #. (itstool) path: example/title
998 #: C/index.docbook:610
999 msgid "Example directory structure with <filename>Makefiles.am</filename>"
1000 msgstr "Könyvtárszerkezeti példa a <filename>Makefile.am</filename> fájlokkal"
1001
1002 #. (itstool) path: example/programlisting
1003 #: C/index.docbook:613
1004 #, no-wrap
1005 msgid ""
1006 "\n"
1007 "meep/\n"
1008 " docs/\n"
1009 " reference/ # reference documentation\n"
1010 " libmeep/\n"
1011 " Makefile.am\n"
1012 " meeper/\n"
1013 " Makefile.am\n"
1014 " help/ # optional: user manual\n"
1015 " meeper/\n"
1016 " src/\n"
1017 " libmeep/\n"
1018 " meeper/\n"
1019 msgstr ""
1020 "\n"
1021 "meep/\n"
1022 " docs/\n"
1023 " reference/ # hivatkozási dokumentáció\n"
1024 " libmeep/\n"
1025 " Makefile.am\n"
1026 " meeper/\n"
1027 " Makefile.am\n"
1028 " help/ # elhagyható: felhasználói kézikönyv\n"
1029 " meeper/\n"
1030 " src/\n"
1031 " libmeep/\n"
1032 " meeper/\n"
1033
1034 #. (itstool) path: sect2/para
1035 #: C/index.docbook:629
1036 msgid ""
1037 "Next, you need to customize the copied Makefiles and provide values for the "
1038 "various parameters in each <filename>Makefile.am</filename>. All settings "
1039 "have a comment above them that describes their purpose and how to customize "
1040 "the setting. Most settings are used to supply extra flags to the respective "
1041 "tools to which they apply. Every tool has a variable of the form "
1042 "<option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-"
1043 "mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All "
1044 "the tools support <option>--help</option> to list the supported options."
1045 msgstr ""
1046 "Ezután személyre kell szabnia a lemásolt Makefile-okat, és meg kell adnia a "
1047 "különböző paraméterek értékeit az egyes <filename>Makefile.am</filename> "
1048 "fájlokban. Az összes beállítás fölött található egy megjegyzés, amely leírja "
1049 "a céljukat és a beállítás személyre szabását. A legtöbb beállítás arra "
1050 "szolgál, hogy további jelzőket adjon azokhoz az eszközökhöz, amelyekre "
1051 "vonatkozik. Minden eszköz rendelkezik egy <option>&lt;ESZKÖZNÉV&gt;_OPTIONS</"
1052 "option> formájú változóval (például a <application>gtkdoc-mkhtml</"
1053 "application> eszköznek van egy <code>MKHTML_OPTIONS</code> nevű kapcsolója). "
1054 "Az összes eszköz támogatja a <option>--help</option> kapcsolót a támogatott "
1055 "kapcsolók felsorolásához."
1056
1057 #. (itstool) path: listitem/para
1058 #: C/index.docbook:653
1059 msgid ""
1060 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1061 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1062 msgstr ""
1063 "A <option>DOC_MODULE</option> a dokumentálandó csomag nevének megadására "
1064 "szolgál (például <code>meeper</code> vagy <code>libmeep</code>)."
1065
1066 #. (itstool) path: listitem/para
1067 #: C/index.docbook:660
1068 msgid ""
1069 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1070 "directory which GTK-Doc searches for your API documentation. This will "
1071 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1072 "directory of that directory."
1073 msgstr ""
1074 "A <option>DOC_SOURCE_DIR</option> a forráskönyvtár helyének megadására "
1075 "szolgál, amelyben a GTK-Doc az API dokumentációját keresi. Ez általában a "
1076 "<code>DOC_SOURCE_DIR=$(top_srcdir)/src</code> vagy annak a könyvtárnak az "
1077 "alkönyvtára."
1078
1079 #. (itstool) path: listitem/para
1080 #: C/index.docbook:673
1081 msgid ""
1082 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1083 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$"
1084 "(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
1085 "the matched files change."
1086 msgstr ""
1087 "A <option>HFILE_GLOB</option> és <option>CFILE_GLOB</option> a függőségekhez "
1088 "használatos. Mindkét kapcsoló egy fájl globot vár (például <code>HFILE_GLOB=$"
1089 "(top_srcdir)/src/*.c</code>). A dokumentáció újra összeállításra kerül, ha "
1090 "bármelyik illeszkedő fájl megváltozik."
1091
1092 #. (itstool) path: listitem/para
1093 #: C/index.docbook:685
1094 msgid ""
1095 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1096 "include when scanning for API documentation, which are not found under "
1097 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1098 "extra.h</code>)."
1099 msgstr ""
1100 "Az <option>EXTRA_HFILES</option> lehetővé teszi az API-dokumentáció "
1101 "keresésekor a további beágyazandó fejlécfájlok megadását, amelyek nem "
1102 "találhatók meg a <code>DOC_SOURCE_DIR</code> alatt (például <code> "
1103 "EXTRA_HFILES=$(top_srcdir}/contrib/extra.h</code>)."
1104
1105 #. (itstool) path: listitem/para
1106 #: C/index.docbook:695
1107 msgid ""
1108 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1109 "to ignore when scanning for API documentation. Use the basename of the file "
1110 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1111 "private_code_folder</code>)."
1112 msgstr ""
1113 "Az <option>IGNORE_HFILES</option> lehetővé teszi a figyelmen kívül hagyandó "
1114 "fejlécfájlok vagy könyvtárak megadását az API-dokumentáció keresésekor. "
1115 "Használja a fájl vagy könyvtár alapnevét (például "
1116 "<code>IGNORE_HFILES=gtkdebug.h gtkintl.h személyes_kód_mappa</code>)."
1117
1118 #. (itstool) path: listitem/para
1119 #: C/index.docbook:705
1120 msgid ""
1121 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1122 "copied into the <filename>html/</filename> directory of the generated "
1123 "documentation. If your API documentation includes any images they need to be "
1124 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1125 "stock_about_24.png</code>)."
1126 msgstr ""
1127 "A <option>HTML_IMAGES</option> lehetővé teszi az olyan képfájlok megadását, "
1128 "amelyek az előállított dokumentáció <filename>html/</filename> könyvtárába "
1129 "lesznek másolva. Ha az API-dokumentáció tartalmaz képeket, akkor azokat is "
1130 "hozzá kell adni ehhez a kapcsolóhoz (például <code>HTML_IMAGES=$(top_srcdir)/"
1131 "gtk/stock-icons/stock_about_24.png</code>)."
1132
1133 #. (itstool) path: listitem/para
1134 #: C/index.docbook:718
1135 msgid ""
1136 "<option>content_files</option> allows to specify extra files that are "
1137 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1138 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1139 msgstr ""
1140 "A <option>content_files</option> lehetővé teszi a további fájlok megadását, "
1141 "amelyeket a <code>$(DOC_MAIN_SGML_FILE)</code> beágyaz (például "
1142 "<code>content_files=running.xml building.xml changes-2.0.xml</code>)."
1143
1144 #. (itstool) path: listitem/para
1145 #: C/index.docbook:729
1146 msgid ""
1147 "<option>expand_content_files</option> allows to specify files where "
1148 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1149 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1150 msgstr ""
1151 "Az <option>expand_content_files</option> lehetővé teszi azoknak a fájloknak "
1152 "a megadását, ahol a <emphasis>gtk-doc rövidítések</emphasis> – mint például "
1153 "a <code>#GtkWidget</code> – ki vannak bővítve (például "
1154 "<code>expand_content_files=running.xml</code>)."
1155
1156 #. (itstool) path: sect2/para
1157 #: C/index.docbook:647
1158 msgid ""
1159 "The following list explains the most relevant options. Check the example "
1160 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1161 msgstr ""
1162 "A következő lista a legfontosabb kapcsolókat ismerteti. További kapcsolókért "
1163 "nézze meg a <filename>Makefile.am</filename> példát. <_:itemizedlist-1/>"
1164
1165 #. (itstool) path: sect2/title
1166 #: C/index.docbook:744
1167 msgid "Integration with autoconf"
1168 msgstr "Integráció az autoconf programmal"
1169
1170 #. (itstool) path: sect2/para
1171 #: C/index.docbook:746
1172 msgid ""
1173 "Integration with <application>autoconf</application> is very simple and "
1174 "includes one required step and an additional optional (but recommended) "
1175 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1176 "to your <filename>configure.ac</filename> script. This registers several "
1177 "configure options to enable GTK-Doc and allows you to set default arguments "
1178 "for <application>gtkdocize</application>."
1179 msgstr ""
1180 "Az <application>autoconf</application> programmal való integráció nagyon "
1181 "egyszerű, és egy kötelező, valamint egy további választható (de ajánlott) "
1182 "lépést tartalmaz. Az első lépés a <function>GTK_DOC_CHECK</function> makró "
1183 "hozzáadása a <filename>configure.ac</filename> parancsfájljához. Ez számos "
1184 "beállítási kapcsolót regisztrál a GTK-Doc engedélyezéséhez, és lehetővé "
1185 "teszi a <application>gtkdocize</application> alapértelmezett argumentumainak "
1186 "beállítását."
1187
1188 #. (itstool) path: warning/simpara
1189 #: C/index.docbook:758
1190 msgid ""
1191 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1192 "macro must start at the beginning of the line and should not start with "
1193 "whitespace."
1194 msgstr ""
1195 "Győződjön meg arról, hogy a <code>GTK_DOC_CHECK</code> makró ne legyen "
1196 "behúzva. A makrónak a sor elején kell kezdődnie, és nem kezdődhet üres "
1197 "karakterekkel."
1198
1199 #. (itstool) path: sect2/para
1200 #: C/index.docbook:765
1201 msgid ""
1202 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1203 "<filename>configure.ac</filename>. This is not required but helps "
1204 "<application>gtkdocize</application> to automatically copy the macro "
1205 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1206 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1207 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1208 "to explicitly tell the <application>aclocal</application> tool where to find "
1209 "the macro definition file."
1210 msgstr ""
1211 "A második lépés az <code>AC_CONFIG_MACRO_DIR(m4)</code> hozzáadása a "
1212 "<filename>configure.ac</filename> parancsfájljához. Ez nem kötelező, de "
1213 "segít a <application>gtkdocize</application> eszköznek abban, hogy azt a "
1214 "makródefiníciót (például <filename>gtk-doc.m4</filename>), amely a "
1215 "<function>GTK_DOC_CHECK</function> makrót tartalmazza, automatikusan a "
1216 "projektje makrókönyvtárába másolja. Enélkül előfordulhat, hogy a "
1217 "GTK_DOC_CHECK makrót nem találja meg, és kifejezetten meg kell mondania az "
1218 "<application>aclocal</application> eszköznek, hogy hol találja meg a "
1219 "makródefiníciós fájlt."
1220
1221 #. (itstool) path: example/title
1222 #: C/index.docbook:778
1223 msgid "Minimal integration with autoconf"
1224 msgstr "Minimális integráció az autoconf programmal"
1225
1226 #. (itstool) path: example/programlisting
1227 #: C/index.docbook:779
1228 #, no-wrap
1229 msgid ""
1230 "\n"
1231 "# recommended: set m4 directory\n"
1232 "AC_CONFIG_MACRO_DIR(m4)\n"
1233 "# optional: register gtk-doc in configure\n"
1234 "GTK_DOC_CHECK([1.28])\n"
1235 msgstr ""
1236 "\n"
1237 "# ajánlott: az m4 könyvtár beállítása\n"
1238 "AC_CONFIG_MACRO_DIR(m4)\n"
1239 "# elhagyható: a gtk-doc regisztrálása a configure fájlban\n"
1240 "GTK_DOC_CHECK([1.28])\n"
1241
1242 #. (itstool) path: example/title
1243 #: C/index.docbook:794
1244 msgid "Integration with optional gtk-doc dependency"
1245 msgstr "Integráció a választható gtk-doc függőséggel"
1246
1247 #. (itstool) path: example/programlisting
1248 #: C/index.docbook:795
1249 #, no-wrap
1250 msgid ""
1251 "\n"
1252 "m4_ifdef([GTK_DOC_CHECK], [\n"
1253 "# recommended: set m4 directory\n"
1254 "AC_CONFIG_MACRO_DIR(m4)\n"
1255 "# optional: register gtk-doc in configure\n"
1256 "GTK_DOC_CHECK([1.28])\n"
1257 "],[\n"
1258 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1259 "])\n"
1260 msgstr ""
1261 "\n"
1262 "m4_ifdef([GTK_DOC_CHECK], [\n"
1263 "# ajánlott: az m4 könyvtár beállítása\n"
1264 "AC_CONFIG_MACRO_DIR(m4)\n"
1265 "# elhagyható: a gtk-doc regisztrálása a configure fájlban\n"
1266 "GTK_DOC_CHECK([1.28])\n"
1267 "],[\n"
1268 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1269 "])\n"
1270
1271 #. (itstool) path: sect2/para
1272 #: C/index.docbook:788
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 "A fenti példa működik, de minden fejlesztőtől megköveteli a gtk-doc "
1279 "telepítését. Jobb megoldás, ha a dokumentáció összeállítását nem tesszük "
1280 "kötelezővé, ahogy a következő példában látható: <_:example-1/>"
1281
1282 #. (itstool) path: sect2/para
1283 #: C/index.docbook:808
1284 msgid ""
1285 "The first argument is used to check for the Gtk-Doc version at configure "
1286 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1287 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1288 "configure switches:"
1289 msgstr ""
1290 "Az első argumentum a GTK-Doc verziójának ellenőrzésére szolgál a "
1291 "beállításkor. A második, nem kötelező argumentumot a <application>gtkdocize</"
1292 "application> használja. A <symbol>GTK_DOC_CHECK</symbol> makró számos "
1293 "beállítási kapcsolót is hozzáad:"
1294
1295 #. (itstool) path: listitem/para
1296 #: C/index.docbook:817
1297 msgid "--with-html-dir=PATH : path to installed docs"
1298 msgstr "--with-html-dir=PATH : útvonal a telepített dokumentációkhoz"
1299
1300 #. (itstool) path: listitem/para
1301 #: C/index.docbook:818
1302 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1303 msgstr ""
1304 "--enable-gtk-doc : a gtk-doc használata a dokumentáció összeállításához "
1305 "[alapértelmezett=nem]"
1306
1307 #. (itstool) path: listitem/para
1308 #: C/index.docbook:819
1309 msgid ""
1310 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1311 msgstr ""
1312 "--enable-gtk-doc-html : dokumentáció összeállítása HTML formátumban "
1313 "[alapértelmezett=igen]"
1314
1315 #. (itstool) path: listitem/para
1316 #: C/index.docbook:820
1317 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1318 msgstr ""
1319 "--enable-gtk-doc-pdf : dokumentáció összeállítása PDF formátumban "
1320 "[alapértelmezett=nem]"
1321
1322 #. (itstool) path: important/para
1323 #: C/index.docbook:824
1324 msgid ""
1325 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1326 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1327 "Otherwise pregenerated documentation is installed (which makes sense for "
1328 "users but not for developers)."
1329 msgstr ""
1330 "A GTK-Doc alapértelmezetten le van tiltva! Ne felejtse el átadni az "
1331 "<option>--enable-gtk-doc</option> kapcsolót a következő <filename>configure</"
1332 "filename> futtatásához. Egyébként előre előállított dokumentáció kerül "
1333 "telepítésre (aminek a felhasználók számára van értelme, de a fejlesztők "
1334 "számára nincs)."
1335
1336 #. (itstool) path: sect2/para
1337 #: C/index.docbook:832
1338 msgid ""
1339 "After all changes to <filename>configure.ac</filename> are made, update the "
1340 "<filename>configure</filename> file. This can be done by re-running "
1341 "<code>autogen.sh</code>."
1342 msgstr ""
1343 "Miután a <filename>configure.ac</filename> fájl összes módosítása "
1344 "megtörtént, frissítse a <filename>configure</filename> fájlt. Ezt az "
1345 "<code>autogen.sh</code> újbóli futtatásával lehet megtenni."
1346
1347 #. (itstool) path: sect2/title
1348 #: C/index.docbook:840
1349 msgid "Integration with autogen"
1350 msgstr "Integráció az autogen programmal"
1351
1352 #. (itstool) path: sect2/para
1353 #: C/index.docbook:842
1354 msgid ""
1355 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1356 "the build infrastructure after the project was checked out from a version "
1357 "control system (such as git or svn). GTK-Doc comes with a script called "
1358 "<application>gtkdocize</application> which can be used to copy the necessary "
1359 "files needed by Gtk-Doc to the source directory."
1360 msgstr ""
1361 "A legtöbb projekt rendelkezik <filename>autogen.sh</filename> parancsfájllal "
1362 "az összeállítási infrastruktúra beállításához, miután a projektet lekérték "
1363 "egy verziókövető rendszerből (például git vagy svn). A GTK-Doc egy "
1364 "<application>gtkdocize</application> nevű parancsfájllal érkezik, amely arra "
1365 "használható, hogy a GTK-Doc számára szükséges fájlokat a forráskönyvtárba "
1366 "másolja."
1367
1368 #. (itstool) path: sect2/para
1369 #: C/index.docbook:850
1370 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1371 msgstr ""
1372 "Ezt az autoreconf, autoheader, automake vagy autoconf előtt kell futtatni."
1373
1374 #. (itstool) path: example/title
1375 #: C/index.docbook:855
1376 msgid "Running gtkdocize from autogen.sh"
1377 msgstr "A gtkdocize futtatása az autogen.sh fájlból"
1378
1379 #. (itstool) path: example/programlisting
1380 #: C/index.docbook:856
1381 #, no-wrap
1382 msgid ""
1383 "\n"
1384 "gtkdocize || exit 1\n"
1385 msgstr ""
1386 "\n"
1387 "gtkdocize || exit 1\n"
1388
1389 #. (itstool) path: example/title
1390 #: C/index.docbook:864
1391 msgid "Conditionally run gtkdocize from autogen.sh"
1392 msgstr "A gtkdocize feltételes futtatása az autogen.sh fájlból"
1393
1394 #. (itstool) path: example/programlisting
1395 #: C/index.docbook:865
1396 #, no-wrap
1397 msgid ""
1398 "\n"
1399 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1400 "if test $? -ne 0; then\n"
1401 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1402 "else\n"
1403 " $GTKDOCIZE || exit 1\n"
1404 "fi\n"
1405 msgstr ""
1406 "\n"
1407 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1408 "if test $? -ne 0; then\n"
1409 " echo \"Nem található gtk-doc támogatás. Nem állítható össze a dokumentáció.\"\n"
1410 "else\n"
1411 " $GTKDOCIZE || exit 1\n"
1412 "fi\n"
1413
1414 #. (itstool) path: sect2/para
1415 #: C/index.docbook:876
1416 msgid ""
1417 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1418 "doc.make</filename> to your project root (or any directory specified by the "
1419 "<option>--docdir</option> option)."
1420 msgstr ""
1421 "A <application>gtkdocize</application> futtatásakor átmásolja a "
1422 "<filename>gtk-doc.make</filename> fájlt a projektje gyökerébe (vagy a "
1423 "<option>--docdir</option> kapcsolóval megadott bármely könyvtárba)."
1424
1425 #. (itstool) path: sect2/para
1426 #: C/index.docbook:882
1427 msgid ""
1428 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1429 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1430 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1431 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1432 "<function>GTK_DOC_CHECK</function> macro."
1433 msgstr ""
1434 "A <application>gtkdocize</application> átnézi a <filename>configure.ac</"
1435 "filename> parancsfájlt a <function>GTK_DOC_CHECK</function> makrót keresve. "
1436 "A <function>GTK_DOC_CHECK</function> makró használható további argumentumok "
1437 "átadásához a <application>gtkdocize</application> parancsfájl számára. A "
1438 "második paraméter a <function>GTK_DOC_CHECK</function> makróban."
1439
1440 #. (itstool) path: sect2/para
1441 #: C/index.docbook:891
1442 msgid ""
1443 "Alternatively, additional arguments can also be passed to "
1444 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1445 "function> environment variable, or by directly specifying them to "
1446 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1447 msgstr ""
1448 "Másik lehetőségként további argumentumok is átadhatók a "
1449 "<application>gtkdocize</application> makrónak a <function>GTKDOCIZE_FLAGS</"
1450 "function> környezeti változón keresztül, vagy közvetlenül megadva azokat a "
1451 "<application>gtkdocize</application> számára az <filename>autogen.sh</"
1452 "filename> fájlban."
1453
1454 #. (itstool) path: sect2/title
1455 #: C/index.docbook:902
1456 msgid "Executing GTK-Doc from the Build System"
1457 msgstr "A GTK-Doc végrehajtása az összeállítási rendszerből"
1458
1459 #. (itstool) path: sect2/para
1460 #: C/index.docbook:904
1461 msgid ""
1462 "After the previous steps it's time to run the build. First we need to rerun "
1463 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1464 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1465 "<filename>configure</filename> with this option afterwards."
1466 msgstr ""
1467 "Az előző lépések után itt az ideje az összeállítás futtatásának. Először az "
1468 "<filename>autogen.sh</filename> ismételt futtatása szükséges. Ha ez a "
1469 "parancsfájl futtatja a configure fájlt, akkor adja meg neki az <option>--"
1470 "enable-gtk-doc</option> kapcsolót. Ellenkező esetben futtassa kézzel a "
1471 "<filename>configure</filename> fájlt utólag ezzel a kapcsolóval."
1472
1473 #. (itstool) path: sect2/para
1474 #: C/index.docbook:911
1475 msgid ""
1476 "The first make run generates several additional files in the doc-"
1477 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1478 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1479 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1480 msgstr ""
1481 "A make első futtatása számos további fájlt állít elő a dokumentációs "
1482 "könyvtárakban. A legfontosabbak a következők: "
1483 "<filename>&lt;csomag&gt;.types</filename>, <filename>&lt;csomag&gt;-"
1484 "docs.xml</filename> (régebben .sgml), <filename>&lt;csomag&gt;-sections.txt</"
1485 "filename>."
1486
1487 #. (itstool) path: example/title
1488 #: C/index.docbook:919
1489 msgid "Running the doc build"
1490 msgstr "A dokumentáció összeállításának futtatása"
1491
1492 #. (itstool) path: example/programlisting
1493 #: C/index.docbook:920
1494 #, no-wrap
1495 msgid ""
1496 "\n"
1497 "./autogen.sh --enable-gtk-doc\n"
1498 "make\n"
1499 msgstr ""
1500 "\n"
1501 "./autogen.sh --enable-gtk-doc\n"
1502 "make\n"
1503
1504 #. (itstool) path: sect2/para
1505 #: C/index.docbook:927
1506 msgid ""
1507 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1508 "index.html</filename>. With this initial setup you will only see a very "
1509 "simple document. The next chapter will teach you how to add API "
1510 "documentation to your code via special comment blocks. The Chapter "
1511 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1512 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1513 "template</link> to add additional chapters and sections to your "
1514 "documentation files."
1515 msgstr ""
1516 "Most nyissa meg a böngészőjével a <filename>docs/reference/&lt;csomag&gt;/"
1517 "index.html</filename> fájlt. Ezzel a kezdeti beállítással csak egy nagyon "
1518 "egyszerű dokumentumot fog látni. A következő fejezetben megtanítjuk, hogyan "
1519 "adhat API-dokumentációt a kódjához a különleges megjegyzésblokkok "
1520 "segítségével. A fejezet ezt követően bemutatja a <link "
1521 "linkend=\"metafiles\">további fájlokat</link>, és megmutatja, hogyan "
1522 "szerkesztheti a <link linkend=\"metafiles_master\">mestersablont</link>, "
1523 "hogy további fejezeteket és szakaszokat adjon a dokumentációs fájljaihoz."
1524
1525 #. (itstool) path: sect1/title
1526 #: C/index.docbook:943
1527 msgid "Integration with CMake build systems"
1528 msgstr "Integráció a CMake összeállítási rendszerekkel"
1529
1530 #. (itstool) path: sect1/para
1531 #: C/index.docbook:945
1532 msgid ""
1533 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1534 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1535 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1536 "set in your <filename>CMakeLists.txt</filename> file."
1537 msgstr ""
1538 "A GTK-Doc mostantól biztosít egy <filename>GtkDocConfig.cmake</filename> "
1539 "modult (és a megfelelő <filename>GtkDocConfigVersion.cmake</filename> "
1540 "modult). Ez biztosít egy <literal>gtk_doc_add_module</literal> parancsot, "
1541 "amelyet beállíthat a <filename>CMakeLists.txt</filename> fájlban."
1542
1543 #. (itstool) path: example/title
1544 #: C/index.docbook:955
1545 msgid "Example of using GTK-Doc from CMake"
1546 msgstr "Példa a GTK-Doc CMake-ből való használatára"
1547
1548 #. (itstool) path: example/programlisting
1549 #: C/index.docbook:956
1550 #, no-wrap
1551 msgid ""
1552 "\n"
1553 "find_package(GtkDoc 1.25 REQUIRED)\n"
1554 "\n"
1555 "# Create the doc-libmeep target.\n"
1556 "gtk_doc_add_module(\n"
1557 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1558 " XML meep-docs.xml\n"
1559 " LIBRARIES libmeep\n"
1560 ")\n"
1561 "\n"
1562 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1563 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1564 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1565 "\n"
1566 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1567 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1568 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1569 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1570 msgstr ""
1571 "\n"
1572 "find_package(GtkDoc 1.25 REQUIRED)\n"
1573 "\n"
1574 "# A doc-libmeep cél létrehozása.\n"
1575 "gtk_doc_add_module(\n"
1576 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1577 " XML meep-docs.xml\n"
1578 " LIBRARIES libmeep\n"
1579 ")\n"
1580 "\n"
1581 "# A doc-libmeep összeállítása az alapértelmezett cél részeként. Enélkül\n"
1582 "# kifejezetten futtatni kellene valami olyasmit, mint a „make doc-libmeep”\n"
1583 "# a dokumentáció összeállításához.add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1584 "\n"
1585 "# A dokumentáció telepítése (ez azt feltételezi, hogy a GNUInstallDirs CMake\n"
1586 "# modulját használja a CMAKE_INSTALL_DOCDIR változó helyes beállításához).\n"
1587 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1588 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1589
1590 #. (itstool) path: sect1/para
1591 #: C/index.docbook:953
1592 msgid "The following example shows how to use this command. <_:example-1/>"
1593 msgstr ""
1594 "A következő példa azt mutatja be, hogy hogyan kell használni ezt a "
1595 "parancsot. <_:example-1/>"
1596
1597 #. (itstool) path: sect1/title
1598 #: C/index.docbook:980
1599 msgid "Integration with plain makefiles or other build systems"
1600 msgstr ""
1601 "Integráció egyszerű makefile-okkal vagy egyéb összeállítási rendszerekkel"
1602
1603 #. (itstool) path: sect1/para
1604 #: C/index.docbook:982
1605 msgid ""
1606 "In the case one does not want to use automake and therefore <filename>gtk-"
1607 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1608 "in own makefiles (or other build tools)."
1609 msgstr ""
1610 "Abban az esetben, ha valaki nem szeretné az automake és ezáltal a "
1611 "<filename>gtk-doc.mak</filename> használatát, akkor a gtkdoc eszközöket a "
1612 "megfelelő sorrendben kell meghívni a saját makefile-okban (vagy más "
1613 "összeállítási eszközökben)."
1614
1615 #. (itstool) path: example/title
1616 #: C/index.docbook:989
1617 msgid "Documentation build steps"
1618 msgstr "Dokumentáció összeállítási lépései"
1619
1620 #. (itstool) path: example/programlisting
1621 #: C/index.docbook:990
1622 #, no-wrap
1623 msgid ""
1624 "\n"
1625 "DOC_MODULE=meep\n"
1626 "// sources have changed\n"
1627 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1628 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1629 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1630 "// xml files have changed\n"
1631 "mkdir html\n"
1632 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1633 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1634 msgstr ""
1635 "\n"
1636 "DOC_MODULE=meep\n"
1637 "// források megváltoztak\n"
1638 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1639 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1640 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1641 "// XML-fájlok megváltoztak\n"
1642 "mkdir html\n"
1643 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1644 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1645
1646 #. (itstool) path: sect1/para
1647 #: C/index.docbook:1004
1648 msgid ""
1649 "One will need to look at the <filename>Makefile.am</filename> and "
1650 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1651 msgstr ""
1652 "Meg kell nézni a <filename>Makefile.am</filename> és a <filename>gtk-"
1653 "doc.mak</filename> fájlokat a szükséges további kapcsolók kiválasztásához."
1654
1655 #. (itstool) path: sect1/title
1656 #: C/index.docbook:1011
1657 msgid "Integration with version control systems"
1658 msgstr "Integráció verziókövető rendszerekkel"
1659
1660 #. (itstool) path: sect1/para
1661 #: C/index.docbook:1013
1662 msgid ""
1663 "As a rule of thumb, it's the files you edit which should go under version "
1664 "control. For typical projects it's these files: "
1665 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1666 "docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-"
1667 "sections.txt</filename>, <filename>Makefile.am</filename>."
1668 msgstr ""
1669 "Ökölszabályként a szerkesztett fájloknak kell verziókövetés alá kerülniük. "
1670 "Tipikus projektek esetén ezek a következő fájlok: "
1671 "<filename>&lt;csomag&gt;.types</filename>, <filename>&lt;csomag&gt;-"
1672 "docs.xml</filename> (régebben .sgml), <filename>&lt;csomag&gt;-sections.txt</"
1673 "filename>, <filename>Makefile.am</filename>."
1674
1675 #. (itstool) path: sect1/para
1676 #: C/index.docbook:1021
1677 msgid ""
1678 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1679 "directories should not go under version control. Neither should any of the "
1680 "<filename>.stamp</filename> files."
1681 msgstr ""
1682 "Az <filename>xml/</filename> és a <filename>html/</filename> könyvtárakban "
1683 "lévő fájlok nem kerülhetnek verziókövetés alá. A <filename>.stamp</filename> "
1684 "fájlok egyikének sem kellene."
1685
1686 #. (itstool) path: chapter/title
1687 #: C/index.docbook:1031
1688 msgid "Documenting the code"
1689 msgstr "A kód dokumentálása"
1690
1691 #. (itstool) path: chapter/para
1692 #: C/index.docbook:1033
1693 msgid ""
1694 "GTK-Doc uses source code comment with a special syntax for code "
1695 "documentation. Further it retrieves information about your project structure "
1696 "from other sources. During the next section you will find all information "
1697 "about the syntax of the comments."
1698 msgstr ""
1699 "A GTK-Doc a forráskód különleges szintaxisú megjegyzéseit használja a kód "
1700 "dokumentációjához. Továbbá információkat szerez a projekt szerkezetéről más "
1701 "forrásokból. A következő szakaszban minden információt megtalál a "
1702 "megjegyzések szintaxisáról."
1703
1704 #. (itstool) path: example/title
1705 #: C/index.docbook:1044 C/index.docbook:1070
1706 msgid "GTK-Doc comment block"
1707 msgstr "GTK-Doc megjegyzésblokk"
1708
1709 #. (itstool) path: example/programlisting
1710 #: C/index.docbook:1045
1711 #, no-wrap
1712 msgid ""
1713 "\n"
1714 "#ifndef __GTK_DOC_IGNORE__\n"
1715 "/* unparseable code here */\n"
1716 "#endif\n"
1717 msgstr ""
1718 "\n"
1719 "#ifndef __GTK_DOC_IGNORE__\n"
1720 "/* feldolgozhatatlan kód itt */\n"
1721 "#endif\n"
1722
1723 #. (itstool) path: chapter/para
1724 #: C/index.docbook:1040
1725 msgid ""
1726 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1727 "of receiving warnings from the scanner that look like a special case, one "
1728 "can hint GTK-Doc to skip over them. <_:example-1/>"
1729 msgstr ""
1730 "A GTK-Doc átvizsgáló a C fejlécek többségét jól tudja kezelni. Abban az "
1731 "esetben, ha az átvizsgálótól olyan figyelmeztetések érkeznek, amelyek "
1732 "különleges esetnek tűnnek, a GTK-Doc eszköznek jelezni lehet, hogy hagyja ki "
1733 "azokat. <_:example-1/>"
1734
1735 #. (itstool) path: note/title
1736 #: C/index.docbook:1054
1737 msgid "Limitations"
1738 msgstr "Korlátozások"
1739
1740 #. (itstool) path: note/para
1741 #: C/index.docbook:1055
1742 msgid ""
1743 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1744 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1745 msgstr ""
1746 "Ne feledje, hogy a GTK-Doc az <code>#ifndef(__GTK_DOC_IGNORE__)</code> "
1747 "megadást támogatja, de az <code>#if !defined(__GTK_DOC_IGNORE__)</code> vagy "
1748 "egyéb kombinációkat nem."
1749
1750 #. (itstool) path: sect1/title
1751 #: C/index.docbook:1065
1752 msgid "Documentation comments"
1753 msgstr "Dokumentációs megjegyzések"
1754
1755 #. (itstool) path: example/programlisting
1756 #: C/index.docbook:1071
1757 #, no-wrap
1758 msgid ""
1759 "\n"
1760 "/**\n"
1761 " * identifier:\n"
1762 " * documentation ...\n"
1763 " */\n"
1764 msgstr ""
1765 "\n"
1766 "/**\n"
1767 " * azonosító:\n"
1768 " * dokumentáció ...\n"
1769 " */\n"
1770
1771 #. (itstool) path: sect1/para
1772 #: C/index.docbook:1067
1773 msgid ""
1774 "A multiline comment that starts with an additional '*' marks a documentation "
1775 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1776 msgstr ""
1777 "Egy további „*” karakterrel kezdődő többsoros megjegyzés olyan dokumentációs "
1778 "blokkot jelöl, amelyet a GTK-Doc eszközök feldolgoznak. <_:example-1/>"
1779
1780 #. (itstool) path: sect1/para
1781 #: C/index.docbook:1080
1782 msgid ""
1783 "The 'identifier' is one line with the name of the item the comment is "
1784 "related to. The syntax differs a little depending on the item. (TODO add "
1785 "table showing identifiers)"
1786 msgstr ""
1787 "Az „azonosító” egy sorban tartalmazza annak az elemnek a nevét, amelyhez a "
1788 "megjegyzés kapcsolódik. A szintaxis az elemtől függően némileg eltér. "
1789 "(TEENDŐ: az azonosítókat megjelenítő táblázat hozzáadása)"
1790
1791 #. (itstool) path: sect1/para
1792 #: C/index.docbook:1086
1793 msgid ""
1794 "The 'documentation' block is also different for each symbol type. Symbol "
1795 "types that get parameters such as functions or macros have the parameter "
1796 "description first followed by a blank line (just a '*'). Afterwards follows "
1797 "the detailed description. All lines (outside program listings and CDATA "
1798 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1799 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1800 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1801 msgstr ""
1802 "A „dokumentáció” blokk szintén különbözik az egyes szimbólumtípusoknál. A "
1803 "paramétereket kapó szimbólumtípusoknál, mint például a függvények vagy "
1804 "makrók, a paraméter leírása az első, amit egy üres sor követ (csak egy „*”). "
1805 "Ezután következik a részletes leírás. Az összes olyan sor (a programlistákon "
1806 "és a CDATA szakaszokon kívül), amely csak „ *” karaktereket (üres helyet és "
1807 "csillagot) tartalmaz, bekezdéstörésekké lesznek átalakítva. Ha nem szeretne "
1808 "bekezdéstörést, akkor változtassa át „ * ” karaktersorozatra (üres hely, "
1809 "csillag, üres hely, üres hely). Ez hasznos az előformázott szövegnél "
1810 "(kódlistáknál)."
1811
1812 #. (itstool) path: listitem/para
1813 #: C/index.docbook:1103
1814 msgid ""
1815 "What it is: The name for a class or function can sometimes be misleading for "
1816 "people coming from a different background."
1817 msgstr ""
1818 "Mi ez: egy osztály vagy funkció neve néha félrevezető lehet a más háttérrel "
1819 "érkezők számára."
1820
1821 #. (itstool) path: listitem/para
1822 #: C/index.docbook:1109
1823 msgid ""
1824 "What it does: Tell about common uses. Put it in relation with the other API."
1825 msgstr ""
1826 "Mit csinál: mondja el a gyakori használatot, helyezze kapcsolatba a többi "
1827 "API-val."
1828
1829 #. (itstool) path: tip/para
1830 #: C/index.docbook:1099
1831 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1832 msgstr "A kód dokumentálásakor két szempontot kell leírni: <_:itemizedlist-1/>"
1833
1834 #. (itstool) path: listitem/para
1835 #: C/index.docbook:1124
1836 msgid "Use function() to refer to functions or macros which take arguments."
1837 msgstr ""
1838 "Használja a függvény() jelölést az olyan függvényekre vagy makrókra való "
1839 "hivatkozáshoz, amelyek argumentumokat fogadnak el."
1840
1841 #. (itstool) path: listitem/para
1842 #: C/index.docbook:1129
1843 msgid ""
1844 "Use @param to refer to parameters. Also use this when referring to "
1845 "parameters of other functions, related to the one being described."
1846 msgstr ""
1847 "Használja a @paraméter jelölést a paraméterekre való hivatkozáshoz. Akkor is "
1848 "használja, ha más függvények paramétereire hivatkozik, amelyek a leírtakhoz "
1849 "kapcsolódnak."
1850
1851 #. (itstool) path: listitem/para
1852 #: C/index.docbook:1135
1853 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1854 msgstr ""
1855 "Használja a %konstans jelölést egy konstansra való hivatkozáshoz, például "
1856 "%G_TRAVERSE_LEAFS."
1857
1858 #. (itstool) path: listitem/para
1859 #: C/index.docbook:1140
1860 msgid ""
1861 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1862 "macros which don't take arguments."
1863 msgstr ""
1864 "Használja a #szimbólum jelölést más típusú szimbólumokra, például "
1865 "struktúrákra, felsorolásokra és olyan makrókra, amelyek nem fogadnak el "
1866 "argumentumokat."
1867
1868 #. (itstool) path: listitem/para
1869 #: C/index.docbook:1146
1870 msgid "Use #Object::signal to refer to a GObject signal."
1871 msgstr ""
1872 "Használja az #Objektum::szignál jelölést egy GObject szignálra való "
1873 "hivatkozáshoz."
1874
1875 #. (itstool) path: listitem/para
1876 #: C/index.docbook:1151
1877 msgid "Use #Object:property to refer to a GObject property."
1878 msgstr ""
1879 "Használja az #Objektum:tulajdonság jelölést egy GObject tulajdonságra való "
1880 "hivatkozáshoz."
1881
1882 #. (itstool) path: listitem/para
1883 #: C/index.docbook:1156
1884 msgid ""
1885 "Use #Struct.field to refer to a field inside a structure and "
1886 "#GObjectClass.foo_bar() to refer to a vmethod."
1887 msgstr ""
1888 "Használja a #Struktúra.mező jelölést egy struktúrán belüli mezőre való "
1889 "hivatkozáshoz, és a #GObjectClass.foo_bar() jelölést egy virtuális metódusra "
1890 "való hivatkozáshoz."
1891
1892 #. (itstool) path: sect1/para
1893 #: C/index.docbook:1118
1894 msgid ""
1895 "One advantage of hyper-text over plain-text is the ability to have links in "
1896 "the document. Writing the correct markup for a link can be tedious though. "
1897 "GTK-Doc comes to help by providing several useful abbreviations. "
1898 "<_:itemizedlist-1/>"
1899 msgstr ""
1900 "A hiperszöveg egyik előnye az egyszerű szöveggel szemben az, hogy a "
1901 "dokumentumban hivatkozások is lehetnek. Egy hivatkozás megfelelő jelölésének "
1902 "megírása azonban fárasztó lehet. A GTK-Doc számos hasznos rövidítéssel segít "
1903 "ebben. <_:itemizedlist-1/>"
1904
1905 #. (itstool) path: tip/para
1906 #: C/index.docbook:1165
1907 msgid ""
1908 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1909 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1910 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", "
1911 "\"&amp;commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape "
1912 "them with a backslash '\\'."
1913 msgstr ""
1914 "Ha különleges karaktereket („&lt;”, „&gt;”, „(”, „)”, „@”, „%” vagy „#”) "
1915 "kell használnia a dokumentációban anélkül, hogy a GTK-Doc megváltoztatná "
1916 "azokat, használhatja az XML-entitásukat („&amp;lt;”, „&amp;gt;”, "
1917 "„&amp;lpar;”, „&amp;rpar;”, „&amp;commat;”, „&amp;percnt;” vagy „&amp;num;”) "
1918 "a fentieknek megfelelően vagy elfedheti azokat egy visszafelé mutató "
1919 "perjellel („\\”)."
1920
1921 #. (itstool) path: sect1/para
1922 #: C/index.docbook:1174
1923 msgid ""
1924 "DocBook can do more than just links. One can also have lists, examples, "
1925 "headings, and images. As of version 1.20, the preferred way is to use a "
1926 "subset of the basic text formatting syntax called <ulink url=\"http://"
1927 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1928 "versions any documentation that includes Markdown will be rendered as is. "
1929 "For example, list items will appear as lines starting with a dash."
1930 msgstr ""
1931 "A DocBook többre is képes a hivatkozásoknál. Lehetnek benne listák, példák, "
1932 "címsorok és képek is. Az 1.20-as verziótól kezdve az előnyben részesített "
1933 "mód a <ulink url=\"http://daringfireball.net/projects/markdown/\">Markdown</"
1934 "ulink> nevű alapvető szövegformázási szintaxis egy részhalmazának "
1935 "használata. A régebbi GTK-Doc verziókban minden olyan dokumentáció, amely "
1936 "Markdown formátumot tartalmaz, úgy lesz megjelenítve, ahogy van. Például a "
1937 "listaelemek kötőjellel kezdődő sorokként jelennek meg."
1938
1939 #. (itstool) path: sect1/para
1940 #: C/index.docbook:1185
1941 msgid ""
1942 "While markdown is now preferred one can mix both. One limitation here is "
1943 "that one can use docbook xml within markdown, but markdown within docbook "
1944 "xml is not supported."
1945 msgstr ""
1946 "Míg a Markdown most előnyben részesített, mindkettőt lehet vegyesen "
1947 "használni. Az egyik korlátozás az, hogy a DocBook XML használható a Markdown "
1948 "jelölésen belül, de a Markdown a DocBook XML-en belül nem támogatott."
1949
1950 #. (itstool) path: sect1/para
1951 #: C/index.docbook:1191
1952 msgid ""
1953 "In older GTK-Doc releases, if you need support for additional formatting, "
1954 "you would need to enable the usage of docbook XML tags inside doc-comments "
1955 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1956 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1957 "filename>."
1958 msgstr ""
1959 "Ha a régebbi GTK-Doc kiadásokban további formázási támogatásra volt "
1960 "szüksége, akkor engedélyeznie kellett a DocBook XML címkék használatát a "
1961 "dokumentációs megjegyzéseken belül úgy, hogy <option>--xml-mode</option> "
1962 "(vagy <option>--sgml-mode</option>) kapcsolókat tett az "
1963 "<symbol>MKDB_OPTIONS</symbol> változóba a <filename>Makefile.am</filename> "
1964 "fájlon belül."
1965
1966 #. (itstool) path: example/title
1967 #: C/index.docbook:1200
1968 msgid "GTK-Doc comment block using Markdown"
1969 msgstr "GTK-Doc megjegyzésblokk Markdown használatával"
1970
1971 #. (itstool) path: example/programlisting
1972 #: C/index.docbook:1201
1973 #, no-wrap
1974 msgid ""
1975 "\n"
1976 "/**\n"
1977 " * identifier:\n"
1978 " *\n"
1979 " * documentation paragraph ...\n"
1980 " *\n"
1981 " * # Sub Heading #\n"
1982 " *\n"
1983 " * ## Second Sub Heading\n"
1984 " *\n"
1985 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1986 " *\n"
1987 " * more documentation:\n"
1988 " *\n"
1989 " * - list item 1\n"
1990 " *\n"
1991 " * Paragraph inside a list item.\n"
1992 " *\n"
1993 " * - list item 2\n"
1994 " *\n"
1995 " * 1. numbered list item\n"
1996 " *\n"
1997 " * 2. another numbered list item\n"
1998 " *\n"
1999 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
2000 " *\n"
2001 " * ![an inline image](plot-result.png)\n"
2002 " *\n"
2003 " * [A link to the heading anchor above][heading-two]\n"
2004 " *\n"
2005 " * A C-language example:\n"
2006 " * |[&lt;!-- language=\"C\" --&gt;\n"
2007 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
2008 " * ]|\n"
2009 " */\n"
2010 msgstr ""
2011 "\n"
2012 "/**\n"
2013 " * azonosító:\n"
2014 " *\n"
2015 " * dokumentációs bekezdés ...\n"
2016 " *\n"
2017 " * # Alcímsor #\n"
2018 " *\n"
2019 " * ## Második alcímsor\n"
2020 " *\n"
2021 " * # Alcímsor hivatkozási horgonnyal # {#heading-two}\n"
2022 " *\n"
2023 " * további dokumentáció:\n"
2024 " *\n"
2025 " * - Első listaelem\n"
2026 " *\n"
2027 " * Bekezdés a listaelemen belül.\n"
2028 " *\n"
2029 " * - Második listaelem\n"
2030 " *\n"
2031 " * 1. számozott listaelem\n"
2032 " *\n"
2033 " * 2. egy másik számozott listaelem\n"
2034 " *\n"
2035 " * Még egy bekezdés. [Hivatkozás a GNOME webhelyére](http://www.gnome.org/)\n"
2036 " *\n"
2037 " * ![egy beágyazott kép](plot-result.png)\n"
2038 " *\n"
2039 " * [Hivatkozás a fenti címsorhorgonyra][heading-two]\n"
2040 " *\n"
2041 " * Egy C nyelven írt példa:\n"
2042 " * |[&lt;!-- language=\"C\" --&gt;\n"
2043 " * GtkWidget *label = gtk_label_new (\"Gyönyörű!\");\n"
2044 " * ]|\n"
2045 " */\n"
2046
2047 #. (itstool) path: sect1/para
2048 #: C/index.docbook:1240
2049 msgid ""
2050 "More examples of what markdown tags are supported can be found in the <ulink "
2051 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
2052 "Documentation Markdown Syntax Reference</ulink>."
2053 msgstr ""
2054 "További példák találhatók a támogatott Markdown-címkékre a <ulink "
2055 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
2056 "dokumentáció Markdown-szintaxis hivatkozásában</ulink>."
2057
2058 #. (itstool) path: tip/para
2059 #: C/index.docbook:1246
2060 msgid ""
2061 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
2062 "cannot write documentation for static symbols. Nevertheless it is good to "
2063 "comment those symbols too. This helps other developers to understand your "
2064 "code. Therefore we recommend to comment these using normal comments (without "
2065 "the 2nd '*' in the first line). If later the function needs to be made "
2066 "public, all one needs to do is to add another '*' in the comment block and "
2067 "insert the symbol name at the right place inside the sections file."
2068 msgstr ""
2069 "Mint már korábban említettük, a GTK-Doc a nyilvános API dokumentálására "
2070 "szolgál. Így statikus szimbólumokhoz nem lehet dokumentációt írni. "
2071 "Mindazonáltal jó, ha ezeket a szimbólumokat is ellátjuk megjegyzéssel. Ez "
2072 "segít más fejlesztőknek megérteni a kódot. Ezért azt javasoljuk, hogy ezeket "
2073 "normál megjegyzésekkel dokumentálja (a második „*” nélkül az első sorban). "
2074 "Ha később a függvényt nyilvánossá kell tenni, akkor csak annyit kell "
2075 "elvégezni, hogy a egy újabb „*” karaktert kell hozzáadni a "
2076 "megjegyzésblokkhoz, és a megfelelő helyre be kell illeszteni a szimbólum "
2077 "nevét a „sections” fájljában."
2078
2079 #. (itstool) path: sect1/title
2080 #: C/index.docbook:1261
2081 msgid "Documenting sections"
2082 msgstr "Szakaszok dokumentálása"
2083
2084 #. (itstool) path: sect1/para
2085 #: C/index.docbook:1263
2086 msgid ""
2087 "Each section of the documentation contains information about one class or "
2088 "module. To introduce the component one can write a section block. The short "
2089 "description is also used inside the table of contents. All the @fields are "
2090 "optional."
2091 msgstr ""
2092 "A dokumentáció minden egyes szakasza egy-egy osztályról vagy modulról "
2093 "tartalmaz információt. Az összetevő bemutatásához írhatunk szakaszblokkot. A "
2094 "rövid leírást a tartalomjegyzéken belül is használják. Egyik @mező "
2095 "használata sem kötelező."
2096
2097 #. (itstool) path: example/title
2098 #: C/index.docbook:1271
2099 msgid "Section comment block"
2100 msgstr "Szakasz megjegyzésblokkja"
2101
2102 #. (itstool) path: example/programlisting
2103 #: C/index.docbook:1272
2104 #, no-wrap
2105 msgid ""
2106 "\n"
2107 "/**\n"
2108 " * SECTION:meepapp\n"
2109 " * @short_description: the application class\n"
2110 " * @title: Meep application\n"
2111 " * @section_id:\n"
2112 " * @see_also: #MeepSettings\n"
2113 " * @stability: Stable\n"
2114 " * @include: meep/app.h\n"
2115 " * @image: application.png\n"
2116 " *\n"
2117 " * The application class handles ...\n"
2118 " */\n"
2119 msgstr ""
2120 "\n"
2121 "/**\n"
2122 " * SECTION:meepapp\n"
2123 " * @short_description: az alkalmazás osztálya\n"
2124 " * @title: Meep alkalmazás\n"
2125 " * @section_id:\n"
2126 " * @see_also: #MeepSettings\n"
2127 " * @stability: Stable\n"
2128 " * @include: meep/app.h\n"
2129 " * @image: application.png\n"
2130 " *\n"
2131 " * Az alkalmazás osztálya kezeli a ...\n"
2132 " */\n"
2133
2134 #. (itstool) path: varlistentry/term
2135 #: C/index.docbook:1291
2136 msgid "SECTION:&lt;name&gt;"
2137 msgstr "SECTION:&lt;név&gt;"
2138
2139 #. (itstool) path: listitem/para
2140 #: C/index.docbook:1293
2141 msgid ""
2142 "The name links the section documentation to the respective part in the "
2143 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2144 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
2145 "sections.txt</filename> file."
2146 msgstr ""
2147 "A név összekapcsolja a szakasz dokumentációját a <filename>&lt;csomag&gt;-"
2148 "sections.txt</filename> fájl megfelelő részével. Az itt megadott névnek meg "
2149 "kell egyeznie a &lt;FILE&gt; címkével a <filename>&lt;csomag&gt;-"
2150 "sections.txt</filename> fájlban."
2151
2152 #. (itstool) path: varlistentry/term
2153 #: C/index.docbook:1302
2154 msgid "@short_description"
2155 msgstr "@short_description"
2156
2157 #. (itstool) path: listitem/para
2158 #: C/index.docbook:1304
2159 msgid ""
2160 "A one line description of the section, that later will appear after the "
2161 "links in the TOC and at the top of the section page."
2162 msgstr ""
2163 "A szakasz egysoros leírása, amely később a hivatkozás után jelenik meg a "
2164 "tartalomjegyzékben és a szakasz oldalának tetején."
2165
2166 #. (itstool) path: varlistentry/term
2167 #: C/index.docbook:1311
2168 msgid "@title"
2169 msgstr "@title"
2170
2171 #. (itstool) path: listitem/para
2172 #: C/index.docbook:1313
2173 msgid ""
2174 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2175 "can be overridden with the @title field."
2176 msgstr ""
2177 "A szakasz címe alapértelmezetten a SECTION deklarációból származó "
2178 "&lt;név&gt;. Ez felülírható a @title mezővel."
2179
2180 #. (itstool) path: varlistentry/term
2181 #: C/index.docbook:1320
2182 msgid "@section_id"
2183 msgstr "@section_id"
2184
2185 #. (itstool) path: listitem/para
2186 #: C/index.docbook:1322
2187 msgid ""
2188 "Overrides the use of title as a section identifier. For GObjects the "
2189 "&lt;title&gt; is used as a section_id and for other sections it is "
2190 "&lt;MODULE&gt;-&lt;title&gt;."
2191 msgstr ""
2192 "Felülírja a cím szakaszazonosítóként való használatát. A GObject "
2193 "objektumoknál a &lt;title&gt; lesz szakaszazonosítóként használva, más "
2194 "szakaszoknál pedig a &lt;MODUL&gt;-&lt;cím&gt;."
2195
2196 #. (itstool) path: varlistentry/term
2197 #: C/index.docbook:1330
2198 msgid "@see_also"
2199 msgstr "@see_also"
2200
2201 #. (itstool) path: listitem/para
2202 #: C/index.docbook:1332
2203 msgid "A list of symbols that are related to this section."
2204 msgstr "A szakaszhoz kapcsolódó szimbólumok listája."
2205
2206 #. (itstool) path: varlistentry/term
2207 #: C/index.docbook:1338
2208 msgid "@stability"
2209 msgstr "@stability"
2210
2211 #. (itstool) path: listitem/para
2212 #: C/index.docbook:1345
2213 msgid ""
2214 "Stable - The intention of a Stable interface is to enable arbitrary third "
2215 "parties to develop applications to these interfaces, release them, and have "
2216 "confidence that they will run on all minor releases of the product (after "
2217 "the one in which the interface was introduced, and within the same major "
2218 "release). Even at a major release, incompatible changes are expected to be "
2219 "rare, and to have strong justifications."
2220 msgstr ""
2221 "Stable – A stabil interfész célja, hogy lehetővé tegye tetszőleges harmadik "
2222 "fél számára, hogy alkalmazásokat fejlesszen ezekre az interfészekre, kiadja "
2223 "azokat, és bízzon abban, hogy azok a termék minden kisebb kiadásán futni "
2224 "fognak (az interfész bevezetését követő, de ugyanazon fő kiadáson belül). "
2225 "Még egy fő kiadásnál is elvárható, hogy az inkompatibilis változtatások "
2226 "ritkák legyenek, és hogy erős indoklással rendelkezzenek."
2227
2228 #. (itstool) path: listitem/para
2229 #: C/index.docbook:1357
2230 msgid ""
2231 "Unstable - Unstable interfaces are experimental or transitional. They are "
2232 "typically used to give outside developers early access to new or rapidly "
2233 "changing technology, or to provide an interim solution to a problem where a "
2234 "more general solution is anticipated. No claims are made about either source "
2235 "or binary compatibility from one minor release to the next."
2236 msgstr ""
2237 "Unstable – Az instabil interfészek kísérleti vagy átmeneti jellegűek. "
2238 "Általában arra használják azokat, hogy külső fejlesztőknek korai hozzáférést "
2239 "biztosítsanak új vagy gyorsan változó technológiához, vagy hogy átmeneti "
2240 "megoldást nyújtsanak egy olyan problémára, amelyre általánosabb megoldást "
2241 "várnak. Sem a forrás-, sem a bináris kompatibilitás tekintetében nem "
2242 "állítanak semmit az egyik kisebb kiadásról a másikra."
2243
2244 #. (itstool) path: listitem/para
2245 #: C/index.docbook:1369
2246 msgid ""
2247 "Private - An interface that can be used within the GNOME stack itself, but "
2248 "that is not documented for end-users. Such functions should only be used in "
2249 "specified and documented ways."
2250 msgstr ""
2251 "Private – Egy olyan interfész, amely a GNOME rendszerben használható, de "
2252 "nincs dokumentálva a végfelhasználók számára. Az ilyen függvényeket csak "
2253 "meghatározott és dokumentált módon szabad használni."
2254
2255 #. (itstool) path: listitem/para
2256 #: C/index.docbook:1378
2257 msgid ""
2258 "Internal - An interface that is internal to a module and does not require "
2259 "end-user documentation. Functions that are undocumented are assumed to be "
2260 "Internal."
2261 msgstr ""
2262 "Internal – Egy olyan interfész, amely egy modul belső része, és nem igényel "
2263 "végfelhasználói dokumentációt. A dokumentálatlan függvények belsőnek "
2264 "tekintendők."
2265
2266 #. (itstool) path: listitem/para
2267 #: C/index.docbook:1340
2268 msgid ""
2269 "An informal description of the stability level this API has. We recommend "
2270 "the use of one of these terms: <_:itemizedlist-1/>"
2271 msgstr ""
2272 "Az API stabilitási szintjének nem hivatalos leírása. Javasoljuk a következő "
2273 "kifejezések egyikének használatát: <_:itemizedlist-1/>"
2274
2275 #. (itstool) path: varlistentry/term
2276 #: C/index.docbook:1390
2277 msgid "@include"
2278 msgstr "@include"
2279
2280 #. (itstool) path: listitem/para
2281 #: C/index.docbook:1392
2282 msgid ""
2283 "The <literal>#include</literal> files to show in the section synopsis (a "
2284 "comma separated list), overriding the global value from the <link "
2285 "linkend=\"metafiles_sections\">section file</link> or command line. This "
2286 "item is optional."
2287 msgstr ""
2288 "Az <literal>#include</literal> fájlok, amelyeket a szakasz összefoglalójában "
2289 "kell megjeleníteni (vesszővel elválasztott lista), felülírva a <link "
2290 "linkend=\"metafiles_sections\">szakaszfájlból</link> vagy a parancssorból "
2291 "származó globális értéket. Ez az elem nem kötelező."
2292
2293 #. (itstool) path: varlistentry/term
2294 #: C/index.docbook:1401
2295 msgid "@image"
2296 msgstr "@image"
2297
2298 #. (itstool) path: listitem/para
2299 #: C/index.docbook:1403
2300 msgid ""
2301 "The image to display at the top of the reference page for this section. This "
2302 "will often be some sort of a diagram to illustrate the visual appearance of "
2303 "a class or a diagram of its relationship to other classes. This item is "
2304 "optional."
2305 msgstr ""
2306 "Az a kép, amelyet a hivatkozási oldal tetején kell megjeleníteni ebben a "
2307 "szakaszban. Ez gyakran valamilyen diagram lesz, amely az osztály vizuális "
2308 "megjelenését vagy más osztályokkal való kapcsolatát szemlélteti. Ez az elem "
2309 "nem kötelező."
2310
2311 #. (itstool) path: tip/para
2312 #: C/index.docbook:1414
2313 msgid ""
2314 "To avoid unnecessary recompilation after doc-changes put the section docs "
2315 "into the c-source where possible."
2316 msgstr ""
2317 "A felesleges újrafordítás elkerülése érdekében a dokumentáció változtatásai "
2318 "után tegye a szakasz dokumentációit a C-forrásba, ahol csak lehetséges."
2319
2320 #. (itstool) path: sect1/title
2321 #: C/index.docbook:1423
2322 msgid "Documenting symbols"
2323 msgstr "Szimbólumok dokumentálása"
2324
2325 #. (itstool) path: sect1/para
2326 #: C/index.docbook:1425
2327 msgid ""
2328 "Each symbol (function, macro, struct, enum, signal and property) is "
2329 "documented in a separate block. The block is best placed close to the "
2330 "definition of the symbols so that it is easy to keep them in sync. Thus "
2331 "functions are usually documented in the c-source and macros, structs and "
2332 "enums in the header file."
2333 msgstr ""
2334 "Minden szimbólum (függvény, makró, struktúra, felsorolás, szignál és "
2335 "tulajdonság) külön blokkban van dokumentálva. A blokkot célszerű a "
2336 "szimbólumok definíciójához közel elhelyezni, hogy könnyen szinkronban "
2337 "lehessen tartani őket. Így a függvényeket általában a C-forrásban, a "
2338 "makrókat, struktúrákat és felsorolásokat pedig a fejlécfájlban dokumentálják."
2339
2340 #. (itstool) path: sect2/title
2341 #. (itstool) path: example/title
2342 #: C/index.docbook:1433 C/index.docbook:1499
2343 msgid "General tags"
2344 msgstr "Általános címkék"
2345
2346 #. (itstool) path: sect2/para
2347 #: C/index.docbook:1435
2348 msgid ""
2349 "You can add versioning information to all documentation elements to tell "
2350 "when an API was introduced, or when it was deprecated."
2351 msgstr ""
2352 "Verziózási információkat adhat az összes dokumentációs elemhez, hogy "
2353 "megmondja, mikor lett egy API bevezetve, vagy mikor vált elavulttá."
2354
2355 #. (itstool) path: variablelist/title
2356 #: C/index.docbook:1440
2357 msgid "Versioning Tags"
2358 msgstr "Verziózási címkék"
2359
2360 #. (itstool) path: varlistentry/term
2361 #: C/index.docbook:1441
2362 msgid "Since:"
2363 msgstr "Since:"
2364
2365 #. (itstool) path: listitem/para
2366 #: C/index.docbook:1443
2367 msgid "Description since which version of the code the API is available."
2368 msgstr "Annak leírása, hogy a kód melyik verziója óta érhető el az API."
2369
2370 #. (itstool) path: varlistentry/term
2371 #: C/index.docbook:1448
2372 msgid "Deprecated:"
2373 msgstr "Deprecated:"
2374
2375 #. (itstool) path: listitem/para
2376 #: C/index.docbook:1450
2377 msgid ""
2378 "Paragraph denoting that this function should no be used anymore. The "
2379 "description should point the reader to the new API."
2380 msgstr ""
2381 "Olyan bekezdés, amely azt jelzi, hogy ezt a funkciót nem szabad tovább "
2382 "használni. A leírásnak az új API-ra kell irányítania az olvasót."
2383
2384 #. (itstool) path: sect2/para
2385 #: C/index.docbook:1458
2386 msgid ""
2387 "You can also add stability information to all documentation elements to "
2388 "indicate whether API stability is guaranteed for them for all future minor "
2389 "releases of the project."
2390 msgstr ""
2391 "Az összes dokumentációs elemhez stabilitási információt is adhat annak "
2392 "feltüntetéséhez, hogy az API stabilitása garantált-e hozzájuk a projekt "
2393 "összes jövőbeli kisebb kiadásában."
2394
2395 #. (itstool) path: sect2/para
2396 #: C/index.docbook:1464
2397 msgid ""
2398 "The default stability level for all documentation elements can be set by "
2399 "passing the <option>--default-stability</option> argument to "
2400 "<application>gtkdoc-mkdb</application> with one of the values below."
2401 msgstr ""
2402 "Az összes dokumentációs elem alapértelmezett stabilitási szintje beállítható "
2403 "a <option>--default-stability</option> argumentum <application>gtkdoc-mkdb</"
2404 "application> részére történő átadásával, az alábbi értékek egyikével."
2405
2406 #. (itstool) path: variablelist/title
2407 #: C/index.docbook:1470
2408 msgid "Stability Tags"
2409 msgstr "Stabilitási címkék"
2410
2411 #. (itstool) path: varlistentry/term
2412 #: C/index.docbook:1471
2413 msgid "Stability: Stable"
2414 msgstr "Stability: Stable"
2415
2416 #. (itstool) path: listitem/para
2417 #: C/index.docbook:1473
2418 msgid ""
2419 "Mark the element as stable. This is for public APIs which are guaranteed to "
2420 "remain stable for all future minor releases of the project."
2421 msgstr ""
2422 "Az elem megjelölése stabilként. Ez olyan nyilvános API-kra vonatkozik, "
2423 "amelyek garantáltan stabilak maradnak a projekt összes jövőbeli kisebb "
2424 "kiadásában."
2425
2426 #. (itstool) path: varlistentry/term
2427 #: C/index.docbook:1480
2428 msgid "Stability: Unstable"
2429 msgstr "Stability: Unstable"
2430
2431 #. (itstool) path: listitem/para
2432 #: C/index.docbook:1482
2433 msgid ""
2434 "Mark the element as unstable. This is for public APIs which are released as "
2435 "a preview before being stabilised."
2436 msgstr ""
2437 "Az elem megjelölése instabilként. Ez olyan nyilvános API-kra vonatkozik, "
2438 "amelyeket előzetesként adnak ki a stabilizálás előtt."
2439
2440 #. (itstool) path: varlistentry/term
2441 #: C/index.docbook:1488
2442 msgid "Stability: Private"
2443 msgstr "Stability: Private"
2444
2445 #. (itstool) path: listitem/para
2446 #: C/index.docbook:1490
2447 msgid ""
2448 "Mark the element as private. This is for interfaces which can be used by "
2449 "tightly coupled modules, but not by arbitrary third parties."
2450 msgstr ""
2451 "Az elem megjelölése privátként. Ez olyan interfészekre vonatkozik, amelyeket "
2452 "szorosan összekapcsolt modulok használhatnak, de tetszőleges harmadik felek "
2453 "nem."
2454
2455 #. (itstool) path: example/programlisting
2456 #: C/index.docbook:1500
2457 #, no-wrap
2458 msgid ""
2459 "\n"
2460 "/**\n"
2461 " * foo_get_bar:\n"
2462 " * @foo: some foo\n"
2463 " *\n"
2464 " * Retrieves @foo's bar.\n"
2465 " *\n"
2466 " * Returns: @foo's bar\n"
2467 " *\n"
2468 " * Since: 2.6\n"
2469 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2470 " */\n"
2471 "Bar *\n"
2472 "foo_get_bar(Foo *foo)\n"
2473 "{\n"
2474 "...\n"
2475 msgstr ""
2476 "\n"
2477 "/**\n"
2478 " * foo_get_bar:\n"
2479 " * @foo: valamilyen izé\n"
2480 " *\n"
2481 " * Visszaadja a @foo bigyóját.\n"
2482 " *\n"
2483 " * Returns: @foo' bigyója\n"
2484 " *\n"
2485 " * Since: 2.6\n"
2486 " * Deprecated: 2.12: Használja a foo_baz_get_bar() függvényt helyette.\n"
2487 " */\n"
2488 "Bar *\n"
2489 "foo_get_bar(Foo *foo)\n"
2490 "{\n"
2491 "...\n"
2492
2493 #. (itstool) path: sect2/title
2494 #. (itstool) path: example/title
2495 #: C/index.docbook:1520 C/index.docbook:1530
2496 msgid "Annotations"
2497 msgstr "Magyarázó jegyzetek"
2498
2499 #. (itstool) path: sect2/para
2500 #: C/index.docbook:1522
2501 msgid ""
2502 "Documentation blocks can contain annotation-tags. These tags will be "
2503 "rendered with tooltips describing their meaning. The tags are used by "
2504 "GObject Introspection to generate language bindings. A detailed list of the "
2505 "supported tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/"
2506 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection "
2507 "documentation</ulink>."
2508 msgstr ""
2509 "A dokumentációs blokkok tartalmazhatnak magyarázó megjegyzés címkéket. Ezek "
2510 "a címkék a jelentésüket leíró buboréksúgókkal lesznek megjelenítve. A "
2511 "címkéket a GObject Introspection használja a nyelvi kötődések "
2512 "előállításához. A támogatott címkék részletes listája megtalálható a <ulink "
2513 "url=\"https://gi.readthedocs.io/en/latest/annotations/giannotations.html\" "
2514 "type=\"http\">GObject Introspection dokumentációjában</ulink>."
2515
2516 #. (itstool) path: example/programlisting
2517 #: C/index.docbook:1531
2518 #, no-wrap
2519 msgid ""
2520 "\n"
2521 "/**\n"
2522 " * foo_get_bar: (annotation)\n"
2523 " * @foo: (annotation): some foo\n"
2524 " *\n"
2525 " * Retrieves @foo's bar.\n"
2526 " *\n"
2527 " * Returns: (annotation): @foo's bar\n"
2528 " */\n"
2529 "...\n"
2530 "/**\n"
2531 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2532 " * (and another annotation)\n"
2533 " * @foo: (annotation) (another annotation): some foo\n"
2534 " *\n"
2535 " * Sets bar on @foo.\n"
2536 " */\n"
2537 msgstr ""
2538 "\n"
2539 "/**\n"
2540 " * foo_get_bar: (megjegyzés)\n"
2541 " * @foo: (megjegyzés): valamilyen izé\n"
2542 " *\n"
2543 " * Visszaadja a @foo bigyóját.\n"
2544 " *\n"
2545 " * Returns: (megjegyzés): a @foo bigyója\n"
2546 " */\n"
2547 "...\n"
2548 "/**\n"
2549 " * foo_set_bar_using_the_frobnicator: (megjegyzés) (másik megjegyzés)\n"
2550 " * (és még egy megjegyzés)\n"
2551 " * @foo: (megjegyzés) (másik megjegyzés): valamilyen izé\n"
2552 " *\n"
2553 " * Beállítja a bigyót a @foo izén.\n"
2554 " */\n"
2555
2556 #. (itstool) path: sect2/title
2557 #. (itstool) path: example/title
2558 #: C/index.docbook:1552 C/index.docbook:1581
2559 msgid "Function comment block"
2560 msgstr "Függvény megjegyzésblokkja"
2561
2562 #. (itstool) path: listitem/para
2563 #: C/index.docbook:1558
2564 msgid ""
2565 "Document whether returned objects, lists, strings, etc, should be freed/"
2566 "unrefed/released."
2567 msgstr ""
2568 "Dokumentálja, hogy a visszaadott objektumokat, listákat, karakterláncokat "
2569 "stb. fel kell-e szabadítani, meg kell-e szüntetni a hivatkozásukat, illetve "
2570 "ki kell-e adni."
2571
2572 #. (itstool) path: listitem/para
2573 #: C/index.docbook:1564
2574 msgid "Document whether parameters can be NULL, and what happens if they are."
2575 msgstr ""
2576 "Dokumentálja, hogy a paraméterek lehetnek-e NULL értékűek, és mi történjen, "
2577 "ha azok."
2578
2579 #. (itstool) path: listitem/para
2580 #: C/index.docbook:1569
2581 msgid ""
2582 "Mention interesting pre-conditions and post-conditions where appropriate."
2583 msgstr "Említse meg az érdekes elő- és utófeltételeket, ahol szükséges."
2584
2585 #. (itstool) path: sect2/para
2586 #: C/index.docbook:1554 C/index.docbook:1640
2587 msgid "Please remember to: <_:itemizedlist-1/>"
2588 msgstr "Ne felejtse el a következőket: <_:itemizedlist-1/>"
2589
2590 #. (itstool) path: sect2/para
2591 #: C/index.docbook:1576
2592 msgid ""
2593 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2594 "private. They are treated like static functions."
2595 msgstr ""
2596 "A GTK-Doc azt feltételezi, hogy az összes „_” karakterrel kezdődő szimbólum "
2597 "(makró, függvény) privát. Úgy kezeli őket, mint a statikus függvényeket."
2598
2599 #. (itstool) path: example/programlisting
2600 #: C/index.docbook:1582
2601 #, no-wrap
2602 msgid ""
2603 "\n"
2604 "/**\n"
2605 " * function_name:\n"
2606 " * @par1: description of parameter 1. These can extend over more than\n"
2607 " * one line.\n"
2608 " * @par2: description of parameter 2\n"
2609 " * @...: a %NULL-terminated list of bars\n"
2610 " *\n"
2611 " * The function description goes here. You can use @par1 to refer to parameters\n"
2612 " * so that they are highlighted in the output. You can also use %constant\n"
2613 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2614 " * other declarations (which may be documented elsewhere).\n"
2615 " *\n"
2616 " * Returns: an integer.\n"
2617 " *\n"
2618 " * Since: 2.2\n"
2619 " * Deprecated: 2.18: Use other_function() instead.\n"
2620 " */\n"
2621 msgstr ""
2622 "\n"
2623 "/**\n"
2624 " * függvénynév:\n"
2625 " * @par1: az 1. paraméter leírása. Ez kiterjedhet több\n"
2626 " * sorra is.\n"
2627 " * @par2: a 2. paraméter leírása.\n"
2628 " * @...: %NULL-ra végződő bigyólisták.\n"
2629 " *\n"
2630 " * A függvény leírása kerül ide. A @par1 használatával hivatkozhat a\n"
2631 " * paraméterekre, így azok a kimeneten kiemelve jelennek meg. Használhatja\n"
2632 " * továbbá a %konstans jelzőt konstansok esetén, a függvény_neve2() jelzőt\n"
2633 " * függvények esetén és a #GtkWidget jelzőt más deklarációkra mutató\n"
2634 " * hivatkozások esetén (amelyek máshol lehetnek dokumentálva).\n"
2635 " *\n"
2636 " * Returns: egy egész szám.\n"
2637 " *\n"
2638 " * Since: 2.2\n"
2639 " * Deprecated: 2.18: Használja az egyéb_függvény() függvényt helyette.\n"
2640 " */\n"
2641
2642 #. (itstool) path: variablelist/title
2643 #: C/index.docbook:1603
2644 msgid "Function tags"
2645 msgstr "A függvény címkéi"
2646
2647 #. (itstool) path: varlistentry/term
2648 #: C/index.docbook:1604 C/index.docbook:1811
2649 msgid "Returns:"
2650 msgstr "Returns:"
2651
2652 #. (itstool) path: listitem/para
2653 #: C/index.docbook:1606
2654 msgid "Paragraph describing the returned result."
2655 msgstr "A visszaadott eredményt leíró bekezdés."
2656
2657 #. (itstool) path: varlistentry/term
2658 #: C/index.docbook:1611
2659 msgid "@...:"
2660 msgstr "@...:"
2661
2662 #. (itstool) path: listitem/para
2663 #: C/index.docbook:1613
2664 msgid ""
2665 "In case the function has variadic arguments, you should use this tag "
2666 "(@Varargs: does also work for historic reasons)."
2667 msgstr ""
2668 "Abban az esetben, ha a függvénynek változó argumentumai vannak, akkor ezt a "
2669 "címkét kell használnia (a @Varargs: történelmi okokból szintén működik)."
2670
2671 #. (itstool) path: sect2/title
2672 #. (itstool) path: example/title
2673 #: C/index.docbook:1623 C/index.docbook:1625
2674 msgid "Property comment block"
2675 msgstr "Tulajdonság megjegyzésblokkja"
2676
2677 #. (itstool) path: example/programlisting
2678 #: C/index.docbook:1626
2679 #, no-wrap
2680 msgid ""
2681 "\n"
2682 "/**\n"
2683 " * SomeWidget:some-property:\n"
2684 " *\n"
2685 " * Here you can document a property.\n"
2686 " */\n"
2687 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2688 msgstr ""
2689 "\n"
2690 "/**\n"
2691 " * ValamilyenElem:valamilyen-tulajdonság:\n"
2692 " *\n"
2693 " * Itt dokumentálhat egy tulajdonságot.\n"
2694 " */\n"
2695 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2696
2697 #. (itstool) path: sect2/title
2698 #. (itstool) path: example/title
2699 #: C/index.docbook:1638 C/index.docbook:1657
2700 msgid "Signal comment block"
2701 msgstr "Szignál megjegyzésblokkja"
2702
2703 #. (itstool) path: listitem/para
2704 #: C/index.docbook:1644
2705 msgid ""
2706 "Document when the signal is emitted and whether it is emitted before or "
2707 "after other signals."
2708 msgstr ""
2709 "Dokumentálja, hogy a szignál mikor kerül kibocsátásra, és hogy más szignálok "
2710 "előtt vagy után kerül-e kibocsátásra."
2711
2712 #. (itstool) path: listitem/para
2713 #: C/index.docbook:1650
2714 msgid "Document what an application might do in the signal handler."
2715 msgstr "Dokumentálja, hogy mit tehet egy alkalmazás a szignál kezelőjében."
2716
2717 #. (itstool) path: example/programlisting
2718 #: C/index.docbook:1658
2719 #, no-wrap
2720 msgid ""
2721 "\n"
2722 "/**\n"
2723 " * FooWidget::foobarized:\n"
2724 " * @widget: the widget that received the signal\n"
2725 " * @foo: some foo\n"
2726 " * @bar: some bar\n"
2727 " *\n"
2728 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2729 " */\n"
2730 "foo_signals[FOOBARIZED] =\n"
2731 " g_signal_new (\"foobarized\",\n"
2732 " ...\n"
2733 msgstr ""
2734 "\n"
2735 "/**\n"
2736 " * FooWidget::foobarized:\n"
2737 " * @widget: a kütyü, amely fogadta a szignált\n"
2738 " * @foo: valamilyen izé\n"
2739 " * @bar: valamilyen bigyó\n"
2740 " *\n"
2741 " * A ::foobarized szignál minden alkalommal kibocsátásra kerül, ha valaki\n"
2742 " * megpróbálja megizélni a @widget kütyüt.\n"
2743 " */\n"
2744 "foo_signals[FOOBARIZED] =\n"
2745 " g_signal_new (\"foobarized\",\n"
2746 " ...\n"
2747
2748 #. (itstool) path: sect2/title
2749 #. (itstool) path: example/title
2750 #: C/index.docbook:1675 C/index.docbook:1676
2751 msgid "Struct comment block"
2752 msgstr "Struktúra megjegyzésblokkja"
2753
2754 #. (itstool) path: example/programlisting
2755 #: C/index.docbook:1677
2756 #, no-wrap
2757 msgid ""
2758 "\n"
2759 "/**\n"
2760 " * FooWidget:\n"
2761 " * @bar: some #gboolean\n"
2762 " *\n"
2763 " * This is the best widget, ever.\n"
2764 " */\n"
2765 "typedef struct _FooWidget {\n"
2766 " GtkWidget parent_instance;\n"
2767 "\n"
2768 " gboolean bar;\n"
2769 "} FooWidget;\n"
2770 msgstr ""
2771 "\n"
2772 "/**\n"
2773 " * FooWidget:\n"
2774 " * @bar: valamilyen #gboolean\n"
2775 " *\n"
2776 " * Ez a valaha volt legjobb kütyü.\n"
2777 " */\n"
2778 "typedef struct _FooWidget {\n"
2779 " GtkWidget parent_instance;\n"
2780 "\n"
2781 " gboolean bar;\n"
2782 "} FooWidget;\n"
2783
2784 #. (itstool) path: sect2/para
2785 #: C/index.docbook:1692
2786 msgid ""
2787 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2788 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2789 "behaviour."
2790 msgstr ""
2791 "Használja a <code>/*&lt; private &gt;*/</code> jelölést azon privát "
2792 "struktúramezők előtt, amelyeket el szeretne rejteni. Használja a <code>/"
2793 "*&lt; public &gt;*/</code> jelölést a fordított viselkedésért."
2794
2795 #. (itstool) path: sect2/para
2796 #: C/index.docbook:1698
2797 msgid ""
2798 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2799 "it will be considered private automatically and doesn't need to be mentioned "
2800 "in the comment block."
2801 msgstr ""
2802 "Ha az első mező „g_iface”, „parent_instance” vagy „parent_class”, akkor az "
2803 "automatikusan privátnak minősül, és nem kell megemlíteni a "
2804 "megjegyzésblokkban."
2805
2806 #. (itstool) path: sect2/para
2807 #: C/index.docbook:1704
2808 msgid ""
2809 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2810 "is usually a good idea to add a comment block for a class, if it has "
2811 "vmethods (as this is how they can be documented). For the GObject itself one "
2812 "can use the related section docs, having a separate block for the instance "
2813 "struct would be useful if the instance has public fields. One disadvantage "
2814 "here is that this creates two index entries of the same name (the structure "
2815 "and the section)."
2816 msgstr ""
2817 "A struktúrák megjegyzésblokkjai GObjectek és GObjectClassok esetében is "
2818 "használhatók. Általában jó ötlet egy osztályhoz megjegyzésblokkot hozzáadni, "
2819 "ha van virtuális metódusa (mivel így lehet dokumentálni). Magához a "
2820 "GObjecthez használhatjuk a kapcsolódó szakaszok dokumentációit, a "
2821 "példánystruktúrához külön blokkot kell létrehozni, ami akkor hasznos, ha a "
2822 "példánynak nyilvános mezői vannak. Ennek egyik hátránya, hogy ez két azonos "
2823 "nevű indexbejegyzést hoz létre (a struktúra és a szakasz)."
2824
2825 #. (itstool) path: sect2/title
2826 #. (itstool) path: example/title
2827 #: C/index.docbook:1716 C/index.docbook:1717
2828 msgid "Enum comment block"
2829 msgstr "Felsorolás megjegyzésblokkja"
2830
2831 #. (itstool) path: example/programlisting
2832 #: C/index.docbook:1718
2833 #, no-wrap
2834 msgid ""
2835 "\n"
2836 "/**\n"
2837 " * Something:\n"
2838 " * @SOMETHING_FOO: something foo\n"
2839 " * @SOMETHING_BAR: something bar\n"
2840 " *\n"
2841 " * Enum values used for the thing, to specify the thing.\n"
2842 " */\n"
2843 "typedef enum {\n"
2844 " SOMETHING_FOO,\n"
2845 " SOMETHING_BAR,\n"
2846 " /*&lt; private &gt;*/\n"
2847 " SOMETHING_COUNT\n"
2848 "} Something;\n"
2849 msgstr ""
2850 "\n"
2851 "/**\n"
2852 " * Something:\n"
2853 " * @SOMETHING_FOO: valamilyen izé\n"
2854 " * @SOMETHING_BAR: valamilyen bigyó\n"
2855 " *\n"
2856 " * A dologhoz használt felsorolásértékek a dolog meghatározásához.\n"
2857 " */\n"
2858 "typedef enum {\n"
2859 " SOMETHING_FOO,\n"
2860 " SOMETHING_BAR,\n"
2861 " /*&lt; private &gt;*/\n"
2862 " SOMETHING_COUNT\n"
2863 "} Something;\n"
2864
2865 #. (itstool) path: sect2/para
2866 #: C/index.docbook:1735
2867 msgid ""
2868 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2869 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2870 "behaviour."
2871 msgstr ""
2872 "Használja a <code>/*&lt; private &gt;*/</code> jelölést azon privát "
2873 "felsorolásértékek előtt, amelyeket el szeretne rejteni. Használja a <code>/"
2874 "*&lt; public &gt;*/</code> jelölést a fordított viselkedésért."
2875
2876 #. (itstool) path: sect1/title
2877 #: C/index.docbook:1746
2878 msgid "Inline program documentation"
2879 msgstr "Beágyazott program dokumentációja"
2880
2881 #. (itstool) path: sect1/para
2882 #: C/index.docbook:1747
2883 msgid ""
2884 "You can document programs and their commandline interface using inline "
2885 "documentation."
2886 msgstr ""
2887 "Dokumentálhat programokat és a parancssori interfészüket beágyazott "
2888 "dokumentáció használatával."
2889
2890 #. (itstool) path: variablelist/title
2891 #: C/index.docbook:1753
2892 msgid "Tags"
2893 msgstr "Címkék"
2894
2895 #. (itstool) path: varlistentry/term
2896 #: C/index.docbook:1755
2897 msgid "PROGRAM"
2898 msgstr "PROGRAM"
2899
2900 #. (itstool) path: listitem/para
2901 #: C/index.docbook:1758
2902 msgid "Defines the start of a program documentation."
2903 msgstr "Meghatározza egy program dokumentációjának kezdetét."
2904
2905 #. (itstool) path: varlistentry/term
2906 #: C/index.docbook:1765
2907 msgid "@short_description:"
2908 msgstr "@short_description:"
2909
2910 #. (itstool) path: listitem/para
2911 #: C/index.docbook:1767
2912 msgid "Defines a short description of the program. (Optional)"
2913 msgstr "Meghatározza a program rövid leírását (nem kötelező)."
2914
2915 #. (itstool) path: varlistentry/term
2916 #: C/index.docbook:1774
2917 msgid "@synopsis:"
2918 msgstr "@synopsis:"
2919
2920 #. (itstool) path: listitem/para
2921 #: C/index.docbook:1776
2922 msgid ""
2923 "Defines the arguments, or list of arguments that the program can take. "
2924 "(Optional)"
2925 msgstr ""
2926 "Meghatározza az argumentumokat vagy az argumentumok listáját, amelyeket a "
2927 "program elfogadhat (nem kötelező)."
2928
2929 #. (itstool) path: varlistentry/term
2930 #: C/index.docbook:1784
2931 msgid "@see_also:"
2932 msgstr "@see_also:"
2933
2934 #. (itstool) path: listitem/para
2935 #: C/index.docbook:1786
2936 msgid "See Also manual page section. (Optional)"
2937 msgstr "Lásd még a kézikönyvoldal szakaszát (nem kötelező)."
2938
2939 #. (itstool) path: varlistentry/term
2940 #: C/index.docbook:1793
2941 msgid "@arg:"
2942 msgstr "@arg:"
2943
2944 #. (itstool) path: listitem/para
2945 #: C/index.docbook:1795
2946 msgid "Argument(s) passed to the program and their description. (Optional)"
2947 msgstr "A programnak átadott argumentumok és leírásaik (nem kötelező)."
2948
2949 #. (itstool) path: varlistentry/term
2950 #: C/index.docbook:1802
2951 msgid "Description:"
2952 msgstr "Leírás:"
2953
2954 #. (itstool) path: listitem/para
2955 #: C/index.docbook:1804
2956 msgid "A longer description of the program."
2957 msgstr "A program hosszabb leírása."
2958
2959 #. (itstool) path: listitem/para
2960 #: C/index.docbook:1813
2961 msgid "Specify what value(s) the program returns. (Optional)"
2962 msgstr ""
2963 "Annak megadása, hogy a program milyen értékeket ad vissza (nem kötelező)."
2964
2965 #. (itstool) path: sect2/title
2966 #: C/index.docbook:1822
2967 msgid "Example of program documentation."
2968 msgstr "Példa egy program dokumentációjára."
2969
2970 #. (itstool) path: example/title
2971 #: C/index.docbook:1823
2972 msgid "Program documentation block"
2973 msgstr "Program dokumentációs blokkja"
2974
2975 #. (itstool) path: example/programlisting
2976 #: C/index.docbook:1824
2977 #, no-wrap
2978 msgid ""
2979 "\n"
2980 "/**\n"
2981 " * PROGRAM:test-program\n"
2982 " * @short_description: A test program\n"
2983 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2984 " * @see_also: test(1)\n"
2985 " * @--arg1 *arg*: set arg1 to *arg*\n"
2986 " * @--arg2 *arg*: set arg2 to *arg*\n"
2987 " * @-v, --version: Print the version number\n"
2988 " * @-h, --help: Print the help message\n"
2989 " *\n"
2990 " * Long description of program.\n"
2991 " *\n"
2992 " * Returns: Zero on success, non-zero on failure\n"
2993 " */\n"
2994 "int main(int argc, char *argv[])\n"
2995 "{\n"
2996 "\treturn 0;\n"
2997 "}\n"
2998 msgstr ""
2999 "\n"
3000 "/**\n"
3001 " * PROGRAM:test-program\n"
3002 " * @short_description: Egy tesztprogram\n"
3003 " * @synopsis: test-program [*KAPCSOLÓK*...] --arg1 *arg* *FÁJL*\n"
3004 " * @see_also: test(1)\n"
3005 " * @--arg1 *arg*: az arg1 beállítása *arg* értékre\n"
3006 " * @--arg2 *arg*: az arg2 beállítása *arg* értékre\n"
3007 " * @-v, --version: A verziószám kiírása\n"
3008 " * @-h, --help: A súgóüzenet kiírása\n"
3009 " *\n"
3010 " * A program hosszú leírása.\n"
3011 " *\n"
3012 " * Returns: Siker esetén nulla, sikertelenség esetén nem nulla\n"
3013 " */\n"
3014 "int main(int argc, char *argv[])\n"
3015 "{\n"
3016 "\treturn 0;\n"
3017 "}\n"
3018
3019 #. (itstool) path: sect1/title
3020 #: C/index.docbook:1850
3021 msgid "Useful DocBook tags"
3022 msgstr "Hasznos DocBook-címkék"
3023
3024 #. (itstool) path: sect1/para
3025 #: C/index.docbook:1852
3026 msgid ""
3027 "Here are some DocBook tags which are most useful when documenting the code."
3028 msgstr ""
3029 "Íme néhány DocBook-címke, amelyek a leghasznosabbak a kód dokumentálásakor."
3030
3031 #. (itstool) path: informalexample/programlisting
3032 #: C/index.docbook:1861
3033 #, no-wrap
3034 msgid ""
3035 "\n"
3036 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
3037 msgstr ""
3038 "\n"
3039 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hasítótáblák&lt;/link&gt;\n"
3040
3041 #. (itstool) path: sect1/para
3042 #: C/index.docbook:1857
3043 msgid ""
3044 "To link to another section in the GTK docs: <_:informalexample-1/> The "
3045 "linkend is the SGML/XML id on the top item of the page you want to link to. "
3046 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
3047 "then the page title (\"Hash Tables\"). For widgets it is just the class "
3048 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
3049 msgstr ""
3050 "A GTK dokumentációjának egy másik szakaszára való hivatkozáshoz: "
3051 "<_:informalexample-1/> A hivatkozás vége az SGML/XML azonosítója annak az "
3052 "oldalnak a legfelső elemén, amelyre hivatkozni kíván. A legtöbb oldal "
3053 "esetében ez jelenleg a („gtk”, „gdk”, „glib”) rész, majd az oldal címe "
3054 "(„Hasítótáblák”). A felületi elemek esetében ez csak az osztály neve. A "
3055 "szóközök és az aláhúzások az SGML/XML-nek való megfelelés érdekében „-” "
3056 "karakterre vannak átalakítva."
3057
3058 #. (itstool) path: informalexample/programlisting
3059 #: C/index.docbook:1874
3060 #, no-wrap
3061 msgid ""
3062 "\n"
3063 "&lt;function&gt;...&lt;/function&gt;\n"
3064 msgstr ""
3065 "\n"
3066 "&lt;function&gt;...&lt;/function&gt;\n"
3067
3068 #. (itstool) path: sect1/para
3069 #: C/index.docbook:1871
3070 msgid ""
3071 "To refer to an external function, e.g. a standard C function: "
3072 "<_:informalexample-1/>"
3073 msgstr ""
3074 "Egy külső függvényre, például egy szabványos C függvényre való "
3075 "hivatkozáshoz: <_:informalexample-1/>"
3076
3077 #. (itstool) path: informalexample/programlisting
3078 #: C/index.docbook:1883
3079 #, no-wrap
3080 msgid ""
3081 "\n"
3082 "&lt;example&gt;\n"
3083 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3084 " &lt;programlisting language=\"C\"&gt;\n"
3085 " ...\n"
3086 " &lt;/programlisting&gt;\n"
3087 "&lt;/example&gt;\n"
3088 msgstr ""
3089 "\n"
3090 "&lt;example&gt;\n"
3091 " &lt;title&gt;Egy GHashTable használata.&lt;/title&gt;\n"
3092 " &lt;programlisting language=\"C\"&gt;\n"
3093 " ...\n"
3094 " &lt;/programlisting&gt;\n"
3095 "&lt;/example&gt;\n"
3096
3097 #. (itstool) path: informalexample/programlisting
3098 #: C/index.docbook:1894
3099 #, no-wrap
3100 msgid ""
3101 "\n"
3102 "&lt;informalexample&gt;\n"
3103 " &lt;programlisting language=\"C\"&gt;\n"
3104 " ...\n"
3105 " &lt;/programlisting&gt;\n"
3106 "&lt;/informalexample&gt;\n"
3107 msgstr ""
3108 "\n"
3109 "&lt;informalexample&gt;\n"
3110 " &lt;programlisting language=\"C\"&gt;\n"
3111 " ...\n"
3112 " &lt;/programlisting&gt;\n"
3113 "&lt;/informalexample&gt;\n"
3114
3115 #. (itstool) path: informalexample/programlisting
3116 #: C/index.docbook:1906
3117 #, no-wrap
3118 msgid ""
3119 "\n"
3120 "|[&lt;!-- language=\"C\" --&gt;\n"
3121 " ...\n"
3122 "]|\n"
3123 msgstr ""
3124 "\n"
3125 "|[&lt;!-- language=\"C\" --&gt;\n"
3126 " ...\n"
3127 "]|\n"
3128
3129 #. (itstool) path: sect1/para
3130 #: C/index.docbook:1880
3131 msgid ""
3132 "To include example code: <_:informalexample-1/> or possibly this, for very "
3133 "short code fragments which don't need a title: <_:informalexample-2/> In "
3134 "both cases, the language attribute is optional and is used as a hint to the "
3135 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3136 "Doc also supports an abbreviation: <_:informalexample-3/>"
3137 msgstr ""
3138 "Példakód beillesztéséhez: <_:informalexample-1/> vagy esetleg ez, a nagyon "
3139 "rövid kódrészletekhez, amelyeknek nincs szükségük címre: "
3140 "<_:informalexample-2/> Mindkét esetben a language attribútum elhagyható, és "
3141 "a szintaxiskiemelő motornak (pygments a HTML kimenethez) szolgál segítségül. "
3142 "Ez utóbbihoz a GTK-Doc egy rövidítést is támogat: <_:informalexample-3/>"
3143
3144 #. (itstool) path: informalexample/programlisting
3145 #: C/index.docbook:1917
3146 #, no-wrap
3147 msgid ""
3148 "\n"
3149 "&lt;itemizedlist&gt;\n"
3150 " &lt;listitem&gt;\n"
3151 " &lt;para&gt;\n"
3152 " ...\n"
3153 " &lt;/para&gt;\n"
3154 " &lt;/listitem&gt;\n"
3155 " &lt;listitem&gt;\n"
3156 " &lt;para&gt;\n"
3157 " ...\n"
3158 " &lt;/para&gt;\n"
3159 " &lt;/listitem&gt;\n"
3160 "&lt;/itemizedlist&gt;\n"
3161 msgstr ""
3162 "\n"
3163 "&lt;itemizedlist&gt;\n"
3164 " &lt;listitem&gt;\n"
3165 " &lt;para&gt;\n"
3166 " ...\n"
3167 " &lt;/para&gt;\n"
3168 " &lt;/listitem&gt;\n"
3169 " &lt;listitem&gt;\n"
3170 " &lt;para&gt;\n"
3171 " ...\n"
3172 " &lt;/para&gt;\n"
3173 " &lt;/listitem&gt;\n"
3174 "&lt;/itemizedlist&gt;\n"
3175
3176 #. (itstool) path: sect1/para
3177 #: C/index.docbook:1914
3178 msgid "To include bulleted lists: <_:informalexample-1/>"
3179 msgstr "Felsorolásos listák beillesztéséhez: <_:informalexample-1/>"
3180
3181 #. (itstool) path: informalexample/programlisting
3182 #: C/index.docbook:1937
3183 #, no-wrap
3184 msgid ""
3185 "\n"
3186 "&lt;note&gt;\n"
3187 " &lt;para&gt;\n"
3188 " Make sure you free the data after use.\n"
3189 " &lt;/para&gt;\n"
3190 "&lt;/note&gt;\n"
3191 msgstr ""
3192 "\n"
3193 "&lt;note&gt;\n"
3194 " &lt;para&gt;\n"
3195 " Győződjön meg arról, hogy használat után felszabadította-e az adatokat.\n"
3196 " &lt;/para&gt;\n"
3197 "&lt;/note&gt;\n"
3198
3199 #. (itstool) path: sect1/para
3200 #: C/index.docbook:1934
3201 msgid ""
3202 "To include a note which stands out from the text: <_:informalexample-1/>"
3203 msgstr ""
3204 "A szövegből kiemelkedő megjegyzés beillesztéséhez: <_:informalexample-1/>"
3205
3206 #. (itstool) path: informalexample/programlisting
3207 #: C/index.docbook:1950
3208 #, no-wrap
3209 msgid ""
3210 "\n"
3211 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3212 msgstr ""
3213 "\n"
3214 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3215
3216 #. (itstool) path: sect1/para
3217 #: C/index.docbook:1947
3218 msgid "To refer to a type: <_:informalexample-1/>"
3219 msgstr "Egy típusra való hivatkozáshoz: <_:informalexample-1/>"
3220
3221 #. (itstool) path: informalexample/programlisting
3222 #: C/index.docbook:1959
3223 #, no-wrap
3224 msgid ""
3225 "\n"
3226 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3227 msgstr ""
3228 "\n"
3229 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3230
3231 #. (itstool) path: sect1/para
3232 #: C/index.docbook:1956
3233 msgid ""
3234 "To refer to an external structure (not one described in the GTK docs): "
3235 "<_:informalexample-1/>"
3236 msgstr ""
3237 "Egy külső (nem a GTK dokumentációban ismertetett) struktúrára való "
3238 "hivatkozáshoz: <_:informalexample-1/>"
3239
3240 #. (itstool) path: informalexample/programlisting
3241 #: C/index.docbook:1968
3242 #, no-wrap
3243 msgid ""
3244 "\n"
3245 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3246 msgstr ""
3247 "\n"
3248 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3249
3250 #. (itstool) path: sect1/para
3251 #: C/index.docbook:1965
3252 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3253 msgstr "Egy struktúra mezőjére való hivatkozáshoz: <_:informalexample-1/>"
3254
3255 #. (itstool) path: informalexample/programlisting
3256 #: C/index.docbook:1977
3257 #, no-wrap
3258 msgid ""
3259 "\n"
3260 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3261 msgstr ""
3262 "\n"
3263 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3264
3265 #. (itstool) path: sect1/para
3266 #: C/index.docbook:1974
3267 msgid ""
3268 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3269 "you'll probably be using #GtkWidget instead (to automatically create a link "
3270 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3271 "abbreviations</link>)."
3272 msgstr ""
3273 "Egy osztálynévre való hivatkozáshoz esetleg használhatjuk a következőt: "
3274 "<_:informalexample-1/> de valószínűleg a #GtkWidget lesz használva helyette "
3275 "(hogy automatikusan létrehozzon egy hivatkozást a GtkWidget oldalára – nézze "
3276 "meg a <link linkend=\"documenting_syntax\">rövidítéseket</link>)."
3277
3278 #. (itstool) path: informalexample/programlisting
3279 #: C/index.docbook:1988
3280 #, no-wrap
3281 msgid ""
3282 "\n"
3283 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3284 msgstr ""
3285 "\n"
3286 "&lt;emphasis&gt;Ez fontos&lt;/emphasis&gt;\n"
3287
3288 #. (itstool) path: sect1/para
3289 #: C/index.docbook:1985
3290 msgid "To emphasize text: <_:informalexample-1/>"
3291 msgstr "A szöveg hangsúlyozásához: <_:informalexample-1/>"
3292
3293 #. (itstool) path: informalexample/programlisting
3294 #: C/index.docbook:1997
3295 #, no-wrap
3296 msgid ""
3297 "\n"
3298 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3299 msgstr ""
3300 "\n"
3301 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3302
3303 #. (itstool) path: sect1/para
3304 #: C/index.docbook:1994
3305 msgid "For filenames use: <_:informalexample-1/>"
3306 msgstr "Fájlnevekhez használja ezt: <_:informalexample-1/>"
3307
3308 #. (itstool) path: informalexample/programlisting
3309 #: C/index.docbook:2006
3310 #, no-wrap
3311 msgid ""
3312 "\n"
3313 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3314 msgstr ""
3315 "\n"
3316 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3317
3318 #. (itstool) path: sect1/para
3319 #: C/index.docbook:2003
3320 msgid "To refer to keys use: <_:informalexample-1/>"
3321 msgstr "Billentyűkre való hivatkozáshoz használja ezt: <_:informalexample-1/>"
3322
3323 #. (itstool) path: chapter/title
3324 #: C/index.docbook:2016
3325 msgid "Filling the extra files"
3326 msgstr "A további fájlok kitöltése"
3327
3328 #. (itstool) path: chapter/para
3329 #: C/index.docbook:2018
3330 msgid ""
3331 "There are a couple of extra files, that need to be maintained along with the "
3332 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3333 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3334 "<filename>&lt;package&gt;-sections.txt</filename>."
3335 msgstr ""
3336 "Van néhány további fájl, amelyeket a forráskód beágyazott megjegyzéseivel "
3337 "együtt kell karbantartani: <filename>&lt;csomag&gt;.types</filename>, "
3338 "<filename>&lt;csomag&gt;-docs.xml</filename> (régebben .sgml), "
3339 "<filename>&lt;csomag&gt;-sections.txt</filename>."
3340
3341 #. (itstool) path: sect1/title
3342 #: C/index.docbook:2027
3343 msgid "Editing the types file"
3344 msgstr "A típusok fájl szerkesztése"
3345
3346 #. (itstool) path: sect1/para
3347 #: C/index.docbook:2029
3348 msgid ""
3349 "If your library or application includes GObjects, you want their signals, "
3350 "arguments/parameters and position in the hierarchy to be shown in the "
3351 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3352 "function> functions together with their include inside the "
3353 "<filename>&lt;package&gt;.types</filename> file."
3354 msgstr ""
3355 "Ha a könyvtár vagy az alkalmazás GObjecteket tartalmaz, akkor a "
3356 "dokumentációban meg szeretné jeleníteni a szignálokat, argumentumokat, "
3357 "paramétereket és a hierarchiában elfoglalt helyüket. Mindössze annyit kell "
3358 "tennie, hogy felsorolja a <function>xxx_get_type</function> függvényeket az "
3359 "include-jaikkal együtt a <filename>&lt;csomag&gt;.types</filename> fájlon "
3360 "belül."
3361
3362 #. (itstool) path: example/title
3363 #: C/index.docbook:2038
3364 msgid "Example &lt;package&gt;.types file"
3365 msgstr "Példa a &lt;csomag&gt;.types-fájlra"
3366
3367 #. (itstool) path: example/programlisting
3368 #: C/index.docbook:2039
3369 #, no-wrap
3370 msgid ""
3371 "\n"
3372 "#include &lt;gtk/gtk.h&gt;\n"
3373 "\n"
3374 "gtk_accel_label_get_type\n"
3375 "gtk_adjustment_get_type\n"
3376 "gtk_alignment_get_type\n"
3377 "gtk_arrow_get_type\n"
3378 msgstr ""
3379 "\n"
3380 "#include &lt;gtk/gtk.h&gt;\n"
3381 "\n"
3382 "gtk_accel_label_get_type\n"
3383 "gtk_adjustment_get_type\n"
3384 "gtk_alignment_get_type\n"
3385 "gtk_arrow_get_type\n"
3386
3387 #. (itstool) path: sect1/para
3388 #: C/index.docbook:2050
3389 msgid ""
3390 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3391 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3392 "<filename>Makefile.am</filename>. If you use this approach you should not "
3393 "dist the types file nor have it under version control."
3394 msgstr ""
3395 "A GTK-Doc 1.8 óta az <application>gtkdoc-scan</application> képes "
3396 "előállítani ezt a listát Önnek. Csak adja hozzá a „--rebuild-types” "
3397 "kapcsolót a SCAN_OPTIONS értékeihez a <filename>Makefile.am</filename> "
3398 "fájlban. Ha ezt a megközelítést használja, akkor nem kell terjesztenie a "
3399 "típusok fájlt, és nem is kell verziókövetés alatt tartania."
3400
3401 #. (itstool) path: sect1/title
3402 #: C/index.docbook:2059
3403 msgid "Editing the master document"
3404 msgstr "A mesterdokumentum szerkesztése"
3405
3406 #. (itstool) path: sect1/para
3407 #: C/index.docbook:2061
3408 msgid ""
3409 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3410 "inline source comments, the GTK-Doc tools generate one documentation page "
3411 "per class or module as a separate file. The master document includes them "
3412 "and place them in an order."
3413 msgstr ""
3414 "A GTK-Doc DocBook SGML/XML formátumú dokumentációt készít. A beágyazott "
3415 "forrásmegjegyzések feldolgozásakor a GTK-Doc eszközei osztályonként vagy "
3416 "modulonként egy dokumentációs oldalt állítanak elő külön fájlként. A "
3417 "mesterdokumentum tartalmazza ezeket, és sorrendbe helyezi őket."
3418
3419 #. (itstool) path: sect1/para
3420 #: C/index.docbook:2068
3421 msgid ""
3422 "While GTK-Doc creates a template master document for you, later runs will "
3423 "not touch it again. This means that one can freely structure the "
3424 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3425 "has now a test suite, where also the master-document is recreated from "
3426 "scratch. Its a good idea to look at this from time to time to see if there "
3427 "are some new goodies introduced there."
3428 msgstr ""
3429 "Noha a GTK-Doc létrehoz egy sablon mesterdokumentumot Önnek, a későbbi "
3430 "futtatások nem nyúlnak hozzá újra. Ez azt jelenti, hogy szabadon "
3431 "szerkesztheti a dokumentációt. Ez magában foglalja az oldalak "
3432 "csoportosítását és a további oldalak hozzáadását. A GTK-Doc mostantól "
3433 "rendelkezik egy tesztcsomaggal, ahol a mesterdokumentum is újra létrejön a "
3434 "semmiből. Jó ötlet erre időről-időre ránézni és észrevenni, hogy vannak-e "
3435 "újdonságok, amik bevezetésre kerültek."
3436
3437 #. (itstool) path: tip/para
3438 #: C/index.docbook:2078
3439 msgid ""
3440 "Do not create tutorials as extra documents. Just write extra chapters. The "
3441 "benefit of directly embedding the tutorial for your library into the API "
3442 "documentation is that it is easy to link for the tutorial to symbol "
3443 "documentation. Apart chances are higher that the tutorial gets updates along "
3444 "with the library."
3445 msgstr ""
3446 "Ne hozzon létre oktatóanyagokat külön dokumentumként. Csak írjon további "
3447 "fejezeteket. A programkönyvtára oktatóanyagának az API-dokumentációba való "
3448 "közvetlen beágyazásának az az előnye, hogy könnyen összekapcsolható az "
3449 "oktatóanyag a szimbólum dokumentációjával. Emellett nagyobb az esélye annak, "
3450 "hogy az oktatóanyag a programkönyvtárral együtt kap frissítéseket."
3451
3452 #. (itstool) path: sect1/para
3453 #: C/index.docbook:2087
3454 msgid ""
3455 "So what are the things to change inside the master document? For a start is "
3456 "only a little. There are some placeholders (text in square brackets) there "
3457 "which you should take care of."
3458 msgstr ""
3459 "Mik azok a dolgok, amelyeket a mesterdokumentumon belül meg kell "
3460 "változtatni? Kezdetnek csak egy keveset. Van ott néhány helykitöltő "
3461 "(szögletes zárójelben lévő szöveg), amelyekre vigyázni kell."
3462
3463 #. (itstool) path: example/title
3464 #: C/index.docbook:2094
3465 msgid "Master document header"
3466 msgstr "Mesterdokumentum fejléce"
3467
3468 #. (itstool) path: example/programlisting
3469 #: C/index.docbook:2095
3470 #, no-wrap
3471 msgid ""
3472 "\n"
3473 "&lt;bookinfo&gt;\n"
3474 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3475 " &lt;releaseinfo&gt;\n"
3476 " for MODULENAME [VERSION]\n"
3477 " The latest version of this documentation can be found on-line at\n"
3478 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3479 " &lt;/releaseinfo&gt;\n"
3480 "&lt;/bookinfo&gt;\n"
3481 "\n"
3482 "&lt;chapter&gt;\n"
3483 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3484 msgstr ""
3485 "\n"
3486 "&lt;bookinfo&gt;\n"
3487 " &lt;title&gt;MODULENAME hivatkozási kézikönyv&lt;/title&gt;\n"
3488 " &lt;releaseinfo&gt;\n"
3489 " MODULENAME [VERSION]\n"
3490 " A dokumentáció legfrissebb változata megtalálható a\n"
3491 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt; internetes oldalon.\n"
3492 " &lt;/releaseinfo&gt;\n"
3493 "&lt;/bookinfo&gt;\n"
3494 "\n"
3495 "&lt;chapter&gt;\n"
3496 " &lt;title&gt;[Cím beszúrása ide]&lt;/title&gt;\n"
3497
3498 #. (itstool) path: sect1/para
3499 #: C/index.docbook:2111
3500 msgid ""
3501 "In addition a few option elements are created in commented form. You can "
3502 "review these and enable them as you like."
3503 msgstr ""
3504 "Ezenkívül néhány választható elem is létrehozásra kerül megjegyzésekkel "
3505 "ellátott formában. Ezeket áttekintheti, és tetszés szerint engedélyezheti."
3506
3507 #. (itstool) path: example/title
3508 #: C/index.docbook:2117
3509 msgid "Optional part in the master document"
3510 msgstr "Választható rész a mesterdokumentumban"
3511
3512 #. (itstool) path: example/programlisting
3513 #: C/index.docbook:2118
3514 #, no-wrap
3515 msgid ""
3516 "\n"
3517 " &lt;!-- enable this when you use gobject introspection annotations\n"
3518 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3519 " --&gt;\n"
3520 msgstr ""
3521 "\n"
3522 " &lt;!-- engedélyezze ezt, ha GObject Introspection megjegyzéseket használ\n"
3523 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3524 " --&gt;\n"
3525
3526 #. (itstool) path: sect1/para
3527 #: C/index.docbook:2126
3528 msgid ""
3529 "Finally you need to add new section whenever you introduce one. The <link "
3530 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3531 "you of newly generated xml files that are not yet included into the doc."
3532 msgstr ""
3533 "Végül új szakaszt kell hozzáadni, amikor bevezet egyet. A <link "
3534 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> eszköz emlékeztetni "
3535 "fogja az újonnan előállított XML-fájlokra, amelyek még nem szerepelnek a "
3536 "dokumentációban."
3537
3538 #. (itstool) path: example/title
3539 #: C/index.docbook:2134 C/index.docbook:2169
3540 msgid "Including generated sections"
3541 msgstr "Előállított szakaszok beágyazása"
3542
3543 #. (itstool) path: example/programlisting
3544 #: C/index.docbook:2135
3545 #, no-wrap
3546 msgid ""
3547 "\n"
3548 " &lt;chapter&gt;\n"
3549 " &lt;title&gt;my library&lt;/title&gt;\n"
3550 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3551 " ...\n"
3552 msgstr ""
3553 "\n"
3554 " &lt;chapter&gt;\n"
3555 " &lt;title&gt;Az én programkönyvtáram&lt;/title&gt;\n"
3556 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3557 " ...\n"
3558
3559 #. (itstool) path: sect1/title
3560 #: C/index.docbook:2147
3561 msgid "Editing the section file"
3562 msgstr "A szakaszfájl szerkesztése"
3563
3564 #. (itstool) path: sect1/para
3565 #: C/index.docbook:2149
3566 msgid ""
3567 "The section file is used to organise the documentation output by GTK-Doc. "
3568 "Here one specifies which symbol belongs to which module or class and control "
3569 "the visibility (public or private)."
3570 msgstr ""
3571 "A szakaszfájl a GTK-Doc által kiírt dokumentáció rendszerezésére szolgál. "
3572 "Itt adhatjuk meg, hogy melyik szimbólum melyik modulhoz vagy osztályhoz "
3573 "tartozik, és szabályozhatjuk a láthatóságot (publikus vagy privát)."
3574
3575 #. (itstool) path: sect1/para
3576 #: C/index.docbook:2155
3577 msgid ""
3578 "The section file is a plain text file with tags delimiting sections. Blank "
3579 "lines are ignored and lines starting with a '#' are treated as comment lines."
3580 msgstr ""
3581 "A szakaszfájl egy egyszerű szöveges fájl, címkékkel elválasztott "
3582 "szakaszokkal. Az üres sorok figyelmen kívül maradnak, és a „#” karakterrel "
3583 "kezdődő sorok megjegyzésként vannak kezelve."
3584
3585 #. (itstool) path: note/para
3586 #: C/index.docbook:2162
3587 msgid ""
3588 "While the tags make the file look like xml, it is not. Please do not close "
3589 "tags like &lt;SUBSECTION&gt;."
3590 msgstr ""
3591 "Noha a címkék miatt a fájl XML-nek tűnik, nem az. Ne zárja le a címkéket, "
3592 "mint például a &lt;SUBSECTION&gt; címkét."
3593
3594 #. (itstool) path: example/programlisting
3595 #: C/index.docbook:2170
3596 #, no-wrap
3597 msgid ""
3598 "\n"
3599 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3600 "\n"
3601 "&lt;SECTION&gt;\n"
3602 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3603 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3604 "MeepApp\n"
3605 "&lt;SUBSECTION Standard&gt;\n"
3606 "MEEP_APP\n"
3607 "...\n"
3608 "MeepAppClass\n"
3609 "meep_app_get_type\n"
3610 "&lt;/SECTION&gt;\n"
3611 msgstr ""
3612 "\n"
3613 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3614 "\n"
3615 "&lt;SECTION&gt;\n"
3616 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3617 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3618 "MeepApp\n"
3619 "&lt;SUBSECTION Standard&gt;\n"
3620 "MEEP_APP\n"
3621 "...\n"
3622 "MeepAppClass\n"
3623 "meep_app_get_type\n"
3624 "&lt;/SECTION&gt;\n"
3625
3626 #. (itstool) path: sect1/para
3627 #: C/index.docbook:2187
3628 msgid ""
3629 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3630 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3631 "FILE&gt;' will result in the section declarations being output in the "
3632 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3633 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3634 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3635 "(The name of the HTML file is based on the module name and the section "
3636 "title, or for GObjects it is based on the GObjects class name converted to "
3637 "lower case)."
3638 msgstr ""
3639 "A &lt;FILE&gt; ... &lt;/FILE&gt; címke a fájl nevének megadására szolgál, "
3640 "utótag nélkül. Például a „&lt;FILE&gt;gnome-config&lt;/FILE&gt;” használata "
3641 "azt eredményezi, hogy a szakaszdeklarációk kiírásra kerülnek a "
3642 "<filename>tmpl/gnome-config.sgml</filename> sablonfájlban, amely az "
3643 "<filename>xml/gnome-config.xml</filename> vagy az <filename>xml/gnome-"
3644 "config.sgml</filename> DocBook XML-fájlra lesz átalakítva. (A HTML-fájl neve "
3645 "a modul nevén és a szakasz címén alapul, vagy GObjectek esetén a GObjectek "
3646 "osztálynevén alapul kisbetűssé alakítva)."
3647
3648 #. (itstool) path: sect1/para
3649 #: C/index.docbook:2199
3650 msgid ""
3651 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3652 "section. It is only useful before the templates (if used) are initially "
3653 "created, since the title set in the template file overrides this. Also if "
3654 "one uses SECTION comment in the sources, this is obsolete."
3655 msgstr ""
3656 "A &lt;TITLE&gt; ... &lt;/TITLE&gt; címke a szakasz címének megadására "
3657 "szolgál. Ez csak a sablonok (ha használjuk) kezdeti létrehozása előtt "
3658 "hasznos, mivel a sablonfájlban beállított cím felülírja ezt. Ha valaki a "
3659 "forrásokban is használja a SECTION megjegyzést, akkor ez elavult."
3660
3661 #. (itstool) path: sect1/para
3662 #: C/index.docbook:2206
3663 msgid ""
3664 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3665 "Currently it outputs a blank line between subsections in the synopsis "
3666 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3667 "declarations (e.g. the functions like g_object_get_type and macros like "
3668 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3669 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3670 "declarations which will not be output (it is a handy way to avoid warning "
3671 "messages about unused declarations). If your library contains private types "
3672 "which you don't want to appear in the object hierarchy and the list of "
3673 "implemented or required interfaces, add them to a Private subsection. "
3674 "Whether you would place GObject and GObjectClass like structs in public or "
3675 "Standard section depends if they have public entries (variables, vmethods)."
3676 msgstr ""
3677 "Csoportosíthatja a szakaszban lévő elemeket a &lt;SUBSECTION&gt; címke "
3678 "használatával. Jelenleg üres sort ír ki az alfejezetek között az "
3679 "összefoglaló szakaszban. Használhatja a &lt;SUBSECTION Standard&gt; címkét "
3680 "is a szabványos GObject deklarációkhoz (például az olyan függvényekhez, mint "
3681 "a g_object_get_type és az olyan makrókhoz, mint a G_OBJECT(), G_IS_OBJECT() "
3682 "stb.). Jelenleg ezek kimaradnak a dokumentációból. Használhatja a "
3683 "&lt;SUBSECTION Private&gt; címkét is a privát deklarációkhoz, amelyek nem "
3684 "kerülnek kiírásra (ez egy praktikus módja annak, hogy elkerülje a nem "
3685 "használt deklarációkról szóló figyelmeztető üzeneteket). Ha a "
3686 "programkönyvtára olyan privát típusokat tartalmaz, amelyeket nem szeretne, "
3687 "hogy megjelenjenek az objektumhierarchiában és a megvalósított vagy "
3688 "szükséges interfészek listájában, adja őket egy Private alszakaszhoz. A "
3689 "GObject és GObjectClass típusú struktúrák publikus vagy a Standard szakaszba "
3690 "helyezése attól függ, hogy vannak-e publikus bejegyzéseik (változók, "
3691 "virtuális metódusok)."
3692
3693 #. (itstool) path: sect1/para
3694 #: C/index.docbook:2225
3695 msgid ""
3696 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3697 "#include files which are shown in the synopsis sections. It contains a comma-"
3698 "separate list of #include files, without the angle brackets. If you set it "
3699 "outside of any sections, it acts for all sections until the end of the file. "
3700 "If you set it within a section, it only applies to that section."
3701 msgstr ""
3702 "Használhatja az &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; jelölést is az #include "
3703 "fájlok megadásához, amelyek az összefoglaló szakaszokban jelennek meg. Az "
3704 "#include fájlok vesszővel elválasztott listáját tartalmazza, szögletes "
3705 "zárójelek nélkül. Ha bármelyik szakaszon kívül állítja be, akkor a fájl "
3706 "végéig az összes szakaszra vonatkozik. Ha egy szakaszon belül állítja be, "
3707 "akkor csak arra a szakaszra vonatkozik."
3708
3709 #. (itstool) path: chapter/title
3710 #: C/index.docbook:2239
3711 msgid "Controlling the result"
3712 msgstr "Az eredmény ellenőrzése"
3713
3714 #. (itstool) path: chapter/para
3715 #: C/index.docbook:2241
3716 msgid ""
3717 "A GTK-Doc run generates report files inside the documentation directory. The "
3718 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3719 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3720 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3721 "files that can be viewed and postprocessed easily."
3722 msgstr ""
3723 "A GTK-Doc futtatása jelentésfájlokat állít elő a dokumentációs könyvtáron "
3724 "belül. Az előállított fájlok neve: <filename>&lt;csomag&gt;-"
3725 "undocumented.txt</filename>, <filename>&lt;csomag&gt;-undeclared.txt</"
3726 "filename> és <filename>&lt;csomag&gt;-unused.txt</filename>. Ezek mind "
3727 "egyszerű szöveges fájlok, amelyek könnyen megtekinthetők és utólagosan "
3728 "feldolgozhatók."
3729
3730 #. (itstool) path: chapter/para
3731 #: C/index.docbook:2250
3732 msgid ""
3733 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3734 "the documentation coverage summary. Below are two sections divided by blank "
3735 "lines. The first section lists undocumented or incomplete symbols. The "
3736 "second section does the same for section docs. Incomplete entries are those, "
3737 "which have documentation, but where e.g. a new parameter has been added."
3738 msgstr ""
3739 "A <filename>&lt;csomag&gt;-undocumented.txt</filename> fájl a dokumentáció "
3740 "lefedettségének összefoglalójával kezdődik. Alatta két, üres sorokkal "
3741 "elválasztott szakasz található. Az első szakasz a dokumentálatlan vagy "
3742 "hiányos szimbólumokat sorolja fel. A második szakasz ugyanezt teszi a "
3743 "szakaszok dokumentációira. A hiányos bejegyzések azok, amelyeknek van "
3744 "dokumentációja, de ahol például új paraméter került hozzáadásra."
3745
3746 #. (itstool) path: chapter/para
3747 #: C/index.docbook:2259
3748 msgid ""
3749 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3750 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3751 "in the sources. Check if they have been removed or if they are misspelled."
3752 msgstr ""
3753 "A <filename>&lt;csomag&gt;-undeclared.txt</filename> fájl a "
3754 "<filename>&lt;csomag&gt;-sections.txt</filename> fájlban megadott, de a "
3755 "forrásokban nem található szimbólumokat sorolja fel. Ellenőrizze, hogy nem "
3756 "kerültek-e eltávolításra, vagy nincsenek-e hibásan írva."
3757
3758 #. (itstool) path: chapter/para
3759 #: C/index.docbook:2266
3760 msgid ""
3761 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3762 "where the GTK-Doc scanner has found documentation, but does not know where "
3763 "to put it. This means that the symbol has not yet been added to the "
3764 "<filename>&lt;package&gt;-sections.txt</filename> file."
3765 msgstr ""
3766 "A <filename>&lt;csomag&gt;-unused.txt</filename> fájl azokat a "
3767 "szimbólumneveket sorolja fel, ahol a GTK-Doc átvizsgáló talált "
3768 "dokumentációt, de nem tudja, hova tegye azt. Ez azt jelenti, hogy a "
3769 "szimbólum még nem lett hozzáadva a <filename>&lt;csomag&gt;-sections.txt</"
3770 "filename> fájlhoz."
3771
3772 #. (itstool) path: tip/para
3773 #: C/index.docbook:2274
3774 msgid ""
3775 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in "
3776 "Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity "
3777 "checks during <command>make check</command> run."
3778 msgstr ""
3779 "Engedélyezze vagy adja hozzá a <option>TESTS=$(GTKDOC_CHECK)</option> sort a "
3780 "Makefile.am fájlhoz. Ha legalább GTK-Doc 1.9 van telepítve, akkor ez "
3781 "józansági ellenőrzéseket futtat a <command>make check</command> futtatása "
3782 "során."
3783
3784 #. (itstool) path: chapter/para
3785 #: C/index.docbook:2281
3786 msgid ""
3787 "One can also look at the files produced by the source code scanner: "
3788 "<filename>&lt;package&gt;-decl-list.txt</filename> and "
3789 "<filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared "
3790 "with the section file if that is manually maintained. The second lists all "
3791 "declarations from the headers. If a symbol is missing one could check if "
3792 "this file contains it."
3793 msgstr ""
3794 "A forráskód-átvizsgáló által előállított fájlokat is megnézhetjük: "
3795 "<filename>&lt;csomag&gt;-decl-list.txt</filename> és "
3796 "<filename>&lt;csomag&gt;-decl.txt</filename>. Az elsőt össze lehet "
3797 "hasonlítani a szakaszfájllal, ha az kézzel van karbantartva. A második a "
3798 "fejlécekből származó összes deklarációt sorolja fel. Ha egy szimbólum "
3799 "hiányzik, akkor ellenőrizhetjük, hogy ez a fájl tartalmazza-e."
3800
3801 #. (itstool) path: chapter/para
3802 #: C/index.docbook:2290
3803 msgid ""
3804 "If the project is GObject based, one can also look into the files produced "
3805 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3806 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
3807 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
3808 "<filename>&lt;package&gt;.prerequisites.txt</filename> and "
3809 "<filename>&lt;package&gt;.signals.txt</filename>. If there are missing "
3810 "symbols in any of those, one can ask GTK-Doc to keep the intermediate "
3811 "scanner file for further analysis, by running it as "
3812 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3813 msgstr ""
3814 "Ha a projekt GObject-alapú, akkor az objektum-átvizsgáló által előállított "
3815 "fájlokat is megnézhetjük: <filename>&lt;csomag&gt;.args.txt</filename>, "
3816 "<filename>&lt;csomag&gt;.hierarchy.txt</filename>, "
3817 "<filename>&lt;csomag&gt;.interfaces.txt</filename>, "
3818 "<filename>&lt;csomag&gt;.prerequisites.txt</filename> és "
3819 "<filename>&lt;csomag&gt;.signals.txt</filename>. Ha ezek bármelyikéből "
3820 "hiányoznak szimbólumok, akkor a <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</"
3821 "command> futtatásával megkérhetjük a GTK-Doc eszközt arra, hogy tartsa meg a "
3822 "köztes átvizsgálási fájlt a további elemzéshez."
3823
3824 #. (itstool) path: chapter/title
3825 #: C/index.docbook:2305
3826 msgid "Modernizing the documentation"
3827 msgstr "A dokumentáció korszerűsítése"
3828
3829 #. (itstool) path: chapter/para
3830 #: C/index.docbook:2307
3831 msgid ""
3832 "GTK-Doc has been around for quite some time. In this section we list new "
3833 "features together with the version since when it is available."
3834 msgstr ""
3835 "A GTK-Doc már jó ideje létezik. Ebben a részben felsoroljuk az új funkciókat "
3836 "a verzióval együtt, amióta elérhetők."
3837
3838 #. (itstool) path: sect1/title
3839 #: C/index.docbook:2313
3840 msgid "GTK-Doc 1.9"
3841 msgstr "GTK-Doc 1.9"
3842
3843 #. (itstool) path: sect1/para
3844 #: C/index.docbook:2315
3845 msgid ""
3846 "When using xml instead of sgml, one can actually name the master document "
3847 "<filename>&lt;package&gt;-docs.xml</filename>."
3848 msgstr ""
3849 "Ha SGML helyett XML-t használunk, a mesterdokumentumot "
3850 "<filename>&lt;csomag&gt;-docs.xml</filename> néven is elnevezhetjük."
3851
3852 #. (itstool) path: sect1/para
3853 #: C/index.docbook:2320
3854 msgid ""
3855 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3856 "<filename>Makefile.am</filename>. When this is enabled, the "
3857 "<filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can "
3858 "be removed from the vcs. This only works nicely for projects that have a "
3859 "very regular structure (e.g. each .{c,h} pair will create new section). If "
3860 "one organize a project close to that updating a manually maintained section "
3861 "file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt "
3862 "&lt;package&gt;-sections.txt</code>."
3863 msgstr ""
3864 "Ez a verzió támogatja a <option>SCAN_OPTIONS=--rebuild-sections</option> "
3865 "kapcsolót a <filename>Makefile.am</filename> fájlban. Ha ez engedélyezve "
3866 "van, akkor a <filename>&lt;csomag&gt;-sections.txt</filename> fájl "
3867 "automatikusan előállításra kerül, és eltávolítható a verziókövető "
3868 "rendszerből. Ez csak olyan projekteknél működik jól, amelyek rendkívül "
3869 "szabályos szerkezettel rendelkeznek (például minden .{c,h} pár új szakaszt "
3870 "hoz létre). Ha valaki egy ehhez közeli projektet szervez, egy kézzel "
3871 "karbantartott szakaszfájl frissítése olyan egyszerű lehet, mint a <code>meld "
3872 "&lt;csomag&gt;-decl-list.txt &lt;csomag&gt;-sections.txt</code> kód "
3873 "futtatása."
3874
3875 #. (itstool) path: sect1/para
3876 #: C/index.docbook:2331
3877 msgid ""
3878 "Version 1.8 already introduced the syntax for documenting sections in the "
3879 "sources instead of the separate files under <filename "
3880 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
3881 "whole doc module to not use the extra tmpl build step at all, by using "
3882 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
3883 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
3884 "your source control system and haven't yet switched, just add the flag to "
3885 "<filename>configure.ac</filename> and you are done."
3886 msgstr ""
3887 "Az 1.8-as verzió már bevezette a szintaxist a szakaszok forrásokban történő "
3888 "dokumentálásához a <filename class=\"directory\">tmpl</filename> alatti "
3889 "különálló fájlok helyett. Ez a verzió olyan kapcsolókat ad hozzá, amelyekkel "
3890 "az egész dokumentációs modult át lehet kapcsolni úgy, hogy egyáltalán ne "
3891 "használja a további sablon-összeállítási lépést. Ehhez a <option>--flavour "
3892 "no-tmpl</option> kapcsolót kell használni a <filename>configure.ac</"
3893 "filename> fájlban. Ha még nincs <filename class=\"directory\">tmpl</"
3894 "filename> könyvtár lekérve a forráskövető rendszerében, és még nem lett "
3895 "átváltva, akkor csak adja hozzá a jelzőt a <filename>configure.ac</filename> "
3896 "fájlhoz, és már kész is van."
3897
3898 #. (itstool) path: sect1/title
3899 #: C/index.docbook:2343
3900 msgid "GTK-Doc 1.10"
3901 msgstr "GTK-Doc 1.10"
3902
3903 #. (itstool) path: sect1/para
3904 #: C/index.docbook:2345
3905 msgid ""
3906 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3907 "<filename>Makefile.am</filename>. When this is enabled, the "
3908 "<filename>&lt;package&gt;.types</filename> is autogenerated and can be "
3909 "removed from the vcs. When using this feature it is important to also setup "
3910 "the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3911 "code that is build conditionally."
3912 msgstr ""
3913 "Ez a verzió támogatja a <option>SCAN_OPTIONS=--rebuild-types</option> "
3914 "kapcsolót a <filename>Makefile.am</filename> fájlban. Ha ez engedélyezve "
3915 "van, akkor a <filename>&lt;csomag&gt;.types</filename> fájl automatikusan "
3916 "előállításra kerül, és eltávolítható a verziókövető rendszerből. A funkció "
3917 "használatakor fontos, hogy az <varname>IGNORE_HFILES</varname> is be legyen "
3918 "állítva a <filename>Makefile.am</filename> fájlban a feltételesen "
3919 "összeállított kódhoz."
3920
3921 #. (itstool) path: sect1/title
3922 #: C/index.docbook:2356
3923 msgid "GTK-Doc 1.16"
3924 msgstr "GTK-Doc 1.16"
3925
3926 #. (itstool) path: example/title
3927 #: C/index.docbook:2362
3928 msgid "Enable gtkdoc-check"
3929 msgstr "A gtkdoc-check engedélyezése"
3930
3931 #. (itstool) path: example/programlisting
3932 #: C/index.docbook:2363
3933 #, no-wrap
3934 msgid ""
3935 "\n"
3936 "if ENABLE_GTK_DOC\n"
3937 "TESTS_ENVIRONMENT = \\\n"
3938 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3939 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3940 "TESTS = $(GTKDOC_CHECK)\n"
3941 "endif\n"
3942 msgstr ""
3943 "\n"
3944 "if ENABLE_GTK_DOC\n"
3945 "TESTS_ENVIRONMENT = \\\n"
3946 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3947 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3948 "TESTS = $(GTKDOC_CHECK)\n"
3949 "endif\n"
3950
3951 #. (itstool) path: sect1/para
3952 #: C/index.docbook:2358
3953 msgid ""
3954 "This version includes a new tool called gtkdoc-check. This tool can run a "
3955 "set of sanity checks on your documentation. It is enabled by adding these "
3956 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3957 msgstr ""
3958 "Ez a verzió egy új, gtkdoc-check nevű eszközt tartalmaz. Ez az eszköz képes "
3959 "lefuttatni egy sor józansági ellenőrzést a dokumentáción. Az engedélyezéshez "
3960 "hozzá kell adni ezeket a sorokat a <filename>Makefile.am</filename> fájl "
3961 "végéhez. <_:example-1/>"
3962
3963 #. (itstool) path: sect1/title
3964 #: C/index.docbook:2376
3965 msgid "GTK-Doc 1.20"
3966 msgstr "GTK-Doc 1.20"
3967
3968 #. (itstool) path: sect1/para
3969 #: C/index.docbook:2378
3970 msgid ""
3971 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3972 "comments is less intrusive than writing docbook xml. This version improves a "
3973 "lot on this and add a lot more styles. The section that explains the <link "
3974 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3975 msgstr ""
3976 "Az 1.18-as verzió hozott némi kezdeti Markdown-támogatást. A Markdown "
3977 "használata a dokumentációs megjegyzésekben kevésbé tolakodó, mint a DocBook "
3978 "XML írása. Ez a verzió sokat javít ezen, és sokkal több stílust ad hozzá. A "
3979 "<link linkend=\"documenting_syntax\">megjegyzés szintaxisát</link> magyarázó "
3980 "szakasz minden részletet tartalmaz."
3981
3982 #. (itstool) path: sect1/title
3983 #: C/index.docbook:2388
3984 msgid "GTK-Doc 1.25"
3985 msgstr "GTK-Doc 1.25"
3986
3987 #. (itstool) path: example/title
3988 #: C/index.docbook:2399
3989 msgid "Use pre-generated entities"
3990 msgstr "Előre előállított entitások használata"
3991
3992 #. (itstool) path: example/programlisting
3993 #: C/index.docbook:2400
3994 #, no-wrap
3995 msgid ""
3996 "\n"
3997 "&lt;?xml version=\"1.0\"?&gt;\n"
3998 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3999 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
4000 "[\n"
4001 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
4002 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
4003 " %gtkdocentities;\n"
4004 "]&gt;\n"
4005 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
4006 " &lt;bookinfo&gt;\n"
4007 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
4008 " &lt;releaseinfo&gt;\n"
4009 " for &amp;package_string;.\n"
4010 " The latest version of this documentation can be found on-line at\n"
4011 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
4012 " &lt;/releaseinfo&gt;\n"
4013 " &lt;/bookinfo&gt;\n"
4014 msgstr ""
4015 "\n"
4016 "&lt;?xml version=\"1.0\"?&gt;\n"
4017 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
4018 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
4019 "[\n"
4020 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
4021 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
4022 " %gtkdocentities;\n"
4023 "]&gt;\n"
4024 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
4025 " &lt;bookinfo&gt;\n"
4026 " &lt;title&gt;&amp;package_name; hivatkozási kézikönyv&lt;/title&gt;\n"
4027 " &lt;releaseinfo&gt;\n"
4028 " for &amp;package_string;.\n"
4029 " A dokumentáció legfrissebb változata megtalálható a\n"
4030 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt; internetes oldalon.\n"
4031 " &lt;/releaseinfo&gt;\n"
4032 " &lt;/bookinfo&gt;\n"
4033
4034 #. (itstool) path: sect1/para
4035 #: C/index.docbook:2390
4036 msgid ""
4037 "The makefiles shipped with this version generate an entity file at "
4038 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
4039 "package_name and package_version. You can use this e.g. in the main xml file "
4040 "to avoid hardcoding the version number. Below is an example that shows how "
4041 "the entity file is included in the master template and how the entities are "
4042 "used. The entities can also be used in all generated files, GTK-Doc will use "
4043 "the same xml header in generated xml files. <_:example-1/>"
4044 msgstr ""
4045 "Az ezzel a verzióval szállított makefile-ok létrehoznak egy entitásfájlt az "
4046 "<filename>xml/gtkdocentities.ent</filename> fájlban, amely például a "
4047 "package_name és package_version entitásokat tartalmazza. Ezt használhatja "
4048 "például a fő XML-fájlban, hogy elkerülje a verziószám kézi megadását. Az "
4049 "alábbiakban egy példa azt mutatja be, hogy az entitásfájl hogyan kerül a "
4050 "mestersablonba, és hogyan kell használni az entitásokat. Az entitások az "
4051 "összes előállított fájlban is használhatók, a GTK-Doc ugyanazt az XML-"
4052 "fejlécet fogja használni az előállított XML-fájlokban. <_:example-1/>"
4053
4054 #. (itstool) path: chapter/title
4055 #: C/index.docbook:2425
4056 msgid "Documenting other interfaces"
4057 msgstr "Egyéb interfészek dokumentálása"
4058
4059 #. (itstool) path: chapter/para
4060 #: C/index.docbook:2427
4061 msgid ""
4062 "So far we have been using GTK-Doc to document the API of code. The next "
4063 "sections contain suggestions how the tools can be used to document other "
4064 "interfaces too."
4065 msgstr ""
4066 "Eddig a GTK-Doc eszközt használtuk a kód API-jának dokumentálásához. A "
4067 "következő szakaszok javaslatokat tartalmaznak arra vonatkozóan, hogy az "
4068 "eszközök hogyan használhatók egyéb interfészek dokumentálásához is."
4069
4070 #. (itstool) path: sect1/title
4071 #: C/index.docbook:2434
4072 msgid "Command line options and man pages"
4073 msgstr "Parancssori kapcsolók és kézikönyvoldalak"
4074
4075 #. (itstool) path: sect1/para
4076 #: C/index.docbook:2436
4077 msgid ""
4078 "As one can generate man pages for a docbook refentry as well, it sounds like "
4079 "a good idea to use it for that purpose. This way the interface is part of "
4080 "the reference and one gets the man-page for free."
4081 msgstr ""
4082 "Mivel kézikönyvoldalakat is elő lehet állítani egy DocBook-hivatkozási "
4083 "bejegyzéshez, jó ötletnek tűnik, hogy erre a célra használjuk. Így az "
4084 "interfész a hivatkozás része lesz, a kézikönyvoldalt pedig ingyen megkapjuk."
4085
4086 #. (itstool) path: sect2/title
4087 #: C/index.docbook:2443
4088 msgid "Document the tool"
4089 msgstr "Az eszköz dokumentálása"
4090
4091 #. (itstool) path: sect2/para
4092 #: C/index.docbook:2445
4093 msgid ""
4094 "Create one refentry file per tool. Following <link "
4095 "linkend=\"settingup_docfiles\">our example</link> we would call it "
4096 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
4097 "that should be used and can look at generated file in the xml subdirectory "
4098 "as well as examples e.g. in glib."
4099 msgstr ""
4100 "Hozzon létre eszközönként egy hivatkozásibejegyzés-fájlt. A <link "
4101 "linkend=\"settingup_docfiles\">példánkat</link> követve elnevezhetjük "
4102 "<filename>meep/docs/reference/meeper/meep.xml</filename> néven. A "
4103 "használandó XML-címkék megtekinthetők az XML alkönyvtárban lévő előállított "
4104 "fájlban, valamint példák is találhatók például a glib csomagban."
4105
4106 #. (itstool) path: sect2/title
4107 #: C/index.docbook:2455
4108 msgid "Adding the extra configure check"
4109 msgstr "A további beállítás-ellenőrzés hozzáadása"
4110
4111 #. (itstool) path: example/title
4112 #: C/index.docbook:2458 C/index.docbook:2476
4113 msgid "Extra configure checks"
4114 msgstr "További beállítás-ellenőrzések"
4115
4116 #. (itstool) path: example/programlisting
4117 #: C/index.docbook:2459
4118 #, no-wrap
4119 msgid ""
4120 "\n"
4121 "AC_ARG_ENABLE(man,\n"
4122 " [AC_HELP_STRING([--enable-man],\n"
4123 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4124 " enable_man=no)\n"
4125 "\n"
4126 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4127 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4128 msgstr ""
4129 "\n"
4130 "AC_ARG_ENABLE(man,\n"
4131 " [AC_HELP_STRING([--enable-man],\n"
4132 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4133 " enable_man=no)\n"
4134 "\n"
4135 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4136 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4137
4138 #. (itstool) path: sect2/title
4139 #: C/index.docbook:2473
4140 msgid "Adding the extra makefile rules"
4141 msgstr "A további makefile-szabályok hozzáadása"
4142
4143 #. (itstool) path: example/programlisting
4144 #: C/index.docbook:2477
4145 #, no-wrap
4146 msgid ""
4147 "\n"
4148 "man_MANS = \\\n"
4149 " meeper.1\n"
4150 "\n"
4151 "if ENABLE_GTK_DOC\n"
4152 "if ENABLE_MAN\n"
4153 "\n"
4154 "%.1 : %.xml\n"
4155 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4156 "\n"
4157 "endif\n"
4158 "endif\n"
4159 "\n"
4160 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4161 "EXTRA_DIST += meep.xml\n"
4162 msgstr ""
4163 "\n"
4164 "man_MANS = \\\n"
4165 " meeper.1\n"
4166 "\n"
4167 "if ENABLE_GTK_DOC\n"
4168 "if ENABLE_MAN\n"
4169 "\n"
4170 "%.1 : %.xml\n"
4171 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4172 "\n"
4173 "endif\n"
4174 "endif\n"
4175 "\n"
4176 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4177 "EXTRA_DIST += meep.xml\n"
4178
4179 #. (itstool) path: sect1/title
4180 #: C/index.docbook:2499
4181 msgid "DBus interfaces"
4182 msgstr "DBus interfészek"
4183
4184 #. (itstool) path: sect1/para
4185 #: C/index.docbook:2501
4186 msgid ""
4187 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4188 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4189 msgstr ""
4190 "(JAVÍTS KI: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4191 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4192
4193 #. (itstool) path: chapter/title
4194 #: C/index.docbook:2510
4195 msgid "Frequently asked questions"
4196 msgstr "Gyakran ismételt kérdések"
4197
4198 #. (itstool) path: segmentedlist/segtitle
4199 #: C/index.docbook:2514
4200 msgid "Question"
4201 msgstr "Kérdés"
4202
4203 #. (itstool) path: segmentedlist/segtitle
4204 #: C/index.docbook:2515
4205 msgid "Answer"
4206 msgstr "Válasz"
4207
4208 #. (itstool) path: seglistitem/seg
4209 #: C/index.docbook:2517
4210 msgid "No class hierarchy."
4211 msgstr "Nincs osztályhierarchia."
4212
4213 #. (itstool) path: seglistitem/seg
4214 #: C/index.docbook:2518
4215 msgid ""
4216 "The objects <function>xxx_get_type()</function> function has not been "
4217 "entered into the <filename>&lt;package&gt;.types</filename> file."
4218 msgstr ""
4219 "Az objektumok <function>xxx_get_type()</function> függvénye nem került be a "
4220 "<filename>&lt;csomag&gt;.types</filename> fájlba."
4221
4222 #. (itstool) path: seglistitem/seg
4223 #: C/index.docbook:2524
4224 msgid "Still no class hierarchy."
4225 msgstr "Még mindig nincs osztályhierarchia."
4226
4227 #. (itstool) path: seglistitem/seg
4228 #: C/index.docbook:2525
4229 msgid ""
4230 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4231 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4232 "October/msg00006.html\">explanation</ulink>)."
4233 msgstr ""
4234 "Hiányzó vagy hibás elnevezés a <filename>&lt;csomag&gt;-sections.txt</"
4235 "filename> fájlban (nézze meg a <ulink url=\"http://mail.gnome.org/archives/"
4236 "gtk-doc-list/2003-October/msg00006.html\">magyarázatot</ulink>)."
4237
4238 #. (itstool) path: seglistitem/seg
4239 #: C/index.docbook:2531
4240 msgid "Damn, I have still no class hierarchy."
4241 msgstr "A fenébe, még mindig nincs osztályhierarchiám."
4242
4243 #. (itstool) path: seglistitem/seg
4244 #: C/index.docbook:2532
4245 msgid ""
4246 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4247 "type>) part of the normal section (don't put this into Standard or Private "
4248 "subsections)."
4249 msgstr ""
4250 "Az objektum neve (a példánystruktúra neve, például <type>GtkWidget</type>) a "
4251 "normál szakasz része (ne tegye ezt a Standard vagy Private alszakaszokba)?"
4252
4253 #. (itstool) path: seglistitem/seg
4254 #: C/index.docbook:2539
4255 msgid "No symbol index."
4256 msgstr "Nincs szimbólumindex."
4257
4258 #. (itstool) path: seglistitem/seg
4259 #: C/index.docbook:2540
4260 msgid ""
4261 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4262 "index that xi:includes the generated index?"
4263 msgstr ""
4264 "A <filename>&lt;csomag&gt;-docs.{xml,sgml}</filename> tartalmaz olyan "
4265 "indexet, amely xi:include-olja az előállított indexet?"
4266
4267 #. (itstool) path: seglistitem/seg
4268 #: C/index.docbook:2546
4269 msgid "Symbols are not linked to their doc-section."
4270 msgstr "A szimbólumok nem kapcsolódnak a dokumentumszakaszukhoz."
4271
4272 #. (itstool) path: seglistitem/seg
4273 #: C/index.docbook:2547
4274 msgid ""
4275 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4276 "gtkdoc-fixxref warns about unresolvable xrefs."
4277 msgstr ""
4278 "A doc-comment a megfelelő jelölést használja (hozzáadott #, % vagy () "
4279 "jelölőket)? Ellenőrizze, hogy a gtkdoc-fixxref figyelmeztet-e a nem "
4280 "feloldható xref-ekre."
4281
4282 #. (itstool) path: seglistitem/seg
4283 #: C/index.docbook:2553
4284 msgid "A new class does not appear in the docs."
4285 msgstr "Egy új osztály nem jelenik meg a dokumentációban."
4286
4287 #. (itstool) path: seglistitem/seg
4288 #: C/index.docbook:2554
4289 msgid ""
4290 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4291 "filename>."
4292 msgstr ""
4293 "Az új oldal xi:include-olva van a <filename>&lt;csomag&gt;-docs.{xml,sgml}</"
4294 "filename> fájlból?"
4295
4296 #. (itstool) path: seglistitem/seg
4297 #: C/index.docbook:2560
4298 msgid "A new symbol does not appear in the docs."
4299 msgstr "Egy új szimbólum nem jelenik meg a dokumentációban."
4300
4301 #. (itstool) path: seglistitem/seg
4302 #: C/index.docbook:2561
4303 msgid ""
4304 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4305 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4306 "xrefs. Check if the symbol is correctly listed in the "
4307 "<filename>&lt;package&gt;-sections.txt</filename> in a public subsection."
4308 msgstr ""
4309 "Megfelelően van formázva a doc-comment tulajdonság? Ellenőrizze, hogy "
4310 "nincsenek-e helyesírási hibák a megjegyzés elején. Ellenőrizze, hogy a "
4311 "gtkdoc-fixxref figyelmeztet-e a feloldhatatlan xref-ekre. Ellenőrizze, hogy "
4312 "a szimbólum helyesen van-e felsorolva a <filename>&lt;csomag&gt;-"
4313 "sections.txt</filename> fájl egy nyilvános alszakaszában."
4314
4315 #. (itstool) path: seglistitem/seg
4316 #: C/index.docbook:2569
4317 msgid "A type is missing from the class hierarchy."
4318 msgstr "Egy típus hiányzik az osztályhierarchiából."
4319
4320 #. (itstool) path: seglistitem/seg
4321 #: C/index.docbook:2570
4322 msgid ""
4323 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4324 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4325 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4326 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4327 "or incidentally marked private it will not be shown."
4328 msgstr ""
4329 "Ha a típus fel van sorolva a <filename>&lt;csomag&gt;.hierarchy</filename> "
4330 "fájlban, de nincs az <filename>xml/tree_index.sgml</filename> fájlban, akkor "
4331 "ellenőrizze kétszer is, hogy a típus helyesen van-e elhelyezve a "
4332 "<filename>&lt;csomag&gt;-sections.txt</filename> fájlban. Ha a típuspéldány "
4333 "(például <type>GtkWidget</type>) nincs felsorolva vagy véletlenül privátként "
4334 "van megjelölve, akkor nem fog megjelenni."
4335
4336 #. (itstool) path: seglistitem/seg
4337 #: C/index.docbook:2579
4338 msgid "I get foldoc links for all gobject annotations."
4339 msgstr "Az összes gobject megjegyzéshez foldoc hivatkozásokat kapok."
4340
4341 #. (itstool) path: seglistitem/seg
4342 #: C/index.docbook:2580
4343 msgid ""
4344 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4345 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4346 msgstr ""
4347 "Ellenőrizze, hogy az <filename>xml/annotation-glossary.xml</filename> fájl "
4348 "xi:include-olva van-e a <filename>&lt;csomag&gt;-docs.{xml,sgml}</filename> "
4349 "fájlból."
4350
4351 #. (itstool) path: seglistitem/seg
4352 #: C/index.docbook:2588
4353 msgid "Parameter described in source code comment block but does not exist"
4354 msgstr ""
4355 "A paraméter le van írva a forráskód megjegyzésblokkjában, de nem létezik"
4356
4357 #. (itstool) path: seglistitem/seg
4358 #: C/index.docbook:2589
4359 msgid ""
4360 "Check if the prototype in the header has different parameter names as in the "
4361 "source."
4362 msgstr ""
4363 "Ellenőrizze, hogy a fejlécben lévő prototípusnak más paraméternevei vannak-"
4364 "e, mint a forrásban."
4365
4366 #. (itstool) path: seglistitem/seg
4367 #: C/index.docbook:2594
4368 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4369 msgstr "Több „azonosító” a korlátozó hivatkozásvéghez: XYZ"
4370
4371 #. (itstool) path: seglistitem/seg
4372 #: C/index.docbook:2595
4373 msgid ""
4374 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4375 "filename> file."
4376 msgstr ""
4377 "Az XYZ szimbólum kétszer jelenik meg a <filename>&lt;csomag&gt;-"
4378 "sections.txt</filename> fájlban."
4379
4380 #. (itstool) path: seglistitem/seg
4381 #: C/index.docbook:2598
4382 msgid ""
4383 "Element typename in namespace '' encountered in para, but no template "
4384 "matches."
4385 msgstr ""
4386 "A „” névtérben lévő típusnév elem megtalálható a bekezdésben, de nincs "
4387 "megfelelő sablon."
4388
4389 #. (itstool) path: chapter/title
4390 #: C/index.docbook:2605
4391 msgid "Tools related to gtk-doc"
4392 msgstr "A GTK-Doc kapcsolódó eszközei"
4393
4394 #. (itstool) path: chapter/para
4395 #: C/index.docbook:2607
4396 msgid ""
4397 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4398 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4399 "integrates with the trac search."
4400 msgstr ""
4401 "GtkDocPlugin – egy <ulink url=\"http://trac-hacks.org/wiki/"
4402 "GtkDocPlugin\">Trac GTK-Doc</ulink> integrációs bővítmény, amely API-"
4403 "dokumentációkat ad egy trac oldalhoz, és integrálódik a trac keresővel."
4404
4405 #. (itstool) path: chapter/para
4406 #: C/index.docbook:2612
4407 msgid ""
4408 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4409 "tags in the API to determine the minimum required version."
4410 msgstr ""
4411 "Gtkdoc-depscan – egy eszköz (a GTK-Doc része), amely ellenőrzi a használt "
4412 "API-t, hogy mióta vannak a címkék az API-ban, hogy meghatározza a "
4413 "minimálisan szükséges verziót."
4414
4415 #. (itstool) path: appendixinfo/releaseinfo
4416 #: C/fdl-appendix.xml:12
4417 msgid "Version 1.1, March 2000"
4418 msgstr "1.1-es verzió, 2000. március"
4419
4420 #. (itstool) path: copyright/year
4421 #: C/fdl-appendix.xml:16
4422 msgid "2000"
4423 msgstr "2000"
4424
4425 #. (itstool) path: copyright/holder
4426 #: C/fdl-appendix.xml:16
4427 msgid "Free Software Foundation, Inc."
4428 msgstr "Free Software Foundation, Inc."
4429
4430 #. (itstool) path: address/street
4431 #: C/fdl-appendix.xml:20
4432 msgid "51 Franklin Street, Suite 330"
4433 msgstr "51 Franklin Street, Suite 330"
4434
4435 #. (itstool) path: address/city
4436 #: C/fdl-appendix.xml:21
4437 msgid "Boston"
4438 msgstr "Boston"
4439
4440 #. (itstool) path: address/state
4441 #: C/fdl-appendix.xml:21
4442 msgid "MA"
4443 msgstr "MA"
4444
4445 #. (itstool) path: address/postcode
4446 #: C/fdl-appendix.xml:22
4447 msgid "02110-1301"
4448 msgstr "02110-1301"
4449
4450 #. (itstool) path: address/country
4451 #: C/fdl-appendix.xml:22
4452 msgid "USA"
4453 msgstr "USA"
4454
4455 #. (itstool) path: para/address
4456 #: C/fdl-appendix.xml:20
4457 msgid ""
4458 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4459 "<_:postcode-4/> <_:country-5/>"
4460 msgstr ""
4461 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4462 "<_:postcode-4/> <_:country-5/>"
4463
4464 #. (itstool) path: legalnotice/para
4465 #: C/fdl-appendix.xml:19
4466 msgid ""
4467 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4468 "of this license document, but changing it is not allowed."
4469 msgstr ""
4470 "<_:address-1/> A jelen licencdokumentumot bárki szabadon lemásolhatja és a "
4471 "pontos másolatait terjesztheti, de a módosítása tilos."
4472
4473 #. (itstool) path: appendix/title
4474 #. (itstool) path: para/quote
4475 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4476 msgid "GNU Free Documentation License"
4477 msgstr "GNU Free Documentation License (nem hivatalos magyar fordítás)"
4478
4479 #. (itstool) path: sect1/title
4480 #: C/fdl-appendix.xml:31
4481 msgid "0. PREAMBLE"
4482 msgstr "0. ELŐSZÓ"
4483
4484 #. (itstool) path: para/quote
4485 #: C/fdl-appendix.xml:34
4486 msgid "free"
4487 msgstr "szabaddá"
4488
4489 #. (itstool) path: sect1/para
4490 #: C/fdl-appendix.xml:32
4491 msgid ""
4492 "The purpose of this License is to make a manual, textbook, or other written "
4493 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4494 "effective freedom to copy and redistribute it, with or without modifying it, "
4495 "either commercially or noncommercially. Secondarily, this License preserves "
4496 "for the author and publisher a way to get credit for their work, while not "
4497 "being considered responsible for modifications made by others."
4498 msgstr ""
4499 "Jelen Licenc célja egy tetszőleges kézikönyv, tankönyv, vagy más, ehhez "
4500 "hasonló írott dokumentum a szó szoros értelmében <_:quote-1/> tétele: annak "
4501 "érdekében, hogy mindenkinek biztosítsa a szöveg sokszorosításának és "
4502 "terjesztésének teljes szabadságát, módosításokkal, vagy anélkül, akár "
4503 "kereskedelmi, akár nem kereskedelmi területen. Másfelől, e Licenc megőrzi a "
4504 "szerző vagy kiadó munkájának elismeréséhez fűződő jogát, s egyúttal "
4505 "mentesíti őt a mások által beiktatott módosítások következményei alól."
4506
4507 #. (itstool) path: para/quote
4508 #: C/fdl-appendix.xml:44
4509 msgid "copyleft"
4510 msgstr "copyleft"
4511
4512 #. (itstool) path: sect1/para
4513 #: C/fdl-appendix.xml:43
4514 msgid ""
4515 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4516 "the document must themselves be free in the same sense. It complements the "
4517 "GNU General Public License, which is a copyleft license designed for free "
4518 "software."
4519 msgstr ""
4520 "A jelen Licenc egyfajta <_:quote-1/> licencnek tekintendő: ez azt jelenti, "
4521 "hogy a dokumentumból származtatott munkák maguk is szabad minősítést kell, "
4522 "hogy kapjanak. Ez a dokumentum egyben a GNU General Public License "
4523 "kiegészítőjeként is szolgál, mely egy, a szabad szoftverekre vonatkozó "
4524 "etalon licenc."
4525
4526 #. (itstool) path: sect1/para
4527 #: C/fdl-appendix.xml:50
4528 msgid ""
4529 "We have designed this License in order to use it for manuals for free "
4530 "software, because free software needs free documentation: a free program "
4531 "should come with manuals providing the same freedoms that the software does. "
4532 "But this License is not limited to software manuals; it can be used for any "
4533 "textual work, regardless of subject matter or whether it is published as a "
4534 "printed book. We recommend this License principally for works whose purpose "
4535 "is instruction or reference."
4536 msgstr ""
4537 "A jelen Licenc a szabad szoftverek kézikönyveihez való használatra készült, "
4538 "hiszen a szabad szoftver egyben szabad dokumentációt is igényel: egy szabad "
4539 "programot olyan kézikönyvvel kell ellátni, amely ugyanazon szabadságokat "
4540 "biztosítja, mint maga a program. Mindazonáltal a jelen Licenc nem "
4541 "korlátozódik pusztán kézikönyvekre; feltételei tetszőleges tárgykörű írott "
4542 "dokumentumra alkalmazhatók, függetlenül attól, hogy az könyvformában valaha "
4543 "megjelent-e. Mindamellett e Licencet főként olyan munkákhoz ajánljuk, melyek "
4544 "elsődleges célja az útmutatás vagy a tájékoztatás."
4545
4546 #. (itstool) path: sect1/title
4547 #: C/fdl-appendix.xml:62
4548 msgid "1. APPLICABILITY AND DEFINITIONS"
4549 msgstr "1. ALKALMAZHATÓSÁG ÉS DEFINÍCIÓK"
4550
4551 #. (itstool) path: para/quote
4552 #. (itstool) path: para/link
4553 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4554 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4555 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4556 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4557 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4558 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4559 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4560 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4561 #: C/fdl-appendix.xml:608
4562 msgid "Document"
4563 msgstr "Dokumentum"
4564
4565 #. (itstool) path: para/quote
4566 #: C/fdl-appendix.xml:69
4567 msgid "you"
4568 msgstr "Ön"
4569
4570 #. (itstool) path: sect1/para
4571 #: C/fdl-appendix.xml:63
4572 msgid ""
4573 "This License applies to any manual or other work that contains a notice "
4574 "placed by the copyright holder saying it can be distributed under the terms "
4575 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4576 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4577 msgstr ""
4578 "A jelen Licenc minden olyan kézikönyvre, vagy más jellegű munkára "
4579 "vonatkozik, amelyen megtalálható a szerzői jog tulajdonosa által "
4580 "feltüntetett figyelmeztetés, miszerint a dokumentum terjesztése jelen Licenc "
4581 "feltételei alapján lehetséges. Az alábbiakban használt <_:quote-1/> "
4582 "kifejezés bármely ilyen jellegű kézikönyvre, vagy egyéb munkára vonatkozhat. "
4583 "A nyilvánosság bármely tagja potenciális licenctulajdonosnak tekinthető, és "
4584 "a továbbiakban az <_:quote-2/> megszólítást használjuk rá."
4585
4586 #. (itstool) path: para/quote
4587 #. (itstool) path: para/link
4588 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4589 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4590 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4591 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4592 msgid "Modified Version"
4593 msgstr "Módosított Változata"
4594
4595 #. (itstool) path: sect1/para
4596 #: C/fdl-appendix.xml:72
4597 msgid ""
4598 "A <_:quote-1/> of the Document means any work containing the Document or a "
4599 "portion of it, either copied verbatim, or with modifications and/or "
4600 "translated into another language."
4601 msgstr ""
4602 "A Dokumentum <_:quote-1/> bármely olyan munkára vonatkozik, amely "
4603 "tartalmazza a Dokumentumot, vagy annak elemeit akár szó szerint, akár "
4604 "módosításokkal, és/vagy más nyelvre lefordítva. "
4605
4606 #. (itstool) path: para/quote
4607 #: C/fdl-appendix.xml:80
4608 msgid "Secondary Section"
4609 msgstr "Másodlagos szakasz"
4610
4611 #. (itstool) path: sect1/para
4612 #: C/fdl-appendix.xml:79
4613 msgid ""
4614 "A <_:quote-1/> is a named appendix or a front-matter section of the "
4615 "<_:link-2/> that deals exclusively with the relationship of the publishers "
4616 "or authors of the Document to the Document's overall subject (or to related "
4617 "matters) and contains nothing that could fall directly within that overall "
4618 "subject. (For example, if the Document is in part a textbook of mathematics, "
4619 "a Secondary Section may not explain any mathematics.) The relationship could "
4620 "be a matter of historical connection with the subject or with related "
4621 "matters, or of legal, commercial, philosophical, ethical or political "
4622 "position regarding them."
4623 msgstr ""
4624 "A <_:quote-1/> egy egyedi névvel bíró függelék, esetleg a <_:link-2/> egy "
4625 "bevezető szakasza, amely kizárólag a kiadóknak, vagy az alkotóknak a "
4626 "Dokumentum átfogó tárgyköréhez (vagy kapcsolódó témákhoz) fűződő viszonyáról "
4627 "szól, és nem tartalmaz semmi olyat, ami közvetlenül ezen átfogó témakör alá "
4628 "eshet. (Vagyis ha a Dokumentum részben egy matematika-tankönyv, akkor a "
4629 "Másodlagos szakasz nem tartalmazhat matematikai tárgyú magyarázatokat). A "
4630 "fenti kapcsolat tárgya lehet a témakörrel, vagy a kapcsolódó témákkal való "
4631 "történelmi viszony, illetve az azokra vonatkozó jogi, kereskedelmi, "
4632 "filozófiai, etikai, vagy politikai felfogás."
4633
4634 #. (itstool) path: para/quote
4635 #. (itstool) path: para/link
4636 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4637 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4638 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4639 msgid "Invariant Sections"
4640 msgstr "Nem Változtatható szakaszok"
4641
4642 #. (itstool) path: para/link
4643 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4644 msgid "Secondary Sections"
4645 msgstr "Másodlagos szakaszok"
4646
4647 #. (itstool) path: sect1/para
4648 #: C/fdl-appendix.xml:94
4649 msgid ""
4650 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
4651 "being those of Invariant Sections, in the notice that says that the "
4652 "<_:link-3/> is released under this License."
4653 msgstr ""
4654 "A <_:quote-1/> olyan <_:link-2/>, amelyek címe Nem Változtatható szakaszként "
4655 "van megjelölve abban a közleményben, amely szerint a <_:link-3/> a jelen "
4656 "Licenc hatálya alatt lett kiadva."
4657
4658 #. (itstool) path: para/quote
4659 #. (itstool) path: para/link
4660 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4661 #: C/fdl-appendix.xml:458
4662 msgid "Cover Texts"
4663 msgstr "Borítószövegek"
4664
4665 #. (itstool) path: sect1/para
4666 #: C/fdl-appendix.xml:103
4667 msgid ""
4668 "The <_:quote-1/> are certain short passages of text that are listed, as "
4669 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the "
4670 "<_:link-2/> is released under this License."
4671 msgstr ""
4672 "A <_:quote-1/> olyan rövid szövegrészek, melyek Címlapszövegként, illetve "
4673 "Hátlapszövegként kerülnek felsorolásra a közleményben, amely szerint a "
4674 "<_:link-2/> a jelen Licenc hatálya alatt lett kiadva."
4675
4676 #. (itstool) path: para/quote
4677 #. (itstool) path: para/link
4678 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4679 #: C/fdl-appendix.xml:369
4680 msgid "Transparent"
4681 msgstr "Átlátszó"
4682
4683 #. (itstool) path: para/quote
4684 #. (itstool) path: para/link
4685 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4686 msgid "Opaque"
4687 msgstr "Átlátszatlan"
4688
4689 #. (itstool) path: sect1/para
4690 #: C/fdl-appendix.xml:111
4691 msgid ""
4692 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4693 "represented in a format whose specification is available to the general "
4694 "public, whose contents can be viewed and edited directly and "
4695 "straightforwardly with generic text editors or (for images composed of "
4696 "pixels) generic paint programs or (for drawings) some widely available "
4697 "drawing editor, and that is suitable for input to text formatters or for "
4698 "automatic translation to a variety of formats suitable for input to text "
4699 "formatters. A copy made in an otherwise Transparent file format whose markup "
4700 "has been designed to thwart or discourage subsequent modification by readers "
4701 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
4702 msgstr ""
4703 "A <_:link-2/> <_:quote-1/> példánya olyan géppel olvasható változatot "
4704 "jelent, amely a nyilvánosság számára hozzáférhető formátumban kerül "
4705 "terjesztésre, továbbá amelynek tartalma közvetlenül megtekinthető és "
4706 "szerkeszthető, és alkalmas a szokványos szövegszerkesztő-programokkal, "
4707 "illetve (pixelekből álló képek esetén) szokványos képmegjelenítő-"
4708 "programokkal, vagy (rajzok esetén) általánosan hozzáférhető rajzprogramok "
4709 "segítségével azonnali és közvetlen változtatásokra; továbbá olyan "
4710 "formátumban mely alkalmas a szövegszerkesztőkbe való bevitelre, vagy a "
4711 "szövegszerkesztők által kezelt formátumokra való automatikus átalakításra. "
4712 "Egy olyan, egyébként Átlátszó formátumban készült példány, melynek a "
4713 "jelölőnyelve úgy lett kialakítva, hogy megakadályozza, vagy eltántorítsa az "
4714 "olvasókat minden további módosítástól, nem tekinthető Átlátszónak. A nem "
4715 "<_:quote-3/> példányok az <_:quote-4/> megnevezést kapják."
4716
4717 #. (itstool) path: sect1/para
4718 #: C/fdl-appendix.xml:128
4719 msgid ""
4720 "Examples of suitable formats for Transparent copies include plain ASCII "
4721 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4722 "a publicly available DTD, and standard-conforming simple HTML designed for "
4723 "human modification. Opaque formats include PostScript, PDF, proprietary "
4724 "formats that can be read and edited only by proprietary word processors, "
4725 "SGML or XML for which the DTD and/or processing tools are not generally "
4726 "available, and the machine-generated HTML produced by some word processors "
4727 "for output purposes only."
4728 msgstr ""
4729 "Az Átlátszóság kritériumainak megfelelő formátumok között megtalálható "
4730 "például a jelölőnyelvet nem használó egyszerű ASCII, a Texinfo beviteli "
4731 "formátum, a LaTeX beviteli formátum, az SGML vagy az XML egy általánosan "
4732 "hozzáférhető DTD használatával, és a szabványnak megfelelő, emberi "
4733 "módosításra tervezett egyszerű HTML. Az Átlátszatlan formátumok közé "
4734 "sorolhatóak a PostScript, a PDF, a szellemi tulajdont képező formátumok, "
4735 "amelyeket csak szellemi tulajdont képező szövegszerkesztőkkel lehet "
4736 "elolvasni, az olyan SGML vagy XML, amelyhez a szükséges DTD és/vagy egyéb "
4737 "feldolgozó eszközök nem általánosan hozzáférhetők, és az olyan gépileg "
4738 "generált HTML formátum, amely kizárólag egyes szövegszerkesztők kimeneti "
4739 "formátumaként áll elő."
4740
4741 #. (itstool) path: para/quote
4742 #. (itstool) path: para/link
4743 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4744 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4745 msgid "Title Page"
4746 msgstr "Címlap"
4747
4748 #. (itstool) path: sect1/para
4749 #: C/fdl-appendix.xml:141
4750 msgid ""
4751 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4752 "following pages as are needed to hold, legibly, the material this License "
4753 "requires to appear in the title page. For works in formats which do not have "
4754 "any title page as such, <_:quote-2/> means the text near the most prominent "
4755 "appearance of the work's title, preceding the beginning of the body of the "
4756 "text."
4757 msgstr ""
4758 "Egy nyomtatott könyv esetében a <_:quote-1/> magát a címlapot, illetve "
4759 "bármely azt kiegészítő további oldalt jelöli, amely a jelen Licencben előírt "
4760 "címlaptartalom közzétételéhez szükséges. Az olyan formátumú munkáknál, "
4761 "amelyek nem rendelkeznek effajta címlappal, a <_:quote-2/> a munka címének "
4762 "legjobban kiemelt változatához legközelebb eső, ám a szöveg törzsét megelőző "
4763 "szövegrészeket jelöli."
4764
4765 #. (itstool) path: sect1/title
4766 #: C/fdl-appendix.xml:153
4767 msgid "2. VERBATIM COPYING"
4768 msgstr "2. SZÓ SZERINTI SOKSZOROSÍTÁS"
4769
4770 #. (itstool) path: para/link
4771 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4772 msgid "section 3"
4773 msgstr "3. szakasz"
4774
4775 #. (itstool) path: sect1/para
4776 #: C/fdl-appendix.xml:154
4777 msgid ""
4778 "You may copy and distribute the <_:link-1/> in any medium, either "
4779 "commercially or noncommercially, provided that this License, the copyright "
4780 "notices, and the license notice saying this License applies to the Document "
4781 "are reproduced in all copies, and that you add no other conditions "
4782 "whatsoever to those of this License. You may not use technical measures to "
4783 "obstruct or control the reading or further copying of the copies you make or "
4784 "distribute. However, you may accept compensation in exchange for copies. If "
4785 "you distribute a large enough number of copies you must also follow the "
4786 "conditions in <_:link-2/>."
4787 msgstr ""
4788 "Önnek lehetősége van a <_:link-1/> kereskedelmi, vagy nem kereskedelmi "
4789 "jellegű sokszorosítására és terjesztésére a felhasznált adathordozó "
4790 "típusától függetlenül, feltéve, hogy a jelen Licenc, a szerzői jogi "
4791 "figyelmeztetés, továbbá a Dokumentumot a jelen Licenc hatálya alá rendelő "
4792 "közlemény minden példányban egyaránt megjelenik, és hogy ezeken kívül "
4793 "semmilyen feltételt nem szab meg a szöveghez. Nem alkalmazhat olyan "
4794 "technikai eszközöket, amelyekkel megakadályozható vagy szabályozható az Ön "
4795 "által terjesztett példányok elolvasása vagy sokszorosítása. Mindazonáltal "
4796 "elfogadhat ellenszolgáltatást a másolatokért cserébe. Amennyiben az Ön által "
4797 "terjesztett példányok száma meghalad egy bizonyos mennyiséget, úgy a "
4798 "<_:link-2/> feltételeinek is eleget kell tennie."
4799
4800 #. (itstool) path: sect1/para
4801 #: C/fdl-appendix.xml:169
4802 msgid ""
4803 "You may also lend copies, under the same conditions stated above, and you "
4804 "may publicly display copies."
4805 msgstr ""
4806 "A fenti feltételeket betartva kölcsönözhet is példányokat, de akár "
4807 "nyilvánosan is közzéteheti a szöveget."
4808
4809 #. (itstool) path: sect1/title
4810 #: C/fdl-appendix.xml:176
4811 msgid "3. COPYING IN QUANTITY"
4812 msgstr "3. SOKSZOROSÍTÁS NAGYOBB MENNYISÉGBEN"
4813
4814 #. (itstool) path: sect1/para
4815 #: C/fdl-appendix.xml:177
4816 msgid ""
4817 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
4818 "and the Document's license notice requires <_:link-2/>, you must enclose the "
4819 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
4820 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
4821 "cover. Both covers must also clearly and legibly identify you as the "
4822 "publisher of these copies. The front cover must present the full title with "
4823 "all words of the title equally prominent and visible. You may add other "
4824 "material on the covers in addition. Copying with changes limited to the "
4825 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
4826 "these conditions, can be treated as verbatim copying in other respects."
4827 msgstr ""
4828 "Amennyiben 100-nál több nyomtatott példányt tesz közzé a <_:link-1/>ból, és "
4829 "a dokumentum Licence feltételül szabja a <_:link-2/> meglétét, úgy minden "
4830 "egyes példányt köteles ellátni olyan borítólapokkal, amelyeken a következő "
4831 "Borítószövegek tisztán és olvashatóan fel vannak tüntetve: Címlapszövegek a "
4832 "címlapon, illetve Hátlapszövegek a hátlapon. Mindkét borítólapra "
4833 "egyértelműen és olvashatóan rá kell vezetnie a kiadó, vagyis jelen esetben "
4834 "az Ön nevét. A címlapon a Dokumentum teljes címének szerepelnie kell, és a "
4835 "cím minden szavának egyformán kiemeltnek és láthatónak kell lennie. Ezen "
4836 "felül, belátása szerint, további részleteket is hozzáadhat a borítólapokhoz. "
4837 "Amennyiben az esetleges módosítások kizárólag a borítólapokat érintik, és "
4838 "feltéve, hogy a <_:link-3/> címe változatlan marad, továbbá a borítólapok "
4839 "megfelelnek minden egyéb követelménynek, úgy a sokszorosítás ettől "
4840 "eltekintve szó szerinti sokszorosításnak minősül."
4841
4842 #. (itstool) path: sect1/para
4843 #: C/fdl-appendix.xml:195
4844 msgid ""
4845 "If the required texts for either cover are too voluminous to fit legibly, "
4846 "you should put the first ones listed (as many as fit reasonably) on the "
4847 "actual cover, and continue the rest onto adjacent pages."
4848 msgstr ""
4849 "Abban az esetben, ha a borítólapok bármelyikén megkövetelt szövegrészek túl "
4850 "hosszúnak bizonyulnának az olvasható közzétételhez, úgy csak az elsőként "
4851 "felsoroltakat kell feltüntetnie (amennyi józan belátás szerint elfér) a "
4852 "tényleges borítón, a továbbiak pedig átkerülhetnek a következő oldalakra."
4853
4854 #. (itstool) path: sect1/para
4855 #: C/fdl-appendix.xml:202
4856 msgid ""
4857 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
4858 "more than 100, you must either include a machine-readable <_:link-3/> copy "
4859 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
4860 "accessible computer-network location containing a complete Transparent copy "
4861 "of the Document, free of added material, which the general network-using "
4862 "public has access to download anonymously at no charge using public-standard "
4863 "network protocols. If you use the latter option, you must take reasonably "
4864 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
4865 "ensure that this Transparent copy will remain thus accessible at the stated "
4866 "location until at least one year after the last time you distribute an "
4867 "Opaque copy (directly or through your agents or retailers) of that edition "
4868 "to the public."
4869 msgstr ""
4870 "Amennyiben a 100-nál több <_:link-1/> példányt tesz közzé, vagy terjeszt a "
4871 "<_:link-2/>ból, úgy köteles vagy egy géppel olvasható <_:link-3/> példányt "
4872 "mellékelni minden egyes Átlátszatlan példányhoz, vagy leírni minden egyes "
4873 "Átlátszatlan példányban egy, a módosítatlan Átlátszó példányt tartalmazó "
4874 "olyan nyilvánosan hozzáférhető számítógép-hálózat elérhetőségét, amely "
4875 "elérhető az általános hálózati felhasználók számára, és onnan nyilvános "
4876 "szabványú hálózati protokollok segítségével a Dokumentum hozzáadott anyagok "
4877 "nélküli, teljes változata letölthető. Ha az utóbbi lehetőséget választja, "
4878 "köteles gondoskodni arról, hogy attól a naptól kezdve, amikor az utolsó "
4879 "Átlátszatlan példány is terjesztésre került (akár közvetlenül Ön által, akár "
4880 "kiskereskedelmi forgalomban), a fenti helyen közzétett Átlátszó példány még "
4881 "legalább egy évig hozzáférhető legyen a felhasználók számára."
4882
4883 #. (itstool) path: sect1/para
4884 #: C/fdl-appendix.xml:222
4885 msgid ""
4886 "It is requested, but not required, that you contact the authors of the "
4887 "<_:link-1/> well before redistributing any large number of copies, to give "
4888 "them a chance to provide you with an updated version of the Document."
4889 msgstr ""
4890 "Megkérjük, ámde nem kötelezzük Önt arra, hogy minden esetben, amikor nagyobb "
4891 "példányszámú terjesztésbe kezd, már jóval ezt megelőzően lépjen kapcsolatba "
4892 "a <_:link-1/> szerzőivel, annak érdekében, hogy megkaphassa tőlük a "
4893 "Dokumentum esetleges újabb változatát."
4894
4895 #. (itstool) path: sect1/title
4896 #: C/fdl-appendix.xml:231
4897 msgid "4. MODIFICATIONS"
4898 msgstr "4. MÓDOSÍTÁSOK"
4899
4900 #. (itstool) path: para/link
4901 #: C/fdl-appendix.xml:236
4902 msgid "2"
4903 msgstr "2"
4904
4905 #. (itstool) path: para/link
4906 #: C/fdl-appendix.xml:237
4907 msgid "3"
4908 msgstr "3"
4909
4910 #. (itstool) path: sect1/para
4911 #: C/fdl-appendix.xml:232
4912 msgid ""
4913 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
4914 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
4915 "release the Modified Version under precisely this License, with the Modified "
4916 "Version filling the role of the Document, thus licensing distribution and "
4917 "modification of the Modified Version to whoever possesses a copy of it. In "
4918 "addition, you must do these things in the Modified Version:"
4919 msgstr ""
4920 "Önnek lehetősége van a <_:link-2/> <_:link-1/> sokszorosítására és "
4921 "terjesztésére a <_:link-3/>. és <_:link-4/>. szakaszok fenti rendelkezései "
4922 "alapján, feltéve, hogy a Módosított Változatot kizárólag jelen Licenc "
4923 "feltételeivel összhangban teszi közzé, ahol a Módosított Változat a "
4924 "Dokumentum szerepét tölti be, ezáltal lehetőséget biztosítva annak "
4925 "terjesztésére és módosítására bárkinek, aki csak hozzájut egy példányához. "
4926 "Mindezen felül, a Módosított Változat az alábbi követelményeknek is meg "
4927 "kell, hogy feleljen:"
4928
4929 #. (itstool) path: formalpara/title
4930 #: C/fdl-appendix.xml:248
4931 msgid "A"
4932 msgstr "A"
4933
4934 #. (itstool) path: formalpara/para
4935 #: C/fdl-appendix.xml:249
4936 msgid ""
4937 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
4938 "that of the <_:link-2/>, and from those of previous versions (which should, "
4939 "if there were any, be listed in the History section of the Document). You "
4940 "may use the same title as a previous version if the original publisher of "
4941 "that version gives permission."
4942 msgstr ""
4943 "A <_:link-1/>on (és ha van, a borítókon) tüntessen fel egy a <_:link-2/>, "
4944 "illetve bármely korábbi változatétól eltérő címet (amelyeknek, ha vannak, a "
4945 "Dokumentum Előzmények szakaszában kell szerepelniük). Egy korábbi változat "
4946 "címét csak akkor használhatja, ha annak szerzője engedélyezte azt."
4947
4948 #. (itstool) path: formalpara/title
4949 #: C/fdl-appendix.xml:264
4950 msgid "B"
4951 msgstr "B"
4952
4953 #. (itstool) path: formalpara/para
4954 #: C/fdl-appendix.xml:265
4955 msgid ""
4956 "List on the <_:link-1/>, as authors, one or more persons or entities "
4957 "responsible for authorship of the modifications in the <_:link-2/>, together "
4958 "with at least five of the principal authors of the <_:link-3/> (all of its "
4959 "principal authors, if it has less than five)."
4960 msgstr ""
4961 "A <_:link-1/>on szerzőkként sorolja fel a <_:link-2/> elvégzett "
4962 "változtatásokért felelős természetes vagy jogi személyeket, továbbá a "
4963 "<_:link-3/> fő szerzői közül legkevesebb ötöt (vagy mindet, ha ötnél "
4964 "kevesebben vannak)."
4965
4966 #. (itstool) path: formalpara/title
4967 #: C/fdl-appendix.xml:279
4968 msgid "C"
4969 msgstr "C"
4970
4971 #. (itstool) path: formalpara/para
4972 #: C/fdl-appendix.xml:280
4973 msgid ""
4974 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
4975 "the publisher."
4976 msgstr ""
4977 "A <_:link-1/>on a <_:link-2/> közzétételéért felelős személyt tüntesse fel "
4978 "kiadóként."
4979
4980 #. (itstool) path: formalpara/title
4981 #: C/fdl-appendix.xml:291
4982 msgid "D"
4983 msgstr "D"
4984
4985 #. (itstool) path: formalpara/para
4986 #: C/fdl-appendix.xml:292
4987 msgid "Preserve all the copyright notices of the <_:link-1/>."
4988 msgstr ""
4989 "A <_:link-1/> összes szerzői jogi figyelmeztetését hagyja érintetlenül."
4990
4991 #. (itstool) path: formalpara/title
4992 #: C/fdl-appendix.xml:301
4993 msgid "E"
4994 msgstr "E"
4995
4996 #. (itstool) path: formalpara/para
4997 #: C/fdl-appendix.xml:302
4998 msgid ""
4999 "Add an appropriate copyright notice for your modifications adjacent to the "
5000 "other copyright notices."
5001 msgstr ""
5002 "Saját módosításaira vonatkozóan is tegyen közzé egy szerzői jogi "
5003 "megjegyzést, a többi ilyen jellegű figyelmeztetés mellett."
5004
5005 #. (itstool) path: formalpara/title
5006 #: C/fdl-appendix.xml:311
5007 msgid "F"
5008 msgstr "F"
5009
5010 #. (itstool) path: formalpara/para
5011 #: C/fdl-appendix.xml:312
5012 msgid ""
5013 "Include, immediately after the copyright notices, a license notice giving "
5014 "the public permission to use the <_:link-1/> under the terms of this "
5015 "License, in the form shown in the Addendum below."
5016 msgstr ""
5017 "Rögtön a szerzői jogi figyelmeztetéseket követően tüntessen fel egy "
5018 "közleményt, az alábbi Függelék mintájára, amelyben engedélyezi a <_:link-1/> "
5019 "felhasználását a jelen Licenc feltételeinek megfelelően."
5020
5021 #. (itstool) path: formalpara/title
5022 #: C/fdl-appendix.xml:324
5023 msgid "G"
5024 msgstr "G"
5025
5026 #. (itstool) path: para/link
5027 #: C/fdl-appendix.xml:330
5028 msgid "Document's"
5029 msgstr "Dokumentum"
5030
5031 #. (itstool) path: formalpara/para
5032 #: C/fdl-appendix.xml:325
5033 msgid ""
5034 "Preserve in that license notice the full lists of <_:link-1/> and required "
5035 "<_:link-2/> given in the <_:link-3/> license notice."
5036 msgstr ""
5037 "A fenti közleményben hagyja érintetlenül a <_:link-1/> és a szükséges "
5038 "<_:link-2/> a jelen <_:link-3/> licencében előírt teljes listáját."
5039
5040 #. (itstool) path: formalpara/title
5041 #: C/fdl-appendix.xml:337
5042 msgid "H"
5043 msgstr "H"
5044
5045 #. (itstool) path: formalpara/para
5046 #: C/fdl-appendix.xml:338
5047 msgid "Include an unaltered copy of this License."
5048 msgstr "Mellékelje a jelen Licenc egy eredeti példányát."
5049
5050 #. (itstool) path: formalpara/title
5051 #: C/fdl-appendix.xml:346
5052 msgid "I"
5053 msgstr "I"
5054
5055 #. (itstool) path: para/quote
5056 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
5057 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
5058 msgid "History"
5059 msgstr "Előzmények"
5060
5061 #. (itstool) path: formalpara/para
5062 #: C/fdl-appendix.xml:347
5063 msgid ""
5064 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
5065 "item stating at least the title, year, new authors, and publisher of the "
5066 "<_:link-2/> as given on the <_:link-3/>. If there is no section entitled "
5067 "<_:quote-4/> in the <_:link-5/>, create one stating the title, year, "
5068 "authors, and publisher of the Document as given on its Title Page, then add "
5069 "an item describing the Modified Version as stated in the previous sentence."
5070 msgstr ""
5071 "Az <_:quote-1/> elnevezésű szakaszt, illetve annak címét szintén hagyja "
5072 "érintetlenül, emellett adjon hozzá egy új elemet, amely minimálisan "
5073 "tartalmazza a <_:link-2/> címét, kiadási évét, továbbá az új szerzők, "
5074 "illetve a kiadó nevét, a <_:link-3/>on láthatókhoz hasonlóan. Amennyiben a "
5075 "<_:link-5/> nem tartalmaz semmiféle <_:quote-4/> elnevezésű szakaszt, úgy "
5076 "hozzon létre egyet, amely tartalmazza a Dokumentum címét, kiadási évét, "
5077 "továbbá a szerzők, illetve a kiadó nevét, a Címlapon láthatókhoz hasonlóan; "
5078 "majd ezt követően adjon hozzá egy új, a Módosított Változatra vonatkozó "
5079 "elemet, a fentiekkel összhangban."
5080
5081 #. (itstool) path: formalpara/title
5082 #: C/fdl-appendix.xml:365
5083 msgid "J"
5084 msgstr "J"
5085
5086 #. (itstool) path: formalpara/para
5087 #: C/fdl-appendix.xml:366
5088 msgid ""
5089 "Preserve the network location, if any, given in the <_:link-1/> for public "
5090 "access to a <_:link-2/> copy of the Document, and likewise the network "
5091 "locations given in the Document for previous versions it was based on. These "
5092 "may be placed in the <_:quote-3/> section. You may omit a network location "
5093 "for a work that was published at least four years before the Document "
5094 "itself, or if the original publisher of the version it refers to gives "
5095 "permission."
5096 msgstr ""
5097 "Ne tegyen változtatásokat a <_:link-1/>ban megadott <_:link-2/> példány "
5098 "nyilvános hálózati elérhetőségét (ha van ilyen) illetően, vagy hasonlóképp, "
5099 "a Dokumentum alapjául szolgáló korábbi változatok hálózati helyére "
5100 "vonatkozóan. Ezek az <_:quote-3/> szakaszban is szerepelhetnek. Csak abban "
5101 "az esetben hagyhatja el egyes korábbi változatok hálózati elérhetőségét, ha "
5102 "azok legkevesebb négy évvel a Dokumentum előtt készültek, vagy ha maga az "
5103 "alkotó engedélyezi azt."
5104
5105 #. (itstool) path: formalpara/title
5106 #: C/fdl-appendix.xml:383
5107 msgid "K"
5108 msgstr "K"
5109
5110 #. (itstool) path: para/quote
5111 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5112 msgid "Acknowledgements"
5113 msgstr "Köszönetnyilvánítás"
5114
5115 #. (itstool) path: para/quote
5116 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5117 msgid "Dedications"
5118 msgstr "Ajánlások"
5119
5120 #. (itstool) path: formalpara/para
5121 #: C/fdl-appendix.xml:384
5122 msgid ""
5123 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5124 "title, and preserve in the section all the substance and tone of each of the "
5125 "contributor acknowledgements and/or dedications given therein."
5126 msgstr ""
5127 "Bármely <_:quote-1/> vagy <_:quote-2/> elnevezésű szakasz címét hagyja "
5128 "érintetlenül, továbbá gondoskodjon arról, hogy azok tartalma és hangvétele "
5129 "az egyes hozzájárulókat, és/vagy az ajánlásokat illetően változatlan "
5130 "maradjon."
5131
5132 #. (itstool) path: formalpara/title
5133 #: C/fdl-appendix.xml:396
5134 msgid "L"
5135 msgstr "L"
5136
5137 #. (itstool) path: formalpara/para
5138 #: C/fdl-appendix.xml:397
5139 msgid ""
5140 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5141 "in their titles. Section numbers or the equivalent are not considered part "
5142 "of the section titles."
5143 msgstr ""
5144 "A <_:link-2/> összes <_:link-1/>át hagyja érintetlenül, úgy címüket, mint "
5145 "tartalmukat illetően. A szakaszok számozása, vagy bármely azzal egyenértékű "
5146 "jelölés nem tartozik a szakaszcímek közé."
5147
5148 #. (itstool) path: formalpara/title
5149 #: C/fdl-appendix.xml:409
5150 msgid "M"
5151 msgstr "M"
5152
5153 #. (itstool) path: para/quote
5154 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5155 msgid "Endorsements"
5156 msgstr "Hozzájárulás"
5157
5158 #. (itstool) path: formalpara/para
5159 #: C/fdl-appendix.xml:410
5160 msgid ""
5161 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5162 "in the <_:link-2/>."
5163 msgstr ""
5164 "Töröljön minden <_:quote-1/> elnevezésű szakaszt. Effajta szakaszok nem "
5165 "képezhetik részét a <_:link-2/>nak."
5166
5167 #. (itstool) path: formalpara/title
5168 #: C/fdl-appendix.xml:421
5169 msgid "N"
5170 msgstr "N"
5171
5172 #. (itstool) path: para/link
5173 #: C/fdl-appendix.xml:425
5174 msgid "Invariant Section"
5175 msgstr "Nem Változtatható szakasz"
5176
5177 #. (itstool) path: formalpara/para
5178 #: C/fdl-appendix.xml:422
5179 msgid ""
5180 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5181 "with any <_:link-2/>."
5182 msgstr ""
5183 "Ne nevezzen át semmilyen létező szakaszt <_:quote-1/> elnevezésűre, vagy "
5184 "olyasmire, amely címében a <_:link-2/>okkal ütközhet."
5185
5186 #. (itstool) path: sect1/para
5187 #: C/fdl-appendix.xml:432
5188 msgid ""
5189 "If the <_:link-1/> includes new front-matter sections or appendices that "
5190 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5191 "may at your option designate some or all of these sections as invariant. To "
5192 "do this, add their titles to the list of <_:link-3/> in the Modified "
5193 "Version's license notice. These titles must be distinct from any other "
5194 "section titles."
5195 msgstr ""
5196 "Ha a <_:link-1/> új bevezető szakaszokat tartalmaz, vagy olyan függelékeket, "
5197 "melyek <_:link-2/>nak minősülnek, ám nem tartalmaznak a Dokumentumból "
5198 "származó anyagot, abban az esetben, belátása szerint, e szakaszok "
5199 "némelyikét, vagy akár az összeset besorolhatja nem változtathatóként. Ehhez "
5200 "nem kell mást tennie, mint felsorolni a szóban forgó címeket a Módosított "
5201 "Változat licencének <_:link-3/> listájában. E címeknek határozottan el kell "
5202 "különülnie minden egyéb szakaszcímtől."
5203
5204 #. (itstool) path: sect1/para
5205 #: C/fdl-appendix.xml:444
5206 msgid ""
5207 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5208 "but endorsements of your <_:link-2/> by various parties--for example, "
5209 "statements of peer review or that the text has been approved by an "
5210 "organization as the authoritative definition of a standard."
5211 msgstr ""
5212 "<_:quote-1/> elnevezésű szakaszt csak akkor adhat a Dokumentumhoz, ha az "
5213 "kizárólag a <_:link-2/>ra utaló megjegyzéseket tartalmaz – például mások "
5214 "recenzióira vonatkozóan, vagy hogy egy szervezet a szöveget egy szabvány "
5215 "mérvadó definíciójaként ismerte el."
5216
5217 #. (itstool) path: para/link
5218 #: C/fdl-appendix.xml:455
5219 msgid "Front-Cover Text"
5220 msgstr "Címlapszöveg"
5221
5222 #. (itstool) path: para/link
5223 #: C/fdl-appendix.xml:457
5224 msgid "Back-Cover Text"
5225 msgstr "Hátlapszöveg"
5226
5227 #. (itstool) path: sect1/para
5228 #: C/fdl-appendix.xml:453
5229 msgid ""
5230 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5231 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5232 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5233 "Text may be added by (or through arrangements made by) any one entity. If "
5234 "the <_:link-5/> already includes a cover text for the same cover, previously "
5235 "added by you or by arrangement made by the same entity you are acting on "
5236 "behalf of, you may not add another; but you may replace the old one, on "
5237 "explicit permission from the previous publisher that added the old one."
5238 msgstr ""
5239 "<_:link-1/> gyanánt egy legfeljebb öt szóból álló szövegrészt adhat meg, a "
5240 "<_:link-2/> esetén pedig 25 szót fűzhet a <_:link-4/> <_:link-3/>einek "
5241 "végéhez. Bármely természetes vagy jogi személy csak és kizárólag egy "
5242 "Címlapszöveg és egy Hátlapszöveg részt adhat (akár közvetítőn keresztül) a "
5243 "Dokumentumhoz. Ha a Dokumentum már rendelkezik Borítószöveggel ehhez a "
5244 "változathoz, mert korábban Ön adta hozzá, vagy az a szervezet, amelynek "
5245 "nevében Ön fellép, akkor nem adhat hozzá másik Borítószöveget; a régit "
5246 "mindazonáltal lecserélheti, abban az esetben, ha az azt hozzáadó korábbi "
5247 "kiadó egyértelműen engedélyezi."
5248
5249 #. (itstool) path: sect1/para
5250 #: C/fdl-appendix.xml:470
5251 msgid ""
5252 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5253 "give permission to use their names for publicity for or to assert or imply "
5254 "endorsement of any <_:link-2/>."
5255 msgstr ""
5256 "A közös <_:link-1/> szerzői és kiadói ezzel a Licenccel nem járulnak hozzá "
5257 "nevük felhasználására, a <_:link-2/> népszerűsítésére, és nem támogatják azt."
5258
5259 #. (itstool) path: sect1/title
5260 #: C/fdl-appendix.xml:480
5261 msgid "5. COMBINING DOCUMENTS"
5262 msgstr "5. KOMBINÁLT DOKUMENTUMOK"
5263
5264 #. (itstool) path: para/link
5265 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5266 msgid "section 4"
5267 msgstr "4. szakasz"
5268
5269 #. (itstool) path: sect1/para
5270 #: C/fdl-appendix.xml:481
5271 msgid ""
5272 "You may combine the <_:link-1/> with other documents released under this "
5273 "License, under the terms defined in <_:link-2/> above for modified versions, "
5274 "provided that you include in the combination all of the <_:link-3/> of all "
5275 "of the original documents, unmodified, and list them all as Invariant "
5276 "Sections of your combined work in its license notice."
5277 msgstr ""
5278 "Önnek lehetősége van a <_:link-1/> egyéb, e Licenc hatálya alatt kiadott "
5279 "dokumentumokkal való kombinálására a <_:link-2/> módosított változatokra "
5280 "vonatkozó rendelkezései alapján, feltéve, hogy a kombináció módosítás nélkül "
5281 "tartalmazza az eredeti dokumentumok összes <_:link-3/> szakaszát, és hogy "
5282 "azok mind Nem Változtatható szakaszként kerülnek felsorolásra a kombinált "
5283 "munka licencében."
5284
5285 #. (itstool) path: sect1/para
5286 #: C/fdl-appendix.xml:492
5287 msgid ""
5288 "The combined work need only contain one copy of this License, and multiple "
5289 "identical <_:link-1/> may be replaced with a single copy. If there are "
5290 "multiple Invariant Sections with the same name but different contents, make "
5291 "the title of each such section unique by adding at the end of it, in "
5292 "parentheses, the name of the original author or publisher of that section if "
5293 "known, or else a unique number. Make the same adjustment to the section "
5294 "titles in the list of Invariant Sections in the license notice of the "
5295 "combined work."
5296 msgstr ""
5297 "A kombinált munkának a jelen Licenc mindössze egy példányát kell "
5298 "tartalmaznia, az egymással átfedésben lévő <_:link-1/> szakaszok pedig "
5299 "kiválthatók egy összegzett példánnyal. Amennyiben több Nem Változtatható "
5300 "szakasz szerepelne ugyanazon címmel, ám eltérő tartalommal, úgy alakítsa át "
5301 "minden egyes szakasz címét olyan módon, hogy mögé írja zárójelben az eredeti "
5302 "szerző és kiadó nevét (ha ismeri) vagy egy egyedi sorszámot. Ha szükséges, a "
5303 "Nem Változtatható szakaszok címeivel is végezze el a fenti módosításokat a "
5304 "kombinált munka licencében."
5305
5306 #. (itstool) path: para/quote
5307 #: C/fdl-appendix.xml:511
5308 msgid "Endorsements."
5309 msgstr "Hozzájárulás"
5310
5311 #. (itstool) path: sect1/para
5312 #: C/fdl-appendix.xml:505
5313 msgid ""
5314 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5315 "the various original documents, forming one section entitled <_:quote-2/>; "
5316 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5317 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5318 msgstr ""
5319 "A kombinált munkában az eredeti dokumentumok összes <_:quote-1/> elnevezésű "
5320 "szakaszát össze kell olvasztania, miáltal egy összefüggő <_:quote-2/> "
5321 "elnevezésű szakasz jön létre; hasonlóképp kell eljárnia a <_:quote-3/>, "
5322 "illetve az <_:quote-4/> elnevezésű szakaszok tekintetében. Ugyanakkor minden "
5323 "<_:quote-5/> elnevezésű szakaszt törölnie kell."
5324
5325 #. (itstool) path: sect1/title
5326 #: C/fdl-appendix.xml:516
5327 msgid "6. COLLECTIONS OF DOCUMENTS"
5328 msgstr "6. DOKUMENTUMGYŰJTEMÉNYEK"
5329
5330 #. (itstool) path: sect1/para
5331 #: C/fdl-appendix.xml:517
5332 msgid ""
5333 "You may make a collection consisting of the <_:link-1/> and other documents "
5334 "released under this License, and replace the individual copies of this "
5335 "License in the various documents with a single copy that is included in the "
5336 "collection, provided that you follow the rules of this License for verbatim "
5337 "copying of each of the documents in all other respects."
5338 msgstr ""
5339 "Önnek lehetősége van a <_:link-1/>ból, illetve bármely egyéb, a jelen Licenc "
5340 "hatálya alatt kiadott dokumentumból gyűjteményt létrehozni, és az egyes "
5341 "dokumentumokban található licenceket egyetlen példánnyal kiváltani, feltéve, "
5342 "hogy a gyűjteményben szereplő összes dokumentum esetén minden más "
5343 "tekintetben követi a jelen Licenc feltételeit azok szó szerinti "
5344 "sokszorosítására vonatkozóan."
5345
5346 #. (itstool) path: sect1/para
5347 #: C/fdl-appendix.xml:527
5348 msgid ""
5349 "You may extract a single document from such a collection, and distribute it "
5350 "individually under this License, provided you insert a copy of this License "
5351 "into the extracted document, and follow this License in all other respects "
5352 "regarding verbatim copying of that document."
5353 msgstr ""
5354 "Tetszése szerint ki is emelhet egy meghatározott dokumentumot a "
5355 "gyűjteményből, továbbá terjesztheti azt jelen Licenc feltételei alapján, "
5356 "feltéve, hogy a szóban forgó dokumentumhoz mellékeli a jelen Licenc egy "
5357 "példányát, és minden egyéb tekintetben betartja jelen Licenc előírásait a "
5358 "dokumentum szó szerinti sokszorosítására vonatkozóan."
5359
5360 #. (itstool) path: sect1/title
5361 #: C/fdl-appendix.xml:537
5362 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5363 msgstr "7. ÖSSZEFŰZÉS FÜGGETLEN MUNKÁKKAL"
5364
5365 #. (itstool) path: para/quote
5366 #: C/fdl-appendix.xml:546
5367 msgid "aggregate"
5368 msgstr "gyűjtemény"
5369
5370 #. (itstool) path: para/link
5371 #: C/fdl-appendix.xml:550
5372 msgid "Cover Text"
5373 msgstr "Borítószöveg"
5374
5375 #. (itstool) path: sect1/para
5376 #: C/fdl-appendix.xml:538
5377 msgid ""
5378 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5379 "independent documents or works, in or on a volume of a storage or "
5380 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5381 "Document, provided no compilation copyright is claimed for the compilation. "
5382 "Such a compilation is called an <_:quote-3/>, and this License does not "
5383 "apply to the other self-contained works thus compiled with the Document , on "
5384 "account of their being thus compiled, if they are not themselves derivative "
5385 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5386 "applicable to these copies of the Document, then if the Document is less "
5387 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5388 "placed on covers that surround only the Document within the aggregate. "
5389 "Otherwise they must appear on covers around the whole aggregate."
5390 msgstr ""
5391 "A <_:link-1/> és annak származékainak különálló, vagy független "
5392 "dokumentumokkal, illetve munkákkal való összefűzése egy közös tárolási, vagy "
5393 "terjesztési egységen nem számít a Dokumentum <_:link-2/>ának, feltéve hogy "
5394 "az összeállításra nem tartanak igényt szerzői jogra. Az ilyen összeállítást "
5395 "<_:quote-3/>nek nevezzük, és ez a licenc nem vonatkozik a Dokumentummal ily "
5396 "módon összeállított egyéb önálló művekre, tekintettel arra, hogy azok ily "
5397 "módon összeállítottak, ha azok maguk nem a Dokumentumból származó művek. "
5398 "Amennyiben a <_:link-5/> <_:link-4/>ekre vonatkozó rendelkezései "
5399 "alkalmazhatók a Dokumentum e példányaira, és a Dokumentum a teljes "
5400 "összegzésnek kevesebb, mint negyedét teszi ki, úgy a Dokumentum "
5401 "Borítószövegeit olyan módon is el lehet helyezni a borítókon, hogy azok csak "
5402 "magát a Dokumentumot fogják közre. Minden más esetben a teljes összegzés "
5403 "borítólapjain kell feltüntetni a fenti szövegeket."
5404
5405 #. (itstool) path: sect1/title
5406 #: C/fdl-appendix.xml:561
5407 msgid "8. TRANSLATION"
5408 msgstr "8. FORDÍTÁS"
5409
5410 #. (itstool) path: sect1/para
5411 #: C/fdl-appendix.xml:562
5412 msgid ""
5413 "Translation is considered a kind of modification, so you may distribute "
5414 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing "
5415 "<_:link-3/> with translations requires special permission from their "
5416 "copyright holders, but you may include translations of some or all Invariant "
5417 "Sections in addition to the original versions of these Invariant Sections. "
5418 "You may include a translation of this License provided that you also include "
5419 "the original English version of this License. In case of a disagreement "
5420 "between the translation and the original English version of this License, "
5421 "the original English version will prevail."
5422 msgstr ""
5423 "A fordítás egyfajta módosításnak tekinthető, így a <_:link-1/> lefordított "
5424 "példányai a <_:link-2/> rendelkezései alapján terjeszthetők. A <_:link-3/> "
5425 "lefordításához külön engedélyt kell kérni a szerzői jogtulajdonostól, "
5426 "mindazonáltal közzétehetők a lefordított változatok is úgy, ha az eredeti "
5427 "Nem Változtatható szakaszokat is belefoglalja a munkába. E Licenc "
5428 "lefordítására ugyanezek a feltételek érvényesek, vagyis a lefordított "
5429 "változatok csak akkor jelenhetnek meg, ha mellette ott vannak az eredeti, "
5430 "angol nyelvű Licenc szövegei is. Amennyiben eltérés mutatkozna az eredeti "
5431 "változatok, illetve a fordítás között, úgy a Licenc angol nyelvű eredetije "
5432 "tekintendő mérvadónak."
5433
5434 #. (itstool) path: sect1/title
5435 #: C/fdl-appendix.xml:580
5436 msgid "9. TERMINATION"
5437 msgstr "9. MEGSZŰNÉS"
5438
5439 #. (itstool) path: sect1/para
5440 #: C/fdl-appendix.xml:581
5441 msgid ""
5442 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5443 "as expressly provided for under this License. Any other attempt to copy, "
5444 "modify, sublicense or distribute the Document is void, and will "
5445 "automatically terminate your rights under this License. However, parties who "
5446 "have received copies, or rights, from you under this License will not have "
5447 "their licenses terminated so long as such parties remain in full compliance."
5448 msgstr ""
5449 "A jelen Licencben egyértelműen kijelölt kereteken kívül tilos a <_:link-1/> "
5450 "bárminemű sokszorosítása, módosítása, továbblicencelése, vagy terjesztése. "
5451 "Minden ezzel szembeni sokszorosítási, módosítási, továbblicencelési, vagy "
5452 "terjesztési kísérlet a jelen Licencben meghatározott jogok automatikus "
5453 "megszűnését vonja maga után. Ugyanakkor azok a felek, akik Önön keresztül "
5454 "jutottak másolathoz vagy jogosultságokhoz, nem veszítik el azokat, amíg "
5455 "maradéktalanul betartják e Licenc előírásait."
5456
5457 #. (itstool) path: sect1/title
5458 #: C/fdl-appendix.xml:594
5459 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5460 msgstr "10. JELEN LICENC JÖVŐBENI JAVÍTÁSAI"
5461
5462 #. (itstool) path: para/ulink
5463 #: C/fdl-appendix.xml:597
5464 msgid "Free Software Foundation"
5465 msgstr "Free Software Foundation"
5466
5467 #. (itstool) path: para/ulink
5468 #: C/fdl-appendix.xml:603
5469 msgid "http://www.gnu.org/copyleft/"
5470 msgstr "http://www.gnu.org/copyleft/"
5471
5472 #. (itstool) path: sect1/para
5473 #: C/fdl-appendix.xml:595
5474 msgid ""
5475 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5476 "Documentation License from time to time. Such new versions will be similar "
5477 "in spirit to the present version, but may differ in detail to address new "
5478 "problems or concerns. See <_:ulink-2/>."
5479 msgstr ""
5480 "Megtörténhet, hogy a <_:ulink-1/> időről időre felülvizsgált és/vagy új "
5481 "verziókat bocsát ki a GNU Free Documentation License-ből. E verziók "
5482 "szellemisége hasonló lesz jelen változatéhoz, ám részleteikben eltérhetnek, "
5483 "új problémák, új aggályok felmerülése okán. Vö.: <_:ulink-2/>"
5484
5485 #. (itstool) path: para/quote
5486 #: C/fdl-appendix.xml:610
5487 msgid "or any later version"
5488 msgstr "vagy bármely újabb verzióra"
5489
5490 #. (itstool) path: sect1/para
5491 #: C/fdl-appendix.xml:606
5492 msgid ""
5493 "Each version of the License is given a distinguishing version number. If the "
5494 "<_:link-1/> specifies that a particular numbered version of this License "
5495 "<_:quote-2/> applies to it, you have the option of following the terms and "
5496 "conditions either of that specified version or of any later version that has "
5497 "been published (not as a draft) by the Free Software Foundation. If the "
5498 "Document does not specify a version number of this License, you may choose "
5499 "any version ever published (not as a draft) by the Free Software Foundation."
5500 msgstr ""
5501 "A Licenc minden változata egyedi verziószámmal van ellátva. Ha a <_:link-1/> "
5502 "jelen Licenc egy konkrét, számozott verziójára <_:quote-2/> hivatkozik, úgy "
5503 "önnek a szóban forgó változat, vagy bármely újabb a Free Software Foundation "
5504 "által (nem vázlatként) kiadott verzió feltételeinek követésére lehetősége "
5505 "van. Ha a Dokumentum nem ad meg semmilyen verziószámot, úgy bármely, a Free "
5506 "Software Foundation által valaha (nem vázlatként) kiadott változat megfelel."
5507
5508 #. (itstool) path: sect1/title
5509 #: C/fdl-appendix.xml:621
5510 msgid "Addendum"
5511 msgstr "Függelék"
5512
5513 #. (itstool) path: sect1/para
5514 #: C/fdl-appendix.xml:622
5515 msgid ""
5516 "To use this License in a document you have written, include a copy of the "
5517 "License in the document and put the following copyright and license notices "
5518 "just after the title page:"
5519 msgstr ""
5520 "Ha a jelen Licencet egy Ön által írt dokumentumban kívánja használni, akkor "
5521 "mellékelje hozzá a Licenc egy példányát, továbbá vezesse rá az alábbi "
5522 "szerzői jogi és licencközleményeket, rögtön a címlapot követően:"
5523
5524 #. (itstool) path: blockquote/para
5525 #: C/fdl-appendix.xml:629
5526 msgid "Copyright YEAR YOUR NAME."
5527 msgstr "Copyright (C) ÉV AZ ÖN NEVE."
5528
5529 #. (itstool) path: para/link
5530 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5531 msgid "Front-Cover Texts"
5532 msgstr "Címlapszövegek"
5533
5534 #. (itstool) path: para/link
5535 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5536 msgid "Back-Cover Texts"
5537 msgstr "Hátlapszövegek"
5538
5539 #. (itstool) path: blockquote/para
5540 #: C/fdl-appendix.xml:632
5541 msgid ""
5542 "Permission is granted to copy, distribute and/or modify this document under "
5543 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5544 "version published by the Free Software Foundation; with the <_:link-1/> "
5545 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the "
5546 "<_:link-3/> being LIST. A copy of the license is included in the section "
5547 "entitled <_:quote-4/>."
5548 msgstr ""
5549 "Engedélyt adunk Önnek a jelen dokumentum sokszorosítására, terjesztésére és/"
5550 "vagy módosítására a Free Software Foundation által kiadott GNU FDL 1.1-es, "
5551 "vagy bármely azt követő verziójának feltételei alapján. A <_:link-1/>, nincs "
5552 "<_:link-2/>, nincs Hátlapszöveg. a <_:link-1/> CÍMEINEK FELSOROLÁSÁVAL, a "
5553 "<_:link-2/> FELSOROLÁSÁVAL és a <_:link-3/> FELSOROLÁSÁVAL. A jelen licenc "
5554 "egy példányát a <_:quote-4/> elnevezésű szakasz alatt találja."
5555
5556 #. (itstool) path: para/quote
5557 #: C/fdl-appendix.xml:649
5558 msgid "with no Invariant Sections"
5559 msgstr "Nem Változtatható szakaszok nélkül"
5560
5561 #. (itstool) path: para/quote
5562 #: C/fdl-appendix.xml:652
5563 msgid "no Front-Cover Texts"
5564 msgstr "nincs Címlapszövegek"
5565
5566 #. (itstool) path: para/quote
5567 #: C/fdl-appendix.xml:653
5568 msgid "Front-Cover Texts being LIST"
5569 msgstr "Címlapszövegek FELSOROLÁSÁVAL"
5570
5571 #. (itstool) path: sect1/para
5572 #: C/fdl-appendix.xml:647
5573 msgid ""
5574 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5575 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of "
5576 "<_:quote-5/>; likewise for <_:link-6/>."
5577 msgstr ""
5578 "Ha nincs <_:link-1/>, írja azt, hogy <_:quote-2/>, ahelyett, hogy "
5579 "megmondaná, melyek azok, amelyek nem változtathatók. Ha nincs <_:link-3/>, "
5580 "írja azt, hogy <_:quote-4/>, ahelyett hogy <_:quote-5/>; ugyanígy a "
5581 "<_:link-6/> esetében is."
5582
5583 #. (itstool) path: para/ulink
5584 #: C/fdl-appendix.xml:661
5585 msgid "GNU General Public License"
5586 msgstr "GNU General Public License"
5587
5588 #. (itstool) path: sect1/para
5589 #: C/fdl-appendix.xml:657
5590 msgid ""
5591 "If your document contains nontrivial examples of program code, we recommend "
5592 "releasing these examples in parallel under your choice of free software "
5593 "license, such as the <_:ulink-1/>, to permit their use in free software."
5594 msgstr ""
5595 "Amennyiben a dokumentum nem egyértelmű programkódpéldákat is tartalmaz, úgy "
5596 "azt javasoljuk, hogy e példákat egy választása szerinti szabad szoftver "
5597 "licenc alatt közölje – mint például a <_:ulink-1/> –, hogy lehetővé tegye a "
5598 "kódok szabad szoftverekben való alkalmazását."