Debian Codegraph @

help/manual/es/es.po

raw
1 # translation of gtk-doc-help.master.po to Español
2 # Francisco Javier Fernandez Serrador <[email protected]>, 2009, 2010
3 # Jorge Gonzalez <[email protected]>, 2009.
4 # Jorge González <[email protected]>, 2009, 2010, 2011.
5 #
6 #
7 # Daniel Mustieles <[email protected]>, 2019-2021.
8 #
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: gtk-doc-help.master\n"
12 "POT-Creation-Date: 2020-10-01 20:17+0000\n"
13 "PO-Revision-Date: 2021-05-10 13:05+0200\n"
14 "Last-Translator: Daniel Mustieles <[email protected]>\n"
15 "Language-Team: Spanish - Spain <[email protected]>\n"
16 "Language: es_ES\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "X-Generator: Gtranslator 40.0\n"
21 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
22
23 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
24 msgctxt "_"
25 msgid "translator-credits"
26 msgstr ""
27 "Daniel Mustieles <[email protected]>, 2009 - 2021\n"
28 "Jorge González <[email protected]>, 2009 - 2011\n"
29 "Francisco Javier F. Serrador <[email protected]>, 2009, 2010"
30
31 #. (itstool) path: bookinfo/title
32 #: C/index.docbook:12
33 msgid "GTK-Doc Manual"
34 msgstr "Manual de GTK-Doc"
35
36 #. (itstool) path: bookinfo/edition
37 #: C/index.docbook:13
38 msgid "1.24.1"
39 msgstr "1.24.1"
40
41 #. (itstool) path: abstract/para
42 #: C/index.docbook:14
43 msgid "User manual for developers with instructions of GTK-Doc usage."
44 msgstr ""
45 "Manual del usuario para desarrolladores con instrucciones del uso de GTK-Doc."
46
47 #. (itstool) path: authorgroup/author
48 #: C/index.docbook:16
49 msgid ""
50 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
51 "<address> <email>[email protected]</email> </address> </affiliation>"
52 msgstr ""
53 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
54 "<address> <email>[email protected]</email> </address> </affiliation>"
55
56 #. (itstool) path: authorgroup/author
57 #: C/index.docbook:25
58 msgid ""
59 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
60 "<email>[email protected]</email> </address> </affiliation>"
61 msgstr ""
62 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
63 "<email>[email protected]</email> </address> </affiliation>"
64
65 #. (itstool) path: authorgroup/author
66 #: C/index.docbook:34
67 msgid ""
68 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
69 "<address> <email>[email protected]</email> </address> </affiliation>"
70 msgstr ""
71 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
72 "<address> <email>[email protected]</email> </address> </affiliation>"
73
74 #. (itstool) path: publisher/publishername
75 #: C/index.docbook:45
76 msgid "GTK-Doc project"
77 msgstr "Proyecto GTK-Doc"
78
79 #. (itstool) path: bookinfo/publisher
80 #: C/index.docbook:44
81 msgid ""
82 "<_:publishername-1/> <address><email>[email protected]</email></address>"
83 msgstr ""
84 "<_:publishername-1/> <address><email>[email protected]</email></address>"
85
86 #. (itstool) path: bookinfo/copyright
87 #: C/index.docbook:48
88 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
89 msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
90
91 #. (itstool) path: bookinfo/copyright
92 #: C/index.docbook:52
93 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
94 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
95
96 #. (itstool) path: legalnotice/para
97 #: C/index.docbook:65
98 msgid ""
99 "Permission is granted to copy, distribute and/or modify this document under "
100 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
101 "Version 1.1 or any later version published by the Free Software Foundation "
102 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
103 "copy of the license is <link linkend=\"fdl\">included</link>."
104 msgstr ""
105 "Se concede autorización para copiar, distribuir o modificar este documento "
106 "según los términos de la <citetitle>GNU Free Documentation License</"
107 "citetitle>, Versión 1.1, o cualquier otra versión posterior publicada por "
108 "Free Software Foundation sin secciones invariables, textos de portada ni "
109 "textos de contraportada. Se <link linkend=\"fdl\">incluye</link> una copia "
110 "de la licencia."
111
112 #. (itstool) path: legalnotice/para
113 #: C/index.docbook:73
114 msgid ""
115 "Many of the names used by companies to distinguish their products and "
116 "services are claimed as trademarks. Where those names appear in any GNOME "
117 "documentation, and those trademarks are made aware to the members of the "
118 "GNOME Documentation Project, the names have been printed in caps or initial "
119 "caps."
120 msgstr ""
121 "Muchos de los nombres usados por compañías para distinguir sus productos y "
122 "servicios se mencionan como marcas comerciales. Donde aparezcan dichos "
123 "nombres en cualquier documentación GNOME, y para que los miembros del "
124 "proyecto de documentación las reconozcan dichas marcas comerciales, dichos "
125 "nombres se imprimen en mayúsculas o iniciales mayúsculas."
126
127 #. (itstool) path: revhistory/revision
128 #: C/index.docbook:83
129 #| msgid ""
130 #| "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> "
131 #| "<authorinitials>ss</authorinitials> <revremark>dev version</revremark>"
132 msgid ""
133 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
134 "authorinitials> <revremark>gtk4 version</revremark>"
135 msgstr ""
136 "<revnumber>1.33.0</revnumber> <date>1 de octubre de 2020</date> "
137 "<authorinitials>mc</authorinitials> <revremark>versión gt4</revremark>"
138
139 #. (itstool) path: revhistory/revision
140 #: C/index.docbook:89
141 msgid ""
142 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
143 "authorinitials> <revremark>dev version</revremark>"
144 msgstr ""
145 "<revnumber>1.32.1</revnumber> <date>15 de agosto de 2019</date> "
146 "<authorinitials>ss</authorinitials> <revremark>desarrollo</revremark>"
147
148 #. (itstool) path: revhistory/revision
149 #: C/index.docbook:95
150 msgid ""
151 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
152 "authorinitials> <revremark>hotfix release</revremark>"
153 msgstr ""
154 "<revnumber>1.32</revnumber> <date>15 de agosto de 2019</date> "
155 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
156 "revremark>"
157
158 #. (itstool) path: revhistory/revision
159 #: C/index.docbook:101
160 msgid ""
161 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
162 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
163 msgstr ""
164 "<revnumber>1.31</revnumber> <date>5 de agosto de 2019</date> "
165 "<authorinitials>ss</authorinitials> <revremark>cobertura para más pruebas</"
166 "revremark>"
167
168 #. (itstool) path: revhistory/revision
169 #: C/index.docbook:107
170 msgid ""
171 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
172 "authorinitials> <revremark>more test coverage</revremark>"
173 msgstr ""
174 "<revnumber>1.30</revnumber> <date>8 de mayo de 2019</date> "
175 "<authorinitials>ss</authorinitials> <revremark>cobertura para más pruebas</"
176 "revremark>"
177
178 #. (itstool) path: revhistory/revision
179 #: C/index.docbook:113
180 msgid ""
181 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
182 "authorinitials> <revremark>bug fixes</revremark>"
183 msgstr ""
184 "<revnumber>1.29</revnumber> <date>28 de agosto de 2018</date> "
185 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
186 "revremark>"
187
188 #. (itstool) path: revhistory/revision
189 #: C/index.docbook:119
190 msgid ""
191 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
192 "authorinitials> <revremark>bug fixes</revremark>"
193 msgstr ""
194 "<revnumber>1.28</revnumber> <date>24 de marzo de 2018</date> "
195 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
196 "revremark>"
197
198 #. (itstool) path: revhistory/revision
199 #: C/index.docbook:125
200 msgid ""
201 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
202 "authorinitials> <revremark>fine tuning of the python port</revremark>"
203 msgstr ""
204 "<revnumber>1.27</revnumber> <date>07 de diciembre de 2017</date> "
205 "<authorinitials>ss</authorinitials> <revremark>ajustes para la migración a "
206 "python</revremark>"
207
208 #. (itstool) path: revhistory/revision
209 #: C/index.docbook:131
210 msgid ""
211 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
212 "authorinitials> <revremark>port all tools from perl/bash to python</"
213 "revremark>"
214 msgstr ""
215 "<revnumber>1.26</revnumber> <date>11 de agosto de 2017</date> "
216 "<authorinitials>ss</authorinitials> <revremark>portar todas las herramientas "
217 "de perl/bash a python</revremark>"
218
219 #. (itstool) path: revhistory/revision
220 #: C/index.docbook:137
221 msgid ""
222 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
223 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
224 msgstr ""
225 "<revnumber>1.25</revnumber> <date>21 de marzo de 2016</date> "
226 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores, "
227 "limpieza</revremark>"
228
229 #. (itstool) path: revhistory/revision
230 #: C/index.docbook:143
231 msgid ""
232 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
233 "authorinitials> <revremark>bug fix</revremark>"
234 msgstr ""
235 "<revnumber>1.24</revnumber> <date>29 de mayo de 2015</date> "
236 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
237 "revremark>"
238
239 #. (itstool) path: revhistory/revision
240 #: C/index.docbook:149
241 msgid ""
242 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
243 "authorinitials> <revremark>bug fix</revremark>"
244 msgstr ""
245 "<revnumber>1.23</revnumber> <date>17 de mayo de 2015</date> "
246 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
247 "revremark>"
248
249 #. (itstool) path: revhistory/revision
250 #: C/index.docbook:155
251 msgid ""
252 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
253 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
254 "revremark>"
255 msgstr ""
256 "<revnumber>1.22</revnumber> <date>7 de mayo de 2015</date> "
257 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores, "
258 "eliminadas funcionalidades obsoletas</revremark>"
259
260 #. (itstool) path: revhistory/revision
261 #: C/index.docbook:161
262 msgid ""
263 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
264 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
265 "revremark>"
266 msgstr ""
267 "<revnumber>1.21</revnumber> <date>17 de julio de 2014</date> "
268 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores, "
269 "eliminadas funcionalidades obsoletas</revremark>"
270
271 #. (itstool) path: revhistory/revision
272 #: C/index.docbook:167
273 msgid ""
274 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
275 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
276 "revremark>"
277 msgstr ""
278 "<revnumber>1.20</revnumber> <date>16 de febrero de 2014</date> "
279 "<authorinitials>ss</authorinitials> <revremark>errores corregidos, soporte "
280 "de marcado, mejoras en los estilos</revremark>"
281
282 #. (itstool) path: revhistory/revision
283 #: C/index.docbook:173
284 msgid ""
285 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
286 "authorinitials> <revremark>bug fixes</revremark>"
287 msgstr ""
288 "<revnumber>1.19</revnumber> <date>05 de junio de 2013</date> "
289 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores</"
290 "revremark>"
291
292 #. (itstool) path: revhistory/revision
293 #: C/index.docbook:179
294 msgid ""
295 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
296 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
297 msgstr ""
298 "<revnumber>1.18</revnumber> <date>14 de septiembre de 2011</date> "
299 "<authorinitials>ss</authorinitials> <revremark>correcciones de errores, "
300 "mejoras en la velocidad y soporte de marcado</revremark>"
301
302 #. (itstool) path: revhistory/revision
303 #: C/index.docbook:185
304 msgid ""
305 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
306 "authorinitials> <revremark>urgent bug fix update</revremark>"
307 msgstr ""
308 "<revnumber>1.17</revnumber> <date>26 de febrero de 2011</date> "
309 "<authorinitials>sk</authorinitials> <revremark>actualización urgente de "
310 "corrección de error</revremark>"
311
312 #. (itstool) path: revhistory/revision
313 #: C/index.docbook:191
314 msgid ""
315 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
316 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
317 msgstr ""
318 "<revnumber>1.16</revnumber> <date>14 de enero de 2011</date> "
319 "<authorinitials>sk</authorinitials> <revremark>correcciones de errores y "
320 "mejoras en la distribución</revremark>"
321
322 #. (itstool) path: revhistory/revision
323 #: C/index.docbook:197
324 msgid ""
325 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
326 "authorinitials> <revremark>bug and regression fixes</revremark>"
327 msgstr ""
328 "<revnumber>1.15</revnumber> <date>21 de mayo de 2010</date> "
329 "<authorinitials>sk</authorinitials> <revremark>correcciones de errores y "
330 "regresiones</revremark>"
331
332 #. (itstool) path: revhistory/revision
333 #: C/index.docbook:203
334 msgid ""
335 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
336 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
337 msgstr ""
338 "<revnumber>1.14</revnumber> <date>28 de marzo de 2010</date> "
339 "<authorinitials>sk</authorinitials> <revremark>correcciones de errores y "
340 "mejoras en el rendimiento</revremark>"
341
342 #. (itstool) path: revhistory/revision
343 #: C/index.docbook:209
344 msgid ""
345 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
346 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
347 "revremark>"
348 msgstr ""
349 "<revnumber>1.13</revnumber> <date>18 de diciembre de 2009</date> "
350 "<authorinitials>sk</authorinitials> <revremark>actualización del tarball "
351 "roto</revremark>"
352
353 #. (itstool) path: revhistory/revision
354 #: C/index.docbook:215
355 msgid ""
356 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
357 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
358 "bugfixes</revremark>"
359 msgstr ""
360 "<revnumber>1.12</revnumber> <date>18 de diciembre de 2009</date> "
361 "<authorinitials>sk</authorinitials> <revremark>correcciones de errores y "
362 "nuevas características</revremark>"
363
364 #. (itstool) path: revhistory/revision
365 #: C/index.docbook:221
366 msgid ""
367 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
368 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
369 "revremark>"
370 msgstr ""
371 "<revnumber>1.11</revnumber> <date>16 de noviembre de 2008</date> "
372 "<authorinitials>mal</authorinitials> <revremark>Migración a GNOME doc-utils</"
373 "revremark>"
374
375 #. (itstool) path: chapter/title
376 #: C/index.docbook:234
377 msgid "Introduction"
378 msgstr "Introducción"
379
380 #. (itstool) path: chapter/para
381 #: C/index.docbook:236
382 msgid ""
383 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
384 "it is used."
385 msgstr ""
386 "Este capítulo introduce GTK-Doc y proporciona una visión general de lo que "
387 "es y cómo usarlo."
388
389 #. (itstool) path: sect1/title
390 #: C/index.docbook:242
391 msgid "What is GTK-Doc?"
392 msgstr "¿Qué es GTK-Doc?"
393
394 #. (itstool) path: sect1/para
395 #: C/index.docbook:244
396 msgid ""
397 "GTK-Doc is used to document C code. It is typically used to document the "
398 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
399 "also be used to document application code."
400 msgstr ""
401 "GTK-Doc se usa para documentar código C. Generalmente se usa para documentar "
402 "la API pública de bibliotecas, tales como las bibliotecas GTK+ y de GNOME. "
403 "Pero también se puede usar para documentar código de aplicaciones."
404
405 #. (itstool) path: sect1/title
406 #: C/index.docbook:252
407 msgid "How Does GTK-Doc Work?"
408 msgstr "¿Cómo funciona GTK-Doc?"
409
410 #. (itstool) path: sect1/para
411 #: C/index.docbook:254
412 msgid ""
413 "GTK-Doc works by using documentation of functions placed inside the source "
414 "files in specially-formatted comment blocks, or documentation added to the "
415 "template files which GTK-Doc uses (though note that GTK-Doc will only "
416 "document functions that are declared in header files; it won't produce "
417 "output for static functions)."
418 msgstr ""
419 "GTK-Doc funciona usando documentación de las funciones ubicadas dentro de "
420 "los archivos de fuentes en bloques de comentarios especialmente formateados, "
421 "o documentación añadida a los archivos de plantillas que GTK-Doc usa (aunque "
422 "debe notar que GTK-Doc sólo documentará las funciones declaradas en los "
423 "archivos de cabecera; no produce salida para funciones estáticas)."
424
425 #. (itstool) path: sect1/para
426 #: C/index.docbook:261
427 msgid ""
428 "GTK-Doc consists of a number of python scripts, each performing a different "
429 "step in the process."
430 msgstr ""
431 "GTK-Doc consiste en un número de scripts en python, cada uno realiza un paso "
432 "diferente en el proceso."
433
434 #. (itstool) path: sect1/para
435 #: C/index.docbook:266
436 msgid "There are 5 main steps in the process:"
437 msgstr "Existen 5 pasos importantes en el proceso:"
438
439 #. (itstool) path: listitem/para
440 #: C/index.docbook:273
441 msgid ""
442 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
443 "source files with the documentation for each function, macro, structs or "
444 "unions, etc."
445 msgstr ""
446 "<guilabel>Escribir la documentación.</guilabel> El autor rellena los "
447 "archivos de fuentes con la documentación para cada función, macro, unión, "
448 "etc."
449
450 #. (itstool) path: listitem/para
451 #: C/index.docbook:282
452 msgid ""
453 "<guilabel>Gathering information about the code.</guilabel> "
454 "<application>gtkdoc-scan</application> scans the header files of the code "
455 "looking for declarations of functions, macros, enums, structs, and unions. "
456 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
457 "containing a list of the declarations, placing them into sections according "
458 "to which header file they are in. On the first run this file is copied to "
459 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
460 "the sections, and the order of the declarations within them, to produce the "
461 "final desired order. The second file it generates is <filename>&lt;"
462 "module&gt;-decl.txt</filename>. This file contains the full declarations "
463 "found by the scanner. If for some reason one would like some symbols to show "
464 "up in the docs, where the full declaration cannot be found by the scanner or "
465 "the declaration should appear differently, one can place entities similar to "
466 "the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
467 "module&gt;-overrides.txt</filename>."
468 msgstr ""
469 "<guilabel>Obtener información acerca del código</guilabel>. "
470 "<application>gtkdoc-scan</application> analiza los archivos de cabecera del "
471 "código buscando declaraciones de funciones, macros, enumeraciones, "
472 "estructuras y uniones. Crea el archivo <filename>&lt;module&gt;-decl-list."
473 "txt</filename> que contiene una lista de las declaraciones, ubicándolas en "
474 "secciones de acuerdo con el archivo de cabecera en el que están. Durante la "
475 "primera ejecución este archivo se copia en <filename>&lt;module&gt;-sections."
476 "txt</filename>. El autor puede reordenar las secciones y el orden de las "
477 "declaraciones en ellas, para producir la salida que quiere. El segundo "
478 "archivo que genera es <filename>&lt;module&gt;-decl.txt</filename>. Este "
479 "archivo contiene las declaraciones completas que encontró el análisis. Si "
480 "por alguna razón quisiese que algunos símbolos apareciesen en los "
481 "documentos, donde el análisis no puede encontrar la declaración completa o "
482 "la declaración debería aparecer de forma diferente, puede introducir "
483 "entradas de forma similar a las que hay en <filename>&lt;module&gt;-decl."
484 "txt</filename> dentro de <filename>&lt;module&gt;-overrides.txt</filename>."
485
486 #. (itstool) path: listitem/para
487 #: C/index.docbook:299
488 msgid ""
489 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
490 "query a library about any GObject subclasses it exports. It saves "
491 "information about each object's position in the class hierarchy and about "
492 "any GObject properties and signals it provides."
493 msgstr ""
494 "<application>gtkdoc-scangobj</application> también se puede usar para "
495 "consultar dinámicamente una biblioteca sobre cualquiera de las subclases "
496 "GObject que exporta. Guarda información sobre la posición de cada objeto en "
497 "la jerarquía de clases y sobre cualquier propiedad de GObject y las señales "
498 "que proporciona."
499
500 #. (itstool) path: listitem/para
501 #: C/index.docbook:305
502 msgid ""
503 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
504 "needed in the past when GObject was still GtkObject inside gtk+."
505 msgstr ""
506 "<application>gtkdoc-scanobj</application> no se debería usar más. Se "
507 "necesitó en el pasado, cuando GObject todavía era GtkObject dentro de GTK+."
508
509 #. (itstool) path: listitem/para
510 #: C/index.docbook:312
511 msgid ""
512 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
513 "mkdb</application> turns the template files into XML files in the <filename "
514 "class=\"directory\">xml/</filename> subdirectory. If the source code "
515 "contains documentation on functions, using the special comment blocks, it "
516 "gets merged in here. If there are no tmpl files used it only reads docs from "
517 "sources and introspection data."
518 msgstr ""
519 "<guilabel>Generar el XML y el HTML/PDF.</guilabel><application>gtkdoc-mkdb</"
520 "application> convierte los archivos de plantilla en archivos SGML o XML en "
521 "la subcarpeta <filename class=\"directory\">xml/</filename>. Si el código "
522 "fuente contiene documentación de funciones, usando los bloques especiales de "
523 "comentarios, entonces se mezclarán aquí. Si no se usan archivos tmpl sólo "
524 "obtiene los documentos de los fuentes y los datos obtenidos en introspección."
525
526 #. (itstool) path: listitem/para
527 #: C/index.docbook:321
528 msgid ""
529 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
530 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
531 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
532 "document called <filename>&lt;package&gt;.pdf</filename>."
533 msgstr ""
534 "<application>gtkdoc-mkhtml</application> convierte los archivos XML en "
535 "archivos HTML en la subcarpeta <filename class=\"directory\">html/</"
536 "filename>. De la misma forma <application>gtkdoc-mkpdf</application> "
537 "convierte los archivos XML en un documento PDF llamado <filename>&lt;"
538 "paquete&gt;.pdf</filename>."
539
540 #. (itstool) path: listitem/para
541 #: C/index.docbook:327
542 msgid ""
543 "Files in <filename class=\"directory\">xml/</filename> and <filename class="
544 "\"directory\">html/</filename> directories are always overwritten. One "
545 "should never edit them directly."
546 msgstr ""
547 "Los archivos en las carpetas <filename class=\"directory\">xml/</filename> y "
548 "<filename class=\"directory\">html/</filename> y siempre se sobrescriben. "
549 "Nunca se deben editar directamente."
550
551 #. (itstool) path: listitem/para
552 #: C/index.docbook:335
553 msgid ""
554 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
555 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
556 "run to fix up any cross-references between separate documents. For example, "
557 "the GTK+ documentation contains many cross-references to types documented in "
558 "the GLib manual. When creating the source tarball for distribution, "
559 "<application>gtkdoc-rebase</application> turns all external links into web-"
560 "links. When installing distributed (pregenerated) docs the same application "
561 "will try to turn links back to local links (where those docs are installed)."
562 msgstr ""
563 "<guilabel>Arreglar referencias cruzadas entre documentos.</guilabel> Después "
564 "de instalar los archivos HTML se puede ejecutar <application>gtkdoc-fixxref</"
565 "application> para arreglar cualquier referencia cruzada entre documentos "
566 "separados. Por ejemplo, la documentación GTK+ contiene muchas referencias "
567 "cruzadas a tipos documentados en el manual de GLib. Al crear los "
568 "archivadores «tarball» para su distribución, <application>gtkdoc-rebase</"
569 "application> convierte todos los enlaces externos en enlaces web. Al "
570 "instalar la documentación distribuida (pregenerada) la misma aplicación "
571 "intentará convertir de nuevo los enlaces, esta vez a enlaces locales (donde "
572 "esa documentación está instalada)."
573
574 #. (itstool) path: sect1/title
575 #: C/index.docbook:353
576 msgid "Getting GTK-Doc"
577 msgstr "Obtener GTK-Doc"
578
579 #. (itstool) path: sect2/title
580 #: C/index.docbook:356
581 msgid "Requirements"
582 msgstr "Requerimientos"
583
584 #. (itstool) path: sect2/para
585 #: C/index.docbook:357
586 msgid ""
587 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
588 msgstr ""
589 "<guilabel>python 2/3</guilabel> - los scripts principales están escritos en "
590 "python."
591
592 #. (itstool) path: sect2/para
593 #: C/index.docbook:360
594 msgid ""
595 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
596 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
597 msgstr ""
598 "<guilabel>xsltproc</guilabel>: el procesador xslt de libxslt <ulink url="
599 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
600
601 #. (itstool) path: sect2/para
602 #: C/index.docbook:364
603 msgid ""
604 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="
605 "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
606 "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
607 msgstr ""
608 "<guilabel>docbook-xsl</guilabel>: las hojas de estilo XLS de docbook <ulink "
609 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type="
610 "\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
611
612 #. (itstool) path: sect2/para
613 #: C/index.docbook:368
614 msgid ""
615 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
616 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
617 "examples"
618 msgstr ""
619 "Una de <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
620 "o <guilabel>vim</guilabel>: opcional, usada para el resaltado de sintaxis de "
621 "los ejemplos."
622
623 #. (itstool) path: sect1/title
624 #: C/index.docbook:376
625 msgid "About GTK-Doc"
626 msgstr "Acerca de GTK-Doc"
627
628 #. (itstool) path: sect1/para
629 #: C/index.docbook:378
630 msgid ""
631 "Historically GTK-Doc was used to generate template files from the sources "
632 "code. These template files could be used by developers to enter the API "
633 "documentation. This approach was rather inconvenient because it required to "
634 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
635 "possible to place all API information into source comments, which made the "
636 "template support obsolete. In version 1.26 template support has been removed."
637 msgstr ""
638 "Históricamente, GTK-Doc se utilizaba para generar archivos de plantilla a "
639 "partir del código fuente. Los desarrolladores pueden usar estos archivos de "
640 "plantilla para introducir la documentación de la API. Este enfoque era "
641 "bastante incómodo porque requería mantener los archivos generados bajo "
642 "control de versiones. Desde GTK-Doc 1.9 se hizo posible colocar toda la "
643 "información de la API en los comentarios de origen, lo que dejó obsoleto el "
644 "soporte de la plantilla. En la versión 1.26 se ha eliminado el soporte de "
645 "plantillas."
646
647 #. (itstool) path: sect1/para
648 #: C/index.docbook:388 C/index.docbook:402
649 msgid "(FIXME)"
650 msgstr "(ARRÉGLAME)"
651
652 #. (itstool) path: sect1/para
653 #: C/index.docbook:392
654 msgid ""
655 "(authors, web pages, mailing list, license, future plans, comparison with "
656 "other similar systems.)"
657 msgstr ""
658 "(autores, páginas web, listas de correo, licencias, planes futuros, "
659 "comparación con otros sistemas similares.)"
660
661 #. (itstool) path: sect1/title
662 #: C/index.docbook:400
663 msgid "About this Manual"
664 msgstr "Acerca de este manual"
665
666 #. (itstool) path: sect1/para
667 #: C/index.docbook:406
668 msgid "(who it is meant for, where you can get it, license)"
669 msgstr "(a quién está dirigido, dónde puede obtenerse, licencia)"
670
671 #. (itstool) path: chapter/title
672 #: C/index.docbook:415
673 msgid "Project Setup"
674 msgstr "Configuración del proyecto"
675
676 #. (itstool) path: chapter/para
677 #: C/index.docbook:417
678 msgid ""
679 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
680 "into your project. The integration of GTK-Doc into a project includes the "
681 "following steps:"
682 msgstr ""
683 "Este capítulo describe los pasos para integrar GTK-Doc en su proyecto. La "
684 "integración de GTK-Doc incluye:"
685
686 #. (itstool) path: listitem/para
687 #: C/index.docbook:425
688 msgid ""
689 "Preparation of the directory structure and creating required configuration "
690 "files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles"
691 "\"> Setting up a skeleton documentation</link>)."
692 msgstr ""
693 "Preparación de la estructura de carpetas y crear los archivos de "
694 "configuración necesarios para su documentación GTK-Doc (consulte <link "
695 "linkend=\"settingup_docfiles\"> Configurar el esqueleto de la documentación</"
696 "link>)."
697
698 #. (itstool) path: listitem/para
699 #: C/index.docbook:433
700 msgid ""
701 "Adjusting the build system to build your documentation using the GTK-Doc "
702 "tools. Multiple build systems are supported, in this manual we describe how "
703 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
704 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link linkend="
705 "\"settingup_plain_makefiles\">plain Makefiles</link>."
706 msgstr ""
707 "Ajustar el sistema de construcción para construir su documentación usando "
708 "las herramientas de GTK-Doc. Hay varios sistemas de construcción soportados, "
709 "en este manual se describe cómo integrar GTK-Doc con <link linkend="
710 "\"settingup_autotools\">Autotools</link>, <link linkend=\"settingup_cmake"
711 "\">CMake</link>, y <link linkend=\"settingup_plain_makefiles\">archivos "
712 "Makefile</link>."
713
714 #. (itstool) path: listitem/para
715 #: C/index.docbook:443
716 msgid ""
717 "Adding GTK-Doc specific files to version control and deciding which files to "
718 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
719 "control systems</link>)."
720 msgstr ""
721 "Añadir archivos específicos de GTK-Doc al control de versiones y decidir qué "
722 "archivos ignorar (consulte <link linkend=\"settingup_vcs\">Integración con "
723 "sistemas de control de versiones</link>)."
724
725 #. (itstool) path: chapter/para
726 #: C/index.docbook:451
727 msgid ""
728 "The following sections assume we work on a project called <code>meep</code>. "
729 "This project contains two packages (or modules), a library called "
730 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
731 msgstr ""
732 "La siguiente sección asume que se trabaja con un proyecto llamado "
733 "<code>meep</code>. Este proyecto contiene dos paquetes (o módulos), una "
734 "biblioteca llamada <code>libmeep</code> y una aplicación de usuario final "
735 "llamada <code>meeper</code>."
736
737 #. (itstool) path: sect1/title
738 #: C/index.docbook:460
739 msgid "Setting up a skeleton documentation"
740 msgstr "Configurar el esquema de la documentación"
741
742 #. (itstool) path: sect1/para
743 #: C/index.docbook:462
744 msgid ""
745 "A common convention is to place documentation into a folder called "
746 "<code>docs</code> inside your top-level project directory. We usually "
747 "distinguish between <emphasis>reference documentation</emphasis> intended "
748 "for developers and an <emphasis>user manual</emphasis> intended for end-"
749 "users. Again the convention is to have separate folders for both. We usually "
750 "place the reference documentation in a folder named <code>reference</code> "
751 "and the end-user manual in a folder named <code>help</code> as. According to "
752 "the above convention the documentation for our <code>libmeep</code> package "
753 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
754 "just one library or application the documentation could also be placed "
755 "directly into <code>docs/reference</code>. It is not mandatory to use the "
756 "above convention, but if you choose to use a different directory structure "
757 "you must adjust your build system configuration to match your directory "
758 "structure."
759 msgstr ""
760 "Un convenio común es colocar la documentación en una carpeta llamada "
761 "<code>docs</code> dentro de su carpeta de proyecto de nivel superior. "
762 "Normalmente se distingue entre <emphasis>documentación de referencia</"
763 "emphasis> destinada a desarrolladores y un <emphasis>manual de usuario</"
764 "emphasis> destinado a usuarios finales. Nuevamente, el convenio es tener "
765 "carpetas separadas para ambos. Por lo general, colocamos la documentación de "
766 "referencia en una carpeta llamada <code>reference</code> y el manual del "
767 "usuario final en una carpeta llamada <code>help</code> como. De acuerdo con "
768 "el convenio anterior, la documentación de nuestro paquete <code>libmeep</"
769 "code> se colocaría en: <code>docs/reference/libmeep</code>. Para paquetes "
770 "con una sola biblioteca o aplicación, la documentación también se puede "
771 "colocar directamente en <code>docs/reference </code>. No es obligatorio usar "
772 "el convenio anterior, pero si elige usar una estructura de carpetas "
773 "diferente, debe ajustar la configuración del sistema de compilación para que "
774 "coincida con la estructura de su carpeta."
775
776 #. (itstool) path: example/title
777 #: C/index.docbook:493
778 msgid "Example directory structure of <emphasis>meep</emphasis> project"
779 msgstr ""
780 "Ejemplo de estructura de carpetas para el proyecto <emphasis>meep</emphasis>"
781
782 #. (itstool) path: example/programlisting
783 #: C/index.docbook:495
784 #, no-wrap
785 msgid ""
786 "\n"
787 "meep/\n"
788 " docs/\n"
789 " reference/ # reference documentation\n"
790 " libmeep/\n"
791 " meeper/\n"
792 " help/ # optional: user manual\n"
793 " meeper/\n"
794 " src/\n"
795 " libmeep/\n"
796 " meeper/\n"
797 msgstr ""
798 "\n"
799 "meep/\n"
800 " docs/\n"
801 " reference/ # reference documentation\n"
802 " libmeep/\n"
803 " meeper/\n"
804 " help/ # optional: user manual\n"
805 " meeper/\n"
806 " src/\n"
807 " libmeep/\n"
808 " meeper/\n"
809
810 #. (itstool) path: sect1/para
811 #: C/index.docbook:487
812 msgid ""
813 "In the following sections we will assume a directory structure for our "
814 "<emphasis>meep</emphasis> project that uses the above conventions. <_:"
815 "example-1/>"
816 msgstr ""
817 "En las siguientes secciones se asumirá que la estructura de carpetas de "
818 "nuestro proyecto <emphasis>meep</emphasis> usa los convenios anteriores. <_:"
819 "example-1/>"
820
821 #. (itstool) path: sect1/title
822 #: C/index.docbook:512
823 msgid "Integration with Autotools"
824 msgstr "Integración con Autotools"
825
826 #. (itstool) path: sect1/para
827 #: C/index.docbook:513
828 msgid ""
829 "Integration of GTK-Doc into an autotools-based build system requires the "
830 "following steps:"
831 msgstr ""
832 "La integración de GTK-Doc en un sistema de construcción basado en autotools "
833 "requiere los siguientes pasos:"
834
835 #. (itstool) path: listitem/para
836 #: C/index.docbook:519
837 msgid ""
838 "Ensure that <application>gtkdocize</application> is run once before the "
839 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
840 "script is present, adjust it to check for GTK-Doc and add a call to "
841 "<application>gtkdocize</application>."
842 msgstr ""
843 "Asegúrese de que <application>gtkdocize</application> se ejecuta antes del "
844 "script <filename>configure</filename>. Si existe un script <filename>autogen."
845 "sh</filename> ajústelo para que compruebe que existe GTK-Doc y añada una "
846 "llamada a <application>gtkdocize</application>."
847
848 #. (itstool) path: listitem/para
849 #: C/index.docbook:527
850 msgid ""
851 "The main purpose of <application>gtkdocize</application> is to make the "
852 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
853 "filename> macro definition file available to the build system, either by "
854 "copying or linking it into the project."
855 msgstr ""
856 "El propósito principal de <application>gtkdocize</application> es hacer que "
857 "el Makefile <filename>gtk-doc.make</filename> y el archivo de definición de "
858 "macros <filename>gtk-doc.m4</filename> estén disponibles para el sistema de "
859 "construcción, bien copiándolos o enlazándolos en el proyecto."
860
861 #. (itstool) path: listitem/para
862 #: C/index.docbook:536
863 msgid ""
864 "Add the necessary <application>autoconf</application> macros to "
865 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
866 "allow configuration of GTK-Doc via the generated <filename>configure</"
867 "filename> script."
868 msgstr ""
869 "Añada las macros de <application>autoconf</application> necesarias a "
870 "<filename>configure.ac</filename> para activar GTK-Doc en su sistema de "
871 "construcción y permitir la configuración de GTK-Doc generada en el script "
872 "<filename>configure</filename>."
873
874 #. (itstool) path: listitem/para
875 #: C/index.docbook:542
876 msgid ""
877 "Among others with registers the <code>--enable-gtk-doc</code> option with "
878 "the <filename>configure</filename> script."
879 msgstr ""
880 "Entre otras la que registra la opción <code>--enable-gtk-doc</code> en el "
881 "script <filename>configure</filename>."
882
883 #. (itstool) path: listitem/para
884 #: C/index.docbook:548
885 msgid ""
886 "Create an <application>automake</application> script for each application or "
887 "library in your project. In the example used in this documentation this step "
888 "applies to both <code>meeper</code> and <code>libmeep</code>."
889 msgstr ""
890 "Cree un script <application>automake</application> para cada aplicación o "
891 "biblioteca de su proyecto. En el ejemplo usado en esta documentación este "
892 "paso se aplica a <code>meeper</code> y a <code>libmeep</code>."
893
894 #. (itstool) path: sect1/para
895 #: C/index.docbook:557
896 msgid ""
897 "In the following sections, we will perform the above steps in reverse order. "
898 "We start with the <application>automake</application> scripts and work our "
899 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
900 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
901 "build the documentation."
902 msgstr ""
903 "En las siguientes secciones, se realizan los pasos anteriores en orden "
904 "inverso. Comienza con los scripts <application>automake</application> y "
905 "avanza hasta <filename>configure.ac</filename> y <filename> autogen.sh </"
906 "filename>. Luego se muestra cómo activar Gtk-Doc en el sistema de "
907 "compilación y cómo compilar la documentación."
908
909 #. (itstool) path: sect2/title
910 #: C/index.docbook:567
911 msgid "Integration with automake"
912 msgstr "Integración con automake"
913
914 #. (itstool) path: sect2/para
915 #: C/index.docbook:569
916 msgid ""
917 "First copy the <filename>Makefile.am</filename> from the <filename class="
918 "\"directory\">examples</filename> sub-directory of the <ulink url=\"https://"
919 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
920 "sources</ulink> to your project's reference documentation directory (e.g. "
921 "<filename class=\"directory\">docs/reference/&lt;package&gt;</filename>). A "
922 "local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-"
923 "tools/examples/Makefile.am</filename>. If you have multiple packages repeat "
924 "this for each one."
925 msgstr ""
926 "Primero copie el archivo <filename>Makefile.am</filename> de la subcarpeta "
927 "<filename class=\"directory\">examples</filename> de <ulink url=\"https://"
928 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\"> gtkdoc-"
929 "sources</ulink> a la carpeta de documentación de la API de su proyecto "
930 "(<filename class=\"directory\">./docs/reference/&lt;paquete&gt;</filename>). "
931 "Debería haber una copia local disponible en <filename>/usr/share/doc/gtk-doc-"
932 "tools/examples/Makefile.am</filename>. Si tiene varios paquetes de "
933 "documentación, repítalo para cada uno de ellos."
934
935 #. (itstool) path: note/simpara
936 #: C/index.docbook:582
937 msgid ""
938 "Do not forget to add each <filename>Makefile.am</filename> to the "
939 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
940 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
941 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
942 "filename> to <function>AC_CONFIG_FILES</function>."
943 msgstr ""
944 "No olvide añadir cada <filename>Makefile.am</filename> a la macro "
945 "<function>AC_CONFIG_FILES</function> en <filename>configure.ac</filename>. "
946 "Para <filename>docs/reference/libmeep/Makefile.am</filename> deberá añadir "
947 "la entrada <filename>docs/reference/libmeep/Makefile</filename> a "
948 "<function>AC_CONFIG_FILES</function>."
949
950 #. (itstool) path: example/title
951 #: C/index.docbook:594
952 msgid "Example directory structure with <filename>Makefiles.am</filename>"
953 msgstr ""
954 "Ejemplo de estructura de carpetas con <filename>Makefiles.am</filename>"
955
956 #. (itstool) path: example/programlisting
957 #: C/index.docbook:597
958 #, no-wrap
959 msgid ""
960 "\n"
961 "meep/\n"
962 " docs/\n"
963 " reference/ # reference documentation\n"
964 " libmeep/\n"
965 " Makefile.am\n"
966 " meeper/\n"
967 " Makefile.am\n"
968 " help/ # optional: user manual\n"
969 " meeper/\n"
970 " src/\n"
971 " libmeep/\n"
972 " meeper/\n"
973 msgstr ""
974 "\n"
975 "meep/\n"
976 " docs/\n"
977 " reference/ # reference documentation\n"
978 " libmeep/\n"
979 " Makefile.am\n"
980 " meeper/\n"
981 " Makefile.am\n"
982 " help/ # optional: user manual\n"
983 " meeper/\n"
984 " src/\n"
985 " libmeep/\n"
986 " meeper/\n"
987
988 #. (itstool) path: sect2/para
989 #: C/index.docbook:613
990 msgid ""
991 "Next, you need to customize the copied Makefiles and provide values for the "
992 "various parameters in each <filename>Makefile.am</filename>. All settings "
993 "have a comment above them that describes their purpose and how to customize "
994 "the setting. Most settings are used to supply extra flags to the respective "
995 "tools to which they apply. Every tool has a variable of the form <option>&lt;"
996 "TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</"
997 "application> has an option named <code>MKHTML_OPTIONS</code>). All the tools "
998 "support <option>--help</option> to list the supported options."
999 msgstr ""
1000 "A continuación, debe personalizar los Makefiles copiados y proporcionar "
1001 "valores para los distintos parámetros en cada <filename>Makefile.am</"
1002 "filename>. Todas las configuraciones tienen un comentario sobre ellas que "
1003 "describe su propósito y cómo personalizar la configuración. La mayoría de "
1004 "las configuraciones se utilizan para proporcionar indicadores adicionales a "
1005 "las herramientas respectivas a las que se aplican. Cada herramienta tiene "
1006 "una variable de la forma <option> &lt;TOOLNAME&gt;_OPTIONS </option> (por "
1007 "ejemplo, la herramienta <application>gtkdoc-mkhtml</application> tiene una "
1008 "opción llamada <code>MKHTML_OPTIONS</code>). Todas las herramientas admiten "
1009 "<option>--help</option> para enumerar las opciones admitidas."
1010
1011 #. (itstool) path: listitem/para
1012 #: C/index.docbook:637
1013 msgid ""
1014 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1015 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1016 msgstr ""
1017 "<option>DOC_MODULE</option> se usa para proporcionar el nombre del paquete "
1018 "que se está documentando (ej. <code>meeper</code>, o <code>libmeep</code>)."
1019
1020 #. (itstool) path: listitem/para
1021 #: C/index.docbook:644
1022 msgid ""
1023 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1024 "directory which GTK-Doc searches for your API documentation. This will "
1025 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1026 "directory of that directory."
1027 msgstr ""
1028 "<option>DOC_SOURCE_DIR</option> se utiliza para especificar la ubicación de "
1029 "la carpeta de origen en el que GTK-Doc busca la documentación de su API. "
1030 "Esto generalmente será <code>DOC_SOURCE_DIR=$(top_srcdir)/src</code> o una "
1031 "subcarpeta de ese carpeta."
1032
1033 #. (itstool) path: listitem/para
1034 #: C/index.docbook:657
1035 msgid ""
1036 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1037 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB="
1038 "$(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
1039 "the matched files change."
1040 msgstr ""
1041 "<option>HFILE_GLOB</option> y <option>CFILE_GLOB</option> se usan para "
1042 "dependencias. Cada opción toma un archivo glob (por ejemplo, "
1043 "<code>HFILE_GLOB=$(top_srcdir)/src/*.C</code>). La documentación se "
1044 "reconstruirá si alguno de los archivos coincidentes cambia."
1045
1046 #. (itstool) path: listitem/para
1047 #: C/index.docbook:669
1048 msgid ""
1049 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1050 "include when scanning for API documentation, which are not found under "
1051 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1052 "extra.h</code>)."
1053 msgstr ""
1054 "<option>EXTRA_HFILES</option> permite especificar archivos de cabeceras "
1055 "adicionales que incluir al analizar la documentación de la API y que no "
1056 "están en <code>DOC_SOURCE_DIR</code> (ej. <code> EXTRA_HFILES=$(top_srcdir}/"
1057 "contrib/extra.h</code>)."
1058
1059 #. (itstool) path: listitem/para
1060 #: C/index.docbook:679
1061 msgid ""
1062 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1063 "to ignore when scanning for API documentation. Use the basename of the file "
1064 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1065 "private_code_folder</code>)."
1066 msgstr ""
1067 "<option>IGNORE_HFILES</option> permite especificar archivos de cabeceras o "
1068 "carpetas que ignorar al analizar la documentación de la API. Use el nombre "
1069 "base del archivo o la carpta (ej. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1070 "private_code_folder</code>)."
1071
1072 #. (itstool) path: listitem/para
1073 #: C/index.docbook:689
1074 msgid ""
1075 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1076 "copied into the <filename>html/</filename> directory of the generated "
1077 "documentation. If your API documentation includes any images they need to be "
1078 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1079 "stock_about_24.png</code>)."
1080 msgstr ""
1081 "<option>HTML_IMAGES</option> permite especificar archivos de imágenes que se "
1082 "copiarán en la carpeta <filename>html/</filename> de la documentación "
1083 "generada. Si su documentación de la API incluye imágenes, deben agregarse a "
1084 "esta opción (por ejemplo, <code>HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1085 "stock_about_24.png</code>)."
1086
1087 #. (itstool) path: listitem/para
1088 #: C/index.docbook:702
1089 msgid ""
1090 "<option>content_files</option> allows to specify extra files that are "
1091 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1092 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1093 msgstr ""
1094 "<option>content_files</option> permite especificar archivos adicionales que "
1095 "están incluidos en <code>$(DOC_MAIN_SGML_FILE)</code> (por ejemplo, "
1096 "<code>content_files=running.xml building.xml changes-2.0.xml</code>)"
1097
1098 #. (itstool) path: listitem/para
1099 #: C/index.docbook:713
1100 msgid ""
1101 "<option>expand_content_files</option> allows to specify files where "
1102 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1103 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1104 msgstr ""
1105 "<option>expand_content_files</option> permite especificar archivos donde "
1106 "<emphasis>gtk-doc abbreviations</emphasis> como <code>#GtkWidget</code> se "
1107 "expanden (por ejemplo, <code>expand_content_files=running.xml</code>)."
1108
1109 #. (itstool) path: sect2/para
1110 #: C/index.docbook:631
1111 msgid ""
1112 "The following list explains the most relevant options. Check the example "
1113 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1114 msgstr ""
1115 "La siguiente lista explica las opciones más relevantes. Consulte el ejemplo "
1116 "<filename>Makefile.am</filename> para obtener opciones adicionales. <_:"
1117 "itemizedlist-1/>"
1118
1119 #. (itstool) path: sect2/title
1120 #: C/index.docbook:728
1121 msgid "Integration with autoconf"
1122 msgstr "Integración con autoconf"
1123
1124 #. (itstool) path: sect2/para
1125 #: C/index.docbook:730
1126 msgid ""
1127 "Integration with <application>autoconf</application> is very simple and "
1128 "includes one required step and an additional optional (but recommended) "
1129 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1130 "to your <filename>configure.ac</filename> script. This registers several "
1131 "configure options to enable GTK-Doc and allows you to set default arguments "
1132 "for <application>gtkdocize</application>."
1133 msgstr ""
1134 "La integración con <application>autoconf</application> es muy simple e "
1135 "incluye un paso requerido y un paso opcional adicional (pero recomendado). "
1136 "El primer paso es agregar la macro <function>GTK_DOC_CHECK</function> a su "
1137 "script <filename>configure.ac</filename>. Esto registra varias opciones de "
1138 "configuración para habilitar GTK-Doc y le permite establecer argumentos "
1139 "predeterminados para <application>gtkdocize</application>."
1140
1141 #. (itstool) path: warning/simpara
1142 #: C/index.docbook:742
1143 msgid ""
1144 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1145 "macro must start at the beginning of the line and should not start with "
1146 "whitespace."
1147 msgstr ""
1148 "Asegúrese de que la macro <code>GTK_DOC_CHECK</code> no esté sangrada. La "
1149 "macro debe comenzar al principio de la línea y no debe comenzar con espacios "
1150 "en blanco."
1151
1152 #. (itstool) path: sect2/para
1153 #: C/index.docbook:749
1154 msgid ""
1155 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1156 "<filename>configure.ac</filename>. This is not required but helps "
1157 "<application>gtkdocize</application> to automatically copy the macro "
1158 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1159 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1160 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1161 "to explicitly tell the <application>aclocal</application> tool where to find "
1162 "the macro definition file."
1163 msgstr ""
1164 "El segundo paso es agregar el <code>AC_CONFIG_MACRO_DIR (m4)</code> a su "
1165 "<filename>configure.ac</filename>. Esto no es obligatorio, pero ayuda a "
1166 "<application>gtkdocize</application> a copiar automáticamente la definición "
1167 "de macro (Ej., <filename>gtk-doc.m4</filename>) que contiene la macro "
1168 "<function>GTK_DOC_CHECK</function> en la carpeta de macros de su proyecto. "
1169 "Sin esto, es posible que no se encuentre la macro GTK_DOC_CHECK y "
1170 "necesitaría decirle explícitamente a la herramienta <application>aclocal</"
1171 "application> dónde encontrar el archivo de definición de macro."
1172
1173 #. (itstool) path: example/title
1174 #: C/index.docbook:762
1175 msgid "Minimal integration with autoconf"
1176 msgstr "Integración mínima con autoconf"
1177
1178 #. (itstool) path: example/programlisting
1179 #: C/index.docbook:763
1180 #, no-wrap
1181 msgid ""
1182 "\n"
1183 "# recommended: set m4 directory\n"
1184 "AC_CONFIG_MACRO_DIR(m4)\n"
1185 "# optional: register gtk-doc in configure\n"
1186 "GTK_DOC_CHECK([1.28])\n"
1187 msgstr ""
1188 "\n"
1189 "# recommended: set m4 directory\n"
1190 "AC_CONFIG_MACRO_DIR(m4)\n"
1191 "# optional: register gtk-doc in configure\n"
1192 "GTK_DOC_CHECK([1.28])\n"
1193
1194 #. (itstool) path: example/title
1195 #: C/index.docbook:778
1196 msgid "Integration with optional gtk-doc dependency"
1197 msgstr "Integración con dependencias opcionales de gtk-doc"
1198
1199 #. (itstool) path: example/programlisting
1200 #: C/index.docbook:779
1201 #, no-wrap
1202 msgid ""
1203 "\n"
1204 "m4_ifdef([GTK_DOC_CHECK], [\n"
1205 "# recommended: set m4 directory\n"
1206 "AC_CONFIG_MACRO_DIR(m4)\n"
1207 "# optional: register gtk-doc in configure\n"
1208 "GTK_DOC_CHECK([1.28])\n"
1209 "],[\n"
1210 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1211 "])\n"
1212 msgstr ""
1213 "\n"
1214 "m4_ifdef([GTK_DOC_CHECK], [\n"
1215 "# recommended: set m4 directory\n"
1216 "AC_CONFIG_MACRO_DIR(m4)\n"
1217 "# optional: register gtk-doc in configure\n"
1218 "GTK_DOC_CHECK([1.28])\n"
1219 "],[\n"
1220 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1221 "])\n"
1222
1223 #. (itstool) path: sect2/para
1224 #: C/index.docbook:772
1225 msgid ""
1226 "The above example works, but will require all developers to have gtk-doc "
1227 "installed. A better way is to make building the documentation optional as "
1228 "shown in the next example: <_:example-1/>"
1229 msgstr ""
1230 "El ejemplo anterior funciona, pero requerirá que todos los desarrolladores "
1231 "tengan instalado gtk-doc. Una mejor manera es hacer que la creación de la "
1232 "documentación sea opcional como se muestra en el siguiente ejemplo: <_:"
1233 "example-1/>"
1234
1235 #. (itstool) path: sect2/para
1236 #: C/index.docbook:792
1237 msgid ""
1238 "The first argument is used to check for the Gtk-Doc version at configure "
1239 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1240 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1241 "configure switches:"
1242 msgstr ""
1243 "El primer argumento se utiliza para verificar la versión de Gtk-Doc en el "
1244 "momento de la configuración. El segundo argumento opcional es usado por "
1245 "<application>gtkdocize</application>. La macro <symbol>GTK_DOC_CHECK</"
1246 "symbol> también agrega varios modificadores de configuración:"
1247
1248 #. (itstool) path: listitem/para
1249 #: C/index.docbook:801
1250 msgid "--with-html-dir=PATH : path to installed docs"
1251 msgstr "--with-html-dir=RUTA: ruta a los documentos instalados"
1252
1253 #. (itstool) path: listitem/para
1254 #: C/index.docbook:802
1255 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1256 msgstr ""
1257 "--enable-gtk-doc: usar gtk-doc para construir la documentación "
1258 "[predeterminado=no]"
1259
1260 #. (itstool) path: listitem/para
1261 #: C/index.docbook:803
1262 msgid ""
1263 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1264 msgstr ""
1265 "--enable-gtk-doc: usar gtk-doc para construir la documentación "
1266 "[predeterminado=sí]"
1267
1268 #. (itstool) path: listitem/para
1269 #: C/index.docbook:804
1270 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1271 msgstr ""
1272 "--enable-gtk-doc: usar gtk-doc para construir la documentación "
1273 "[predeterminado=no]"
1274
1275 #. (itstool) path: important/para
1276 #: C/index.docbook:808
1277 msgid ""
1278 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1279 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1280 "Otherwise pregenerated documentation is installed (which makes sense for "
1281 "users but not for developers)."
1282 msgstr ""
1283 "GTK-Doc está desactivado de forma predeterminada. Recuerde pasar la opción "
1284 "<option>«--enable-gtk-doc»</option> en la siguiente ejecución de "
1285 "<filename>configure</filename>. De otra forma, la documentación pregenerada "
1286 "se instala (lo que tiene sentido para usuarios, pero no para "
1287 "desarrolladores)."
1288
1289 #. (itstool) path: sect2/para
1290 #: C/index.docbook:816
1291 msgid ""
1292 "After all changes to <filename>configure.ac</filename> are made, update the "
1293 "<filename>configure</filename> file. This can be done by re-running "
1294 "<code>autogen.sh</code>."
1295 msgstr ""
1296 "Después de hacer los cambios en el <filename>configure.ac</filename> "
1297 "actualice el archivo <filename>configure</filename>. Esto se puede hacer "
1298 "volviendo a ejecutar <code>autogen.sh</code>."
1299
1300 #. (itstool) path: sect2/title
1301 #: C/index.docbook:824
1302 msgid "Integration with autogen"
1303 msgstr "Integración con autogen"
1304
1305 #. (itstool) path: sect2/para
1306 #: C/index.docbook:826
1307 msgid ""
1308 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1309 "the build infrastructure after the project was checked out from a version "
1310 "control system (such as git or svn). GTK-Doc comes with a script called "
1311 "<application>gtkdocize</application> which can be used to copy the necessary "
1312 "files needed by Gtk-Doc to the source directory."
1313 msgstr ""
1314 "La mayoría de los proyectos tendrán un script <filename>autogen.sh</"
1315 "filename> para configurar la infraestructura de compilación después de que "
1316 "el proyecto se haya extraído de un sistema de control de versiones (como git "
1317 "o svn). GTK-Doc viene con un script llamado <application>gtkdocize</"
1318 "application> que puede usarse para copiar los archivos necesarios que "
1319 "necesita Gtk-Doc en la carpeta fuente."
1320
1321 #. (itstool) path: sect2/para
1322 #: C/index.docbook:834
1323 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1324 msgstr "Se debe ejecutar antes de autoreconf, autoheader, automake o autoconf."
1325
1326 #. (itstool) path: example/title
1327 #: C/index.docbook:839
1328 msgid "Running gtkdocize from autogen.sh"
1329 msgstr "Ejecutar gtkdocize desde autogen.sh"
1330
1331 #. (itstool) path: example/programlisting
1332 #: C/index.docbook:840
1333 #, no-wrap
1334 msgid ""
1335 "\n"
1336 "gtkdocize || exit 1\n"
1337 msgstr ""
1338 "\n"
1339 "gtkdocize || exit 1\n"
1340
1341 #. (itstool) path: example/title
1342 #: C/index.docbook:848
1343 msgid "Conditionally run gtkdocize from autogen.sh"
1344 msgstr "Condicionalmente, ejecutar gtkdocize desde autogen.sh"
1345
1346 #. (itstool) path: example/programlisting
1347 #: C/index.docbook:849
1348 #, no-wrap
1349 msgid ""
1350 "\n"
1351 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1352 "if test $? -ne 0; then\n"
1353 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1354 "else\n"
1355 " $GTKDOCIZE || exit 1\n"
1356 "fi\n"
1357 msgstr ""
1358 "\n"
1359 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1360 "if test $? -ne 0; then\n"
1361 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1362 "else\n"
1363 " $GTKDOCIZE || exit 1\n"
1364 "fi\n"
1365
1366 #. (itstool) path: sect2/para
1367 #: C/index.docbook:860
1368 msgid ""
1369 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1370 "doc.make</filename> to your project root (or any directory specified by the "
1371 "<option>--docdir</option> option)."
1372 msgstr ""
1373 "Al ejecutar <filename>gtkdocize</filename> copia <filename>gtk-doc.make</"
1374 "filename> a la raíz de su proyecto (o cualquier carpeta especificada por la "
1375 "opción <option>--docdir</option>)."
1376
1377 #. (itstool) path: sect2/para
1378 #: C/index.docbook:866
1379 msgid ""
1380 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1381 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1382 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1383 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1384 "<function>GTK_DOC_CHECK</function> macro."
1385 msgstr ""
1386 "<application>gtkdocize</application> comprueba su script <filename> "
1387 "configure.ac </filename> para la macro <function> GTK_DOC_CHECK</function>. "
1388 "La macro <function> GTK_DOC_CHECK </function> se puede usar para pasar "
1389 "argumentos adicionales al script <application>gtkdocize</application>. el "
1390 "segundo parámetro en la macro <function>GTK_DOC_CHECK</function>."
1391
1392 #. (itstool) path: sect2/para
1393 #: C/index.docbook:875
1394 msgid ""
1395 "Alternatively, additional arguments can also be passed to "
1396 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1397 "function> environment variable, or by directly specifying them to "
1398 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1399 msgstr ""
1400 "Alternativamente, también se pueden pasar argumentos adicionales a "
1401 "<application>gtkdocize</application> a través de la variable de entorno "
1402 "<function>GTKDOCIZE_FLAGS</function>, o especificándolos directamente a "
1403 "<application>gtkdocize</application> en <filename>autogen.sh</filename>."
1404
1405 #. (itstool) path: sect2/title
1406 #: C/index.docbook:886
1407 msgid "Executing GTK-Doc from the Build System"
1408 msgstr "Ejecutar GTH-Doc desde el sistema de construcción"
1409
1410 #. (itstool) path: sect2/para
1411 #: C/index.docbook:888
1412 msgid ""
1413 "After the previous steps it's time to run the build. First we need to rerun "
1414 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1415 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1416 "<filename>configure</filename> with this option afterwards."
1417 msgstr ""
1418 "Después de los pasos anteriores es hora de ejecutar el constructor. Primero "
1419 "se debe volver a ejecutar <filename>autogen.sh</filename>. Si este script "
1420 "ejecuta configure automáticamente, entonces debe pasar la opción <option>--"
1421 "enable-gtk-doc</option>. De otra forma, ejecute posteriormente "
1422 "<filename>configure</filename> con esta opción."
1423
1424 #. (itstool) path: sect2/para
1425 #: C/index.docbook:895
1426 msgid ""
1427 "The first make run generates several additional files in the doc-"
1428 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1429 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
1430 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1431 msgstr ""
1432 "El primer make genera diversas líneas adicionales en las carpetas de "
1433 "documentación. Las importantes son: <filename>&lt;paquete&gt;.types</"
1434 "filename>, <filename>&lt;paquete&gt;-docs.xml</filename> (.sgml en el "
1435 "pasado), <filename>&lt;paquete&gt;-sections.txt</filename>."
1436
1437 #. (itstool) path: example/title
1438 #: C/index.docbook:903
1439 msgid "Running the doc build"
1440 msgstr "Ejecutar la construcción de la documentación"
1441
1442 #. (itstool) path: example/programlisting
1443 #: C/index.docbook:904
1444 #, no-wrap
1445 msgid ""
1446 "\n"
1447 "./autogen.sh --enable-gtk-doc\n"
1448 "make\n"
1449 msgstr ""
1450 "\n"
1451 "./autogen.sh --enable-gtk-doc\n"
1452 "make\n"
1453
1454 #. (itstool) path: sect2/para
1455 #: C/index.docbook:911
1456 msgid ""
1457 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1458 "index.html</filename>. With this initial setup you will only see a very "
1459 "simple document. The next chapter will teach you how to add API "
1460 "documentation to your code via special comment blocks. The Chapter "
1461 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1462 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1463 "template</link> to add additional chapters and sections to your "
1464 "documentation files."
1465 msgstr ""
1466 "Ahora puede apuntar su navegador a <filename>docs/reference/&lt;package&gt;/"
1467 "index.html</filename>. Con esta configuración inicial, solo verá un "
1468 "documento muy simple. El siguiente capítulo le enseñará cómo agregar "
1469 "documentación API a su código a través de bloques de comentarios especiales. "
1470 "Posteriormente, el Capítulo presenta <link linkend=\"metafiles\">archivos "
1471 "adicionales</link> y muestra cómo editar la plantilla maestra <link linkend="
1472 "\"metafiles_master\"></link> para agregar capítulos y secciones adicionales "
1473 "a sus archivos de documentación."
1474
1475 #. (itstool) path: sect1/title
1476 #: C/index.docbook:927
1477 msgid "Integration with CMake build systems"
1478 msgstr "Integración con sistemas de construcción CMake"
1479
1480 #. (itstool) path: sect1/para
1481 #: C/index.docbook:929
1482 msgid ""
1483 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1484 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1485 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1486 "set in your <filename>CMakeLists.txt</filename> file."
1487 msgstr ""
1488 "Ahroa, GTK-Doc proporciona un módulo <filename>GtkDocConfig.cmake</filename> "
1489 "(y el correspondiente módulo <filename>GtkDocConfigVersion.cmake</"
1490 "filename>). Esto proporciona un comando <literal>gtk_doc_add_module</"
1491 "literal> que puede configurar en su archivo <filename>CMakeLists.txt</"
1492 "filename>."
1493
1494 #. (itstool) path: example/title
1495 #: C/index.docbook:939
1496 msgid "Example of using GTK-Doc from CMake"
1497 msgstr "Ejeplo de uso de GTK-Doc desde CMake"
1498
1499 #. (itstool) path: example/programlisting
1500 #: C/index.docbook:940
1501 #, no-wrap
1502 msgid ""
1503 "\n"
1504 "find_package(GtkDoc 1.25 REQUIRED)\n"
1505 "\n"
1506 "# Create the doc-libmeep target.\n"
1507 "gtk_doc_add_module(\n"
1508 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1509 " XML meep-docs.xml\n"
1510 " LIBRARIES libmeep\n"
1511 ")\n"
1512 "\n"
1513 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1514 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1515 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1516 "\n"
1517 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1518 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1519 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1520 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1521 msgstr ""
1522 "\n"
1523 "find_package(GtkDoc 1.25 REQUIRED)\n"
1524 "\n"
1525 "# Create the doc-libmeep target.\n"
1526 "gtk_doc_add_module(\n"
1527 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1528 " XML meep-docs.xml\n"
1529 " LIBRARIES libmeep\n"
1530 ")\n"
1531 "\n"
1532 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1533 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1534 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1535 "\n"
1536 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1537 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1538 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1539 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1540
1541 #. (itstool) path: sect1/para
1542 #: C/index.docbook:937
1543 msgid "The following example shows how to use this command. <_:example-1/>"
1544 msgstr "El siguiente ejemplo muestra cómo usar este comando. <_:example-1/>"
1545
1546 #. (itstool) path: sect1/title
1547 #: C/index.docbook:964
1548 msgid "Integration with plain makefiles or other build systems"
1549 msgstr "Integración con makefiles u otros sistemas de construcción"
1550
1551 #. (itstool) path: sect1/para
1552 #: C/index.docbook:966
1553 msgid ""
1554 "In the case one does not want to use automake and therefore <filename>gtk-"
1555 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1556 "in own makefiles (or other build tools)."
1557 msgstr ""
1558 "En el caso de que no quiera usar automake y por ello <filename>gtk-doc.mak</"
1559 "filename> deberá llamar a las herramientas gtkdoc en el orden correcto en "
1560 "makefiles propios (o en otras herramientas de construcción)."
1561
1562 #. (itstool) path: example/title
1563 #: C/index.docbook:973
1564 msgid "Documentation build steps"
1565 msgstr "Pasos de construcción de la documentación"
1566
1567 #. (itstool) path: example/programlisting
1568 #: C/index.docbook:974
1569 #, no-wrap
1570 msgid ""
1571 "\n"
1572 "DOC_MODULE=meep\n"
1573 "// sources have changed\n"
1574 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1575 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1576 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1577 "// xml files have changed\n"
1578 "mkdir html\n"
1579 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1580 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1581 msgstr ""
1582 "\n"
1583 "DOC_MODULE=meep\n"
1584 "// sources have changed\n"
1585 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1586 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1587 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1588 "// xml files have changed\n"
1589 "mkdir html\n"
1590 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1591 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1592
1593 #. (itstool) path: sect1/para
1594 #: C/index.docbook:988
1595 msgid ""
1596 "One will need to look at the <filename>Makefile.am</filename> and "
1597 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1598 msgstr ""
1599 "Deberá mirar en el archivo <filename>Makefile.am</filename> y <filename>gtk-"
1600 "doc.mak</filename> para elegir las opciones adicionales necesarias."
1601
1602 #. (itstool) path: sect1/title
1603 #: C/index.docbook:995
1604 msgid "Integration with version control systems"
1605 msgstr "Integración con los sistemas de control de versiones"
1606
1607 #. (itstool) path: sect1/para
1608 #: C/index.docbook:997
1609 msgid ""
1610 "As a rule of thumb, it's the files you edit which should go under version "
1611 "control. For typical projects it's these files: <filename>&lt;package&gt;."
1612 "types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1613 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
1614 "<filename>Makefile.am</filename>."
1615 msgstr ""
1616 "Como regla principal, son los archivos que edita los que deberían estar bajo "
1617 "el control de versiones. Para proyectos típicos son los archivos: "
1618 "<filename>&lt;paquete&gt;.types</filename>, <filename>&lt;paquete&gt;-docs."
1619 "xml</filename> (anteriormente .sgml), <filename>&lt;paquete&gt;-sections."
1620 "txt</filename>, <filename>Makefile.am</filename>."
1621
1622 #. (itstool) path: sect1/para
1623 #: C/index.docbook:1005
1624 msgid ""
1625 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1626 "directories should not go under version control. Neither should any of the "
1627 "<filename>.stamp</filename> files."
1628 msgstr ""
1629 "Los archivos de las carpetas <filename>xml/</filename> y <filename>html/</"
1630 "filename> No deberían estar bajo control de versiones. Tampoco ninguno de "
1631 "los archivos <filename>.stamp</filename>."
1632
1633 #. (itstool) path: chapter/title
1634 #: C/index.docbook:1015
1635 msgid "Documenting the code"
1636 msgstr "Documentar el código"
1637
1638 #. (itstool) path: chapter/para
1639 #: C/index.docbook:1017
1640 msgid ""
1641 "GTK-Doc uses source code comment with a special syntax for code "
1642 "documentation. Further it retrieves information about your project structure "
1643 "from other sources. During the next section you will find all information "
1644 "about the syntax of the comments."
1645 msgstr ""
1646 "GTK-Doc usa código fuente comentado con una sintaxis especial para "
1647 "documentar el código. Además obtiene información acerca de la estructura de "
1648 "su proyecto de otras fuentes. En la siguiente sección encontrará información "
1649 "acerca de la sintaxis de los comentarios."
1650
1651 #. (itstool) path: example/title
1652 #: C/index.docbook:1028 C/index.docbook:1054
1653 msgid "GTK-Doc comment block"
1654 msgstr "Bloque de comentario de GTK-Doc"
1655
1656 #. (itstool) path: example/programlisting
1657 #: C/index.docbook:1029
1658 #, no-wrap
1659 msgid ""
1660 "\n"
1661 "#ifndef __GTK_DOC_IGNORE__\n"
1662 "/* unparseable code here */\n"
1663 "#endif\n"
1664 msgstr ""
1665 "\n"
1666 "#ifndef __GTK_DOC_IGNORE__\n"
1667 "/* unparseable code here */\n"
1668 "#endif\n"
1669
1670 #. (itstool) path: chapter/para
1671 #: C/index.docbook:1024
1672 msgid ""
1673 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1674 "of receiving warnings from the scanner that look like a special case, one "
1675 "can hint GTK-Doc to skip over them. <_:example-1/>"
1676 msgstr ""
1677 "El escáner GTK-Doc puede manejar bien la mayoría de los encabezados C. En el "
1678 "caso de recibir advertencias del escáner que se vean como un caso especial, "
1679 "uno puede indicarle a GTK-Doc que las omita. <_:example-1/>"
1680
1681 #. (itstool) path: note/title
1682 #: C/index.docbook:1038
1683 msgid "Limitations"
1684 msgstr "Limitaciones"
1685
1686 #. (itstool) path: note/para
1687 #: C/index.docbook:1039
1688 msgid ""
1689 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1690 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1691 msgstr ""
1692 "Tenga en cuenta que GTK-Doc soporta <code>#ifndef(__GTK_DOC_IGNORE__)</code> "
1693 "pero <code>#if !defined(__GTK_DOC_IGNORE__)</code> u otras combinaciones."
1694
1695 #. (itstool) path: sect1/title
1696 #: C/index.docbook:1049
1697 msgid "Documentation comments"
1698 msgstr "Comentarios de la documentación"
1699
1700 #. (itstool) path: example/programlisting
1701 #: C/index.docbook:1055
1702 #, no-wrap
1703 msgid ""
1704 "\n"
1705 "/**\n"
1706 " * identifier:\n"
1707 " * documentation ...\n"
1708 " */\n"
1709 msgstr ""
1710 "\n"
1711 "/**\n"
1712 " * identifier:\n"
1713 " * documentation ...\n"
1714 " */\n"
1715
1716 #. (itstool) path: sect1/para
1717 #: C/index.docbook:1051
1718 msgid ""
1719 "A multiline comment that starts with an additional '*' marks a documentation "
1720 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1721 msgstr ""
1722 "Un comentario de varias líneas que comienza con un «*» adicional marca un "
1723 "bloque de documentación que GTK-Doc tools procesarán. <_:example-1/>"
1724
1725 #. (itstool) path: sect1/para
1726 #: C/index.docbook:1064
1727 msgid ""
1728 "The 'identifier' is one line with the name of the item the comment is "
1729 "related to. The syntax differs a little depending on the item. (TODO add "
1730 "table showing identifiers)"
1731 msgstr ""
1732 "El «identificador» es una línea con el nombre del elemento relacionado con "
1733 "el comentario. La sintaxis difiere un poco dependiendo del elemento. (Por "
1734 "hacer: añadir una tabla mostrando los identificadores)"
1735
1736 #. (itstool) path: sect1/para
1737 #: C/index.docbook:1070
1738 msgid ""
1739 "The 'documentation' block is also different for each symbol type. Symbol "
1740 "types that get parameters such as functions or macros have the parameter "
1741 "description first followed by a blank line (just a '*'). Afterwards follows "
1742 "the detailed description. All lines (outside program listings and CDATA "
1743 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1744 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1745 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1746 msgstr ""
1747 "El bloque de «Documentación» también es diferente para cada tipo de símbolo. "
1748 "Los tipos de símbolos que obtienen parámetros tales como funciones o macros, "
1749 "tienen primero las descripciones seguidas por una línea blanca (exactamente "
1750 "un «*»). Después siguen las descripciones detalladas. Todas las líneas "
1751 "(fuera de los programas; listados y CDATA de la secciones) que solo "
1752 "contengan un « *» (asterisco con espacio) se convierten en párrafos. Si no "
1753 "quiere un espaciado de párrafo, cámbielo a un « * » (espacio-asterisco-"
1754 "espacio). Esto es útil para texto preformateado (listados de código)."
1755
1756 #. (itstool) path: listitem/para
1757 #: C/index.docbook:1087
1758 msgid ""
1759 "What it is: The name for a class or function can sometimes be misleading for "
1760 "people coming from a different background."
1761 msgstr ""
1762 "Qué es: el nombre de la clase o la función puede confundir a veces a "
1763 "personas que provengan de otros entornos."
1764
1765 #. (itstool) path: listitem/para
1766 #: C/index.docbook:1093
1767 msgid ""
1768 "What it does: Tell about common uses. Put it in relation with the other API."
1769 msgstr "Qué hace: indique los usos comunes, en relación con las otras API."
1770
1771 #. (itstool) path: tip/para
1772 #: C/index.docbook:1083
1773 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1774 msgstr "Al documentar código, describa dos aspectos: <_:itemizedlist-1/>"
1775
1776 #. (itstool) path: listitem/para
1777 #: C/index.docbook:1108
1778 msgid "Use function() to refer to functions or macros which take arguments."
1779 msgstr ""
1780 "Use función() para referirse a funciones o macros que toman argumentos."
1781
1782 #. (itstool) path: listitem/para
1783 #: C/index.docbook:1113
1784 msgid ""
1785 "Use @param to refer to parameters. Also use this when referring to "
1786 "parameters of other functions, related to the one being described."
1787 msgstr ""
1788 "Use @parámetro para referirse a parámetros. Úselo también al referirse a "
1789 "parámetros de otras funciones, relacionados al que se describe."
1790
1791 #. (itstool) path: listitem/para
1792 #: C/index.docbook:1119
1793 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1794 msgstr "Use %constant para referirse a una constante, ej: %G_TRAVERSE_LEAFS."
1795
1796 #. (itstool) path: listitem/para
1797 #: C/index.docbook:1124
1798 msgid ""
1799 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1800 "macros which don't take arguments."
1801 msgstr ""
1802 "Use #símbolo para referirse a otro tipo de símbolos, como por ejemplo "
1803 "estructuras, enumeraciones y macros que no toman argumentos."
1804
1805 #. (itstool) path: listitem/para
1806 #: C/index.docbook:1130
1807 msgid "Use #Object::signal to refer to a GObject signal."
1808 msgstr "Use #Object::signal para referirse a una señal de GObject."
1809
1810 #. (itstool) path: listitem/para
1811 #: C/index.docbook:1135
1812 msgid "Use #Object:property to refer to a GObject property."
1813 msgstr "Use #Object:property para referirse a una propiedad de GObject."
1814
1815 #. (itstool) path: listitem/para
1816 #: C/index.docbook:1140
1817 msgid ""
1818 "Use #Struct.field to refer to a field inside a structure and #GObjectClass."
1819 "foo_bar() to refer to a vmethod."
1820 msgstr ""
1821 "Use #Struct.field para referirse a un campo dentro de una estructura y "
1822 "#GObjectClass.foo_bar() para referirse a un vmethod."
1823
1824 #. (itstool) path: sect1/para
1825 #: C/index.docbook:1102
1826 msgid ""
1827 "One advantage of hyper-text over plain-text is the ability to have links in "
1828 "the document. Writing the correct markup for a link can be tedious though. "
1829 "GTK-Doc comes to help by providing several useful abbreviations. <_:"
1830 "itemizedlist-1/>"
1831 msgstr ""
1832 "Una ventaja del hipertexto sobre el texto plano es la capacidad de tener "
1833 "enlaces en el documento. Escribir las marcas adecuadas para un enlace puede "
1834 "ser tedioso aunque GTK-Doc le ayuda proporcionando abreviaturas útiles. <_:"
1835 "itemizedlist-1/>"
1836
1837 #. (itstool) path: tip/para
1838 #: C/index.docbook:1149
1839 msgid ""
1840 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1841 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1842 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
1843 "commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
1844 "with a backslash '\\'."
1845 msgstr ""
1846 "Si necesita usar los caracteres especiales «&lt;», «&gt;», «()», «@», «%», o "
1847 "«#» en su documentación sin que GTK-Doc los cambie, puede usar las entidades "
1848 "XML «&amp;lt;», «&amp;gt;», «amp;lpar;», «amp;rpar;», «amp;commat;» «&amp;"
1849 "percnt;» y «&amp;num;» respectivamente o escaparlas con una contrabarra "
1850 "doble «\\»."
1851
1852 #. (itstool) path: sect1/para
1853 #: C/index.docbook:1158
1854 msgid ""
1855 "DocBook can do more than just links. One can also have lists, examples, "
1856 "headings, and images. As of version 1.20, the preferred way is to use a "
1857 "subset of the basic text formatting syntax called <ulink url=\"http://"
1858 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1859 "versions any documentation that includes Markdown will be rendered as is. "
1860 "For example, list items will appear as lines starting with a dash."
1861 msgstr ""
1862 "DocBook puede crear algo más que enlaces. También se pueden tener listas, "
1863 "ejemplos, cabeceras e imágenes. En la versión 1.20, la manera prefefira de "
1864 "hacer esto es usando un subconjunto de la sintaxis básica de formateado de "
1865 "texto llamada <ulink url=\"http://daringfireball.net/projects/markdown/"
1866 "\">Marcado</ulink>. En versiones anteriores de GTK-Doc, cualquier "
1867 "documentación que incluya marcado se renderizará como tal. Por ejemplo, los "
1868 "elementos de una lista aparecerán como líneas que empiezan con un guión."
1869
1870 #. (itstool) path: sect1/para
1871 #: C/index.docbook:1169
1872 msgid ""
1873 "While markdown is now preferred one can mix both. One limitation here is "
1874 "that one can use docbook xml within markdown, but markdown within docbook "
1875 "xml is not supported."
1876 msgstr ""
1877 "Aunque el marcado es el preferido, puede mezclar ambos. Una limitación aquí "
1878 "es que se puede usar docbook xml con marcado, pero el marcado con docbook "
1879 "xml no está soportado."
1880
1881 #. (itstool) path: sect1/para
1882 #: C/index.docbook:1175
1883 msgid ""
1884 "In older GTK-Doc releases, if you need support for additional formatting, "
1885 "you would need to enable the usage of docbook XML tags inside doc-comments "
1886 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1887 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1888 "filename>."
1889 msgstr ""
1890 "En versiones anteriores de GTK-Doc, si necesitaba soporte para formato "
1891 "adicional, necesitaba activar el uso de etiquetas XML dentro de comentarios "
1892 "en la documentación poniendo <option>--xml-mode</option> o <option>--sgml-"
1893 "mode</option> en la variable <symbol>MKDB_OPTIONS</symbol> dentro de "
1894 "<filename>Makefile.am</filename>."
1895
1896 #. (itstool) path: example/title
1897 #: C/index.docbook:1184
1898 msgid "GTK-Doc comment block using Markdown"
1899 msgstr "Bloque de comentario de GTK-Doc usando marcado"
1900
1901 #. (itstool) path: example/programlisting
1902 #: C/index.docbook:1185
1903 #, no-wrap
1904 msgid ""
1905 "\n"
1906 "/**\n"
1907 " * identifier:\n"
1908 " *\n"
1909 " * documentation paragraph ...\n"
1910 " *\n"
1911 " * # Sub Heading #\n"
1912 " *\n"
1913 " * ## Second Sub Heading\n"
1914 " *\n"
1915 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1916 " *\n"
1917 " * more documentation:\n"
1918 " *\n"
1919 " * - list item 1\n"
1920 " *\n"
1921 " * Paragraph inside a list item.\n"
1922 " *\n"
1923 " * - list item 2\n"
1924 " *\n"
1925 " * 1. numbered list item\n"
1926 " *\n"
1927 " * 2. another numbered list item\n"
1928 " *\n"
1929 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1930 " *\n"
1931 " * ![an inline image](plot-result.png)\n"
1932 " *\n"
1933 " * [A link to the heading anchor above][heading-two]\n"
1934 " *\n"
1935 " * A C-language example:\n"
1936 " * |[&lt;!-- language=\"C\" --&gt;\n"
1937 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1938 " * ]|\n"
1939 " */\n"
1940 msgstr ""
1941 "\n"
1942 "/**\n"
1943 " * identifier:\n"
1944 " *\n"
1945 " * documentation paragraph ...\n"
1946 " *\n"
1947 " * # Sub Heading #\n"
1948 " *\n"
1949 " * ## Second Sub Heading\n"
1950 " *\n"
1951 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1952 " *\n"
1953 " * more documentation:\n"
1954 " *\n"
1955 " * - list item 1\n"
1956 " *\n"
1957 " * Paragraph inside a list item.\n"
1958 " *\n"
1959 " * - list item 2\n"
1960 " *\n"
1961 " * 1. numbered list item\n"
1962 " *\n"
1963 " * 2. another numbered list item\n"
1964 " *\n"
1965 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1966 " *\n"
1967 " * ![an inline image](plot-result.png)\n"
1968 " *\n"
1969 " * [A link to the heading anchor above][heading-two]\n"
1970 " *\n"
1971 " * A C-language example:\n"
1972 " * |[&lt;!-- language=\"C\" --&gt;\n"
1973 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1974 " * ]|\n"
1975 " */\n"
1976
1977 #. (itstool) path: sect1/para
1978 #: C/index.docbook:1224
1979 #| msgid ""
1980 #| "More examples of what markdown tags are supported can be found in the "
1981 #| "<ulink url=\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/"
1982 #| "Markdown\">GTK+ Documentation Markdown Syntax Reference</ulink>."
1983 msgid ""
1984 "More examples of what markdown tags are supported can be found in the <ulink "
1985 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1986 "Documentation Markdown Syntax Reference</ulink>."
1987 msgstr ""
1988 "Se pueden encontrar más ejemplos de las etiquetas de marcado soportadas en "
1989 "el <ulink url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/"
1990 "Markdown\">Manual de referencia de sintaxis de marcado de documentación de "
1991 "GTK</ulink>."
1992
1993 #. (itstool) path: tip/para
1994 #: C/index.docbook:1230
1995 msgid ""
1996 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1997 "cannot write documentation for static symbols. Nevertheless it is good to "
1998 "comment those symbols too. This helps other developers to understand your "
1999 "code. Therefore we recommend to comment these using normal comments (without "
2000 "the 2nd '*' in the first line). If later the function needs to be made "
2001 "public, all one needs to do is to add another '*' in the comment block and "
2002 "insert the symbol name at the right place inside the sections file."
2003 msgstr ""
2004 "Como ya se mencionó anteriormente, GTK-Doc es para documentar API públicas. "
2005 "Por lo tanto, no se puede escribir documentación para símbolos estáticos. "
2006 "Sin embargo, también es bueno comentar esos símbolos. Esto ayuda a otros "
2007 "desarrolladores a comprender su código. Por lo tanto, recomendamos "
2008 "comentarlos usando comentarios normales (sin el segundo «*» en la primera "
2009 "línea). Si luego la función necesita hacerse pública, todo lo que se debe "
2010 "hacer es agregar otro «*» en el bloque de comentarios e insertar el nombre "
2011 "del símbolo en el lugar correcto dentro del archivo de secciones."
2012
2013 #. (itstool) path: sect1/title
2014 #: C/index.docbook:1245
2015 msgid "Documenting sections"
2016 msgstr "Documentar secciones"
2017
2018 #. (itstool) path: sect1/para
2019 #: C/index.docbook:1247
2020 msgid ""
2021 "Each section of the documentation contains information about one class or "
2022 "module. To introduce the component one can write a section block. The short "
2023 "description is also used inside the table of contents. All the @fields are "
2024 "optional."
2025 msgstr ""
2026 "Cada sección del documento contiene información acerca de una clase o un "
2027 "módulo. Para introducir el componente puede escribir un bloque de sección. "
2028 "La descripción corta además se usa dentro de la tabla de contenidos. Todos "
2029 "los campos @ son opcionales."
2030
2031 #. (itstool) path: example/title
2032 #: C/index.docbook:1255
2033 msgid "Section comment block"
2034 msgstr "Bloque de comentarios en una sección"
2035
2036 #. (itstool) path: example/programlisting
2037 #: C/index.docbook:1256
2038 #, no-wrap
2039 msgid ""
2040 "\n"
2041 "/**\n"
2042 " * SECTION:meepapp\n"
2043 " * @short_description: the application class\n"
2044 " * @title: Meep application\n"
2045 " * @section_id:\n"
2046 " * @see_also: #MeepSettings\n"
2047 " * @stability: Stable\n"
2048 " * @include: meep/app.h\n"
2049 " * @image: application.png\n"
2050 " *\n"
2051 " * The application class handles ...\n"
2052 " */\n"
2053 msgstr ""
2054 "\n"
2055 "/**\n"
2056 " * SECTION:meepapp\n"
2057 " * @short_description: the application class\n"
2058 " * @title: Meep application\n"
2059 " * @section_id:\n"
2060 " * @see_also: #MeepSettings\n"
2061 " * @stability: Stable\n"
2062 " * @include: meep/app.h\n"
2063 " * @image: application.png\n"
2064 " *\n"
2065 " * The application class handles ...\n"
2066 " */\n"
2067
2068 #. (itstool) path: varlistentry/term
2069 #: C/index.docbook:1275
2070 msgid "SECTION:&lt;name&gt;"
2071 msgstr "SECCIÓN &lt;nombre&gt;"
2072
2073 #. (itstool) path: listitem/para
2074 #: C/index.docbook:1277
2075 msgid ""
2076 "The name links the section documentation to the respective part in the "
2077 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2078 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
2079 "txt</filename> file."
2080 msgstr ""
2081 "El nombre enlaza la sección de la documentación con la parte respectiva en "
2082 "el archivo <filename>&lt;paquete&gt;-sections.txt</filename>. El nombre aquí "
2083 "proporcionado debería coincidir con la etiqueta &lt;ARCHIVO&gt; en el "
2084 "archivo <filename>&lt;paquete&gt;-sections.txt</filename>."
2085
2086 #. (itstool) path: varlistentry/term
2087 #: C/index.docbook:1286
2088 msgid "@short_description"
2089 msgstr "@short_description"
2090
2091 #. (itstool) path: listitem/para
2092 #: C/index.docbook:1288
2093 msgid ""
2094 "A one line description of the section, that later will appear after the "
2095 "links in the TOC and at the top of the section page."
2096 msgstr ""
2097 "Una línea descrita en la sección, que después aparece tras los enlaces en el "
2098 "TOC y en la página de la sección."
2099
2100 #. (itstool) path: varlistentry/term
2101 #: C/index.docbook:1295
2102 msgid "@title"
2103 msgstr "@title"
2104
2105 #. (itstool) path: listitem/para
2106 #: C/index.docbook:1297
2107 msgid ""
2108 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2109 "can be overridden with the @title field."
2110 msgstr ""
2111 "De forma predeterminada el título de la sección es &lt;name&gt; de la "
2112 "declaración SECTION. Se puede sobrescribir con el campo @title."
2113
2114 #. (itstool) path: varlistentry/term
2115 #: C/index.docbook:1304
2116 msgid "@section_id"
2117 msgstr "@section_id"
2118
2119 #. (itstool) path: listitem/para
2120 #: C/index.docbook:1306
2121 msgid ""
2122 "Overrides the use of title as a section identifier. For GObjects the &lt;"
2123 "title&gt; is used as a section_id and for other sections it is &lt;"
2124 "MODULE&gt;-&lt;title&gt;."
2125 msgstr ""
2126 "Sobrescribe el uso del título como el identificador de sección. &lt;"
2127 "title&gt; se usa en GObjects como el identificador de sección (section_id) y "
2128 "para otra sección es &lt;MÓDULO&gt;-&lt;title&gt;."
2129
2130 #. (itstool) path: varlistentry/term
2131 #: C/index.docbook:1314
2132 msgid "@see_also"
2133 msgstr "@see_also"
2134
2135 #. (itstool) path: listitem/para
2136 #: C/index.docbook:1316
2137 msgid "A list of symbols that are related to this section."
2138 msgstr "Una lista de símbolos relacionados con esta sección."
2139
2140 #. (itstool) path: varlistentry/term
2141 #: C/index.docbook:1322
2142 msgid "@stability"
2143 msgstr "@stability"
2144
2145 #. (itstool) path: listitem/para
2146 #: C/index.docbook:1329
2147 msgid ""
2148 "Stable - The intention of a Stable interface is to enable arbitrary third "
2149 "parties to develop applications to these interfaces, release them, and have "
2150 "confidence that they will run on all minor releases of the product (after "
2151 "the one in which the interface was introduced, and within the same major "
2152 "release). Even at a major release, incompatible changes are expected to be "
2153 "rare, and to have strong justifications."
2154 msgstr ""
2155 "Estable: La intención de una interfaz estable es la de permitir que terceras "
2156 "partes arbitrarias desarrollen aplicaciones para esas interfaces, las "
2157 "liberen, y confíen que que se podrán ejecutar en todas las publicaciones "
2158 "menores del producto (después de que se introdujese la interfaz en una de "
2159 "ellas, y dentro de la misma versión principal de la publicación). Incluso en "
2160 "publicaciones importantes no se espera que existan cambios incompatibles, y "
2161 "de haberlos habrá buenas razones para ello."
2162
2163 #. (itstool) path: listitem/para
2164 #: C/index.docbook:1341
2165 msgid ""
2166 "Unstable - Unstable interfaces are experimental or transitional. They are "
2167 "typically used to give outside developers early access to new or rapidly "
2168 "changing technology, or to provide an interim solution to a problem where a "
2169 "more general solution is anticipated. No claims are made about either source "
2170 "or binary compatibility from one minor release to the next."
2171 msgstr ""
2172 "Inestable: Las interfaces inestables son experimentales o de transición. "
2173 "Generalmente se usan para dar a los desarrolladores externos acceso a "
2174 "tecnología nueva o cambiante, o para proporcionar una solución a un "
2175 "problema, anticipándose a una solución más general. No se realizan "
2176 "reclamaciones acerca de la compatibilidad del código o del binario desde una "
2177 "publicación menor a la siguiente."
2178
2179 #. (itstool) path: listitem/para
2180 #: C/index.docbook:1353
2181 msgid ""
2182 "Private - An interface that can be used within the GNOME stack itself, but "
2183 "that is not documented for end-users. Such functions should only be used in "
2184 "specified and documented ways."
2185 msgstr ""
2186 "Privada: Una interfaz que se puede usar en la pila de GNOME en si misma, "
2187 "pero que no está documentada para usuarios finales. Tales funciones sólo se "
2188 "deberían usar de formas especificadas y documentadas."
2189
2190 #. (itstool) path: listitem/para
2191 #: C/index.docbook:1362
2192 msgid ""
2193 "Internal - An interface that is internal to a module and does not require "
2194 "end-user documentation. Functions that are undocumented are assumed to be "
2195 "Internal."
2196 msgstr ""
2197 "Interna: Una interfaz que es interna a un módulo y no requiere documentación "
2198 "para el usuario final. Se asume que las funciones que están sin documentar "
2199 "son internas."
2200
2201 #. (itstool) path: listitem/para
2202 #: C/index.docbook:1324
2203 msgid ""
2204 "An informal description of the stability level this API has. We recommend "
2205 "the use of one of these terms: <_:itemizedlist-1/>"
2206 msgstr ""
2207 "Esta API tiene una descripción informal del nivel de estabilidad. Se "
2208 "recomienda el uso de uno de estos términos: <_:itemizedlist-1/>"
2209
2210 #. (itstool) path: varlistentry/term
2211 #: C/index.docbook:1374
2212 msgid "@include"
2213 msgstr "@include"
2214
2215 #. (itstool) path: listitem/para
2216 #: C/index.docbook:1376
2217 msgid ""
2218 "The <literal>#include</literal> files to show in the section synopsis (a "
2219 "comma separated list), overriding the global value from the <link linkend="
2220 "\"metafiles_sections\">section file</link> or command line. This item is "
2221 "optional."
2222 msgstr ""
2223 "Los archivos <literal>#include</literal> para mostrar en la sección del "
2224 "resumen (una lista separada por comas), sobrescribiendo el valor global del "
2225 "<link linkend=\"metafiles_sections\">archivo de secciones</link> o de la "
2226 "línea de comandos. Este elemento es opcional."
2227
2228 #. (itstool) path: varlistentry/term
2229 #: C/index.docbook:1385
2230 msgid "@image"
2231 msgstr "@image"
2232
2233 #. (itstool) path: listitem/para
2234 #: C/index.docbook:1387
2235 msgid ""
2236 "The image to display at the top of the reference page for this section. This "
2237 "will often be some sort of a diagram to illustrate the visual appearance of "
2238 "a class or a diagram of its relationship to other classes. This item is "
2239 "optional."
2240 msgstr ""
2241 "La imagen para mostrar en la parte superior de la página de referencia, para "
2242 "esta sección. Generalmente será un tipo de diagrama para ilustrar la "
2243 "apariencia visual de una clase o diagrama de su relación con otras clases. "
2244 "Este elemento es opcional."
2245
2246 #. (itstool) path: tip/para
2247 #: C/index.docbook:1398
2248 msgid ""
2249 "To avoid unnecessary recompilation after doc-changes put the section docs "
2250 "into the c-source where possible."
2251 msgstr ""
2252 "Para evitar recompilaciones innecesarias después de cambios en la "
2253 "documentación ponga los documentos de sección en el código fuente C cuando "
2254 "sea posible."
2255
2256 #. (itstool) path: sect1/title
2257 #: C/index.docbook:1407
2258 msgid "Documenting symbols"
2259 msgstr "Documentar símbolos"
2260
2261 #. (itstool) path: sect1/para
2262 #: C/index.docbook:1409
2263 msgid ""
2264 "Each symbol (function, macro, struct, enum, signal and property) is "
2265 "documented in a separate block. The block is best placed close to the "
2266 "definition of the symbols so that it is easy to keep them in sync. Thus "
2267 "functions are usually documented in the c-source and macros, structs and "
2268 "enums in the header file."
2269 msgstr ""
2270 "Cada símbolo (función, macro, estructura, enum, señal y propiedad) está "
2271 "documentado en un bloque separado. La mejor posición para el bloque es junto "
2272 "a la definición del símbolo de tal forma que sea fácil mantenerlos "
2273 "sincronizados. Por ello las funciones generalmente se documentan en el "
2274 "código C y las macros, estructuras y enum en el archivo de cabecera."
2275
2276 #. (itstool) path: sect2/title
2277 #. (itstool) path: example/title
2278 #: C/index.docbook:1417 C/index.docbook:1483
2279 msgid "General tags"
2280 msgstr "Etiquetas generales"
2281
2282 #. (itstool) path: sect2/para
2283 #: C/index.docbook:1419
2284 msgid ""
2285 "You can add versioning information to all documentation elements to tell "
2286 "when an API was introduced, or when it was deprecated."
2287 msgstr ""
2288 "Puede añadir información de versiones a todos los elementos de la "
2289 "documentación para mostrar cuándo se introdujo una API o cuándo se declaró "
2290 "obsoleta."
2291
2292 #. (itstool) path: variablelist/title
2293 #: C/index.docbook:1424
2294 msgid "Versioning Tags"
2295 msgstr "Versionado de etiquetas"
2296
2297 #. (itstool) path: varlistentry/term
2298 #: C/index.docbook:1425
2299 msgid "Since:"
2300 msgstr "Desde:"
2301
2302 #. (itstool) path: listitem/para
2303 #: C/index.docbook:1427
2304 msgid "Description since which version of the code the API is available."
2305 msgstr "Descripción desde qué versión del código está disponible la API."
2306
2307 #. (itstool) path: varlistentry/term
2308 #: C/index.docbook:1432
2309 msgid "Deprecated:"
2310 msgstr "Obsoleto:"
2311
2312 #. (itstool) path: listitem/para
2313 #: C/index.docbook:1434
2314 msgid ""
2315 "Paragraph denoting that this function should no be used anymore. The "
2316 "description should point the reader to the new API."
2317 msgstr ""
2318 "Párrafo que denota que esta función no se debería usar más. La descripción "
2319 "debería informar al lector de la nueva API."
2320
2321 #. (itstool) path: sect2/para
2322 #: C/index.docbook:1442
2323 msgid ""
2324 "You can also add stability information to all documentation elements to "
2325 "indicate whether API stability is guaranteed for them for all future minor "
2326 "releases of the project."
2327 msgstr ""
2328 "También puede añadir información de estabilidad a todos los elementos de la "
2329 "documentación para indicar si la se garantiza la estabilidad de la API en "
2330 "todas las versiones menores futuras del proyecto."
2331
2332 #. (itstool) path: sect2/para
2333 #: C/index.docbook:1448
2334 msgid ""
2335 "The default stability level for all documentation elements can be set by "
2336 "passing the <option>--default-stability</option> argument to "
2337 "<application>gtkdoc-mkdb</application> with one of the values below."
2338 msgstr ""
2339 "El nivel de estabilidad predeterminado para todos los elementos de la "
2340 "documentación se puede establecer pasando el argumento <option>--default-"
2341 "stability</option> a <application>gtkdoc-mkdb</application> con uno de los "
2342 "siguientes valores."
2343
2344 #. (itstool) path: variablelist/title
2345 #: C/index.docbook:1454
2346 msgid "Stability Tags"
2347 msgstr "Etiquetas de estabilidad"
2348
2349 #. (itstool) path: varlistentry/term
2350 #: C/index.docbook:1455
2351 msgid "Stability: Stable"
2352 msgstr "Estabilidad: estable"
2353
2354 #. (itstool) path: listitem/para
2355 #: C/index.docbook:1457
2356 msgid ""
2357 "Mark the element as stable. This is for public APIs which are guaranteed to "
2358 "remain stable for all future minor releases of the project."
2359 msgstr ""
2360 "Marcar el elemento como estable. Esto es para API públicas que está "
2361 "garantizado que serán estables para todas las versiones menores futuras del "
2362 "proyecto."
2363
2364 #. (itstool) path: varlistentry/term
2365 #: C/index.docbook:1464
2366 msgid "Stability: Unstable"
2367 msgstr "Estabilidad: inestable"
2368
2369 #. (itstool) path: listitem/para
2370 #: C/index.docbook:1466
2371 msgid ""
2372 "Mark the element as unstable. This is for public APIs which are released as "
2373 "a preview before being stabilised."
2374 msgstr ""
2375 "Marcar el elemento como inestable. Esto es para las API públicas que se "
2376 "publican como versión previa antes de estabilizarse."
2377
2378 #. (itstool) path: varlistentry/term
2379 #: C/index.docbook:1472
2380 msgid "Stability: Private"
2381 msgstr "Estabilidad: privado"
2382
2383 #. (itstool) path: listitem/para
2384 #: C/index.docbook:1474
2385 msgid ""
2386 "Mark the element as private. This is for interfaces which can be used by "
2387 "tightly coupled modules, but not by arbitrary third parties."
2388 msgstr ""
2389 "Marcar el elemento como privado. Esto es para interfaces que se pueden usar "
2390 "en módulos fuertemente acoplados, pero no en terceras partes aleatorias."
2391
2392 #. (itstool) path: example/programlisting
2393 #: C/index.docbook:1484
2394 #, no-wrap
2395 msgid ""
2396 "\n"
2397 "/**\n"
2398 " * foo_get_bar:\n"
2399 " * @foo: some foo\n"
2400 " *\n"
2401 " * Retrieves @foo's bar.\n"
2402 " *\n"
2403 " * Returns: @foo's bar\n"
2404 " *\n"
2405 " * Since: 2.6\n"
2406 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2407 " */\n"
2408 "Bar *\n"
2409 "foo_get_bar(Foo *foo)\n"
2410 "{\n"
2411 "...\n"
2412 msgstr ""
2413 "\n"
2414 "/**\n"
2415 " * foo_get_bar:\n"
2416 " * @foo: some foo\n"
2417 " *\n"
2418 " * Retrieves @foo's bar.\n"
2419 " *\n"
2420 " * Returns: @foo's bar\n"
2421 " *\n"
2422 " * Since: 2.6\n"
2423 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2424 " */\n"
2425 "Bar *\n"
2426 "foo_get_bar(Foo *foo)\n"
2427 "{\n"
2428 "...\n"
2429
2430 #. (itstool) path: sect2/title
2431 #. (itstool) path: example/title
2432 #: C/index.docbook:1504 C/index.docbook:1514
2433 msgid "Annotations"
2434 msgstr "Anotaciones"
2435
2436 #. (itstool) path: sect2/para
2437 #: C/index.docbook:1506
2438 msgid ""
2439 "Documentation blocks can contain annotation-tags. These tags will be "
2440 "rendered with tooltips describing their meaning. The tags are used by "
2441 "gobject-introspection to generate language bindings. A detailed list of the "
2442 "supported tags can be found on <ulink url=\"http://live.gnome.org/"
2443 "GObjectIntrospection/Annotations\" type=\"http\">the wiki</ulink>."
2444 msgstr ""
2445 "Los bloques de documentación pueden contener etiquetas de anotaciones. Estas "
2446 "etiquetas se renderizarán con consejos que describan su significado. Las "
2447 "etiquetas se usan en la introspección de GObject para generar vinculaciones "
2448 "del lenguaje. Puede obtener una lista detallada de las etiquetas soportadas "
2449 "en <ulink url=\"http://live.gnome.org/GObjectIntrospection/Annotations\" "
2450 "type=\"http\">el wiki</ulink>."
2451
2452 #. (itstool) path: example/programlisting
2453 #: C/index.docbook:1515
2454 #, no-wrap
2455 msgid ""
2456 "\n"
2457 "/**\n"
2458 " * foo_get_bar: (annotation)\n"
2459 " * @foo: (annotation): some foo\n"
2460 " *\n"
2461 " * Retrieves @foo's bar.\n"
2462 " *\n"
2463 " * Returns: (annotation): @foo's bar\n"
2464 " */\n"
2465 "...\n"
2466 "/**\n"
2467 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2468 " * (and another annotation)\n"
2469 " * @foo: (annotation) (another annotation): some foo\n"
2470 " *\n"
2471 " * Sets bar on @foo.\n"
2472 " */\n"
2473 msgstr ""
2474 "\n"
2475 "/**\n"
2476 " * foo_get_bar: (annotation)\n"
2477 " * @foo: (annotation): some foo\n"
2478 " *\n"
2479 " * Retrieves @foo's bar.\n"
2480 " *\n"
2481 " * Returns: (annotation): @foo's bar\n"
2482 " */\n"
2483 "...\n"
2484 "/**\n"
2485 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2486 " * (and another annotation)\n"
2487 " * @foo: (annotation) (another annotation): some foo\n"
2488 " *\n"
2489 " * Sets bar on @foo.\n"
2490 " */\n"
2491
2492 #. (itstool) path: sect2/title
2493 #. (itstool) path: example/title
2494 #: C/index.docbook:1536 C/index.docbook:1565
2495 msgid "Function comment block"
2496 msgstr "Bloque de comentario de función"
2497
2498 #. (itstool) path: listitem/para
2499 #: C/index.docbook:1542
2500 msgid ""
2501 "Document whether returned objects, lists, strings, etc, should be freed/"
2502 "unrefed/released."
2503 msgstr ""
2504 "El documento, dependiendo de si devuelve objetos, listas, cadenas, etc. "
2505 "debería liberarse/desreferenciarse/etc."
2506
2507 #. (itstool) path: listitem/para
2508 #: C/index.docbook:1548
2509 msgid "Document whether parameters can be NULL, and what happens if they are."
2510 msgstr ""
2511 "El documento, dependiendo de si sus parámetros pueden ser nulos, y qué "
2512 "sucede si lo son."
2513
2514 #. (itstool) path: listitem/para
2515 #: C/index.docbook:1553
2516 msgid ""
2517 "Mention interesting pre-conditions and post-conditions where appropriate."
2518 msgstr ""
2519 "Mencionar precondiciones y postcondiciones interesantes donde sea apropiado."
2520
2521 #. (itstool) path: sect2/para
2522 #: C/index.docbook:1538 C/index.docbook:1624
2523 msgid "Please remember to: <_:itemizedlist-1/>"
2524 msgstr "Recuerde: <_:itemizedlist-1/>"
2525
2526 #. (itstool) path: sect2/para
2527 #: C/index.docbook:1560
2528 msgid ""
2529 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2530 "private. They are treated like static functions."
2531 msgstr ""
2532 "GTK-Doc asume que todos los símbolos (macros, funciones) que empiezan por "
2533 "«_» son privados. Se tratan como funciones estáticas."
2534
2535 #. (itstool) path: example/programlisting
2536 #: C/index.docbook:1566
2537 #, no-wrap
2538 msgid ""
2539 "\n"
2540 "/**\n"
2541 " * function_name:\n"
2542 " * @par1: description of parameter 1. These can extend over more than\n"
2543 " * one line.\n"
2544 " * @par2: description of parameter 2\n"
2545 " * @...: a %NULL-terminated list of bars\n"
2546 " *\n"
2547 " * The function description goes here. You can use @par1 to refer to parameters\n"
2548 " * so that they are highlighted in the output. You can also use %constant\n"
2549 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2550 " * other declarations (which may be documented elsewhere).\n"
2551 " *\n"
2552 " * Returns: an integer.\n"
2553 " *\n"
2554 " * Since: 2.2\n"
2555 " * Deprecated: 2.18: Use other_function() instead.\n"
2556 " */\n"
2557 msgstr ""
2558 "\n"
2559 "/**\n"
2560 " * function_name:\n"
2561 " * @par1: description of parameter 1. These can extend over more than\n"
2562 " * one line.\n"
2563 " * @par2: description of parameter 2\n"
2564 " * @...: a %NULL-terminated list of bars\n"
2565 " *\n"
2566 " * The function description goes here. You can use @par1 to refer to parameters\n"
2567 " * so that they are highlighted in the output. You can also use %constant\n"
2568 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2569 " * other declarations (which may be documented elsewhere).\n"
2570 " *\n"
2571 " * Returns: an integer.\n"
2572 " *\n"
2573 " * Since: 2.2\n"
2574 " * Deprecated: 2.18: Use other_function() instead.\n"
2575 " */\n"
2576
2577 #. (itstool) path: variablelist/title
2578 #: C/index.docbook:1587
2579 msgid "Function tags"
2580 msgstr "Etiquetas de funciones"
2581
2582 #. (itstool) path: varlistentry/term
2583 #: C/index.docbook:1588 C/index.docbook:1795
2584 msgid "Returns:"
2585 msgstr "Devuelve:"
2586
2587 #. (itstool) path: listitem/para
2588 #: C/index.docbook:1590
2589 msgid "Paragraph describing the returned result."
2590 msgstr "Párrafo que describe el resultado devuelto."
2591
2592 #. (itstool) path: varlistentry/term
2593 #: C/index.docbook:1595
2594 msgid "@...:"
2595 msgstr "@...:"
2596
2597 #. (itstool) path: listitem/para
2598 #: C/index.docbook:1597
2599 msgid ""
2600 "In case the function has variadic arguments, you should use this tag "
2601 "(@Varargs: does also work for historic reasons)."
2602 msgstr ""
2603 "En el caso de que la función tenga argumentos variados debe usar esta "
2604 "etiqueta (@Vargargs: también funciona por razones históricas)."
2605
2606 #. (itstool) path: sect2/title
2607 #. (itstool) path: example/title
2608 #: C/index.docbook:1607 C/index.docbook:1609
2609 msgid "Property comment block"
2610 msgstr "Bloque de comentario de propiedad"
2611
2612 #. (itstool) path: example/programlisting
2613 #: C/index.docbook:1610
2614 #, no-wrap
2615 msgid ""
2616 "\n"
2617 "/**\n"
2618 " * SomeWidget:some-property:\n"
2619 " *\n"
2620 " * Here you can document a property.\n"
2621 " */\n"
2622 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2623 msgstr ""
2624 "\n"
2625 "/**\n"
2626 " * SomeWidget:some-property:\n"
2627 " *\n"
2628 " * Here you can document a property.\n"
2629 " */\n"
2630 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2631
2632 #. (itstool) path: sect2/title
2633 #. (itstool) path: example/title
2634 #: C/index.docbook:1622 C/index.docbook:1641
2635 msgid "Signal comment block"
2636 msgstr "Bloque de comentario de señal"
2637
2638 #. (itstool) path: listitem/para
2639 #: C/index.docbook:1628
2640 msgid ""
2641 "Document when the signal is emitted and whether it is emitted before or "
2642 "after other signals."
2643 msgstr ""
2644 "Documentar cuando la señal se emite e indica si se emite antes o después de "
2645 "otras señales."
2646
2647 #. (itstool) path: listitem/para
2648 #: C/index.docbook:1634
2649 msgid "Document what an application might do in the signal handler."
2650 msgstr "Documentar qué aplicación debe gestionar las señales."
2651
2652 #. (itstool) path: example/programlisting
2653 #: C/index.docbook:1642
2654 #, no-wrap
2655 msgid ""
2656 "\n"
2657 "/**\n"
2658 " * FooWidget::foobarized:\n"
2659 " * @widget: the widget that received the signal\n"
2660 " * @foo: some foo\n"
2661 " * @bar: some bar\n"
2662 " *\n"
2663 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2664 " */\n"
2665 "foo_signals[FOOBARIZED] =\n"
2666 " g_signal_new (\"foobarized\",\n"
2667 " ...\n"
2668 msgstr ""
2669 "\n"
2670 "/**\n"
2671 " * FooWidget::foobarized:\n"
2672 " * @widget: the widget that received the signal\n"
2673 " * @foo: some foo\n"
2674 " * @bar: some bar\n"
2675 " *\n"
2676 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2677 " */\n"
2678 "foo_signals[FOOBARIZED] =\n"
2679 " g_signal_new (\"foobarized\",\n"
2680 " ...\n"
2681
2682 #. (itstool) path: sect2/title
2683 #. (itstool) path: example/title
2684 #: C/index.docbook:1659 C/index.docbook:1660
2685 msgid "Struct comment block"
2686 msgstr "Bloque de comentario de estructura"
2687
2688 #. (itstool) path: example/programlisting
2689 #: C/index.docbook:1661
2690 #, no-wrap
2691 msgid ""
2692 "\n"
2693 "/**\n"
2694 " * FooWidget:\n"
2695 " * @bar: some #gboolean\n"
2696 " *\n"
2697 " * This is the best widget, ever.\n"
2698 " */\n"
2699 "typedef struct _FooWidget {\n"
2700 " GtkWidget parent_instance;\n"
2701 "\n"
2702 " gboolean bar;\n"
2703 "} FooWidget;\n"
2704 msgstr ""
2705 "\n"
2706 "/**\n"
2707 " * FooWidget:\n"
2708 " * @bar: some #gboolean\n"
2709 " *\n"
2710 " * This is the best widget, ever.\n"
2711 " */\n"
2712 "typedef struct _FooWidget {\n"
2713 " GtkWidget parent_instance;\n"
2714 "\n"
2715 " gboolean bar;\n"
2716 "} FooWidget;\n"
2717
2718 #. (itstool) path: sect2/para
2719 #: C/index.docbook:1676
2720 msgid ""
2721 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2722 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2723 "behaviour."
2724 msgstr ""
2725 "Use <code>/*&lt; private &gt;*/</code> antes de campos de estructuras "
2726 "privadas que quiera ocultar. Use <code>/*&lt; public &gt;*/</code> para "
2727 "revertir el comportamiento anterior."
2728
2729 #. (itstool) path: sect2/para
2730 #: C/index.docbook:1682
2731 msgid ""
2732 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2733 "it will be considered private automatically and doesn't need to be mentioned "
2734 "in the comment block."
2735 msgstr ""
2736 "Si el primer campo es «g_iface», «parent_instance» o «parent_class» se "
2737 "considerará como privado automáticamente y no necesita mencionarse en el "
2738 "bloque de comentario."
2739
2740 #. (itstool) path: sect2/para
2741 #: C/index.docbook:1688
2742 msgid ""
2743 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2744 "is usually a good idea to add a comment block for a class, if it has "
2745 "vmethods (as this is how they can be documented). For the GObject itself one "
2746 "can use the related section docs, having a separate block for the instance "
2747 "struct would be useful if the instance has public fields. One disadvantage "
2748 "here is that this creates two index entries of the same name (the structure "
2749 "and the section)."
2750 msgstr ""
2751 "También se pueden usar bloques de comentario para GObjects y GObjectClasses. "
2752 "Generalmente es buena idea añadir un bloque de comentario para una clase, si "
2753 "tiene «vmethods» (ya que así se pueden documentar). Para el GObject en si, "
2754 "se puede usar la sección relativa a la documentación, tener un bloque "
2755 "separado para la estructura de la instancia sería útil si la instancia tiene "
2756 "campos públicos. Una desventaja aquí es que esto crea dos entradas de índice "
2757 "con el mismo nombre (la estructura y la sección)."
2758
2759 #. (itstool) path: sect2/title
2760 #. (itstool) path: example/title
2761 #: C/index.docbook:1700 C/index.docbook:1701
2762 msgid "Enum comment block"
2763 msgstr "Enumerar bloques de comentarios"
2764
2765 #. (itstool) path: example/programlisting
2766 #: C/index.docbook:1702
2767 #, no-wrap
2768 msgid ""
2769 "\n"
2770 "/**\n"
2771 " * Something:\n"
2772 " * @SOMETHING_FOO: something foo\n"
2773 " * @SOMETHING_BAR: something bar\n"
2774 " *\n"
2775 " * Enum values used for the thing, to specify the thing.\n"
2776 " */\n"
2777 "typedef enum {\n"
2778 " SOMETHING_FOO,\n"
2779 " SOMETHING_BAR,\n"
2780 " /*&lt; private &gt;*/\n"
2781 " SOMETHING_COUNT\n"
2782 "} Something;\n"
2783 msgstr ""
2784 "\n"
2785 "/**\n"
2786 " * Something:\n"
2787 " * @SOMETHING_FOO: something foo\n"
2788 " * @SOMETHING_BAR: something bar\n"
2789 " *\n"
2790 " * Enum values used for the thing, to specify the thing.\n"
2791 " */\n"
2792 "typedef enum {\n"
2793 " SOMETHING_FOO,\n"
2794 " SOMETHING_BAR,\n"
2795 " /*&lt; private &gt;*/\n"
2796 " SOMETHING_COUNT\n"
2797 "} Something;\n"
2798
2799 #. (itstool) path: sect2/para
2800 #: C/index.docbook:1719
2801 msgid ""
2802 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2803 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2804 "behaviour."
2805 msgstr ""
2806 "Use <code>/*&lt; private &gt;*/</code> antes de enumerar valores privados "
2807 "que quiera ocultar. Use <code>/*&lt; public &gt;*/</code> para revertir el "
2808 "comportamiento anterior."
2809
2810 #. (itstool) path: sect1/title
2811 #: C/index.docbook:1730
2812 msgid "Inline program documentation"
2813 msgstr "Documentación en línea del programa"
2814
2815 #. (itstool) path: sect1/para
2816 #: C/index.docbook:1731
2817 msgid ""
2818 "You can document programs and their commandline interface using inline "
2819 "documentation."
2820 msgstr ""
2821 "Puede documentar programas y su interfaz de línea de comandos usando la "
2822 "documentación en línea."
2823
2824 #. (itstool) path: variablelist/title
2825 #: C/index.docbook:1737
2826 msgid "Tags"
2827 msgstr "Etiquetas"
2828
2829 #. (itstool) path: varlistentry/term
2830 #: C/index.docbook:1739
2831 msgid "PROGRAM"
2832 msgstr "PROGRAM"
2833
2834 #. (itstool) path: listitem/para
2835 #: C/index.docbook:1742
2836 msgid "Defines the start of a program documentation."
2837 msgstr "Define el inicio de la documentación de un programa."
2838
2839 #. (itstool) path: varlistentry/term
2840 #: C/index.docbook:1749
2841 msgid "@short_description:"
2842 msgstr "@short_description:"
2843
2844 #. (itstool) path: listitem/para
2845 #: C/index.docbook:1751
2846 msgid "Defines a short description of the program. (Optional)"
2847 msgstr "Define una descripción corta del programa. (Opcional)"
2848
2849 #. (itstool) path: varlistentry/term
2850 #: C/index.docbook:1758
2851 msgid "@synopsis:"
2852 msgstr "@synopsis:"
2853
2854 #. (itstool) path: listitem/para
2855 #: C/index.docbook:1760
2856 msgid ""
2857 "Defines the arguments, or list of arguments that the program can take. "
2858 "(Optional)"
2859 msgstr ""
2860 "Define el argumento o la lista de argumentos que el programa puede usar. "
2861 "(Opcional)"
2862
2863 #. (itstool) path: varlistentry/term
2864 #: C/index.docbook:1768
2865 msgid "@see_also:"
2866 msgstr "@see_also:"
2867
2868 #. (itstool) path: listitem/para
2869 #: C/index.docbook:1770
2870 msgid "See Also manual page section. (Optional)"
2871 msgstr "Página del manual Ver también. (Opcional)"
2872
2873 #. (itstool) path: varlistentry/term
2874 #: C/index.docbook:1777
2875 msgid "@arg:"
2876 msgstr "@arg:"
2877
2878 #. (itstool) path: listitem/para
2879 #: C/index.docbook:1779
2880 msgid "Argument(s) passed to the program and their description. (Optional)"
2881 msgstr "Argumentos pasados al programa y su descripción. (Opcional)"
2882
2883 #. (itstool) path: varlistentry/term
2884 #: C/index.docbook:1786
2885 msgid "Description:"
2886 msgstr "Description:"
2887
2888 #. (itstool) path: listitem/para
2889 #: C/index.docbook:1788
2890 msgid "A longer description of the program."
2891 msgstr "Una descripción más larga del programa."
2892
2893 #. (itstool) path: listitem/para
2894 #: C/index.docbook:1797
2895 msgid "Specify what value(s) the program returns. (Optional)"
2896 msgstr "Especifique qué valores devuelve el programa. (Opcional)"
2897
2898 #. (itstool) path: sect2/title
2899 #: C/index.docbook:1806
2900 msgid "Example of program documentation."
2901 msgstr "Ejemplo de documentación de un programa."
2902
2903 #. (itstool) path: example/title
2904 #: C/index.docbook:1807
2905 msgid "Program documentation block"
2906 msgstr "Bloque de documentación del programa"
2907
2908 #. (itstool) path: example/programlisting
2909 #: C/index.docbook:1808
2910 #, no-wrap
2911 msgid ""
2912 "\n"
2913 "/**\n"
2914 " * PROGRAM:test-program\n"
2915 " * @short_description: A test program\n"
2916 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2917 " * @see_also: test(1)\n"
2918 " * @--arg1 *arg*: set arg1 to *arg*\n"
2919 " * @--arg2 *arg*: set arg2 to *arg*\n"
2920 " * @-v, --version: Print the version number\n"
2921 " * @-h, --help: Print the help message\n"
2922 " *\n"
2923 " * Long description of program.\n"
2924 " *\n"
2925 " * Returns: Zero on success, non-zero on failure\n"
2926 " */\n"
2927 "int main(int argc, char *argv[])\n"
2928 "{\n"
2929 "\treturn 0;\n"
2930 "}\n"
2931 msgstr ""
2932 "\n"
2933 "/**\n"
2934 " * PROGRAM:test-program\n"
2935 " * @short_description: A test program\n"
2936 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2937 " * @see_also: test(1)\n"
2938 " * @--arg1 *arg*: set arg1 to *arg*\n"
2939 " * @--arg2 *arg*: set arg2 to *arg*\n"
2940 " * @-v, --version: Print the version number\n"
2941 " * @-h, --help: Print the help message\n"
2942 " *\n"
2943 " * Long description of program.\n"
2944 " *\n"
2945 " * Returns: Zero on success, non-zero on failure\n"
2946 " */\n"
2947 "int main(int argc, char *argv[])\n"
2948 "{\n"
2949 "\treturn 0;\n"
2950 "}\n"
2951
2952 #. (itstool) path: sect1/title
2953 #: C/index.docbook:1834
2954 msgid "Useful DocBook tags"
2955 msgstr "Etiquetas DocBook útiles"
2956
2957 #. (itstool) path: sect1/para
2958 #: C/index.docbook:1836
2959 msgid ""
2960 "Here are some DocBook tags which are most useful when documenting the code."
2961 msgstr ""
2962 "Aquí están varias etiquetas de DocBook muy útiles al documentar código."
2963
2964 #. (itstool) path: informalexample/programlisting
2965 #: C/index.docbook:1845
2966 #, no-wrap
2967 msgid ""
2968 "\n"
2969 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2970 msgstr ""
2971 "\n"
2972 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2973
2974 #. (itstool) path: sect1/para
2975 #: C/index.docbook:1841
2976 msgid ""
2977 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2978 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2979 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2980 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2981 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2982 msgstr ""
2983 "Para enlazar otra sección en GTK docs: <_:informalexample-1/>. El enlace es "
2984 "el id SGML en el elemento superior de la página a la que quiere enlazar. "
2985 "Para la mayoría de las páginas esta es la parte («gtk», «gdk», «glib») y "
2986 "después el título de página («Tablas hash»). Para los widgets es simplemente "
2987 "el nombre de la clase. Los espacios y guiones bajos se convierten a «-» para "
2988 "ajustarse a SGML/XML."
2989
2990 #. (itstool) path: informalexample/programlisting
2991 #: C/index.docbook:1858
2992 #, no-wrap
2993 msgid ""
2994 "\n"
2995 "&lt;function&gt;...&lt;/function&gt;\n"
2996 msgstr ""
2997 "\n"
2998 "&lt;function&gt;...&lt;/function&gt;\n"
2999
3000 #. (itstool) path: sect1/para
3001 #: C/index.docbook:1855
3002 msgid ""
3003 "To refer to an external function, e.g. a standard C function: <_:"
3004 "informalexample-1/>"
3005 msgstr ""
3006 "Para referirse a una función externa, ej. una función de C estándar: <_:"
3007 "informalexample-1/>"
3008
3009 #. (itstool) path: informalexample/programlisting
3010 #: C/index.docbook:1867
3011 #, no-wrap
3012 msgid ""
3013 "\n"
3014 "&lt;example&gt;\n"
3015 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3016 " &lt;programlisting language=\"C\"&gt;\n"
3017 " ...\n"
3018 " &lt;/programlisting&gt;\n"
3019 "&lt;/example&gt;\n"
3020 msgstr ""
3021 "\n"
3022 "&lt;example&gt;\n"
3023 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3024 " &lt;programlisting language=\"C\"&gt;\n"
3025 " ...\n"
3026 " &lt;/programlisting&gt;\n"
3027 "&lt;/example&gt;\n"
3028
3029 #. (itstool) path: informalexample/programlisting
3030 #: C/index.docbook:1878
3031 #, no-wrap
3032 msgid ""
3033 "\n"
3034 "&lt;informalexample&gt;\n"
3035 " &lt;programlisting language=\"C\"&gt;\n"
3036 " ...\n"
3037 " &lt;/programlisting&gt;\n"
3038 "&lt;/informalexample&gt;\n"
3039 msgstr ""
3040 "\n"
3041 "&lt;informalexample&gt;\n"
3042 " &lt;programlisting language=\"C\"&gt;\n"
3043 " ...\n"
3044 " &lt;/programlisting&gt;\n"
3045 "&lt;/informalexample&gt;\n"
3046
3047 #. (itstool) path: informalexample/programlisting
3048 #: C/index.docbook:1890
3049 #, no-wrap
3050 msgid ""
3051 "\n"
3052 "|[&lt;!-- language=\"C\" --&gt;\n"
3053 " ...\n"
3054 "]|\n"
3055 msgstr ""
3056 "\n"
3057 "|[&lt;!-- language=\"C\" --&gt;\n"
3058 " ...\n"
3059 "]|\n"
3060
3061 #. (itstool) path: sect1/para
3062 #: C/index.docbook:1864
3063 msgid ""
3064 "To include example code: <_:informalexample-1/> or possibly this, for very "
3065 "short code fragments which don't need a title: <_:informalexample-2/> In "
3066 "both cases, the language attribute is optional and is used as a hint to the "
3067 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3068 "Doc also supports an abbreviation: <_:informalexample-3/>"
3069 msgstr ""
3070 "Para incluir código de ejemplo: <_:informalexample-1/> o posiblemente esto, "
3071 "para fragmentos de código muy cortos que no necesitan un título: <_:"
3072 "informalexample-2/> En ambos casos, el atributo de lenguaje es opcional y se "
3073 "utiliza como una pista para el motor de resaltado de sintaxis (pygments para "
3074 "salida html). Para este último, GTK-Doc también admite una abreviatura: <_:"
3075 "informalexample-3/>"
3076
3077 #. (itstool) path: informalexample/programlisting
3078 #: C/index.docbook:1901
3079 #, no-wrap
3080 msgid ""
3081 "\n"
3082 "&lt;itemizedlist&gt;\n"
3083 " &lt;listitem&gt;\n"
3084 " &lt;para&gt;\n"
3085 " ...\n"
3086 " &lt;/para&gt;\n"
3087 " &lt;/listitem&gt;\n"
3088 " &lt;listitem&gt;\n"
3089 " &lt;para&gt;\n"
3090 " ...\n"
3091 " &lt;/para&gt;\n"
3092 " &lt;/listitem&gt;\n"
3093 "&lt;/itemizedlist&gt;\n"
3094 msgstr ""
3095 "\n"
3096 "&lt;itemizedlist&gt;\n"
3097 " &lt;listitem&gt;\n"
3098 " &lt;para&gt;\n"
3099 " ...\n"
3100 " &lt;/para&gt;\n"
3101 " &lt;/listitem&gt;\n"
3102 " &lt;listitem&gt;\n"
3103 " &lt;para&gt;\n"
3104 " ...\n"
3105 " &lt;/para&gt;\n"
3106 " &lt;/listitem&gt;\n"
3107 "&lt;/itemizedlist&gt;\n"
3108
3109 #. (itstool) path: sect1/para
3110 #: C/index.docbook:1898
3111 msgid "To include bulleted lists: <_:informalexample-1/>"
3112 msgstr "Para incluir listas de topos: <_:informalexample-1/>"
3113
3114 #. (itstool) path: informalexample/programlisting
3115 #: C/index.docbook:1921
3116 #, no-wrap
3117 msgid ""
3118 "\n"
3119 "&lt;note&gt;\n"
3120 " &lt;para&gt;\n"
3121 " Make sure you free the data after use.\n"
3122 " &lt;/para&gt;\n"
3123 "&lt;/note&gt;\n"
3124 msgstr ""
3125 "\n"
3126 "&lt;note&gt;\n"
3127 " &lt;para&gt;\n"
3128 " Make sure you free the data after use.\n"
3129 " &lt;/para&gt;\n"
3130 "&lt;/note&gt;\n"
3131
3132 #. (itstool) path: sect1/para
3133 #: C/index.docbook:1918
3134 msgid ""
3135 "To include a note which stands out from the text: <_:informalexample-1/>"
3136 msgstr "Para incluir una nota que sobresale del texto: <_:informalexample-1/>"
3137
3138 #. (itstool) path: informalexample/programlisting
3139 #: C/index.docbook:1934
3140 #, no-wrap
3141 msgid ""
3142 "\n"
3143 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3144 msgstr ""
3145 "\n"
3146 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3147
3148 #. (itstool) path: sect1/para
3149 #: C/index.docbook:1931
3150 msgid "To refer to a type: <_:informalexample-1/>"
3151 msgstr "Para referirse a un tipo: <_:informalexample-1/>"
3152
3153 #. (itstool) path: informalexample/programlisting
3154 #: C/index.docbook:1943
3155 #, no-wrap
3156 msgid ""
3157 "\n"
3158 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3159 msgstr ""
3160 "\n"
3161 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3162
3163 #. (itstool) path: sect1/para
3164 #: C/index.docbook:1940
3165 msgid ""
3166 "To refer to an external structure (not one described in the GTK docs): <_:"
3167 "informalexample-1/>"
3168 msgstr ""
3169 "Para referirse a una estructura externa (no una descrita en la documentación "
3170 "de GTK): <_:informalexample-1/>"
3171
3172 #. (itstool) path: informalexample/programlisting
3173 #: C/index.docbook:1952
3174 #, no-wrap
3175 msgid ""
3176 "\n"
3177 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3178 msgstr ""
3179 "\n"
3180 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3181
3182 #. (itstool) path: sect1/para
3183 #: C/index.docbook:1949
3184 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3185 msgstr "Para referirse a un campo o a una estructura: <_:informalexample-1/>"
3186
3187 #. (itstool) path: informalexample/programlisting
3188 #: C/index.docbook:1961
3189 #, no-wrap
3190 msgid ""
3191 "\n"
3192 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3193 msgstr ""
3194 "\n"
3195 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3196
3197 #. (itstool) path: sect1/para
3198 #: C/index.docbook:1958
3199 msgid ""
3200 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3201 "you'll probably be using #GtkWidget instead (to automatically create a link "
3202 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3203 "abbreviations</link>)."
3204 msgstr ""
3205 "Para referirse a un nombre de clase, se podría usar: <_:informalexample-1/> "
3206 "pero probablemente estará usando #GtkWidget en su lugar (para crear "
3207 "automáticamente un enlace a la página GtkWidget; consulte <link linkend="
3208 "\"documenting_syntax\">abreviaciones</link>)."
3209
3210 #. (itstool) path: informalexample/programlisting
3211 #: C/index.docbook:1972
3212 #, no-wrap
3213 msgid ""
3214 "\n"
3215 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3216 msgstr ""
3217 "\n"
3218 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3219
3220 #. (itstool) path: sect1/para
3221 #: C/index.docbook:1969
3222 msgid "To emphasize text: <_:informalexample-1/>"
3223 msgstr "Para enfatizar un texto: <_:informalexample-1/>"
3224
3225 #. (itstool) path: informalexample/programlisting
3226 #: C/index.docbook:1981
3227 #, no-wrap
3228 msgid ""
3229 "\n"
3230 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3231 msgstr ""
3232 "\n"
3233 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3234
3235 #. (itstool) path: sect1/para
3236 #: C/index.docbook:1978
3237 msgid "For filenames use: <_:informalexample-1/>"
3238 msgstr "Para uso de nombres de archivo: <_:informalexample-1/>"
3239
3240 #. (itstool) path: informalexample/programlisting
3241 #: C/index.docbook:1990
3242 #, no-wrap
3243 msgid ""
3244 "\n"
3245 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3246 msgstr ""
3247 "\n"
3248 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3249
3250 #. (itstool) path: sect1/para
3251 #: C/index.docbook:1987
3252 msgid "To refer to keys use: <_:informalexample-1/>"
3253 msgstr "Para referirse a claves: <_:informalexample-1/>"
3254
3255 #. (itstool) path: chapter/title
3256 #: C/index.docbook:2000
3257 msgid "Filling the extra files"
3258 msgstr "Rellenar campos adicionales"
3259
3260 #. (itstool) path: chapter/para
3261 #: C/index.docbook:2002
3262 msgid ""
3263 "There are a couple of extra files, that need to be maintained along with the "
3264 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3265 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3266 "<filename>&lt;package&gt;-sections.txt</filename>."
3267 msgstr ""
3268 "Existen tres archivos adicionales que deben mantenerse junto con los "
3269 "comentarios en línea del código fuente: <filename>&lt;paquete&gt;.types</"
3270 "filename>, <filename>&lt;paquete&gt;-docs.xml</filename> (.sgml en el "
3271 "pasado) y <filename>&lt;paquete&gt;-sections.txt</filename>."
3272
3273 #. (itstool) path: sect1/title
3274 #: C/index.docbook:2011
3275 msgid "Editing the types file"
3276 msgstr "Editar los tipos de archivo"
3277
3278 #. (itstool) path: sect1/para
3279 #: C/index.docbook:2013
3280 msgid ""
3281 "If your library or application includes GObjects, you want their signals, "
3282 "arguments/parameters and position in the hierarchy to be shown in the "
3283 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3284 "function> functions together with their include inside the <filename>&lt;"
3285 "package&gt;.types</filename> file."
3286 msgstr ""
3287 "Si su biblioteca o aplicación incluye GObjects puede querer que sus señales, "
3288 "argumentos y/o parámetros y posición en la jerarquía se muestre en la "
3289 "documentación. Todo lo que debe hacer es listar las funciones "
3290 "<function>xxx_get_type</function> junto con sus «include» en el archivo "
3291 "<filename>&lt;paquete&gt;.types</filename>."
3292
3293 #. (itstool) path: example/title
3294 #: C/index.docbook:2022
3295 msgid "Example &lt;package&gt;.types file"
3296 msgstr "Ejemplo de archivo &lt;paquete&gt;.tipos"
3297
3298 #. (itstool) path: example/programlisting
3299 #: C/index.docbook:2023
3300 #, no-wrap
3301 msgid ""
3302 "\n"
3303 "#include &lt;gtk/gtk.h&gt;\n"
3304 "\n"
3305 "gtk_accel_label_get_type\n"
3306 "gtk_adjustment_get_type\n"
3307 "gtk_alignment_get_type\n"
3308 "gtk_arrow_get_type\n"
3309 msgstr ""
3310 "\n"
3311 "#include &lt;gtk/gtk.h&gt;\n"
3312 "\n"
3313 "gtk_accel_label_get_type\n"
3314 "gtk_adjustment_get_type\n"
3315 "gtk_alignment_get_type\n"
3316 "gtk_arrow_get_type\n"
3317
3318 #. (itstool) path: sect1/para
3319 #: C/index.docbook:2034
3320 msgid ""
3321 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3322 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3323 "<filename>Makefile.am</filename>. If you use this approach you should not "
3324 "dist the types file nor have it under version control."
3325 msgstr ""
3326 "Desde GTK-Doc 1.8 <application>gtkdoc-scan</application> puede genera esta "
3327 "lista. Simplemente añada «--rebuild-types» a SCAN_OPTIONS en el "
3328 "<filename>Makefile.am</filename>. Si usa esto no debería ejecutar dist sobre "
3329 "los tipos de archivo ni tenerlos bajo el control de versiones."
3330
3331 #. (itstool) path: sect1/title
3332 #: C/index.docbook:2043
3333 msgid "Editing the master document"
3334 msgstr "Editar la sección maestra del documento"
3335
3336 #. (itstool) path: sect1/para
3337 #: C/index.docbook:2045
3338 msgid ""
3339 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3340 "inline source comments, the GTK-Doc tools generate one documentation page "
3341 "per class or module as a separate file. The master document includes them "
3342 "and place them in an order."
3343 msgstr ""
3344 "GTK-Doc produce documentación en DocBook SGML/XML. Cuando se procesan los "
3345 "comentarios en las líneas del código, las herramientas de GTK-Doc generan "
3346 "una página de documentación por clase o módulo en un archivo aparte. El "
3347 "documento maestro las incluye y ordena."
3348
3349 #. (itstool) path: sect1/para
3350 #: C/index.docbook:2052
3351 msgid ""
3352 "While GTK-Doc creates a template master document for you, later runs will "
3353 "not touch it again. This means that one can freely structure the "
3354 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3355 "has now a test suite, where also the master-document is recreated from "
3356 "scratch. Its a good idea to look at this from time to time to see if there "
3357 "are some new goodies introduced there."
3358 msgstr ""
3359 "Puesto que GTK-Doc crea una documento maestro de plantilla, una posterior "
3360 "ejecución no lo modificará de nuevo. Esto significa que se puede estructurar "
3361 "libremente la documentación. Esto incluye agrupar páginas y añadir páginas "
3362 "adicionales. Ahora GTK-Doc tiene un entorno de pruebas, donde también el "
3363 "documento maestro se vuelve a crear desde cero. Es una buena idea mirarlo de "
3364 "vez en cuando para ver si se han introducido algunas mejoras."
3365
3366 #. (itstool) path: tip/para
3367 #: C/index.docbook:2062
3368 msgid ""
3369 "Do not create tutorials as extra documents. Just write extra chapters. The "
3370 "benefit of directly embedding the tutorial for your library into the API "
3371 "documentation is that it is easy to link for the tutorial to symbol "
3372 "documentation. Apart chances are higher that the tutorial gets updates along "
3373 "with the library."
3374 msgstr ""
3375 "No crear tutoriales como documentos adicionales. Solamente escriba capítulos "
3376 "adicionales. La ventaja de integrar directamente el tutorial para su "
3377 "biblioteca en la documentación de la API es que es fácil para el tutorial "
3378 "enlazar la documentación de símbolos. Además las posibilidades de actualizar "
3379 "el tutorial junto con la biblioteca son mayores."
3380
3381 #. (itstool) path: sect1/para
3382 #: C/index.docbook:2071
3383 msgid ""
3384 "So what are the things to change inside the master document? For a start is "
3385 "only a little. There are some placeholders (text in square brackets) there "
3386 "which you should take care of."
3387 msgstr ""
3388 "¿Así que qué es lo que hay que cambiar en el documento maestro? Para empezar "
3389 "es muy poco. Existen algunos «placeholders» (texto entre corchetes) de los "
3390 "que habría que encargarse."
3391
3392 #. (itstool) path: example/title
3393 #: C/index.docbook:2078
3394 msgid "Master document header"
3395 msgstr "Cabecera del documento maestro"
3396
3397 #. (itstool) path: example/programlisting
3398 #: C/index.docbook:2079
3399 #, no-wrap
3400 msgid ""
3401 "\n"
3402 "&lt;bookinfo&gt;\n"
3403 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3404 " &lt;releaseinfo&gt;\n"
3405 " for MODULENAME [VERSION]\n"
3406 " The latest version of this documentation can be found on-line at\n"
3407 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3408 " &lt;/releaseinfo&gt;\n"
3409 "&lt;/bookinfo&gt;\n"
3410 "\n"
3411 "&lt;chapter&gt;\n"
3412 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3413 msgstr ""
3414 "\n"
3415 "&lt;bookinfo&gt;\n"
3416 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3417 " &lt;releaseinfo&gt;\n"
3418 " for MODULENAME [VERSION]\n"
3419 " The latest version of this documentation can be found on-line at\n"
3420 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3421 " &lt;/releaseinfo&gt;\n"
3422 "&lt;/bookinfo&gt;\n"
3423 "\n"
3424 "&lt;chapter&gt;\n"
3425 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3426
3427 #. (itstool) path: sect1/para
3428 #: C/index.docbook:2095
3429 msgid ""
3430 "In addition a few option elements are created in commented form. You can "
3431 "review these and enable them as you like."
3432 msgstr ""
3433 "Se crean además unos pocos elementos de opciones de la manera comentada. "
3434 "Puede revisarlos y activarlos como quiera."
3435
3436 #. (itstool) path: example/title
3437 #: C/index.docbook:2101
3438 msgid "Optional part in the master document"
3439 msgstr "Parte opcional en el documento maestro"
3440
3441 #. (itstool) path: example/programlisting
3442 #: C/index.docbook:2102
3443 #, no-wrap
3444 msgid ""
3445 "\n"
3446 " &lt;!-- enable this when you use gobject introspection annotations\n"
3447 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3448 " --&gt;\n"
3449 msgstr ""
3450 "\n"
3451 " &lt;!-- active esto cuando use anotaciones de introspección de gobject\n"
3452 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3453 " --&gt; \n"
3454
3455 #. (itstool) path: sect1/para
3456 #: C/index.docbook:2110
3457 msgid ""
3458 "Finally you need to add new section whenever you introduce one. The <link "
3459 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3460 "you of newly generated xml files that are not yet included into the doc."
3461 msgstr ""
3462 "Por último, necesita añadir una sección nueva siempre que quiera introducir "
3463 "una. La herramienta <link linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</"
3464 "link> le recordará los nuevos archivos xml generados que no estén inclídos "
3465 "todavía en la documentación."
3466
3467 #. (itstool) path: example/title
3468 #: C/index.docbook:2118 C/index.docbook:2153
3469 msgid "Including generated sections"
3470 msgstr "Incluir secciones generadas"
3471
3472 #. (itstool) path: example/programlisting
3473 #: C/index.docbook:2119
3474 #, no-wrap
3475 msgid ""
3476 "\n"
3477 " &lt;chapter&gt;\n"
3478 " &lt;title&gt;my library&lt;/title&gt;\n"
3479 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3480 " ...\n"
3481 msgstr ""
3482 "\n"
3483 " &lt;chapter&gt;\n"
3484 " &lt;title&gt;mi biblioteca&lt;/title&gt;\n"
3485 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3486 " ...\n"
3487
3488 #. (itstool) path: sect1/title
3489 #: C/index.docbook:2131
3490 msgid "Editing the section file"
3491 msgstr "Editar el archivo de sección"
3492
3493 #. (itstool) path: sect1/para
3494 #: C/index.docbook:2133
3495 msgid ""
3496 "The section file is used to organise the documentation output by GTK-Doc. "
3497 "Here one specifies which symbol belongs to which module or class and control "
3498 "the visibility (public or private)."
3499 msgstr ""
3500 "El archivo de sección se usa para organizar la salida de la documentación "
3501 "por GTK-Doc. Aquí se especifica qué símbolos pertenecen a qué módulo o clase "
3502 "y el control de la visibilidad (pública o privada)."
3503
3504 #. (itstool) path: sect1/para
3505 #: C/index.docbook:2139
3506 msgid ""
3507 "The section file is a plain text file with tags delimiting sections. Blank "
3508 "lines are ignored and lines starting with a '#' are treated as comment lines."
3509 msgstr ""
3510 "El archivo de sección es un archivo de texto plano con etiquetas que "
3511 "delimitan las secciones. Se ignoran las líneas vacías y las líneas que "
3512 "comiencen con «#» se tratan como comentarios."
3513
3514 #. (itstool) path: note/para
3515 #: C/index.docbook:2146
3516 msgid ""
3517 "While the tags make the file look like xml, it is not. Please do not close "
3518 "tags like &lt;SUBSECTION&gt;."
3519 msgstr ""
3520 "Aunque las etiquetas hacen que el archivo parezca XML, no lo es. No incluya "
3521 "etiquetas del tipo &lt;SUBSECTION&gt;."
3522
3523 #. (itstool) path: example/programlisting
3524 #: C/index.docbook:2154
3525 #, no-wrap
3526 msgid ""
3527 "\n"
3528 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3529 "\n"
3530 "&lt;SECTION&gt;\n"
3531 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3532 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3533 "MeepApp\n"
3534 "&lt;SUBSECTION Standard&gt;\n"
3535 "MEEP_APP\n"
3536 "...\n"
3537 "MeepAppClass\n"
3538 "meep_app_get_type\n"
3539 "&lt;/SECTION&gt;\n"
3540 msgstr ""
3541 "\n"
3542 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3543 "\n"
3544 "&lt;SECTION&gt;\n"
3545 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3546 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3547 "MeepApp\n"
3548 "&lt;SUBSECTION Standard&gt;\n"
3549 "MEEP_APP\n"
3550 "...\n"
3551 "MeepAppClass\n"
3552 "meep_app_get_type\n"
3553 "&lt;/SECTION&gt;\n"
3554
3555 #. (itstool) path: sect1/para
3556 #: C/index.docbook:2171
3557 msgid ""
3558 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3559 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3560 "FILE&gt;' will result in the section declarations being output in the "
3561 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3562 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3563 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3564 "(The name of the HTML file is based on the module name and the section "
3565 "title, or for GObjects it is based on the GObjects class name converted to "
3566 "lower case)."
3567 msgstr ""
3568 "La etiqueta &lt;FILE&gt; ... &lt;/FILE&gt; se usa para especificar el nombre "
3569 "del archivo, sin sufijo. Por ejemplo, usar «&lt;FILE&gt;gnome-config&lt;/"
3570 "FILE&gt;» dará como resultado en la sección de declaraciones la salida "
3571 "<filename>tmpl/gnome-config.sgml</filename> en el archivo de plantilla, que "
3572 "se convertirá al archivo DocBook XML <filename>sgml/gnome-config.sgml</"
3573 "filename> o al archivo DocBook XML <filename>xml/gnome-config.xml</"
3574 "filename>. (El nombre del archivo HTML está basado en el nombre del módulo y "
3575 "en el título de la sección, o para GObjects está basado en el nombre de "
3576 "clase de GObject convertido a minúscula.)"
3577
3578 #. (itstool) path: sect1/para
3579 #: C/index.docbook:2183
3580 msgid ""
3581 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3582 "section. It is only useful before the templates (if used) are initially "
3583 "created, since the title set in the template file overrides this. Also if "
3584 "one uses SECTION comment in the sources, this is obsolete."
3585 msgstr ""
3586 "La etiqueta &lt;TITLE&gt; ... &lt;/TITLE&gt; se usa para especificar el "
3587 "título de una sección. Sólo es útil antes de que las plantillas (si se usan) "
3588 "se creen inicialmente, ya que el título configurado en la plantilla lo "
3589 "sobrescribe. Además, si una usa comentarios SECTION en los fuentes, se queda "
3590 "obsoleto."
3591
3592 #. (itstool) path: sect1/para
3593 #: C/index.docbook:2190
3594 msgid ""
3595 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3596 "Currently it outputs a blank line between subsections in the synopsis "
3597 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3598 "declarations (e.g. the functions like g_object_get_type and macros like "
3599 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3600 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3601 "declarations which will not be output (it is a handy way to avoid warning "
3602 "messages about unused declarations). If your library contains private types "
3603 "which you don't want to appear in the object hierarchy and the list of "
3604 "implemented or required interfaces, add them to a Private subsection. "
3605 "Whether you would place GObject and GObjectClass like structs in public or "
3606 "Standard section depends if they have public entries (variables, vmethods)."
3607 msgstr ""
3608 "Puede agrupar elementos en la sección usando la etiqueta &lt;SUBSECTION&gt;. "
3609 "Actualmente esto genera una línea en blanco entre subsecciones en la sección "
3610 "de resumen. También puede usar &lt;SUBSECTION Standard&gt; para "
3611 "declaraciones estándar de GObject (ej. funciones como g_object_get_type and "
3612 "macros como G_OBJECT(), G_IS_OBJECT() etc.). Actualmente éstas se han dejado "
3613 "fuera de la documentación. También puede usar &lt;SUBSECTION Private&gt; "
3614 "para declaraciones privadas que no producirán ninguna salida (s una manera "
3615 "práctica de evitar mensajes de advertencia sobre declaraciones sin usar). Si "
3616 "sus bibliotecas contienen tipos privados que no quiere que aparezcan en la "
3617 "jerarquía de objetos o en la lista de interfaces implementados o necesarios, "
3618 "añádalos a una subsección Privada. Si ubica GObject y GObjectClass como "
3619 "estructuras en la sección pública o estándar, depende de si tienen entradas "
3620 "públicas (variables, vmethods)."
3621
3622 #. (itstool) path: sect1/para
3623 #: C/index.docbook:2209
3624 msgid ""
3625 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3626 "#include files which are shown in the synopsis sections. It contains a comma-"
3627 "separate list of #include files, without the angle brackets. If you set it "
3628 "outside of any sections, it acts for all sections until the end of the file. "
3629 "If you set it within a section, it only applies to that section."
3630 msgstr ""
3631 "También puede usar &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; para especificar qué "
3632 "archivos #include se muestran en la sección de resumen. Contiene una lista "
3633 "de archivos #include separados por comas, sin las almohadillas. Si lo "
3634 "configura fuera de cualquier sección, actúa para todas las secciones hasta "
3635 "el final del archivo. Si lo configura dentro de una sección, sólo se aplica "
3636 "a esa sección."
3637
3638 #. (itstool) path: chapter/title
3639 #: C/index.docbook:2223
3640 msgid "Controlling the result"
3641 msgstr "Controlar el resultado"
3642
3643 #. (itstool) path: chapter/para
3644 #: C/index.docbook:2225
3645 msgid ""
3646 "A GTK-Doc run generates report files inside the documentation directory. The "
3647 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3648 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3649 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3650 "files that can be viewed and postprocessed easily."
3651 msgstr ""
3652 "Una ejecución de GTK-Doc genera archivos de informe dentro de la carpeta de "
3653 "la documentación. Los archivos generados se llaman <filename>&lt;paquete&gt;-"
3654 "undocumented.txt</filename>, <filename>&lt;paquete&gt;-undeclared.txt</"
3655 "filename> y <filename>&lt;paquete&gt;-unused.txt</filename>.Todos son "
3656 "archivos de texto plano y se pueden ver y posprocesar fácilmente."
3657
3658 #. (itstool) path: chapter/para
3659 #: C/index.docbook:2234
3660 msgid ""
3661 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3662 "the documentation coverage summary. Below are two sections divided by blank "
3663 "lines. The first section lists undocumented or incomplete symbols. The "
3664 "second section does the same for section docs. Incomplete entries are those, "
3665 "which have documentation, but where e.g. a new parameter has been added."
3666 msgstr ""
3667 "El archivo <filename>&lt;paquete&gt;-undocumented.txt</filename> comienza "
3668 "con el resumen de cobertura de la documentación. Debajo hay dos secciones "
3669 "divididas por líneas vacías. La primera sección lista los símbolos "
3670 "incompletos o indocumentados. La segunda sección hace lo mismo para los "
3671 "documentos de sección. Las entradas incompletas son aquellas que tienen "
3672 "documentación pero dónde; p.e. se ha añadido un parámetro nuevo."
3673
3674 #. (itstool) path: chapter/para
3675 #: C/index.docbook:2243
3676 msgid ""
3677 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3678 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3679 "in the sources. Check if they have been removed or if they are misspelled."
3680 msgstr ""
3681 "El archivo <filename>&lt;paquete&gt;-undeclared.txt</filename> lista "
3682 "símbolos proporcionados en el archivo <filename>&lt;paquete&gt;-sections."
3683 "txt</filename>, pero no encontrados en los fuentes. Compruebe si se han "
3684 "eliminado o no se han escrito correctamente."
3685
3686 #. (itstool) path: chapter/para
3687 #: C/index.docbook:2250
3688 msgid ""
3689 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3690 "where the GTK-Doc scanner has found documentation, but does not know where "
3691 "to put it. This means that the symbol has not yet been added to the "
3692 "<filename>&lt;package&gt;-sections.txt</filename> file."
3693 msgstr ""
3694 "El archivo <filename>&lt;paquete&gt;-unused.txt</filename> lista nombres de "
3695 "símbolos, donde el analizador de GTK-Doc ha encontrado documentación, pero "
3696 "no sabe dónde ponerla. Esto significa que el símbolo no se ha añadido "
3697 "todavía al archivo <filename>&lt;paquete&gt;-sections.txt</filename>."
3698
3699 #. (itstool) path: tip/para
3700 #: C/index.docbook:2258
3701 msgid ""
3702 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
3703 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
3704 "<command>make check</command> run."
3705 msgstr ""
3706 "Activar o añadir la línea <option>TESTS=($GTKDOC_CHECK)</option> en Makefile."
3707 "am. Si como mínimo está instalado GTK-Doc 1.9, esto ejecutará comprobaciones "
3708 "de integridad durante la ejecución de make check."
3709
3710 #. (itstool) path: chapter/para
3711 #: C/index.docbook:2265
3712 msgid ""
3713 "One can also look at the files produced by the source code scanner: "
3714 "<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
3715 "package&gt;-decl.txt</filename>. The first one can be compared with the "
3716 "section file if that is manually maintained. The second lists all "
3717 "declarations from the headers. If a symbol is missing one could check if "
3718 "this file contains it."
3719 msgstr ""
3720 "También puede mirar los archivos producidos por el analizador del código "
3721 "fuente: <filename>&lt;paquete&gt;-decl-list.txt</filename> y <filename>&lt;"
3722 "paquete&gt;-decl.txt</filename>. El primero se puede comparar con el archivo "
3723 "de sección si se mantiene manualmente. El segundo lista todas las "
3724 "declaraciones desde las cabeceras. Si falta un símbolo, se puede comprobar "
3725 "si este archivo lo contiene."
3726
3727 #. (itstool) path: chapter/para
3728 #: C/index.docbook:2274
3729 msgid ""
3730 "If the project is GObject based, one can also look into the files produced "
3731 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3732 "<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
3733 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
3734 "prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
3735 "filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
3736 "to keep the intermediate scanner file for further analysis, by running it as "
3737 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3738 msgstr ""
3739 "Si el proyecto está basado en GObject, también se puede mirar en los "
3740 "archivos producidos por el analizador de objetos: <filename>&lt;paquete&gt;."
3741 "args.txt</filename>, <filename>&lt;paquete&gt;.hierarchy.txt</filename>, "
3742 "<filename>&lt;paquete&gt;.interfaces.txt</filename>, <filename>&lt;"
3743 "paquete&gt;.prerequisites.txt</filename> y <filename>&lt;paquete&gt;.signals."
3744 "txt</filename>. Si faltan símbolos en cualquiera de ellos, puede hacer que "
3745 "GTK-Doc guarde el análisis de archivos para futuros análisis, pero "
3746 "ejecutándolo como <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3747
3748 #. (itstool) path: chapter/title
3749 #: C/index.docbook:2289
3750 msgid "Modernizing the documentation"
3751 msgstr "Modernizar la documentación"
3752
3753 #. (itstool) path: chapter/para
3754 #: C/index.docbook:2291
3755 msgid ""
3756 "GTK-Doc has been around for quite some time. In this section we list new "
3757 "features together with the version since when it is available."
3758 msgstr ""
3759 "GTK-Doc ha existido durante mucho tiempo. En esta sección se listan las "
3760 "características nuevas junto con la versión desde la que están disponibles."
3761
3762 #. (itstool) path: sect1/title
3763 #: C/index.docbook:2297
3764 msgid "GTK-Doc 1.9"
3765 msgstr "GTK-Doc 1.9"
3766
3767 #. (itstool) path: sect1/para
3768 #: C/index.docbook:2299
3769 msgid ""
3770 "When using xml instead of sgml, one can actually name the master document "
3771 "<filename>&lt;package&gt;-docs.xml</filename>."
3772 msgstr ""
3773 "Al usar XML en lugar de SGML, actualmente se puede nombrar el documento "
3774 "maestro <filename>&lt;paquete&gt;-docs.xml</filename>."
3775
3776 #. (itstool) path: sect1/para
3777 #: C/index.docbook:2304
3778 msgid ""
3779 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3780 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3781 "package&gt;-sections.txt</filename> is autogenerated and can be removed from "
3782 "the vcs. This only works nicely for projects that have a very regular "
3783 "structure (e.g. each .{c,h} pair will create new section). If one organize a "
3784 "project close to that updating a manually maintained section file can be as "
3785 "simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
3786 "sections.txt</code>."
3787 msgstr ""
3788 "Esta versión soporta <option>SCAN_OPTIONS=--rebuild-sections</option> en "
3789 "<filename>Makefile.am</filename>. Cuando está activada, el archivo "
3790 "<filename>&lt;paquete&gt;-sections.txt</filename> se genera automáticamente "
3791 "y se puede quitar del control de versiones. Esto sólo funciona en proyectos "
3792 "que tienen una estructura regular (ej. cada pareja .{c,h} creará una sección "
3793 "nueva). Si se organiza un proyecto parecido a esto, actualizar una sección "
3794 "mantenida manualmente puede ser tan sencillo como ejecutar <code>meld &lt;"
3795 "paquete&gt;-decl-list.txt &lt;paquete&gt;-sections.txt</code>."
3796
3797 #. (itstool) path: sect1/para
3798 #: C/index.docbook:2315
3799 msgid ""
3800 "Version 1.8 already introduced the syntax for documenting sections in the "
3801 "sources instead of the separate files under <filename class=\"directory"
3802 "\">tmpl</filename>. This version adds options to switch the whole doc module "
3803 "to not use the extra tmpl build step at all, by using <option>--flavour no-"
3804 "tmpl</option> in <filename>configure.ac</filename>. If you don't have a "
3805 "<filename class=\"directory\">tmpl</filename> checked into your source "
3806 "control system and haven't yet switched, just add the flag to "
3807 "<filename>configure.ac</filename> and you are done."
3808 msgstr ""
3809 "La versión 1.18 ya introdujo la sintaxis para documentar secciones en las "
3810 "fuentes en lugar de tener que hacerlo en archivos separados bajo <filename "
3811 "class=\"directory\">tmpl</filename>. Esta versión añade opciones para "
3812 "cambiar todo el módulo «doc» del documento para que no realice el paso de "
3813 "construcción de tmpl adicional, usando <option>--flavour no-tmpl</option> en "
3814 "<filename>configure.ac</filename>. Si no tiene una <filename class="
3815 "\"directory\">tmpl</filename> marcada en su sistema de control de versiones "
3816 "y todavía no ha cambiado, simplemente añada la opción al archivo "
3817 "<filename>configure.ac</filename> y lo tendrá hecho."
3818
3819 #. (itstool) path: sect1/title
3820 #: C/index.docbook:2327
3821 msgid "GTK-Doc 1.10"
3822 msgstr "GTK-Doc 1.10"
3823
3824 #. (itstool) path: sect1/para
3825 #: C/index.docbook:2329
3826 msgid ""
3827 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3828 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3829 "package&gt;.types</filename> is autogenerated and can be removed from the "
3830 "vcs. When using this feature it is important to also setup the "
3831 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3832 "code that is build conditionally."
3833 msgstr ""
3834 "Esta versión soporta <option>SCAN_OPTIONS=--rebuild-types</option> en "
3835 "<filename>Makefile.am</filename>. Cuando está activado, el archivo "
3836 "<filename>&lt;package&gt;.types</filename> se genera automáticamente y se "
3837 "puede eliminar del control de versiones. Al usar esta característica es "
3838 "importante configurar la variable <varname>IGNORE_HFILES</varname> en el "
3839 "<filename>Makefile.am</filename> para el código que se construye de manera "
3840 "condicional."
3841
3842 #. (itstool) path: sect1/title
3843 #: C/index.docbook:2340
3844 msgid "GTK-Doc 1.16"
3845 msgstr "GTK-Doc 1.16"
3846
3847 #. (itstool) path: example/title
3848 #: C/index.docbook:2346
3849 msgid "Enable gtkdoc-check"
3850 msgstr "Activar gtkdoc-check"
3851
3852 #. (itstool) path: example/programlisting
3853 #: C/index.docbook:2347
3854 #, no-wrap
3855 msgid ""
3856 "\n"
3857 "if ENABLE_GTK_DOC\n"
3858 "TESTS_ENVIRONMENT = \\\n"
3859 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3860 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3861 "TESTS = $(GTKDOC_CHECK)\n"
3862 "endif\n"
3863 msgstr ""
3864 "\n"
3865 "if ENABLE_GTK_DOC\n"
3866 "TESTS_ENVIRONMENT = \\\n"
3867 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3868 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3869 "TESTS = $(GTKDOC_CHECK)\n"
3870 "endif\n"
3871
3872 #. (itstool) path: sect1/para
3873 #: C/index.docbook:2342
3874 msgid ""
3875 "This version includes a new tool called gtkdoc-check. This tool can run a "
3876 "set of sanity checks on your documentation. It is enabled by adding these "
3877 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3878 msgstr ""
3879 "Esta versión incluye una herramienta nueva llamada gtkdoc-check. Esta "
3880 "herramienta puede ejecutar una serie de comprobaciones de integridad de la "
3881 "documentación. Se activa añadiendo las siguientes líneas al final del "
3882 "archivo <filename>Makefile.am</filename>. <_:example-1/>"
3883
3884 #. (itstool) path: sect1/title
3885 #: C/index.docbook:2360
3886 msgid "GTK-Doc 1.20"
3887 msgstr "GTK-Doc 1.20"
3888
3889 #. (itstool) path: sect1/para
3890 #: C/index.docbook:2362
3891 msgid ""
3892 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3893 "comments is less intrusive than writing docbook xml. This version improves a "
3894 "lot on this and add a lot more styles. The section that explains the <link "
3895 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3896 msgstr ""
3897 "La versión 1.18 incluía soporte para cierto marcado inicial. Usar el marcado "
3898 "en los comentarios del documento es menos intrusivo que escribir el XML del "
3899 "«docbook». Esta versión mejora mucho esto y añade muchos más estilos. La "
3900 "sección que explica la <link linkend=\"documenting_syntax\">sintaxis de los "
3901 "comentarios</link> contiene todos los detalles."
3902
3903 #. (itstool) path: sect1/title
3904 #: C/index.docbook:2372
3905 msgid "GTK-Doc 1.25"
3906 msgstr "GTK-Doc 1.25"
3907
3908 #. (itstool) path: example/title
3909 #: C/index.docbook:2383
3910 msgid "Use pre-generated entities"
3911 msgstr "Usar entidades generadas previamenet"
3912
3913 #. (itstool) path: example/programlisting
3914 #: C/index.docbook:2384
3915 #, no-wrap
3916 msgid ""
3917 "\n"
3918 "&lt;?xml version=\"1.0\"?&gt;\n"
3919 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3920 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3921 "[\n"
3922 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3923 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3924 " %gtkdocentities;\n"
3925 "]&gt;\n"
3926 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3927 " &lt;bookinfo&gt;\n"
3928 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3929 " &lt;releaseinfo&gt;\n"
3930 " for &amp;package_string;.\n"
3931 " The latest version of this documentation can be found on-line at\n"
3932 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3933 " &lt;/releaseinfo&gt;\n"
3934 " &lt;/bookinfo&gt;\n"
3935 msgstr ""
3936 "\n"
3937 "&lt;?xml version=\"1.0\"?&gt;\n"
3938 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3939 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3940 "[\n"
3941 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3942 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3943 " %gtkdocentities;\n"
3944 "]&gt;\n"
3945 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3946 " &lt;bookinfo&gt;\n"
3947 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3948 " &lt;releaseinfo&gt;\n"
3949 " for &amp;package_string;.\n"
3950 " The latest version of this documentation can be found on-line at\n"
3951 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3952 " &lt;/releaseinfo&gt;\n"
3953 " &lt;/bookinfo&gt;\n"
3954
3955 #. (itstool) path: sect1/para
3956 #: C/index.docbook:2374
3957 msgid ""
3958 "The makefiles shipped with this version generate an entity file at "
3959 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3960 "package_name and package_version. You can use this e.g. in the main xml file "
3961 "to avoid hardcoding the version number. Below is an example that shows how "
3962 "the entity file is included in the master template and how the entities are "
3963 "used. The entities can also be used in all generated files, GTK-Doc will use "
3964 "the same xml header in generated xml files. <_:example-1/>"
3965 msgstr ""
3966 "Los makefiles distribuidos con esta versión generan un archivo de entidad en "
3967 "<filename>xml/gtkdocentities.ent</filename>, que contiene entidades para, "
3968 "por ejemplo, nombre_paquete y versión_paquete. Puedes usar esto, por "
3969 "ejemplo, en el archivo xml principal para evitar codificar el número de "
3970 "versión. A continuación se muestra un ejemplo que muestra cómo se incluye el "
3971 "archivo de entidad en la plantilla maestra y cómo se utilizan las entidades. "
3972 "Las entidades también se pueden usar en todos los archivos generados, GTK-"
3973 "Doc usará el mismo encabezado xml en los archivos xml generados. <_:"
3974 "example-1/>"
3975
3976 #. (itstool) path: chapter/title
3977 #: C/index.docbook:2409
3978 msgid "Documenting other interfaces"
3979 msgstr "Documentar otras interfaces"
3980
3981 #. (itstool) path: chapter/para
3982 #: C/index.docbook:2411
3983 msgid ""
3984 "So far we have been using GTK-Doc to document the API of code. The next "
3985 "sections contain suggestions how the tools can be used to document other "
3986 "interfaces too."
3987 msgstr ""
3988 "Hasta ahora se ha usado GTK-Doc para documentar la API del código. Las "
3989 "siguientes secciones contienen sugerencias acerca de cómo se pueden usar las "
3990 "herramientas para documentar otras interfaces."
3991
3992 #. (itstool) path: sect1/title
3993 #: C/index.docbook:2418
3994 msgid "Command line options and man pages"
3995 msgstr "Opciones de la línea de comandos y páginas man"
3996
3997 #. (itstool) path: sect1/para
3998 #: C/index.docbook:2420
3999 msgid ""
4000 "As one can generate man pages for a docbook refentry as well, it sounds like "
4001 "a good idea to use it for that purpose. This way the interface is part of "
4002 "the reference and one gets the man-page for free."
4003 msgstr ""
4004 "Ya que también se pueden generar páginas man para referencias de entrada "
4005 "docbook, parece buena idea usarlas para ese propósito. De esta forma la "
4006 "interfaz es parte de la referencia y se obtienen las páginas man sin trabajo."
4007
4008 #. (itstool) path: sect2/title
4009 #: C/index.docbook:2427
4010 msgid "Document the tool"
4011 msgstr "Documentar la herramienta"
4012
4013 #. (itstool) path: sect2/para
4014 #: C/index.docbook:2429
4015 msgid ""
4016 "Create one refentry file per tool. Following <link linkend="
4017 "\"settingup_docfiles\">our example</link> we would call it <filename>meep/"
4018 "docs/reference/meeper/meep.xml</filename>. For the xml tags that should be "
4019 "used and can look at generated file in the xml subdirectory as well as "
4020 "examples e.g. in glib."
4021 msgstr ""
4022 "Cree un archivo de entrada de referencia para cada herramienta. Siguiendo "
4023 "<link linkend=\"settingup_docfiles\">el ejemplo</link> se llamará "
4024 "<filename>meep/docs/reference/meeper/meep.xml</filename>. Para las etiquetas "
4025 "xml que se deben usar puede mirar al archivo generado en la subcarpeta xml "
4026 "así como los ejemplos en, por ejemplo, glib."
4027
4028 #. (itstool) path: sect2/title
4029 #: C/index.docbook:2439
4030 msgid "Adding the extra configure check"
4031 msgstr "Añadir la comprobación de configuración adicional"
4032
4033 #. (itstool) path: example/title
4034 #: C/index.docbook:2442 C/index.docbook:2460
4035 msgid "Extra configure checks"
4036 msgstr "Comprobaciones de configuración adicionales"
4037
4038 #. (itstool) path: example/programlisting
4039 #: C/index.docbook:2443
4040 #, no-wrap
4041 msgid ""
4042 "\n"
4043 "AC_ARG_ENABLE(man,\n"
4044 " [AC_HELP_STRING([--enable-man],\n"
4045 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4046 " enable_man=no)\n"
4047 "\n"
4048 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4049 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4050 msgstr ""
4051 "\n"
4052 "AC_ARG_ENABLE(man,\n"
4053 " [AC_HELP_STRING([--enable-man],\n"
4054 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4055 " enable_man=no)\n"
4056 "\n"
4057 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4058 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4059
4060 #. (itstool) path: sect2/title
4061 #: C/index.docbook:2457
4062 msgid "Adding the extra makefile rules"
4063 msgstr "Añadir reglas de makefile adicionales"
4064
4065 #. (itstool) path: example/programlisting
4066 #: C/index.docbook:2461
4067 #, no-wrap
4068 msgid ""
4069 "\n"
4070 "man_MANS = \\\n"
4071 " meeper.1\n"
4072 "\n"
4073 "if ENABLE_GTK_DOC\n"
4074 "if ENABLE_MAN\n"
4075 "\n"
4076 "%.1 : %.xml\n"
4077 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4078 "\n"
4079 "endif\n"
4080 "endif\n"
4081 "\n"
4082 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4083 "EXTRA_DIST += meep.xml\n"
4084 msgstr ""
4085 "\n"
4086 "man_MANS = \\\n"
4087 " meeper.1\n"
4088 "\n"
4089 "if ENABLE_GTK_DOC\n"
4090 "if ENABLE_MAN\n"
4091 "\n"
4092 "%.1 : %.xml\n"
4093 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4094 "\n"
4095 "endif\n"
4096 "endif\n"
4097 "\n"
4098 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4099 "EXTRA_DIST += meep.xml\n"
4100
4101 #. (itstool) path: sect1/title
4102 #: C/index.docbook:2483
4103 msgid "DBus interfaces"
4104 msgstr "Interfaces de DBus"
4105
4106 #. (itstool) path: sect1/para
4107 #: C/index.docbook:2485
4108 msgid ""
4109 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4110 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4111 msgstr ""
4112 "(ARREGLAR: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4113 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4114
4115 #. (itstool) path: chapter/title
4116 #: C/index.docbook:2494
4117 msgid "Frequently asked questions"
4118 msgstr "Preguntas más frecuentes"
4119
4120 #. (itstool) path: segmentedlist/segtitle
4121 #: C/index.docbook:2498
4122 msgid "Question"
4123 msgstr "Pregunta"
4124
4125 #. (itstool) path: segmentedlist/segtitle
4126 #: C/index.docbook:2499
4127 msgid "Answer"
4128 msgstr "Respuesta"
4129
4130 #. (itstool) path: seglistitem/seg
4131 #: C/index.docbook:2501
4132 msgid "No class hierarchy."
4133 msgstr "Sin jerarquía de clases."
4134
4135 #. (itstool) path: seglistitem/seg
4136 #: C/index.docbook:2502
4137 msgid ""
4138 "The objects <function>xxx_get_type()</function> function has not been "
4139 "entered into the <filename>&lt;package&gt;.types</filename> file."
4140 msgstr ""
4141 "Los objetos de la función <function>xxx_get_type()</function> no se han "
4142 "introducido en el archivo <filename>&lt;package&gt;.types</filename>."
4143
4144 #. (itstool) path: seglistitem/seg
4145 #: C/index.docbook:2508
4146 msgid "Still no class hierarchy."
4147 msgstr "Aún sin jerarquía de clases."
4148
4149 #. (itstool) path: seglistitem/seg
4150 #: C/index.docbook:2509
4151 msgid ""
4152 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4153 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4154 "October/msg00006.html\">explanation</ulink>)."
4155 msgstr ""
4156 "Nombre incorrecto o ausente en el archivo <filename>&lt;package&gt;-sections."
4157 "txt</filename> (consulte la <ulink url=\"http://mail.gnome.org/archives/gtk-"
4158 "doc-list/2003-October/msg00006.html\">explicación</ulink>)."
4159
4160 #. (itstool) path: seglistitem/seg
4161 #: C/index.docbook:2515
4162 msgid "Damn, I have still no class hierarchy."
4163 msgstr "Maldición, aún no hay una jerarquía de clases."
4164
4165 #. (itstool) path: seglistitem/seg
4166 #: C/index.docbook:2516
4167 msgid ""
4168 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4169 "type>) part of the normal section (don't put this into Standard or Private "
4170 "subsections)."
4171 msgstr ""
4172 "Es el nombre del objeto (nombre de la estructura de la instancia, ej. "
4173 "<type>GtkWidget</type>) parte de la sección normal (no ponga esto en "
4174 "Estándar o Privado)."
4175
4176 #. (itstool) path: seglistitem/seg
4177 #: C/index.docbook:2523
4178 msgid "No symbol index."
4179 msgstr "Sin índice de símbolos."
4180
4181 #. (itstool) path: seglistitem/seg
4182 #: C/index.docbook:2524
4183 msgid ""
4184 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4185 "index that xi:includes the generated index?"
4186 msgstr ""
4187 "¿<filename>&lt;package&gt;-docs.{xml,sgml}</filename> contiene un índice que "
4188 "«xi:includes» el índice generado?"
4189
4190 #. (itstool) path: seglistitem/seg
4191 #: C/index.docbook:2530
4192 msgid "Symbols are not linked to their doc-section."
4193 msgstr "Los símbolos no se enlazan con su sección en el documento."
4194
4195 #. (itstool) path: seglistitem/seg
4196 #: C/index.docbook:2531
4197 msgid ""
4198 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4199 "gtkdoc-fixxref warns about unresolvable xrefs."
4200 msgstr ""
4201 "¿Está doc-comment usando el marcado correcto (añadido #,% o ())? Compruebe "
4202 "si gtk-doc-fixxref avisa de alguna referencia xref sin resolver."
4203
4204 #. (itstool) path: seglistitem/seg
4205 #: C/index.docbook:2537
4206 msgid "A new class does not appear in the docs."
4207 msgstr "Una clase nueva no aparece en la documentación."
4208
4209 #. (itstool) path: seglistitem/seg
4210 #: C/index.docbook:2538
4211 msgid ""
4212 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4213 "filename>."
4214 msgstr ""
4215 "Es la página nueva «xi:included» desde <filename>&lt;package&gt;-docs.{xml,"
4216 "sgml}</filename>."
4217
4218 #. (itstool) path: seglistitem/seg
4219 #: C/index.docbook:2544
4220 msgid "A new symbol does not appear in the docs."
4221 msgstr "Un símbolo nuevo no aparece en la documentación."
4222
4223 #. (itstool) path: seglistitem/seg
4224 #: C/index.docbook:2545
4225 msgid ""
4226 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4227 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4228 "xrefs. Check if the symbol is correctly listed in the <filename>&lt;"
4229 "package&gt;-sections.txt</filename> in a public subsection."
4230 msgstr ""
4231 "Comprobar que el doc-comment está formateado correctamente. Compruebe "
4232 "errores de escritura al principio del comentario. Compruebe si gtkdoc-"
4233 "fixxref avisa acerca de referencias xref no solventables. Compruebe si el "
4234 "símbolo está listado correctamente en <filename>&lt;package&gt;-sections."
4235 "txt</filename> en una subsección pública."
4236
4237 #. (itstool) path: seglistitem/seg
4238 #: C/index.docbook:2553
4239 msgid "A type is missing from the class hierarchy."
4240 msgstr "Falta un tipo en la clase de jerarquías"
4241
4242 #. (itstool) path: seglistitem/seg
4243 #: C/index.docbook:2554
4244 msgid ""
4245 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4246 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4247 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4248 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4249 "or incidentally marked private it will not be shown."
4250 msgstr ""
4251 "Si el tipo está listado en <filename>&lt;package&gt;.hierarchy</filename> "
4252 "pero no en <filename>xml/tree_index.sgml</filename>, entonces compruebe dos "
4253 "veces que el tipo está correctamente ubicado en la <filename>&lt;package&gt;-"
4254 "sections.txt</filename>. No se mostrará el tipo de instancia (ej. "
4255 "<type>GtkWidget</type>) si no está listada o accidentalmente marcada como "
4256 "privada."
4257
4258 #. (itstool) path: seglistitem/seg
4259 #: C/index.docbook:2563
4260 msgid "I get foldoc links for all gobject annotations."
4261 msgstr ""
4262 "Obtengo enlaces de seguimiento de documentos para todas las anotaciones "
4263 "gobject."
4264
4265 #. (itstool) path: seglistitem/seg
4266 #: C/index.docbook:2564
4267 msgid ""
4268 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4269 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4270 msgstr ""
4271 "Compruebe que <filename>xml/annotation-glossary.xml</filename> está «xi:"
4272 "included» desde <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4273
4274 #. (itstool) path: seglistitem/seg
4275 #: C/index.docbook:2572
4276 msgid "Parameter described in source code comment block but does not exist"
4277 msgstr ""
4278 "Parámetro descrito en el bloque de comentarios del código fuente pero no "
4279 "existe"
4280
4281 #. (itstool) path: seglistitem/seg
4282 #: C/index.docbook:2573
4283 msgid ""
4284 "Check if the prototype in the header has different parameter names as in the "
4285 "source."
4286 msgstr ""
4287 "Compruebe si el prototipo en la cabecera tiene nombres de parámetro "
4288 "diferentes de la fuente."
4289
4290 #. (itstool) path: seglistitem/seg
4291 #: C/index.docbook:2578
4292 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4293 msgstr "múltiples «ID» para la restricción enlazada: XYZ"
4294
4295 #. (itstool) path: seglistitem/seg
4296 #: C/index.docbook:2579
4297 msgid ""
4298 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4299 "filename> file."
4300 msgstr ""
4301 "El símbolo XYZ aparece dos veces en el archivo <filename>&lt;package&gt;-"
4302 "sections.txt</filename>."
4303
4304 #. (itstool) path: seglistitem/seg
4305 #: C/index.docbook:2582
4306 msgid ""
4307 "Element typename in namespace '' encountered in para, but no template "
4308 "matches."
4309 msgstr ""
4310 "Elemento typename en namespace «» encontrado en para, pero ninguna plantilla "
4311 "coincide."
4312
4313 #. (itstool) path: chapter/title
4314 #: C/index.docbook:2589
4315 msgid "Tools related to gtk-doc"
4316 msgstr "Herramientas relacionadas con GTK-Doc"
4317
4318 #. (itstool) path: chapter/para
4319 #: C/index.docbook:2591
4320 msgid ""
4321 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4322 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4323 "integrates with the trac search."
4324 msgstr ""
4325 "GtkDocPlugin: un complemento de integración <ulink url=\"http://trac-hacks."
4326 "org/wiki/GtkDocPlugin\">Trac GTK-Doc</ulink> que añade documentos de la API "
4327 "a un sitio «trac» y se integra con la búsqueda de «trac»."
4328
4329 #. (itstool) path: chapter/para
4330 #: C/index.docbook:2596
4331 msgid ""
4332 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4333 "tags in the API to determine the minimum required version."
4334 msgstr ""
4335 "Gtkdoc-depscan: una herramienta (parte de gtk-doc) para comprobar la API "
4336 "usada contra etiquetas en la API para determinar la versión mínima necesaria."
4337
4338 #. (itstool) path: appendixinfo/releaseinfo
4339 #: C/index.docbook:12 C/fdl-appendix.xml:12
4340 msgid "Version 1.1, March 2000"
4341 msgstr "Versión 1.1, marzo de 2000"
4342
4343 #. (itstool) path: appendixinfo/copyright
4344 #: C/index.docbook:15
4345 msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4346 msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
4347
4348 #. (itstool) path: para/address
4349 #: C/index.docbook:20
4350 #, no-wrap
4351 msgid ""
4352 "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
4353 " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
4354 " <postcode>02110-1301</postcode> <country>USA</country>"
4355 msgstr ""
4356 "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
4357 " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
4358 " <postcode>02110-1301</postcode> <country>USA</country>"
4359
4360 #. (itstool) path: legalnotice/para
4361 #: C/index.docbook:19 C/fdl-appendix.xml:19
4362 msgid ""
4363 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4364 "of this license document, but changing it is not allowed."
4365 msgstr ""
4366 "<_:address-1/>. Se permite la copia y distribución de copias literales de "
4367 "este documento, pero no se permite su modificación."
4368
4369 #. (itstool) path: appendix/title
4370 #. (itstool) path: para/quote
4371 #: C/index.docbook:28 C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4372 msgid "GNU Free Documentation License"
4373 msgstr "Licencia de documentación libre de GNU"
4374
4375 #. (itstool) path: sect1/title
4376 #: C/index.docbook:31 C/fdl-appendix.xml:31
4377 msgid "0. PREAMBLE"
4378 msgstr "0. PREÁMBULO"
4379
4380 #. (itstool) path: sect1/para
4381 #: C/index.docbook:32
4382 msgid ""
4383 "The purpose of this License is to make a manual, textbook, or other written "
4384 "document <quote>free</quote> in the sense of freedom: to assure everyone the "
4385 "effective freedom to copy and redistribute it, with or without modifying it, "
4386 "either commercially or noncommercially. Secondarily, this License preserves "
4387 "for the author and publisher a way to get credit for their work, while not "
4388 "being considered responsible for modifications made by others."
4389 msgstr ""
4390 "El propósito de esta Licencia es permitir que un manual, libro de texto, u "
4391 "otro documento escrito sea <quote>libre</quote> en el sentido de libertad: "
4392 "asegurar a todo el mundo la libertad efectiva de copiarlo y redistribuirlo, "
4393 "con o sin modificaciones, de manera comercial o no. En segundo término, esta "
4394 "Licencia proporciona al autor y al editor una manera de obtener "
4395 "reconocimiento por su trabajo, sin que se le considere responsable de las "
4396 "modificaciones realizadas por otros."
4397
4398 #. (itstool) path: sect1/para
4399 #: C/index.docbook:43
4400 msgid ""
4401 "This License is a kind of <quote>copyleft</quote>, which means that "
4402 "derivative works of the document must themselves be free in the same sense. "
4403 "It complements the GNU General Public License, which is a copyleft license "
4404 "designed for free software."
4405 msgstr ""
4406 "Esta Licencia es de tipo <quote>copyleft</quote>, lo que significa que los "
4407 "trabajos derivados del documento deben a su vez ser libres en el mismo "
4408 "sentido. Complementa la Licencia Pública General de GNU, que es una licencia "
4409 "tipo copyleft diseñada para el software libre."
4410
4411 #. (itstool) path: sect1/para
4412 #: C/index.docbook:50 C/fdl-appendix.xml:50
4413 msgid ""
4414 "We have designed this License in order to use it for manuals for free "
4415 "software, because free software needs free documentation: a free program "
4416 "should come with manuals providing the same freedoms that the software does. "
4417 "But this License is not limited to software manuals; it can be used for any "
4418 "textual work, regardless of subject matter or whether it is published as a "
4419 "printed book. We recommend this License principally for works whose purpose "
4420 "is instruction or reference."
4421 msgstr ""
4422 "Hemos diseñado esta Licencia para usarla en manuales de software libre, ya "
4423 "que el software libre necesita documentación libre: Un programa libre debe "
4424 "venir con los manuales que ofrezcan la mismas libertades que da el software. "
4425 "Pero esta licencia no se limita a manuales de software; puede ser usada para "
4426 "cualquier trabajo textual, sin tener en cuenta su temática o si se publica "
4427 "como libro impreso. Recomendamos esta licencia principalmente para trabajos "
4428 "cuyo fin sea instructivo o de referencia."
4429
4430 #. (itstool) path: sect1/title
4431 #: C/index.docbook:62 C/fdl-appendix.xml:62
4432 msgid "1. APPLICABILITY AND DEFINITIONS"
4433 msgstr "1. APLICABILIDAD Y DEFINICIONES"
4434
4435 #. (itstool) path: sect1/para
4436 #: C/index.docbook:63
4437 msgid ""
4438 "This License applies to any manual or other work that contains a notice "
4439 "placed by the copyright holder saying it can be distributed under the terms "
4440 "of this License. The <quote>Document</quote>, below, refers to any such "
4441 "manual or work. Any member of the public is a licensee, and is addressed as "
4442 "<quote>you</quote>."
4443 msgstr ""
4444 "Esta Licencia se aplica a cualquier manual u otro trabajo que contenga un "
4445 "aviso colocado por el poseedor del copyright diciendo que puede distribuirse "
4446 "bajo los términos de esta Licencia. El <quote>Documento</quote>, abajo, se "
4447 "refiere a cualquier manual o trabajo. Cualquier miembro del público es un "
4448 "licenciatario, y será referido como <quote>Usted</quote>."
4449
4450 #. (itstool) path: sect1/para
4451 #: C/index.docbook:72
4452 msgid ""
4453 "A <quote>Modified Version</quote> of the Document means any work containing "
4454 "the Document or a portion of it, either copied verbatim, or with "
4455 "modifications and/or translated into another language."
4456 msgstr ""
4457 "Una <quote>Versión Modificada</quote> del Documento significa cualquier "
4458 "trabajo que contenga el Documento o una porción del mismo, ya sea una copia "
4459 "literal o con modificaciones y/o traducciones a otro idioma."
4460
4461 #. (itstool) path: sect1/para
4462 #: C/index.docbook:79
4463 msgid ""
4464 "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
4465 "section of the <link linkend=\"fdl-document\">Document</link> that deals "
4466 "exclusively with the relationship of the publishers or authors of the "
4467 "Document to the Document's overall subject (or to related matters) and "
4468 "contains nothing that could fall directly within that overall subject. (For "
4469 "example, if the Document is in part a textbook of mathematics, a Secondary "
4470 "Section may not explain any mathematics.) The relationship could be a matter "
4471 "of historical connection with the subject or with related matters, or of "
4472 "legal, commercial, philosophical, ethical or political position regarding "
4473 "them."
4474 msgstr ""
4475 "Una <quote>Sección Secundaria</quote> es un apéndice con título o una "
4476 "sección preliminar del Documento que trata exclusivamente de la relación "
4477 "entre los autores o editores y el tema general del<link linkend=\"fdl-"
4478 "document\">Documento</link> que trata exclusivamente con la relación entre "
4479 "los editores o autores del Documento con el asunto general del Documento (o "
4480 "asuntos relacionados) y no contiene nada que pueda considerarse dentro del "
4481 "tema principal. (Por ejemplo, si el Documento es en parte un libro de texto "
4482 "de matemáticas, una Sección Secundaria no explicará nada de matemáticas.) La "
4483 "relación puede ser una conexión histórica con el asunto o temas "
4484 "relacionados, o una opinión legal, comercial, filosófica, ética o política "
4485 "acerca de ellos."
4486
4487 #. (itstool) path: sect1/para
4488 #: C/index.docbook:94
4489 msgid ""
4490 "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
4491 "secondary\"> Secondary Sections</link> whose titles are designated, as being "
4492 "those of Invariant Sections, in the notice that says that the <link linkend="
4493 "\"fdl-document\">Document</link> is released under this License."
4494 msgstr ""
4495 "Las <quote>Secciones Invariantes</quote> son ciertas <link linkend=\"fdl-"
4496 "secondary\">Secciones Secundarias</link> cuyos títulos son designados como "
4497 "Secciones Invariantes en la nota que indica que el <link linkend=\"fdl-"
4498 "document\">Documento</link> se publica bajo esta Licencia."
4499
4500 #. (itstool) path: sect1/para
4501 #: C/index.docbook:103
4502 msgid ""
4503 "The <quote>Cover Texts</quote> are certain short passages of text that are "
4504 "listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says "
4505 "that the <link linkend=\"fdl-document\">Document</link> is released under "
4506 "this License."
4507 msgstr ""
4508 " Los <quote>Textos de Cubierta</quote> son ciertos pasajes cortos de texto "
4509 "que se listan como Textos de Cubierta Delantera o Textos de Cubierta Trasera "
4510 "en la nota que indica que el <link linkend=\"fdl-document\">Documento</link> "
4511 "se publica bajo esta Licencia."
4512
4513 #. (itstool) path: sect1/para
4514 #: C/index.docbook:111
4515 msgid ""
4516 "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
4517 "Document</link> means a machine-readable copy, represented in a format whose "
4518 "specification is available to the general public, whose contents can be "
4519 "viewed and edited directly and straightforwardly with generic text editors "
4520 "or (for images composed of pixels) generic paint programs or (for drawings) "
4521 "some widely available drawing editor, and that is suitable for input to text "
4522 "formatters or for automatic translation to a variety of formats suitable for "
4523 "input to text formatters. A copy made in an otherwise Transparent file "
4524 "format whose markup has been designed to thwart or discourage subsequent "
4525 "modification by readers is not Transparent. A copy that is not "
4526 "<quote>Transparent</quote> is called <quote>Opaque</quote>."
4527 msgstr ""
4528 "Una copia <quote>Transparente</quote> del <link linkend=\"fdl-document"
4529 "\">Documento</link>, significa una copia para lectura en máquina, "
4530 "representada en un formato cuya especificación está disponible al público en "
4531 "general, cuyo contenido puede ser visto y editados directamente con editores "
4532 "de texto genéricos o (para imágenes compuestas por píxeles) con programas "
4533 "genéricos de manipulación de imágenes o (para dibujos) con algún editor de "
4534 "dibujos ampliamente disponible, y que sea adecuado como entrada para "
4535 "formateadores de texto o para su traducción automática a formatos adecuados "
4536 "para formateadores de texto. Una copia hecha en un formato definido como "
4537 "Transparente, pero cuyo marcaje o ausencia de él haya sido diseñado para "
4538 "impedir o dificultar modificaciones posteriores por parte de los lectores no "
4539 "es Transparente. Una copia que no es <quote>Transparente</quote> se denomina "
4540 "<quote>Opaca</quote>."
4541
4542 #. (itstool) path: sect1/para
4543 #: C/index.docbook:128 C/fdl-appendix.xml:128
4544 msgid ""
4545 "Examples of suitable formats for Transparent copies include plain ASCII "
4546 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4547 "a publicly available DTD, and standard-conforming simple HTML designed for "
4548 "human modification. Opaque formats include PostScript, PDF, proprietary "
4549 "formats that can be read and edited only by proprietary word processors, "
4550 "SGML or XML for which the DTD and/or processing tools are not generally "
4551 "available, and the machine-generated HTML produced by some word processors "
4552 "for output purposes only."
4553 msgstr ""
4554 "Como ejemplos de formatos adecuados para copias Transparentes están ASCII "
4555 "puro sin marcaje, formato de entrada de Texinfo, formato de entrada de "
4556 "LaTeX, SGML o XML usando una DTD disponible públicamente, y HTML, PostScript "
4557 "o PDF simples, que sigan los estándares y diseños para que los modifiquen "
4558 "personas.Los formatos Opacos incluyen formatos propietarios que pueden ser "
4559 "leídos y editados únicamente en procesadores de textos propietarios, SGML o "
4560 "XML para los cuáles las DTD y/o herramientas de procesamiento no estén "
4561 "ampliamente disponibles, y HTML, PostScript o PDF generados por algunos "
4562 "procesadores de textos sólo como salida."
4563
4564 #. (itstool) path: sect1/para
4565 #: C/index.docbook:141
4566 msgid ""
4567 "The <quote>Title Page</quote> means, for a printed book, the title page "
4568 "itself, plus such following pages as are needed to hold, legibly, the "
4569 "material this License requires to appear in the title page. For works in "
4570 "formats which do not have any title page as such, <quote>Title Page</quote> "
4571 "means the text near the most prominent appearance of the work's title, "
4572 "preceding the beginning of the body of the text."
4573 msgstr ""
4574 " La <quote>Portada</quote> significa, en un libro impreso, la página de "
4575 "título, más las páginas siguientes que sean necesarias para mantener "
4576 "legiblemente el material que esta Licencia requiere en la portada. Para "
4577 "trabajos en formatos que no tienen página de portada como tal, "
4578 "<quote>Portada</quote>significa el texto cercano a la aparición más "
4579 "prominente del título del trabajo,precediendo el comienzo del cuerpo del "
4580 "texto."
4581
4582 #. (itstool) path: sect1/title
4583 #: C/index.docbook:153 C/fdl-appendix.xml:153
4584 msgid "2. VERBATIM COPYING"
4585 msgstr "2. COPIA LITERAL"
4586
4587 #. (itstool) path: sect1/para
4588 #: C/index.docbook:154
4589 msgid ""
4590 "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
4591 "link> in any medium, either commercially or noncommercially, provided that "
4592 "this License, the copyright notices, and the license notice saying this "
4593 "License applies to the Document are reproduced in all copies, and that you "
4594 "add no other conditions whatsoever to those of this License. You may not use "
4595 "technical measures to obstruct or control the reading or further copying of "
4596 "the copies you make or distribute. However, you may accept compensation in "
4597 "exchange for copies. If you distribute a large enough number of copies you "
4598 "must also follow the conditions in <link linkend=\"fdl-section3\">section 3</"
4599 "link>."
4600 msgstr ""
4601 "Usted puede copiar y distribuir el <link linkend=\"fdl-document\">Documento</"
4602 "link> en cualquier soporte, sea en forma comercial o no, siempre y cuando "
4603 "proporcione esta Licencia, las notas de copyright y la nota que indica que "
4604 "esta Licencia se aplica al Documento reproduciéndola en todas las copias y "
4605 "que usted no añada ninguna otra condición a las expuestas en esta Licencia. "
4606 "Usted no puede usar medidas técnicas para obstruir o controlar la lectura o "
4607 "copia posterior de las copias que usted haga o distribuya. Sin embargo, "
4608 "usted puede aceptar compensación a cambio de las copias. Si distribuye un "
4609 "número suficientemente grande de copias también deberá seguir las "
4610 "condiciones de la <link linkend=\"fdl-section3\">sección 3</link>."
4611
4612 #. (itstool) path: sect1/para
4613 #: C/index.docbook:169 C/fdl-appendix.xml:169
4614 msgid ""
4615 "You may also lend copies, under the same conditions stated above, and you "
4616 "may publicly display copies."
4617 msgstr ""
4618 "Usted también puede prestar copias, bajo las mismas condiciones establecidas "
4619 "anteriormente, y puede exhibir copias públicamente."
4620
4621 #. (itstool) path: sect1/title
4622 #: C/index.docbook:176 C/fdl-appendix.xml:176
4623 msgid "3. COPYING IN QUANTITY"
4624 msgstr "3. COPIAR EN CANTIDAD"
4625
4626 #. (itstool) path: sect1/para
4627 #: C/index.docbook:177
4628 msgid ""
4629 "If you publish printed copies of the <link linkend=\"fdl-document"
4630 "\">Document</link> numbering more than 100, and the Document's license "
4631 "notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</link>, you "
4632 "must enclose the copies in covers that carry, clearly and legibly, all these "
4633 "Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on "
4634 "the back cover. Both covers must also clearly and legibly identify you as "
4635 "the publisher of these copies. The front cover must present the full title "
4636 "with all words of the title equally prominent and visible. You may add other "
4637 "material on the covers in addition. Copying with changes limited to the "
4638 "covers, as long as they preserve the title of the <link linkend=\"fdl-"
4639 "document\">Document</link> and satisfy these conditions, can be treated as "
4640 "verbatim copying in other respects."
4641 msgstr ""
4642 " Si publica copias impresas del <link linkend=\"fdl-document\">Documento</"
4643 "link> que sobrepasen las 100, y la nota de licencia del Documento exige "
4644 "<link linkend=\"fdl-cover-texts\">Textos de Cubierta</link>, debe incluirlas "
4645 "copias con cubiertas que lleven en forma clara y legible todos esos Textos "
4646 "de Cubierta: Textos de Cubierta Delantera en la cubierta delantera y Textos "
4647 "de Cubierta Trasera en la cubierta trasera. Ambas cubiertas deben "
4648 "identificarlo a Usted clara y legiblemente como editor de tales copias. La "
4649 "cubierta debe mostrar el título completo con todas las palabras igualmente "
4650 "prominentes y visibles. Además puede añadir otro material en las cubiertas. "
4651 "Las copias con cambios limitados a las cubiertas, siempre que conserven el "
4652 "título del <link linkend=\"fdl-document\">Documento</link> y satisfagan "
4653 "estas condiciones, pueden considerarse como copias literales en todos los "
4654 "aspectos."
4655
4656 #. (itstool) path: sect1/para
4657 #: C/index.docbook:195 C/fdl-appendix.xml:195
4658 msgid ""
4659 "If the required texts for either cover are too voluminous to fit legibly, "
4660 "you should put the first ones listed (as many as fit reasonably) on the "
4661 "actual cover, and continue the rest onto adjacent pages."
4662 msgstr ""
4663 " Si los textos requeridos para la cubierta son muy voluminosos para que "
4664 "ajusten legiblemente, debe colocar los primeros (tantos como sea razonable "
4665 "colocar) en la verdadera cubierta y situar el resto en páginas adyacentes."
4666
4667 #. (itstool) path: sect1/para
4668 #: C/index.docbook:202
4669 msgid ""
4670 "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</link> "
4671 "copies of the <link linkend=\"fdl-document\">Document</link> numbering more "
4672 "than 100, you must either include a machine-readable <link linkend=\"fdl-"
4673 "transparent\">Transparent</link> copy along with each Opaque copy, or state "
4674 "in or with each Opaque copy a publicly-accessible computer-network location "
4675 "containing a complete Transparent copy of the Document, free of added "
4676 "material, which the general network-using public has access to download "
4677 "anonymously at no charge using public-standard network protocols. If you use "
4678 "the latter option, you must take reasonably prudent steps, when you begin "
4679 "distribution of Opaque copies in quantity, to ensure that this Transparent "
4680 "copy will remain thus accessible at the stated location until at least one "
4681 "year after the last time you distribute an Opaque copy (directly or through "
4682 "your agents or retailers) of that edition to the public."
4683 msgstr ""
4684 "Si Usted publica o distribuye copias <link linkend=\"fdl-transparent"
4685 "\">Opacas</link> del <link linkend=\"fdl-document\">Documento</link> cuya "
4686 "cantidad exceda las 100, debe incluir una copia <link linkend=\"fdl-"
4687 "transparent\">Transparente</link>, que pueda ser leída por una máquina, con "
4688 "cada copia Opaca, o bien mostrar, en cada copia Opaca, una dirección de red "
4689 "donde cualquier usuario de la misma tenga acceso por medio de protocolos "
4690 "públicos y estandarizados a una copia Transparente del Documento completa, "
4691 "sin material adicional. Si usted hace uso de la última opción, deberá tomar "
4692 "las medidas necesarias, cuando comience la distribución de las copias Opacas "
4693 "en cantidad, para asegurar que esta copia Transparente permanecerá accesible "
4694 "en el sitio establecido por lo menos un año después de la última vez que "
4695 "distribuya una copia Opaca de esa edición al público (directamente o a "
4696 "través de sus agentes o distribuidores)."
4697
4698 #. (itstool) path: sect1/para
4699 #: C/index.docbook:222
4700 msgid ""
4701 "It is requested, but not required, that you contact the authors of the <link "
4702 "linkend=\"fdl-document\">Document</link> well before redistributing any "
4703 "large number of copies, to give them a chance to provide you with an updated "
4704 "version of the Document."
4705 msgstr ""
4706 "Se solicita, aunque no es requisito, que se ponga en contacto con los "
4707 "autores del <link linkend=\"fdl-document\">Documento</link> antes de "
4708 "redistribuir gran número de copias, para darles la oportunidad de que le "
4709 "proporcionen una versión actualizada del Documento."
4710
4711 #. (itstool) path: sect1/title
4712 #: C/index.docbook:231 C/fdl-appendix.xml:231
4713 msgid "4. MODIFICATIONS"
4714 msgstr "4. MODIFICACIONES"
4715
4716 #. (itstool) path: sect1/para
4717 #: C/index.docbook:232
4718 msgid ""
4719 "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
4720 "Version</link> of the <link linkend=\"fdl-document\">Document</link> under "
4721 "the conditions of sections <link linkend=\"fdl-section2\">2</link> and <link "
4722 "linkend=\"fdl-section3\">3</link> above, provided that you release the "
4723 "Modified Version under precisely this License, with the Modified Version "
4724 "filling the role of the Document, thus licensing distribution and "
4725 "modification of the Modified Version to whoever possesses a copy of it. In "
4726 "addition, you must do these things in the Modified Version:"
4727 msgstr ""
4728 "Puede copiar y distribuir una <link linkend=\"fdl-modified\">Versión "
4729 "Modificada</link> del <link linkend=\"fdl-document\">Documento</link> bajo "
4730 "las condiciones de las secciones <link linkend=\"fdl-section2\">2</link> y "
4731 "<link linkend=\"fdl-section3\">3</link> anteriores, siempre que Usted libere "
4732 "la Versión Modificada bajo esta misma Licencia, con la Versión Modificada "
4733 "haciendo el rol del Documento, por lo tanto dando Licencia de distribución y "
4734 "modificación de la Versión Modificada a quienquiera posea una copia de la "
4735 "misma. Además, debe hacer lo siguiente en la Versión Modificada:"
4736
4737 #. (itstool) path: formalpara/title
4738 #: C/index.docbook:248 C/fdl-appendix.xml:248
4739 msgid "A"
4740 msgstr "A"
4741
4742 #. (itstool) path: formalpara/para
4743 #: C/index.docbook:249
4744 msgid ""
4745 "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
4746 "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
4747 "document\">Document</link>, and from those of previous versions (which "
4748 "should, if there were any, be listed in the History section of the "
4749 "Document). You may use the same title as a previous version if the original "
4750 "publisher of that version gives permission."
4751 msgstr ""
4752 "Usar en la <link linkend=\"fdl-title-page\">Portada</link> (y en las "
4753 "cubiertas, si hay alguna) un título distinto al del <link linkend=\"fdl-"
4754 "document\">Documento</link> y de sus versiones anteriores (que deberían, si "
4755 "hay alguna, estar listadas en la sección de Historia del Documento). Puede "
4756 "usar el mismo título de versiones anteriores al original siempre y cuando "
4757 "quien las publicó originalmente otorgue permiso."
4758
4759 #. (itstool) path: formalpara/title
4760 #: C/index.docbook:264 C/fdl-appendix.xml:264
4761 msgid "B"
4762 msgstr "B"
4763
4764 #. (itstool) path: formalpara/para
4765 #: C/index.docbook:265
4766 msgid ""
4767 "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as authors, "
4768 "one or more persons or entities responsible for authorship of the "
4769 "modifications in the <link linkend=\"fdl-modified\">Modified Version</link>, "
4770 "together with at least five of the principal authors of the <link linkend="
4771 "\"fdl-document\">Document</link> (all of its principal authors, if it has "
4772 "less than five)."
4773 msgstr ""
4774 "Listar en la <link linkend=\"fdl-title-page\">Portada</link>, como autores, "
4775 "una o más personas o entidades responsables de la autoría de las "
4776 "modificaciones de la <link linkend=\"fdl-modified\">Versión Modificada</"
4777 "link>, junto con por lo menos cinco de los autores principales del <link "
4778 "linkend=\"fdl-document\">Documento</link> (todos sus autores principales, si "
4779 "hay menos de cinco), a menos que le eximan de tal requisito."
4780
4781 #. (itstool) path: formalpara/title
4782 #: C/index.docbook:279 C/fdl-appendix.xml:279
4783 msgid "C"
4784 msgstr "C"
4785
4786 #. (itstool) path: formalpara/para
4787 #: C/index.docbook:280
4788 msgid ""
4789 "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name of "
4790 "the publisher of the <link linkend=\"fdl-modified\">Modified Version</link>, "
4791 "as the publisher."
4792 msgstr ""
4793 "Mostrar en la <link linkend=\"fdl-title-page\">Portada</link> como editor "
4794 "el nombre del editor de la <link linkend=\"fdl-modified\">Versión "
4795 "Modificada</link>"
4796
4797 #. (itstool) path: formalpara/title
4798 #: C/index.docbook:291 C/fdl-appendix.xml:291
4799 msgid "D"
4800 msgstr "D"
4801
4802 #. (itstool) path: formalpara/para
4803 #: C/index.docbook:292
4804 msgid ""
4805 "Preserve all the copyright notices of the <link linkend=\"fdl-document"
4806 "\">Document</link>."
4807 msgstr ""
4808 "Conservar todas las notas de copyright del <link linkend=\"fdl-document"
4809 "\">Documento</link>."
4810
4811 #. (itstool) path: formalpara/title
4812 #: C/index.docbook:301 C/fdl-appendix.xml:301
4813 msgid "E"
4814 msgstr "E"
4815
4816 #. (itstool) path: formalpara/para
4817 #: C/index.docbook:302 C/fdl-appendix.xml:302
4818 msgid ""
4819 "Add an appropriate copyright notice for your modifications adjacent to the "
4820 "other copyright notices."
4821 msgstr ""
4822 "Añadir una nota de copyright apropiada a sus modificaciones, adyacente a las "
4823 "otras notas de copyright."
4824
4825 #. (itstool) path: formalpara/title
4826 #: C/index.docbook:311 C/fdl-appendix.xml:311
4827 msgid "F"
4828 msgstr "F"
4829
4830 #. (itstool) path: formalpara/para
4831 #: C/index.docbook:312
4832 msgid ""
4833 "Include, immediately after the copyright notices, a license notice giving "
4834 "the public permission to use the <link linkend=\"fdl-modified\">Modified "
4835 "Version</link> under the terms of this License, in the form shown in the "
4836 "Addendum below."
4837 msgstr ""
4838 "Incluir, inmediatamente después de los avisos de copyright, una nota de "
4839 "licencia dando el permiso público para usar la <link linkend=\"fdl-modified"
4840 "\">Versión Modificada</link> bajo los términos de esta Licencia, de la forma "
4841 "mostrada en el Adenda de más abajo."
4842
4843 #. (itstool) path: formalpara/title
4844 #: C/index.docbook:324 C/fdl-appendix.xml:324
4845 msgid "G"
4846 msgstr "G"
4847
4848 #. (itstool) path: formalpara/para
4849 #: C/index.docbook:325
4850 msgid ""
4851 "Preserve in that license notice the full lists of <link linkend=\"fdl-"
4852 "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
4853 "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-document"
4854 "\">Document's</link> license notice."
4855 msgstr ""
4856 "Incluir, inmediatamente después de ese aviso de licencia, la lista completa "
4857 "de <link linkend=\"fdl-invariant\">Secciones invariantes</link> y de los "
4858 "<link linkend=\"fdl-cover-texts\">Textos de Cubierta</link> que sean "
4859 "requeridos en el aviso de Licencia del <link linkend=\"fdl-document"
4860 "\">Documento</link> original."
4861
4862 #. (itstool) path: formalpara/title
4863 #: C/index.docbook:337 C/fdl-appendix.xml:337
4864 msgid "H"
4865 msgstr "H"
4866
4867 #. (itstool) path: formalpara/para
4868 #: C/index.docbook:338 C/fdl-appendix.xml:338
4869 msgid "Include an unaltered copy of this License."
4870 msgstr "Incluir una copia sin modificación de esta Licencia."
4871
4872 #. (itstool) path: formalpara/title
4873 #: C/index.docbook:346 C/fdl-appendix.xml:346
4874 msgid "I"
4875 msgstr "I"
4876
4877 #. (itstool) path: formalpara/para
4878 #: C/index.docbook:347
4879 msgid ""
4880 "Preserve the section entitled <quote>History</quote>, and its title, and add "
4881 "to it an item stating at least the title, year, new authors, and publisher "
4882 "of the <link linkend=\"fdl-modified\">Modified Version</link> as given on "
4883 "the <link linkend=\"fdl-title-page\">Title Page</link>. If there is no "
4884 "section entitled <quote>History</quote> in the <link linkend=\"fdl-document"
4885 "\">Document</link>, create one stating the title, year, authors, and "
4886 "publisher of the Document as given on its Title Page, then add an item "
4887 "describing the Modified Version as stated in the previous sentence."
4888 msgstr ""
4889 "Conservar la sección titulada <quote>Historia</quote>, conservar su Título y "
4890 "añadirle un elemento que declare al menos el título, el año, los nuevos "
4891 "autores y el editor de la <link linkend=\"fdl-modified\">Versión Modificada</"
4892 "link>, tal como figuran en la <link linkend=\"fdl-title-page\">Portada</"
4893 "link>. Si no hay una sección titulada <quote>Historia</quote> en el <link "
4894 "linkend=\"fdl-document\">Documento</link>, crear una estableciendo el "
4895 "título, el año, los autores y el editor del Documento, tal como figuran en "
4896 "su Portada, añadiendo además un elemento describiendo la Versión Modificada, "
4897 "como se estableció en la sentencia anterior."
4898
4899 #. (itstool) path: formalpara/title
4900 #: C/index.docbook:365 C/fdl-appendix.xml:365
4901 msgid "J"
4902 msgstr "J"
4903
4904 #. (itstool) path: formalpara/para
4905 #: C/index.docbook:366
4906 msgid ""
4907 "Preserve the network location, if any, given in the <link linkend=\"fdl-"
4908 "document\">Document</link> for public access to a <link linkend=\"fdl-"
4909 "transparent\">Transparent</link> copy of the Document, and likewise the "
4910 "network locations given in the Document for previous versions it was based "
4911 "on. These may be placed in the <quote>History</quote> section. You may omit "
4912 "a network location for a work that was published at least four years before "
4913 "the Document itself, or if the original publisher of the version it refers "
4914 "to gives permission."
4915 msgstr ""
4916 "Conservar la dirección en red, si la hay, dada en el <link linkend=\"fdl-"
4917 "document\">Documento</link> para el acceso público a una copia <link linkend="
4918 "\"fdl-transparent\">Transparente</link> del mismo, así como las otras "
4919 "direcciones de red dadas en el Documento para versiones anteriores en las "
4920 "que estuviese basado. Pueden ubicarse en la sección <quote>Historia</quote>. "
4921 "Se puede omitir la ubicación en red de un trabajo que haya sido publicado "
4922 "por lo menos cuatro años antes que el Documento mismo, o si el editor "
4923 "original de dicha versión da permiso."
4924
4925 #. (itstool) path: formalpara/title
4926 #: C/index.docbook:383 C/fdl-appendix.xml:383
4927 msgid "K"
4928 msgstr "K"
4929
4930 #. (itstool) path: formalpara/para
4931 #: C/index.docbook:384
4932 msgid ""
4933 "In any section entitled <quote>Acknowledgements</quote> or "
4934 "<quote>Dedications</quote>, preserve the section's title, and preserve in "
4935 "the section all the substance and tone of each of the contributor "
4936 "acknowledgements and/or dedications given therein."
4937 msgstr ""
4938 "En cualquier sección titulada <quote>Agradecimientos</quote> o "
4939 "<quote>Dedicatorias</quote>, conservar el título de la sección y conservar "
4940 "en ella toda la sustancia y el tono de los agradecimientos y/o dedicatorias "
4941 "incluidas por cada contribuyente."
4942
4943 #. (itstool) path: formalpara/title
4944 #: C/index.docbook:396 C/fdl-appendix.xml:396
4945 msgid "L"
4946 msgstr "L"
4947
4948 #. (itstool) path: formalpara/para
4949 #: C/index.docbook:397
4950 msgid ""
4951 "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</link> "
4952 "of the <link linkend=\"fdl-document\">Document</link>, unaltered in their "
4953 "text and in their titles. Section numbers or the equivalent are not "
4954 "considered part of the section titles."
4955 msgstr ""
4956 "Conservar todas las <link linkend=\"fdl-invariant\">Secciones Invariantes</"
4957 "link> del <link linkend=\"fdl-document\">Documento</link>, sin alterar su "
4958 "texto ni sus títulos. Los números de sección o equivalentes no se consideran "
4959 "parte de los títulos de la sección."
4960
4961 #. (itstool) path: formalpara/title
4962 #: C/index.docbook:409 C/fdl-appendix.xml:409
4963 msgid "M"
4964 msgstr "M"
4965
4966 #. (itstool) path: formalpara/para
4967 #: C/index.docbook:410
4968 msgid ""
4969 "Delete any section entitled <quote>Endorsements</quote>. Such a section may "
4970 "not be included in the <link linkend=\"fdl-modified\">Modified Version</"
4971 "link>."
4972 msgstr ""
4973 "Eliminar cualquier sección titulada <quote>Aprobaciones</quote>. Tales "
4974 "secciones no pueden estar incluidas en las <link linkend=\"fdl-modified"
4975 "\">Versiones Modificadas</link>."
4976
4977 #. (itstool) path: formalpara/title
4978 #: C/index.docbook:421 C/fdl-appendix.xml:421
4979 msgid "N"
4980 msgstr "N"
4981
4982 #. (itstool) path: formalpara/para
4983 #: C/index.docbook:422
4984 msgid ""
4985 "Do not retitle any existing section as <quote>Endorsements</quote> or to "
4986 "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
4987 "Section</link>."
4988 msgstr ""
4989 "No cambiar el título de ninguna sección existente a <quote>Aprobaciones</"
4990 "quote> ni a uno que entre en conflicto con el de alguna <link linkend=\"fdl-"
4991 "invariant\">Sección Invariante</link>."
4992
4993 #. (itstool) path: sect1/para
4994 #: C/index.docbook:432
4995 msgid ""
4996 "If the <link linkend=\"fdl-modified\">Modified Version</link> includes new "
4997 "front-matter sections or appendices that qualify as <link linkend=\"fdl-"
4998 "secondary\">Secondary Sections</link> and contain no material copied from "
4999 "the Document, you may at your option designate some or all of these sections "
5000 "as invariant. To do this, add their titles to the list of <link linkend="
5001 "\"fdl-invariant\">Invariant Sections</link> in the Modified Version's "
5002 "license notice. These titles must be distinct from any other section titles."
5003 msgstr ""
5004 " Si la <link linkend=\"fdl-modified\">Versión Modificada</link> incluye "
5005 "secciones o apéndices nuevos que cualifiquen como <link linkend=\"fdl-"
5006 "secondary\">Secciones Secundarias</link> y no contienen ningún material "
5007 "copiado del Documento, puede opcionalmente designar algunas o todas esas "
5008 "secciones como invariantes. Para hacerlo, añada sus títulos a la lista de "
5009 "<link linkend=\"fdl-invariant\">Secciones Invariantes</link> en el aviso de "
5010 "licencia de la Versión Modificada. Tales títulos deben ser distintos de "
5011 "cualquier otro título de sección."
5012
5013 #. (itstool) path: sect1/para
5014 #: C/index.docbook:444
5015 msgid ""
5016 "You may add a section entitled <quote>Endorsements</quote>, provided it "
5017 "contains nothing but endorsements of your <link linkend=\"fdl-modified"
5018 "\">Modified Version</link> by various parties--for example, statements of "
5019 "peer review or that the text has been approved by an organization as the "
5020 "authoritative definition of a standard."
5021 msgstr ""
5022 "Puede añadir una sección titulada <quote>Aprobaciones</quote>, siempre que "
5023 "contenga únicamente aprobaciones de su <link linkend=\"fdl-modified"
5024 "\">Versión Modificada</link> por otras fuentes --por ejemplo, observaciones "
5025 "de compañeros o que el texto ha sido aprobado por una organización como "
5026 "definición oficial de un estándar."
5027
5028 #. (itstool) path: sect1/para
5029 #: C/index.docbook:453
5030 msgid ""
5031 "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
5032 "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a <link "
5033 "linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of the list "
5034 "of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the <link linkend="
5035 "\"fdl-modified\">Modified Version</link>. Only one passage of Front-Cover "
5036 "Text and one of Back-Cover Text may be added by (or through arrangements "
5037 "made by) any one entity. If the <link linkend=\"fdl-document\">Document</"
5038 "link> already includes a cover text for the same cover, previously added by "
5039 "you or by arrangement made by the same entity you are acting on behalf of, "
5040 "you may not add another; but you may replace the old one, on explicit "
5041 "permission from the previous publisher that added the old one."
5042 msgstr ""
5043 "Puede añadir un pasaje de hasta cinco palabras como <link linkend=\"fdl-"
5044 "cover-texts\">Texto de Cubierta Delantera</link> y un pasaje de hasta 25 "
5045 "palabras como <link linkend=\"fdl-cover-texts\">Texto de Cubierta Trasera</"
5046 "link> al final de la lista de <link linkend=\"fdl-cover-texts\">Texto de "
5047 "Cubierta</link> en la <link linkend=\"fdl-modified\">Versión Modificada</"
5048 "link>. Una entidad sólo puede añadir (o hacer que se añada) un pasaje al "
5049 "Texto de Cubierta Delantera y uno al de Cubierta Trasera. Si el <link "
5050 "linkend=\"fdl-document\">Documento</link> ya incluye un textos de cubiertas "
5051 "añadidos previamente por usted o por acuerdo previo con la entidad que usted "
5052 "representa, usted no puede añadir otro; pero puede reemplazar el anterior, "
5053 "con permiso explícito del editor anterior que agregó el texto anterior."
5054
5055 #. (itstool) path: sect1/para
5056 #: C/index.docbook:470
5057 msgid ""
5058 "The author(s) and publisher(s) of the <link linkend=\"fdl-document"
5059 "\">Document</link> do not by this License give permission to use their names "
5060 "for publicity for or to assert or imply endorsement of any <link linkend="
5061 "\"fdl-modified\">Modified Version </link>."
5062 msgstr ""
5063 "Con esta Licencia ni los autores ni los editores del <link linkend=\"fdl-"
5064 "document\">Documento</link> dan permiso para usar sus nombres para "
5065 "publicidad ni para asegurar o implicar aprobación de cualquier <link linkend="
5066 "\"fdl-modified\">Versión Modificada</link>."
5067
5068 #. (itstool) path: sect1/title
5069 #: C/index.docbook:480 C/fdl-appendix.xml:480
5070 msgid "5. COMBINING DOCUMENTS"
5071 msgstr "5. COMBINAR DOCUMENTOS"
5072
5073 #. (itstool) path: sect1/para
5074 #: C/index.docbook:481
5075 msgid ""
5076 "You may combine the <link linkend=\"fdl-document\">Document</link> with "
5077 "other documents released under this License, under the terms defined in "
5078 "<link linkend=\"fdl-section4\">section 4</link> above for modified versions, "
5079 "provided that you include in the combination all of the <link linkend=\"fdl-"
5080 "invariant\">Invariant Sections</link> of all of the original documents, "
5081 "unmodified, and list them all as Invariant Sections of your combined work in "
5082 "its license notice."
5083 msgstr ""
5084 "Usted puede combinar el <link linkend=\"fdl-document\">Documento</link> con "
5085 "otros documentos liberados bajo esta Licencia, bajo los términos definidos "
5086 "en la sección <link linkend=\"fdl-section4\">section 4</link> más arriba "
5087 "para versiones modificadas, siempre que incluya en la combinación todas las "
5088 "<link linkend=\"fdl-invariant\">Secciones Invariantes</link> de todos los "
5089 "documentos originales, sin modificaciones, y las liste todas como Secciones "
5090 "Invariantes de su trabajo combinado en su aviso de licencia."
5091
5092 #. (itstool) path: sect1/para
5093 #: C/index.docbook:492
5094 msgid ""
5095 "The combined work need only contain one copy of this License, and multiple "
5096 "identical <link linkend=\"fdl-invariant\">Invariant Sections</link> may be "
5097 "replaced with a single copy. If there are multiple Invariant Sections with "
5098 "the same name but different contents, make the title of each such section "
5099 "unique by adding at the end of it, in parentheses, the name of the original "
5100 "author or publisher of that section if known, or else a unique number. Make "
5101 "the same adjustment to the section titles in the list of Invariant Sections "
5102 "in the license notice of the combined work."
5103 msgstr ""
5104 "El trabajo combinado necesita contener solamente una copia de esta Licencia, "
5105 "y múltiples <link linkend=\"fdl-invariant\">Secciones Invariantes</link> "
5106 "idénticas pueden reemplazarse por una sola copia. Si hay múltiples Secciones "
5107 "Invariantes con el mismo nombre pero con contenidos diferentes, haga el "
5108 "título de cada una de estas secciones único añadiéndolo al final de este, "
5109 "entre paréntesis, el nombre del autor o de quien editó originalmente esa "
5110 "sección, si es conocido, o si no, un número único. Haga el mismo ajuste a "
5111 "los títulos de sección en la lista de Secciones Invariantes en la nota de "
5112 "licencia del trabajo combinado."
5113
5114 #. (itstool) path: sect1/para
5115 #: C/index.docbook:505
5116 msgid ""
5117 "In the combination, you must combine any sections entitled <quote>History</"
5118 "quote> in the various original documents, forming one section entitled "
5119 "<quote>History</quote>; likewise combine any sections entitled "
5120 "<quote>Acknowledgements</quote>, and any sections entitled "
5121 "<quote>Dedications</quote>. You must delete all sections entitled "
5122 "<quote>Endorsements.</quote>"
5123 msgstr ""
5124 "En la combinación, debe combinar cualquier sección titulada <quote>Historia</"
5125 "quote> de los distintos documentos originales, formando una sección titulada "
5126 "<quote>Historia</quote>; de la misma forma, combine cualquier sección "
5127 "titulada <quote>Reconocimientos</quote> y cualquier sección titulada "
5128 "<quote>Dedicatorias</quote>. Debe eliminar todas las secciones tituladas "
5129 "<quote>Aprobaciones</quote>."
5130
5131 #. (itstool) path: sect1/title
5132 #: C/index.docbook:516 C/fdl-appendix.xml:516
5133 msgid "6. COLLECTIONS OF DOCUMENTS"
5134 msgstr "6. COLECCIONES DE DOCUMENTOS"
5135
5136 #. (itstool) path: sect1/para
5137 #: C/index.docbook:517
5138 msgid ""
5139 "You may make a collection consisting of the <link linkend=\"fdl-document"
5140 "\">Document</link> and other documents released under this License, and "
5141 "replace the individual copies of this License in the various documents with "
5142 "a single copy that is included in the collection, provided that you follow "
5143 "the rules of this License for verbatim copying of each of the documents in "
5144 "all other respects."
5145 msgstr ""
5146 "Puede hacer una colección que conste del <link linkend=\"fdl-document"
5147 "\">Documento</link> y de otros documentos publicados bajo esta Licencia, y "
5148 "reemplazar las copias individuales de esta Licencia en todos los documentos "
5149 "por una sola copia que esté incluida en la colección, siempre que siga las "
5150 "reglas de esta Licencia para cada copia literal de cada uno de los "
5151 "documentos en cualquiera de los demás aspectos."
5152
5153 #. (itstool) path: sect1/para
5154 #: C/index.docbook:527 C/fdl-appendix.xml:527
5155 msgid ""
5156 "You may extract a single document from such a collection, and distribute it "
5157 "individually under this License, provided you insert a copy of this License "
5158 "into the extracted document, and follow this License in all other respects "
5159 "regarding verbatim copying of that document."
5160 msgstr ""
5161 "Puede extraer un solo documento de una de tales colecciones y distribuirlo "
5162 "individualmente bajo esta Licencia, siempre que inserte una copia de esta "
5163 "Licencia en el documento extraído, y siga esta Licencia en todos los demás "
5164 "aspectos relativos a la copia literal de dicho documento."
5165
5166 #. (itstool) path: sect1/title
5167 #: C/index.docbook:537 C/fdl-appendix.xml:537
5168 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5169 msgstr "7. AGREGACIÓN CON TRABAJOS INDEPENDIENTES"
5170
5171 #. (itstool) path: sect1/para
5172 #: C/index.docbook:538
5173 msgid ""
5174 "A compilation of the <link linkend=\"fdl-document\">Document</link> or its "
5175 "derivatives with other separate and independent documents or works, in or on "
5176 "a volume of a storage or distribution medium, does not as a whole count as a "
5177 "<link linkend=\"fdl-modified\">Modified Version</link> of the Document, "
5178 "provided no compilation copyright is claimed for the compilation. Such a "
5179 "compilation is called an <quote>aggregate</quote>, and this License does not "
5180 "apply to the other self-contained works thus compiled with the Document , on "
5181 "account of their being thus compiled, if they are not themselves derivative "
5182 "works of the Document. If the <link linkend=\"fdl-cover-texts\">Cover Text</"
5183 "link> requirement of <link linkend=\"fdl-section3\">section 3</link> is "
5184 "applicable to these copies of the Document, then if the Document is less "
5185 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5186 "placed on covers that surround only the Document within the aggregate. "
5187 "Otherwise they must appear on covers around the whole aggregate."
5188 msgstr ""
5189 "Una recopilación que conste del <link linkend=\"fdl-document\">Documento</"
5190 "link> o sus derivados y de otros documentos o trabajos separados e "
5191 "independientes, en cualquier soporte de almacenamiento o distribución, no "
5192 "cuenta como un todo como una <link linkend=\"fdl-modified\">Versión "
5193 "Modificada</link> del Documento, siempre que no se reclame ningún derecho de "
5194 "copyright por la compilación. Dicha compilación se denomina un "
5195 "<quote>agregado</quote>, y esta Licencia no se aplica a otros trabajos "
5196 "autocontenidos incluidos con el Documento. teniendo en cuenta que son "
5197 "compilados, si no son los mismos trabajos derivados del Documento. Si el "
5198 "requisito de <link linkend=\"fdl-cover-texts\">Texto de Cubierta</link> de "
5199 "la <link linkend=\"fdl-section3\">sección 3</link> es aplicable a estas "
5200 "copias del Documento, entonces si el Documento es menor que un cuarto del "
5201 "agregado completo, los Textos de Cubierta del Documento pueden colocarse en "
5202 "cubiertas que enmarquen solamente el Documento dentro del agregado. En caso "
5203 "contrario deben aparecer en cubiertas impresas enmarcando todo el agregado."
5204
5205 #. (itstool) path: sect1/title
5206 #: C/index.docbook:561 C/fdl-appendix.xml:561
5207 msgid "8. TRANSLATION"
5208 msgstr "8. TRADUCCIÓN"
5209
5210 #. (itstool) path: sect1/para
5211 #: C/index.docbook:562
5212 msgid ""
5213 "Translation is considered a kind of modification, so you may distribute "
5214 "translations of the <link linkend=\"fdl-document\">Document</link> under the "
5215 "terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing <link "
5216 "linkend=\"fdl-invariant\"> Invariant Sections</link> with translations "
5217 "requires special permission from their copyright holders, but you may "
5218 "include translations of some or all Invariant Sections in addition to the "
5219 "original versions of these Invariant Sections. You may include a translation "
5220 "of this License provided that you also include the original English version "
5221 "of this License. In case of a disagreement between the translation and the "
5222 "original English version of this License, the original English version will "
5223 "prevail."
5224 msgstr ""
5225 "La traducción se considera un tipo de modificación, así que puede distribuir "
5226 "traducciones del <link linkend=\"fdl-document\">Documento</link> bajo los "
5227 "términos de la <link linkend=\"fdl-section4\">sección 4</link>. Reemplazar "
5228 "las <link linkend=\"fdl-invariant\">Secciones invariantes</link> con "
5229 "traducciones requiere permiso especial de los mantenedores de la "
5230 "propietarios del copyright, pero puede incluir traducciones de algunos o "
5231 "todas las Secciones invariantes. Puede incluir una traducción de esta "
5232 "licencia proporcionada que además incluya la versión original de esta "
5233 "Sección invariante en adición de esta licencia. En caso de desacuerdo "
5234 "prevalecerá la versión original en inglés."
5235
5236 #. (itstool) path: sect1/title
5237 #: C/index.docbook:580 C/fdl-appendix.xml:580
5238 msgid "9. TERMINATION"
5239 msgstr "9. TERMINACIÓN"
5240
5241 #. (itstool) path: sect1/para
5242 #: C/index.docbook:581
5243 msgid ""
5244 "You may not copy, modify, sublicense, or distribute the <link linkend=\"fdl-"
5245 "document\">Document</link> except as expressly provided for under this "
5246 "License. Any other attempt to copy, modify, sublicense or distribute the "
5247 "Document is void, and will automatically terminate your rights under this "
5248 "License. However, parties who have received copies, or rights, from you "
5249 "under this License will not have their licenses terminated so long as such "
5250 "parties remain in full compliance."
5251 msgstr ""
5252 " Usted no puede copiar, modificar, sublicenciar o distribuir el <link "
5253 "linkend=\"fdl-document\">Documento</link> salvo por lo permitido "
5254 "expresamente por esta Licencia. Cualquier otro intento de copia, "
5255 "modificación, sublicenciamiento o distribución del Documento es nulo, y dará "
5256 "por terminados automáticamente sus derechos bajo esa Licencia. Sin embargo, "
5257 "los terceros que hayan recibido copias, o derechos, de usted bajo esta "
5258 "Licencia no verán terminadas sus licencias, siempre que permanezcan en total "
5259 "conformidad con ella."
5260
5261 #. (itstool) path: sect1/title
5262 #: C/index.docbook:594 C/fdl-appendix.xml:594
5263 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5264 msgstr "10. FUTURAS REVISIONES DE ESTA LICENCIA"
5265
5266 #. (itstool) path: sect1/para
5267 #: C/index.docbook:595
5268 msgid ""
5269 "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
5270 "Software Foundation</ulink> may publish new, revised versions of the GNU "
5271 "Free Documentation License from time to time. Such new versions will be "
5272 "similar in spirit to the present version, but may differ in detail to "
5273 "address new problems or concerns. See <ulink type=\"http\" url=\"http://www."
5274 "gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
5275 msgstr ""
5276 "La <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
5277 "Software Foundation</ulink> puede publicar versiones nuevas y revisadas de "
5278 "la Licencia de Documentación Libre GNU de vez en cuando. Dichas versiones "
5279 "nuevas serán similares en espíritu a la presente versión, pero pueden "
5280 "diferir en detalles para solucionar nuevos problemas o preocupaciones. Vea "
5281 "<ulink type=\"http\" url=\"http://www.gnu.org/copyleft\">http://www.gnu.org/"
5282 "copyleft/</ulink>."
5283
5284 #. (itstool) path: sect1/para
5285 #: C/index.docbook:606
5286 msgid ""
5287 "Each version of the License is given a distinguishing version number. If the "
5288 "<link linkend=\"fdl-document\">Document</link> specifies that a particular "
5289 "numbered version of this License <quote>or any later version</quote> applies "
5290 "to it, you have the option of following the terms and conditions either of "
5291 "that specified version or of any later version that has been published (not "
5292 "as a draft) by the Free Software Foundation. If the Document does not "
5293 "specify a version number of this License, you may choose any version ever "
5294 "published (not as a draft) by the Free Software Foundation."
5295 msgstr ""
5296 "Cada versión de la licencia tiene un número de versión. Si la <link linkend="
5297 "\"fdl-document\">Documentación</link> especifica que el número particular de "
5298 "versión de esta Licencia <quote>o cualquier posterior versión</quote> "
5299 "aplicado sobre él, tiene la opción de seguir los términos y condiciones de "
5300 "cualquiera de esas versiones especificadas o de cualquiera de las versiones "
5301 "publicadas (no como borrador) por la Free Software Foundation. Si el "
5302 "Documento no especifica un número de versión de la licencia, puede elegir "
5303 "cualquier versión publicada (no como borrador) por la Free Software "
5304 "Foundation."
5305
5306 #. (itstool) path: sect1/title
5307 #: C/index.docbook:621 C/fdl-appendix.xml:621
5308 msgid "Addendum"
5309 msgstr "Addendum"
5310
5311 #. (itstool) path: sect1/para
5312 #: C/index.docbook:622 C/fdl-appendix.xml:622
5313 msgid ""
5314 "To use this License in a document you have written, include a copy of the "
5315 "License in the document and put the following copyright and license notices "
5316 "just after the title page:"
5317 msgstr ""
5318 "Para usar esta licencia en un documento que ha escrito, incluya una copia de "
5319 "la Licencia en el documento y ponga el siguiente copyright y las notas justo "
5320 "después del título de la página."
5321
5322 #. (itstool) path: blockquote/para
5323 #: C/index.docbook:629 C/fdl-appendix.xml:629
5324 msgid "Copyright YEAR YOUR NAME."
5325 msgstr ""
5326 "Copyright 2009-2016 Daniel Mustieles\n"
5327 "Copyright 2009-2010 Jorge González González\n"
5328 "Copyright 2009-2010 Francisco Javier Fernández Serrador"
5329
5330 #. (itstool) path: blockquote/para
5331 #: C/index.docbook:632
5332 msgid ""
5333 "Permission is granted to copy, distribute and/or modify this document under "
5334 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5335 "version published by the Free Software Foundation; with the <link linkend="
5336 "\"fdl-invariant\">Invariant Sections</link> being LIST THEIR TITLES, with "
5337 "the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</link> being LIST, "
5338 "and with the <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link> being "
5339 "LIST. A copy of the license is included in the section entitled <quote>GNU "
5340 "Free Documentation License</quote>."
5341 msgstr ""
5342 "Se otorga permiso para copiar, distribuir y/o modificar este documento bajo "
5343 "los términos de la Licencia de Documentación Libre de GNU, Versión 1.1 o "
5344 "cualquier otra versión posterior publicada por la Free Software Foundation; "
5345 "con las <link linkend=\"fdl-invariant\">Secciones Invariantes</link> siendo "
5346 "su LISTE SUS TÍTULOS, con <link linkend=\"fdl-cover-texts\">Textos de "
5347 "Cubierta Delantera</link> siendo LISTA, y con los <link linkend=\"fdl-cover-"
5348 "texts\">Textos de Cubierta Trasera</link> siendo LISTA. Una copia de la "
5349 "licencia está incluida en la sección titulada <quote>GNU Free Documentation "
5350 "License</quote>."
5351
5352 #. (itstool) path: sect1/para
5353 #: C/index.docbook:647
5354 msgid ""
5355 "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
5356 "write <quote>with no Invariant Sections</quote> instead of saying which ones "
5357 "are invariant. If you have no <link linkend=\"fdl-cover-texts\">Front-Cover "
5358 "Texts</link>, write <quote>no Front-Cover Texts</quote> instead of "
5359 "<quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="
5360 "\"fdl-cover-texts\">Back-Cover Texts</link>."
5361 msgstr ""
5362 "Si no tiene <link linkend=\"fdl-invariant\">Secciones Invariantes</link>, "
5363 "escriba <quote>sin Secciones Invariantes</quote> en vez de decir cuáles son "
5364 "invariantes. Si no tiene <link linkend=\"fdl-cover-texts\">Textos de "
5365 "Cubierta Frontal</link>, escriba <quote>sin Textos de Cubierta Frontal</"
5366 "quote>; de la misma manera para <link linkend=\"fdl-cover-texts\">Textos de "
5367 "Cubierta Trasera</link>."
5368
5369 #. (itstool) path: sect1/para
5370 #: C/index.docbook:657
5371 msgid ""
5372 "If your document contains nontrivial examples of program code, we recommend "
5373 "releasing these examples in parallel under your choice of free software "
5374 "license, such as the <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
5375 "gpl.html\"> GNU General Public License</ulink>, to permit their use in free "
5376 "software."
5377 msgstr ""
5378 "Si su documento contiene ejemplos de código de programa no triviales, "
5379 "recomendamos liberar estos ejemplos en paralelo bajo la licencia de software "
5380 "libre que usted elija, como la <ulink type=\"http\" url=\"http://www.gnu.org/"
5381 "copyleft/gpl.html\">Licencia Pública General de GNU (GNU General Public "
5382 "License)</ulink>, para permitir su uso en software libre."
5383
5384 #. (itstool) path: copyright/year
5385 #: C/fdl-appendix.xml:16
5386 msgid "2000"
5387 msgstr "2000"
5388
5389 #. (itstool) path: copyright/holder
5390 #: C/fdl-appendix.xml:16
5391 msgid "Free Software Foundation, Inc."
5392 msgstr "Free Software Foundation, Inc."
5393
5394 #. (itstool) path: address/street
5395 #: C/fdl-appendix.xml:20
5396 msgid "51 Franklin Street, Suite 330"
5397 msgstr "51 Franklin Street, Suite 330"
5398
5399 #. (itstool) path: address/city
5400 #: C/fdl-appendix.xml:21
5401 msgid "Boston"
5402 msgstr "Boston"
5403
5404 #. (itstool) path: address/state
5405 #: C/fdl-appendix.xml:21
5406 msgid "MA"
5407 msgstr "MA"
5408
5409 #. (itstool) path: address/postcode
5410 #: C/fdl-appendix.xml:22
5411 msgid "02110-1301"
5412 msgstr "02110-1301"
5413
5414 #. (itstool) path: address/country
5415 #: C/fdl-appendix.xml:22
5416 msgid "USA"
5417 msgstr "EE.UU."
5418
5419 #. (itstool) path: para/address
5420 #: C/fdl-appendix.xml:20
5421 msgid ""
5422 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
5423 "postcode-4/> <_:country-5/>"
5424 msgstr ""
5425 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
5426 "postcode-4/> <_:country-5/>"
5427
5428 #. (itstool) path: para/quote
5429 #: C/fdl-appendix.xml:34
5430 msgid "free"
5431 msgstr "libre"
5432
5433 #. (itstool) path: sect1/para
5434 #: C/fdl-appendix.xml:32
5435 msgid ""
5436 "The purpose of this License is to make a manual, textbook, or other written "
5437 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
5438 "effective freedom to copy and redistribute it, with or without modifying it, "
5439 "either commercially or noncommercially. Secondarily, this License preserves "
5440 "for the author and publisher a way to get credit for their work, while not "
5441 "being considered responsible for modifications made by others."
5442 msgstr ""
5443 "El propósito de esta Licencia es permitir que un manual, libro de texto, u "
5444 "otro documento escrito sea <_:quote-1/> en el sentido de libertad: asegurar "
5445 "a todo el mundo la libertad efectiva de copiarlo y redistribuirlo, con o sin "
5446 "modificaciones, de manera comercial o no. En segundo término, esta Licencia "
5447 "proporciona al autor y al editor una manera de obtener reconocimiento por su "
5448 "trabajo, sin que se le considere responsable de las modificaciones "
5449 "realizadas por otros."
5450
5451 #. (itstool) path: para/quote
5452 #: C/fdl-appendix.xml:44
5453 msgid "copyleft"
5454 msgstr "copyleft"
5455
5456 #. (itstool) path: sect1/para
5457 #: C/fdl-appendix.xml:43
5458 msgid ""
5459 "This License is a kind of <_:quote-1/>, which means that derivative works of "
5460 "the document must themselves be free in the same sense. It complements the "
5461 "GNU General Public License, which is a copyleft license designed for free "
5462 "software."
5463 msgstr ""
5464 "Esta Licencia es de tipo <_:quote-1/>, lo que significa que los trabajos "
5465 "derivados del documento deben a su vez ser libres en el mismo sentido. "
5466 "Complementa la Licencia Pública General de GNU, que es una licencia tipo "
5467 "copyleft diseñada para el software libre."
5468
5469 #. (itstool) path: para/quote
5470 #. (itstool) path: para/link
5471 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
5472 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
5473 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
5474 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
5475 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
5476 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
5477 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
5478 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
5479 #: C/fdl-appendix.xml:608
5480 msgid "Document"
5481 msgstr "Documento"
5482
5483 #. (itstool) path: para/quote
5484 #: C/fdl-appendix.xml:69
5485 msgid "you"
5486 msgstr "usted"
5487
5488 #. (itstool) path: sect1/para
5489 #: C/fdl-appendix.xml:63
5490 msgid ""
5491 "This License applies to any manual or other work that contains a notice "
5492 "placed by the copyright holder saying it can be distributed under the terms "
5493 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
5494 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
5495 msgstr ""
5496 "Esta Licencia se aplica a cualquier manual u otro trabajo que contenga un "
5497 "aviso colocado por el poseedor del copyright diciendo que puede distribuirse "
5498 "bajo los términos de esta Licencia. El <_:quote-1/>, abajo, se refiere a "
5499 "cualquier manual o trabajo. Cualquier miembro del público es un "
5500 "licenciatario, y será referido como <_:quote-2/>."
5501
5502 #. (itstool) path: para/quote
5503 #. (itstool) path: para/link
5504 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
5505 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
5506 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
5507 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
5508 msgid "Modified Version"
5509 msgstr "Versión modificada"
5510
5511 #. (itstool) path: sect1/para
5512 #: C/fdl-appendix.xml:72
5513 msgid ""
5514 "A <_:quote-1/> of the Document means any work containing the Document or a "
5515 "portion of it, either copied verbatim, or with modifications and/or "
5516 "translated into another language."
5517 msgstr ""
5518 "Una <_:quote-1/> del Documento significa cualquier trabajo que contenga el "
5519 "Documento o una porción del mismo, ya sea una copia literal o con "
5520 "modificaciones y/o traducciones a otro idioma."
5521
5522 #. (itstool) path: para/quote
5523 #: C/fdl-appendix.xml:80
5524 msgid "Secondary Section"
5525 msgstr "Sección secundaria"
5526
5527 #. (itstool) path: sect1/para
5528 #: C/fdl-appendix.xml:79
5529 msgid ""
5530 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:"
5531 "link-2/> that deals exclusively with the relationship of the publishers or "
5532 "authors of the Document to the Document's overall subject (or to related "
5533 "matters) and contains nothing that could fall directly within that overall "
5534 "subject. (For example, if the Document is in part a textbook of mathematics, "
5535 "a Secondary Section may not explain any mathematics.) The relationship could "
5536 "be a matter of historical connection with the subject or with related "
5537 "matters, or of legal, commercial, philosophical, ethical or political "
5538 "position regarding them."
5539 msgstr ""
5540 "Una <_:quote-1/> es un apéndice con título o una sección preliminar del "
5541 "Documento que trata exclusivamente de la relación entre los autores o "
5542 "editores y el tema general del <_:link-2/> que trata exclusivamente con la "
5543 "relación entre los editores o autores del Documento con el asunto general "
5544 "del Documento (o asuntos relacionados) y no contiene nada que pueda "
5545 "considerarse dentro del tema principal. (Por ejemplo, si el Documento es en "
5546 "parte un libro de texto de matemáticas, una Sección Secundaria no explicará "
5547 "nada de matemáticas.) La relación puede ser una conexión histórica con el "
5548 "asunto o temas relacionados, o una opinión legal, comercial, filosófica, "
5549 "ética o política acerca de ellos."
5550
5551 #. (itstool) path: para/quote
5552 #. (itstool) path: para/link
5553 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
5554 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
5555 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
5556 msgid "Invariant Sections"
5557 msgstr "Secciones invariantes"
5558
5559 #. (itstool) path: para/link
5560 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
5561 msgid "Secondary Sections"
5562 msgstr "Secciones secundarias"
5563
5564 #. (itstool) path: sect1/para
5565 #: C/fdl-appendix.xml:94
5566 msgid ""
5567 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
5568 "being those of Invariant Sections, in the notice that says that the <_:"
5569 "link-3/> is released under this License."
5570 msgstr ""
5571 "Las <_:quote-1/> son ciertas <_:link-2/> cuyos títulos son designados como "
5572 "Secciones Invariantes en la nota que indica que el <_:link-3/> se publica "
5573 "bajo esta Licencia."
5574
5575 #. (itstool) path: para/quote
5576 #. (itstool) path: para/link
5577 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
5578 #: C/fdl-appendix.xml:458
5579 msgid "Cover Texts"
5580 msgstr "Textos de cubierta"
5581
5582 #. (itstool) path: sect1/para
5583 #: C/fdl-appendix.xml:103
5584 msgid ""
5585 "The <_:quote-1/> are certain short passages of text that are listed, as "
5586 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:"
5587 "link-2/> is released under this License."
5588 msgstr ""
5589 " Los <_:quote-1/> son ciertos pasajes cortos de texto que se listan como "
5590 "Textos de Cubierta Delantera o Textos de Cubierta Trasera en la nota que "
5591 "indica que el <_:link-2/> se publica bajo esta Licencia."
5592
5593 #. (itstool) path: para/quote
5594 #. (itstool) path: para/link
5595 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
5596 #: C/fdl-appendix.xml:369
5597 msgid "Transparent"
5598 msgstr "Transparente"
5599
5600 #. (itstool) path: para/quote
5601 #. (itstool) path: para/link
5602 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
5603 msgid "Opaque"
5604 msgstr "Opacas"
5605
5606 #. (itstool) path: sect1/para
5607 #: C/fdl-appendix.xml:111
5608 msgid ""
5609 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
5610 "represented in a format whose specification is available to the general "
5611 "public, whose contents can be viewed and edited directly and "
5612 "straightforwardly with generic text editors or (for images composed of "
5613 "pixels) generic paint programs or (for drawings) some widely available "
5614 "drawing editor, and that is suitable for input to text formatters or for "
5615 "automatic translation to a variety of formats suitable for input to text "
5616 "formatters. A copy made in an otherwise Transparent file format whose markup "
5617 "has been designed to thwart or discourage subsequent modification by readers "
5618 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
5619 msgstr ""
5620 "Una copia <_:quote-1/> del <_:link-2/>, significa una copia para lectura en "
5621 "máquina, representada en un formato cuya especificación está disponible al "
5622 "público en general, cuyo contenido puede ser visto y editados directamente "
5623 "con editores de texto genéricos o (para imágenes compuestas por píxeles) con "
5624 "programas genéricos de manipulación de imágenes o (para dibujos) con algún "
5625 "editor de dibujos ampliamente disponible, y que sea adecuado como entrada "
5626 "para formateadores de texto o para su traducción automática a formatos "
5627 "adecuados para formateadores de texto. Una copia hecha en un formato "
5628 "definido como Transparente, pero cuyo marcaje o ausencia de él haya sido "
5629 "diseñado para impedir o dificultar modificaciones posteriores por parte de "
5630 "los lectores no es Transparente. Una copia que no es <_:quote-3/> se "
5631 "denomina <_:quote-4/>"
5632
5633 #. (itstool) path: para/quote
5634 #. (itstool) path: para/link
5635 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
5636 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
5637 msgid "Title Page"
5638 msgstr "Portada"
5639
5640 #. (itstool) path: sect1/para
5641 #: C/fdl-appendix.xml:141
5642 msgid ""
5643 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
5644 "following pages as are needed to hold, legibly, the material this License "
5645 "requires to appear in the title page. For works in formats which do not have "
5646 "any title page as such, <_:quote-2/> means the text near the most prominent "
5647 "appearance of the work's title, preceding the beginning of the body of the "
5648 "text."
5649 msgstr ""
5650 "La <_:quote-1/> significa, en un libro impreso, la página de título, más las "
5651 "páginas siguientes que sean necesarias para mantener legiblemente el "
5652 "material que esta Licencia requiere en la portada. Para trabajos en formatos "
5653 "que no tienen página de portada como tal, <_:quote-2/> significa el texto "
5654 "cercano a la aparición más prominente del título del trabajo,precediendo el "
5655 "comienzo del cuerpo del texto."
5656
5657 #. (itstool) path: para/link
5658 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
5659 msgid "section 3"
5660 msgstr "sección 3"
5661
5662 #. (itstool) path: sect1/para
5663 #: C/fdl-appendix.xml:154
5664 msgid ""
5665 "You may copy and distribute the <_:link-1/> in any medium, either "
5666 "commercially or noncommercially, provided that this License, the copyright "
5667 "notices, and the license notice saying this License applies to the Document "
5668 "are reproduced in all copies, and that you add no other conditions "
5669 "whatsoever to those of this License. You may not use technical measures to "
5670 "obstruct or control the reading or further copying of the copies you make or "
5671 "distribute. However, you may accept compensation in exchange for copies. If "
5672 "you distribute a large enough number of copies you must also follow the "
5673 "conditions in <_:link-2/>."
5674 msgstr ""
5675 "Usted puede copiar y distribuir el <_:link-1/> en cualquier soporte, sea en "
5676 "forma comercial o no, siempre y cuando proporcione esta Licencia, las notas "
5677 "de copyright y la nota que indica que esta Licencia se aplica al Documento "
5678 "reproduciéndola en todas las copias y que usted no añada ninguna otra "
5679 "condición a las expuestas en esta Licencia. Usted no puede usar medidas "
5680 "técnicas para obstruir o controlar la lectura o copia posterior de las "
5681 "copias que usted haga o distribuya. Sin embargo, usted puede aceptar "
5682 "compensación a cambio de las copias. Si distribuye un número suficientemente "
5683 "grande de copias también deberá seguir las condiciones de la <_:link-2/>."
5684
5685 #. (itstool) path: sect1/para
5686 #: C/fdl-appendix.xml:177
5687 msgid ""
5688 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
5689 "and the Document's license notice requires <_:link-2/>, you must enclose the "
5690 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
5691 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
5692 "cover. Both covers must also clearly and legibly identify you as the "
5693 "publisher of these copies. The front cover must present the full title with "
5694 "all words of the title equally prominent and visible. You may add other "
5695 "material on the covers in addition. Copying with changes limited to the "
5696 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
5697 "these conditions, can be treated as verbatim copying in other respects."
5698 msgstr ""
5699 " Si publica copias impresas del <_:link-1/> que sobrepasen las 100, y la "
5700 "nota de licencia del Documento exige <_:link-2/>, debe incluirlas copias con "
5701 "cubiertas que lleven en forma clara y legible todos esos Textos de Cubierta: "
5702 "Textos de Cubierta Delantera en la cubierta delantera y Textos de Cubierta "
5703 "Trasera en la cubierta trasera. Ambas cubiertas deben identificarlo a Usted "
5704 "clara y legiblemente como editor de tales copias. La cubierta debe mostrar "
5705 "el título completo con todas las palabras igualmente prominentes y visibles. "
5706 "Además puede añadir otro material en las cubiertas. Las copias con cambios "
5707 "limitados a las cubiertas, siempre que conserven el título del <_:link-3/> y "
5708 "satisfagan estas condiciones, pueden considerarse como copias literales en "
5709 "todos los aspectos."
5710
5711 #. (itstool) path: sect1/para
5712 #: C/fdl-appendix.xml:202
5713 msgid ""
5714 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
5715 "more than 100, you must either include a machine-readable <_:link-3/> copy "
5716 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
5717 "accessible computer-network location containing a complete Transparent copy "
5718 "of the Document, free of added material, which the general network-using "
5719 "public has access to download anonymously at no charge using public-standard "
5720 "network protocols. If you use the latter option, you must take reasonably "
5721 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
5722 "ensure that this Transparent copy will remain thus accessible at the stated "
5723 "location until at least one year after the last time you distribute an "
5724 "Opaque copy (directly or through your agents or retailers) of that edition "
5725 "to the public."
5726 msgstr ""
5727 "Si Usted publica o distribuye copias <_:link-1/> del <_:link-2/> cuya "
5728 "cantidad exceda las 100, debe incluir una copia <_:link-3/>, que pueda ser "
5729 "leída por una máquina, con cada copia Opaca, o bien mostrar, en cada copia "
5730 "Opaca, una dirección de red donde cualquier usuario de la misma tenga acceso "
5731 "por medio de protocolos públicos y estandarizados a una copia Transparente "
5732 "del Documento completa, sin material adicional. Si usted hace uso de la "
5733 "última opción, deberá tomar las medidas necesarias, cuando comience la "
5734 "distribución de las copias Opacas en cantidad, para asegurar que esta copia "
5735 "Transparente permanecerá accesible en el sitio establecido por lo menos un "
5736 "año después de la última vez que distribuya una copia Opaca de esa edición "
5737 "al público (directamente o a través de sus agentes o distribuidores)."
5738
5739 #. (itstool) path: sect1/para
5740 #: C/fdl-appendix.xml:222
5741 msgid ""
5742 "It is requested, but not required, that you contact the authors of the <_:"
5743 "link-1/> well before redistributing any large number of copies, to give them "
5744 "a chance to provide you with an updated version of the Document."
5745 msgstr ""
5746 "Se solicita, aunque no es requisito, que se ponga en contacto con los "
5747 "autores del <_:link-1/> antes de redistribuir gran número de copias, para "
5748 "darles la oportunidad de que le proporcionen una versión actualizada del "
5749 "Documento."
5750
5751 #. (itstool) path: para/link
5752 #: C/fdl-appendix.xml:236
5753 msgid "2"
5754 msgstr "2"
5755
5756 #. (itstool) path: para/link
5757 #: C/fdl-appendix.xml:237
5758 msgid "3"
5759 msgstr "3"
5760
5761 #. (itstool) path: sect1/para
5762 #: C/fdl-appendix.xml:232
5763 msgid ""
5764 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
5765 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
5766 "release the Modified Version under precisely this License, with the Modified "
5767 "Version filling the role of the Document, thus licensing distribution and "
5768 "modification of the Modified Version to whoever possesses a copy of it. In "
5769 "addition, you must do these things in the Modified Version:"
5770 msgstr ""
5771 "Puede copiar y distribuir una <_:link-1/> del <_:link-2/> bajo las "
5772 "condiciones de las secciones <_:link-3/> y <_:link-4/> anteriores, siempre "
5773 "que Usted libere la Versión Modificada bajo esta misma Licencia, con la "
5774 "Versión Modificada haciendo el rol del Documento, por lo tanto dando "
5775 "Licencia de distribución y modificación de la Versión Modificada a "
5776 "quienquiera posea una copia de la misma. Además, debe hacer lo siguiente en "
5777 "la Versión Modificada:"
5778
5779 #. (itstool) path: formalpara/para
5780 #: C/fdl-appendix.xml:249
5781 msgid ""
5782 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
5783 "that of the <_:link-2/>, and from those of previous versions (which should, "
5784 "if there were any, be listed in the History section of the Document). You "
5785 "may use the same title as a previous version if the original publisher of "
5786 "that version gives permission."
5787 msgstr ""
5788 "Usar en la <_:link-1/> (y en las cubiertas, si hay alguna) un título "
5789 "distinto al del <_:link-2/> y de sus versiones anteriores (que deberían, si "
5790 "hay alguna, estar listadas en la sección de Historia del Documento). Puede "
5791 "usar el mismo título de versiones anteriores al original siempre y cuando "
5792 "quien las publicó originalmente otorgue permiso."
5793
5794 #. (itstool) path: formalpara/para
5795 #: C/fdl-appendix.xml:265
5796 msgid ""
5797 "List on the <_:link-1/>, as authors, one or more persons or entities "
5798 "responsible for authorship of the modifications in the <_:link-2/>, together "
5799 "with at least five of the principal authors of the <_:link-3/> (all of its "
5800 "principal authors, if it has less than five)."
5801 msgstr ""
5802 "Listar en la <_:link-1/>, como autores, una o más personas o entidades "
5803 "responsables de la autoría de las modificaciones de la <_:link-2/>, junto "
5804 "con por lo menos cinco de los autores principales del <_:link-3/> (todos sus "
5805 "autores principales, si hay menos de cinco), a menos que le eximan de tal "
5806 "requisito."
5807
5808 #. (itstool) path: formalpara/para
5809 #: C/fdl-appendix.xml:280
5810 msgid ""
5811 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
5812 "the publisher."
5813 msgstr ""
5814 "Mostrar en la <_:link-1/> como editor el nombre del editor de la <_:link-2/>."
5815
5816 #. (itstool) path: formalpara/para
5817 #: C/fdl-appendix.xml:292
5818 msgid "Preserve all the copyright notices of the <_:link-1/>."
5819 msgstr "Conservar todas las notas de copyright del <_:link-1/>."
5820
5821 #. (itstool) path: formalpara/para
5822 #: C/fdl-appendix.xml:312
5823 msgid ""
5824 "Include, immediately after the copyright notices, a license notice giving "
5825 "the public permission to use the <_:link-1/> under the terms of this "
5826 "License, in the form shown in the Addendum below."
5827 msgstr ""
5828 "Incluir, inmediatamente después de los avisos de copyright, una nota de "
5829 "licencia dando el permiso público para usar la <_:link-1/>. bajo los "
5830 "términos de esta Licencia, de la forma mostrada en el Adenda de más abajo."
5831
5832 #. (itstool) path: para/link
5833 #: C/fdl-appendix.xml:330
5834 msgid "Document's"
5835 msgstr "Documento"
5836
5837 #. (itstool) path: formalpara/para
5838 #: C/fdl-appendix.xml:325
5839 msgid ""
5840 "Preserve in that license notice the full lists of <_:link-1/> and required "
5841 "<_:link-2/> given in the <_:link-3/> license notice."
5842 msgstr ""
5843 "Incluir, inmediatamente después de ese aviso de licencia, la lista completa "
5844 "de <_:link-1/> y de los <_:link-2/> que sean requeridos en el aviso de "
5845 "Licencia del <_:link-3/> original."
5846
5847 #. (itstool) path: para/quote
5848 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
5849 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
5850 msgid "History"
5851 msgstr "Historia"
5852
5853 #. (itstool) path: formalpara/para
5854 #: C/fdl-appendix.xml:347
5855 msgid ""
5856 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
5857 "item stating at least the title, year, new authors, and publisher of the <_:"
5858 "link-2/> as given on the <_:link-3/>. If there is no section entitled <_:"
5859 "quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
5860 "and publisher of the Document as given on its Title Page, then add an item "
5861 "describing the Modified Version as stated in the previous sentence."
5862 msgstr ""
5863 "Conservar la sección titulada <_:quote-1/>, conservar su Título y añadirle "
5864 "un elemento que declare al menos el título, el año, los nuevos autores y el "
5865 "editor de la <_:link-2/>, tal como figuran en la <_:link-3/>. Si no hay una "
5866 "sección titulada <_:quote-4/> en el <_:link-5/>, crear una estableciendo el "
5867 "título, el año, los autores y el editor del Documento, tal como figuran en "
5868 "su Portada, añadiendo además un elemento describiendo la Versión Modificada, "
5869 "como se estableció en la sentencia anterior."
5870
5871 #. (itstool) path: formalpara/para
5872 #: C/fdl-appendix.xml:366
5873 msgid ""
5874 "Preserve the network location, if any, given in the <_:link-1/> for public "
5875 "access to a <_:link-2/> copy of the Document, and likewise the network "
5876 "locations given in the Document for previous versions it was based on. These "
5877 "may be placed in the <_:quote-3/> section. You may omit a network location "
5878 "for a work that was published at least four years before the Document "
5879 "itself, or if the original publisher of the version it refers to gives "
5880 "permission."
5881 msgstr ""
5882 "Conservar la dirección en red, si la hay, dada en el <_:link-1/> para el "
5883 "acceso público a una copia <_:link-2/> del mismo, así como las otras "
5884 "direcciones de red dadas en el Documento para versiones anteriores en las "
5885 "que estuviese basado. Pueden ubicarse en la sección <_:quote-3/>. Se puede "
5886 "omitir la ubicación en red de un trabajo que haya sido publicado por lo "
5887 "menos cuatro años antes que el Documento mismo, o si el editor original de "
5888 "dicha versión da permiso."
5889
5890 #. (itstool) path: para/quote
5891 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5892 msgid "Acknowledgements"
5893 msgstr "Agradecimientos"
5894
5895 #. (itstool) path: para/quote
5896 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5897 msgid "Dedications"
5898 msgstr "Dedicatorias"
5899
5900 #. (itstool) path: formalpara/para
5901 #: C/fdl-appendix.xml:384
5902 msgid ""
5903 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5904 "title, and preserve in the section all the substance and tone of each of the "
5905 "contributor acknowledgements and/or dedications given therein."
5906 msgstr ""
5907 "En cualquier sección titulada <_:quote-1/> o <_:quote-2/>, conservar el "
5908 "título de la sección y conservar en ella toda la sustancia y el tono de los "
5909 "agradecimientos y/o dedicatorias incluidas por cada contribuyente."
5910
5911 #. (itstool) path: formalpara/para
5912 #: C/fdl-appendix.xml:397
5913 msgid ""
5914 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5915 "in their titles. Section numbers or the equivalent are not considered part "
5916 "of the section titles."
5917 msgstr ""
5918 "Conservar todas las <_:link-1/> del <_:link-2/>, sin alterar su texto ni sus "
5919 "títulos. Los números de sección o equivalentes no se consideran parte de los "
5920 "títulos de la sección."
5921
5922 #. (itstool) path: para/quote
5923 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5924 msgid "Endorsements"
5925 msgstr "Aprobaciones"
5926
5927 #. (itstool) path: formalpara/para
5928 #: C/fdl-appendix.xml:410
5929 msgid ""
5930 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5931 "in the <_:link-2/>."
5932 msgstr ""
5933 "Elimine cualquier sección titulada <_:quote-1/>. Tales secciones no pueden "
5934 "estar incluidas en las <_:link-2/>."
5935
5936 #. (itstool) path: para/link
5937 #: C/fdl-appendix.xml:425
5938 msgid "Invariant Section"
5939 msgstr "Sección invariante"
5940
5941 #. (itstool) path: formalpara/para
5942 #: C/fdl-appendix.xml:422
5943 msgid ""
5944 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5945 "with any <_:link-2/>."
5946 msgstr ""
5947 "No cambiar el título de ninguna sección existente a <_:quote-1/> ni a uno "
5948 "que entre en conflicto con el de alguna <_:link-2/>."
5949
5950 #. (itstool) path: sect1/para
5951 #: C/fdl-appendix.xml:432
5952 msgid ""
5953 "If the <_:link-1/> includes new front-matter sections or appendices that "
5954 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5955 "may at your option designate some or all of these sections as invariant. To "
5956 "do this, add their titles to the list of <_:link-3/> in the Modified "
5957 "Version's license notice. These titles must be distinct from any other "
5958 "section titles."
5959 msgstr ""
5960 "Si la <_:link-1/> incluye secciones o apéndices nuevos que cualifiquen como "
5961 "<_:link-2/> y no contienen ningún material copiado del Documento, puede "
5962 "opcionalmente designar algunas o todas esas secciones como invariantes. Para "
5963 "hacerlo, añada sus títulos a la lista de <_:link-3/> en el aviso de licencia "
5964 "de la Versión Modificada. Tales títulos deben ser distintos de cualquier "
5965 "otro título de sección."
5966
5967 #. (itstool) path: sect1/para
5968 #: C/fdl-appendix.xml:444
5969 msgid ""
5970 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5971 "but endorsements of your <_:link-2/> by various parties--for example, "
5972 "statements of peer review or that the text has been approved by an "
5973 "organization as the authoritative definition of a standard."
5974 msgstr ""
5975 "Puede añadir una sección titulada <_:quote-1/>, siempre que contenga "
5976 "únicamente aprobaciones de su <_:link-2/> por otras fuentes --por ejemplo, "
5977 "observaciones de compañeros o que el texto ha sido aprobado por una "
5978 "organización como definición oficial de un estándar."
5979
5980 #. (itstool) path: para/link
5981 #: C/fdl-appendix.xml:455
5982 msgid "Front-Cover Text"
5983 msgstr "Texto de cubierta delantera"
5984
5985 #. (itstool) path: para/link
5986 #: C/fdl-appendix.xml:457
5987 msgid "Back-Cover Text"
5988 msgstr "Texto de cubierta trasera"
5989
5990 #. (itstool) path: sect1/para
5991 #: C/fdl-appendix.xml:453
5992 msgid ""
5993 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5994 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5995 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5996 "Text may be added by (or through arrangements made by) any one entity. If "
5997 "the <_:link-5/> already includes a cover text for the same cover, previously "
5998 "added by you or by arrangement made by the same entity you are acting on "
5999 "behalf of, you may not add another; but you may replace the old one, on "
6000 "explicit permission from the previous publisher that added the old one."
6001 msgstr ""
6002 "Puede añadir un pasaje de hasta cinco palabras como <_:link-1/> y un pasaje "
6003 "de hasta 25 palabras como <_:link-2/> al final de la lista de <_:link-3/> en "
6004 "la <_:link-4/>. Una entidad sólo puede añadir (o hacer que se añada) un "
6005 "pasaje al Texto de Cubierta Delantera y uno al de Cubierta Trasera. Si el <_:"
6006 "link-5/> ya incluye un textos de cubiertas añadidos previamente por usted o "
6007 "por acuerdo previo con la entidad que usted representa, usted no puede "
6008 "añadir otro; pero puede reemplazar el anterior, con permiso explícito del "
6009 "editor anterior que agregó el texto anterior."
6010
6011 #. (itstool) path: sect1/para
6012 #: C/fdl-appendix.xml:470
6013 msgid ""
6014 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
6015 "give permission to use their names for publicity for or to assert or imply "
6016 "endorsement of any <_:link-2/>."
6017 msgstr ""
6018 "Con esta Licencia ni los autores ni los editores del <_:link-1/> dan permiso "
6019 "para usar sus nombres para publicidad ni para asegurar o implicar aprobación "
6020 "de cualquier <_:link-2/>."
6021
6022 #. (itstool) path: para/link
6023 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
6024 msgid "section 4"
6025 msgstr "sección 4"
6026
6027 #. (itstool) path: sect1/para
6028 #: C/fdl-appendix.xml:481
6029 msgid ""
6030 "You may combine the <_:link-1/> with other documents released under this "
6031 "License, under the terms defined in <_:link-2/> above for modified versions, "
6032 "provided that you include in the combination all of the <_:link-3/> of all "
6033 "of the original documents, unmodified, and list them all as Invariant "
6034 "Sections of your combined work in its license notice."
6035 msgstr ""
6036 "Usted puede combinar el <_:link-1/> con otros documentos liberados bajo esta "
6037 "Licencia, bajo los términos definidos en la sección <_:link-2/> más arriba "
6038 "para versiones modificadas, siempre que incluya en la combinación todas las "
6039 "<_:link-3/> de todos los documentos originales, sin modificaciones, y las "
6040 "liste todas como Secciones Invariantes de su trabajo combinado en su aviso "
6041 "de licencia."
6042
6043 #. (itstool) path: sect1/para
6044 #: C/fdl-appendix.xml:492
6045 msgid ""
6046 "The combined work need only contain one copy of this License, and multiple "
6047 "identical <_:link-1/> may be replaced with a single copy. If there are "
6048 "multiple Invariant Sections with the same name but different contents, make "
6049 "the title of each such section unique by adding at the end of it, in "
6050 "parentheses, the name of the original author or publisher of that section if "
6051 "known, or else a unique number. Make the same adjustment to the section "
6052 "titles in the list of Invariant Sections in the license notice of the "
6053 "combined work."
6054 msgstr ""
6055 "El trabajo combinado necesita contener solamente una copia de esta Licencia, "
6056 "y múltiples <_:link-1/> idénticas pueden reemplazarse por una sola copia. Si "
6057 "hay múltiples Secciones Invariantes con el mismo nombre pero con contenidos "
6058 "diferentes, haga el título de cada una de estas secciones único añadiéndolo "
6059 "al final de este, entre paréntesis, el nombre del autor o de quien editó "
6060 "originalmente esa sección, si es conocido, o si no, un número único. Haga el "
6061 "mismo ajuste a los títulos de sección en la lista de Secciones Invariantes "
6062 "en la nota de licencia del trabajo combinado."
6063
6064 #. (itstool) path: para/quote
6065 #: C/fdl-appendix.xml:511
6066 msgid "Endorsements."
6067 msgstr "Aprobaciones."
6068
6069 #. (itstool) path: sect1/para
6070 #: C/fdl-appendix.xml:505
6071 msgid ""
6072 "In the combination, you must combine any sections entitled <_:quote-1/> in "
6073 "the various original documents, forming one section entitled <_:quote-2/>; "
6074 "likewise combine any sections entitled <_:quote-3/>, and any sections "
6075 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
6076 msgstr ""
6077 "En la combinación, debe combinar cualquier sección titulada <_:quote-1/> de "
6078 "los distintos documentos originales, formando una sección titulada <_:"
6079 "quote-2/>; de la misma forma, combine cualquier sección titulada <_:quote-3/"
6080 "> y cualquier sección titulada <_:quote-4/>. Debe eliminar todas las "
6081 "secciones tituladas <_:quote-5/>."
6082
6083 #. (itstool) path: sect1/para
6084 #: C/fdl-appendix.xml:517
6085 msgid ""
6086 "You may make a collection consisting of the <_:link-1/> and other documents "
6087 "released under this License, and replace the individual copies of this "
6088 "License in the various documents with a single copy that is included in the "
6089 "collection, provided that you follow the rules of this License for verbatim "
6090 "copying of each of the documents in all other respects."
6091 msgstr ""
6092 "Puede hacer una colección que conste del <_:link-1/> y de otros documentos "
6093 "publicados bajo esta Licencia, y reemplazar las copias individuales de esta "
6094 "Licencia en todos los documentos por una sola copia que esté incluida en la "
6095 "colección, siempre que siga las reglas de esta Licencia para cada copia "
6096 "literal de cada uno de los documentos en cualquiera de los demás aspectos."
6097
6098 #. (itstool) path: para/quote
6099 #: C/fdl-appendix.xml:546
6100 msgid "aggregate"
6101 msgstr "agregado"
6102
6103 #. (itstool) path: para/link
6104 #: C/fdl-appendix.xml:550
6105 msgid "Cover Text"
6106 msgstr "Texto de cubierta"
6107
6108 #. (itstool) path: sect1/para
6109 #: C/fdl-appendix.xml:538
6110 msgid ""
6111 "A compilation of the <_:link-1/> or its derivatives with other separate and "
6112 "independent documents or works, in or on a volume of a storage or "
6113 "distribution medium, does not as a whole count as a <_:link-2/> of the "
6114 "Document, provided no compilation copyright is claimed for the compilation. "
6115 "Such a compilation is called an <_:quote-3/>, and this License does not "
6116 "apply to the other self-contained works thus compiled with the Document , on "
6117 "account of their being thus compiled, if they are not themselves derivative "
6118 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
6119 "applicable to these copies of the Document, then if the Document is less "
6120 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
6121 "placed on covers that surround only the Document within the aggregate. "
6122 "Otherwise they must appear on covers around the whole aggregate."
6123 msgstr ""
6124 "Una recopilación que conste del <_:link-1/> o sus derivados y de otros "
6125 "documentos o trabajos separados e independientes, en cualquier soporte de "
6126 "almacenamiento o distribución, no cuenta como un todo como un <_:link-2/> "
6127 "del Documento, siempre que no se reclame ningún derecho de copyright por la "
6128 "compilación. Dicha compilación se denomina un <_:quote-3/>, y esta Licencia "
6129 "no se aplica a otros trabajos autocontenidos incluidos con el Documento. "
6130 "teniendo en cuenta que son compilados, si no son los mismos trabajos "
6131 "derivados del Documento. Si el requisito de <_:link-4/> de la <_:link-5/> es "
6132 "aplicable a estas copias del Documento, entonces si el Documento es menor "
6133 "que un cuarto del agregado completo, los Textos de Cubierta del Documento "
6134 "pueden colocarse en cubiertas que enmarquen solamente el Documento dentro "
6135 "del agregado. En caso contrario deben aparecer en cubiertas impresas "
6136 "enmarcando todo el agregado."
6137
6138 #. (itstool) path: sect1/para
6139 #: C/fdl-appendix.xml:562
6140 msgid ""
6141 "Translation is considered a kind of modification, so you may distribute "
6142 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:"
6143 "link-3/> with translations requires special permission from their copyright "
6144 "holders, but you may include translations of some or all Invariant Sections "
6145 "in addition to the original versions of these Invariant Sections. You may "
6146 "include a translation of this License provided that you also include the "
6147 "original English version of this License. In case of a disagreement between "
6148 "the translation and the original English version of this License, the "
6149 "original English version will prevail."
6150 msgstr ""
6151 "La traducción se considera un tipo de modificación, así que puede distribuir "
6152 "traducciones del <_:link-1/> bajo los términos de la <_:link-2/>. Reemplazar "
6153 "las <_:link-3/> con traducciones requiere permiso especial de los "
6154 "mantenedores de la propietarios del copyright, pero puede incluir "
6155 "traducciones de algunos o todas las Secciones invariantes. Puede incluir una "
6156 "traducción de esta licencia proporcionada que además incluya la versión "
6157 "original de esta Sección invariante en adición de esta licencia. En caso de "
6158 "desacuerdo prevalecerá la versión original en inglés."
6159
6160 #. (itstool) path: sect1/para
6161 #: C/fdl-appendix.xml:581
6162 msgid ""
6163 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
6164 "as expressly provided for under this License. Any other attempt to copy, "
6165 "modify, sublicense or distribute the Document is void, and will "
6166 "automatically terminate your rights under this License. However, parties who "
6167 "have received copies, or rights, from you under this License will not have "
6168 "their licenses terminated so long as such parties remain in full compliance."
6169 msgstr ""
6170 " Usted no puede copiar, modificar, sublicenciar o distribuir el <_:link-1/> "
6171 "salvo por lo permitido expresamente por esta Licencia. Cualquier otro "
6172 "intento de copia, modificación, sublicenciamiento o distribución del "
6173 "Documento es nulo, y dará por terminados automáticamente sus derechos bajo "
6174 "esa Licencia. Sin embargo, los terceros que hayan recibido copias, o "
6175 "derechos, de usted bajo esta Licencia no verán terminadas sus licencias, "
6176 "siempre que permanezcan en total conformidad con ella."
6177
6178 #. (itstool) path: para/ulink
6179 #: C/fdl-appendix.xml:597
6180 msgid "Free Software Foundation"
6181 msgstr "Free Software Foundation"
6182
6183 #. (itstool) path: para/ulink
6184 #: C/fdl-appendix.xml:603
6185 msgid "http://www.gnu.org/copyleft/"
6186 msgstr "http://www.gnu.org/copyleft/"
6187
6188 #. (itstool) path: sect1/para
6189 #: C/fdl-appendix.xml:595
6190 msgid ""
6191 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
6192 "Documentation License from time to time. Such new versions will be similar "
6193 "in spirit to the present version, but may differ in detail to address new "
6194 "problems or concerns. See <_:ulink-2/>."
6195 msgstr ""
6196 "La <_:ulink-1/> puede publicar versiones nuevas y revisadas de la Licencia "
6197 "de Documentación Libre GNU de vez en cuando. Dichas versiones nuevas serán "
6198 "similares en espíritu a la presente versión, pero pueden diferir en detalles "
6199 "para solucionar nuevos problemas o preocupaciones. Consulte <_:ulink-2/>."
6200
6201 #. (itstool) path: para/quote
6202 #: C/fdl-appendix.xml:610
6203 msgid "or any later version"
6204 msgstr "o cualquier versión posterior"
6205
6206 #. (itstool) path: sect1/para
6207 #: C/fdl-appendix.xml:606
6208 msgid ""
6209 "Each version of the License is given a distinguishing version number. If the "
6210 "<_:link-1/> specifies that a particular numbered version of this License <_:"
6211 "quote-2/> applies to it, you have the option of following the terms and "
6212 "conditions either of that specified version or of any later version that has "
6213 "been published (not as a draft) by the Free Software Foundation. If the "
6214 "Document does not specify a version number of this License, you may choose "
6215 "any version ever published (not as a draft) by the Free Software Foundation."
6216 msgstr ""
6217 "Cada versión de la licencia tiene un número de versión. Si la <_:link-1/> "
6218 "especifica que el número particular de versión de esta Licencia <_:quote-2/> "
6219 "aplicado sobre él, tiene la opción de seguir los términos y condiciones de "
6220 "cualquiera de esas versiones especificadas o de cualquiera de las versiones "
6221 "publicadas (no como borrador) por la Free Software Foundation. Si el "
6222 "Documento no especifica un número de versión de la licencia, puede elegir "
6223 "cualquier versión publicada (no como borrador) por la Free Software "
6224 "Foundation."
6225
6226 #. (itstool) path: para/link
6227 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
6228 msgid "Front-Cover Texts"
6229 msgstr "Textos de cubierta delantera"
6230
6231 #. (itstool) path: para/link
6232 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
6233 msgid "Back-Cover Texts"
6234 msgstr "Textos de cubierta trasera"
6235
6236 #. (itstool) path: blockquote/para
6237 #: C/fdl-appendix.xml:632
6238 msgid ""
6239 "Permission is granted to copy, distribute and/or modify this document under "
6240 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
6241 "version published by the Free Software Foundation; with the <_:link-1/> "
6242 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:"
6243 "link-3/> being LIST. A copy of the license is included in the section "
6244 "entitled <_:quote-4/>."
6245 msgstr ""
6246 "Se otorga permiso para copiar, distribuir y/o modificar este documento bajo "
6247 "los términos de la Licencia de Documentación Libre de GNU, Versión 1.1 o "
6248 "cualquier otra versión posterior publicada por la Free Software Foundation; "
6249 "con las <_:link-1/> siendo su LISTE SUS TÍTULOS, con <_:link-2/> siendo "
6250 "LISTA, y con los <_:link-3/> siendo LISTA. Una copia de la licencia está "
6251 "incluida en la sección titulada <_:quote-4/>."
6252
6253 #. (itstool) path: para/quote
6254 #: C/fdl-appendix.xml:649
6255 msgid "with no Invariant Sections"
6256 msgstr "sin secciones invariantes"
6257
6258 #. (itstool) path: para/quote
6259 #: C/fdl-appendix.xml:652
6260 msgid "no Front-Cover Texts"
6261 msgstr "sin textos de cubierta delantera"
6262
6263 #. (itstool) path: para/quote
6264 #: C/fdl-appendix.xml:653
6265 msgid "Front-Cover Texts being LIST"
6266 msgstr "Textos de cubierta LISTADOS"
6267
6268 #. (itstool) path: sect1/para
6269 #: C/fdl-appendix.xml:647
6270 msgid ""
6271 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
6272 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:"
6273 "quote-5/>; likewise for <_:link-6/>."
6274 msgstr ""
6275 "Si no tiene <_:link-1/>, escriba <_:quote-2/> en lugar de indicar los que "
6276 "son invariantes. Si no tiene <_:link-3/>, escriba <_:quote-4/> en lugar de "
6277 "<_:quote-5/>; lo mismo para <_:link-6/>."
6278
6279 #. (itstool) path: para/ulink
6280 #: C/fdl-appendix.xml:661
6281 msgid "GNU General Public License"
6282 msgstr "Licencia Pública General GNU"
6283
6284 #. (itstool) path: sect1/para
6285 #: C/fdl-appendix.xml:657
6286 msgid ""
6287 "If your document contains nontrivial examples of program code, we recommend "
6288 "releasing these examples in parallel under your choice of free software "
6289 "license, such as the <_:ulink-1/>, to permit their use in free software."
6290 msgstr ""
6291 "Si su documento contiene ejemplos de código de programa no triviales, "
6292 "recomendamos liberar estos ejemplos en paralelo bajo la licencia de software "
6293 "libre que usted elija, como la <_:ulink-1/>, para permitir su uso en "
6294 "software libre."
6295
6296 #~| msgid ""
6297 #~| "<revnumber>1.29.1</revnumber> <date>28 Aug 2018</date> "
6298 #~| "<authorinitials>ss</authorinitials> <revremark>development</revremark>"
6299 #~ msgid ""
6300 #~ "<revnumber>1.30.1</revnumber> <date>09 May 2019</date> "
6301 #~ "<authorinitials>ss</authorinitials> <revremark>development</revremark>"
6302 #~ msgstr ""
6303 #~ "<revnumber>1.30.1</revnumber> <date>9 de mayo de 2019</date> "
6304 #~ "<authorinitials>ss</authorinitials> <revremark>desarrollo</revremark>"
6305
6306 #~ msgid "Setting up your project"
6307 #~ msgstr "Configurando su proyecto"
6308
6309 #~ msgid ""
6310 #~ "The next sections describe what steps to perform to integrate GTK-Doc "
6311 #~ "into your project. Theses sections assume we work on a project called "
6312 #~ "'meep'. This project contains a library called 'libmeep' and an end-user "
6313 #~ "app called 'meeper'. We also assume you will be using autoconf and "
6314 #~ "automake. In addition section <link linkend=\"plain_makefiles\">plain "
6315 #~ "makefiles or other build systems</link> will describe the basics needed "
6316 #~ "to work in a different build setup."
6317 #~ msgstr ""
6318 #~ "Las siguientes secciones describen los pasos que realizar para integrar "
6319 #~ "GTK-Doc en su proyecto. Estas secciones asumen que se trabaja en un "
6320 #~ "proyecto llamado «meep». Este proyecto contiene una biblioteca llamada "
6321 #~ "«libmeep» y una aplicación final de usuario llamada «meeper». También se "
6322 #~ "asume que usará «autoconf» y «automake». En la sección <link linkend="
6323 #~ "\"plain_makefiles\">Integración con makefiles u otros sistemas de "
6324 #~ "construcción</link> se describen las necesidades básicas para trabajar "
6325 #~ "con un sistema de construcción diferente."
6326
6327 #~ msgid ""
6328 #~ "Under your top-level project directory create folders called docs/"
6329 #~ "reference (this way you can also have docs/help for end-user "
6330 #~ "documentation). It is recommended to create another subdirectory with the "
6331 #~ "name of the doc-package. For packages with just one library this step is "
6332 #~ "not necessary."
6333 #~ msgstr ""
6334 #~ "Bajo su carpeta de nivel superior cree carpetas llamadas docs/reference "
6335 #~ "(de esta forma también puede tener docs/help para la documentación final "
6336 #~ "de usuario). Se recomienda crear otra subcarpeta con el nombre doc-"
6337 #~ "package. Para paquetes con una sola biblioteca este paso no es necesario."
6338
6339 #~ msgid "Example directory structure"
6340 #~ msgstr "Ejemplo de estructura de carpetas"
6341
6342 #~ msgid "This can then look as shown below: <_:example-1/>"
6343 #~ msgstr "Esto después aparecerá como se muestra debajo: <_:example-1/>"
6344
6345 #~ msgid ""
6346 #~ "Very easy! Just add one line to your <filename>configure.ac</filename> "
6347 #~ "script."
6348 #~ msgstr ""
6349 #~ "Muy fácil, simplemente añada una línea a su script <filename>configure."
6350 #~ "ac</filename>."
6351
6352 #~ msgid ""
6353 #~ "\n"
6354 #~ "# check for gtk-doc\n"
6355 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6356 #~ msgstr ""
6357 #~ "\n"
6358 #~ "# check for gtk-doc\n"
6359 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6360
6361 #~ msgid "Keep gtk-doc optional"
6362 #~ msgstr "Mantener gtk-doc como opcional"
6363
6364 #~ msgid ""
6365 #~ "\n"
6366 #~ "# check for gtk-doc\n"
6367 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6368 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6369 #~ "],[\n"
6370 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6371 #~ "])\n"
6372 #~ msgstr ""
6373 #~ "\n"
6374 #~ "# check for gtk-doc\n"
6375 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6376 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6377 #~ "],[\n"
6378 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6379 #~ "])\n"
6380
6381 #~ msgid ""
6382 #~ "This will require all developers to have gtk-doc installed. If it is okay "
6383 #~ "for your project to have optional api-doc build setup, you can solve this "
6384 #~ "as below. Keep it as is, as gtkdocize is looking for "
6385 #~ "<function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>"
6386 #~ msgstr ""
6387 #~ "Esto requerirá que todos los desarrolladores tengan gtk-doc instalado. Si "
6388 #~ "para su proyecto es correcto tener una configuración de construcción de "
6389 #~ "api-doc opcional, puede resolver esto como sigue. Manténgalo como está, "
6390 #~ "ya que gtkdocize busca en <function>GTK_DOC_CHECK</function> al inicio de "
6391 #~ "la línea. <_:example-1/>"
6392
6393 #~ msgid ""
6394 #~ "Furthermore it is recommended that you have the following line inside "
6395 #~ "your <filename>configure.ac</filename> script. This allows "
6396 #~ "<application>gtkdocize</application> to automatically copy the macro "
6397 #~ "definition for <function>GTK_DOC_CHECK</function> to your project."
6398 #~ msgstr ""
6399 #~ "Aún más, se recomienda que tenga la siguiente línea en su script "
6400 #~ "<filename>configure.ac</filename>. Esto permite que "
6401 #~ "<application>gtkdocize</application> copie automáticamente la definición "
6402 #~ "de la macro para <function>GTK_DOC_CHECK</function> a su proyecto."
6403
6404 #~ msgid "Preparation for gtkdocize"
6405 #~ msgstr "Preparación para gtkdocize"
6406
6407 #~ msgid ""
6408 #~ "\n"
6409 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6410 #~ msgstr ""
6411 #~ "\n"
6412 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6413
6414 #~ msgid ""
6415 #~ "Historically GTK-Doc was generating template files where developers "
6416 #~ "entered the docs. This turned out to be not so good (e.g. the need for "
6417 #~ "having generated files under version control). Since GTK-Doc 1.9 the "
6418 #~ "tools can get all the information from source comments and thus the "
6419 #~ "templates can be avoided. We encourage people to keep documentation in "
6420 #~ "the code. <application>gtkdocize</application> supports now a <option>--"
6421 #~ "flavour no-tmpl</option> option that chooses a makefile that skips tmpl "
6422 #~ "usage totally. Besides adding the option directly to the command "
6423 #~ "invocation, they can be added also to an environment variable called "
6424 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in "
6425 #~ "<symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have "
6426 #~ "never changed file in tmpl by hand and migrating from older gtkdoc "
6427 #~ "versions, please remove the directory (e.g. from version control system)."
6428 #~ msgstr ""
6429 #~ "Históricamente GTK-Doc generaba plantillas de archivos donde los "
6430 #~ "desarrolladores introducían los documentos. Al final esto resulto no ser "
6431 #~ "muy bueno (por ejemplo, por la necesidad de tener archivos generados bajo "
6432 #~ "un control de versiones). Desde la versión de DTK-Doc 1.9 las "
6433 #~ "herramientas pueden obtener toda la información desde los comentarios del "
6434 #~ "código fuente y por ello se pueden evitar las plantillas. Se anima a los "
6435 #~ "desarrolladores a mantener su documentación en el código. "
6436 #~ "<application>gtkdocize</application> ahora soporta una opción <option>--"
6437 #~ "flavour no-tmpl</option> que elije un makefile que omite completamente el "
6438 #~ "uso de plantillas. Además de añadir la opción directamente a la línea de "
6439 #~ "comandos al invocarlo, se pueden añadir a una variable de entorno llamada "
6440 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> o configurar como un segundo parámetro "
6441 #~ "en la macro <symbol>GTK_DOC_CHECK</symbol> en el script de configuración. "
6442 #~ "Si nunca ha cambiado un archivo tmpl (plantilla) a mano, elimine la "
6443 #~ "carpeta una vez (ej. desde el sistema de control de versiones)."
6444
6445 #~ msgid ""
6446 #~ "Now you can point your browser to <filename>docs/reference/&lt;"
6447 #~ "package&gt;/index.html</filename>. Yes, it's a bit disappointing still. "
6448 #~ "But hang-on, during the next chapter we tell you how to fill the pages "
6449 #~ "with life."
6450 #~ msgstr ""
6451 #~ "Ahora puede apuntar su navegador a <filename>docs/reference/&lt;"
6452 #~ "paquete&gt;/index.html</filename>. Sí, aún es un poco decepcionante. Pero "
6453 #~ "espere, durante el siguiente capítulo aprenderá a rellenar las páginas "
6454 #~ "con información."
6455
6456 #~ msgid "Documentation placement"
6457 #~ msgstr "Ubicación de la documentación"
6458
6459 #~ msgid ""
6460 #~ "In the past most documentation had to be filled into files residing "
6461 #~ "inside the <filename>tmpl</filename> directory. This has the "
6462 #~ "disadvantages that the information is often not updated and also that the "
6463 #~ "file tend to cause conflicts with version control systems."
6464 #~ msgstr ""
6465 #~ "En el pasado la mayoría de la documentación se debía rellenar en campos "
6466 #~ "dentro de la carpeta <filename>tmpl</filename>. Esto tiene las "
6467 #~ "desventajas de que la información. Esto tiene las desventajas de que la "
6468 #~ "información no se actualiza muy a menudo y que el archivo tiene tendencia "
6469 #~ "a causar conflictos con los sistemas de control de versiones."
6470
6471 #~ msgid ""
6472 #~ "The avoid the aforementioned problems we suggest putting the "
6473 #~ "documentation inside the sources. This manual will only describe this way "
6474 #~ "of documenting code."
6475 #~ msgstr ""
6476 #~ "Para evitar los problemas anteriormente mencionados, se sugiere dejar la "
6477 #~ "documentación dentro de los fuentes. Este manual sólo describe esta forma "
6478 #~ "de documentar el código."
6479
6480 #~ msgid "Example types file snippet"
6481 #~ msgstr "Fragmento de ejemplo de tipos de archivo"
6482
6483 #~ msgid "<guilabel>Python</guilabel> - optional - for gtkdoc-depscan"
6484 #~ msgstr "<guilabel>Python</guilabel>: opcional, para gtkdoc-depscan"
6485
6486 #~ msgid ""
6487 #~ "<guilabel>Generating the \"template\" files.</guilabel> "
6488 #~ "<application>gtkdoc-mktmpl</application> creates a number of files in the "
6489 #~ "<filename class=\"directory\">tmpl/</filename> subdirectory, using the "
6490 #~ "information gathered in the first step. (Note that this can be run "
6491 #~ "repeatedly. It will try to ensure that no documentation is ever lost.)"
6492 #~ msgstr ""
6493 #~ "<guilabel>Generar los archivos «plantilla».</guilabel> "
6494 #~ "<application>gtkdoc-mktmpl</application> crea un número de archivos en la "
6495 #~ "subcarpeta <filename class=\"directory\">tmpl/</filename>, usando la "
6496 #~ "información obtenida en el primer paso. (Tenga en cuenta que esto se "
6497 #~ "puede ejecutar de forma separada. Intentará asegurarse de que la "
6498 #~ "documentación nunca se pierde.)"
6499
6500 #~ msgid ""
6501 #~ "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to "
6502 #~ "keep documentation in the code. <application>gtkdocize</application> "
6503 #~ "supports now a <option>--flavour no-tmpl</option> option that chooses a "
6504 #~ "makefile that skips tmpl usage totally. If you have never changed file in "
6505 #~ "tmpl by hand, please remove the directory (e.g. from version control "
6506 #~ "system)."
6507 #~ msgstr ""
6508 #~ "Desde de GTK-Doc 1.9 se pueden evitar las plantillas. Animamos a la gente "
6509 #~ "a que mantenga la documentación en el código. <application>gtkdocize</"
6510 #~ "application> ahora soporta una opción <command>--flavour no-tmpl</"
6511 #~ "command> que elige un archivo makefile que omite completamente el uso de "
6512 #~ "tmpl. Si nunca ha cambiado a mano el archivo tmpl, elimine la carpeta una "
6513 #~ "vez (por ejemplo, desde el sistema de control de versiones)."
6514
6515 #~ msgid "(FIXME : Stability information)"
6516 #~ msgstr "(ARREGLAR: estabilidad de la información)"
6517
6518 #~ msgid "1.23"
6519 #~ msgstr "1.23"
6520
6521 #~ msgid "1.20"
6522 #~ msgstr "1.20"
6523
6524 #~ msgid ""
6525 #~ "Also, take a look at GObject Introspection annotation tags: http://live."
6526 #~ "gnome.org/GObjectIntrospection/Annotations"
6527 #~ msgstr ""
6528 #~ "Consulte también las anotaciones de las etiquetas de introspección de "
6529 #~ "GObject: http://live.gnome.org/GObjectIntrospection/Annotations"
6530
6531 #~ msgid ""
6532 #~ "<guilabel>DocBook DTD v3.0</guilabel> - This is the DocBook SGML DTD. "
6533 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
6534 #~ "com/davenport</ulink>"
6535 #~ msgstr ""
6536 #~ "<guilabel>DocBook DTD v3.0</guilabel>: Este es el DocBook SGML DTD. "
6537 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
6538 #~ "com/davenport</ulink>"
6539
6540 #~ msgid ""
6541 #~ "<guilabel>Jade v1.1</guilabel> - This is a DSSSL processor for converting "
6542 #~ "SGML to various formats. <ulink url=\"http://www.jclark.com/jade\" type="
6543 #~ "\"http\">http://www.jclark.com/jade</ulink>"
6544 #~ msgstr ""
6545 #~ "<guilabel>Jade v1.1</guilabel>: Este es el procesador DSSSL para "
6546 #~ "convertir SGML a varios formatos. <ulink url=\"http://www.jclark.com/jade"
6547 #~ "\" type=\"http\">http://www.jclark.com/jade</ulink>"
6548
6549 #~ msgid ""
6550 #~ "<guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code "
6551 #~ "to convert DocBook to HTML (and a few other formats). It's used together "
6552 #~ "with jade. I've customized the DSSSL code slightly, in gtk-doc.dsl, to "
6553 #~ "colour the program code listings/declarations, and to support global "
6554 #~ "cross-reference indices in the generated HTML. <ulink url=\"http://nwalsh."
6555 #~ "com/docbook/dsssl\" type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>"
6556 #~ msgstr ""
6557 #~ "<guilabel>Hojas de estilo DocBook modulares:</guilabel> Éste es el código "
6558 #~ "DSSSL para convertir DocBook a HTML (y otros cuantos formatos). Se usa "
6559 #~ "junto con jade. El código DSSSL está algo personalizado, en GTK-Doc dsl, "
6560 #~ "para colorear el código de listas/declaraciones del programa y soportar "
6561 #~ "índices de referencias cruzadas globales en el HTML generado. <ulink url="
6562 #~ "\"http://nwalsh.com/docbook/dsssl\" type=\"http\">http://nwalsh.com/"
6563 #~ "docbook/dsssl</ulink>."
6564
6565 #~ msgid ""
6566 #~ "<guilabel>docbook-to-man</guilabel> - if you want to create man pages "
6567 #~ "from the DocBook. I've customized the 'translation spec' slightly, to "
6568 #~ "capitalise section headings and add the 'GTK Library' title at the top of "
6569 #~ "the pages and the revision date at the bottom. There is a link to this on "
6570 #~ "<ulink url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora."
6571 #~ "com/davenport</ulink> NOTE: This does not work yet."
6572 #~ msgstr ""
6573 #~ "<guilabel>docbook-to-man</guilabel>: Si quiere crear páginas man desde el "
6574 #~ "DocBook. «translation spec» se ha personalizado un poco para capitalizar "
6575 #~ "la sección de cabeceras y añadir un título de «Biblioteca GTK» en la "
6576 #~ "parte superior de las páginas y la fecha de revisión al final. Existe un "
6577 #~ "enlace acerca de esto en <ulink url=\"http://www.ora.com/davenport\" type="
6578 #~ "\"http\">http://www.ora.com/davenport</ulink>. NOTA: Esto aún no funciona."
6579
6580 #~ msgid ""
6581 #~ "There is no standard place where the DocBook Modular Stylesheets are "
6582 #~ "installed."
6583 #~ msgstr ""
6584 #~ "No existe ningún sitio estándar donde se instalan las hojas de estilo "
6585 #~ "modulares de DocBook."
6586
6587 #~ msgid ""
6588 #~ "GTK-Doc's configure script searches these 3 directories automatically:"
6589 #~ msgstr ""
6590 #~ "El script de configuración de GTK-Doc busca estas tres carpetas "
6591 #~ "automáticamente:"
6592
6593 #~ msgid ""
6594 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (used by "
6595 #~ "RedHat)"
6596 #~ msgstr ""
6597 #~ "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (usado "
6598 #~ "por RedHat)"
6599
6600 #~ msgid ""
6601 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (used by Debian)"
6602 #~ msgstr ""
6603 #~ "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (usado por "
6604 #~ "Debian)"
6605
6606 #~ msgid "<filename> /usr/share/sgml/docbkdsl </filename> (used by SuSE)"
6607 #~ msgstr "<filename> /usr/share/sgml/docbkdsl </filename> (usado por SuSE)"
6608
6609 #~ msgid ""
6610 #~ "If you have the stylesheets installed somewhere else, you need to "
6611 #~ "configure GTK-Doc using the option: <command> --with-dsssl-dir=&lt;"
6612 #~ "PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>"
6613 #~ msgstr ""
6614 #~ "Si tiene las hojas de estilo instaladas en algún otro sitio, deberá "
6615 #~ "configurar GTK-Doc usando la opción: <command> --with-dsssl-dir=&lt;"
6616 #~ "RUTA_A_LA_CARPETA_DE_NIVEL_SUPERIOR_DE_LAS_HOJAS_DE_ESTILO&gt; </command>"
6617
6618 #~ msgid "1.18.1"
6619 #~ msgstr "1.18.1"
6620
6621 #~ msgid ""
6622 #~ "\n"
6623 #~ "\n"
6624 #~ "/**\n"
6625 #~ " * identifier:\n"
6626 #~ " *\n"
6627 #~ " * documentation ...\n"
6628 #~ " *\n"
6629 #~ " * # Sub heading #\n"
6630 #~ " *\n"
6631 #~ " * more documentation:\n"
6632 #~ " * - list item 1\n"
6633 #~ " * - list item 2\n"
6634 #~ " *\n"
6635 #~ " * Even more docs.\n"
6636 #~ " */\n"
6637 #~ "\n"
6638 #~ " "
6639 #~ msgstr ""
6640 #~ "\n"
6641 #~ "\n"
6642 #~ "/**\n"
6643 #~ " * identifier:\n"
6644 #~ " *\n"
6645 #~ " * documentation ...\n"
6646 #~ " *\n"
6647 #~ " * # Sub heading #\n"
6648 #~ " *\n"
6649 #~ " * more documentation:\n"
6650 #~ " * - list item 1\n"
6651 #~ " * - list item 2\n"
6652 #~ " *\n"
6653 #~ " * Even more docs.\n"
6654 #~ " */\n"
6655 #~ "\n"
6656 #~ " "
6657
6658 #~| msgid ""
6659 #~| "Since GTK-Doc-1.18 the tool supports a subset of the <ulink url=\"http://"
6660 #~| "daringfireball.net/projects/markdown/\">markdown language</ulink>. One "
6661 #~| "can use it for sub-headings and simple itemized lists. On older GTK-Doc "
6662 #~| "versions the content will be rendered as it (the list items will appear "
6663 #~| "in one line separated by dashes). <_:example-1/>"
6664 #~ msgid ""
6665 #~ "Since GTK-Doc-1.18 the tool supports a subset of the <ulink url=\"http://"
6666 #~ "daringfireball.net/projects/markdown/\">markdown language</ulink>. The "
6667 #~ "support has improved a lot with version 1.20. On older GTK-Doc versions "
6668 #~ "the content will be rendered as it (the list items will appear in one "
6669 #~ "line separated by dashes). <_:example-1/>"
6670 #~ msgstr ""
6671 #~ "Desde GTK-Doc-1.18 la herramienta soporta un subconjunto de <ulink url="
6672 #~ "\"http://daringfireball.net/projects/markdown/\">lenguajes de marcado</"
6673 #~ "ulink>. En la versión 1.20 se ha mejorado ucho este soporte. En versiones "
6674 #~ "más antiguas de GTK-Doc el contenido se puede renderizar como tal (la "
6675 #~ "lista de elementos aparecerá en una línea separada por guiones). <_:"
6676 #~ "example-1/>"
6677
6678 #~ msgid ""
6679 #~ "You may also want to enable GTK-Doc for the distcheck make target. Just "
6680 #~ "add the one line shown in the next example to your top-level "
6681 #~ "<filename>Makefile.am</filename>:"
6682 #~ msgstr ""
6683 #~ "Puede que también quiera activar GTK-Doc para el objetivo distcheckmate. "
6684 #~ "Simplemente añada la línea mostrada en el siguiente ejemplo a su nivel "
6685 #~ "superior de <filename>Makefile.am</filename>:"
6686
6687 #~ msgid "Enable GTK-Doc during make distcheck"
6688 #~ msgstr "Activar GTK-Doc durante make distcheck"
6689
6690 #~ msgid ""
6691 #~ "\n"
6692 #~ "\n"
6693 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
6694 #~ "\n"
6695 #~ " "
6696 #~ msgstr ""
6697 #~ "\n"
6698 #~ "\n"
6699 #~ "DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc\n"
6700 #~ "\n"
6701 #~ " "
6702
6703 #~ msgid "Chris"
6704 #~ msgstr "Chris"
6705
6706 #~ msgid "Lyttle"
6707 #~ msgstr "Lyttle"
6708
6709 #~ msgid "[email protected]"
6710 #~ msgstr "[email protected]"
6711
6712 #~ msgid "Dan"
6713 #~ msgstr "Dan"
6714
6715 #~ msgid "Mueth"
6716 #~ msgstr "Mueth"
6717
6718 #~ msgid "[email protected]"
6719 #~ msgstr "[email protected]"
6720
6721 #~ msgid "Stefan"
6722 #~ msgstr "Stefan"
6723
6724 #~ msgid "Kost"
6725 #~ msgstr "Kost"
6726
6727 #~ msgid "[email protected]"
6728 #~ msgstr "[email protected]"
6729
6730 #~ msgid "[email protected]"
6731 #~ msgstr "[email protected]"
6732
6733 #~ msgid "2000, 2005"
6734 #~ msgstr "2000, 2005"
6735
6736 #~ msgid "Dan Mueth and Chris Lyttle"
6737 #~ msgstr "Dan Mueth y Chris Lyttle"
6738
6739 #~ msgid "2007-2011"
6740 #~ msgstr "2007-2011"
6741
6742 #~ msgid "Stefan Sauer (Kost)"
6743 #~ msgstr "Stefan Sauer (Kost)"
6744
6745 #~ msgid "20 Sep 2011"
6746 #~ msgstr "20 de septiembre de 2011"
6747
6748 #~ msgid "ss"
6749 #~ msgstr "ss"
6750
6751 #~ msgid "development version"
6752 #~ msgstr "versión de desarrollo"
6753
6754 #~ msgid "1.18"
6755 #~ msgstr "1.18"
6756
6757 #~ msgid "14 sep 2011"
6758 #~ msgstr "14 de septiembre 2011"
6759
6760 #~ msgid "bug fixes, speedups, markdown support"
6761 #~ msgstr "correcciones de errores, mejoras de velocidad, soporte de marcado"
6762
6763 #~ msgid "1.17"
6764 #~ msgstr "1.17"
6765
6766 #~ msgid "26 Feb 2011"
6767 #~ msgstr "26 de febrero de 2011"
6768
6769 #~ msgid "sk"
6770 #~ msgstr "sk"
6771
6772 #~ msgid "urgent bug fix update"
6773 #~ msgstr "actualización de corrección de error urgente"
6774
6775 #~ msgid "1.16"
6776 #~ msgstr "1.16"
6777
6778 #~ msgid "14 Jan 2011"
6779 #~ msgstr "4 de enero de 2011"
6780
6781 #~ msgid "bugfixes, layout improvements"
6782 #~ msgstr "correcciones de errores, mejoras de diseño"
6783
6784 #~ msgid "1.15"
6785 #~ msgstr "1.15"
6786
6787 #~ msgid "21 May 2010"
6788 #~ msgstr "21 de mayo de 2010"
6789
6790 #~ msgid "bug and regression fixes"
6791 #~ msgstr "arreglos de errores y regresiones"
6792
6793 #~ msgid "1.14"
6794 #~ msgstr "1.14"
6795
6796 #~ msgid "28 March 2010"
6797 #~ msgstr "28 de marzo de 2010"
6798
6799 #~ msgid "bugfixes and performance improvements"
6800 #~ msgstr "solución de errores y mejoras de rendimiento"
6801
6802 #~ msgid "1.13"
6803 #~ msgstr "1.13"
6804
6805 #~ msgid "18 December 2009"
6806 #~ msgstr "18 de diciembre de 2009"
6807
6808 #~ msgid "broken tarball update"
6809 #~ msgstr "actualización de archivador «tarball» roto"
6810
6811 #~ msgid "1.12"
6812 #~ msgstr "1.12"
6813
6814 #~ msgid "new tool features and bugfixes"
6815 #~ msgstr "nuevas característicacs de la herramienta y errores solucionados"
6816
6817 #~ msgid "1.11"
6818 #~ msgstr "1.11"
6819
6820 #~ msgid "16 Novemebr 2008"
6821 #~ msgstr "16 de noviembre de 2008"
6822
6823 #~ msgid "mal"
6824 #~ msgstr "mal"
6825
6826 #~ msgid "GNOME doc-utils migration"
6827 #~ msgstr "Migración de GNOME doc-utils"
6828
6829 #~ msgid "xxx_get_type()"
6830 #~ msgstr "xxx_get_type()"
6831
6832 #~ msgid "&lt;package&gt;-sections.txt"
6833 #~ msgstr "&lt;paquete&gt;-sections.txt"
6834
6835 #~ msgid "explanation"
6836 #~ msgstr "explicación"
6837
6838 #~ msgid ""
6839 #~ "Missing or wrong naming in <placeholder-1/> file (see <placeholder-2/>)."
6840 #~ msgstr ""
6841 #~ "Faltan nombres o son erróneos en el archivo <placeholder-1/> (consultar "
6842 #~ "<placeholder-2/>)."
6843
6844 #~ msgid "GtkWidget"
6845 #~ msgstr "GtkWidget"
6846
6847 #~ msgid "&lt;package&gt;-docs.{xml,sgml}"
6848 #~ msgstr "&lt;paquete&gt;-docs.{xml,sgml}"
6849
6850 #~ msgid "&lt;package&gt;.hierarchy"
6851 #~ msgstr "&lt;paquete&gt;.jerarquía"
6852
6853 #~ msgid "xml/tree_index.sgml"
6854 #~ msgstr "xml/tree_index.sgml"
6855
6856 #~ msgid "xml/annotation-glossary.xml"
6857 #~ msgstr "xml/annotation-glossary.xml"
6858
6859 #~ msgid "Check that <placeholder-1/> is xi:included from <placeholder-2/>."
6860 #~ msgstr ""
6861 #~ "Compruebe que <placeholder-1/> está «xi:included» desde <placeholder-2/>."
6862
6863 #~| msgid "21 May 2010"
6864 #~ msgid "17 Jan 2011"
6865 #~ msgstr "17 de enero 2011"
6866
6867 #~ msgid "6 April 2010"
6868 #~ msgstr "6 de abril de 2010"
6869
6870 #~ msgid "19 December 2009"
6871 #~ msgstr "19 de diciembre de 2009"
6872
6873 #~ msgid "(FIXME) (stability) (glib-enums, ...)"
6874 #~ msgstr "(ARRÉGLAME) (estabilidad) (glib-enums, ...)"