Debian Codegraph @

help/manual/eu/eu.po

raw
1 # Basque translation for gtk-doc.
2 # Copyright (C) 2021 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # Asier Saratsua Garmendia <[email protected]>, 2021, 2025.
5 #
6 msgid ""
7 msgstr "Project-Id-Version: gtk-doc master\n"
8 "POT-Creation-Date: 2025-08-10 21:12+0000\n"
9 "PO-Revision-Date: 2025-09-21 11:35+0000\n"
10 "Last-Translator: Asier Saratsua Garmendia <[email protected]>\n"
11 "Language-Team: Basque <[email protected]>\n"
12 "Language: eu\n"
13 "MIME-Version: 1.0\n"
14 "Content-Type: text/plain; charset=UTF-8\n"
15 "Content-Transfer-Encoding: 8bit\n"
16
17 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
18 msgctxt "_"
19 msgid "translator-credits"
20 msgstr "translator-credits"
21
22 #. (itstool) path: bookinfo/title
23 #: C/index.docbook:12
24 msgid "GTK-Doc Manual"
25 msgstr "GTK-Doc aplikazioaren eskuliburua"
26
27 #. (itstool) path: bookinfo/edition
28 #: C/index.docbook:13
29 msgid "1.24.1"
30 msgstr "1.24.1"
31
32 #. (itstool) path: abstract/para
33 #: C/index.docbook:14
34 msgid "User manual for developers with instructions of GTK-Doc usage."
35 msgstr "GTK-Doc aplikazioaren erabilera azaltzen duen erabiltzaile-eskuliburua, garatzaileentzako argibideekin."
36
37 #. (itstool) path: authorgroup/author
38 #: C/index.docbook:16
39 msgid ""
40 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
41 "<address> <email>[email protected]</email> </address> </affiliation>"
42 msgstr "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
43
44 #. (itstool) path: authorgroup/author
45 #: C/index.docbook:25
46 msgid ""
47 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
48 "<email>[email protected]</email> </address> </affiliation>"
49 msgstr "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
50
51 #. (itstool) path: authorgroup/author
52 #: C/index.docbook:34
53 msgid ""
54 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
55 "<address> <email>[email protected]</email> </address> </affiliation>"
56 msgstr "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> <address> <email>[email protected]</email> </address> </affiliation>"
57
58 #. (itstool) path: publisher/publishername
59 #: C/index.docbook:45
60 msgid "GTK-Doc project"
61 msgstr "GTK-Doc proiektua"
62
63 #. (itstool) path: bookinfo/publisher
64 #: C/index.docbook:44
65 msgid ""
66 "<_:publishername-1/> <address><email>[email protected]</email></address>"
67 msgstr "<_:publishername-1/> <address><email>[email protected]</email></address>"
68
69 #. (itstool) path: bookinfo/copyright
70 #: C/index.docbook:48
71 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
72 msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
73
74 #. (itstool) path: bookinfo/copyright
75 #: C/index.docbook:52
76 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
77 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
78
79 #. (itstool) path: legalnotice/para
80 #: C/index.docbook:65
81 msgid ""
82 "Permission is granted to copy, distribute and/or modify this document under "
83 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
84 "Version 1.1 or any later version published by the Free Software Foundation "
85 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
86 "copy of the license is <link linkend=\"fdl\">included</link>."
87 msgstr "Baimena ematen da dokumentu hau kopiatu, banatu eta/edo aldatzeko Free Software Foundation-ek argitaratutako <citetitle>GNU Dokumentazio Librearen Lizentziaren</citetitle> 1.1. bertsioan edo berriago batean ezarritako baldintzetan, atal aldaezinik gabe, aurreko azaleko testurik gabe eta atzeko azaleko testurik gabe. Lizentziaren kopia <link linkend=\"fdl\">esteka honetan</link>."
88
89 #. (itstool) path: legalnotice/para
90 #: C/index.docbook:73
91 msgid ""
92 "Many of the names used by companies to distinguish their products and "
93 "services are claimed as trademarks. Where those names appear in any GNOME "
94 "documentation, and those trademarks are made aware to the members of the "
95 "GNOME Documentation Project, the names have been printed in caps or initial "
96 "caps."
97 msgstr "Enpresek beren produktu eta zerbitzuak bereizteko erabiltzen dituzten izen asko marka erregistratu gisa hartu behar dira. Izen horiek GNOMEren edozein agiritan agertzen direnean, eta GNOMEren Dokumentazio Proiektuko kideak marka komertzialak direla konturatzen direnean, izen horiek osorik maiuskulaz edo hasierako letra maiuskulaz idatzi dituzte."
98
99 #. (itstool) path: revhistory/revision
100 #: C/index.docbook:83
101 msgid ""
102 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
103 "authorinitials> <revremark>gtk4 version</revremark>"
104 msgstr "<revnumber>1.33.0</revnumber> <date>2020ko urriaren 1a</date> <authorinitials>mc</authorinitials> <revremark>gtk4 version</revremark>"
105
106 #. (itstool) path: revhistory/revision
107 #: C/index.docbook:89
108 msgid ""
109 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
110 "authorinitials> <revremark>dev version</revremark>"
111 msgstr "<revnumber>1.32.1</revnumber> <date>2019ko abuztuaren 15a</date> <authorinitials>ss</authorinitials> <revremark>dev version</revremark>"
112
113 #. (itstool) path: revhistory/revision
114 #: C/index.docbook:95
115 msgid ""
116 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
117 "authorinitials> <revremark>hotfix release</revremark>"
118 msgstr "<revnumber>1.32</revnumber> <date>2019ko abuztuaren 15a</date> <authorinitials>ss</authorinitials> <revremark>hotfix release</revremark>"
119
120 #. (itstool) path: revhistory/revision
121 #: C/index.docbook:101
122 msgid ""
123 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
124 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
125 msgstr "<revnumber>1.31</revnumber> <date>05 Aug 2019ko abuztuaren 5a</date> <authorinitials>ss</authorinitials> <revremark>refactorings and more test coverage</revremark>"
126
127 #. (itstool) path: revhistory/revision
128 #: C/index.docbook:107
129 msgid ""
130 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
131 "authorinitials> <revremark>more test coverage</revremark>"
132 msgstr "<revnumber>1.30</revnumber> <date>2019ko maiatzaren 8a</date> <authorinitials>ss</authorinitials> <revremark>hotfix release</revremark>"
133
134 #. (itstool) path: revhistory/revision
135 #: C/index.docbook:113
136 msgid ""
137 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
138 "authorinitials> <revremark>bug fixes</revremark>"
139 msgstr "<revnumber>1.29</revnumber> <date>28 Aug 2018ko abuztuaren 28a</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
140
141 #. (itstool) path: revhistory/revision
142 #: C/index.docbook:119
143 msgid ""
144 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
145 "authorinitials> <revremark>bug fixes</revremark>"
146 msgstr "<revnumber>1.28</revnumber> <date>2018ko martxoaren 14a</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
147
148 #. (itstool) path: revhistory/revision
149 #: C/index.docbook:125
150 msgid ""
151 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
152 "authorinitials> <revremark>fine tuning of the python port</revremark>"
153 msgstr "<revnumber>1.27</revnumber> <date>2017ko abenduaren 7a</date> <authorinitials>ss</authorinitials> <revremark>Python atakaren doitze fina</revremark>"
154
155 #. (itstool) path: revhistory/revision
156 #: C/index.docbook:131
157 msgid ""
158 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
159 "authorinitials> <revremark>port all tools from perl/bash to python</"
160 "revremark>"
161 msgstr "<revnumber>1.26</revnumber> <date>2017ko abuztuaren 11</date> <authorinitials>ss</authorinitials> <revremark>tresna guztiak Perl/Bash lengoaietatik Python-era eraman dira</revremark>"
162
163 #. (itstool) path: revhistory/revision
164 #: C/index.docbook:137
165 msgid ""
166 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
167 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
168 msgstr "<revnumber>1.25</revnumber> <date>2016ko martxoaren 21a</date> <authorinitials>ss</authorinitials> <revremark>akatsen konponketa, proben garbiketa</revremark>"
169
170 #. (itstool) path: revhistory/revision
171 #: C/index.docbook:143
172 msgid ""
173 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
174 "authorinitials> <revremark>bug fix</revremark>"
175 msgstr "<revnumber>1.24</revnumber> <date>2015eko maiatzaren 29a</date> <authorinitials>ss</authorinitials> <revremark>akats baten konponketa</revremark>"
176
177 #. (itstool) path: revhistory/revision
178 #: C/index.docbook:149
179 msgid ""
180 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
181 "authorinitials> <revremark>bug fix</revremark>"
182 msgstr "<revnumber>1.23</revnumber> <date>2015eko maiatzaren 17a</date> <authorinitials>ss</authorinitials> <revremark>akats baten konponketa</revremark>"
183
184 #. (itstool) path: revhistory/revision
185 #: C/index.docbook:155
186 msgid ""
187 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
188 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
189 "revremark>"
190 msgstr "<revnumber>1.22</revnumber> <date>2015eko maiatzaren 7a</date> <authorinitials>ss</authorinitials> <revremark>akatsen konponketa, eginbide zaharkituak kentzea</revremark>"
191
192 #. (itstool) path: revhistory/revision
193 #: C/index.docbook:161
194 msgid ""
195 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
196 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
197 "revremark>"
198 msgstr "<revnumber>1.21</revnumber> <date>2014ko uztailaren 17a</date> <authorinitials>ss</authorinitials> <revremark>akatsen konponketa, eginbide zaharkituak kentzea</revremark>"
199
200 #. (itstool) path: revhistory/revision
201 #: C/index.docbook:167
202 msgid ""
203 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
204 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
205 "revremark>"
206 msgstr "<revnumber>1.20</revnumber> <date>2014ko otsailaren 16a</date> <authorinitials>ss</authorinitials> <revremark>akatsen konponketa, markdown euskarria, estiloaren hobekuntzak</revremark>"
207
208 #. (itstool) path: revhistory/revision
209 #: C/index.docbook:173
210 msgid ""
211 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
212 "authorinitials> <revremark>bug fixes</revremark>"
213 msgstr "<revnumber>1.19</revnumber> <date>2013ko ekainaren 5a</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>"
214
215 #. (itstool) path: revhistory/revision
216 #: C/index.docbook:179
217 msgid ""
218 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
219 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
220 msgstr "<revnumber>1.18</revnumber> <date>2011ko irailaren 14a</date> <authorinitials>ss</authorinitials> <revremark>akatsen konponketa, abiadura-hobekuntzak, markdown euskarria</revremark>"
221
222 #. (itstool) path: revhistory/revision
223 #: C/index.docbook:185
224 msgid ""
225 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
226 "authorinitials> <revremark>urgent bug fix update</revremark>"
227 msgstr "<revnumber>1.17</revnumber> <date>2011ko otsailaren 26a</date> <authorinitials>sk</authorinitials> <revremark>akats larri baten konponketa</revremark>"
228
229 #. (itstool) path: revhistory/revision
230 #: C/index.docbook:191
231 msgid ""
232 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
233 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
234 msgstr "<revnumber>1.16</revnumber> <date>2011ko urtarrilaren 14a</date> <authorinitials>sk</authorinitials> <revremark>akatsen konponketa, diseinu-hobekuntzak</revremark>"
235
236 #. (itstool) path: revhistory/revision
237 #: C/index.docbook:197
238 msgid ""
239 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
240 "authorinitials> <revremark>bug and regression fixes</revremark>"
241 msgstr "<revnumber>1.15</revnumber> <date>2010eko maiatzaren 21a</date> <authorinitials>sk</authorinitials> <revremark>akatsen eta erregresioen konponketa</revremark>"
242
243 #. (itstool) path: revhistory/revision
244 #: C/index.docbook:203
245 msgid ""
246 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
247 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
248 msgstr "<revnumber>1.14</revnumber> <date>2010eko martxoaren 28a</date> <authorinitials>sk</authorinitials> <revremark>akatsen konponketa eta errendimendu-hobekuntzak</revremark>"
249
250 #. (itstool) path: revhistory/revision
251 #: C/index.docbook:209
252 msgid ""
253 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
254 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
255 "revremark>"
256 msgstr "<revnumber>1.13</revnumber> <date>18 December 2009ko abenduaren 18a</date> <authorinitials>sk</authorinitials> <revremark>banaketa-pakete hautsiaren eguneratzea</revremark>"
257
258 #. (itstool) path: revhistory/revision
259 #: C/index.docbook:215
260 msgid ""
261 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
262 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
263 "bugfixes</revremark>"
264 msgstr "<revnumber>1.12</revnumber> <date>2009ko abenduaren 18a</date> <authorinitials>sk</authorinitials> <revremark>tresnen eginbide berriak eta akatsen konponketa</revremark>"
265
266 #. (itstool) path: revhistory/revision
267 #: C/index.docbook:221
268 msgid ""
269 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
270 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
271 "revremark>"
272 msgstr "<revnumber>1.11</revnumber> <date>2008ko azaroaren 16a</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migrazioa</revremark>"
273
274 #. (itstool) path: chapter/title
275 #: C/index.docbook:234
276 msgid "Introduction"
277 msgstr "Sarrera"
278
279 #. (itstool) path: chapter/para
280 #: C/index.docbook:236
281 msgid ""
282 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
283 "it is used."
284 msgstr "Kapitulu hau GTK-Doc aplikazioaren sarrera da, zer den eta nola erabiltzen den azaltzen du orokorrean."
285
286 #. (itstool) path: sect1/title
287 #: C/index.docbook:242
288 msgid "What is GTK-Doc?"
289 msgstr "Zer da GTK-Doc?"
290
291 #. (itstool) path: sect1/para
292 #: C/index.docbook:244
293 msgid ""
294 "GTK-Doc is used to document C code. It is typically used to document the "
295 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
296 "also be used to document application code."
297 msgstr "C kodea dokumentatzeko erabiltzen da GTK-Doc. Normalean, GTK+ eta GNOMEren liburutegien API publikoa dokumentatzeko erabiltzen da, baina aplikazioen kodea dokumentatzeko ere erabili daiteke"
298
299 #. (itstool) path: sect1/title
300 #: C/index.docbook:252
301 msgid "How Does GTK-Doc Work?"
302 msgstr "Nola dabil GTK-Doc?"
303
304 #. (itstool) path: sect1/para
305 #: C/index.docbook:254
306 msgid ""
307 "GTK-Doc works by using documentation of functions placed inside the source "
308 "files in specially-formatted comment blocks, or documentation added to the "
309 "template files which GTK-Doc uses (though note that GTK-Doc will only "
310 "document functions that are declared in header files; it won't produce "
311 "output for static functions)."
312 msgstr ""
313
314 #. (itstool) path: sect1/para
315 #: C/index.docbook:261
316 msgid ""
317 "GTK-Doc consists of a number of python scripts, each performing a different "
318 "step in the process."
319 msgstr "GTK-Doc aplikazioa Python script-en bilduma bat da. Horietako bakoitzak prozesuko urrats bat betetzen du."
320
321 #. (itstool) path: sect1/para
322 #: C/index.docbook:266
323 msgid "There are 5 main steps in the process:"
324 msgstr "5 urrats nagusi daude prozesuan:"
325
326 #. (itstool) path: listitem/para
327 #: C/index.docbook:273
328 msgid ""
329 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
330 "source files with the documentation for each function, macro, structs or "
331 "unions, etc."
332 msgstr "<guilabel>Dokumentazioa idaztea.</guilabel> Egileak funtzio, makro, struct eta abarren dokumentazioarekin betetzen ditu iturburu-fitxategiak."
333
334 #. (itstool) path: listitem/para
335 #: C/index.docbook:282
336 msgid ""
337 "<guilabel>Gathering information about the code.</guilabel> "
338 "<application>gtkdoc-scan</application> scans the header files of the code "
339 "looking for declarations of functions, macros, enums, structs, and unions. "
340 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
341 "containing a list of the declarations, placing them into sections according "
342 "to which header file they are in. On the first run this file is copied to "
343 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
344 "the sections, and the order of the declarations within them, to produce the "
345 "final desired order. The second file it generates is "
346 "<filename>&lt;module&gt;-decl.txt</filename>. This file contains the full "
347 "declarations found by the scanner. If for some reason one would like some "
348 "symbols to show up in the docs, where the full declaration cannot be found "
349 "by the scanner or the declaration should appear differently, one can place "
350 "entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> "
351 "into <filename>&lt;module&gt;-overrides.txt</filename>."
352 msgstr ""
353
354 #. (itstool) path: listitem/para
355 #: C/index.docbook:299
356 msgid ""
357 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
358 "query a library about any GObject subclasses it exports. It saves "
359 "information about each object's position in the class hierarchy and about "
360 "any GObject properties and signals it provides."
361 msgstr "<application>gtkdoc-scangobj</application> edozein GObject azpiklaseri buruzko kontsultak dinamikoki gauzatzeko ere erabili daiteke. Objektu bakoitzak klase-hierarkian duen kokalekuari eta eskaintzen duen edozein GObject propietate eta seinaleri buruzko informazioa gordetzen du."
362
363 #. (itstool) path: listitem/para
364 #: C/index.docbook:305
365 msgid ""
366 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
367 "needed in the past when GObject was still GtkObject inside gtk+."
368 msgstr "<application>gtkdoc-scanobj</application> ez da gehiago erabili behar. Iraganean zen beharrezkoa, GObject oraindik gtk+ barruko GtkObject zenean."
369
370 #. (itstool) path: listitem/para
371 #: C/index.docbook:312
372 msgid ""
373 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
374 "mkdb</application> turns the template files into XML files in the <filename "
375 "class=\"directory\">xml/</filename> subdirectory. If the source code "
376 "contains documentation on functions, using the special comment blocks, it "
377 "gets merged in here. If there are no tmpl files used it only reads docs from "
378 "sources and introspection data."
379 msgstr ""
380
381 #. (itstool) path: listitem/para
382 #: C/index.docbook:321
383 msgid ""
384 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
385 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
386 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
387 "document called <filename>&lt;package&gt;.pdf</filename>."
388 msgstr "<application>gtkdoc-mkhtml</application> aplikazioak XML fitxategiak HTML fitxategi bihurtzen ditu <filename class=\"directory\">html/</filename> azpidirektorioan. Era berean, <application>gtkdoc-mkpdf</application> aplikazioak XML fitxategiak <filename>&lt;package&gt;.pdf</filename> deitutako PDF dokumentu bihurtzen ditu."
389
390 #. (itstool) path: listitem/para
391 #: C/index.docbook:327
392 msgid ""
393 "Files in <filename class=\"directory\">xml/</filename> and <filename "
394 "class=\"directory\">html/</filename> directories are always overwritten. One "
395 "should never edit them directly."
396 msgstr "<filename class=\"directory\">xml/</filename> eta <filename class=\"directory\">html/</filename> direktorioetako fitxategiak gainidatzi egiten dira beti. Ez dira zuzenean editatu behar."
397
398 #. (itstool) path: listitem/para
399 #: C/index.docbook:335
400 msgid ""
401 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
402 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
403 "run to fix up any cross-references between separate documents. For example, "
404 "the GTK+ documentation contains many cross-references to types documented in "
405 "the GLib manual. When creating the source tarball for distribution, "
406 "<application>gtkdoc-rebase</application> turns all external links into web-"
407 "links. When installing distributed (pregenerated) docs the same application "
408 "will try to turn links back to local links (where those docs are installed)."
409 msgstr ""
410
411 #. (itstool) path: sect1/title
412 #: C/index.docbook:353
413 msgid "Getting GTK-Doc"
414 msgstr "GTK-Doc eskuratzea"
415
416 #. (itstool) path: sect2/title
417 #: C/index.docbook:356
418 msgid "Requirements"
419 msgstr "Eskakizunak"
420
421 #. (itstool) path: sect2/para
422 #: C/index.docbook:357
423 msgid ""
424 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
425 msgstr "<guilabel>python 2/3</guilabel> - script nagusiak Python lengoaian daude idatzita."
426
427 #. (itstool) path: sect2/para
428 #: C/index.docbook:360
429 msgid ""
430 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
431 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
432 msgstr "<guilabel>xsltproc</guilabel> - libxslt liburutegiaren xslt prozesatzailea <ulink url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
433
434 #. (itstool) path: sect2/para
435 #: C/index.docbook:364
436 msgid ""
437 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
438 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
439 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
440 msgstr "<guilabel>docbook-xsl</guilabel> - docbook xsl estilo-orriak <ulink url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
441
442 #. (itstool) path: sect2/para
443 #: C/index.docbook:368
444 msgid ""
445 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
446 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
447 "examples"
448 msgstr "Hiru hauetako bat: <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> edo <guilabel>vim</guilabel> - aukerakoa - adibideen sintaxia nabarmentzeko erabiltzen da"
449
450 #. (itstool) path: sect1/title
451 #: C/index.docbook:376
452 msgid "About GTK-Doc"
453 msgstr "GTK-Doc aplikazioari buruz"
454
455 #. (itstool) path: sect1/para
456 #: C/index.docbook:378
457 msgid ""
458 "Historically GTK-Doc was used to generate template files from the sources "
459 "code. These template files could be used by developers to enter the API "
460 "documentation. This approach was rather inconvenient because it required to "
461 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
462 "possible to place all API information into source comments, which made the "
463 "template support obsolete. In version 1.26 template support has been removed."
464 msgstr ""
465
466 #. (itstool) path: sect1/para
467 #: C/index.docbook:388 C/index.docbook:402
468 msgid "(FIXME)"
469 msgstr "(ZUZENTZEKO)"
470
471 #. (itstool) path: sect1/para
472 #: C/index.docbook:392
473 msgid ""
474 "(authors, web pages, mailing list, license, future plans, comparison with "
475 "other similar systems.)"
476 msgstr "(egileak, web orriak, posta-zerrendak, lizentzia, etorkizuneko planak, konparazioa antzeko beste sistema batzuekin.)"
477
478 #. (itstool) path: sect1/title
479 #: C/index.docbook:400
480 msgid "About this Manual"
481 msgstr "Eskuliburu honi buruz"
482
483 #. (itstool) path: sect1/para
484 #: C/index.docbook:406
485 msgid "(who it is meant for, where you can get it, license)"
486 msgstr "(norentzat den, zer dagoen hemen, lizentzia)"
487
488 #. (itstool) path: chapter/title
489 #: C/index.docbook:415
490 msgid "Project Setup"
491 msgstr "Proiektuaren konfigurazioa"
492
493 #. (itstool) path: chapter/para
494 #: C/index.docbook:417
495 msgid ""
496 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
497 "into your project. The integration of GTK-Doc into a project includes the "
498 "following steps:"
499 msgstr "Kapitulu honetan, GTK-Doc zure proiektuan integratzeko eman behar diren urratsak deskribatu dira. GTK-DOC proiektu batean integratzeko, honakoak egin behar dira:"
500
501 #. (itstool) path: listitem/para
502 #: C/index.docbook:425
503 msgid ""
504 "Preparation of the directory structure and creating required configuration "
505 "files for your GTK-Doc documentation (see <link "
506 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
507 msgstr ""
508
509 #. (itstool) path: listitem/para
510 #: C/index.docbook:433
511 msgid ""
512 "Adjusting the build system to build your documentation using the GTK-Doc "
513 "tools. Multiple build systems are supported, in this manual we describe how "
514 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
515 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link "
516 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
517 msgstr ""
518
519 #. (itstool) path: listitem/para
520 #: C/index.docbook:443
521 msgid ""
522 "Adding GTK-Doc specific files to version control and deciding which files to "
523 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
524 "control systems</link>)."
525 msgstr "GTK-Doc fitxategi espezifikoak bertsio-kontrolari gehitu eta zein fitxategiri ez ikusiarena egingo zaien erabaki (ikus <link linkend=\"settingup_vcs\">Integrazioa bertsio-kontrolerako sistemekin</link>)."
526
527 #. (itstool) path: chapter/para
528 #: C/index.docbook:451
529 msgid ""
530 "The following sections assume we work on a project called <code>meep</code>. "
531 "This project contains two packages (or modules), a library called "
532 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
533 msgstr ""
534
535 #. (itstool) path: sect1/title
536 #: C/index.docbook:460
537 msgid "Setting up a skeleton documentation"
538 msgstr "Dokumentuazioaren muina konfiguratzea"
539
540 #. (itstool) path: sect1/para
541 #: C/index.docbook:462
542 msgid ""
543 "A common convention is to place documentation into a folder called "
544 "<code>docs</code> inside your top-level project directory. We usually "
545 "distinguish between <emphasis>reference documentation</emphasis> intended "
546 "for developers and an <emphasis>user manual</emphasis> intended for end-"
547 "users. Again the convention is to have separate folders for both. We usually "
548 "place the reference documentation in a folder named <code>reference</code> "
549 "and the end-user manual in a folder named <code>help</code> as. According to "
550 "the above convention the documentation for our <code>libmeep</code> package "
551 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
552 "just one library or application the documentation could also be placed "
553 "directly into <code>docs/reference</code>. It is not mandatory to use the "
554 "above convention, but if you choose to use a different directory structure "
555 "you must adjust your build system configuration to match your directory "
556 "structure."
557 msgstr ""
558
559 #. (itstool) path: example/title
560 #: C/index.docbook:493
561 msgid "Example directory structure of <emphasis>meep</emphasis> project"
562 msgstr "<emphasis>meep</emphasis> proiektuaren adibideko direktorio-egitura"
563
564 #. (itstool) path: example/programlisting
565 #: C/index.docbook:495
566 #, no-wrap
567 msgid ""
568 "\n"
569 "meep/\n"
570 " docs/\n"
571 " reference/ # reference documentation\n"
572 " libmeep/\n"
573 " meeper/\n"
574 " help/ # optional: user manual\n"
575 " meeper/\n"
576 " src/\n"
577 " libmeep/\n"
578 " meeper/\n"
579 msgstr ""
580 "\n"
581 "meep/\n"
582 " docs/\n"
583 " reference/ # erreferentziako dokumentazioa\n"
584 " libmeep/\n"
585 " meeper/\n"
586 " help/ # aukerakoa: erabiltzailearen eskuliburua\n"
587 " meeper/\n"
588 " src/\n"
589 " libmeep/\n"
590 " meeper/\n"
591
592 #. (itstool) path: sect1/para
593 #: C/index.docbook:487
594 msgid ""
595 "In the following sections we will assume a directory structure for our "
596 "<emphasis>meep</emphasis> project that uses the above conventions. "
597 "<_:example-1/>"
598 msgstr "Hurrengo atalerako, gure <emphasis>meep</emphasis> proiektuaren direktorio-egiturak goiko konbentzioak darabiltzala onartuko dugu. <_:example-1/>"
599
600 #. (itstool) path: sect1/title
601 #: C/index.docbook:512
602 msgid "Integration with Autotools"
603 msgstr "Integrazioa Autotools tresnarekin"
604
605 #. (itstool) path: sect1/para
606 #: C/index.docbook:513
607 msgid ""
608 "Integration of GTK-Doc into an autotools-based build system requires the "
609 "following steps:"
610 msgstr "GTK-Doc autotools tresnetan oinarritutako eraikuntza-sistema batean integratzeko honako urratsak eman behar dira:"
611
612 #. (itstool) path: listitem/para
613 #: C/index.docbook:519
614 msgid ""
615 "Ensure that <application>gtkdocize</application> is run once before the "
616 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
617 "script is present, adjust it to check for GTK-Doc and add a call to "
618 "<application>gtkdocize</application>."
619 msgstr "Ziurtatu <application>gtkdocize</application> aplikazioa behin exekutatzen dela <filename>configure</filename> script-aren aurretik. <filename>autogen.sh</filename> script bat badago, doitu hura GTK-Doc bilatu dezan eta gehitu <application>gtkdocize</application> aplikazioaren dei bat."
620
621 #. (itstool) path: listitem/para
622 #: C/index.docbook:527
623 msgid ""
624 "The main purpose of <application>gtkdocize</application> is to make the "
625 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
626 "filename> macro definition file available to the build system, either by "
627 "copying or linking it into the project."
628 msgstr ""
629
630 #. (itstool) path: listitem/para
631 #: C/index.docbook:536
632 msgid ""
633 "Add the necessary <application>autoconf</application> macros to "
634 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
635 "allow configuration of GTK-Doc via the generated <filename>configure</"
636 "filename> script."
637 msgstr ""
638
639 #. (itstool) path: listitem/para
640 #: C/index.docbook:542
641 msgid ""
642 "Among others with registers the <code>--enable-gtk-doc</code> option with "
643 "the <filename>configure</filename> script."
644 msgstr ""
645
646 #. (itstool) path: listitem/para
647 #: C/index.docbook:548
648 msgid ""
649 "Create an <application>automake</application> script for each application or "
650 "library in your project. In the example used in this documentation this step "
651 "applies to both <code>meeper</code> and <code>libmeep</code>."
652 msgstr ""
653
654 #. (itstool) path: sect1/para
655 #: C/index.docbook:557
656 msgid ""
657 "In the following sections, we will perform the above steps in reverse order. "
658 "We start with the <application>automake</application> scripts and work our "
659 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
660 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
661 "build the documentation."
662 msgstr ""
663
664 #. (itstool) path: sect2/title
665 #: C/index.docbook:567
666 msgid "Integration with automake"
667 msgstr "Integrazioa automake tresnarekin"
668
669 #. (itstool) path: sect2/para
670 #: C/index.docbook:569
671 msgid ""
672 "First copy the <filename>Makefile.am</filename> from the <filename "
673 "class=\"directory\">examples</filename> sub-directory of the <ulink "
674 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
675 "Makefile.am\"> gtkdoc-sources</ulink> to your project's reference "
676 "documentation directory (e.g. <filename class=\"directory\">docs/reference/"
677 "&lt;package&gt;</filename>). A local copy should be available under e.g. "
678 "<filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If "
679 "you have multiple packages repeat this for each one."
680 msgstr ""
681
682 #. (itstool) path: note/simpara
683 #: C/index.docbook:582
684 msgid ""
685 "Do not forget to add each <filename>Makefile.am</filename> to the "
686 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
687 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
688 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
689 "filename> to <function>AC_CONFIG_FILES</function>."
690 msgstr ""
691
692 #. (itstool) path: example/title
693 #: C/index.docbook:594
694 msgid "Example directory structure with <filename>Makefiles.am</filename>"
695 msgstr ""
696
697 #. (itstool) path: example/programlisting
698 #: C/index.docbook:597
699 #, no-wrap
700 msgid ""
701 "\n"
702 "meep/\n"
703 " docs/\n"
704 " reference/ # reference documentation\n"
705 " libmeep/\n"
706 " Makefile.am\n"
707 " meeper/\n"
708 " Makefile.am\n"
709 " help/ # optional: user manual\n"
710 " meeper/\n"
711 " src/\n"
712 " libmeep/\n"
713 " meeper/\n"
714 msgstr ""
715 "\n"
716 "meep/\n"
717 " docs/\n"
718 " reference/ # erreferentziako dokumentazioa\n"
719 " libmeep/\n"
720 " Makefile.am\n"
721 " meeper/\n"
722 " Makefile.am\n"
723 " help/ # aukerakoa: erabiltzaile-eskuliburua\n"
724 " meeper/\n"
725 " src/\n"
726 " libmeep/\n"
727 " meeper/\n"
728
729 #. (itstool) path: sect2/para
730 #: C/index.docbook:613
731 msgid ""
732 "Next, you need to customize the copied Makefiles and provide values for the "
733 "various parameters in each <filename>Makefile.am</filename>. All settings "
734 "have a comment above them that describes their purpose and how to customize "
735 "the setting. Most settings are used to supply extra flags to the respective "
736 "tools to which they apply. Every tool has a variable of the form "
737 "<option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-"
738 "mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All "
739 "the tools support <option>--help</option> to list the supported options."
740 msgstr ""
741
742 #. (itstool) path: listitem/para
743 #: C/index.docbook:637
744 msgid ""
745 "<option>DOC_MODULE</option> is used to provide the name of the package that "
746 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
747 msgstr "<option>DOC_MODULE</option> aukera erabiltzen da dokumentatzen ari den paketearen izena emateko (adibidez <code>meeper</code> edo <code>libmeep</code>)."
748
749 #. (itstool) path: listitem/para
750 #: C/index.docbook:644
751 msgid ""
752 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
753 "directory which GTK-Doc searches for your API documentation. This will "
754 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
755 "directory of that directory."
756 msgstr ""
757
758 #. (itstool) path: listitem/para
759 #: C/index.docbook:657
760 msgid ""
761 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
762 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$"
763 "(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
764 "the matched files change."
765 msgstr ""
766
767 #. (itstool) path: listitem/para
768 #: C/index.docbook:669
769 msgid ""
770 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
771 "include when scanning for API documentation, which are not found under "
772 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
773 "extra.h</code>)."
774 msgstr ""
775
776 #. (itstool) path: listitem/para
777 #: C/index.docbook:679
778 msgid ""
779 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
780 "to ignore when scanning for API documentation. Use the basename of the file "
781 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
782 "private_code_folder</code>)."
783 msgstr ""
784
785 #. (itstool) path: listitem/para
786 #: C/index.docbook:689
787 msgid ""
788 "<option>HTML_IMAGES</option> allows to specify images files which will be "
789 "copied into the <filename>html/</filename> directory of the generated "
790 "documentation. If your API documentation includes any images they need to be "
791 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
792 "stock_about_24.png</code>)."
793 msgstr ""
794
795 #. (itstool) path: listitem/para
796 #: C/index.docbook:702
797 msgid ""
798 "<option>content_files</option> allows to specify extra files that are "
799 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
800 "content_files=running.xml building.xml changes-2.0.xml</code>)."
801 msgstr ""
802
803 #. (itstool) path: listitem/para
804 #: C/index.docbook:713
805 msgid ""
806 "<option>expand_content_files</option> allows to specify files where "
807 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
808 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
809 msgstr ""
810
811 #. (itstool) path: sect2/para
812 #: C/index.docbook:631
813 msgid ""
814 "The following list explains the most relevant options. Check the example "
815 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
816 msgstr "Hurrengo zerrendak aukerarik nabarmenenak azaltzen ditu. Begiratu <filename>Makefile.am</filename> adibidea aukera gehiago ezagutzeko. <_:itemizedlist-1/>"
817
818 #. (itstool) path: sect2/title
819 #: C/index.docbook:728
820 msgid "Integration with autoconf"
821 msgstr "Integrazioa autoconf tresnarekin"
822
823 #. (itstool) path: sect2/para
824 #: C/index.docbook:730
825 msgid ""
826 "Integration with <application>autoconf</application> is very simple and "
827 "includes one required step and an additional optional (but recommended) "
828 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
829 "to your <filename>configure.ac</filename> script. This registers several "
830 "configure options to enable GTK-Doc and allows you to set default arguments "
831 "for <application>gtkdocize</application>."
832 msgstr ""
833
834 #. (itstool) path: warning/simpara
835 #: C/index.docbook:742
836 msgid ""
837 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
838 "macro must start at the beginning of the line and should not start with "
839 "whitespace."
840 msgstr ""
841
842 #. (itstool) path: sect2/para
843 #: C/index.docbook:749
844 msgid ""
845 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
846 "<filename>configure.ac</filename>. This is not required but helps "
847 "<application>gtkdocize</application> to automatically copy the macro "
848 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
849 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
850 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
851 "to explicitly tell the <application>aclocal</application> tool where to find "
852 "the macro definition file."
853 msgstr ""
854
855 #. (itstool) path: example/title
856 #: C/index.docbook:762
857 msgid "Minimal integration with autoconf"
858 msgstr "Gutxieneko integrazioa autoconf tresnarekin"
859
860 #. (itstool) path: example/programlisting
861 #: C/index.docbook:763
862 #, no-wrap
863 msgid ""
864 "\n"
865 "# recommended: set m4 directory\n"
866 "AC_CONFIG_MACRO_DIR(m4)\n"
867 "# optional: register gtk-doc in configure\n"
868 "GTK_DOC_CHECK([1.28])\n"
869 msgstr ""
870
871 #. (itstool) path: example/title
872 #: C/index.docbook:778
873 msgid "Integration with optional gtk-doc dependency"
874 msgstr "Integrazioa aukerako gtk-doc mendekotasunarekin"
875
876 #. (itstool) path: example/programlisting
877 #: C/index.docbook:779
878 #, no-wrap
879 msgid ""
880 "\n"
881 "m4_ifdef([GTK_DOC_CHECK], [\n"
882 "# recommended: set m4 directory\n"
883 "AC_CONFIG_MACRO_DIR(m4)\n"
884 "# optional: register gtk-doc in configure\n"
885 "GTK_DOC_CHECK([1.28])\n"
886 "],[\n"
887 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
888 "])\n"
889 msgstr ""
890
891 #. (itstool) path: sect2/para
892 #: C/index.docbook:772
893 msgid ""
894 "The above example works, but will require all developers to have gtk-doc "
895 "installed. A better way is to make building the documentation optional as "
896 "shown in the next example: <_:example-1/>"
897 msgstr "Goiko adibideak funtzionatzen du, baina horretarako garatzaile guztiek gtk-doc instalatuta eduki behar dute. Hobe da dokumentazioaren eraikuntza aukerakoa izan dadin, hurrengo adibidean erakusten den bezala: <_:example-1/>"
898
899 #. (itstool) path: sect2/para
900 #: C/index.docbook:792
901 msgid ""
902 "The first argument is used to check for the Gtk-Doc version at configure "
903 "time. The 2nd, optional argument is used by <application>gtkdocize</"
904 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
905 "configure switches:"
906 msgstr ""
907
908 #. (itstool) path: listitem/para
909 #: C/index.docbook:801
910 msgid "--with-html-dir=PATH : path to installed docs"
911 msgstr "--with-html-dir=PATH : instalatutako dokumentuen bide-izena"
912
913 #. (itstool) path: listitem/para
914 #: C/index.docbook:802
915 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
916 msgstr "--enable-gtk-doc : erabili gtk-doc dokumentazioa eraikitzeko [lehenetsia=ez]"
917
918 #. (itstool) path: listitem/para
919 #: C/index.docbook:803
920 msgid ""
921 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
922 msgstr "--enable-gtk-doc-html : eraiki dokumentazioa HTML formatuan [lehenetsia=bai]"
923
924 #. (itstool) path: listitem/para
925 #: C/index.docbook:804
926 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
927 msgstr "--enable-gtk-doc-pdf : eraiki dokumentazioa PDF formatuan [lehenetsia=ez]"
928
929 #. (itstool) path: important/para
930 #: C/index.docbook:808
931 msgid ""
932 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
933 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
934 "Otherwise pregenerated documentation is installed (which makes sense for "
935 "users but not for developers)."
936 msgstr ""
937
938 #. (itstool) path: sect2/para
939 #: C/index.docbook:816
940 msgid ""
941 "After all changes to <filename>configure.ac</filename> are made, update the "
942 "<filename>configure</filename> file. This can be done by re-running "
943 "<code>autogen.sh</code>."
944 msgstr ""
945
946 #. (itstool) path: sect2/title
947 #: C/index.docbook:824
948 msgid "Integration with autogen"
949 msgstr "Integrazioa autogen tresnarekin"
950
951 #. (itstool) path: sect2/para
952 #: C/index.docbook:826
953 msgid ""
954 "Most projects will have an <filename>autogen.sh</filename> script to setup "
955 "the build infrastructure after the project was checked out from a version "
956 "control system (such as git or svn). GTK-Doc comes with a script called "
957 "<application>gtkdocize</application> which can be used to copy the necessary "
958 "files needed by Gtk-Doc to the source directory."
959 msgstr ""
960
961 #. (itstool) path: sect2/para
962 #: C/index.docbook:834
963 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
964 msgstr "autoreconf, autoheader, automake edo autoconf aurretik exekutatu beharko litzateke."
965
966 #. (itstool) path: example/title
967 #: C/index.docbook:839
968 msgid "Running gtkdocize from autogen.sh"
969 msgstr "gtkdocize exekutatzea autogen.sh script-etik"
970
971 #. (itstool) path: example/programlisting
972 #: C/index.docbook:840
973 #, no-wrap
974 msgid ""
975 "\n"
976 "gtkdocize || exit 1\n"
977 msgstr ""
978 "\n"
979 "gtkdocize || exit 1\n"
980
981 #. (itstool) path: example/title
982 #: C/index.docbook:848
983 msgid "Conditionally run gtkdocize from autogen.sh"
984 msgstr ""
985
986 #. (itstool) path: example/programlisting
987 #: C/index.docbook:849
988 #, no-wrap
989 msgid ""
990 "\n"
991 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
992 "if test $? -ne 0; then\n"
993 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
994 "else\n"
995 " $GTKDOCIZE || exit 1\n"
996 "fi\n"
997 msgstr ""
998 "\n"
999 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1000 "if test $? -ne 0; then\n"
1001 " echo \"Ez da gtk-doc euskarririk aurkitu. Ezin dituzu dokumentuak eraiki.\"\n"
1002 "else\n"
1003 " $GTKDOCIZE || exit 1\n"
1004 "fi\n"
1005
1006 #. (itstool) path: sect2/para
1007 #: C/index.docbook:860
1008 msgid ""
1009 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1010 "doc.make</filename> to your project root (or any directory specified by the "
1011 "<option>--docdir</option> option)."
1012 msgstr "<application>gtkdocize</application> exekutatzean, <filename>gtk-doc.make</filename> zure proiektuaren errora (edo <option>--docdir</option> aukerarekin zehaztutako edozein direktoriora) kopiatzen du."
1013
1014 #. (itstool) path: sect2/para
1015 #: C/index.docbook:866
1016 msgid ""
1017 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1018 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1019 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1020 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1021 "<function>GTK_DOC_CHECK</function> macro."
1022 msgstr ""
1023
1024 #. (itstool) path: sect2/para
1025 #: C/index.docbook:875
1026 msgid ""
1027 "Alternatively, additional arguments can also be passed to "
1028 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1029 "function> environment variable, or by directly specifying them to "
1030 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1031 msgstr ""
1032
1033 #. (itstool) path: sect2/title
1034 #: C/index.docbook:886
1035 msgid "Executing GTK-Doc from the Build System"
1036 msgstr "GTK-Doc eraikitze-sistematik exekutatzea"
1037
1038 #. (itstool) path: sect2/para
1039 #: C/index.docbook:888
1040 msgid ""
1041 "After the previous steps it's time to run the build. First we need to rerun "
1042 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1043 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1044 "<filename>configure</filename> with this option afterwards."
1045 msgstr ""
1046
1047 #. (itstool) path: sect2/para
1048 #: C/index.docbook:895
1049 msgid ""
1050 "The first make run generates several additional files in the doc-"
1051 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1052 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1053 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1054 msgstr ""
1055
1056 #. (itstool) path: example/title
1057 #: C/index.docbook:903
1058 msgid "Running the doc build"
1059 msgstr "Dokumentazioaren eraikitzea exekutatzea"
1060
1061 #. (itstool) path: example/programlisting
1062 #: C/index.docbook:904
1063 #, no-wrap
1064 msgid ""
1065 "\n"
1066 "./autogen.sh --enable-gtk-doc\n"
1067 "make\n"
1068 msgstr ""
1069 "\n"
1070 "./autogen.sh --enable-gtk-doc\n"
1071 "make\n"
1072
1073 #. (itstool) path: sect2/para
1074 #: C/index.docbook:911
1075 msgid ""
1076 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1077 "index.html</filename>. With this initial setup you will only see a very "
1078 "simple document. The next chapter will teach you how to add API "
1079 "documentation to your code via special comment blocks. The Chapter "
1080 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1081 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1082 "template</link> to add additional chapters and sections to your "
1083 "documentation files."
1084 msgstr ""
1085
1086 #. (itstool) path: sect1/title
1087 #: C/index.docbook:927
1088 msgid "Integration with CMake build systems"
1089 msgstr "Integrazioa CMake eraikitze-sisemarekin"
1090
1091 #. (itstool) path: sect1/para
1092 #: C/index.docbook:929
1093 msgid ""
1094 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1095 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1096 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1097 "set in your <filename>CMakeLists.txt</filename> file."
1098 msgstr ""
1099
1100 #. (itstool) path: example/title
1101 #: C/index.docbook:939
1102 msgid "Example of using GTK-Doc from CMake"
1103 msgstr "GTK-Doc aplikazioa CMake-tik nola erabili erakusten duen adibidea"
1104
1105 #. (itstool) path: example/programlisting
1106 #: C/index.docbook:940
1107 #, no-wrap
1108 msgid ""
1109 "\n"
1110 "find_package(GtkDoc 1.25 REQUIRED)\n"
1111 "\n"
1112 "# Create the doc-libmeep target.\n"
1113 "gtk_doc_add_module(\n"
1114 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1115 " XML meep-docs.xml\n"
1116 " LIBRARIES libmeep\n"
1117 ")\n"
1118 "\n"
1119 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1120 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1121 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1122 "\n"
1123 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1124 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1125 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1126 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1127 msgstr ""
1128
1129 #. (itstool) path: sect1/para
1130 #: C/index.docbook:937
1131 msgid "The following example shows how to use this command. <_:example-1/>"
1132 msgstr "Hurrengo adibideak komando hau nola erabili erakusten du. <_:example-1/>"
1133
1134 #. (itstool) path: sect1/title
1135 #: C/index.docbook:964
1136 msgid "Integration with plain makefiles or other build systems"
1137 msgstr "Integrazioa makefile soilekin edo beste eraikitze-sistema batzuekin"
1138
1139 #. (itstool) path: sect1/para
1140 #: C/index.docbook:966
1141 msgid ""
1142 "In the case one does not want to use automake and therefore <filename>gtk-"
1143 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1144 "in own makefiles (or other build tools)."
1145 msgstr ""
1146
1147 #. (itstool) path: example/title
1148 #: C/index.docbook:973
1149 msgid "Documentation build steps"
1150 msgstr "Dokumentazioa eraikitzeko urratsak"
1151
1152 #. (itstool) path: example/programlisting
1153 #: C/index.docbook:974
1154 #, no-wrap
1155 msgid ""
1156 "\n"
1157 "DOC_MODULE=meep\n"
1158 "// sources have changed\n"
1159 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1160 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1161 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1162 "// xml files have changed\n"
1163 "mkdir html\n"
1164 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1165 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1166 msgstr ""
1167 "\n"
1168 "DOC_MODULE=meep\n"
1169 "// sources have changed\n"
1170 "gtkdoc-scan - module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1171 "gtkdoc-scangobj - module=$(DOC_MODULE)\n"
1172 "gtkdoc-mkdb - module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1173 "// xml files have changed\n"
1174 "mkdir html\n"
1175 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1176 "gtkdoc-fixxref - module=$(DOC_MODULE) - module-dir=html\n"
1177
1178 #. (itstool) path: sect1/para
1179 #: C/index.docbook:988
1180 msgid ""
1181 "One will need to look at the <filename>Makefile.am</filename> and "
1182 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1183 msgstr ""
1184
1185 #. (itstool) path: sect1/title
1186 #: C/index.docbook:995
1187 msgid "Integration with version control systems"
1188 msgstr "Integrazioa bertsioen kontroleko sistemekin"
1189
1190 #. (itstool) path: sect1/para
1191 #: C/index.docbook:997
1192 msgid ""
1193 "As a rule of thumb, it's the files you edit which should go under version "
1194 "control. For typical projects it's these files: "
1195 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1196 "docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-"
1197 "sections.txt</filename>, <filename>Makefile.am</filename>."
1198 msgstr ""
1199
1200 #. (itstool) path: sect1/para
1201 #: C/index.docbook:1005
1202 msgid ""
1203 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1204 "directories should not go under version control. Neither should any of the "
1205 "<filename>.stamp</filename> files."
1206 msgstr ""
1207
1208 #. (itstool) path: chapter/title
1209 #: C/index.docbook:1015
1210 msgid "Documenting the code"
1211 msgstr "Kodea dokumentatzea"
1212
1213 #. (itstool) path: chapter/para
1214 #: C/index.docbook:1017
1215 msgid ""
1216 "GTK-Doc uses source code comment with a special syntax for code "
1217 "documentation. Further it retrieves information about your project structure "
1218 "from other sources. During the next section you will find all information "
1219 "about the syntax of the comments."
1220 msgstr ""
1221
1222 #. (itstool) path: example/title
1223 #: C/index.docbook:1028 C/index.docbook:1054
1224 msgid "GTK-Doc comment block"
1225 msgstr "GTK-Doc iruzkin-blokea"
1226
1227 #. (itstool) path: example/programlisting
1228 #: C/index.docbook:1029
1229 #, no-wrap
1230 msgid ""
1231 "\n"
1232 "#ifndef __GTK_DOC_IGNORE__\n"
1233 "/* unparseable code here */\n"
1234 "#endif\n"
1235 msgstr ""
1236 "\n"
1237 "#ifndef __GTK_DOC_IGNORE__\n"
1238 "/* analizatu ezin daitekeen kodea*/\n"
1239 "#endif\n"
1240
1241 #. (itstool) path: chapter/para
1242 #: C/index.docbook:1024
1243 msgid ""
1244 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1245 "of receiving warnings from the scanner that look like a special case, one "
1246 "can hint GTK-Doc to skip over them. <_:example-1/>"
1247 msgstr ""
1248
1249 #. (itstool) path: note/title
1250 #: C/index.docbook:1038
1251 msgid "Limitations"
1252 msgstr "Mugak"
1253
1254 #. (itstool) path: note/para
1255 #: C/index.docbook:1039
1256 msgid ""
1257 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1258 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1259 msgstr "Kontuan izan GTK-Doc aplikazioak <code>#ifndef(__GTK_DOC_IGNORE__)</code> onartzen duela baina ez <code>#if !defined(__GTK_DOC_IGNORE__)</code> edo beste konbinazio batzuk."
1260
1261 #. (itstool) path: sect1/title
1262 #: C/index.docbook:1049
1263 msgid "Documentation comments"
1264 msgstr "Dokumentazio-iruzkinak"
1265
1266 #. (itstool) path: example/programlisting
1267 #: C/index.docbook:1055
1268 #, no-wrap
1269 msgid ""
1270 "\n"
1271 "/**\n"
1272 " * identifier:\n"
1273 " * documentation ...\n"
1274 " */\n"
1275 msgstr ""
1276 "\n"
1277 "/**\n"
1278 " * identifikatzailea:\n"
1279 " * dokumentazioa ...\n"
1280 " */\n"
1281
1282 #. (itstool) path: sect1/para
1283 #: C/index.docbook:1051
1284 msgid ""
1285 "A multiline comment that starts with an additional '*' marks a documentation "
1286 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1287 msgstr "'*' ikur batekin hasten den lerro anitzeko iruzkin batek GTK-Doc tresnek prozesatu behar duten dokumentazio-bloke bat markatzen du. <_:example-1/>"
1288
1289 #. (itstool) path: sect1/para
1290 #: C/index.docbook:1064
1291 msgid ""
1292 "The 'identifier' is one line with the name of the item the comment is "
1293 "related to. The syntax differs a little depending on the item. (TODO add "
1294 "table showing identifiers)"
1295 msgstr ""
1296
1297 #. (itstool) path: sect1/para
1298 #: C/index.docbook:1070
1299 msgid ""
1300 "The 'documentation' block is also different for each symbol type. Symbol "
1301 "types that get parameters such as functions or macros have the parameter "
1302 "description first followed by a blank line (just a '*'). Afterwards follows "
1303 "the detailed description. All lines (outside program listings and CDATA "
1304 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1305 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1306 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1307 msgstr ""
1308
1309 #. (itstool) path: listitem/para
1310 #: C/index.docbook:1087
1311 msgid ""
1312 "What it is: The name for a class or function can sometimes be misleading for "
1313 "people coming from a different background."
1314 msgstr "Zer den: Klase edo funtzio baten izena zenbaitetan nahasgarria izan daiteke beste esperientzia bat duen jendearentzat."
1315
1316 #. (itstool) path: listitem/para
1317 #: C/index.docbook:1093
1318 msgid ""
1319 "What it does: Tell about common uses. Put it in relation with the other API."
1320 msgstr "Zer egiten duen: Azaldu erabilera arruntenak. Erlazionatu beste APIekin."
1321
1322 #. (itstool) path: tip/para
1323 #: C/index.docbook:1083
1324 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1325 msgstr "Kodea dokumentatzean, erabili bi ikuspegi: <_:itemizedlist-1/>"
1326
1327 #. (itstool) path: listitem/para
1328 #: C/index.docbook:1108
1329 msgid "Use function() to refer to functions or macros which take arguments."
1330 msgstr "Erabili function() argumentuak hartzen dituzten funtzioei edo makroei erreferentzia egiteko."
1331
1332 #. (itstool) path: listitem/para
1333 #: C/index.docbook:1113
1334 msgid ""
1335 "Use @param to refer to parameters. Also use this when referring to "
1336 "parameters of other functions, related to the one being described."
1337 msgstr "Erabili @param parametroei erreferentzia egiteko. Erabili, baita ere, deskribatzen ari den funtzioari lotutako beste funtzio batzuen parametroei erreferentzia egitean."
1338
1339 #. (itstool) path: listitem/para
1340 #: C/index.docbook:1119
1341 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1342 msgstr "Erabili %constant konstante bati erreferentzia egiteko, adibidez %G_TRAVERSE_LEAFS."
1343
1344 #. (itstool) path: listitem/para
1345 #: C/index.docbook:1124
1346 msgid ""
1347 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1348 "macros which don't take arguments."
1349 msgstr "Erabili #symbol beste ikur mota batzuei erreferentzia egiteko, adibidez struct eta enum motei eta argumentuak hartzen ez dituzten makroei."
1350
1351 #. (itstool) path: listitem/para
1352 #: C/index.docbook:1130
1353 msgid "Use #Object::signal to refer to a GObject signal."
1354 msgstr "GObject seinale bati erreferentzia egiteko, erabili #Object::signal."
1355
1356 #. (itstool) path: listitem/para
1357 #: C/index.docbook:1135
1358 msgid "Use #Object:property to refer to a GObject property."
1359 msgstr "GObject propietate bati erreferentzia egiteko, erabili #Object:property."
1360
1361 #. (itstool) path: listitem/para
1362 #: C/index.docbook:1140
1363 msgid ""
1364 "Use #Struct.field to refer to a field inside a structure and "
1365 "#GObjectClass.foo_bar() to refer to a vmethod."
1366 msgstr ""
1367
1368 #. (itstool) path: sect1/para
1369 #: C/index.docbook:1102
1370 msgid ""
1371 "One advantage of hyper-text over plain-text is the ability to have links in "
1372 "the document. Writing the correct markup for a link can be tedious though. "
1373 "GTK-Doc comes to help by providing several useful abbreviations. "
1374 "<_:itemizedlist-1/>"
1375 msgstr ""
1376
1377 #. (itstool) path: tip/para
1378 #: C/index.docbook:1149
1379 msgid ""
1380 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1381 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1382 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", "
1383 "\"&amp;commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape "
1384 "them with a backslash '\\'."
1385 msgstr ""
1386
1387 #. (itstool) path: sect1/para
1388 #: C/index.docbook:1158
1389 msgid ""
1390 "DocBook can do more than just links. One can also have lists, examples, "
1391 "headings, and images. As of version 1.20, the preferred way is to use a "
1392 "subset of the basic text formatting syntax called <ulink url=\"http://"
1393 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1394 "versions any documentation that includes Markdown will be rendered as is. "
1395 "For example, list items will appear as lines starting with a dash."
1396 msgstr ""
1397
1398 #. (itstool) path: sect1/para
1399 #: C/index.docbook:1169
1400 msgid ""
1401 "While markdown is now preferred one can mix both. One limitation here is "
1402 "that one can use docbook xml within markdown, but markdown within docbook "
1403 "xml is not supported."
1404 msgstr ""
1405
1406 #. (itstool) path: sect1/para
1407 #: C/index.docbook:1175
1408 msgid ""
1409 "In older GTK-Doc releases, if you need support for additional formatting, "
1410 "you would need to enable the usage of docbook XML tags inside doc-comments "
1411 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1412 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1413 "filename>."
1414 msgstr ""
1415
1416 #. (itstool) path: example/title
1417 #: C/index.docbook:1184
1418 msgid "GTK-Doc comment block using Markdown"
1419 msgstr "GTK-Doc iruzkin-blokea Markdown erabiliz"
1420
1421 #. (itstool) path: example/programlisting
1422 #: C/index.docbook:1185
1423 #, no-wrap
1424 msgid ""
1425 "\n"
1426 "/**\n"
1427 " * identifier:\n"
1428 " *\n"
1429 " * documentation paragraph ...\n"
1430 " *\n"
1431 " * # Sub Heading #\n"
1432 " *\n"
1433 " * ## Second Sub Heading\n"
1434 " *\n"
1435 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1436 " *\n"
1437 " * more documentation:\n"
1438 " *\n"
1439 " * - list item 1\n"
1440 " *\n"
1441 " * Paragraph inside a list item.\n"
1442 " *\n"
1443 " * - list item 2\n"
1444 " *\n"
1445 " * 1. numbered list item\n"
1446 " *\n"
1447 " * 2. another numbered list item\n"
1448 " *\n"
1449 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1450 " *\n"
1451 " * ![an inline image](plot-result.png)\n"
1452 " *\n"
1453 " * [A link to the heading anchor above][heading-two]\n"
1454 " *\n"
1455 " * A C-language example:\n"
1456 " * |[&lt;!-- language=\"C\" --&gt;\n"
1457 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1458 " * ]|\n"
1459 " */\n"
1460 msgstr ""
1461
1462 #. (itstool) path: sect1/para
1463 #: C/index.docbook:1224
1464 msgid ""
1465 "More examples of what markdown tags are supported can be found in the <ulink "
1466 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1467 "Documentation Markdown Syntax Reference</ulink>."
1468 msgstr ""
1469
1470 #. (itstool) path: tip/para
1471 #: C/index.docbook:1230
1472 msgid ""
1473 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1474 "cannot write documentation for static symbols. Nevertheless it is good to "
1475 "comment those symbols too. This helps other developers to understand your "
1476 "code. Therefore we recommend to comment these using normal comments (without "
1477 "the 2nd '*' in the first line). If later the function needs to be made "
1478 "public, all one needs to do is to add another '*' in the comment block and "
1479 "insert the symbol name at the right place inside the sections file."
1480 msgstr ""
1481
1482 #. (itstool) path: sect1/title
1483 #: C/index.docbook:1245
1484 msgid "Documenting sections"
1485 msgstr "Atalak dokumentatzea"
1486
1487 #. (itstool) path: sect1/para
1488 #: C/index.docbook:1247
1489 msgid ""
1490 "Each section of the documentation contains information about one class or "
1491 "module. To introduce the component one can write a section block. The short "
1492 "description is also used inside the table of contents. All the @fields are "
1493 "optional."
1494 msgstr ""
1495
1496 #. (itstool) path: example/title
1497 #: C/index.docbook:1255
1498 msgid "Section comment block"
1499 msgstr "Atalen iruzkin-blokea"
1500
1501 #. (itstool) path: example/programlisting
1502 #: C/index.docbook:1256
1503 #, no-wrap
1504 msgid ""
1505 "\n"
1506 "/**\n"
1507 " * SECTION:meepapp\n"
1508 " * @short_description: the application class\n"
1509 " * @title: Meep application\n"
1510 " * @section_id:\n"
1511 " * @see_also: #MeepSettings\n"
1512 " * @stability: Stable\n"
1513 " * @include: meep/app.h\n"
1514 " * @image: application.png\n"
1515 " *\n"
1516 " * The application class handles ...\n"
1517 " */\n"
1518 msgstr ""
1519
1520 #. (itstool) path: varlistentry/term
1521 #: C/index.docbook:1275
1522 msgid "SECTION:&lt;name&gt;"
1523 msgstr "SECTION:&lt;name&gt;"
1524
1525 #. (itstool) path: listitem/para
1526 #: C/index.docbook:1277
1527 msgid ""
1528 "The name links the section documentation to the respective part in the "
1529 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
1530 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
1531 "sections.txt</filename> file."
1532 msgstr ""
1533
1534 #. (itstool) path: varlistentry/term
1535 #: C/index.docbook:1286
1536 msgid "@short_description"
1537 msgstr "@short_description"
1538
1539 #. (itstool) path: listitem/para
1540 #: C/index.docbook:1288
1541 msgid ""
1542 "A one line description of the section, that later will appear after the "
1543 "links in the TOC and at the top of the section page."
1544 msgstr "Atala deskribatzen duen lerro bakarreko testua, geroago aurkibidean esteken ondoren eta atal-orriaren goiko aldean agertuko dena."
1545
1546 #. (itstool) path: varlistentry/term
1547 #: C/index.docbook:1295
1548 msgid "@title"
1549 msgstr "@title"
1550
1551 #. (itstool) path: listitem/para
1552 #: C/index.docbook:1297
1553 msgid ""
1554 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
1555 "can be overridden with the @title field."
1556 msgstr ""
1557
1558 #. (itstool) path: varlistentry/term
1559 #: C/index.docbook:1304
1560 msgid "@section_id"
1561 msgstr "@section_id"
1562
1563 #. (itstool) path: listitem/para
1564 #: C/index.docbook:1306
1565 msgid ""
1566 "Overrides the use of title as a section identifier. For GObjects the "
1567 "&lt;title&gt; is used as a section_id and for other sections it is "
1568 "&lt;MODULE&gt;-&lt;title&gt;."
1569 msgstr ""
1570
1571 #. (itstool) path: varlistentry/term
1572 #: C/index.docbook:1314
1573 msgid "@see_also"
1574 msgstr "@see_also"
1575
1576 #. (itstool) path: listitem/para
1577 #: C/index.docbook:1316
1578 msgid "A list of symbols that are related to this section."
1579 msgstr "Atal honekin erlazioa duten ikurren zerrenda bat."
1580
1581 #. (itstool) path: varlistentry/term
1582 #: C/index.docbook:1322
1583 msgid "@stability"
1584 msgstr "@stability"
1585
1586 #. (itstool) path: listitem/para
1587 #: C/index.docbook:1329
1588 msgid ""
1589 "Stable - The intention of a Stable interface is to enable arbitrary third "
1590 "parties to develop applications to these interfaces, release them, and have "
1591 "confidence that they will run on all minor releases of the product (after "
1592 "the one in which the interface was introduced, and within the same major "
1593 "release). Even at a major release, incompatible changes are expected to be "
1594 "rare, and to have strong justifications."
1595 msgstr ""
1596
1597 #. (itstool) path: listitem/para
1598 #: C/index.docbook:1341
1599 msgid ""
1600 "Unstable - Unstable interfaces are experimental or transitional. They are "
1601 "typically used to give outside developers early access to new or rapidly "
1602 "changing technology, or to provide an interim solution to a problem where a "
1603 "more general solution is anticipated. No claims are made about either source "
1604 "or binary compatibility from one minor release to the next."
1605 msgstr ""
1606
1607 #. (itstool) path: listitem/para
1608 #: C/index.docbook:1353
1609 msgid ""
1610 "Private - An interface that can be used within the GNOME stack itself, but "
1611 "that is not documented for end-users. Such functions should only be used in "
1612 "specified and documented ways."
1613 msgstr "Pribatua - GNOMEren pilan bertan erabili daitekeen interfaze bat, amaierako erabiltzaileentzat dokumentatuta ez dagoena. Funtzio horiek modu zehatz eta dokumentatuetan soilik erabili behar dira."
1614
1615 #. (itstool) path: listitem/para
1616 #: C/index.docbook:1362
1617 msgid ""
1618 "Internal - An interface that is internal to a module and does not require "
1619 "end-user documentation. Functions that are undocumented are assumed to be "
1620 "Internal."
1621 msgstr "Barnekoa - Modulu baten barnekoa den interfaze bat, amaierako erabiltzaileentzako dokumentaziorik behar ez duena. Dokumentatu gabe dauden funtzioak barne-erabilerarako direla onartzen da."
1622
1623 #. (itstool) path: listitem/para
1624 #: C/index.docbook:1324
1625 msgid ""
1626 "An informal description of the stability level this API has. We recommend "
1627 "the use of one of these terms: <_:itemizedlist-1/>"
1628 msgstr "API honek duen egonkortasun-mailaren deskribapen ez formala. Honako terminoetako bat erabiltzea gomendatzen dugu: <_:itemizedlist-1/>"
1629
1630 #. (itstool) path: varlistentry/term
1631 #: C/index.docbook:1374
1632 msgid "@include"
1633 msgstr "@include"
1634
1635 #. (itstool) path: listitem/para
1636 #: C/index.docbook:1376
1637 msgid ""
1638 "The <literal>#include</literal> files to show in the section synopsis (a "
1639 "comma separated list), overriding the global value from the <link "
1640 "linkend=\"metafiles_sections\">section file</link> or command line. This "
1641 "item is optional."
1642 msgstr ""
1643
1644 #. (itstool) path: varlistentry/term
1645 #: C/index.docbook:1385
1646 msgid "@image"
1647 msgstr "@image"
1648
1649 #. (itstool) path: listitem/para
1650 #: C/index.docbook:1387
1651 msgid ""
1652 "The image to display at the top of the reference page for this section. This "
1653 "will often be some sort of a diagram to illustrate the visual appearance of "
1654 "a class or a diagram of its relationship to other classes. This item is "
1655 "optional."
1656 msgstr "Atal honen erreferentzia-orriaren goiko aldean bistaratuko den irudia. Sarritan, klase baten itxura irudikatzen duen diagrama bat edo beste klase batzuekin duen erlazioen diagrama bat izaten da. Elementu hau aukerakoa da."
1657
1658 #. (itstool) path: tip/para
1659 #: C/index.docbook:1398
1660 msgid ""
1661 "To avoid unnecessary recompilation after doc-changes put the section docs "
1662 "into the c-source where possible."
1663 msgstr ""
1664
1665 #. (itstool) path: sect1/title
1666 #: C/index.docbook:1407
1667 msgid "Documenting symbols"
1668 msgstr "Ikurrak dokumentatzea"
1669
1670 #. (itstool) path: sect1/para
1671 #: C/index.docbook:1409
1672 msgid ""
1673 "Each symbol (function, macro, struct, enum, signal and property) is "
1674 "documented in a separate block. The block is best placed close to the "
1675 "definition of the symbols so that it is easy to keep them in sync. Thus "
1676 "functions are usually documented in the c-source and macros, structs and "
1677 "enums in the header file."
1678 msgstr ""
1679
1680 #. (itstool) path: sect2/title
1681 #. (itstool) path: example/title
1682 #: C/index.docbook:1417 C/index.docbook:1483
1683 msgid "General tags"
1684 msgstr "Etiketa orokorrak"
1685
1686 #. (itstool) path: sect2/para
1687 #: C/index.docbook:1419
1688 msgid ""
1689 "You can add versioning information to all documentation elements to tell "
1690 "when an API was introduced, or when it was deprecated."
1691 msgstr "Bertsio-informazioa gehitu diezaiekezu dokumentazio-elementu guztiei API bat noiz sortu zen adierazteko, edo zaharkitutzat noiz markatu zen adierazteko."
1692
1693 #. (itstool) path: variablelist/title
1694 #: C/index.docbook:1424
1695 msgid "Versioning Tags"
1696 msgstr "Bertsio-etiketak"
1697
1698 #. (itstool) path: varlistentry/term
1699 #: C/index.docbook:1425
1700 msgid "Since:"
1701 msgstr "Noiztik:"
1702
1703 #. (itstool) path: listitem/para
1704 #: C/index.docbook:1427
1705 msgid "Description since which version of the code the API is available."
1706 msgstr "Kodearen zein bertsiotik hasita APIa erabilgarri dagoen deskribatzen duen testua."
1707
1708 #. (itstool) path: varlistentry/term
1709 #: C/index.docbook:1432
1710 msgid "Deprecated:"
1711 msgstr "Zaharkitua:"
1712
1713 #. (itstool) path: listitem/para
1714 #: C/index.docbook:1434
1715 msgid ""
1716 "Paragraph denoting that this function should no be used anymore. The "
1717 "description should point the reader to the new API."
1718 msgstr "Funtzioa ez dela gehiagotan erabili behar adierazten duen paragrafoa. Deskribapenak irakurlea API berrira bideratu beharko luke."
1719
1720 #. (itstool) path: sect2/para
1721 #: C/index.docbook:1442
1722 msgid ""
1723 "You can also add stability information to all documentation elements to "
1724 "indicate whether API stability is guaranteed for them for all future minor "
1725 "releases of the project."
1726 msgstr ""
1727
1728 #. (itstool) path: sect2/para
1729 #: C/index.docbook:1448
1730 msgid ""
1731 "The default stability level for all documentation elements can be set by "
1732 "passing the <option>--default-stability</option> argument to "
1733 "<application>gtkdoc-mkdb</application> with one of the values below."
1734 msgstr ""
1735
1736 #. (itstool) path: variablelist/title
1737 #: C/index.docbook:1454
1738 msgid "Stability Tags"
1739 msgstr "Egonkortasun-etiketak"
1740
1741 #. (itstool) path: varlistentry/term
1742 #: C/index.docbook:1455
1743 msgid "Stability: Stable"
1744 msgstr "Egonkortasuna: Egonkorra"
1745
1746 #. (itstool) path: listitem/para
1747 #: C/index.docbook:1457
1748 msgid ""
1749 "Mark the element as stable. This is for public APIs which are guaranteed to "
1750 "remain stable for all future minor releases of the project."
1751 msgstr "Markatu elementua egonkor gisa. Hori erabiltzen da proiektuaren etorkizuneko bertsio txikietan egonkorra izango diren API publikoetarako da."
1752
1753 #. (itstool) path: varlistentry/term
1754 #: C/index.docbook:1464
1755 msgid "Stability: Unstable"
1756 msgstr "Egonkortasuna: Desegonkorra"
1757
1758 #. (itstool) path: listitem/para
1759 #: C/index.docbook:1466
1760 msgid ""
1761 "Mark the element as unstable. This is for public APIs which are released as "
1762 "a preview before being stabilised."
1763 msgstr "Markatu elementua desegonkor gisa. Egonkortu baino lehen aurrebista gisa argitaratzen diren API publikoetarako da."
1764
1765 #. (itstool) path: varlistentry/term
1766 #: C/index.docbook:1472
1767 msgid "Stability: Private"
1768 msgstr "Egonkortasuna: Pribatua"
1769
1770 #. (itstool) path: listitem/para
1771 #: C/index.docbook:1474
1772 msgid ""
1773 "Mark the element as private. This is for interfaces which can be used by "
1774 "tightly coupled modules, but not by arbitrary third parties."
1775 msgstr "Markatu elementua pribatu gisa. Estu lotutako moduluekin erabili daitezkeen interfazeetarako da, ez dituztenak hirugarrenek erabili behar."
1776
1777 #. (itstool) path: example/programlisting
1778 #: C/index.docbook:1484
1779 #, no-wrap
1780 msgid ""
1781 "\n"
1782 "/**\n"
1783 " * foo_get_bar:\n"
1784 " * @foo: some foo\n"
1785 " *\n"
1786 " * Retrieves @foo's bar.\n"
1787 " *\n"
1788 " * Returns: @foo's bar\n"
1789 " *\n"
1790 " * Since: 2.6\n"
1791 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
1792 " */\n"
1793 "Bar *\n"
1794 "foo_get_bar(Foo *foo)\n"
1795 "{\n"
1796 "...\n"
1797 msgstr ""
1798
1799 #. (itstool) path: sect2/title
1800 #. (itstool) path: example/title
1801 #: C/index.docbook:1504 C/index.docbook:1514
1802 msgid "Annotations"
1803 msgstr "Oharpenak"
1804
1805 #. (itstool) path: sect2/para
1806 #: C/index.docbook:1506
1807 msgid ""
1808 "Documentation blocks can contain annotation-tags. These tags will be "
1809 "rendered with tooltips describing their meaning. The tags are used by "
1810 "GObject Introspection to generate language bindings. A detailed list of the "
1811 "supported tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/"
1812 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection "
1813 "documentation</ulink>."
1814 msgstr ""
1815
1816 #. (itstool) path: example/programlisting
1817 #: C/index.docbook:1515
1818 #, no-wrap
1819 msgid ""
1820 "\n"
1821 "/**\n"
1822 " * foo_get_bar: (annotation)\n"
1823 " * @foo: (annotation): some foo\n"
1824 " *\n"
1825 " * Retrieves @foo's bar.\n"
1826 " *\n"
1827 " * Returns: (annotation): @foo's bar\n"
1828 " */\n"
1829 "...\n"
1830 "/**\n"
1831 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
1832 " * (and another annotation)\n"
1833 " * @foo: (annotation) (another annotation): some foo\n"
1834 " *\n"
1835 " * Sets bar on @foo.\n"
1836 " */\n"
1837 msgstr ""
1838
1839 #. (itstool) path: sect2/title
1840 #. (itstool) path: example/title
1841 #: C/index.docbook:1536 C/index.docbook:1565
1842 msgid "Function comment block"
1843 msgstr "Funtzio-iruzkinen blokea"
1844
1845 #. (itstool) path: listitem/para
1846 #: C/index.docbook:1542
1847 msgid ""
1848 "Document whether returned objects, lists, strings, etc, should be freed/"
1849 "unrefed/released."
1850 msgstr ""
1851
1852 #. (itstool) path: listitem/para
1853 #: C/index.docbook:1548
1854 msgid "Document whether parameters can be NULL, and what happens if they are."
1855 msgstr "Dokumentatu parametroak NULL izan daitezkeen, eta zer gertatzen den baldin badira."
1856
1857 #. (itstool) path: listitem/para
1858 #: C/index.docbook:1553
1859 msgid ""
1860 "Mention interesting pre-conditions and post-conditions where appropriate."
1861 msgstr ""
1862
1863 #. (itstool) path: sect2/para
1864 #: C/index.docbook:1538 C/index.docbook:1624
1865 msgid "Please remember to: <_:itemizedlist-1/>"
1866 msgstr "Gogoratu honakoa: <_:itemizedlist-1/>"
1867
1868 #. (itstool) path: sect2/para
1869 #: C/index.docbook:1560
1870 msgid ""
1871 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
1872 "private. They are treated like static functions."
1873 msgstr "Gtk-doc sistemak ulertzen du '_' ikurrarekin hasten diren ikur guztiak (makroak, funtzioak) pribatuak direla. Funtzio estatikotzat hartzen dira. "
1874
1875 #. (itstool) path: example/programlisting
1876 #: C/index.docbook:1566
1877 #, no-wrap
1878 msgid ""
1879 "\n"
1880 "/**\n"
1881 " * function_name:\n"
1882 " * @par1: description of parameter 1. These can extend over more than\n"
1883 " * one line.\n"
1884 " * @par2: description of parameter 2\n"
1885 " * @...: a %NULL-terminated list of bars\n"
1886 " *\n"
1887 " * The function description goes here. You can use @par1 to refer to parameters\n"
1888 " * so that they are highlighted in the output. You can also use %constant\n"
1889 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
1890 " * other declarations (which may be documented elsewhere).\n"
1891 " *\n"
1892 " * Returns: an integer.\n"
1893 " *\n"
1894 " * Since: 2.2\n"
1895 " * Deprecated: 2.18: Use other_function() instead.\n"
1896 " */\n"
1897 msgstr ""
1898
1899 #. (itstool) path: variablelist/title
1900 #: C/index.docbook:1587
1901 msgid "Function tags"
1902 msgstr "Funtzio-etiketak"
1903
1904 #. (itstool) path: varlistentry/term
1905 #: C/index.docbook:1588 C/index.docbook:1795
1906 msgid "Returns:"
1907 msgstr "Itzultzen du:"
1908
1909 #. (itstool) path: listitem/para
1910 #: C/index.docbook:1590
1911 msgid "Paragraph describing the returned result."
1912 msgstr "Itzulitako emaitza deskribatzen duen paragrafoa."
1913
1914 #. (itstool) path: varlistentry/term
1915 #: C/index.docbook:1595
1916 msgid "@...:"
1917 msgstr "@...:"
1918
1919 #. (itstool) path: listitem/para
1920 #: C/index.docbook:1597
1921 msgid ""
1922 "In case the function has variadic arguments, you should use this tag "
1923 "(@Varargs: does also work for historic reasons)."
1924 msgstr ""
1925
1926 #. (itstool) path: sect2/title
1927 #. (itstool) path: example/title
1928 #: C/index.docbook:1607 C/index.docbook:1609
1929 msgid "Property comment block"
1930 msgstr "Propietate-iruzkinen blokea"
1931
1932 #. (itstool) path: example/programlisting
1933 #: C/index.docbook:1610
1934 #, no-wrap
1935 msgid ""
1936 "\n"
1937 "/**\n"
1938 " * SomeWidget:some-property:\n"
1939 " *\n"
1940 " * Here you can document a property.\n"
1941 " */\n"
1942 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
1943 msgstr ""
1944 "\n"
1945 "/**\n"
1946 " * TrepetaBat:propietate-bat:\n"
1947 " *\n"
1948 " * Hemen propietate bat dokumentatu dezakezu.\n"
1949 " */\n"
1950 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
1951
1952 #. (itstool) path: sect2/title
1953 #. (itstool) path: example/title
1954 #: C/index.docbook:1622 C/index.docbook:1641
1955 msgid "Signal comment block"
1956 msgstr "Seinale-iruzkinen blokea"
1957
1958 #. (itstool) path: listitem/para
1959 #: C/index.docbook:1628
1960 msgid ""
1961 "Document when the signal is emitted and whether it is emitted before or "
1962 "after other signals."
1963 msgstr "Dokumentatu seinalea noiz igortzen den eta beste seinaleen aurretik ala ondoren igortzen den."
1964
1965 #. (itstool) path: listitem/para
1966 #: C/index.docbook:1634
1967 msgid "Document what an application might do in the signal handler."
1968 msgstr "Dokumentatu aplikazio batek zer egin behar duen seinale-maneiatzailean."
1969
1970 #. (itstool) path: example/programlisting
1971 #: C/index.docbook:1642
1972 #, no-wrap
1973 msgid ""
1974 "\n"
1975 "/**\n"
1976 " * FooWidget::foobarized:\n"
1977 " * @widget: the widget that received the signal\n"
1978 " * @foo: some foo\n"
1979 " * @bar: some bar\n"
1980 " *\n"
1981 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
1982 " */\n"
1983 "foo_signals[FOOBARIZED] =\n"
1984 " g_signal_new (\"foobarized\",\n"
1985 " ...\n"
1986 msgstr ""
1987
1988 #. (itstool) path: sect2/title
1989 #. (itstool) path: example/title
1990 #: C/index.docbook:1659 C/index.docbook:1660
1991 msgid "Struct comment block"
1992 msgstr ""
1993
1994 #. (itstool) path: example/programlisting
1995 #: C/index.docbook:1661
1996 #, no-wrap
1997 msgid ""
1998 "\n"
1999 "/**\n"
2000 " * FooWidget:\n"
2001 " * @bar: some #gboolean\n"
2002 " *\n"
2003 " * This is the best widget, ever.\n"
2004 " */\n"
2005 "typedef struct _FooWidget {\n"
2006 " GtkWidget parent_instance;\n"
2007 "\n"
2008 " gboolean bar;\n"
2009 "} FooWidget;\n"
2010 msgstr ""
2011
2012 #. (itstool) path: sect2/para
2013 #: C/index.docbook:1676
2014 msgid ""
2015 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2016 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2017 "behaviour."
2018 msgstr ""
2019
2020 #. (itstool) path: sect2/para
2021 #: C/index.docbook:1682
2022 msgid ""
2023 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2024 "it will be considered private automatically and doesn't need to be mentioned "
2025 "in the comment block."
2026 msgstr ""
2027
2028 #. (itstool) path: sect2/para
2029 #: C/index.docbook:1688
2030 msgid ""
2031 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2032 "is usually a good idea to add a comment block for a class, if it has "
2033 "vmethods (as this is how they can be documented). For the GObject itself one "
2034 "can use the related section docs, having a separate block for the instance "
2035 "struct would be useful if the instance has public fields. One disadvantage "
2036 "here is that this creates two index entries of the same name (the structure "
2037 "and the section)."
2038 msgstr ""
2039
2040 #. (itstool) path: sect2/title
2041 #. (itstool) path: example/title
2042 #: C/index.docbook:1700 C/index.docbook:1701
2043 msgid "Enum comment block"
2044 msgstr "Enumerazioen iruzkin-blokea"
2045
2046 #. (itstool) path: example/programlisting
2047 #: C/index.docbook:1702
2048 #, no-wrap
2049 msgid ""
2050 "\n"
2051 "/**\n"
2052 " * Something:\n"
2053 " * @SOMETHING_FOO: something foo\n"
2054 " * @SOMETHING_BAR: something bar\n"
2055 " *\n"
2056 " * Enum values used for the thing, to specify the thing.\n"
2057 " */\n"
2058 "typedef enum {\n"
2059 " SOMETHING_FOO,\n"
2060 " SOMETHING_BAR,\n"
2061 " /*&lt; private &gt;*/\n"
2062 " SOMETHING_COUNT\n"
2063 "} Something;\n"
2064 msgstr ""
2065
2066 #. (itstool) path: sect2/para
2067 #: C/index.docbook:1719
2068 msgid ""
2069 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2070 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2071 "behaviour."
2072 msgstr ""
2073
2074 #. (itstool) path: sect1/title
2075 #: C/index.docbook:1730
2076 msgid "Inline program documentation"
2077 msgstr "Programa-dokumentazio integratua"
2078
2079 #. (itstool) path: sect1/para
2080 #: C/index.docbook:1731
2081 msgid ""
2082 "You can document programs and their commandline interface using inline "
2083 "documentation."
2084 msgstr "Programak eta haien komando-lerroko interfazeak dokumentazio integratuaren bidez dokumentatu daitezke."
2085
2086 #. (itstool) path: variablelist/title
2087 #: C/index.docbook:1737
2088 msgid "Tags"
2089 msgstr "Etiketak"
2090
2091 #. (itstool) path: varlistentry/term
2092 #: C/index.docbook:1739
2093 msgid "PROGRAM"
2094 msgstr "PROGRAM"
2095
2096 #. (itstool) path: listitem/para
2097 #: C/index.docbook:1742
2098 msgid "Defines the start of a program documentation."
2099 msgstr "Programa-dokumentazio baten hasiera definitzen du."
2100
2101 #. (itstool) path: varlistentry/term
2102 #: C/index.docbook:1749
2103 msgid "@short_description:"
2104 msgstr "@short_description:"
2105
2106 #. (itstool) path: listitem/para
2107 #: C/index.docbook:1751
2108 msgid "Defines a short description of the program. (Optional)"
2109 msgstr "Programaren deskribapen laburra definitzen du. (Aukerakoa)"
2110
2111 #. (itstool) path: varlistentry/term
2112 #: C/index.docbook:1758
2113 msgid "@synopsis:"
2114 msgstr "@synopsis:"
2115
2116 #. (itstool) path: listitem/para
2117 #: C/index.docbook:1760
2118 msgid ""
2119 "Defines the arguments, or list of arguments that the program can take. "
2120 "(Optional)"
2121 msgstr "Programak hartu ditzakeen argumentuak edo argumentuen zerrenda definitzen du. (Aukerakoa)"
2122
2123 #. (itstool) path: varlistentry/term
2124 #: C/index.docbook:1768
2125 msgid "@see_also:"
2126 msgstr "@see_also:"
2127
2128 #. (itstool) path: listitem/para
2129 #: C/index.docbook:1770
2130 msgid "See Also manual page section. (Optional)"
2131 msgstr "Eskuliburuaren 'Ikus halaber' orri-atala. (Aukerakoa)"
2132
2133 #. (itstool) path: varlistentry/term
2134 #: C/index.docbook:1777
2135 msgid "@arg:"
2136 msgstr "@arg:"
2137
2138 #. (itstool) path: listitem/para
2139 #: C/index.docbook:1779
2140 msgid "Argument(s) passed to the program and their description. (Optional)"
2141 msgstr "Programari pasatutako argumentua(k) eta haien deskribapena. (Aukerakoa)"
2142
2143 #. (itstool) path: varlistentry/term
2144 #: C/index.docbook:1786
2145 msgid "Description:"
2146 msgstr "Deskribapena:"
2147
2148 #. (itstool) path: listitem/para
2149 #: C/index.docbook:1788
2150 msgid "A longer description of the program."
2151 msgstr "Programaren deskribapen luzeagoa."
2152
2153 #. (itstool) path: listitem/para
2154 #: C/index.docbook:1797
2155 msgid "Specify what value(s) the program returns. (Optional)"
2156 msgstr "Zehaztu programak itzultzen d(it)uen balioa(k). (Aukerakoa)"
2157
2158 #. (itstool) path: sect2/title
2159 #: C/index.docbook:1806
2160 msgid "Example of program documentation."
2161 msgstr "Programa-dokumentazioaren adibidea."
2162
2163 #. (itstool) path: example/title
2164 #: C/index.docbook:1807
2165 msgid "Program documentation block"
2166 msgstr "Programa-dokumentazioaren blokea"
2167
2168 #. (itstool) path: example/programlisting
2169 #: C/index.docbook:1808
2170 #, no-wrap
2171 msgid ""
2172 "\n"
2173 "/**\n"
2174 " * PROGRAM:test-program\n"
2175 " * @short_description: A test program\n"
2176 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2177 " * @see_also: test(1)\n"
2178 " * @--arg1 *arg*: set arg1 to *arg*\n"
2179 " * @--arg2 *arg*: set arg2 to *arg*\n"
2180 " * @-v, --version: Print the version number\n"
2181 " * @-h, --help: Print the help message\n"
2182 " *\n"
2183 " * Long description of program.\n"
2184 " *\n"
2185 " * Returns: Zero on success, non-zero on failure\n"
2186 " */\n"
2187 "int main(int argc, char *argv[])\n"
2188 "{\n"
2189 "\treturn 0;\n"
2190 "}\n"
2191 msgstr ""
2192
2193 #. (itstool) path: sect1/title
2194 #: C/index.docbook:1834
2195 msgid "Useful DocBook tags"
2196 msgstr "DocBook etiketa erabilgarriak"
2197
2198 #. (itstool) path: sect1/para
2199 #: C/index.docbook:1836
2200 msgid ""
2201 "Here are some DocBook tags which are most useful when documenting the code."
2202 msgstr ""
2203
2204 #. (itstool) path: informalexample/programlisting
2205 #: C/index.docbook:1845
2206 #, no-wrap
2207 msgid ""
2208 "\n"
2209 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2210 msgstr ""
2211
2212 #. (itstool) path: sect1/para
2213 #: C/index.docbook:1841
2214 msgid ""
2215 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2216 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2217 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2218 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2219 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2220 msgstr ""
2221
2222 #. (itstool) path: informalexample/programlisting
2223 #: C/index.docbook:1858
2224 #, no-wrap
2225 msgid ""
2226 "\n"
2227 "&lt;function&gt;...&lt;/function&gt;\n"
2228 msgstr ""
2229 "\n"
2230 "&lt;function&gt;...&lt;/function&gt;\n"
2231
2232 #. (itstool) path: sect1/para
2233 #: C/index.docbook:1855
2234 msgid ""
2235 "To refer to an external function, e.g. a standard C function: "
2236 "<_:informalexample-1/>"
2237 msgstr "Kanpoko funtzio bati, adibidez C funtzio estandar bati, erreferentzia egiteko: <_:informalexample-1/>"
2238
2239 #. (itstool) path: informalexample/programlisting
2240 #: C/index.docbook:1867
2241 #, no-wrap
2242 msgid ""
2243 "\n"
2244 "&lt;example&gt;\n"
2245 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2246 " &lt;programlisting language=\"C\"&gt;\n"
2247 " ...\n"
2248 " &lt;/programlisting&gt;\n"
2249 "&lt;/example&gt;\n"
2250 msgstr ""
2251 "\n"
2252 "&lt;example&gt;\n"
2253 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
2254 " &lt;programlisting language=\"C\"&gt;\n"
2255 " ...\n"
2256 " &lt;/programlisting&gt;\n"
2257 "&lt;/example&gt;\n"
2258
2259 #. (itstool) path: informalexample/programlisting
2260 #: C/index.docbook:1878
2261 #, no-wrap
2262 msgid ""
2263 "\n"
2264 "&lt;informalexample&gt;\n"
2265 " &lt;programlisting language=\"C\"&gt;\n"
2266 " ...\n"
2267 " &lt;/programlisting&gt;\n"
2268 "&lt;/informalexample&gt;\n"
2269 msgstr ""
2270 "\n"
2271 "&lt;informalexample&gt;\n"
2272 " &lt;programlisting language=\"C\"&gt;\n"
2273 " ...\n"
2274 " &lt;/programlisting&gt;\n"
2275 "&lt;/informalexample&gt;\n"
2276
2277 #. (itstool) path: informalexample/programlisting
2278 #: C/index.docbook:1890
2279 #, no-wrap
2280 msgid ""
2281 "\n"
2282 "|[&lt;!-- language=\"C\" --&gt;\n"
2283 " ...\n"
2284 "]|\n"
2285 msgstr ""
2286 "\n"
2287 "|[&lt;!-- language=\"C\" --&gt;\n"
2288 " ...\n"
2289 "]|\n"
2290
2291 #. (itstool) path: sect1/para
2292 #: C/index.docbook:1864
2293 msgid ""
2294 "To include example code: <_:informalexample-1/> or possibly this, for very "
2295 "short code fragments which don't need a title: <_:informalexample-2/> In "
2296 "both cases, the language attribute is optional and is used as a hint to the "
2297 "syntax highlighting engine (pygments for html output). For the latter GTK-"
2298 "Doc also supports an abbreviation: <_:informalexample-3/>"
2299 msgstr ""
2300
2301 #. (itstool) path: informalexample/programlisting
2302 #: C/index.docbook:1901
2303 #, no-wrap
2304 msgid ""
2305 "\n"
2306 "&lt;itemizedlist&gt;\n"
2307 " &lt;listitem&gt;\n"
2308 " &lt;para&gt;\n"
2309 " ...\n"
2310 " &lt;/para&gt;\n"
2311 " &lt;/listitem&gt;\n"
2312 " &lt;listitem&gt;\n"
2313 " &lt;para&gt;\n"
2314 " ...\n"
2315 " &lt;/para&gt;\n"
2316 " &lt;/listitem&gt;\n"
2317 "&lt;/itemizedlist&gt;\n"
2318 msgstr ""
2319 "\n"
2320 "&lt;itemizedlist&gt;\n"
2321 " &lt;listitem&gt;\n"
2322 " &lt;para&gt;\n"
2323 " ...\n"
2324 " &lt;/para&gt;\n"
2325 " &lt;/listitem&gt;\n"
2326 " &lt;listitem&gt;\n"
2327 " &lt;para&gt;\n"
2328 " ...\n"
2329 " &lt;/para&gt;\n"
2330 " &lt;/listitem&gt;\n"
2331 "&lt;/itemizedlist&gt;\n"
2332
2333 #. (itstool) path: sect1/para
2334 #: C/index.docbook:1898
2335 msgid "To include bulleted lists: <_:informalexample-1/>"
2336 msgstr "Buletdun zerrendak sartzeko: <_:informalexample-1/>"
2337
2338 #. (itstool) path: informalexample/programlisting
2339 #: C/index.docbook:1921
2340 #, no-wrap
2341 msgid ""
2342 "\n"
2343 "&lt;note&gt;\n"
2344 " &lt;para&gt;\n"
2345 " Make sure you free the data after use.\n"
2346 " &lt;/para&gt;\n"
2347 "&lt;/note&gt;\n"
2348 msgstr ""
2349 "\n"
2350 "&lt;note&gt;\n"
2351 " &lt;para&gt;\n"
2352 " Ziurtatu datuak askatzen dituzula haiek erabili ondoren.\n"
2353 " &lt;/para&gt;\n"
2354 "&lt;/note&gt;\n"
2355
2356 #. (itstool) path: sect1/para
2357 #: C/index.docbook:1918
2358 msgid ""
2359 "To include a note which stands out from the text: <_:informalexample-1/>"
2360 msgstr ""
2361
2362 #. (itstool) path: informalexample/programlisting
2363 #: C/index.docbook:1934
2364 #, no-wrap
2365 msgid ""
2366 "\n"
2367 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
2368 msgstr ""
2369 "\n"
2370 "&lt;type&gt;sinatu gabeko karakterea&lt;/type&gt;\n"
2371
2372 #. (itstool) path: sect1/para
2373 #: C/index.docbook:1931
2374 msgid "To refer to a type: <_:informalexample-1/>"
2375 msgstr "Mota bati erreferentzia egiteko: <_:informalexample-1/>"
2376
2377 #. (itstool) path: informalexample/programlisting
2378 #: C/index.docbook:1943
2379 #, no-wrap
2380 msgid ""
2381 "\n"
2382 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
2383 msgstr ""
2384 "\n"
2385 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
2386
2387 #. (itstool) path: sect1/para
2388 #: C/index.docbook:1940
2389 msgid ""
2390 "To refer to an external structure (not one described in the GTK docs): "
2391 "<_:informalexample-1/>"
2392 msgstr "Kanpoko egitura bati (ez GTK dokumentuetan deskribatutako bati) erreferentzia egiteko: <_:informalexample-1/>"
2393
2394 #. (itstool) path: informalexample/programlisting
2395 #: C/index.docbook:1952
2396 #, no-wrap
2397 msgid ""
2398 "\n"
2399 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
2400 msgstr ""
2401 "\n"
2402 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
2403
2404 #. (itstool) path: sect1/para
2405 #: C/index.docbook:1949
2406 msgid "To refer to a field of a structure: <_:informalexample-1/>"
2407 msgstr "Egitura baten eremu bati erreferentzia egiteko: <_:informalexample-1/>"
2408
2409 #. (itstool) path: informalexample/programlisting
2410 #: C/index.docbook:1961
2411 #, no-wrap
2412 msgid ""
2413 "\n"
2414 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
2415 msgstr ""
2416 "\n"
2417 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
2418
2419 #. (itstool) path: sect1/para
2420 #: C/index.docbook:1958
2421 msgid ""
2422 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
2423 "you'll probably be using #GtkWidget instead (to automatically create a link "
2424 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
2425 "abbreviations</link>)."
2426 msgstr ""
2427
2428 #. (itstool) path: informalexample/programlisting
2429 #: C/index.docbook:1972
2430 #, no-wrap
2431 msgid ""
2432 "\n"
2433 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
2434 msgstr ""
2435 "\n"
2436 "&lt;emphasis&gt;Hau garrantzitsua da&lt;/emphasis&gt;\n"
2437
2438 #. (itstool) path: sect1/para
2439 #: C/index.docbook:1969
2440 msgid "To emphasize text: <_:informalexample-1/>"
2441 msgstr "Testua nabarmentzeko: <_:informalexample-1/>"
2442
2443 #. (itstool) path: informalexample/programlisting
2444 #: C/index.docbook:1981
2445 #, no-wrap
2446 msgid ""
2447 "\n"
2448 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
2449 msgstr ""
2450 "\n"
2451 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
2452
2453 #. (itstool) path: sect1/para
2454 #: C/index.docbook:1978
2455 msgid "For filenames use: <_:informalexample-1/>"
2456 msgstr "Fitxategi-izenetarako, erabili: <_:informalexample-1/>"
2457
2458 #. (itstool) path: informalexample/programlisting
2459 #: C/index.docbook:1990
2460 #, no-wrap
2461 msgid ""
2462 "\n"
2463 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
2464 msgstr ""
2465 "\n"
2466 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
2467
2468 #. (itstool) path: sect1/para
2469 #: C/index.docbook:1987
2470 msgid "To refer to keys use: <_:informalexample-1/>"
2471 msgstr "Teklei erreferentzia egiteko, erabili: <_:informalexample-1/>"
2472
2473 #. (itstool) path: chapter/title
2474 #: C/index.docbook:2000
2475 msgid "Filling the extra files"
2476 msgstr "Fitxategi gehigarriak betetzea"
2477
2478 #. (itstool) path: chapter/para
2479 #: C/index.docbook:2002
2480 msgid ""
2481 "There are a couple of extra files, that need to be maintained along with the "
2482 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
2483 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
2484 "<filename>&lt;package&gt;-sections.txt</filename>."
2485 msgstr ""
2486
2487 #. (itstool) path: sect1/title
2488 #: C/index.docbook:2011
2489 msgid "Editing the types file"
2490 msgstr "Moten fitxategia editatzea"
2491
2492 #. (itstool) path: sect1/para
2493 #: C/index.docbook:2013
2494 msgid ""
2495 "If your library or application includes GObjects, you want their signals, "
2496 "arguments/parameters and position in the hierarchy to be shown in the "
2497 "documentation. All you need to do, is to list the <function>xxx_get_type</"
2498 "function> functions together with their include inside the "
2499 "<filename>&lt;package&gt;.types</filename> file."
2500 msgstr ""
2501
2502 #. (itstool) path: example/title
2503 #: C/index.docbook:2022
2504 msgid "Example &lt;package&gt;.types file"
2505 msgstr "&lt;Pakete&gt;.moten adibideko fitxategia"
2506
2507 #. (itstool) path: example/programlisting
2508 #: C/index.docbook:2023
2509 #, no-wrap
2510 msgid ""
2511 "\n"
2512 "#include &lt;gtk/gtk.h&gt;\n"
2513 "\n"
2514 "gtk_accel_label_get_type\n"
2515 "gtk_adjustment_get_type\n"
2516 "gtk_alignment_get_type\n"
2517 "gtk_arrow_get_type\n"
2518 msgstr ""
2519 "\n"
2520 "#include &lt;gtk/gtk.h&gt;\n"
2521 "\n"
2522 "gtk_accel_label_get_type\n"
2523 "gtk_adjustment_get_type\n"
2524 "gtk_alignment_get_type\n"
2525 "gtk_arrow_get_type\n"
2526
2527 #. (itstool) path: sect1/para
2528 #: C/index.docbook:2034
2529 msgid ""
2530 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
2531 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
2532 "<filename>Makefile.am</filename>. If you use this approach you should not "
2533 "dist the types file nor have it under version control."
2534 msgstr ""
2535
2536 #. (itstool) path: sect1/title
2537 #: C/index.docbook:2043
2538 msgid "Editing the master document"
2539 msgstr "Dokumentu maisua editatzea"
2540
2541 #. (itstool) path: sect1/para
2542 #: C/index.docbook:2045
2543 msgid ""
2544 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
2545 "inline source comments, the GTK-Doc tools generate one documentation page "
2546 "per class or module as a separate file. The master document includes them "
2547 "and place them in an order."
2548 msgstr ""
2549
2550 #. (itstool) path: sect1/para
2551 #: C/index.docbook:2052
2552 msgid ""
2553 "While GTK-Doc creates a template master document for you, later runs will "
2554 "not touch it again. This means that one can freely structure the "
2555 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
2556 "has now a test suite, where also the master-document is recreated from "
2557 "scratch. Its a good idea to look at this from time to time to see if there "
2558 "are some new goodies introduced there."
2559 msgstr ""
2560
2561 #. (itstool) path: tip/para
2562 #: C/index.docbook:2062
2563 msgid ""
2564 "Do not create tutorials as extra documents. Just write extra chapters. The "
2565 "benefit of directly embedding the tutorial for your library into the API "
2566 "documentation is that it is easy to link for the tutorial to symbol "
2567 "documentation. Apart chances are higher that the tutorial gets updates along "
2568 "with the library."
2569 msgstr ""
2570
2571 #. (itstool) path: sect1/para
2572 #: C/index.docbook:2071
2573 msgid ""
2574 "So what are the things to change inside the master document? For a start is "
2575 "only a little. There are some placeholders (text in square brackets) there "
2576 "which you should take care of."
2577 msgstr "Beraz, zein dira dokumentu maisuaren barruan aldatu behar diren gauzak? Hasteko, ezer gutxi. Badaude zenbait leku-marka (kortxete barruan dauden testuak), horiek zaindu behar dituzu."
2578
2579 #. (itstool) path: example/title
2580 #: C/index.docbook:2078
2581 msgid "Master document header"
2582 msgstr "Dokumentu maisuaren goiburua"
2583
2584 #. (itstool) path: example/programlisting
2585 #: C/index.docbook:2079
2586 #, no-wrap
2587 msgid ""
2588 "\n"
2589 "&lt;bookinfo&gt;\n"
2590 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
2591 " &lt;releaseinfo&gt;\n"
2592 " for MODULENAME [VERSION]\n"
2593 " The latest version of this documentation can be found on-line at\n"
2594 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
2595 " &lt;/releaseinfo&gt;\n"
2596 "&lt;/bookinfo&gt;\n"
2597 "\n"
2598 "&lt;chapter&gt;\n"
2599 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
2600 msgstr ""
2601
2602 #. (itstool) path: sect1/para
2603 #: C/index.docbook:2095
2604 msgid ""
2605 "In addition a few option elements are created in commented form. You can "
2606 "review these and enable them as you like."
2607 msgstr "Horrez gain, iruzkin modura sortzen diren aukerako elementu gutxi batzuk daude. Errepasatu horiek eta gaitu nahieran."
2608
2609 #. (itstool) path: example/title
2610 #: C/index.docbook:2101
2611 msgid "Optional part in the master document"
2612 msgstr "Dokumentu maisuaren aukerako atala"
2613
2614 #. (itstool) path: example/programlisting
2615 #: C/index.docbook:2102
2616 #, no-wrap
2617 msgid ""
2618 "\n"
2619 " &lt;!-- enable this when you use gobject introspection annotations\n"
2620 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
2621 " --&gt;\n"
2622 msgstr ""
2623 "\n"
2624 " &lt;!-- gaitu hau gobject introskpekzio-oharrak erabiltzen dituzunean\n"
2625 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
2626 " --&gt;\n"
2627
2628 #. (itstool) path: sect1/para
2629 #: C/index.docbook:2110
2630 msgid ""
2631 "Finally you need to add new section whenever you introduce one. The <link "
2632 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
2633 "you of newly generated xml files that are not yet included into the doc."
2634 msgstr ""
2635
2636 #. (itstool) path: example/title
2637 #: C/index.docbook:2118 C/index.docbook:2153
2638 msgid "Including generated sections"
2639 msgstr "Sortutako atalak sartzea"
2640
2641 #. (itstool) path: example/programlisting
2642 #: C/index.docbook:2119
2643 #, no-wrap
2644 msgid ""
2645 "\n"
2646 " &lt;chapter&gt;\n"
2647 " &lt;title&gt;my library&lt;/title&gt;\n"
2648 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
2649 " ...\n"
2650 msgstr ""
2651 "\n"
2652 " &lt;kapitulua&gt;\n"
2653 " &lt;izenburua&gt;nire liburutegia&lt;/title&gt;\n"
2654 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
2655 " ...\n"
2656
2657 #. (itstool) path: sect1/title
2658 #: C/index.docbook:2131
2659 msgid "Editing the section file"
2660 msgstr "Atalen fitxategia editatzea"
2661
2662 #. (itstool) path: sect1/para
2663 #: C/index.docbook:2133
2664 msgid ""
2665 "The section file is used to organise the documentation output by GTK-Doc. "
2666 "Here one specifies which symbol belongs to which module or class and control "
2667 "the visibility (public or private)."
2668 msgstr ""
2669
2670 #. (itstool) path: sect1/para
2671 #: C/index.docbook:2139
2672 msgid ""
2673 "The section file is a plain text file with tags delimiting sections. Blank "
2674 "lines are ignored and lines starting with a '#' are treated as comment lines."
2675 msgstr ""
2676
2677 #. (itstool) path: note/para
2678 #: C/index.docbook:2146
2679 msgid ""
2680 "While the tags make the file look like xml, it is not. Please do not close "
2681 "tags like &lt;SUBSECTION&gt;."
2682 msgstr ""
2683
2684 #. (itstool) path: example/programlisting
2685 #: C/index.docbook:2154
2686 #, no-wrap
2687 msgid ""
2688 "\n"
2689 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
2690 "\n"
2691 "&lt;SECTION&gt;\n"
2692 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
2693 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
2694 "MeepApp\n"
2695 "&lt;SUBSECTION Standard&gt;\n"
2696 "MEEP_APP\n"
2697 "...\n"
2698 "MeepAppClass\n"
2699 "meep_app_get_type\n"
2700 "&lt;/SECTION&gt;\n"
2701 msgstr ""
2702
2703 #. (itstool) path: sect1/para
2704 #: C/index.docbook:2171
2705 msgid ""
2706 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
2707 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
2708 "FILE&gt;' will result in the section declarations being output in the "
2709 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
2710 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
2711 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
2712 "(The name of the HTML file is based on the module name and the section "
2713 "title, or for GObjects it is based on the GObjects class name converted to "
2714 "lower case)."
2715 msgstr ""
2716
2717 #. (itstool) path: sect1/para
2718 #: C/index.docbook:2183
2719 msgid ""
2720 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
2721 "section. It is only useful before the templates (if used) are initially "
2722 "created, since the title set in the template file overrides this. Also if "
2723 "one uses SECTION comment in the sources, this is obsolete."
2724 msgstr ""
2725
2726 #. (itstool) path: sect1/para
2727 #: C/index.docbook:2190
2728 msgid ""
2729 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
2730 "Currently it outputs a blank line between subsections in the synopsis "
2731 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
2732 "declarations (e.g. the functions like g_object_get_type and macros like "
2733 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
2734 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
2735 "declarations which will not be output (it is a handy way to avoid warning "
2736 "messages about unused declarations). If your library contains private types "
2737 "which you don't want to appear in the object hierarchy and the list of "
2738 "implemented or required interfaces, add them to a Private subsection. "
2739 "Whether you would place GObject and GObjectClass like structs in public or "
2740 "Standard section depends if they have public entries (variables, vmethods)."
2741 msgstr ""
2742
2743 #. (itstool) path: sect1/para
2744 #: C/index.docbook:2209
2745 msgid ""
2746 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
2747 "#include files which are shown in the synopsis sections. It contains a comma-"
2748 "separate list of #include files, without the angle brackets. If you set it "
2749 "outside of any sections, it acts for all sections until the end of the file. "
2750 "If you set it within a section, it only applies to that section."
2751 msgstr ""
2752
2753 #. (itstool) path: chapter/title
2754 #: C/index.docbook:2223
2755 msgid "Controlling the result"
2756 msgstr "Emaitza kontrolatzea"
2757
2758 #. (itstool) path: chapter/para
2759 #: C/index.docbook:2225
2760 msgid ""
2761 "A GTK-Doc run generates report files inside the documentation directory. The "
2762 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
2763 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
2764 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
2765 "files that can be viewed and postprocessed easily."
2766 msgstr ""
2767
2768 #. (itstool) path: chapter/para
2769 #: C/index.docbook:2234
2770 msgid ""
2771 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
2772 "the documentation coverage summary. Below are two sections divided by blank "
2773 "lines. The first section lists undocumented or incomplete symbols. The "
2774 "second section does the same for section docs. Incomplete entries are those, "
2775 "which have documentation, but where e.g. a new parameter has been added."
2776 msgstr ""
2777
2778 #. (itstool) path: chapter/para
2779 #: C/index.docbook:2243
2780 msgid ""
2781 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
2782 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
2783 "in the sources. Check if they have been removed or if they are misspelled."
2784 msgstr ""
2785
2786 #. (itstool) path: chapter/para
2787 #: C/index.docbook:2250
2788 msgid ""
2789 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
2790 "where the GTK-Doc scanner has found documentation, but does not know where "
2791 "to put it. This means that the symbol has not yet been added to the "
2792 "<filename>&lt;package&gt;-sections.txt</filename> file."
2793 msgstr ""
2794
2795 #. (itstool) path: tip/para
2796 #: C/index.docbook:2258
2797 msgid ""
2798 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in "
2799 "Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity "
2800 "checks during <command>make check</command> run."
2801 msgstr ""
2802
2803 #. (itstool) path: chapter/para
2804 #: C/index.docbook:2265
2805 msgid ""
2806 "One can also look at the files produced by the source code scanner: "
2807 "<filename>&lt;package&gt;-decl-list.txt</filename> and "
2808 "<filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared "
2809 "with the section file if that is manually maintained. The second lists all "
2810 "declarations from the headers. If a symbol is missing one could check if "
2811 "this file contains it."
2812 msgstr ""
2813
2814 #. (itstool) path: chapter/para
2815 #: C/index.docbook:2274
2816 msgid ""
2817 "If the project is GObject based, one can also look into the files produced "
2818 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
2819 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
2820 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
2821 "<filename>&lt;package&gt;.prerequisites.txt</filename> and "
2822 "<filename>&lt;package&gt;.signals.txt</filename>. If there are missing "
2823 "symbols in any of those, one can ask GTK-Doc to keep the intermediate "
2824 "scanner file for further analysis, by running it as "
2825 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
2826 msgstr ""
2827
2828 #. (itstool) path: chapter/title
2829 #: C/index.docbook:2289
2830 msgid "Modernizing the documentation"
2831 msgstr "Dokumentazioa modernizatzea"
2832
2833 #. (itstool) path: chapter/para
2834 #: C/index.docbook:2291
2835 msgid ""
2836 "GTK-Doc has been around for quite some time. In this section we list new "
2837 "features together with the version since when it is available."
2838 msgstr ""
2839
2840 #. (itstool) path: sect1/title
2841 #: C/index.docbook:2297
2842 msgid "GTK-Doc 1.9"
2843 msgstr "GTK-Doc 1.9"
2844
2845 #. (itstool) path: sect1/para
2846 #: C/index.docbook:2299
2847 msgid ""
2848 "When using xml instead of sgml, one can actually name the master document "
2849 "<filename>&lt;package&gt;-docs.xml</filename>."
2850 msgstr ""
2851
2852 #. (itstool) path: sect1/para
2853 #: C/index.docbook:2304
2854 msgid ""
2855 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
2856 "<filename>Makefile.am</filename>. When this is enabled, the "
2857 "<filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can "
2858 "be removed from the vcs. This only works nicely for projects that have a "
2859 "very regular structure (e.g. each .{c,h} pair will create new section). If "
2860 "one organize a project close to that updating a manually maintained section "
2861 "file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt "
2862 "&lt;package&gt;-sections.txt</code>."
2863 msgstr ""
2864
2865 #. (itstool) path: sect1/para
2866 #: C/index.docbook:2315
2867 msgid ""
2868 "Version 1.8 already introduced the syntax for documenting sections in the "
2869 "sources instead of the separate files under <filename "
2870 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
2871 "whole doc module to not use the extra tmpl build step at all, by using "
2872 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
2873 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
2874 "your source control system and haven't yet switched, just add the flag to "
2875 "<filename>configure.ac</filename> and you are done."
2876 msgstr ""
2877
2878 #. (itstool) path: sect1/title
2879 #: C/index.docbook:2327
2880 msgid "GTK-Doc 1.10"
2881 msgstr "GTK-Doc 1.10"
2882
2883 #. (itstool) path: sect1/para
2884 #: C/index.docbook:2329
2885 msgid ""
2886 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
2887 "<filename>Makefile.am</filename>. When this is enabled, the "
2888 "<filename>&lt;package&gt;.types</filename> is autogenerated and can be "
2889 "removed from the vcs. When using this feature it is important to also setup "
2890 "the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
2891 "code that is build conditionally."
2892 msgstr ""
2893
2894 #. (itstool) path: sect1/title
2895 #: C/index.docbook:2340
2896 msgid "GTK-Doc 1.16"
2897 msgstr "GTK-Doc 1.16"
2898
2899 #. (itstool) path: example/title
2900 #: C/index.docbook:2346
2901 msgid "Enable gtkdoc-check"
2902 msgstr "Gaitu gtkdoc-check"
2903
2904 #. (itstool) path: example/programlisting
2905 #: C/index.docbook:2347
2906 #, no-wrap
2907 msgid ""
2908 "\n"
2909 "if ENABLE_GTK_DOC\n"
2910 "TESTS_ENVIRONMENT = \\\n"
2911 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
2912 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
2913 "TESTS = $(GTKDOC_CHECK)\n"
2914 "endif\n"
2915 msgstr ""
2916
2917 #. (itstool) path: sect1/para
2918 #: C/index.docbook:2342
2919 msgid ""
2920 "This version includes a new tool called gtkdoc-check. This tool can run a "
2921 "set of sanity checks on your documentation. It is enabled by adding these "
2922 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
2923 msgstr ""
2924
2925 #. (itstool) path: sect1/title
2926 #: C/index.docbook:2360
2927 msgid "GTK-Doc 1.20"
2928 msgstr "GTK-Doc 1.20"
2929
2930 #. (itstool) path: sect1/para
2931 #: C/index.docbook:2362
2932 msgid ""
2933 "Version 1.18 brought some initial markdown support. Using markdown in doc "
2934 "comments is less intrusive than writing docbook xml. This version improves a "
2935 "lot on this and add a lot more styles. The section that explains the <link "
2936 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
2937 msgstr ""
2938
2939 #. (itstool) path: sect1/title
2940 #: C/index.docbook:2372
2941 msgid "GTK-Doc 1.25"
2942 msgstr "GTK-Doc 1.25"
2943
2944 #. (itstool) path: example/title
2945 #: C/index.docbook:2383
2946 msgid "Use pre-generated entities"
2947 msgstr ""
2948
2949 #. (itstool) path: example/programlisting
2950 #: C/index.docbook:2384
2951 #, no-wrap
2952 msgid ""
2953 "\n"
2954 "&lt;?xml version=\"1.0\"?&gt;\n"
2955 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
2956 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
2957 "[\n"
2958 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
2959 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
2960 " %gtkdocentities;\n"
2961 "]&gt;\n"
2962 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
2963 " &lt;bookinfo&gt;\n"
2964 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
2965 " &lt;releaseinfo&gt;\n"
2966 " for &amp;package_string;.\n"
2967 " The latest version of this documentation can be found on-line at\n"
2968 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
2969 " &lt;/releaseinfo&gt;\n"
2970 " &lt;/bookinfo&gt;\n"
2971 msgstr ""
2972
2973 #. (itstool) path: sect1/para
2974 #: C/index.docbook:2374
2975 msgid ""
2976 "The makefiles shipped with this version generate an entity file at "
2977 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
2978 "package_name and package_version. You can use this e.g. in the main xml file "
2979 "to avoid hardcoding the version number. Below is an example that shows how "
2980 "the entity file is included in the master template and how the entities are "
2981 "used. The entities can also be used in all generated files, GTK-Doc will use "
2982 "the same xml header in generated xml files. <_:example-1/>"
2983 msgstr ""
2984
2985 #. (itstool) path: chapter/title
2986 #: C/index.docbook:2409
2987 msgid "Documenting other interfaces"
2988 msgstr "Beste interfaze batzuk dokumentatzea"
2989
2990 #. (itstool) path: chapter/para
2991 #: C/index.docbook:2411
2992 msgid ""
2993 "So far we have been using GTK-Doc to document the API of code. The next "
2994 "sections contain suggestions how the tools can be used to document other "
2995 "interfaces too."
2996 msgstr ""
2997
2998 #. (itstool) path: sect1/title
2999 #: C/index.docbook:2418
3000 msgid "Command line options and man pages"
3001 msgstr "Komando-lerroko aukerak eta man orriak"
3002
3003 #. (itstool) path: sect1/para
3004 #: C/index.docbook:2420
3005 msgid ""
3006 "As one can generate man pages for a docbook refentry as well, it sounds like "
3007 "a good idea to use it for that purpose. This way the interface is part of "
3008 "the reference and one gets the man-page for free."
3009 msgstr ""
3010
3011 #. (itstool) path: sect2/title
3012 #: C/index.docbook:2427
3013 msgid "Document the tool"
3014 msgstr "Dokumentatu tresna"
3015
3016 #. (itstool) path: sect2/para
3017 #: C/index.docbook:2429
3018 msgid ""
3019 "Create one refentry file per tool. Following <link "
3020 "linkend=\"settingup_docfiles\">our example</link> we would call it "
3021 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
3022 "that should be used and can look at generated file in the xml subdirectory "
3023 "as well as examples e.g. in glib."
3024 msgstr ""
3025
3026 #. (itstool) path: sect2/title
3027 #: C/index.docbook:2439
3028 msgid "Adding the extra configure check"
3029 msgstr ""
3030
3031 #. (itstool) path: example/title
3032 #: C/index.docbook:2442 C/index.docbook:2460
3033 msgid "Extra configure checks"
3034 msgstr ""
3035
3036 #. (itstool) path: example/programlisting
3037 #: C/index.docbook:2443
3038 #, no-wrap
3039 msgid ""
3040 "\n"
3041 "AC_ARG_ENABLE(man,\n"
3042 " [AC_HELP_STRING([--enable-man],\n"
3043 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
3044 " enable_man=no)\n"
3045 "\n"
3046 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
3047 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
3048 msgstr ""
3049
3050 #. (itstool) path: sect2/title
3051 #: C/index.docbook:2457
3052 msgid "Adding the extra makefile rules"
3053 msgstr ""
3054
3055 #. (itstool) path: example/programlisting
3056 #: C/index.docbook:2461
3057 #, no-wrap
3058 msgid ""
3059 "\n"
3060 "man_MANS = \\\n"
3061 " meeper.1\n"
3062 "\n"
3063 "if ENABLE_GTK_DOC\n"
3064 "if ENABLE_MAN\n"
3065 "\n"
3066 "%.1 : %.xml\n"
3067 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
3068 "\n"
3069 "endif\n"
3070 "endif\n"
3071 "\n"
3072 "BUILT_EXTRA_DIST = $(man_MANS)\n"
3073 "EXTRA_DIST += meep.xml\n"
3074 msgstr ""
3075
3076 #. (itstool) path: sect1/title
3077 #: C/index.docbook:2483
3078 msgid "DBus interfaces"
3079 msgstr "DBus interfazeak"
3080
3081 #. (itstool) path: sect1/para
3082 #: C/index.docbook:2485
3083 msgid ""
3084 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
3085 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
3086 msgstr ""
3087
3088 #. (itstool) path: chapter/title
3089 #: C/index.docbook:2494
3090 msgid "Frequently asked questions"
3091 msgstr "Ohiko galderak"
3092
3093 #. (itstool) path: segmentedlist/segtitle
3094 #: C/index.docbook:2498
3095 msgid "Question"
3096 msgstr "Galdera"
3097
3098 #. (itstool) path: segmentedlist/segtitle
3099 #: C/index.docbook:2499
3100 msgid "Answer"
3101 msgstr "Erantzuna"
3102
3103 #. (itstool) path: seglistitem/seg
3104 #: C/index.docbook:2501
3105 msgid "No class hierarchy."
3106 msgstr "Klase-hierarkiarik ez."
3107
3108 #. (itstool) path: seglistitem/seg
3109 #: C/index.docbook:2502
3110 msgid ""
3111 "The objects <function>xxx_get_type()</function> function has not been "
3112 "entered into the <filename>&lt;package&gt;.types</filename> file."
3113 msgstr ""
3114
3115 #. (itstool) path: seglistitem/seg
3116 #: C/index.docbook:2508
3117 msgid "Still no class hierarchy."
3118 msgstr "Klase-hierarkiarik ez oraindik."
3119
3120 #. (itstool) path: seglistitem/seg
3121 #: C/index.docbook:2509
3122 msgid ""
3123 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
3124 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
3125 "October/msg00006.html\">explanation</ulink>)."
3126 msgstr ""
3127
3128 #. (itstool) path: seglistitem/seg
3129 #: C/index.docbook:2515
3130 msgid "Damn, I have still no class hierarchy."
3131 msgstr "Ene, oraindik ez dago klase-hierarkiarik."
3132
3133 #. (itstool) path: seglistitem/seg
3134 #: C/index.docbook:2516
3135 msgid ""
3136 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
3137 "type>) part of the normal section (don't put this into Standard or Private "
3138 "subsections)."
3139 msgstr ""
3140
3141 #. (itstool) path: seglistitem/seg
3142 #: C/index.docbook:2523
3143 msgid "No symbol index."
3144 msgstr "Ikur-indizerik ez."
3145
3146 #. (itstool) path: seglistitem/seg
3147 #: C/index.docbook:2524
3148 msgid ""
3149 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
3150 "index that xi:includes the generated index?"
3151 msgstr ""
3152
3153 #. (itstool) path: seglistitem/seg
3154 #: C/index.docbook:2530
3155 msgid "Symbols are not linked to their doc-section."
3156 msgstr ""
3157
3158 #. (itstool) path: seglistitem/seg
3159 #: C/index.docbook:2531
3160 msgid ""
3161 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
3162 "gtkdoc-fixxref warns about unresolvable xrefs."
3163 msgstr ""
3164
3165 #. (itstool) path: seglistitem/seg
3166 #: C/index.docbook:2537
3167 msgid "A new class does not appear in the docs."
3168 msgstr "Klase berri bat ez da agertzen dokumentuetan."
3169
3170 #. (itstool) path: seglistitem/seg
3171 #: C/index.docbook:2538
3172 msgid ""
3173 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
3174 "filename>."
3175 msgstr ""
3176
3177 #. (itstool) path: seglistitem/seg
3178 #: C/index.docbook:2544
3179 msgid "A new symbol does not appear in the docs."
3180 msgstr "Ikur berri bat ez da agertzen dokumentuetan."
3181
3182 #. (itstool) path: seglistitem/seg
3183 #: C/index.docbook:2545
3184 msgid ""
3185 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
3186 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
3187 "xrefs. Check if the symbol is correctly listed in the "
3188 "<filename>&lt;package&gt;-sections.txt</filename> in a public subsection."
3189 msgstr ""
3190
3191 #. (itstool) path: seglistitem/seg
3192 #: C/index.docbook:2553
3193 msgid "A type is missing from the class hierarchy."
3194 msgstr "Mota bat falta da klaseen hierarkian."
3195
3196 #. (itstool) path: seglistitem/seg
3197 #: C/index.docbook:2554
3198 msgid ""
3199 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
3200 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
3201 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
3202 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
3203 "or incidentally marked private it will not be shown."
3204 msgstr ""
3205
3206 #. (itstool) path: seglistitem/seg
3207 #: C/index.docbook:2563
3208 msgid "I get foldoc links for all gobject annotations."
3209 msgstr ""
3210
3211 #. (itstool) path: seglistitem/seg
3212 #: C/index.docbook:2564
3213 msgid ""
3214 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
3215 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
3216 msgstr ""
3217
3218 #. (itstool) path: seglistitem/seg
3219 #: C/index.docbook:2572
3220 msgid "Parameter described in source code comment block but does not exist"
3221 msgstr ""
3222
3223 #. (itstool) path: seglistitem/seg
3224 #: C/index.docbook:2573
3225 msgid ""
3226 "Check if the prototype in the header has different parameter names as in the "
3227 "source."
3228 msgstr ""
3229
3230 #. (itstool) path: seglistitem/seg
3231 #: C/index.docbook:2578
3232 msgid "multiple \"IDs\" for constraint linkend: XYZ"
3233 msgstr ""
3234
3235 #. (itstool) path: seglistitem/seg
3236 #: C/index.docbook:2579
3237 msgid ""
3238 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
3239 "filename> file."
3240 msgstr ""
3241
3242 #. (itstool) path: seglistitem/seg
3243 #: C/index.docbook:2582
3244 msgid ""
3245 "Element typename in namespace '' encountered in para, but no template "
3246 "matches."
3247 msgstr ""
3248
3249 #. (itstool) path: chapter/title
3250 #: C/index.docbook:2589
3251 msgid "Tools related to gtk-doc"
3252 msgstr ""
3253
3254 #. (itstool) path: chapter/para
3255 #: C/index.docbook:2591
3256 msgid ""
3257 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
3258 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
3259 "integrates with the trac search."
3260 msgstr ""
3261
3262 #. (itstool) path: chapter/para
3263 #: C/index.docbook:2596
3264 msgid ""
3265 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
3266 "tags in the API to determine the minimum required version."
3267 msgstr ""
3268
3269 #. (itstool) path: appendixinfo/releaseinfo
3270 #: C/fdl-appendix.xml:12
3271 msgid "Version 1.1, March 2000"
3272 msgstr "1.1 bertsioa, 2000ko martxoa"
3273
3274 #. (itstool) path: copyright/year
3275 #: C/fdl-appendix.xml:16
3276 msgid "2000"
3277 msgstr "2000"
3278
3279 #. (itstool) path: copyright/holder
3280 #: C/fdl-appendix.xml:16
3281 msgid "Free Software Foundation, Inc."
3282 msgstr "Free Software Foundation, Inc."
3283
3284 #. (itstool) path: address/street
3285 #: C/fdl-appendix.xml:20
3286 msgid "51 Franklin Street, Suite 330"
3287 msgstr "51 Franklin Street, Suite 330"
3288
3289 #. (itstool) path: address/city
3290 #: C/fdl-appendix.xml:21
3291 msgid "Boston"
3292 msgstr "Boston"
3293
3294 #. (itstool) path: address/state
3295 #: C/fdl-appendix.xml:21
3296 msgid "MA"
3297 msgstr "MA"
3298
3299 #. (itstool) path: address/postcode
3300 #: C/fdl-appendix.xml:22
3301 msgid "02110-1301"
3302 msgstr "02110-1301"
3303
3304 #. (itstool) path: address/country
3305 #: C/fdl-appendix.xml:22
3306 msgid "USA"
3307 msgstr "USA"
3308
3309 #. (itstool) path: para/address
3310 #: C/fdl-appendix.xml:20
3311 msgid ""
3312 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
3313 "<_:postcode-4/> <_:country-5/>"
3314 msgstr "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:postcode-4/> <_:country-5/>"
3315
3316 #. (itstool) path: legalnotice/para
3317 #: C/fdl-appendix.xml:19
3318 msgid ""
3319 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
3320 "of this license document, but changing it is not allowed."
3321 msgstr "<_:address-1/> Edonork egin eta banatu ditzake lizentzia-dokumentu honen kopia literalak, baina debekatuta dago dokumentuan aldaketak egitea."
3322
3323 #. (itstool) path: appendix/title
3324 #. (itstool) path: para/quote
3325 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
3326 msgid "GNU Free Documentation License"
3327 msgstr "GNU Dokumentazio librearen lizentzia"
3328
3329 #. (itstool) path: sect1/title
3330 #: C/fdl-appendix.xml:31
3331 msgid "0. PREAMBLE"
3332 msgstr "0. AITZINSOLASA"
3333
3334 #. (itstool) path: para/quote
3335 #: C/fdl-appendix.xml:34
3336 msgid "free"
3337 msgstr "libre"
3338
3339 #. (itstool) path: sect1/para
3340 #: C/fdl-appendix.xml:32
3341 msgid ""
3342 "The purpose of this License is to make a manual, textbook, or other written "
3343 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
3344 "effective freedom to copy and redistribute it, with or without modifying it, "
3345 "either commercially or noncommercially. Secondarily, this License preserves "
3346 "for the author and publisher a way to get credit for their work, while not "
3347 "being considered responsible for modifications made by others."
3348 msgstr "Lizentzia honen xedea da eskuliburu bat, testuliburu bat edo bestelako edozein dokumentu idatzi <_:quote-1/> egitea askatasunaren zentzuan: edonori ziurtatzea kopiatzeko eta birbanatzeko benetako askatasuna, aldatuta zein aldatu gabe, eta komertzialki zein ez-komertzialki. Bestalde, Lizentziaren bidez autoreei eta argitaratzaileei euren lana aitortzen zaie, eta ez dira beste batzuk egindako aldaketen erantzule."
3349
3350 #. (itstool) path: para/quote
3351 #: C/fdl-appendix.xml:44
3352 msgid "copyleft"
3353 msgstr "copyleft"
3354
3355 #. (itstool) path: sect1/para
3356 #: C/fdl-appendix.xml:43
3357 msgid ""
3358 "This License is a kind of <_:quote-1/>, which means that derivative works of "
3359 "the document must themselves be free in the same sense. It complements the "
3360 "GNU General Public License, which is a copyleft license designed for free "
3361 "software."
3362 msgstr "Lizentzia hau <_:quote-1/> modukoa da, hau da, dokumentu honetatik eratorritako lan guztiek ere libreak izan behar dute zentzu berean. GNU Lizentzia Publiko Orokorra (software librearentzat diseinatutako \"copyleft\" lizentzia) osatzen du."
3363
3364 #. (itstool) path: sect1/para
3365 #: C/fdl-appendix.xml:50
3366 msgid ""
3367 "We have designed this License in order to use it for manuals for free "
3368 "software, because free software needs free documentation: a free program "
3369 "should come with manuals providing the same freedoms that the software does. "
3370 "But this License is not limited to software manuals; it can be used for any "
3371 "textual work, regardless of subject matter or whether it is published as a "
3372 "printed book. We recommend this License principally for works whose purpose "
3373 "is instruction or reference."
3374 msgstr "Lizentzia hau software librearen eskuliburuentzat erabiltzeko diseinatu dugu, izan ere, software libreak dokumentazio librea behar baitu. Programa libre baten eskuliburuak software librearen askatasun berberak izan behar ditu. Baina lizentzia hau ez da software-eskuliburuentzat soilik; edozein testu-lanentzat erabil daiteke, zein gairi buruzkoa den eta liburu gisa inprimatua dagoen ala ez kontuan hartu gabe. Lizentzia hau batez ere gida edo erreferentzia izatea helburu duten lanentzat erabiltzea gomendatzen dugu."
3375
3376 #. (itstool) path: sect1/title
3377 #: C/fdl-appendix.xml:62
3378 msgid "1. APPLICABILITY AND DEFINITIONS"
3379 msgstr "1. APLIKAGARRITASUNA ETA DEFINIZIOAK"
3380
3381 #. (itstool) path: para/quote
3382 #. (itstool) path: para/link
3383 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
3384 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
3385 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
3386 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
3387 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
3388 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
3389 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
3390 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
3391 #: C/fdl-appendix.xml:608
3392 msgid "Document"
3393 msgstr "Dokumentua"
3394
3395 #. (itstool) path: para/quote
3396 #: C/fdl-appendix.xml:69
3397 msgid "you"
3398 msgstr "zu"
3399
3400 #. (itstool) path: sect1/para
3401 #: C/fdl-appendix.xml:63
3402 msgid ""
3403 "This License applies to any manual or other work that contains a notice "
3404 "placed by the copyright holder saying it can be distributed under the terms "
3405 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
3406 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
3407 msgstr "Eskuliburu edo bestelako lan bati Lizentzia honen baldintzen pean bana daitekeela adierazten duen oharra jarri baldin badio egile-eskubideen jabeak, eskuliburu edo lan horri lizentzia hau aplikatuko zaio. Beheo <_:quote-1/> horrek horrelako eskuliburu edo lanei egiten die erreferentzia. Publikoko edonor da lizentziaren hartzaile, eta <_:quote-2/> bidez adierazten da."
3408
3409 #. (itstool) path: para/quote
3410 #. (itstool) path: para/link
3411 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
3412 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
3413 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
3414 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
3415 msgid "Modified Version"
3416 msgstr "Bertsio aldatua"
3417
3418 #. (itstool) path: sect1/para
3419 #: C/fdl-appendix.xml:72
3420 msgid ""
3421 "A <_:quote-1/> of the Document means any work containing the Document or a "
3422 "portion of it, either copied verbatim, or with modifications and/or "
3423 "translated into another language."
3424 msgstr "Dokumentuaren <_:quote-1/> esaten denean, Dokumentu hau osorik edo zati batean biltzen duen edozein lan adierazten da, hau da, kopia literala, aldaketak dituena edo beste hizkuntza batera itzulitakoa."
3425
3426 #. (itstool) path: para/quote
3427 #: C/fdl-appendix.xml:80
3428 msgid "Secondary Section"
3429 msgstr "Bigarren mailako atala"
3430
3431 #. (itstool) path: sect1/para
3432 #: C/fdl-appendix.xml:79
3433 msgid ""
3434 "A <_:quote-1/> is a named appendix or a front-matter section of the "
3435 "<_:link-2/> that deals exclusively with the relationship of the publishers "
3436 "or authors of the Document to the Document's overall subject (or to related "
3437 "matters) and contains nothing that could fall directly within that overall "
3438 "subject. (For example, if the Document is in part a textbook of mathematics, "
3439 "a Secondary Section may not explain any mathematics.) The relationship could "
3440 "be a matter of historical connection with the subject or with related "
3441 "matters, or of legal, commercial, philosophical, ethical or political "
3442 "position regarding them."
3443 msgstr ""
3444
3445 #. (itstool) path: para/quote
3446 #. (itstool) path: para/link
3447 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
3448 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
3449 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
3450 msgid "Invariant Sections"
3451 msgstr "Atal aldaezinak"
3452
3453 #. (itstool) path: para/link
3454 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
3455 msgid "Secondary Sections"
3456 msgstr "Bigarren mailako atalak"
3457
3458 #. (itstool) path: sect1/para
3459 #: C/fdl-appendix.xml:94
3460 msgid ""
3461 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
3462 "being those of Invariant Sections, in the notice that says that the "
3463 "<_:link-3/> is released under this License."
3464 msgstr ""
3465
3466 #. (itstool) path: para/quote
3467 #. (itstool) path: para/link
3468 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
3469 #: C/fdl-appendix.xml:458
3470 msgid "Cover Texts"
3471 msgstr "Azaleko testuak"
3472
3473 #. (itstool) path: sect1/para
3474 #: C/fdl-appendix.xml:103
3475 msgid ""
3476 "The <_:quote-1/> are certain short passages of text that are listed, as "
3477 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the "
3478 "<_:link-2/> is released under this License."
3479 msgstr ""
3480
3481 #. (itstool) path: para/quote
3482 #. (itstool) path: para/link
3483 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
3484 #: C/fdl-appendix.xml:369
3485 msgid "Transparent"
3486 msgstr "Gardena"
3487
3488 #. (itstool) path: para/quote
3489 #. (itstool) path: para/link
3490 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
3491 msgid "Opaque"
3492 msgstr "Opakua"
3493
3494 #. (itstool) path: sect1/para
3495 #: C/fdl-appendix.xml:111
3496 msgid ""
3497 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
3498 "represented in a format whose specification is available to the general "
3499 "public, whose contents can be viewed and edited directly and "
3500 "straightforwardly with generic text editors or (for images composed of "
3501 "pixels) generic paint programs or (for drawings) some widely available "
3502 "drawing editor, and that is suitable for input to text formatters or for "
3503 "automatic translation to a variety of formats suitable for input to text "
3504 "formatters. A copy made in an otherwise Transparent file format whose markup "
3505 "has been designed to thwart or discourage subsequent modification by readers "
3506 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
3507 msgstr ""
3508
3509 #. (itstool) path: sect1/para
3510 #: C/fdl-appendix.xml:128
3511 msgid ""
3512 "Examples of suitable formats for Transparent copies include plain ASCII "
3513 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
3514 "a publicly available DTD, and standard-conforming simple HTML designed for "
3515 "human modification. Opaque formats include PostScript, PDF, proprietary "
3516 "formats that can be read and edited only by proprietary word processors, "
3517 "SGML or XML for which the DTD and/or processing tools are not generally "
3518 "available, and the machine-generated HTML produced by some word processors "
3519 "for output purposes only."
3520 msgstr "Kopia Gardenak egiteko erabil daitezkeen formatu egokien artean, honako hauek ditugu, besteak beste: markaketarik gabeko ASCII soila, Texinfo sarrera-formatua, LaTex sarrera-formatua, SGML edo XML jendeak erabiltzeko moduko DTDarekin, eta pertsonek aldatu ahal izateko diseinatutako HTML sinple eta estandarrarekiko egokitua. Formatu opakoen artean, berriz, honako hauek ditugu: PostScript, PDF, testu-prozesadore jabedunek soilik irakurri eta edita ditzaketen testu-formatu jabedunak, SGML edo XML bereziak (DTD eta/edo prozesatze-tresna erabilgarririk apenas dutenak), eta zenbait testu-prozesadorek irteerako emaitza gisa soilik makina bidez sortutako HTMLak."
3521
3522 #. (itstool) path: para/quote
3523 #. (itstool) path: para/link
3524 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
3525 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
3526 msgid "Title Page"
3527 msgstr "Orriaren izenburua"
3528
3529 #. (itstool) path: sect1/para
3530 #: C/fdl-appendix.xml:141
3531 msgid ""
3532 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
3533 "following pages as are needed to hold, legibly, the material this License "
3534 "requires to appear in the title page. For works in formats which do not have "
3535 "any title page as such, <_:quote-2/> means the text near the most prominent "
3536 "appearance of the work's title, preceding the beginning of the body of the "
3537 "text."
3538 msgstr ""
3539
3540 #. (itstool) path: sect1/title
3541 #: C/fdl-appendix.xml:153
3542 msgid "2. VERBATIM COPYING"
3543 msgstr "2. KOPIA LITERALAK"
3544
3545 #. (itstool) path: para/link
3546 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
3547 msgid "section 3"
3548 msgstr "3. atala"
3549
3550 #. (itstool) path: sect1/para
3551 #: C/fdl-appendix.xml:154
3552 msgid ""
3553 "You may copy and distribute the <_:link-1/> in any medium, either "
3554 "commercially or noncommercially, provided that this License, the copyright "
3555 "notices, and the license notice saying this License applies to the Document "
3556 "are reproduced in all copies, and that you add no other conditions "
3557 "whatsoever to those of this License. You may not use technical measures to "
3558 "obstruct or control the reading or further copying of the copies you make or "
3559 "distribute. However, you may accept compensation in exchange for copies. If "
3560 "you distribute a large enough number of copies you must also follow the "
3561 "conditions in <_:link-2/>."
3562 msgstr "<_:link-1/> edozein euskarritan kopiatu eta banatu dezakezu, komertzialki zein ez-komertzialki, baldin eta Lizentzia hau, copyright-oharrak eta Dokumentuari lizentzia hau aplikatzen zaiola adierazten duen lizentzia-oharra jartzen bazaie kopia guztiei, eta Lizentzia honi beste inolako baldintzarik gehitzen ez badiozu. Egiten edo banatzen dituzun kopietan ezin da erabili irakurketa edo kopiak egitea eragozten edo kontrolatzen duen inolako baliabide teknikorik. Nolanahi ere, kopiak egitearen truke ordaina jasotzea onartzen da. Kopia asko banatzen baduzu (hurrengo atalean zehazten da kopurua), <_:link-2/>-eko baldintzak ere bete behar dituzu."
3563
3564 #. (itstool) path: sect1/para
3565 #: C/fdl-appendix.xml:169
3566 msgid ""
3567 "You may also lend copies, under the same conditions stated above, and you "
3568 "may publicly display copies."
3569 msgstr "Goian azaldutako baldintza berdinen pean kopiak mailegutan ere utz ditzakezu, eta kopiak jendaurrean erakutsi ere bai."
3570
3571 #. (itstool) path: sect1/title
3572 #: C/fdl-appendix.xml:176
3573 msgid "3. COPYING IN QUANTITY"
3574 msgstr "3. KANTITATE HANDIAK KOPIATZEA"
3575
3576 #. (itstool) path: sect1/para
3577 #: C/fdl-appendix.xml:177
3578 msgid ""
3579 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
3580 "and the Document's license notice requires <_:link-2/>, you must enclose the "
3581 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
3582 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
3583 "cover. Both covers must also clearly and legibly identify you as the "
3584 "publisher of these copies. The front cover must present the full title with "
3585 "all words of the title equally prominent and visible. You may add other "
3586 "material on the covers in addition. Copying with changes limited to the "
3587 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
3588 "these conditions, can be treated as verbatim copying in other respects."
3589 msgstr "<_:link-1/> dokumentuaren 100 kopia baino gehiago argitaratzen badituzu, eta Dokumentuaren lizentzia-oharrak <_:link-2/> behar badu, kopiei nahitaez jarri behar dizkiezu argi eta garbi irakurtzen diren Azaleko testu hauek: aurreko azaleko testuak aurreko azalean, eta Atzeko azaleko testuak atzeko azalean. Bi azalek modu argi eta irakurgarrian identifikatu behar zaituzte kopia horien argitaratzaile gisa. Aurreko azalak titulu osoa izan behar du, eta tituluaren hitz guztiak maila berdinean izan behar dute nabarmenak eta ikusteko modukoak. Horrez gainera, beste material batzuk ere gehi ditzakezu azaletan. Azaletara mugatutako aldaketekin egindako kopiak, <_:link-3/> dokumentuaren titulua mantentzen bada eta baldintza horiek betez egiten badira, kopia literaltzat jo daiteke beste alderdi batzuei dagokienez."
3590
3591 #. (itstool) path: sect1/para
3592 #: C/fdl-appendix.xml:195
3593 msgid ""
3594 "If the required texts for either cover are too voluminous to fit legibly, "
3595 "you should put the first ones listed (as many as fit reasonably) on the "
3596 "actual cover, and continue the rest onto adjacent pages."
3597 msgstr "Azaletan jarri beharreko testuak luzeegiak badira modu irakurgarrian ipintzeko, zerrendako lehenak jarri behar dituzu azalean bertan (sartzen diren guztiak), eta hurrengo orrietan jarraitu besteekin."
3598
3599 #. (itstool) path: sect1/para
3600 #: C/fdl-appendix.xml:202
3601 msgid ""
3602 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
3603 "more than 100, you must either include a machine-readable <_:link-3/> copy "
3604 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
3605 "accessible computer-network location containing a complete Transparent copy "
3606 "of the Document, free of added material, which the general network-using "
3607 "public has access to download anonymously at no charge using public-standard "
3608 "network protocols. If you use the latter option, you must take reasonably "
3609 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
3610 "ensure that this Transparent copy will remain thus accessible at the stated "
3611 "location until at least one year after the last time you distribute an "
3612 "Opaque copy (directly or through your agents or retailers) of that edition "
3613 "to the public."
3614 msgstr "<_:link-2/> dokumentuaren 100 kopia <_:link-1/> argitaratzen edo banatzen badituzu, kopia Opako bakoitzarekin batera makinaz irakurtzeko moduko kopia <_:link-3/> bat eman behar duzu, edo bestela, kopia Opako bakoitzean edo bakoitzarekin batera ordenagailu-sare bateko helbide bat adierazi beharko duzu, edonork libreki atzi dezakeena eta Dokumentuaren kopia Garden osoa daukana, gehitutako materialik gabe, sare-erabiltzaile arruntak anonimoki deskargatu ahal izateko doan eta sare-protokolo estandar publikoen bidez. Azken aukeraren bidetik jotzen baduzu, zentzuz eta zuhur jokatu behar duzu kopia Opako asko banatzen hasten zarenean, kopia Garden hori adierazitako kokalekuan urtebetean gutxienez erabilgarri eta atzigarri egongo dela segurtatzeko zuk edizio horren azken kopia Opakoa (zuzenean edo zure agente edo xehekarien bidez) publikoari banatzen diozunetik kontatzen hasita."
3615
3616 #. (itstool) path: sect1/para
3617 #: C/fdl-appendix.xml:222
3618 msgid ""
3619 "It is requested, but not required, that you contact the authors of the "
3620 "<_:link-1/> well before redistributing any large number of copies, to give "
3621 "them a chance to provide you with an updated version of the Document."
3622 msgstr "Bestalde, <_:link-1/> dokumentuaren kopiak kantitate handian birbanatzen hasi aurretik, autoreekin harremanetan jar zaitezen eskatzen zaizu, behartu gabe, Dokumentuaren bertsio eguneratua eman ahal izan diezazuten."
3623
3624 #. (itstool) path: sect1/title
3625 #: C/fdl-appendix.xml:231
3626 msgid "4. MODIFICATIONS"
3627 msgstr "4. ALDAKETAK"
3628
3629 #. (itstool) path: para/link
3630 #: C/fdl-appendix.xml:236
3631 msgid "2"
3632 msgstr "2"
3633
3634 #. (itstool) path: para/link
3635 #: C/fdl-appendix.xml:237
3636 msgid "3"
3637 msgstr "3"
3638
3639 #. (itstool) path: sect1/para
3640 #: C/fdl-appendix.xml:232
3641 msgid ""
3642 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
3643 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
3644 "release the Modified Version under precisely this License, with the Modified "
3645 "Version filling the role of the Document, thus licensing distribution and "
3646 "modification of the Modified Version to whoever possesses a copy of it. In "
3647 "addition, you must do these things in the Modified Version:"
3648 msgstr "<_:link-2/> dokumentuaren <_:link-1/> kopiatu eta banatu dezakezu baldin eta hemen goiko <_:link-3/> eta <_:link-4/> ataletako baldintzak betetzen badituzu, kontuan izanik betiere Bertsio aldatua Lizentzia honen pean banatu behar duzula, Bertsio aldatua izanik Dokumentuaren funtzioa beteko duena, eta, beraz, Bertsio aldatua banatzeko edo aldatzeko baimena eman behar diozula kopia bat duen edonori. Horrez gainera, honako hauek egin behar dituzu Bertsio Aldatuan:"
3649
3650 #. (itstool) path: formalpara/title
3651 #: C/fdl-appendix.xml:248
3652 msgid "A"
3653 msgstr "A"
3654
3655 #. (itstool) path: formalpara/para
3656 #: C/fdl-appendix.xml:249
3657 msgid ""
3658 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
3659 "that of the <_:link-2/>, and from those of previous versions (which should, "
3660 "if there were any, be listed in the History section of the Document). You "
3661 "may use the same title as a previous version if the original publisher of "
3662 "that version gives permission."
3663 msgstr "<_:link-1/> izenburuan (eta azaletan, azalik badu) <_:link-2/> eta aurreko bertsioena ez den beste edozein titulu bat erabili behar duzu (aurreko bertsiorik badago, Dokumentuaren Historiaren atalean zerrendatuta egongo da). Aurreko bertsio horietako baten titulu bera erabil dezakezu, baldin eta jatorrizko argitaratzaileak horretarako baimena ematen badu."
3664
3665 #. (itstool) path: formalpara/title
3666 #: C/fdl-appendix.xml:264
3667 msgid "B"
3668 msgstr "B"
3669
3670 #. (itstool) path: formalpara/para
3671 #: C/fdl-appendix.xml:265
3672 msgid ""
3673 "List on the <_:link-1/>, as authors, one or more persons or entities "
3674 "responsible for authorship of the modifications in the <_:link-2/>, together "
3675 "with at least five of the principal authors of the <_:link-3/> (all of its "
3676 "principal authors, if it has less than five)."
3677 msgstr ""
3678
3679 #. (itstool) path: formalpara/title
3680 #: C/fdl-appendix.xml:279
3681 msgid "C"
3682 msgstr "C"
3683
3684 #. (itstool) path: formalpara/para
3685 #: C/fdl-appendix.xml:280
3686 msgid ""
3687 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
3688 "the publisher."
3689 msgstr "<_:link-1/> titulu-orrian <_:link-2/> bertsio aldatuaren argitaratzailearen izena jarri behar duzu, argitaratzaile gisa."
3690
3691 #. (itstool) path: formalpara/title
3692 #: C/fdl-appendix.xml:291
3693 msgid "D"
3694 msgstr "D"
3695
3696 #. (itstool) path: formalpara/para
3697 #: C/fdl-appendix.xml:292
3698 msgid "Preserve all the copyright notices of the <_:link-1/>."
3699 msgstr "<_:link-1/> dokumentuaren copyright-ohar guztiak gorde behar dituzu."
3700
3701 #. (itstool) path: formalpara/title
3702 #: C/fdl-appendix.xml:301
3703 msgid "E"
3704 msgstr "E"
3705
3706 #. (itstool) path: formalpara/para
3707 #: C/fdl-appendix.xml:302
3708 msgid ""
3709 "Add an appropriate copyright notice for your modifications adjacent to the "
3710 "other copyright notices."
3711 msgstr "Zure aldaketei dagokien copyright-oharra gehitu behar duzu beste copyright-oharren ondoan."
3712
3713 #. (itstool) path: formalpara/title
3714 #: C/fdl-appendix.xml:311
3715 msgid "F"
3716 msgstr "F"
3717
3718 #. (itstool) path: formalpara/para
3719 #: C/fdl-appendix.xml:312
3720 msgid ""
3721 "Include, immediately after the copyright notices, a license notice giving "
3722 "the public permission to use the <_:link-1/> under the terms of this "
3723 "License, in the form shown in the Addendum below."
3724 msgstr "Copyright-oharren jarraian, lizentzia-ohar bat ipini behar duzu, jendeari baimena emateko <_:link-1/> bertsio aldatua erabil dezan Lizentzia horren baldintzen pean, beheko Eranskinean azaltzen den bezala."
3725
3726 #. (itstool) path: formalpara/title
3727 #: C/fdl-appendix.xml:324
3728 msgid "G"
3729 msgstr "G"
3730
3731 #. (itstool) path: para/link
3732 #: C/fdl-appendix.xml:330
3733 msgid "Document's"
3734 msgstr "Dokumentuaren"
3735
3736 #. (itstool) path: formalpara/para
3737 #: C/fdl-appendix.xml:325
3738 msgid ""
3739 "Preserve in that license notice the full lists of <_:link-1/> and required "
3740 "<_:link-2/> given in the <_:link-3/> license notice."
3741 msgstr "Lizentzia-ohar horretan <_:link-3/> lizentzia-oharrean adierazitako <_:link-1/> eta jarri beharreko <_:link-2/> guztien zerrenda gorde behar duzu."
3742
3743 #. (itstool) path: formalpara/title
3744 #: C/fdl-appendix.xml:337
3745 msgid "H"
3746 msgstr "H"
3747
3748 #. (itstool) path: formalpara/para
3749 #: C/fdl-appendix.xml:338
3750 msgid "Include an unaltered copy of this License."
3751 msgstr "Lizentzia honen kopia ere, aldaketarik gabe jarri behar duzu."
3752
3753 #. (itstool) path: formalpara/title
3754 #: C/fdl-appendix.xml:346
3755 msgid "I"
3756 msgstr "I"
3757
3758 #. (itstool) path: para/quote
3759 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
3760 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
3761 msgid "History"
3762 msgstr "Historia"
3763
3764 #. (itstool) path: formalpara/para
3765 #: C/fdl-appendix.xml:347
3766 msgid ""
3767 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
3768 "item stating at least the title, year, new authors, and publisher of the "
3769 "<_:link-2/> as given on the <_:link-3/>. If there is no section entitled "
3770 "<_:quote-4/> in the <_:link-5/>, create one stating the title, year, "
3771 "authors, and publisher of the Document as given on its Title Page, then add "
3772 "an item describing the Modified Version as stated in the previous sentence."
3773 msgstr ""
3774
3775 #. (itstool) path: formalpara/title
3776 #: C/fdl-appendix.xml:365
3777 msgid "J"
3778 msgstr "J"
3779
3780 #. (itstool) path: formalpara/para
3781 #: C/fdl-appendix.xml:366
3782 msgid ""
3783 "Preserve the network location, if any, given in the <_:link-1/> for public "
3784 "access to a <_:link-2/> copy of the Document, and likewise the network "
3785 "locations given in the Document for previous versions it was based on. These "
3786 "may be placed in the <_:quote-3/> section. You may omit a network location "
3787 "for a work that was published at least four years before the Document "
3788 "itself, or if the original publisher of the version it refers to gives "
3789 "permission."
3790 msgstr ""
3791
3792 #. (itstool) path: formalpara/title
3793 #: C/fdl-appendix.xml:383
3794 msgid "K"
3795 msgstr "K"
3796
3797 #. (itstool) path: para/quote
3798 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
3799 msgid "Acknowledgements"
3800 msgstr "Aitortzak"
3801
3802 #. (itstool) path: para/quote
3803 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
3804 msgid "Dedications"
3805 msgstr "Eskaintzak"
3806
3807 #. (itstool) path: formalpara/para
3808 #: C/fdl-appendix.xml:384
3809 msgid ""
3810 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
3811 "title, and preserve in the section all the substance and tone of each of the "
3812 "contributor acknowledgements and/or dedications given therein."
3813 msgstr "<_:quote-1/> edo <_:quote-2/> izeneko edozein ataletan, atalaren titulua gorde behar da, eta ataleko eskertza edota eskaintza bakoitzean egileak darabilen gai eta tonua errespetatu behar dira."
3814
3815 #. (itstool) path: formalpara/title
3816 #: C/fdl-appendix.xml:396
3817 msgid "L"
3818 msgstr "L"
3819
3820 #. (itstool) path: formalpara/para
3821 #: C/fdl-appendix.xml:397
3822 msgid ""
3823 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
3824 "in their titles. Section numbers or the equivalent are not considered part "
3825 "of the section titles."
3826 msgstr ""
3827
3828 #. (itstool) path: formalpara/title
3829 #: C/fdl-appendix.xml:409
3830 msgid "M"
3831 msgstr "M"
3832
3833 #. (itstool) path: para/quote
3834 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
3835 msgid "Endorsements"
3836 msgstr "Oniritziak"
3837
3838 #. (itstool) path: formalpara/para
3839 #: C/fdl-appendix.xml:410
3840 msgid ""
3841 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
3842 "in the <_:link-2/>."
3843 msgstr ""
3844
3845 #. (itstool) path: formalpara/title
3846 #: C/fdl-appendix.xml:421
3847 msgid "N"
3848 msgstr "N"
3849
3850 #. (itstool) path: para/link
3851 #: C/fdl-appendix.xml:425
3852 msgid "Invariant Section"
3853 msgstr "Atal aldaezina"
3854
3855 #. (itstool) path: formalpara/para
3856 #: C/fdl-appendix.xml:422
3857 msgid ""
3858 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
3859 "with any <_:link-2/>."
3860 msgstr ""
3861
3862 #. (itstool) path: sect1/para
3863 #: C/fdl-appendix.xml:432
3864 msgid ""
3865 "If the <_:link-1/> includes new front-matter sections or appendices that "
3866 "qualify as <_:link-2/> and contain no material copied from the Document, you "
3867 "may at your option designate some or all of these sections as invariant. To "
3868 "do this, add their titles to the list of <_:link-3/> in the Modified "
3869 "Version's license notice. These titles must be distinct from any other "
3870 "section titles."
3871 msgstr ""
3872
3873 #. (itstool) path: sect1/para
3874 #: C/fdl-appendix.xml:444
3875 msgid ""
3876 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
3877 "but endorsements of your <_:link-2/> by various parties--for example, "
3878 "statements of peer review or that the text has been approved by an "
3879 "organization as the authoritative definition of a standard."
3880 msgstr ""
3881
3882 #. (itstool) path: para/link
3883 #: C/fdl-appendix.xml:455
3884 msgid "Front-Cover Text"
3885 msgstr "Azaleko testua"
3886
3887 #. (itstool) path: para/link
3888 #: C/fdl-appendix.xml:457
3889 msgid "Back-Cover Text"
3890 msgstr "Kontrazaleko testua"
3891
3892 #. (itstool) path: sect1/para
3893 #: C/fdl-appendix.xml:453
3894 msgid ""
3895 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
3896 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
3897 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
3898 "Text may be added by (or through arrangements made by) any one entity. If "
3899 "the <_:link-5/> already includes a cover text for the same cover, previously "
3900 "added by you or by arrangement made by the same entity you are acting on "
3901 "behalf of, you may not add another; but you may replace the old one, on "
3902 "explicit permission from the previous publisher that added the old one."
3903 msgstr ""
3904
3905 #. (itstool) path: sect1/para
3906 #: C/fdl-appendix.xml:470
3907 msgid ""
3908 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
3909 "give permission to use their names for publicity for or to assert or imply "
3910 "endorsement of any <_:link-2/>."
3911 msgstr ""
3912
3913 #. (itstool) path: sect1/title
3914 #: C/fdl-appendix.xml:480
3915 msgid "5. COMBINING DOCUMENTS"
3916 msgstr "5. DOKUMENTUAK KONBINATZEA"
3917
3918 #. (itstool) path: para/link
3919 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
3920 msgid "section 4"
3921 msgstr "4. atala"
3922
3923 #. (itstool) path: sect1/para
3924 #: C/fdl-appendix.xml:481
3925 msgid ""
3926 "You may combine the <_:link-1/> with other documents released under this "
3927 "License, under the terms defined in <_:link-2/> above for modified versions, "
3928 "provided that you include in the combination all of the <_:link-3/> of all "
3929 "of the original documents, unmodified, and list them all as Invariant "
3930 "Sections of your combined work in its license notice."
3931 msgstr ""
3932
3933 #. (itstool) path: sect1/para
3934 #: C/fdl-appendix.xml:492
3935 msgid ""
3936 "The combined work need only contain one copy of this License, and multiple "
3937 "identical <_:link-1/> may be replaced with a single copy. If there are "
3938 "multiple Invariant Sections with the same name but different contents, make "
3939 "the title of each such section unique by adding at the end of it, in "
3940 "parentheses, the name of the original author or publisher of that section if "
3941 "known, or else a unique number. Make the same adjustment to the section "
3942 "titles in the list of Invariant Sections in the license notice of the "
3943 "combined work."
3944 msgstr ""
3945
3946 #. (itstool) path: para/quote
3947 #: C/fdl-appendix.xml:511
3948 msgid "Endorsements."
3949 msgstr "Oniritziak."
3950
3951 #. (itstool) path: sect1/para
3952 #: C/fdl-appendix.xml:505
3953 msgid ""
3954 "In the combination, you must combine any sections entitled <_:quote-1/> in "
3955 "the various original documents, forming one section entitled <_:quote-2/>; "
3956 "likewise combine any sections entitled <_:quote-3/>, and any sections "
3957 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
3958 msgstr ""
3959
3960 #. (itstool) path: sect1/title
3961 #: C/fdl-appendix.xml:516
3962 msgid "6. COLLECTIONS OF DOCUMENTS"
3963 msgstr "6. DOKUMENTU-BILDUMAK"
3964
3965 #. (itstool) path: sect1/para
3966 #: C/fdl-appendix.xml:517
3967 msgid ""
3968 "You may make a collection consisting of the <_:link-1/> and other documents "
3969 "released under this License, and replace the individual copies of this "
3970 "License in the various documents with a single copy that is included in the "
3971 "collection, provided that you follow the rules of this License for verbatim "
3972 "copying of each of the documents in all other respects."
3973 msgstr ""
3974
3975 #. (itstool) path: sect1/para
3976 #: C/fdl-appendix.xml:527
3977 msgid ""
3978 "You may extract a single document from such a collection, and distribute it "
3979 "individually under this License, provided you insert a copy of this License "
3980 "into the extracted document, and follow this License in all other respects "
3981 "regarding verbatim copying of that document."
3982 msgstr "Bilduma horretatik dokumentu bat atera eta banaka banatu dezakezu Lizentzia honen pean, baldin eta ateratako dokumentuari Lizentziaren kopia bat jartzen badiozu, eta kopia literalei dagokienez Lizentziaren beste alderdi guztiak betetzen badituzu."
3983
3984 #. (itstool) path: sect1/title
3985 #: C/fdl-appendix.xml:537
3986 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
3987 msgstr "7. LAN INDEPENDENTEAK GAINERATZEA"
3988
3989 #. (itstool) path: para/quote
3990 #: C/fdl-appendix.xml:546
3991 msgid "aggregate"
3992 msgstr ""
3993
3994 #. (itstool) path: para/link
3995 #: C/fdl-appendix.xml:550
3996 msgid "Cover Text"
3997 msgstr "Azaleko testua"
3998
3999 #. (itstool) path: sect1/para
4000 #: C/fdl-appendix.xml:538
4001 msgid ""
4002 "A compilation of the <_:link-1/> or its derivatives with other separate and "
4003 "independent documents or works, in or on a volume of a storage or "
4004 "distribution medium, does not as a whole count as a <_:link-2/> of the "
4005 "Document, provided no compilation copyright is claimed for the compilation. "
4006 "Such a compilation is called an <_:quote-3/>, and this License does not "
4007 "apply to the other self-contained works thus compiled with the Document , on "
4008 "account of their being thus compiled, if they are not themselves derivative "
4009 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
4010 "applicable to these copies of the Document, then if the Document is less "
4011 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
4012 "placed on covers that surround only the Document within the aggregate. "
4013 "Otherwise they must appear on covers around the whole aggregate."
4014 msgstr ""
4015
4016 #. (itstool) path: sect1/title
4017 #: C/fdl-appendix.xml:561
4018 msgid "8. TRANSLATION"
4019 msgstr "8. ITZULPENA"
4020
4021 #. (itstool) path: sect1/para
4022 #: C/fdl-appendix.xml:562
4023 msgid ""
4024 "Translation is considered a kind of modification, so you may distribute "
4025 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing "
4026 "<_:link-3/> with translations requires special permission from their "
4027 "copyright holders, but you may include translations of some or all Invariant "
4028 "Sections in addition to the original versions of these Invariant Sections. "
4029 "You may include a translation of this License provided that you also include "
4030 "the original English version of this License. In case of a disagreement "
4031 "between the translation and the original English version of this License, "
4032 "the original English version will prevail."
4033 msgstr ""
4034
4035 #. (itstool) path: sect1/title
4036 #: C/fdl-appendix.xml:580
4037 msgid "9. TERMINATION"
4038 msgstr "9. AMAIERA"
4039
4040 #. (itstool) path: sect1/para
4041 #: C/fdl-appendix.xml:581
4042 msgid ""
4043 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
4044 "as expressly provided for under this License. Any other attempt to copy, "
4045 "modify, sublicense or distribute the Document is void, and will "
4046 "automatically terminate your rights under this License. However, parties who "
4047 "have received copies, or rights, from you under this License will not have "
4048 "their licenses terminated so long as such parties remain in full compliance."
4049 msgstr ""
4050
4051 #. (itstool) path: sect1/title
4052 #: C/fdl-appendix.xml:594
4053 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
4054 msgstr "10. LIZENTZIA HONEN ETORKIZUNEKO BERRIKUSPENAK"
4055
4056 #. (itstool) path: para/ulink
4057 #: C/fdl-appendix.xml:597
4058 msgid "Free Software Foundation"
4059 msgstr "Free Software Foundation"
4060
4061 #. (itstool) path: para/ulink
4062 #: C/fdl-appendix.xml:603
4063 msgid "http://www.gnu.org/copyleft/"
4064 msgstr "http://www.gnu.org/copyleft/"
4065
4066 #. (itstool) path: sect1/para
4067 #: C/fdl-appendix.xml:595
4068 msgid ""
4069 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
4070 "Documentation License from time to time. Such new versions will be similar "
4071 "in spirit to the present version, but may differ in detail to address new "
4072 "problems or concerns. See <_:ulink-2/>."
4073 msgstr ""
4074
4075 #. (itstool) path: para/quote
4076 #: C/fdl-appendix.xml:610
4077 msgid "or any later version"
4078 msgstr "edo bertsio berriagoak"
4079
4080 #. (itstool) path: sect1/para
4081 #: C/fdl-appendix.xml:606
4082 msgid ""
4083 "Each version of the License is given a distinguishing version number. If the "
4084 "<_:link-1/> specifies that a particular numbered version of this License "
4085 "<_:quote-2/> applies to it, you have the option of following the terms and "
4086 "conditions either of that specified version or of any later version that has "
4087 "been published (not as a draft) by the Free Software Foundation. If the "
4088 "Document does not specify a version number of this License, you may choose "
4089 "any version ever published (not as a draft) by the Free Software Foundation."
4090 msgstr ""
4091
4092 #. (itstool) path: sect1/title
4093 #: C/fdl-appendix.xml:621
4094 msgid "Addendum"
4095 msgstr "Eranskina"
4096
4097 #. (itstool) path: sect1/para
4098 #: C/fdl-appendix.xml:622
4099 msgid ""
4100 "To use this License in a document you have written, include a copy of the "
4101 "License in the document and put the following copyright and license notices "
4102 "just after the title page:"
4103 msgstr "Zuk idatzitako dokumentu batean Lizentzia hau erabiltzeko, jar ezazu Lizentziaren kopia bat dokumentuan, eta titulu-orriaren jarraian, berriz, copyrighta eta lizentzia-ohar hauek:"
4104
4105 #. (itstool) path: blockquote/para
4106 #: C/fdl-appendix.xml:629
4107 msgid "Copyright YEAR YOUR NAME."
4108 msgstr "Copyright URTEA ZURE IZENA."
4109
4110 #. (itstool) path: para/link
4111 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
4112 msgid "Front-Cover Texts"
4113 msgstr "Azaleko testuak"
4114
4115 #. (itstool) path: para/link
4116 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
4117 msgid "Back-Cover Texts"
4118 msgstr "Kontrazaleko testuak"
4119
4120 #. (itstool) path: blockquote/para
4121 #: C/fdl-appendix.xml:632
4122 msgid ""
4123 "Permission is granted to copy, distribute and/or modify this document under "
4124 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
4125 "version published by the Free Software Foundation; with the <_:link-1/> "
4126 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the "
4127 "<_:link-3/> being LIST. A copy of the license is included in the section "
4128 "entitled <_:quote-4/>."
4129 msgstr ""
4130
4131 #. (itstool) path: para/quote
4132 #: C/fdl-appendix.xml:649
4133 msgid "with no Invariant Sections"
4134 msgstr "atal aldaezinik gabe"
4135
4136 #. (itstool) path: para/quote
4137 #: C/fdl-appendix.xml:652
4138 msgid "no Front-Cover Texts"
4139 msgstr "azaleko testurik ez"
4140
4141 #. (itstool) path: para/quote
4142 #: C/fdl-appendix.xml:653
4143 msgid "Front-Cover Texts being LIST"
4144 msgstr ""
4145
4146 #. (itstool) path: sect1/para
4147 #: C/fdl-appendix.xml:647
4148 msgid ""
4149 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
4150 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of "
4151 "<_:quote-5/>; likewise for <_:link-6/>."
4152 msgstr ""
4153
4154 #. (itstool) path: para/ulink
4155 #: C/fdl-appendix.xml:661
4156 msgid "GNU General Public License"
4157 msgstr "GNU Lizentzia Publiko Orokorra"
4158
4159 #. (itstool) path: sect1/para
4160 #: C/fdl-appendix.xml:657
4161 msgid ""
4162 "If your document contains nontrivial examples of program code, we recommend "
4163 "releasing these examples in parallel under your choice of free software "
4164 "license, such as the <_:ulink-1/>, to permit their use in free software."
4165 msgstr ""
4166
4167 #~ msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4168 #~ msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4169
4170 #, no-wrap
4171 #~ msgid ""
4172 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
4173 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
4174 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
4175 #~ msgstr ""
4176 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
4177 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
4178 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
4179
4180 #~ msgid ""
4181 #~ "The purpose of this License is to make a manual, textbook, or other "
4182 #~ "written document <quote>free</quote> in the sense of freedom: to assure "
4183 #~ "everyone the effective freedom to copy and redistribute it, with or "
4184 #~ "without modifying it, either commercially or noncommercially. "
4185 #~ "Secondarily, this License preserves for the author and publisher a way to "
4186 #~ "get credit for their work, while not being considered responsible for "
4187 #~ "modifications made by others."
4188 #~ msgstr ""
4189 #~ "Lizentzia honen xedea da eskuliburu bat, testuliburu bat edo bestelako "
4190 #~ "edozein dokumentu idatzi <quote>libre</quote> egitea askatasunaren "
4191 #~ "zentzuan: edonori ziurtatzea kopiatzeko eta birbanatzeko benetako "
4192 #~ "askatasuna, aldatuta zein aldatu gabe, eta komertzialki zein ez-"
4193 #~ "komertzialki. Bestalde, Lizentziaren bidez autoreei eta argitaratzaileei "
4194 #~ "euren lana aitortzen zaie, eta ez dira beste batzuk egindako aldaketen "
4195 #~ "erantzule."
4196
4197 #~ msgid ""
4198 #~ "This License is a kind of <quote>copyleft</quote>, which means that "
4199 #~ "derivative works of the document must themselves be free in the same "
4200 #~ "sense. It complements the GNU General Public License, which is a copyleft "
4201 #~ "license designed for free software."
4202 #~ msgstr ""
4203 #~ "Lizentzia hau <quote>copyleft</quote> modukoa da, hau da, dokumentu "
4204 #~ "honetatik eratorritako lan guztiek ere libreak izan behar dute zentzu "
4205 #~ "berean. GNU Lizentzia Publiko Orokorra (software librearentzat "
4206 #~ "diseinatutako \"copyleft\" lizentzia) osatzen du."
4207
4208 #~ msgid ""
4209 #~ "This License applies to any manual or other work that contains a notice "
4210 #~ "placed by the copyright holder saying it can be distributed under the "
4211 #~ "terms of this License. The <quote>Document</quote>, below, refers to any "
4212 #~ "such manual or work. Any member of the public is a licensee, and is "
4213 #~ "addressed as <quote>you</quote>."
4214 #~ msgstr ""
4215 #~ "Eskuliburu edo bestelako lan bati Lizentzia honen baldintzen pean bana "
4216 #~ "daitekeela adierazten duen oharra jarri baldin badio egile-eskubideen "
4217 #~ "jabeak, eskuliburu edo lan horri lizentzia hau aplikatuko zaio. Hemendik "
4218 #~ "aurrera Dokumentua aipatzen denean, horrelako eskuliburu edo lanei egiten "
4219 #~ "die erreferentzia. Publikoko edonor da lizentziaren hartzaile, eta "
4220 #~ "<quote>zu</quote> bidez adierazten da."
4221
4222 #~ msgid ""
4223 #~ "A <quote>Modified Version</quote> of the Document means any work "
4224 #~ "containing the Document or a portion of it, either copied verbatim, or "
4225 #~ "with modifications and/or translated into another language."
4226 #~ msgstr ""
4227 #~ "Dokumentuaren <quote>Bertsio aldatua</quote> esaten denean, Dokumentu hau "
4228 #~ "osorik edo zati batean biltzen duen edozein lan adierazten da, hau da, "
4229 #~ "kopia literala, aldaketak dituena edo beste hizkuntza batera itzulitakoa."
4230
4231 #~ msgid ""
4232 #~ "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
4233 #~ "section of the <link linkend=\"fdl-document\">Document</link> that deals "
4234 #~ "exclusively with the relationship of the publishers or authors of the "
4235 #~ "Document to the Document's overall subject (or to related matters) and "
4236 #~ "contains nothing that could fall directly within that overall subject. "
4237 #~ "(For example, if the Document is in part a textbook of mathematics, a "
4238 #~ "Secondary Section may not explain any mathematics.) The relationship "
4239 #~ "could be a matter of historical connection with the subject or with "
4240 #~ "related matters, or of legal, commercial, philosophical, ethical or "
4241 #~ "political position regarding them."
4242 #~ msgstr ""
4243 #~ "<quote>Atal sekundarioa</quote> <link linkend=\"fdl-document\">Dokumentu</"
4244 #~ "link>aren eranskin izenduna edo gai nagusiaren aurreko hasierako atala "
4245 #~ "da, eta Dokumentuaren argitaratzaileek edo autoreek Dokumentuaren gai "
4246 #~ "nagusiarekiko (edo gai horrekin zerikusia duten gaiekiko) duten "
4247 #~ "erlazioari buruzkoa da soil-soilik. Atal sekundarioan ez da agertzen "
4248 #~ "zuzenean gai nagusiari dagokion ezer. (Adibidez, Dokumentua matematikako "
4249 #~ "eskuliburu bat bada, Atal sekundarioak ez du matematikarik azalduko.) Gai "
4250 #~ "nagusiarekin edo harekin zerikusia duten gaiekin duen harremana, konexio "
4251 #~ "historikoa izan liteke, edo haien ikuspegi legal, komertzial, filosofiko, "
4252 #~ "etiko edo politikoa."
4253
4254 #~ msgid ""
4255 #~ "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
4256 #~ "secondary\"> Secondary Sections</link> whose titles are designated, as "
4257 #~ "being those of Invariant Sections, in the notice that says that the <link "
4258 #~ "linkend=\"fdl-document\">Document</link> is released under this License."
4259 #~ msgstr ""
4260 #~ "<quote>Atal aldaezinak</quote> <link linkend=\"fdl-secondary\">Atal "
4261 #~ "sekundario</link> jakin batzuk dira; <link linkend=\"fdl-"
4262 #~ "document\">Dokumentua</link> Lizentzia honen baldintzen pean argitaratzen "
4263 #~ "dela esaten duen oharrean zehazten dira Atal aldaezinen izenburuak."
4264
4265 #~ msgid ""
4266 #~ "The <quote>Cover Texts</quote> are certain short passages of text that "
4267 #~ "are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that "
4268 #~ "says that the <link linkend=\"fdl-document\">Document</link> is released "
4269 #~ "under this License."
4270 #~ msgstr ""
4271 #~ "<quote>Azaleko testuak</quote> testu zati laburrak dira eta Aurreko "
4272 #~ "azaleko testu edo Atzeko azaleko testu gisa aipatzen dira <link "
4273 #~ "linkend=\"fdl-document\">Dokumentua</link> Lizentzia honen pean "
4274 #~ "argitaratzen dela dioen oharrean."
4275
4276 #~ msgid ""
4277 #~ "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
4278 #~ "Document</link> means a machine-readable copy, represented in a format "
4279 #~ "whose specification is available to the general public, whose contents "
4280 #~ "can be viewed and edited directly and straightforwardly with generic text "
4281 #~ "editors or (for images composed of pixels) generic paint programs or (for "
4282 #~ "drawings) some widely available drawing editor, and that is suitable for "
4283 #~ "input to text formatters or for automatic translation to a variety of "
4284 #~ "formats suitable for input to text formatters. A copy made in an "
4285 #~ "otherwise Transparent file format whose markup has been designed to "
4286 #~ "thwart or discourage subsequent modification by readers is not "
4287 #~ "Transparent. A copy that is not <quote>Transparent</quote> is called "
4288 #~ "<quote>Opaque</quote>."
4289 #~ msgstr ""
4290 #~ "<link linkend=\"fdl-doument\">Dokumentu</link>aren kopia <quote>gardena</"
4291 #~ "quote> makina bidez irakurtzeko moduko kopia da eta, gainera, publiko "
4292 #~ "orokorrak erabiltzeko moduko formatuduna, zuzenean testu-editore "
4293 #~ "arruntekin ikusi eta edita daitekeena, edo, pixeletan osatutako irudia "
4294 #~ "bada, pintatzeko editore orokorrekin editatzeko modukoa edo, marrazkia "
4295 #~ "bada, marrazki-editore oso erabilgarriekin editatzeko modukoa; horrez "
4296 #~ "gain, testu-formateatzaileetan sargai edo input gisa erabil daitekeena, "
4297 #~ "edo testu-formateatzaileek sargai gisa onartzen duten formatuetako batera "
4298 #~ "automatikoki itzul daitekeena. Beste era bateko fitxategi-formatu "
4299 #~ "Gardenean egindako kopia, irakurleek aldaketak egiteko eragozpenak eta "
4300 #~ "trabak jartzeko diseinatutako marka-sistema duena, ez da Gardena. "
4301 #~ "<quote>Gardena</quote> ez den kopiari <quote>opako</quote> deitzen zaio."
4302
4303 #~ msgid ""
4304 #~ "The <quote>Title Page</quote> means, for a printed book, the title page "
4305 #~ "itself, plus such following pages as are needed to hold, legibly, the "
4306 #~ "material this License requires to appear in the title page. For works in "
4307 #~ "formats which do not have any title page as such, <quote>Title Page</"
4308 #~ "quote> means the text near the most prominent appearance of the work's "
4309 #~ "title, preceding the beginning of the body of the text."
4310 #~ msgstr ""
4311 #~ "<quote>Titulu-orriak</quote> esan nahi duena zera da: inprimatutako "
4312 #~ "liburu bati dagokionez, titulu-orria bera eta Lizentzia honek titulu-"
4313 #~ "orrian agertzera behartzen duen materiala modu irakurgarrian biltzeko "
4314 #~ "behar diren orriak. Berez titulu-orririk ez duten formatuetan egindako "
4315 #~ "lanetan, <quote>Titulu-orriak</quote> esan nahi duena da, testuaren "
4316 #~ "gorputza hasi aurretik, gehien nabarmenduta agertzen den lanaren "
4317 #~ "tituluaren ondoan agertzen den testua."
4318
4319 #~ msgid ""
4320 #~ "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
4321 #~ "link> in any medium, either commercially or noncommercially, provided "
4322 #~ "that this License, the copyright notices, and the license notice saying "
4323 #~ "this License applies to the Document are reproduced in all copies, and "
4324 #~ "that you add no other conditions whatsoever to those of this License. You "
4325 #~ "may not use technical measures to obstruct or control the reading or "
4326 #~ "further copying of the copies you make or distribute. However, you may "
4327 #~ "accept compensation in exchange for copies. If you distribute a large "
4328 #~ "enough number of copies you must also follow the conditions in <link "
4329 #~ "linkend=\"fdl-section3\">section 3</link>."
4330 #~ msgstr ""
4331 #~ "<link linkend=\"fdl-document\">Dokumentua</link> edozein euskarritan "
4332 #~ "kopiatu eta banatu dezakezu, komertzialki zein ez-komertzialki, baldin "
4333 #~ "eta Lizentzia hau, copyright-oharrak eta Dokumentuari lizentzia hau "
4334 #~ "aplikatzen zaiola adierazten duen lizentzia-oharra jartzen bazaie kopia "
4335 #~ "guztiei, eta Lizentzia honi beste inolako baldintzarik gehitzen ez "
4336 #~ "badiozu. Egiten edo banatzen dituzun kopietan ezin da erabili irakurketa "
4337 #~ "edo kopiak egitea eragozten edo kontrolatzen duen inolako baliabide "
4338 #~ "teknikorik. Nolanahi ere, kopiak egitearen truke ordaina jasotzea "
4339 #~ "onartzen da. Kopia asko banatzen baduzu (hurrengo atalean zehazten da "
4340 #~ "kopurua), <link linkend=\"fdl-section3\">3. ataleko</link> baldintzak ere "
4341 #~ "bete behar dituzu."
4342
4343 #~ msgid ""
4344 #~ "If you publish printed copies of the <link linkend=\"fdl-"
4345 #~ "document\">Document</link> numbering more than 100, and the Document's "
4346 #~ "license notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</"
4347 #~ "link>, you must enclose the copies in covers that carry, clearly and "
4348 #~ "legibly, all these Cover Texts: Front-Cover Texts on the front cover, and "
4349 #~ "Back-Cover Texts on the back cover. Both covers must also clearly and "
4350 #~ "legibly identify you as the publisher of these copies. The front cover "
4351 #~ "must present the full title with all words of the title equally prominent "
4352 #~ "and visible. You may add other material on the covers in addition. "
4353 #~ "Copying with changes limited to the covers, as long as they preserve the "
4354 #~ "title of the <link linkend=\"fdl-document\">Document</link> and satisfy "
4355 #~ "these conditions, can be treated as verbatim copying in other respects."
4356 #~ msgstr ""
4357 #~ "<link linkend=\"fdl-document\">Dokumentu</link>aren 100 kopia baino "
4358 #~ "gehiago argitaratzen badituzu, eta Dokumentuaren lizentzia-oharrak <link "
4359 #~ "linkend=\"fdl-cover-texts\">Azaleko testuak</link> behar baditu, kopiei "
4360 #~ "nahitaez jarri behar dizkiezu argi eta garbi irakurtzen diren Azaleko "
4361 #~ "testu hauek: aurreko azaleko testuak aurreko azalean, eta Atzeko azaleko "
4362 #~ "testuak atzeko azalean. Bi azalek modu argi eta irakurgarrian "
4363 #~ "identifikatu behar zaituzte kopia horien argitaratzaile gisa. Aurreko "
4364 #~ "azalak titulu osoa izan behar du, eta tituluaren hitz guztiak maila "
4365 #~ "berdinean izan behar dute nabarmenak eta ikusteko modukoak. Horrez "
4366 #~ "gainera, beste material batzuk ere gehi ditzakezu azaletan. Azaletara "
4367 #~ "mugatutako aldaketekin egindako kopiak, <link linkend=\"fdl-"
4368 #~ "document\">Dokumentu</link>aren titulua mantentzen bada eta baldintza "
4369 #~ "horiek betez egiten badira, kopia literaltzat jo daiteke beste alderdi "
4370 #~ "batzuei dagokienez."
4371
4372 #~ msgid ""
4373 #~ "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</"
4374 #~ "link> copies of the <link linkend=\"fdl-document\">Document</link> "
4375 #~ "numbering more than 100, you must either include a machine-readable <link "
4376 #~ "linkend=\"fdl-transparent\">Transparent</link> copy along with each "
4377 #~ "Opaque copy, or state in or with each Opaque copy a publicly-accessible "
4378 #~ "computer-network location containing a complete Transparent copy of the "
4379 #~ "Document, free of added material, which the general network-using public "
4380 #~ "has access to download anonymously at no charge using public-standard "
4381 #~ "network protocols. If you use the latter option, you must take reasonably "
4382 #~ "prudent steps, when you begin distribution of Opaque copies in quantity, "
4383 #~ "to ensure that this Transparent copy will remain thus accessible at the "
4384 #~ "stated location until at least one year after the last time you "
4385 #~ "distribute an Opaque copy (directly or through your agents or retailers) "
4386 #~ "of that edition to the public."
4387 #~ msgstr ""
4388 #~ "<link linkend=\"fdl-document\">Dokumentu</link>aren 100 kopia <link "
4389 #~ "linkend=\"fdl-transparent\">Opako</link> argitaratzen edo banatzen "
4390 #~ "badituzu, kopia Opako bakoitzarekin batera makinaz irakurtzeko moduko "
4391 #~ "kopia <link linkend=\"fdl-transparent\">Garden</link> bat eman behar "
4392 #~ "duzu, edo bestela, kopia Opako bakoitzean edo bakoitzarekin batera "
4393 #~ "ordenagailu-sare bateko helbide bat adierazi beharko duzu, edonork "
4394 #~ "libreki atzi dezakeena eta Dokumentuaren kopia Garden osoa daukana, "
4395 #~ "gehitutako materialik gabe, sare-erabiltzaile arruntak anonimoki "
4396 #~ "deskargatu ahal izateko doan eta sare-protokolo estandar publikoen bidez. "
4397 #~ "Azken aukeraren bidetik jotzen baduzu, zentzuz eta zuhur jokatu behar "
4398 #~ "duzu kopia Opako asko banatzen hasten zarenean, kopia Garden hori "
4399 #~ "adierazitako kokalekuan urtebetean gutxienez erabilgarri eta atzigarri "
4400 #~ "egongo dela segurtatzeko zuk edizio horren azken kopia Opakoa (zuzenean "
4401 #~ "edo zure agente edo xehekarien bidez) publikoari banatzen diozunetik "
4402 #~ "kontatzen hasita."
4403
4404 #~ msgid ""
4405 #~ "It is requested, but not required, that you contact the authors of the "
4406 #~ "<link linkend=\"fdl-document\">Document</link> well before redistributing "
4407 #~ "any large number of copies, to give them a chance to provide you with an "
4408 #~ "updated version of the Document."
4409 #~ msgstr ""
4410 #~ "Bestalde, <link linkend=\"fdl-document\">Dokumentu</link>aren kopiak "
4411 #~ "kantitate handian birbanatzen hasi aurretik, autoreekin harremanetan jar "
4412 #~ "zaitezen eskatzen zaizu, behartu gabe, Dokumentuaren bertsio eguneratua "
4413 #~ "eman ahal izan diezazuten."
4414
4415 #~ msgid ""
4416 #~ "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
4417 #~ "Version</link> of the <link linkend=\"fdl-document\">Document</link> "
4418 #~ "under the conditions of sections <link linkend=\"fdl-section2\">2</link> "
4419 #~ "and <link linkend=\"fdl-section3\">3</link> above, provided that you "
4420 #~ "release the Modified Version under precisely this License, with the "
4421 #~ "Modified Version filling the role of the Document, thus licensing "
4422 #~ "distribution and modification of the Modified Version to whoever "
4423 #~ "possesses a copy of it. In addition, you must do these things in the "
4424 #~ "Modified Version:"
4425 #~ msgstr ""
4426 #~ "<link linkend=\"fdl-document\">Dokumentu</link>aren <link linkend=\"fdl-"
4427 #~ "modified\">Bertsio aldatua</link> kopiatu eta banatu dezakezu baldin eta "
4428 #~ "hemen goiko <link linkend=\"fdl-section2\">2</link> eta <link "
4429 #~ "linkend=\"fdl-section3\">3</link> ataletako baldintzak betetzen badituzu, "
4430 #~ "kontuan izanik betiere Bertsio aldatua Lizentzia honen pean banatu behar "
4431 #~ "duzula, Bertsio aldatua izanik Dokumentuaren funtzioa beteko duena, eta, "
4432 #~ "beraz, Bertsio aldatua banatzeko edo aldatzeko baimena eman behar diozula "
4433 #~ "kopia bat duen edonori. Horrez gainera, honako hauek egin behar dituzu "
4434 #~ "Bertsio Aldatuan:"
4435
4436 #~ msgid ""
4437 #~ "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
4438 #~ "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
4439 #~ "document\">Document</link>, and from those of previous versions (which "
4440 #~ "should, if there were any, be listed in the History section of the "
4441 #~ "Document). You may use the same title as a previous version if the "
4442 #~ "original publisher of that version gives permission."
4443 #~ msgstr ""
4444 #~ "<link linkend=\"fdl-title-page\">Titulu-orri</link>an (eta azaletan, "
4445 #~ "azalik badu) <link linkend=\"fdl-document\">Dokumentu</link>arena eta "
4446 #~ "aurreko bertsioena ez den beste edozein titulu bat erabili behar duzu "
4447 #~ "(aurreko bertsiorik badago, Dokumentuaren Historiaren atalean "
4448 #~ "zerrendatuta egongo da). Aurreko bertsio horietako baten titulu bera "
4449 #~ "erabil dezakezu, baldin eta jatorrizko argitaratzaileak horretarako "
4450 #~ "baimena ematen badu."
4451
4452 #~ msgid ""
4453 #~ "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as "
4454 #~ "authors, one or more persons or entities responsible for authorship of "
4455 #~ "the modifications in the <link linkend=\"fdl-modified\">Modified Version</"
4456 #~ "link>, together with at least five of the principal authors of the <link "
4457 #~ "linkend=\"fdl-document\">Document</link> (all of its principal authors, "
4458 #~ "if it has less than five)."
4459 #~ msgstr ""
4460 #~ "<link linkend=\"fdl-title-page\">Titulu-orri</link>an, autore gisa, <link "
4461 #~ "linkend=\"fdl-modified\">Bertsio aldatu</link>an aldaketak egin dituen "
4462 #~ "pertsona edo erakunde baten edo gehiagoren izena jarri behar duzu, eta, "
4463 #~ "horrekin batera, <link linkend=\"fdl-document\">Dokumentu</link>aren bost "
4464 #~ "egile nagusien izena gutxienez (eta bost baino gutxiago badira, guztiena)."
4465
4466 #~ msgid ""
4467 #~ "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name "
4468 #~ "of the publisher of the <link linkend=\"fdl-modified\">Modified Version</"
4469 #~ "link>, as the publisher."
4470 #~ msgstr ""
4471 #~ "<link linkend=\"fdl-title-page\">Titulu-orri</link>an <link "
4472 #~ "linkend=\"fdl-modified\">Bertsio aldatu</link>aren argitaratzailearen "
4473 #~ "izena jarri behar duzu, argitaratzaile gisa."
4474
4475 #~ msgid ""
4476 #~ "Preserve all the copyright notices of the <link linkend=\"fdl-"
4477 #~ "document\">Document</link>."
4478 #~ msgstr ""
4479 #~ "<link linkend=\"fdl-document\">Dokumentu</link>aren copyright-ohar "
4480 #~ "guztiak gorde behar dituzu."
4481
4482 #~ msgid ""
4483 #~ "Include, immediately after the copyright notices, a license notice giving "
4484 #~ "the public permission to use the <link linkend=\"fdl-modified\">Modified "
4485 #~ "Version</link> under the terms of this License, in the form shown in the "
4486 #~ "Addendum below."
4487 #~ msgstr ""
4488 #~ "Copyright-oharren jarraian, lizentzia-ohar bat ipini behar duzu, jendeari "
4489 #~ "baimena emateko <link linkend=\"fdl-modified\">Bertsio aldatua</link> "
4490 #~ "erabil dezan Lizentzia horren baldintzen pean, beheko Eranskinean "
4491 #~ "azaltzen den bezala."
4492
4493 #~ msgid ""
4494 #~ "Preserve in that license notice the full lists of <link linkend=\"fdl-"
4495 #~ "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
4496 #~ "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-"
4497 #~ "document\">Document's</link> license notice."
4498 #~ msgstr ""
4499 #~ "Lizentzia-ohar horretan <link linkend=\"fdl-document\">Dokumentu</"
4500 #~ "link>aren lizentzia-oharrean adierazitako <link linkend=\"fdl-"
4501 #~ "invariant\">Atal aldaezin</link> eta jarri beharreko <link linkend=\"fdl-"
4502 #~ "cover-texts\">Azaleko testu</link> guztien zerrenda gorde behar duzu."
4503
4504 #~ msgid ""
4505 #~ "Preserve the section entitled <quote>History</quote>, and its title, and "
4506 #~ "add to it an item stating at least the title, year, new authors, and "
4507 #~ "publisher of the <link linkend=\"fdl-modified\">Modified Version</link> "
4508 #~ "as given on the <link linkend=\"fdl-title-page\">Title Page</link>. If "
4509 #~ "there is no section entitled <quote>History</quote> in the <link "
4510 #~ "linkend=\"fdl-document\">Document</link>, create one stating the title, "
4511 #~ "year, authors, and publisher of the Document as given on its Title Page, "
4512 #~ "then add an item describing the Modified Version as stated in the "
4513 #~ "previous sentence."
4514 #~ msgstr ""
4515 #~ "<quote>Historia</quote> izeneko atala gorde behar duzu, baita bere "
4516 #~ "titulua ere, eta gutxienez <link linkend=\"fdl-modified\">Bertsio "
4517 #~ "aldatuaren</link> izenburua, urtea, autore berriak eta argitaratzailea "
4518 #~ "aipatuko dituen elementu bat gehitu behar diozu, <link linkend=\"fdl-"
4519 #~ "title-page\">Titulu-orri</link>an agertzen den bezala. <quote>Historia</"
4520 #~ "quote> izeneko atalik ez badago <link linkend=\"fdl-document\">Dokumentu</"
4521 #~ "link>an, zeuk sortu beharko duzu, Dokumentuaren titulua, urtea, autoreak "
4522 #~ "eta argitaratzailea adierazteko Dokumentuaren Titulu-orrian agertzen den "
4523 #~ "bezala, eta, gainera, Bertsio aldatua deskribatzeko beste elementu bat "
4524 #~ "gehitu beharko duzu aurreko esaldian azaldutako moduan."
4525
4526 #~ msgid ""
4527 #~ "Preserve the network location, if any, given in the <link linkend=\"fdl-"
4528 #~ "document\">Document</link> for public access to a <link linkend=\"fdl-"
4529 #~ "transparent\">Transparent</link> copy of the Document, and likewise the "
4530 #~ "network locations given in the Document for previous versions it was "
4531 #~ "based on. These may be placed in the <quote>History</quote> section. You "
4532 #~ "may omit a network location for a work that was published at least four "
4533 #~ "years before the Document itself, or if the original publisher of the "
4534 #~ "version it refers to gives permission."
4535 #~ msgstr ""
4536 #~ "Dokumentuaren kopia <link linkend=\"fdl-transparent\">Gardena</link> "
4537 #~ "publikoki atzitzeko <link linkend=\"fdl-document\">Dokumentu</link>an "
4538 #~ "ematen den sare-helbidea (helbiderik ematen bada) gorde behar duzu, eta, "
4539 #~ "era berean, Dokumentuaren oinarri izan diren aurreko bertsioentzat ematen "
4540 #~ "diren sare-helbideak ere bai. Helbide horiek <quote>Historia</quote> "
4541 #~ "atalean sar daitezke. Sare-helbideak ez dira nahitaez jarri behar, "
4542 #~ "Dokumentua bera baino gutxienez lau urte lehenago argitaratutako lanari "
4543 #~ "dagozkionak baldin badira, edo horretarako baimena ematen badu "
4544 #~ "bertsioaren jatorrizko argitaratzaileak."
4545
4546 #~ msgid ""
4547 #~ "In any section entitled <quote>Acknowledgements</quote> or "
4548 #~ "<quote>Dedications</quote>, preserve the section's title, and preserve in "
4549 #~ "the section all the substance and tone of each of the contributor "
4550 #~ "acknowledgements and/or dedications given therein."
4551 #~ msgstr ""
4552 #~ "<quote>Eskertzak</quote> edo <quote>Eskaintzak</quote> izeneko edozein "
4553 #~ "ataletan, atalaren titulua gorde behar da, eta ataleko eskertza edota "
4554 #~ "eskaintza bakoitzean egileak darabilen gai eta tonua errespetatu behar "
4555 #~ "dira."
4556
4557 #~ msgid ""
4558 #~ "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</"
4559 #~ "link> of the <link linkend=\"fdl-document\">Document</link>, unaltered in "
4560 #~ "their text and in their titles. Section numbers or the equivalent are not "
4561 #~ "considered part of the section titles."
4562 #~ msgstr ""
4563 #~ "Errespetatu <link linkend=\"fdl-document\">Dokumentu</link>aren <link "
4564 #~ "linkend=\"fdl-invariant\">Atal aldaezin</link> guztiak, testuak eta "
4565 #~ "tituluak batere aldatu gabe. Atal-zenbakiak edo haien baliokideak ez dira "
4566 #~ "atalaren tituluaren zatitzat hartzen."
4567
4568 #~ msgid ""
4569 #~ "Delete any section entitled <quote>Endorsements</quote>. Such a section "
4570 #~ "may not be included in the <link linkend=\"fdl-modified\">Modified "
4571 #~ "Version</link>."
4572 #~ msgstr ""
4573 #~ "Ezabatu <quote>Oniritziak</quote> titulua duen edozein atal. Horrelako "
4574 #~ "atal bat ezin da <link linkend=\"fdl-modified\">Aldatutako bertsio</"
4575 #~ "link>aren barruan egon."
4576
4577 #~ msgid ""
4578 #~ "Do not retitle any existing section as <quote>Endorsements</quote> or to "
4579 #~ "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
4580 #~ "Section</link>."
4581 #~ msgstr ""
4582 #~ "Lehendik dagoen atal bati ez jarri <quote>oniritziak</quote> titulua ez "
4583 #~ "eta <link linkend=\"fdl-invariant\">Atal aldaezin</link>en baten "
4584 #~ "tituluarekin gatazka sor lezakeena ere."
4585
4586 #~ msgid ""
4587 #~ "If the <link linkend=\"fdl-modified\">Modified Version</link> includes "
4588 #~ "new front-matter sections or appendices that qualify as <link "
4589 #~ "linkend=\"fdl-secondary\">Secondary Sections</link> and contain no "
4590 #~ "material copied from the Document, you may at your option designate some "
4591 #~ "or all of these sections as invariant. To do this, add their titles to "
4592 #~ "the list of <link linkend=\"fdl-invariant\">Invariant Sections</link> in "
4593 #~ "the Modified Version's license notice. These titles must be distinct from "
4594 #~ "any other section titles."
4595 #~ msgstr ""
4596 #~ "<link linkend=\"fdl-modified\">Bertsio aldatuak</link> gai nagusiari "
4597 #~ "buruzko atal berriak edo eranskinak baditu, <link linkend=\"fdl-"
4598 #~ "secondary\">Atal Sekundario</link> gisa agertzen direnak, eta elementu "
4599 #~ "horiek Dokumentutik kopiatutako materialik ez badute, atal horietako "
4600 #~ "batzuk edo denak aldaezin izenda ditzakezu zuk hala nahi izanez gero. "
4601 #~ "Horretarako, gehitu atal horien tituluak <link linkend=\"fdl-"
4602 #~ "invariant\">Atal aldaezin</link>en zerrendan, Bertsio aldatuaren "
4603 #~ "lizentzia-oharrean. Titulu horiek gainerako atalen tituluen ezberdinak "
4604 #~ "izan behar dute."
4605
4606 #~ msgid ""
4607 #~ "You may add a section entitled <quote>Endorsements</quote>, provided it "
4608 #~ "contains nothing but endorsements of your <link linkend=\"fdl-"
4609 #~ "modified\">Modified Version</link> by various parties--for example, "
4610 #~ "statements of peer review or that the text has been approved by an "
4611 #~ "organization as the authoritative definition of a standard."
4612 #~ msgstr ""
4613 #~ "<quote>Oniritziak</quote> titulua duen atala gehi dezakezu, baldin eta "
4614 #~ "zure <link linkend=\"fdl-modified\">Bertsio aldatu</link>ari buruz "
4615 #~ "alderdiek emandako oniritziak soilik biltzen badira, eta ez beste ezer --"
4616 #~ "adibidez, adituek egindako ikuskatzea edo erakunde batek testua "
4617 #~ "estandartzat onartu duela, eta abar--."
4618
4619 #~ msgid ""
4620 #~ "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
4621 #~ "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a "
4622 #~ "<link linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of "
4623 #~ "the list of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the "
4624 #~ "<link linkend=\"fdl-modified\">Modified Version</link>. Only one passage "
4625 #~ "of Front-Cover Text and one of Back-Cover Text may be added by (or "
4626 #~ "through arrangements made by) any one entity. If the <link linkend=\"fdl-"
4627 #~ "document\">Document</link> already includes a cover text for the same "
4628 #~ "cover, previously added by you or by arrangement made by the same entity "
4629 #~ "you are acting on behalf of, you may not add another; but you may replace "
4630 #~ "the old one, on explicit permission from the previous publisher that "
4631 #~ "added the old one."
4632 #~ msgstr ""
4633 #~ "Gehienez bost hitz dituen pasartea gehi dezakezu <link linkend=\"fdl-"
4634 #~ "cover-texts\">Aurreko azaleko testu</link> gisa, eta gehienez 25 hitzeko "
4635 #~ "pasartea <link linkend=\"fdl-cover-texts\">Atzeko azaleko testu</link> "
4636 #~ "gisa <link linkend=\"fdl-modified\">Bertsio aldatu</link>aren <link "
4637 #~ "linkend=\"fdl-cover-texts\">Azaleko testu</link>en zerrendaren bukaeran. "
4638 #~ "Aurreko azaleko testu bakar bat eta Atzeko azaleko testu bat gehi daiteke "
4639 #~ "entitate baten bidez (edo entitate batek egindako egokitzapenen bidez). "
4640 #~ "Dagoeneko <link linkend=\"fdl-document\">Dokumentu</link>ak azaleko "
4641 #~ "testua baldin badauka azal berarentzat, aurretik zuk edo zu ordezkatzen "
4642 #~ "zaituen entitateak gehitutakoa, ezingo duzu beste testurik gehitu, baina "
4643 #~ "nahi izanez gero, lehendik dagoena ordeztu dezakezu, testu zaharra gehitu "
4644 #~ "zuen argitaratzailearen baimen esplizitua baldin baduzu."
4645
4646 #~ msgid ""
4647 #~ "The author(s) and publisher(s) of the <link linkend=\"fdl-"
4648 #~ "document\">Document</link> do not by this License give permission to use "
4649 #~ "their names for publicity for or to assert or imply endorsement of any "
4650 #~ "<link linkend=\"fdl-modified\">Modified Version </link>."
4651 #~ msgstr ""
4652 #~ "Lizentzia honen bidez <link linkend=\"fdl-document\">Dokumentu</link>aren "
4653 #~ "autoreak (edo autoreek) eta argitaratzaileak (edo argitaratzaileek) ez "
4654 #~ "dute baimenik ematen haien izenak publizitatean erabiltzeko edo <link "
4655 #~ "linkend=\"fdl-modified\">Bertsio aldatu</link>en oniritzia eragiteko edo "
4656 #~ "adierazteko"
4657
4658 #~ msgid ""
4659 #~ "You may combine the <link linkend=\"fdl-document\">Document</link> with "
4660 #~ "other documents released under this License, under the terms defined in "
4661 #~ "<link linkend=\"fdl-section4\">section 4</link> above for modified "
4662 #~ "versions, provided that you include in the combination all of the <link "
4663 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> of all of the "
4664 #~ "original documents, unmodified, and list them all as Invariant Sections "
4665 #~ "of your combined work in its license notice."
4666 #~ msgstr ""
4667 #~ "Lizentzia honen pean argitaratutako beste dokumentu batzuekin konbina "
4668 #~ "dezakezu <link linkend=\"fdl-document\">Dokumentua</link>, goian <link "
4669 #~ "linkend=\"fdl-section4\">4. atalean</link> biltzen diren baldintzak "
4670 #~ "betetzen badituzu eta bateratzean jatorrizko dokumentuen <link "
4671 #~ "linkend=\"fdl-invariant\">Atal aldaezin</link> guztiak sartzen badituzu "
4672 #~ "aldatu gabe eta guztiak Atal aldaezin gisa zerrendatuta zure lan "
4673 #~ "konbinatuaren lizentzia-oharrean."
4674
4675 #~ msgid ""
4676 #~ "The combined work need only contain one copy of this License, and "
4677 #~ "multiple identical <link linkend=\"fdl-invariant\">Invariant Sections</"
4678 #~ "link> may be replaced with a single copy. If there are multiple Invariant "
4679 #~ "Sections with the same name but different contents, make the title of "
4680 #~ "each such section unique by adding at the end of it, in parentheses, the "
4681 #~ "name of the original author or publisher of that section if known, or "
4682 #~ "else a unique number. Make the same adjustment to the section titles in "
4683 #~ "the list of Invariant Sections in the license notice of the combined work."
4684 #~ msgstr ""
4685 #~ "Lan konbinatuak Lizentzia honen kopia bakarra baino ez du behar, eta "
4686 #~ "hainbat <link linkend=\"fdl-invariant\">Atal aldaezin</link> berdin "
4687 #~ "badaude, kopia bakarrarekin ordeztu daitezke. Izen bera baina eduki "
4688 #~ "ezberdina duten hainbat Atal aldaezin baldin badaude, atal bakoitzaren "
4689 #~ "titulua desberdindu eta titulu bakar bihur ezazu, bukaeran autorearen edo "
4690 #~ "argitaratzailearen izena jarriz parentesi artean, edo errepikatzen ez den "
4691 #~ "zenbaki bat. Egin ezazu egokitzapen bera Atal aldaezinen zerrendako atal-"
4692 #~ "tituluetan, lan konbinatuaren lizentzia-oharrean."
4693
4694 #~ msgid ""
4695 #~ "In the combination, you must combine any sections entitled "
4696 #~ "<quote>History</quote> in the various original documents, forming one "
4697 #~ "section entitled <quote>History</quote>; likewise combine any sections "
4698 #~ "entitled <quote>Acknowledgements</quote>, and any sections entitled "
4699 #~ "<quote>Dedications</quote>. You must delete all sections entitled "
4700 #~ "<quote>Endorsements.</quote>"
4701 #~ msgstr ""
4702 #~ "Konbinazioan, jatorrizko dokumentuetan <quote>Historia</quote> titulua "
4703 #~ "duten atalak konbinatu behar dituzu, eta <quote>Historia</quote> "
4704 #~ "tituludun atal bakar bat osatu. Era berean, <quote>Eskertzak</quote> eta "
4705 #~ "<quote>Eskaintzak</quote> tituluak dituzten atal guztiak bateratu. "
4706 #~ "<quote>Oniritziak</quote> titulua duten sekzio guztiak, aldiz, ezabatu "
4707 #~ "egin behar dituzu."
4708
4709 #~ msgid ""
4710 #~ "You may make a collection consisting of the <link linkend=\"fdl-"
4711 #~ "document\">Document</link> and other documents released under this "
4712 #~ "License, and replace the individual copies of this License in the various "
4713 #~ "documents with a single copy that is included in the collection, provided "
4714 #~ "that you follow the rules of this License for verbatim copying of each of "
4715 #~ "the documents in all other respects."
4716 #~ msgstr ""
4717 #~ "<link linkend=\"fdl-document\">Dokumentu</link> honekin eta lizentzia "
4718 #~ "honekin argitaratutako beste dokumentu batzuekin bilduma bat osa "
4719 #~ "dezakezu, eta, dokumentu bakoitzarekin batera ematen den Lizentziaren "
4720 #~ "kopiaren ordez, Lizentzia bakarra eman dezakezu bilduma osoarentzat, "
4721 #~ "baldin eta dokumentu bakoitzaren kopia literalak egiteko lizentzia honek "
4722 #~ "ezartzen dituen baldintzak betetzen badituzu beste alderdi guztiei "
4723 #~ "dagokienez."
4724
4725 #~ msgid ""
4726 #~ "A compilation of the <link linkend=\"fdl-document\">Document</link> or "
4727 #~ "its derivatives with other separate and independent documents or works, "
4728 #~ "in or on a volume of a storage or distribution medium, does not as a "
4729 #~ "whole count as a <link linkend=\"fdl-modified\">Modified Version</link> "
4730 #~ "of the Document, provided no compilation copyright is claimed for the "
4731 #~ "compilation. Such a compilation is called an <quote>aggregate</quote>, "
4732 #~ "and this License does not apply to the other self-contained works thus "
4733 #~ "compiled with the Document , on account of their being thus compiled, if "
4734 #~ "they are not themselves derivative works of the Document. If the <link "
4735 #~ "linkend=\"fdl-cover-texts\">Cover Text</link> requirement of <link "
4736 #~ "linkend=\"fdl-section3\">section 3</link> is applicable to these copies "
4737 #~ "of the Document, then if the Document is less than one quarter of the "
4738 #~ "entire aggregate, the Document's Cover Texts may be placed on covers that "
4739 #~ "surround only the Document within the aggregate. Otherwise they must "
4740 #~ "appear on covers around the whole aggregate."
4741 #~ msgstr ""
4742 #~ "<link linkend=\"fdl-document\">Dokumentua</link> edo dokumentuaren "
4743 #~ "eratorriak beste dokumentu edo lan bereizi batzuekin batera elkartzea --"
4744 #~ "biltegi-bolumen batean edo banaketarako euskarri batean-- ez da "
4745 #~ "Dokumentuaren <link linkend=\"fdl-modified\">Bertsio aldatu</link>tzat "
4746 #~ "jotzen bere osotasunean, non eta ez den konpilazioarengatik konpilazio-"
4747 #~ "copyrightik eskatzen. Horrelako konpilazioei <quote>agregazio</quote> "
4748 #~ "esaten zaie, eta Lizentzia hau ez zaie aplikatuko Dokumentuarekin batera "
4749 #~ "konpilazioan sartutako gainerako lanei, konpilazioan sartu izanagatik "
4750 #~ "bakarrik, baldin eta ez badira Dokumentuaren lan eratorriak. <link "
4751 #~ "linkend=\"fdl-cover-texts\">Azaleko testu</link>ari dagokion <link "
4752 #~ "linkend=\"fdl-section3\">3. ataleko</link> betebeharra Dokumentuaren "
4753 #~ "kopia hauei aplikatzerik baldin badago, Dokumentua agregazioaren barnean "
4754 #~ "biltzen duten azaletan bakarrik jar daitezke Azaleko testuak Dokumentua "
4755 #~ "agregazio osoaren laurdena baino txikiagoa bada. Bestela, agregazio osoa "
4756 #~ "inguratzen duten azaletan jarri behar dira testu horiek."
4757
4758 #~ msgid ""
4759 #~ "Translation is considered a kind of modification, so you may distribute "
4760 #~ "translations of the <link linkend=\"fdl-document\">Document</link> under "
4761 #~ "the terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing "
4762 #~ "<link linkend=\"fdl-invariant\"> Invariant Sections</link> with "
4763 #~ "translations requires special permission from their copyright holders, "
4764 #~ "but you may include translations of some or all Invariant Sections in "
4765 #~ "addition to the original versions of these Invariant Sections. You may "
4766 #~ "include a translation of this License provided that you also include the "
4767 #~ "original English version of this License. In case of a disagreement "
4768 #~ "between the translation and the original English version of this License, "
4769 #~ "the original English version will prevail."
4770 #~ msgstr ""
4771 #~ "Itzulpena aldaketatzat jotzen da, eta, beraz, <link linkend=\"fdl-"
4772 #~ "document\">Dokumentu</link>aren itzulpenak <link linkend=\"fdl-"
4773 #~ "section4\">4. ataleko</link> baldintzen pean banatu ditzakezu. <link "
4774 #~ "linkend=\"fdl-invariant\"> Atal aldaezin</link>en ordez itzulpena "
4775 #~ "bakarrik jartzeko, copyright-jabeen baimena behar da, baina Atal aldaezin "
4776 #~ "batzuen edo guztien itzulpenak jar ditzakezu Atal aldaezin horien "
4777 #~ "jatorrizko bertsioekin batera. Lizentzia honen itzulpena ere jar "
4778 #~ "dezakezu, baldin eta ingelesezko jatorrizko bertsioa ere jartzen baduzu. "
4779 #~ "Lizentzia honen itzulpena eta jatorrizko ingelesezko bertsioa bat ez "
4780 #~ "badatoz, jatorrizko bertsioak balioko du."
4781
4782 #~ msgid ""
4783 #~ "You may not copy, modify, sublicense, or distribute the <link "
4784 #~ "linkend=\"fdl-document\">Document</link> except as expressly provided for "
4785 #~ "under this License. Any other attempt to copy, modify, sublicense or "
4786 #~ "distribute the Document is void, and will automatically terminate your "
4787 #~ "rights under this License. However, parties who have received copies, or "
4788 #~ "rights, from you under this License will not have their licenses "
4789 #~ "terminated so long as such parties remain in full compliance."
4790 #~ msgstr ""
4791 #~ "Lizentzia honen baitan espresuki adierazitakoa betetzen ez bada, "
4792 #~ "debekatuta dago <link linkend=\"fdl-document\">Dokumentua</link> "
4793 #~ "kopiatzea, aldatzea, azpilizentziatzea edo banatzea. Dokumentua beste "
4794 #~ "edozein eratan kopiatu, aldatu, azpilizentziatu edo banatzeko saio oro "
4795 #~ "deuseza izango da, eta Lizentzia honek ematen dizkizun eskubideak "
4796 #~ "automatikoki kenduko zaizkizu. Dena den, Lizentzia honen pean zuregandik "
4797 #~ "kopiak edo eskubideak jaso dituztenei ez zaizkie lizentziak kenduko, "
4798 #~ "baldintza guztiak betetzen dituzten bitartean."
4799
4800 #~ msgid ""
4801 #~ "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
4802 #~ "Software Foundation</ulink> may publish new, revised versions of the GNU "
4803 #~ "Free Documentation License from time to time. Such new versions will be "
4804 #~ "similar in spirit to the present version, but may differ in detail to "
4805 #~ "address new problems or concerns. See <ulink type=\"http\" url=\"http://"
4806 #~ "www.gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
4807 #~ msgstr ""
4808 #~ "<ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
4809 #~ "Software Foundation</ulink>ek GNU noizean behin Dokumentazio Librearen "
4810 #~ "Lizentziaren bertsio berrituak eta birmoldatuak argitaratuko ditu. "
4811 #~ "Bertsio berri horiek egungoaren antzekoak izango dira espirituz, baina, "
4812 #~ "arazo edo kezka berriei aurre egin beharko dietenez, litekeena da zehatz-"
4813 #~ "mehatz bat ez etortzea. Ikus <ulink type=\"http\" url=\"http://"
4814 #~ "www.gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
4815
4816 #~ msgid ""
4817 #~ "Each version of the License is given a distinguishing version number. If "
4818 #~ "the <link linkend=\"fdl-document\">Document</link> specifies that a "
4819 #~ "particular numbered version of this License <quote>or any later version</"
4820 #~ "quote> applies to it, you have the option of following the terms and "
4821 #~ "conditions either of that specified version or of any later version that "
4822 #~ "has been published (not as a draft) by the Free Software Foundation. If "
4823 #~ "the Document does not specify a version number of this License, you may "
4824 #~ "choose any version ever published (not as a draft) by the Free Software "
4825 #~ "Foundation."
4826 #~ msgstr ""
4827 #~ "Lizentziaren bertsio bakoitzak bertsio-zenbaki desberdindua dauka. <link "
4828 #~ "linkend=\"fdl-document\">Dokumentu</link>an zehazten bada Lizentzia honen "
4829 #~ "bertsio-zenbaki jakin bat <quote>edo bertsio berriago bat</quote> "
4830 #~ "dagokiola, zehaztutako bertsioko baldintzak edo Free Software Foundation-"
4831 #~ "ek argitaratutako (ez zirriborro gisako) bertsio berriago bateko "
4832 #~ "baldintzak betetzeko aukera izango duzu. Dokumentuak ez badu Lizentzia "
4833 #~ "honen bertsio-zenbakirik zehazten, Free Software Foundation-ek "
4834 #~ "argitaratutako bertsioetako edozein aukeratu dezakezu (baina ez "
4835 #~ "zirriborro gisa argitaratutakoa)."
4836
4837 #~ msgid ""
4838 #~ "Permission is granted to copy, distribute and/or modify this document "
4839 #~ "under the terms of the GNU Free Documentation License, Version 1.1 or any "
4840 #~ "later version published by the Free Software Foundation; with the <link "
4841 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> being LIST THEIR "
4842 #~ "TITLES, with the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</"
4843 #~ "link> being LIST, and with the <link linkend=\"fdl-cover-texts\">Back-"
4844 #~ "Cover Texts</link> being LIST. A copy of the license is included in the "
4845 #~ "section entitled <quote>GNU Free Documentation License</quote>."
4846 #~ msgstr ""
4847 #~ "Baimena ematen da dokumentu hau kopiatu, banatu eta/edo aldatzeko Free "
4848 #~ "Software Foundation-ek argitaratutako GNU Dokumentazio Librearen "
4849 #~ "Lizentziaren 1.1. bertsioan edo berriago batean ezarritako baldintzak "
4850 #~ "betetzen badira; <link linkend=\"fdl-invariant\">Atal Aldaezin</link> "
4851 #~ "hauekin: ZERRENDATU TITULUAK, <link linkend=\"fdl-cover-texts\">Aurreko "
4852 #~ "azal</link>eko testu hauekin: IDATZI ZERRENDA, eta <link linkend=\"fdl-"
4853 #~ "cover-texts\">Atzeko azal</link>eko testu hauekin: IDATZI ZERRENDA. "
4854 #~ "Lizentziaren kopia bat aurkituko duzu <quote>GNU Dokumentazio Librearen "
4855 #~ "lizentzia</quote> atalean."
4856
4857 #~ msgid ""
4858 #~ "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
4859 #~ "write <quote>with no Invariant Sections</quote> instead of saying which "
4860 #~ "ones are invariant. If you have no <link linkend=\"fdl-cover-"
4861 #~ "texts\">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</"
4862 #~ "quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise "
4863 #~ "for <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link>."
4864 #~ msgstr ""
4865 #~ "<link linkend=\"fdl-invariant\">Atal aldaezin</link>ik ez baduzu, idatzi "
4866 #~ "<quote>Atal aldaezinik gabe</quote> aldaezinak zein diren adierazi "
4867 #~ "beharrean. Ez baduzu <link linkend=\"fdl-cover-texts\">Aurreko azaleko "
4868 #~ "testu</link>rik, idatzi <quote>Aurreko azaleko testurik gabe</quote> "
4869 #~ "<quote>Aurreko azaleko testu hauekin: ZERRENDA</quote> jarri beharrean, "
4870 #~ "eta gauza bera <link linkend=\"fdl-cover-texts\">Atzeko azaleko testu</"
4871 #~ "link>ekin."
4872
4873 #~ msgid ""
4874 #~ "If your document contains nontrivial examples of program code, we "
4875 #~ "recommend releasing these examples in parallel under your choice of free "
4876 #~ "software license, such as the <ulink type=\"http\" url=\"http://"
4877 #~ "www.gnu.org/copyleft/gpl.html\"> GNU General Public License</ulink>, to "
4878 #~ "permit their use in free software."
4879 #~ msgstr ""
4880 #~ "Zure dokumentuan programa-kodearen adibide ez-tribialik baldin badago, "
4881 #~ "adibide horiek paraleloan argitaratzea gomendatzen dizugu eta zeuk "
4882 #~ "aukeratu software librearen lizentzia eman nahi diezun, <ulink "
4883 #~ "type=\"http\" url=\"http://www.gnu.org/copyleft/gpl.html\">GNU Lizentzia "
4884 #~ "Publiko Orokorra</ulink> lizentzian esaterako, software libre gisa erabil "
4885 #~ "ahal izan daitezen."