Debian Codegraph @

help/manual/gl/gl.po

raw
1 # Galician translation for gtk-doc.
2 # Copyright (C) 2014 gtk-doc's COPYRIGHT HOLDER
3 # This file is distributed under the same license as the gtk-doc package.
4 # Fran Dieguez <[email protected]>, 2014.
5 msgid ""
6 msgstr ""
7 "Project-Id-Version: gtk-doc master\n"
8 "POT-Creation-Date: 2014-09-22 21:18+0000\n"
9 "PO-Revision-Date: 2014-09-23 02:11+0200\n"
10 "Last-Translator: Fran Dieguez <[email protected]>\n"
11 "Language-Team: [email protected]\n"
12 "Language: gl\n"
13 "MIME-Version: 1.0\n"
14 "Content-Type: text/plain; charset=UTF-8\n"
15 "Content-Transfer-Encoding: 8bit\n"
16 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
17 "X-Generator: Virtaal 0.7.1\n"
18
19 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
20 msgctxt "_"
21 msgid "translator-credits"
22 msgstr "Fran Diéguez <[email protected]>, 2014."
23
24 #. (itstool) path: bookinfo/title
25 #: C/index.docbook:12
26 msgid "GTK-Doc Manual"
27 msgstr "Manual de GTK-Doc"
28
29 #. (itstool) path: bookinfo/edition
30 #: C/index.docbook:13
31 msgid "1.20"
32 msgstr "1.20"
33
34 #. (itstool) path: abstract/para
35 #: C/index.docbook:14
36 msgid "User manual for developers with instructions of GTK-Doc usage."
37 msgstr ""
38 "Manual de usuarios para desenvolvedores con instrucións do uso de GTK-Doc."
39
40 #. (itstool) path: authorgroup/author
41 #: C/index.docbook:16
42 msgid ""
43 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
44 "<address> <email>[email protected]</email> </address> </affiliation>"
45 msgstr ""
46 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
47 "<address> <email>[email protected]</email> </address> </affiliation>"
48
49 #. (itstool) path: authorgroup/author
50 #: C/index.docbook:25
51 msgid ""
52 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
53 "<email>[email protected]</email> </address> </affiliation>"
54 msgstr ""
55 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
56 "<email>[email protected]</email> </address> </affiliation>"
57
58 #. (itstool) path: authorgroup/author
59 #: C/index.docbook:34
60 msgid ""
61 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
62 "<address> <email>[email protected]</email> </address> </affiliation>"
63 msgstr ""
64 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
65 "<address> <email>[email protected]</email> </address> </affiliation>"
66
67 #. (itstool) path: publisher/publishername
68 #: C/index.docbook:45
69 msgid "GTK-Doc project"
70 msgstr "Proxecto GTK-Doc"
71
72 #. (itstool) path: bookinfo/publisher
73 #: C/index.docbook:44
74 msgid ""
75 "<_:publishername-1/> <address><email>[email protected]</email></address>"
76 msgstr ""
77 "<_:publishername-1/> <address><email>[email protected]</email></address>"
78
79 #. (itstool) path: bookinfo/copyright
80 #: C/index.docbook:48
81 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
82 msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
83
84 #. (itstool) path: bookinfo/copyright
85 #: C/index.docbook:52
86 msgid "<year>2007-2014</year> <holder>Stefan Sauer (Kost)</holder>"
87 msgstr "<year>2007-2014</year> <holder>Stefan Sauer (Kost)</holder>"
88
89 #. (itstool) path: legalnotice/para
90 #: C/index.docbook:65
91 msgid ""
92 "Permission is granted to copy, distribute and/or modify this document under "
93 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
94 "Version 1.1 or any later version published by the Free Software Foundation "
95 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
96 "copy of the license is <link linkend=\"fdl\">included</link>."
97 msgstr ""
98 "Pode copiar, distribuír e modificar este documento baixo os termos da "
99 "<citetitle>Licenza de Documentación Libre GNU</citetitle>, na súa versión "
100 "1.1 ou posterior, publicada pola Free Software Foundation, sen seccións "
101 "invariantes e sen textos de portada ou de contraportada. <link linkend=\""
102 "fdl\">Inclúese</link> unha cópida da licenza."
103
104 #. (itstool) path: legalnotice/para
105 #: C/index.docbook:73
106 msgid ""
107 "Many of the names used by companies to distinguish their products and "
108 "services are claimed as trademarks. Where those names appear in any GNOME "
109 "documentation, and those trademarks are made aware to the members of the "
110 "GNOME Documentation Project, the names have been printed in caps or initial "
111 "caps."
112 msgstr ""
113
114 #. (itstool) path: revhistory/revision
115 #: C/index.docbook:83
116 msgid ""
117 "<revnumber>1.21.1</revnumber> <date>18 Jul 2014</date> <authorinitials>ss</"
118 "authorinitials> <revremark>development version</revremark>"
119 msgstr ""
120 "<revnumber>1.21.1</revnumber> <date>18 de Xullo de 2014</date> "
121 "<authorinitials>ss</authorinitials> <revremark>versión de "
122 "desenvolvemento</revremark>"
123
124 #. (itstool) path: revhistory/revision
125 #: C/index.docbook:89
126 msgid ""
127 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
128 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
129 "revremark>"
130 msgstr ""
131 "<revnumber>1.21</revnumber> <date>17 de Xullo de 2014</date> "
132 "<authorinitials>ss</authorinitials> <revremark>arranxos de erros, retirado "
133 "de características obsoletas</revremark>"
134
135 #. (itstool) path: revhistory/revision
136 #: C/index.docbook:95
137 msgid ""
138 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
139 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
140 "revremark>"
141 msgstr ""
142 "<revnumber>1.20</revnumber> <date>16 de Febreiro de 2014</date> "
143 "<authorinitials>ss</authorinitials> <revremark>arranxos de erros, "
144 "compatibilidade de markdown, melloras de estilo</revremark>"
145
146 #. (itstool) path: revhistory/revision
147 #: C/index.docbook:101
148 msgid ""
149 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
150 "authorinitials> <revremark>bug fixes</revremark>"
151 msgstr ""
152 "<revnumber>1.19</revnumber> <date>05 de Xuño de 2013</date> "
153 "<authorinitials>ss</authorinitials> <revremark>arranxos de erros</revremark>"
154
155 #. (itstool) path: revhistory/revision
156 #: C/index.docbook:107
157 msgid ""
158 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
159 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
160 msgstr ""
161 "<revnumber>1.18</revnumber> <date>14 de Setembro de 2011</date> "
162 "<authorinitials>ss</authorinitials> <revremark>arranxos de erros, melloras "
163 "de velocidade, compatibilidade de markdown</revremark>"
164
165 #. (itstool) path: revhistory/revision
166 #: C/index.docbook:113
167 msgid ""
168 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
169 "authorinitials> <revremark>urgent bug fix update</revremark>"
170 msgstr ""
171
172 #. (itstool) path: revhistory/revision
173 #: C/index.docbook:119
174 msgid ""
175 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
176 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
177 msgstr ""
178
179 #. (itstool) path: revhistory/revision
180 #: C/index.docbook:125
181 msgid ""
182 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
183 "authorinitials> <revremark>bug and regression fixes</revremark>"
184 msgstr ""
185
186 #. (itstool) path: revhistory/revision
187 #: C/index.docbook:131
188 msgid ""
189 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
190 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
191 msgstr ""
192
193 #. (itstool) path: revhistory/revision
194 #: C/index.docbook:137
195 msgid ""
196 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
197 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
198 "revremark>"
199 msgstr ""
200
201 #. (itstool) path: revhistory/revision
202 #: C/index.docbook:143
203 msgid ""
204 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
205 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
206 "bugfixes</revremark>"
207 msgstr ""
208
209 #. (itstool) path: revhistory/revision
210 #: C/index.docbook:149
211 msgid ""
212 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
213 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
214 "revremark>"
215 msgstr ""
216
217 #. (itstool) path: chapter/title
218 #: C/index.docbook:162
219 msgid "Introduction"
220 msgstr ""
221
222 #. (itstool) path: chapter/para
223 #: C/index.docbook:164
224 msgid ""
225 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
226 "it is used."
227 msgstr ""
228
229 #. (itstool) path: sect1/title
230 #: C/index.docbook:170
231 msgid "What is GTK-Doc?"
232 msgstr ""
233
234 #. (itstool) path: sect1/para
235 #: C/index.docbook:172
236 msgid ""
237 "GTK-Doc is used to document C code. It is typically used to document the "
238 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
239 "also be used to document application code."
240 msgstr ""
241
242 #. (itstool) path: sect1/title
243 #: C/index.docbook:180
244 msgid "How Does GTK-Doc Work?"
245 msgstr ""
246
247 #. (itstool) path: sect1/para
248 #: C/index.docbook:182
249 msgid ""
250 "GTK-Doc works by using documentation of functions placed inside the source "
251 "files in specially-formatted comment blocks, or documentation added to the "
252 "template files which GTK-Doc uses (though note that GTK-Doc will only "
253 "document functions that are declared in header files; it won't produce "
254 "output for static functions)."
255 msgstr ""
256
257 #. (itstool) path: sect1/para
258 #: C/index.docbook:189
259 msgid ""
260 "GTK-Doc consists of a number of perl scripts, each performing a different "
261 "step in the process."
262 msgstr ""
263
264 #. (itstool) path: sect1/para
265 #: C/index.docbook:194
266 msgid "There are 5 main steps in the process:"
267 msgstr ""
268
269 #. (itstool) path: listitem/para
270 #: C/index.docbook:201
271 msgid ""
272 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
273 "source files with the documentation for each function, macro, union etc. (In "
274 "the past information was entered in generated template files, which is not "
275 "recommended anymore)."
276 msgstr ""
277
278 #. (itstool) path: listitem/para
279 #: C/index.docbook:211
280 msgid ""
281 "<guilabel>Gathering information about the code.</guilabel> "
282 "<application>gtkdoc-scan</application> scans the header files of the code "
283 "looking for declarations of functions, macros, enums, structs, and unions. "
284 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
285 "containing a list of the declarations, placing them into sections according "
286 "to which header file they are in. On the first run this file is copied to "
287 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
288 "the sections, and the order of the declarations within them, to produce the "
289 "final desired order. The second file it generates is <filename>&lt;"
290 "module&gt;-decl.txt</filename>. This file contains the full declarations "
291 "found by the scanner. If for some reason one would like some symbols to show "
292 "up in the docs, where the full declaration cannot be found by the scanner or "
293 "the declaration should appear differently, one can place entities similar to "
294 "the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
295 "module&gt;-overrides.txt</filename>."
296 msgstr ""
297
298 #. (itstool) path: listitem/para
299 #: C/index.docbook:228
300 msgid ""
301 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
302 "query a library about any GObject subclasses it exports. It saves "
303 "information about each object's position in the class hierarchy and about "
304 "any GObject properties and signals it provides."
305 msgstr ""
306
307 #. (itstool) path: listitem/para
308 #: C/index.docbook:234
309 msgid ""
310 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
311 "needed in the past when GObject was still GtkObject inside gtk+."
312 msgstr ""
313
314 #. (itstool) path: listitem/para
315 #: C/index.docbook:241
316 msgid ""
317 "<guilabel>Generating the \"template\" files.</guilabel> <application>gtkdoc-"
318 "mktmpl</application> creates a number of files in the <filename class="
319 "\"directory\">tmpl/</filename> subdirectory, using the information gathered "
320 "in the first step. (Note that this can be run repeatedly. It will try to "
321 "ensure that no documentation is ever lost.)"
322 msgstr ""
323
324 #. (itstool) path: note/para
325 #: C/index.docbook:250
326 msgid ""
327 "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to keep "
328 "documentation in the code. <application>gtkdocize</application> supports now "
329 "a <option>--flavour no-tmpl</option> option that chooses a makefile that "
330 "skips tmpl usage totally. If you have never changed file in tmpl by hand, "
331 "please remove the directory (e.g. from version control system)."
332 msgstr ""
333
334 #. (itstool) path: listitem/para
335 #: C/index.docbook:262
336 msgid ""
337 "<guilabel>Generating the SGML/XML and HTML/PDF.</guilabel> "
338 "<application>gtkdoc-mkdb</application> turns the template files into SGML or "
339 "XML files in the <filename class=\"directory\">sgml/</filename> or <filename "
340 "class=\"directory\">xml/</filename> subdirectory. If the source code "
341 "contains documentation on functions, using the special comment blocks, it "
342 "gets merged in here. If there are no tmpl files used it only reads docs from "
343 "sources and introspection data. We recommend to use Docbook XML."
344 msgstr ""
345
346 #. (itstool) path: listitem/para
347 #: C/index.docbook:273
348 msgid ""
349 "<application>gtkdoc-mkhtml</application> turns the SGML/XML files into HTML "
350 "files in the <filename class=\"directory\">html/</filename> subdirectory. "
351 "Likewise <application>gtkdoc-mkpdf</application> turns the SGML/XML files "
352 "into a PDF document called <filename>&lt;package&gt;.pdf</filename>."
353 msgstr ""
354
355 #. (itstool) path: listitem/para
356 #: C/index.docbook:279
357 msgid ""
358 "Files in <filename class=\"directory\">sgml/</filename> or <filename class="
359 "\"directory\">xml/</filename> and <filename class=\"directory\">html/</"
360 "filename> directories are always overwritten. One should never edit them "
361 "directly."
362 msgstr ""
363
364 #. (itstool) path: listitem/para
365 #: C/index.docbook:287
366 msgid ""
367 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
368 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
369 "run to fix up any cross-references between separate documents. For example, "
370 "the GTK+ documentation contains many cross-references to types documented in "
371 "the GLib manual. When creating the source tarball for distribution, "
372 "<application>gtkdoc-rebase</application> turns all external links into web-"
373 "links. When installing distributed (pregenerated) docs the same application "
374 "will try to turn links back to local links (where those docs are installed)."
375 msgstr ""
376
377 #. (itstool) path: sect1/title
378 #: C/index.docbook:305
379 msgid "Getting GTK-Doc"
380 msgstr ""
381
382 #. (itstool) path: sect2/title
383 #: C/index.docbook:308
384 msgid "Requirements"
385 msgstr ""
386
387 #. (itstool) path: sect2/para
388 #: C/index.docbook:309
389 msgid "<guilabel>Perl v5</guilabel> - the main scripts are in Perl."
390 msgstr ""
391
392 #. (itstool) path: sect2/para
393 #: C/index.docbook:312
394 msgid ""
395 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="
396 "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
397 msgstr ""
398
399 #. (itstool) path: sect2/para
400 #: C/index.docbook:316
401 msgid ""
402 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="
403 "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http"
404 "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
405 msgstr ""
406
407 #. (itstool) path: sect2/para
408 #: C/index.docbook:320
409 msgid "<guilabel>Python</guilabel> - optional - for gtkdoc-depscan"
410 msgstr ""
411
412 #. (itstool) path: sect2/para
413 #: C/index.docbook:323
414 msgid ""
415 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
416 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
417 "examples"
418 msgstr ""
419
420 #. (itstool) path: sect1/title
421 #: C/index.docbook:331
422 msgid "About GTK-Doc"
423 msgstr ""
424
425 #. (itstool) path: sect1/para
426 #: C/index.docbook:333 C/index.docbook:347
427 msgid "(FIXME)"
428 msgstr ""
429
430 #. (itstool) path: sect1/para
431 #: C/index.docbook:337
432 msgid ""
433 "(History, authors, web pages, mailing list, license, future plans, "
434 "comparison with other similar systems.)"
435 msgstr ""
436
437 #. (itstool) path: sect1/title
438 #: C/index.docbook:345
439 msgid "About this Manual"
440 msgstr ""
441
442 #. (itstool) path: sect1/para
443 #: C/index.docbook:351
444 msgid "(who it is meant for, where you can get it, license)"
445 msgstr ""
446
447 #. (itstool) path: chapter/title
448 #: C/index.docbook:360
449 msgid "Setting up your project"
450 msgstr ""
451
452 #. (itstool) path: chapter/para
453 #: C/index.docbook:362
454 msgid ""
455 "The next sections describe what steps to perform to integrate GTK-Doc into "
456 "your project. Theses sections assume we work on a project called 'meep'. "
457 "This project contains a library called 'libmeep' and an end-user app called "
458 "'meeper'. We also assume you will be using autoconf and automake. In "
459 "addition section <link linkend=\"plain_makefiles\">plain makefiles or other "
460 "build systems</link> will describe the basics needed to work in a different "
461 "build setup."
462 msgstr ""
463
464 #. (itstool) path: sect1/title
465 #: C/index.docbook:373
466 msgid "Setting up a skeleton documentation"
467 msgstr ""
468
469 #. (itstool) path: sect1/para
470 #: C/index.docbook:375
471 msgid ""
472 "Under your top-level project directory create folders called docs/reference "
473 "(this way you can also have docs/help for end-user documentation). It is "
474 "recommended to create another subdirectory with the name of the doc-package. "
475 "For packages with just one library this step is not necessary."
476 msgstr ""
477
478 #. (itstool) path: example/title
479 #: C/index.docbook:384
480 msgid "Example directory structure"
481 msgstr ""
482
483 #. (itstool) path: example/programlisting
484 #: C/index.docbook:385
485 #, no-wrap
486 msgid ""
487 "\n"
488 "meep/\n"
489 " docs/\n"
490 " reference/\n"
491 " libmeep/\n"
492 " meeper/\n"
493 " src/\n"
494 " libmeep/\n"
495 " meeper/\n"
496 msgstr ""
497
498 #. (itstool) path: sect1/para
499 #: C/index.docbook:382
500 msgid "This can then look as shown below: <_:example-1/>"
501 msgstr ""
502
503 #. (itstool) path: sect1/title
504 #. (itstool) path: example/title
505 #: C/index.docbook:400 C/index.docbook:407
506 msgid "Integration with autoconf"
507 msgstr ""
508
509 #. (itstool) path: sect1/para
510 #: C/index.docbook:402
511 msgid ""
512 "Very easy! Just add one line to your <filename>configure.ac</filename> "
513 "script."
514 msgstr ""
515
516 #. (itstool) path: example/programlisting
517 #: C/index.docbook:408
518 #, no-wrap
519 msgid ""
520 "\n"
521 "# check for gtk-doc\n"
522 "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
523 msgstr ""
524
525 #. (itstool) path: example/title
526 #: C/index.docbook:420
527 msgid "Keep gtk-doc optional"
528 msgstr ""
529
530 #. (itstool) path: example/programlisting
531 #: C/index.docbook:421
532 #, no-wrap
533 msgid ""
534 "\n"
535 "# check for gtk-doc\n"
536 "m4_ifdef([GTK_DOC_CHECK], [\n"
537 "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
538 "],[\n"
539 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
540 "])\n"
541 msgstr ""
542
543 #. (itstool) path: sect1/para
544 #: C/index.docbook:415
545 msgid ""
546 "This will require all developers to have gtk-doc installed. If it is okay "
547 "for your project to have optional api-doc build setup, you can solve this as "
548 "below. Keep it as is, as gtkdocize is looking for <function>GTK_DOC_CHECK</"
549 "function> at the start of a line. <_:example-1/>"
550 msgstr ""
551
552 #. (itstool) path: sect1/para
553 #: C/index.docbook:432
554 msgid ""
555 "The first argument is used to check for the gtkdocversion at configure time. "
556 "The 2nd, optional argument is used by <application>gtkdocize</application>. "
557 "The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure "
558 "switches:"
559 msgstr ""
560
561 #. (itstool) path: listitem/para
562 #: C/index.docbook:438
563 msgid "--with-html-dir=PATH : path to installed docs"
564 msgstr ""
565
566 #. (itstool) path: listitem/para
567 #: C/index.docbook:439
568 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
569 msgstr ""
570
571 #. (itstool) path: listitem/para
572 #: C/index.docbook:440
573 msgid ""
574 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
575 msgstr ""
576
577 #. (itstool) path: listitem/para
578 #: C/index.docbook:441
579 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
580 msgstr ""
581
582 #. (itstool) path: important/para
583 #: C/index.docbook:445
584 msgid ""
585 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
586 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
587 "Otherwise pregenerated documentation is installed (which makes sense for "
588 "users but not for developers)."
589 msgstr ""
590
591 #. (itstool) path: sect1/para
592 #: C/index.docbook:453
593 msgid ""
594 "Furthermore it is recommended that you have the following line inside you "
595 "<filename>configure.ac</filename> script. This allows "
596 "<application>gtkdocize</application> to automatically copy the macro "
597 "definition for <function>GTK_DOC_CHECK</function> to your project."
598 msgstr ""
599
600 #. (itstool) path: example/title
601 #: C/index.docbook:461
602 msgid "Preparation for gtkdocize"
603 msgstr ""
604
605 #. (itstool) path: example/programlisting
606 #: C/index.docbook:462
607 #, no-wrap
608 msgid ""
609 "\n"
610 "AC_CONFIG_MACRO_DIR(m4)\n"
611 msgstr ""
612
613 #. (itstool) path: sect1/para
614 #: C/index.docbook:467
615 msgid ""
616 "After all changes to <filename>configure.ac</filename> are made, update the "
617 "<filename>configure</filename> file. This can be done by re-running "
618 "<code>autoreconf -i</code> or <code>autogen.sh</code>."
619 msgstr ""
620
621 #. (itstool) path: sect1/title
622 #: C/index.docbook:475
623 msgid "Integration with automake"
624 msgstr ""
625
626 #. (itstool) path: sect1/para
627 #: C/index.docbook:477
628 msgid ""
629 "First copy the <filename>Makefile.am</filename> from the <filename class="
630 "\"directory\">examples</filename> sub directory of the <ulink url=\"https://"
631 "git.gnome.org/browse/gtk-doc/tree/examples/Makefile.am\">gtkdoc-sources</"
632 "ulink> to your project's API documentation directory ( <filename class="
633 "\"directory\">./docs/reference/&lt;package&gt;</filename>). A local copy "
634 "should be available under e.g. <filename>/usr/share/doc/gtk-doc-tools/"
635 "examples/Makefile.am</filename>. If you have multiple doc-packages repeat "
636 "this for each one."
637 msgstr ""
638
639 #. (itstool) path: sect1/para
640 #: C/index.docbook:488
641 msgid ""
642 "The next step is to edit the settings inside the <filename>Makefile.am</"
643 "filename>. All the settings have a comment above that describes their "
644 "purpose. Most settings are extra flags passed to the respective tools. Every "
645 "tool has a variable of the form <option>&lt;TOOLNAME&gt;_OPTIONS</option>. "
646 "All the tools support <option>--help</option> to list the supported "
647 "parameters."
648 msgstr ""
649
650 #. (itstool) path: sect1/title
651 #: C/index.docbook:502
652 msgid "Integration with autogen"
653 msgstr ""
654
655 #. (itstool) path: sect1/para
656 #: C/index.docbook:504
657 msgid ""
658 "Most projects will have an <filename>autogen.sh</filename> script to setup "
659 "the build infrastructure after a checkout from version control system (such "
660 "as cvs/svn/git). GTK-Doc comes with a tool called <application>gtkdocize</"
661 "application> which can be used in such a script. It should be run before "
662 "autoheader, automake or autoconf."
663 msgstr ""
664
665 #. (itstool) path: example/title
666 #: C/index.docbook:513
667 msgid "Running gtkdocize from autogen.sh"
668 msgstr ""
669
670 #. (itstool) path: example/programlisting
671 #: C/index.docbook:514
672 #, no-wrap
673 msgid ""
674 "\n"
675 "gtkdocize || exit 1\n"
676 msgstr ""
677
678 #. (itstool) path: sect1/para
679 #: C/index.docbook:520
680 msgid ""
681 "When running <application>gtkdocize</application> it copies <filename>gtk-"
682 "doc.make</filename> to your project root (or any directory specified by the "
683 "<option>--docdir</option> option). It also checks you configure script for "
684 "the <function>GTK_DOC_CHECK</function> invocation. This macro can be used to "
685 "pass extra parameters to <application>gtkdocize</application>."
686 msgstr ""
687
688 #. (itstool) path: sect1/para
689 #: C/index.docbook:529
690 msgid ""
691 "Historically GTK-Doc was generating template files where developers entered "
692 "the docs. This turned out to be not so good (e.g. the need for having "
693 "generated files under version control). Since GTK-Doc 1.9 the tools can get "
694 "all the information from source comments and thus the templates can be "
695 "avoided. We encourage people to keep documentation in the code. "
696 "<application>gtkdocize</application> supports now a <option>--flavour no-"
697 "tmpl</option> option that chooses a makefile that skips tmpl usage totally. "
698 "Besides adding the option directly to the command invocation, they can be "
699 "added also to an environment variable called <symbol>GTKDOCIZE_FLAGS</"
700 "symbol> or set as a 2nd parameter in <symbol>GTK_DOC_CHECK</symbol> macro in "
701 "the configure script. If you have never changed file in tmpl by hand and "
702 "migrating from older gtkdoc versions, please remove the directory (e.g. from "
703 "version control system)."
704 msgstr ""
705
706 #. (itstool) path: sect1/title
707 #. (itstool) path: example/title
708 #: C/index.docbook:546 C/index.docbook:563
709 msgid "Running the doc build"
710 msgstr ""
711
712 #. (itstool) path: sect1/para
713 #: C/index.docbook:548
714 msgid ""
715 "After the previous steps it's time to run the build. First we need to rerun "
716 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
717 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
718 "<filename>configure</filename> with this option afterwards."
719 msgstr ""
720
721 #. (itstool) path: sect1/para
722 #: C/index.docbook:555
723 msgid ""
724 "The first make run generates several additional files in the doc-"
725 "directories. The important ones are: <filename>&lt;package&gt;.types</"
726 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
727 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
728 msgstr ""
729
730 #. (itstool) path: example/programlisting
731 #: C/index.docbook:564
732 #, no-wrap
733 msgid ""
734 "\n"
735 "./autogen.sh --enable-gtk-doc\n"
736 "make\n"
737 msgstr ""
738
739 #. (itstool) path: sect1/para
740 #: C/index.docbook:570
741 msgid ""
742 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
743 "index.html</filename>. Yes, it's a bit disappointing still. But hang-on, "
744 "during the next chapter we tell you how to fill the pages with life."
745 msgstr ""
746
747 #. (itstool) path: sect1/title
748 #: C/index.docbook:578
749 msgid "Integration with version control systems"
750 msgstr ""
751
752 #. (itstool) path: sect1/para
753 #: C/index.docbook:580
754 msgid ""
755 "As a rule of the thumb, it's those files you edit, that should go under "
756 "version control. For typical projects it's these files: <filename>&lt;"
757 "package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> "
758 "(in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
759 "<filename>Makefile.am</filename>"
760 msgstr ""
761
762 #. (itstool) path: sect1/title
763 #: C/index.docbook:591
764 msgid "Integration with plain makefiles or other build systems"
765 msgstr ""
766
767 #. (itstool) path: sect1/para
768 #: C/index.docbook:593
769 msgid ""
770 "In the case one does not want to use automake and therefore <filename>gtk-"
771 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
772 "in own makefiles (or other build tools)."
773 msgstr ""
774
775 #. (itstool) path: example/title
776 #: C/index.docbook:600
777 msgid "Documentation build steps"
778 msgstr ""
779
780 #. (itstool) path: example/programlisting
781 #: C/index.docbook:601
782 #, no-wrap
783 msgid ""
784 "\n"
785 "DOC_MODULE=meep\n"
786 "// sources have changed\n"
787 "gtkdoc-scan --module=$(DOC_MODULE) --source-dir=...\n"
788 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
789 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml\n"
790 "// xml files have changed\n"
791 "mkdir html\n"
792 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
793 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
794 msgstr ""
795
796 #. (itstool) path: sect1/para
797 #: C/index.docbook:615
798 msgid ""
799 "One will need to look at the <filename>Makefile.am</filename> and "
800 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
801 msgstr ""
802
803 #. (itstool) path: chapter/title
804 #: C/index.docbook:624
805 msgid "Documenting the code"
806 msgstr ""
807
808 #. (itstool) path: chapter/para
809 #: C/index.docbook:626
810 msgid ""
811 "GTK-Doc uses source code comment with a special syntax for code "
812 "documentation. Further it retrieves information about your project structure "
813 "from other sources. During the next section you will find all information "
814 "about the syntax of the comments."
815 msgstr ""
816
817 #. (itstool) path: note/title
818 #: C/index.docbook:634
819 msgid "Documentation placement"
820 msgstr ""
821
822 #. (itstool) path: note/para
823 #: C/index.docbook:635
824 msgid ""
825 "In the past most documentation had to be filled into files residing inside "
826 "the <filename>tmpl</filename> directory. This has the disadvantages that the "
827 "information is often not updated and also that the file tend to cause "
828 "conflicts with version control systems."
829 msgstr ""
830
831 #. (itstool) path: note/para
832 #: C/index.docbook:641
833 msgid ""
834 "The avoid the aforementioned problems we suggest putting the documentation "
835 "inside the sources. This manual will only describe this way of documenting "
836 "code."
837 msgstr ""
838
839 #. (itstool) path: example/title
840 #: C/index.docbook:652 C/index.docbook:669
841 msgid "GTK-Doc comment block"
842 msgstr ""
843
844 #. (itstool) path: example/programlisting
845 #: C/index.docbook:653
846 #, no-wrap
847 msgid ""
848 "\n"
849 "#ifndef __GTK_DOC_IGNORE__\n"
850 "/* unparseable code here */\n"
851 "#endif\n"
852 msgstr ""
853
854 #. (itstool) path: chapter/para
855 #: C/index.docbook:648
856 msgid ""
857 "The scanner can handle the majority of C headers fine. In the case of "
858 "receiving warnings from the scanner that look like a special case, one can "
859 "hint GTK-Doc to skip over them. <_:example-1/>"
860 msgstr ""
861
862 #. (itstool) path: sect1/title
863 #: C/index.docbook:664
864 msgid "Documentation comments"
865 msgstr ""
866
867 #. (itstool) path: example/programlisting
868 #: C/index.docbook:670
869 #, no-wrap
870 msgid ""
871 "\n"
872 "/**\n"
873 " * identifier:\n"
874 " * documentation ...\n"
875 " */\n"
876 msgstr ""
877
878 #. (itstool) path: sect1/para
879 #: C/index.docbook:666
880 msgid ""
881 "A multiline comment that starts with an additional '*' marks a documentation "
882 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
883 msgstr ""
884
885 #. (itstool) path: sect1/para
886 #: C/index.docbook:679
887 msgid ""
888 "The 'identifier' is one line with the name of the item the comment is "
889 "related to. The syntax differs a little depending on the item. (TODO add "
890 "table showing identifiers)"
891 msgstr ""
892
893 #. (itstool) path: sect1/para
894 #: C/index.docbook:685
895 msgid ""
896 "The 'documentation' block is also different for each symbol type. Symbol "
897 "types that get parameters such as functions or macros have the parameter "
898 "description first followed by a blank line (just a '*'). Afterwards follows "
899 "the detailed description. All lines (outside program listings and CDATA "
900 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
901 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
902 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
903 msgstr ""
904
905 #. (itstool) path: listitem/para
906 #: C/index.docbook:702
907 msgid ""
908 "What it is: The name for a class or function can sometimes be misleading for "
909 "people coming from a different background."
910 msgstr ""
911
912 #. (itstool) path: listitem/para
913 #: C/index.docbook:708
914 msgid ""
915 "What it does: Tell about common uses. Put it in relation with the other API."
916 msgstr ""
917
918 #. (itstool) path: tip/para
919 #: C/index.docbook:698
920 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
921 msgstr ""
922
923 #. (itstool) path: listitem/para
924 #: C/index.docbook:723
925 msgid "Use function() to refer to functions or macros which take arguments."
926 msgstr ""
927
928 #. (itstool) path: listitem/para
929 #: C/index.docbook:728
930 msgid ""
931 "Use @param to refer to parameters. Also use this when referring to "
932 "parameters of other functions, related to the one being described."
933 msgstr ""
934
935 #. (itstool) path: listitem/para
936 #: C/index.docbook:734
937 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
938 msgstr ""
939
940 #. (itstool) path: listitem/para
941 #: C/index.docbook:739
942 msgid ""
943 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
944 "macros which don't take arguments."
945 msgstr ""
946
947 #. (itstool) path: listitem/para
948 #: C/index.docbook:745
949 msgid "Use #Object::signal to refer to a GObject signal."
950 msgstr ""
951
952 #. (itstool) path: listitem/para
953 #: C/index.docbook:750
954 msgid "Use #Object:property to refer to a GObject property."
955 msgstr ""
956
957 #. (itstool) path: listitem/para
958 #: C/index.docbook:755
959 msgid ""
960 "Use #Struct.field to refer to a field inside a structure and #GObjectClass."
961 "foo_bar() to refer to a vmethod."
962 msgstr ""
963
964 #. (itstool) path: sect1/para
965 #: C/index.docbook:717
966 msgid ""
967 "One advantage of hyper-text over plain-text is the ability to have links in "
968 "the document. Writing the correct markup for a link can be tedious though. "
969 "GTK-Doc comes to help by providing several useful abbreviations. <_:"
970 "itemizedlist-1/>"
971 msgstr ""
972
973 #. (itstool) path: tip/para
974 #: C/index.docbook:764
975 msgid ""
976 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
977 "'#' in your documentation without GTK-Doc changing them you can use the XML "
978 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
979 "commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
980 "with a backslash '\\'."
981 msgstr ""
982
983 #. (itstool) path: sect1/para
984 #: C/index.docbook:773
985 msgid ""
986 "DocBook can do more than just links. One can also have lists, examples, "
987 "headings, and images. As of version 1.20, the preferred way is to use a "
988 "subset of the basic text formatting syntax called <ulink url=\"http://"
989 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
990 "versions any documentation that includes Markdown will be rendered as is. "
991 "For example, list items will appear as lines starting with a dash."
992 msgstr ""
993
994 #. (itstool) path: sect1/para
995 #: C/index.docbook:784
996 msgid ""
997 "In older GTK-Doc releases, if you need support for additional formatting, "
998 "you would need to enable the usage of docbook SGML/XML tags inside doc-"
999 "comments by putting <option>--xml-mode</option> or <option>--sgml-mode</"
1000 "option> in the variable <symbol>MKDB_OPTIONS</symbol> inside "
1001 "<filename>Makefile.am</filename>."
1002 msgstr ""
1003
1004 #. (itstool) path: example/title
1005 #: C/index.docbook:794
1006 msgid "GTK-Doc comment block using Markdown"
1007 msgstr ""
1008
1009 #. (itstool) path: example/programlisting
1010 #: C/index.docbook:795
1011 #, no-wrap
1012 msgid ""
1013 "\n"
1014 "/**\n"
1015 " * identifier:\n"
1016 " *\n"
1017 " * documentation paragraph ...\n"
1018 " *\n"
1019 " * # Sub Heading #\n"
1020 " *\n"
1021 " * ## Second Sub Heading\n"
1022 " *\n"
1023 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1024 " *\n"
1025 " * more documentation:\n"
1026 " *\n"
1027 " * - list item 1\n"
1028 " *\n"
1029 " * Paragraph inside a list item.\n"
1030 " *\n"
1031 " * - list item 2\n"
1032 " *\n"
1033 " * 1. numbered list item\n"
1034 " *\n"
1035 " * 2. another numbered list item\n"
1036 " *\n"
1037 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1038 " *\n"
1039 " * ![an inline image](plot-result.png)\n"
1040 " *\n"
1041 " * [A link to the heading anchor above][heading-two]\n"
1042 " *\n"
1043 " * A C-language example:\n"
1044 " * |[&lt;!-- language=\"C\" --&gt;\n"
1045 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1046 " * ]|\n"
1047 " */\n"
1048 msgstr ""
1049
1050 #. (itstool) path: sect1/para
1051 #: C/index.docbook:834
1052 msgid ""
1053 "More examples of what markdown tags are supported can be found in the <ulink "
1054 "url=\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown"
1055 "\">GTK+ Documentation Markdown Syntax Reference</ulink>."
1056 msgstr ""
1057
1058 #. (itstool) path: tip/para
1059 #: C/index.docbook:840
1060 msgid ""
1061 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1062 "cannot write documentation for static symbols. Nevertheless it is good to "
1063 "comment those symbols too. This helps other to understand you code. "
1064 "Therefore we recommend to comment these using normal comments (without the "
1065 "2nd '*' in the first line). If later the function needs to be made public, "
1066 "all one needs to do is to add another '*' in the comment block and insert "
1067 "the symbol name at the right place inside the sections file."
1068 msgstr ""
1069
1070 #. (itstool) path: sect1/title
1071 #: C/index.docbook:854
1072 msgid "Documenting sections"
1073 msgstr ""
1074
1075 #. (itstool) path: sect1/para
1076 #: C/index.docbook:856
1077 msgid ""
1078 "Each section of the documentation contains information about one class or "
1079 "module. To introduce the component one can write a section block. The short "
1080 "description is also used inside the table of contents. All the @fields are "
1081 "optional."
1082 msgstr ""
1083
1084 #. (itstool) path: example/title
1085 #: C/index.docbook:864
1086 msgid "Section comment block"
1087 msgstr ""
1088
1089 #. (itstool) path: example/programlisting
1090 #: C/index.docbook:865
1091 #, no-wrap
1092 msgid ""
1093 "\n"
1094 "/**\n"
1095 " * SECTION:meepapp\n"
1096 " * @short_description: the application class\n"
1097 " * @title: Meep application\n"
1098 " * @section_id:\n"
1099 " * @see_also: #MeepSettings\n"
1100 " * @stability: Stable\n"
1101 " * @include: meep/app.h\n"
1102 " * @image: application.png\n"
1103 " *\n"
1104 " * The application class handles ...\n"
1105 " */\n"
1106 msgstr ""
1107
1108 #. (itstool) path: varlistentry/term
1109 #: C/index.docbook:884
1110 msgid "SECTION:&lt;name&gt;"
1111 msgstr ""
1112
1113 #. (itstool) path: listitem/para
1114 #: C/index.docbook:886
1115 msgid ""
1116 "The name links the section documentation to the respective part in the "
1117 "<filename>&lt;package&gt;-sections.txt</filename> file. The name give here "
1118 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
1119 "txt</filename> file."
1120 msgstr ""
1121
1122 #. (itstool) path: varlistentry/term
1123 #: C/index.docbook:895
1124 msgid "@short_description"
1125 msgstr ""
1126
1127 #. (itstool) path: listitem/para
1128 #: C/index.docbook:897
1129 msgid ""
1130 "A one line description of the section, that later will appear after the "
1131 "links in the TOC and at the top of the section page."
1132 msgstr ""
1133
1134 #. (itstool) path: varlistentry/term
1135 #: C/index.docbook:904
1136 msgid "@title"
1137 msgstr ""
1138
1139 #. (itstool) path: listitem/para
1140 #: C/index.docbook:906
1141 msgid ""
1142 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
1143 "can be overridden with the @title field."
1144 msgstr ""
1145
1146 #. (itstool) path: varlistentry/term
1147 #: C/index.docbook:913
1148 msgid "@section_id"
1149 msgstr ""
1150
1151 #. (itstool) path: listitem/para
1152 #: C/index.docbook:915
1153 msgid ""
1154 "Overrides the use of title as a section identifier. For GObjects the &lt;"
1155 "title&gt; is used as a section_id and for other sections it is &lt;"
1156 "MODULE&gt;-&lt;title&gt;."
1157 msgstr ""
1158
1159 #. (itstool) path: varlistentry/term
1160 #: C/index.docbook:923
1161 msgid "@see_also"
1162 msgstr ""
1163
1164 #. (itstool) path: listitem/para
1165 #: C/index.docbook:925
1166 msgid "A list of symbols that are related to this section."
1167 msgstr ""
1168
1169 #. (itstool) path: varlistentry/term
1170 #: C/index.docbook:931
1171 msgid "@stability"
1172 msgstr ""
1173
1174 #. (itstool) path: listitem/para
1175 #: C/index.docbook:938
1176 msgid ""
1177 "Stable - The intention of a Stable interface is to enable arbitrary third "
1178 "parties to develop applications to these interfaces, release them, and have "
1179 "confidence that they will run on all minor releases of the product (after "
1180 "the one in which the interface was introduced, and within the same major "
1181 "release). Even at a major release, incompatible changes are expected to be "
1182 "rare, and to have strong justifications."
1183 msgstr ""
1184
1185 #. (itstool) path: listitem/para
1186 #: C/index.docbook:950
1187 msgid ""
1188 "Unstable - Unstable interfaces are experimental or transitional. They are "
1189 "typically used to give outside developers early access to new or rapidly "
1190 "changing technology, or to provide an interim solution to a problem where a "
1191 "more general solution is anticipated. No claims are made about either source "
1192 "or binary compatibility from one minor release to the next."
1193 msgstr ""
1194
1195 #. (itstool) path: listitem/para
1196 #: C/index.docbook:962
1197 msgid ""
1198 "Private - An interface that can be used within the GNOME stack itself, but "
1199 "that is not documented for end-users. Such functions should only be used in "
1200 "specified and documented ways."
1201 msgstr ""
1202
1203 #. (itstool) path: listitem/para
1204 #: C/index.docbook:971
1205 msgid ""
1206 "Internal - An interface that is internal to a module and does not require "
1207 "end-user documentation. Functions that are undocumented are assumed to be "
1208 "Internal."
1209 msgstr ""
1210
1211 #. (itstool) path: listitem/para
1212 #: C/index.docbook:933
1213 msgid ""
1214 "An informal description of the stability level this API has. We recommend "
1215 "the use of one of these terms: <_:itemizedlist-1/>"
1216 msgstr ""
1217
1218 #. (itstool) path: varlistentry/term
1219 #: C/index.docbook:983
1220 msgid "@include"
1221 msgstr ""
1222
1223 #. (itstool) path: listitem/para
1224 #: C/index.docbook:985
1225 msgid ""
1226 "The <literal>#include</literal> files to show in the section synopsis (a "
1227 "comma separated list), overriding the global value from the <link linkend="
1228 "\"metafiles_sections\">section file</link> or command line. This item is "
1229 "optional."
1230 msgstr ""
1231
1232 #. (itstool) path: varlistentry/term
1233 #: C/index.docbook:994
1234 msgid "@image"
1235 msgstr ""
1236
1237 #. (itstool) path: listitem/para
1238 #: C/index.docbook:996
1239 msgid ""
1240 "The image to display at the top of the reference page for this section. This "
1241 "will often be some sort of a diagram to illustrate the visual appearance of "
1242 "a class or a diagram of its relationship to other classes. This item is "
1243 "optional."
1244 msgstr ""
1245
1246 #. (itstool) path: tip/para
1247 #: C/index.docbook:1007
1248 msgid ""
1249 "To avoid unnecessary recompilation after doc-changes put the section docs "
1250 "into the c-source where possible."
1251 msgstr ""
1252
1253 #. (itstool) path: sect1/title
1254 #: C/index.docbook:1016
1255 msgid "Documenting symbols"
1256 msgstr ""
1257
1258 #. (itstool) path: sect1/para
1259 #: C/index.docbook:1018
1260 msgid ""
1261 "Each symbol (function, macro, struct, enum, signal and property) is "
1262 "documented in a separate block. The block is best placed close to the "
1263 "definition of the symbols so that it is easy to keep them in sync. Thus "
1264 "functions are usually documented in the c-source and macros, structs and "
1265 "enums in the header file."
1266 msgstr ""
1267
1268 #. (itstool) path: sect2/title
1269 #. (itstool) path: example/title
1270 #: C/index.docbook:1026 C/index.docbook:1055
1271 msgid "General tags"
1272 msgstr ""
1273
1274 #. (itstool) path: sect2/para
1275 #: C/index.docbook:1028
1276 msgid ""
1277 "You can add versioning information to all documentation elements to tell "
1278 "when an API was introduced, or when it was deprecated."
1279 msgstr ""
1280
1281 #. (itstool) path: variablelist/title
1282 #: C/index.docbook:1033
1283 msgid "Versioning Tags"
1284 msgstr ""
1285
1286 #. (itstool) path: varlistentry/term
1287 #: C/index.docbook:1034
1288 msgid "Since:"
1289 msgstr ""
1290
1291 #. (itstool) path: listitem/para
1292 #: C/index.docbook:1036
1293 msgid "Description since which version of the code the API is available."
1294 msgstr ""
1295
1296 #. (itstool) path: varlistentry/term
1297 #: C/index.docbook:1041
1298 msgid "Deprecated:"
1299 msgstr ""
1300
1301 #. (itstool) path: listitem/para
1302 #: C/index.docbook:1043
1303 msgid ""
1304 "Paragraph denoting that this function should no be used anymore. The "
1305 "description should point the reader to the new API."
1306 msgstr ""
1307
1308 #. (itstool) path: sect2/para
1309 #: C/index.docbook:1051
1310 msgid "(FIXME : Stability information)"
1311 msgstr ""
1312
1313 #. (itstool) path: example/programlisting
1314 #: C/index.docbook:1056
1315 #, no-wrap
1316 msgid ""
1317 "\n"
1318 "/**\n"
1319 " * foo_get_bar:\n"
1320 " * @foo: some foo\n"
1321 " *\n"
1322 " * Retrieves @foo's bar.\n"
1323 " *\n"
1324 " * Returns: @foo's bar\n"
1325 " *\n"
1326 " * Since: 2.6\n"
1327 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
1328 " */\n"
1329 "Bar *\n"
1330 "foo_get_bar(Foo *foo)\n"
1331 "{\n"
1332 "...\n"
1333 msgstr ""
1334
1335 #. (itstool) path: sect2/title
1336 #. (itstool) path: example/title
1337 #: C/index.docbook:1076 C/index.docbook:1112
1338 msgid "Function comment block"
1339 msgstr ""
1340
1341 #. (itstool) path: listitem/para
1342 #: C/index.docbook:1082
1343 msgid ""
1344 "Document whether returned objects, lists, strings, etc, should be freed/"
1345 "unrefed/released."
1346 msgstr ""
1347
1348 #. (itstool) path: listitem/para
1349 #: C/index.docbook:1088
1350 msgid "Document whether parameters can be NULL, and what happens if they are."
1351 msgstr ""
1352
1353 #. (itstool) path: listitem/para
1354 #: C/index.docbook:1093
1355 msgid ""
1356 "Mention interesting pre-conditions and post-conditions where appropriate."
1357 msgstr ""
1358
1359 #. (itstool) path: sect2/para
1360 #: C/index.docbook:1078 C/index.docbook:1171
1361 msgid "Please remember to: <_:itemizedlist-1/>"
1362 msgstr ""
1363
1364 #. (itstool) path: sect2/para
1365 #: C/index.docbook:1100
1366 msgid ""
1367 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
1368 "private. They are treated like static functions."
1369 msgstr ""
1370
1371 #. (itstool) path: sect2/para
1372 #: C/index.docbook:1105
1373 msgid ""
1374 "Also, take a look at GObject Introspection annotation tags: http://live."
1375 "gnome.org/GObjectIntrospection/Annotations"
1376 msgstr ""
1377
1378 #. (itstool) path: example/programlisting
1379 #: C/index.docbook:1113
1380 #, no-wrap
1381 msgid ""
1382 "\n"
1383 "/**\n"
1384 " * function_name:\n"
1385 " * @par1: description of parameter 1. These can extend over more than\n"
1386 " * one line.\n"
1387 " * @par2: description of parameter 2\n"
1388 " * @...: a %NULL-terminated list of bars\n"
1389 " *\n"
1390 " * The function description goes here. You can use @par1 to refer to parameters\n"
1391 " * so that they are highlighted in the output. You can also use %constant\n"
1392 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
1393 " * other declarations (which may be documented elsewhere).\n"
1394 " *\n"
1395 " * Returns: an integer.\n"
1396 " *\n"
1397 " * Since: 2.2\n"
1398 " * Deprecated: 2.18: Use other_function() instead.\n"
1399 " */\n"
1400 msgstr ""
1401
1402 #. (itstool) path: variablelist/title
1403 #: C/index.docbook:1134
1404 msgid "Function tags"
1405 msgstr ""
1406
1407 #. (itstool) path: varlistentry/term
1408 #: C/index.docbook:1135
1409 msgid "Returns:"
1410 msgstr ""
1411
1412 #. (itstool) path: listitem/para
1413 #: C/index.docbook:1137
1414 msgid "Paragraph describing the returned result."
1415 msgstr ""
1416
1417 #. (itstool) path: varlistentry/term
1418 #: C/index.docbook:1142
1419 msgid "@...:"
1420 msgstr ""
1421
1422 #. (itstool) path: listitem/para
1423 #: C/index.docbook:1144
1424 msgid ""
1425 "In case the function has variadic arguments, you should use this tag "
1426 "(@Varargs: does also work for historic reasons)."
1427 msgstr ""
1428
1429 #. (itstool) path: sect2/title
1430 #. (itstool) path: example/title
1431 #: C/index.docbook:1154 C/index.docbook:1156
1432 msgid "Property comment block"
1433 msgstr ""
1434
1435 #. (itstool) path: example/programlisting
1436 #: C/index.docbook:1157
1437 #, no-wrap
1438 msgid ""
1439 "\n"
1440 "/**\n"
1441 " * SomeWidget:some-property:\n"
1442 " *\n"
1443 " * Here you can document a property.\n"
1444 " */\n"
1445 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
1446 msgstr ""
1447
1448 #. (itstool) path: sect2/title
1449 #. (itstool) path: example/title
1450 #: C/index.docbook:1169 C/index.docbook:1188
1451 msgid "Signal comment block"
1452 msgstr ""
1453
1454 #. (itstool) path: listitem/para
1455 #: C/index.docbook:1175
1456 msgid ""
1457 "Document when the signal is emitted and whether it is emitted before or "
1458 "after other signals."
1459 msgstr ""
1460
1461 #. (itstool) path: listitem/para
1462 #: C/index.docbook:1181
1463 msgid "Document what an application might do in the signal handler."
1464 msgstr ""
1465
1466 #. (itstool) path: example/programlisting
1467 #: C/index.docbook:1189
1468 #, no-wrap
1469 msgid ""
1470 "\n"
1471 "/**\n"
1472 " * FooWidget::foobarized:\n"
1473 " * @widget: the widget that received the signal\n"
1474 " * @foo: some foo\n"
1475 " * @bar: some bar\n"
1476 " *\n"
1477 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
1478 " */\n"
1479 "foo_signals[FOOBARIZE] =\n"
1480 " g_signal_new (\"foobarize\",\n"
1481 " ...\n"
1482 msgstr ""
1483
1484 #. (itstool) path: sect2/title
1485 #. (itstool) path: example/title
1486 #: C/index.docbook:1206 C/index.docbook:1207
1487 msgid "Struct comment block"
1488 msgstr ""
1489
1490 #. (itstool) path: example/programlisting
1491 #: C/index.docbook:1208
1492 #, no-wrap
1493 msgid ""
1494 "\n"
1495 "/**\n"
1496 " * FooWidget:\n"
1497 " * @bar: some #gboolean\n"
1498 " *\n"
1499 " * This is the best widget, ever.\n"
1500 " */\n"
1501 "typedef struct _FooWidget {\n"
1502 " /*&lt; private &gt;*/\n"
1503 " GtkWidget parent;\n"
1504 "\n"
1505 " /*&lt; public &gt;*/\n"
1506 " gboolean bar;\n"
1507 "} FooWidget;\n"
1508 msgstr ""
1509
1510 #. (itstool) path: sect2/para
1511 #: C/index.docbook:1225
1512 msgid ""
1513 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
1514 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
1515 "behaviour."
1516 msgstr ""
1517
1518 #. (itstool) path: sect2/para
1519 #: C/index.docbook:1231
1520 msgid ""
1521 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
1522 "is usually a good idea to add a comment block for a class, if it has "
1523 "vmethods (as this is how they can be documented). For the GObject itself one "
1524 "can use the related section docs, having a separate block for the instance "
1525 "struct would be useful if the instance has public fields. One disadvantage "
1526 "here is that this creates two index entries of the same name (the structure "
1527 "and the section)."
1528 msgstr ""
1529
1530 #. (itstool) path: sect2/title
1531 #. (itstool) path: example/title
1532 #: C/index.docbook:1243 C/index.docbook:1244
1533 msgid "Enum comment block"
1534 msgstr ""
1535
1536 #. (itstool) path: example/programlisting
1537 #: C/index.docbook:1245
1538 #, no-wrap
1539 msgid ""
1540 "\n"
1541 "/**\n"
1542 " * Something:\n"
1543 " * @SOMETHING_FOO: something foo\n"
1544 " * @SOMETHING_BAR: something bar\n"
1545 " *\n"
1546 " * Enum values used for the thing, to specify the thing.\n"
1547 " */\n"
1548 "typedef enum {\n"
1549 " SOMETHING_FOO,\n"
1550 " SOMETHING_BAR,\n"
1551 " /*&lt; private &gt;*/\n"
1552 " SOMETHING_COUNT\n"
1553 "} Something;\n"
1554 msgstr ""
1555
1556 #. (itstool) path: sect2/para
1557 #: C/index.docbook:1262
1558 msgid ""
1559 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
1560 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
1561 "behaviour."
1562 msgstr ""
1563
1564 #. (itstool) path: sect1/title
1565 #: C/index.docbook:1272
1566 msgid "Useful DocBook tags"
1567 msgstr ""
1568
1569 #. (itstool) path: sect1/para
1570 #: C/index.docbook:1274
1571 msgid ""
1572 "Here are some DocBook tags which are most useful when documenting the code."
1573 msgstr ""
1574
1575 #. (itstool) path: informalexample/programlisting
1576 #: C/index.docbook:1283
1577 #, no-wrap
1578 msgid ""
1579 "\n"
1580 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
1581 msgstr ""
1582
1583 #. (itstool) path: sect1/para
1584 #: C/index.docbook:1279
1585 msgid ""
1586 "To link to another section in the GTK docs: <_:informalexample-1/> The "
1587 "linkend is the SGML/XML id on the top item of the page you want to link to. "
1588 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
1589 "then the page title (\"Hash Tables\"). For widgets it is just the class "
1590 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
1591 msgstr ""
1592
1593 #. (itstool) path: informalexample/programlisting
1594 #: C/index.docbook:1296
1595 #, no-wrap
1596 msgid ""
1597 "\n"
1598 "&lt;function&gt;...&lt;/function&gt;\n"
1599 msgstr ""
1600
1601 #. (itstool) path: sect1/para
1602 #: C/index.docbook:1293
1603 msgid ""
1604 "To refer to an external function, e.g. a standard C function: <_:"
1605 "informalexample-1/>"
1606 msgstr ""
1607
1608 #. (itstool) path: informalexample/programlisting
1609 #: C/index.docbook:1305
1610 #, no-wrap
1611 msgid ""
1612 "\n"
1613 "&lt;example&gt;\n"
1614 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
1615 " &lt;programlisting&gt;\n"
1616 " ...\n"
1617 " &lt;/programlisting&gt;\n"
1618 "&lt;/example&gt;\n"
1619 msgstr ""
1620
1621 #. (itstool) path: informalexample/programlisting
1622 #: C/index.docbook:1316
1623 #, no-wrap
1624 msgid ""
1625 "\n"
1626 "&lt;informalexample&gt;\n"
1627 " &lt;programlisting&gt;\n"
1628 " ...\n"
1629 " &lt;/programlisting&gt;\n"
1630 "&lt;/informalexample&gt;\n"
1631 msgstr ""
1632
1633 #. (itstool) path: sect1/para
1634 #: C/index.docbook:1302
1635 msgid ""
1636 "To include example code: <_:informalexample-1/> or possibly this, for very "
1637 "short code fragments which don't need a title: <_:informalexample-2/> For "
1638 "the latter GTK-Doc also supports an abbreviation: |[ ... ]|"
1639 msgstr ""
1640
1641 #. (itstool) path: informalexample/programlisting
1642 #: C/index.docbook:1335
1643 #, no-wrap
1644 msgid ""
1645 "\n"
1646 "&lt;itemizedlist&gt;\n"
1647 " &lt;listitem&gt;\n"
1648 " &lt;para&gt;\n"
1649 " ...\n"
1650 " &lt;/para&gt;\n"
1651 " &lt;/listitem&gt;\n"
1652 " &lt;listitem&gt;\n"
1653 " &lt;para&gt;\n"
1654 " ...\n"
1655 " &lt;/para&gt;\n"
1656 " &lt;/listitem&gt;\n"
1657 "&lt;/itemizedlist&gt;\n"
1658 msgstr ""
1659
1660 #. (itstool) path: sect1/para
1661 #: C/index.docbook:1332
1662 msgid "To include bulleted lists: <_:informalexample-1/>"
1663 msgstr ""
1664
1665 #. (itstool) path: informalexample/programlisting
1666 #: C/index.docbook:1355
1667 #, no-wrap
1668 msgid ""
1669 "\n"
1670 "&lt;note&gt;\n"
1671 " &lt;para&gt;\n"
1672 " Make sure you free the data after use.\n"
1673 " &lt;/para&gt;\n"
1674 "&lt;/note&gt;\n"
1675 msgstr ""
1676
1677 #. (itstool) path: sect1/para
1678 #: C/index.docbook:1352
1679 msgid ""
1680 "To include a note which stands out from the text: <_:informalexample-1/>"
1681 msgstr ""
1682
1683 #. (itstool) path: informalexample/programlisting
1684 #: C/index.docbook:1368
1685 #, no-wrap
1686 msgid ""
1687 "\n"
1688 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
1689 msgstr ""
1690
1691 #. (itstool) path: sect1/para
1692 #: C/index.docbook:1365
1693 msgid "To refer to a type: <_:informalexample-1/>"
1694 msgstr ""
1695
1696 #. (itstool) path: informalexample/programlisting
1697 #: C/index.docbook:1377
1698 #, no-wrap
1699 msgid ""
1700 "\n"
1701 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
1702 msgstr ""
1703
1704 #. (itstool) path: sect1/para
1705 #: C/index.docbook:1374
1706 msgid ""
1707 "To refer to an external structure (not one described in the GTK docs): <_:"
1708 "informalexample-1/>"
1709 msgstr ""
1710
1711 #. (itstool) path: informalexample/programlisting
1712 #: C/index.docbook:1386
1713 #, no-wrap
1714 msgid ""
1715 "\n"
1716 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
1717 msgstr ""
1718
1719 #. (itstool) path: sect1/para
1720 #: C/index.docbook:1383
1721 msgid "To refer to a field of a structure: <_:informalexample-1/>"
1722 msgstr ""
1723
1724 #. (itstool) path: informalexample/programlisting
1725 #: C/index.docbook:1395
1726 #, no-wrap
1727 msgid ""
1728 "\n"
1729 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
1730 msgstr ""
1731
1732 #. (itstool) path: sect1/para
1733 #: C/index.docbook:1392
1734 msgid ""
1735 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
1736 "you'll probably be using #GtkWidget instead (to automatically create a link "
1737 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
1738 "abbreviations</link>)."
1739 msgstr ""
1740
1741 #. (itstool) path: informalexample/programlisting
1742 #: C/index.docbook:1406
1743 #, no-wrap
1744 msgid ""
1745 "\n"
1746 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
1747 msgstr ""
1748
1749 #. (itstool) path: sect1/para
1750 #: C/index.docbook:1403
1751 msgid "To emphasize text: <_:informalexample-1/>"
1752 msgstr ""
1753
1754 #. (itstool) path: informalexample/programlisting
1755 #: C/index.docbook:1415
1756 #, no-wrap
1757 msgid ""
1758 "\n"
1759 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
1760 msgstr ""
1761
1762 #. (itstool) path: sect1/para
1763 #: C/index.docbook:1412
1764 msgid "For filenames use: <_:informalexample-1/>"
1765 msgstr ""
1766
1767 #. (itstool) path: informalexample/programlisting
1768 #: C/index.docbook:1424
1769 #, no-wrap
1770 msgid ""
1771 "\n"
1772 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
1773 msgstr ""
1774
1775 #. (itstool) path: sect1/para
1776 #: C/index.docbook:1421
1777 msgid "To refer to keys use: <_:informalexample-1/>"
1778 msgstr ""
1779
1780 #. (itstool) path: chapter/title
1781 #: C/index.docbook:1434
1782 msgid "Filling the extra files"
1783 msgstr ""
1784
1785 #. (itstool) path: chapter/para
1786 #: C/index.docbook:1436
1787 msgid ""
1788 "There are a couple of extra files, that need to be maintained along with the "
1789 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
1790 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
1791 "<filename>&lt;package&gt;-sections.txt</filename>."
1792 msgstr ""
1793
1794 #. (itstool) path: sect1/title
1795 #: C/index.docbook:1445
1796 msgid "Editing the types file"
1797 msgstr ""
1798
1799 #. (itstool) path: sect1/para
1800 #: C/index.docbook:1447
1801 msgid ""
1802 "If your library or application includes GObjects, you want their signals, "
1803 "arguments/parameters and position in the hierarchy to be shown in the "
1804 "documentation. All you need to do, is to list the <function>xxx_get_type</"
1805 "function> functions together with their include inside the <filename>&lt;"
1806 "package&gt;.types</filename> file."
1807 msgstr ""
1808
1809 #. (itstool) path: example/title
1810 #: C/index.docbook:1456
1811 msgid "Example types file snippet"
1812 msgstr ""
1813
1814 #. (itstool) path: example/programlisting
1815 #: C/index.docbook:1457
1816 #, no-wrap
1817 msgid ""
1818 "\n"
1819 "#include &lt;gtk/gtk.h&gt;\n"
1820 "\n"
1821 "gtk_accel_label_get_type\n"
1822 "gtk_adjustment_get_type\n"
1823 "gtk_alignment_get_type\n"
1824 "gtk_arrow_get_type\n"
1825 msgstr ""
1826
1827 #. (itstool) path: sect1/para
1828 #: C/index.docbook:1468
1829 msgid ""
1830 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
1831 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
1832 "<filename>Makefile.am</filename>. If you use this approach you should not "
1833 "dist the types file nor have it under version control."
1834 msgstr ""
1835
1836 #. (itstool) path: sect1/title
1837 #: C/index.docbook:1477
1838 msgid "Editing the master document"
1839 msgstr ""
1840
1841 #. (itstool) path: sect1/para
1842 #: C/index.docbook:1479
1843 msgid ""
1844 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
1845 "inline source comments, the GTK-Doc tools generate one documentation page "
1846 "per class or module as a separate file. The master document includes them "
1847 "and place them in an order."
1848 msgstr ""
1849
1850 #. (itstool) path: sect1/para
1851 #: C/index.docbook:1486
1852 msgid ""
1853 "While GTK-Doc creates a template master document for you, later run will not "
1854 "touch it again. This means that one can freely structure the documentation. "
1855 "That includes grouping pages and adding extra pages. GTK-Doc has now a test "
1856 "suite, where also the master-document is recreated from scratch. Its a good "
1857 "idea to look at this from time to time to see if there are some new goodies "
1858 "introduced there."
1859 msgstr ""
1860
1861 #. (itstool) path: tip/para
1862 #: C/index.docbook:1496
1863 msgid ""
1864 "Do not create tutorials as extra documents. Just write extra chapters. The "
1865 "benefit of directly embedding the tutorial for your library into the API "
1866 "documentation is that it is easy to link for the tutorial to symbol "
1867 "documentation. Apart chances are higher that the tutorial gets updates along "
1868 "with the library."
1869 msgstr ""
1870
1871 #. (itstool) path: sect1/para
1872 #: C/index.docbook:1505
1873 msgid ""
1874 "So what are the things to change inside the master document? For a start is "
1875 "only a little. There are some placeholders (text in square brackets) there "
1876 "which you should take care of."
1877 msgstr ""
1878
1879 #. (itstool) path: example/title
1880 #: C/index.docbook:1512
1881 msgid "Master document header"
1882 msgstr ""
1883
1884 #. (itstool) path: example/programlisting
1885 #: C/index.docbook:1513
1886 #, no-wrap
1887 msgid ""
1888 "\n"
1889 "&lt;bookinfo&gt;\n"
1890 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
1891 " &lt;releaseinfo&gt;\n"
1892 " for MODULENAME [VERSION]\n"
1893 " The latest version of this documentation can be found on-line at\n"
1894 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
1895 " &lt;/releaseinfo&gt;\n"
1896 "&lt;/bookinfo&gt;\n"
1897 "\n"
1898 "&lt;chapter&gt;\n"
1899 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
1900 msgstr ""
1901
1902 #. (itstool) path: sect1/title
1903 #: C/index.docbook:1532
1904 msgid "Editing the section file"
1905 msgstr ""
1906
1907 #. (itstool) path: sect1/para
1908 #: C/index.docbook:1534
1909 msgid ""
1910 "The section file is used to organise the documentation output by GTK-Doc. "
1911 "Here one specifies which symbol belongs to which module or class and control "
1912 "the visibility (public or private)."
1913 msgstr ""
1914
1915 #. (itstool) path: sect1/para
1916 #: C/index.docbook:1540
1917 msgid ""
1918 "The section file is a plain text file with XML-like syntax (using tags). "
1919 "Blank lines are ignored and lines starting with a '#' are treated as comment "
1920 "lines."
1921 msgstr ""
1922
1923 #. (itstool) path: sect1/para
1924 #: C/index.docbook:1546
1925 msgid ""
1926 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
1927 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
1928 "FILE&gt;' will result in the section declarations being output in the "
1929 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
1930 "converted into the DocBook SGML/XML file <filename>sgml/gnome-config.sgml</"
1931 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
1932 "(The name of the HTML file is based on the module name and the section "
1933 "title, or for GObjects it is based on the GObjects class name converted to "
1934 "lower case)."
1935 msgstr ""
1936
1937 #. (itstool) path: sect1/para
1938 #: C/index.docbook:1558
1939 msgid ""
1940 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
1941 "section. It is only useful before the templates (if used) are initially "
1942 "created, since the title set in the template file overrides this. Also if "
1943 "one uses SECTION comment in the sources, this is obsolete."
1944 msgstr ""
1945
1946 #. (itstool) path: sect1/para
1947 #: C/index.docbook:1565
1948 msgid ""
1949 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
1950 "Currently it outputs a blank line between subsections in the synopsis "
1951 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
1952 "declarations (e.g. the functions like g_object_get_type and macros like "
1953 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
1954 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
1955 "declarations which will not be output (it is a handy way to avoid warning "
1956 "messages about unused declarations). If your library contains private types "
1957 "which you don't want to appear in the object hierarchy and the list of "
1958 "implemented or required interfaces, add them to a Private subsection. "
1959 "Whether you would place GObject and GObjectClass like structs in public or "
1960 "Standard section depends if they have public entries (variables, vmethods)."
1961 msgstr ""
1962
1963 #. (itstool) path: sect1/para
1964 #: C/index.docbook:1584
1965 msgid ""
1966 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
1967 "#include files which are shown in the synopsis sections. It contains a comma-"
1968 "separate list of #include files, without the angle brackets. If you set it "
1969 "outside of any sections, it acts for all sections until the end of the file. "
1970 "If you set it within a section, it only applies to that section."
1971 msgstr ""
1972
1973 #. (itstool) path: chapter/title
1974 #: C/index.docbook:1598
1975 msgid "Controlling the result"
1976 msgstr ""
1977
1978 #. (itstool) path: chapter/para
1979 #: C/index.docbook:1600
1980 msgid ""
1981 "A GTK-Doc run generates report files inside the documentation directory. The "
1982 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
1983 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
1984 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
1985 "files that can be viewed and postprocessed easily."
1986 msgstr ""
1987
1988 #. (itstool) path: chapter/para
1989 #: C/index.docbook:1609
1990 msgid ""
1991 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
1992 "the documentation coverage summary. Below are two sections divided by blank "
1993 "lines. The first section lists undocumented or incomplete symbols. The "
1994 "second section does the same for section docs. Incomplete entries are those, "
1995 "which have documentation, but where e.g. a new parameter has been added."
1996 msgstr ""
1997
1998 #. (itstool) path: chapter/para
1999 #: C/index.docbook:1618
2000 msgid ""
2001 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
2002 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
2003 "in the sources. Check if they have been removed or if they are misspelled."
2004 msgstr ""
2005
2006 #. (itstool) path: chapter/para
2007 #: C/index.docbook:1625
2008 msgid ""
2009 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
2010 "where the GTK-Doc scanner has found documentation, but does not know where "
2011 "to put it. This means that the symbol has not yet been added to the "
2012 "<filename>&lt;package&gt;-sections.txt</filename> file."
2013 msgstr ""
2014
2015 #. (itstool) path: tip/para
2016 #: C/index.docbook:1633
2017 msgid ""
2018 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
2019 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
2020 "<command>make check</command> run."
2021 msgstr ""
2022
2023 #. (itstool) path: chapter/para
2024 #: C/index.docbook:1640
2025 msgid ""
2026 "One can also look at the files produced by the source code scanner: "
2027 "<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
2028 "package&gt;-decl.txt</filename>. The first one can be compared with the "
2029 "section file if that is manually maintained. The second lists all "
2030 "declarations from the headers. If a symbol is missing one could check if "
2031 "this file contains it."
2032 msgstr ""
2033
2034 #. (itstool) path: chapter/para
2035 #: C/index.docbook:1649
2036 msgid ""
2037 "If the project is GObject based, one can also look into the files produced "
2038 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
2039 "<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
2040 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
2041 "prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
2042 "filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
2043 "to keep the intermediate scanner file for further analysis, by running it as "
2044 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
2045 msgstr ""
2046
2047 #. (itstool) path: chapter/title
2048 #: C/index.docbook:1664
2049 msgid "Modernizing the documentation"
2050 msgstr ""
2051
2052 #. (itstool) path: chapter/para
2053 #: C/index.docbook:1666
2054 msgid ""
2055 "GTK-Doc has been around for quite some time. In this section we list new "
2056 "features together with the version since when it is available."
2057 msgstr ""
2058
2059 #. (itstool) path: sect1/title
2060 #: C/index.docbook:1672
2061 msgid "GTK-Doc 1.9"
2062 msgstr ""
2063
2064 #. (itstool) path: sect1/para
2065 #: C/index.docbook:1674
2066 msgid ""
2067 "When using xml instead of sgml, one can actually name the master document "
2068 "<filename>&lt;package&gt;-docs.xml</filename>."
2069 msgstr ""
2070
2071 #. (itstool) path: sect1/para
2072 #: C/index.docbook:1679
2073 msgid ""
2074 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
2075 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
2076 "package&gt;-sections.txt</filename> is autogenerated and can be removed from "
2077 "the vcs. This only works nicely for projects that have a very regular "
2078 "structure (e.g. each .{c,h} pair will create new section). If one organize a "
2079 "project close to that updating a manually maintained section file can be as "
2080 "simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
2081 "sections.txt</code>."
2082 msgstr ""
2083
2084 #. (itstool) path: sect1/para
2085 #: C/index.docbook:1690
2086 msgid ""
2087 "Version 1.8 already introduced the syntax for documenting sections in the "
2088 "sources instead of the separate files under <filename class=\"directory"
2089 "\">tmpl</filename>. This version adds options to switch the whole doc module "
2090 "to not use the extra tmpl build step at all, by using <option>--flavour no-"
2091 "tmpl</option> in <filename>configure.ac</filename>."
2092 msgstr ""
2093
2094 #. (itstool) path: sect1/title
2095 #: C/index.docbook:1700
2096 msgid "GTK-Doc 1.10"
2097 msgstr "GTK-Doc 1.10"
2098
2099 #. (itstool) path: sect1/para
2100 #: C/index.docbook:1702
2101 msgid ""
2102 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
2103 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
2104 "package&gt;.types</filename> is autogenerated and can be removed from the "
2105 "vcs. When using this feature it is important to also setup the "
2106 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
2107 "code that is build conditionally."
2108 msgstr ""
2109
2110 #. (itstool) path: sect1/title
2111 #: C/index.docbook:1713
2112 msgid "GTK-Doc 1.16"
2113 msgstr "GTK-Doc 1.16"
2114
2115 #. (itstool) path: example/title
2116 #: C/index.docbook:1719
2117 msgid "Enable gtkdoc-check"
2118 msgstr ""
2119
2120 #. (itstool) path: example/programlisting
2121 #: C/index.docbook:1720
2122 #, no-wrap
2123 msgid ""
2124 "\n"
2125 "if ENABLE_GTK_DOC\n"
2126 "TESTS_ENVIRONMENT = \\\n"
2127 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
2128 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
2129 "TESTS = $(GTKDOC_CHECK)\n"
2130 "endif\n"
2131 msgstr ""
2132 "\n"
2133 "if ENABLE_GTK_DOC\n"
2134 "TESTS_ENVIRONMENT = \\\n"
2135 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
2136 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
2137 "TESTS = $(GTKDOC_CHECK)\n"
2138 "endif\n"
2139
2140 #. (itstool) path: sect1/para
2141 #: C/index.docbook:1715
2142 msgid ""
2143 "This version includes a new tool called gtkdoc-check. This tool can run a "
2144 "set of sanity checks on your documentation. It is enabled by adding these "
2145 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
2146 msgstr ""
2147
2148 #. (itstool) path: sect1/title
2149 #: C/index.docbook:1733
2150 msgid "GTK-Doc 1.20"
2151 msgstr "GTK-Doc 1.20"
2152
2153 #. (itstool) path: sect1/para
2154 #: C/index.docbook:1735
2155 msgid ""
2156 "Version 1.18 brought some initial markdown support. Using markdown in doc "
2157 "comments is less intrusive than writing docbook xml. This version improves a "
2158 "lot on this and add a lot more styles. The section that explains the <link "
2159 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
2160 msgstr ""
2161
2162 #. (itstool) path: chapter/title
2163 #: C/index.docbook:1746
2164 msgid "Documenting other interfaces"
2165 msgstr "Documentando outras interfaces"
2166
2167 #. (itstool) path: chapter/para
2168 #: C/index.docbook:1748
2169 msgid ""
2170 "So far we have been using GTK-Doc to document the API of code. The next "
2171 "sections contain suggestions how the tools can be used to document other "
2172 "interfaces too."
2173 msgstr ""
2174
2175 #. (itstool) path: sect1/title
2176 #: C/index.docbook:1755
2177 msgid "Command line options and man pages"
2178 msgstr ""
2179
2180 #. (itstool) path: sect1/para
2181 #: C/index.docbook:1757
2182 msgid ""
2183 "As one can generate man pages for a docbook refentry as well, it sounds like "
2184 "a good idea to use it for that purpose. This way the interface is part of "
2185 "the reference and one gets the man-page for free."
2186 msgstr ""
2187
2188 #. (itstool) path: sect2/title
2189 #: C/index.docbook:1764
2190 msgid "Document the tool"
2191 msgstr "Documente a ferramenta"
2192
2193 #. (itstool) path: sect2/para
2194 #: C/index.docbook:1766
2195 msgid ""
2196 "Create one refentry file per tool. Following <link linkend="
2197 "\"settingup_docfiles\">our example</link> we would call it <filename>meep/"
2198 "docs/reference/meeper/meep.xml</filename>. For the xml tags that should be "
2199 "used and can look at generated file in the xml subdirectory as well as "
2200 "examples e.g. in glib."
2201 msgstr ""
2202
2203 #. (itstool) path: sect2/title
2204 #: C/index.docbook:1776
2205 msgid "Adding the extra configure check"
2206 msgstr ""
2207
2208 #. (itstool) path: example/title
2209 #: C/index.docbook:1779 C/index.docbook:1797
2210 msgid "Extra configure checks"
2211 msgstr ""
2212
2213 #. (itstool) path: example/programlisting
2214 #: C/index.docbook:1780
2215 #, no-wrap
2216 msgid ""
2217 "\n"
2218 "AC_ARG_ENABLE(man,\n"
2219 " [AC_HELP_STRING([--enable-man],\n"
2220 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
2221 " enable_man=no)\n"
2222 "\n"
2223 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
2224 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
2225 msgstr ""
2226
2227 #. (itstool) path: sect2/title
2228 #: C/index.docbook:1794
2229 msgid "Adding the extra makefile rules"
2230 msgstr ""
2231
2232 #. (itstool) path: example/programlisting
2233 #: C/index.docbook:1798
2234 #, no-wrap
2235 msgid ""
2236 "\n"
2237 "man_MANS = \\\n"
2238 " meeper.1\n"
2239 "\n"
2240 "if ENABLE_GTK_DOC\n"
2241 "if ENABLE_MAN\n"
2242 "\n"
2243 "%.1 : %.xml\n"
2244 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
2245 "\n"
2246 "endif\n"
2247 "endif\n"
2248 "\n"
2249 "BUILT_EXTRA_DIST = $(man_MANS)\n"
2250 "EXTRA_DIST += meep.xml\n"
2251 msgstr ""
2252
2253 #. (itstool) path: sect1/title
2254 #: C/index.docbook:1820
2255 msgid "DBus interfaces"
2256 msgstr "Intefaces de DBus"
2257
2258 #. (itstool) path: sect1/para
2259 #: C/index.docbook:1822
2260 msgid ""
2261 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
2262 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
2263 msgstr ""
2264
2265 #. (itstool) path: chapter/title
2266 #: C/index.docbook:1831
2267 msgid "Frequently asked questions"
2268 msgstr "Preguntas frecuentes"
2269
2270 #. (itstool) path: segmentedlist/segtitle
2271 #: C/index.docbook:1835
2272 msgid "Question"
2273 msgstr "Pregunta"
2274
2275 #. (itstool) path: segmentedlist/segtitle
2276 #: C/index.docbook:1836
2277 msgid "Answer"
2278 msgstr "Resposta"
2279
2280 #. (itstool) path: seglistitem/seg
2281 #: C/index.docbook:1838
2282 msgid "No class hierarchy."
2283 msgstr "Non hai herdanza de clases."
2284
2285 #. (itstool) path: seglistitem/seg
2286 #: C/index.docbook:1839
2287 msgid ""
2288 "The objects <function>xxx_get_type()</function> function has not been "
2289 "entered into the <filename>&lt;package&gt;.types</filename> file."
2290 msgstr ""
2291
2292 #. (itstool) path: seglistitem/seg
2293 #: C/index.docbook:1845
2294 msgid "Still no class hierarchy."
2295 msgstr "Aínda non hai herdanza de clases."
2296
2297 #. (itstool) path: seglistitem/seg
2298 #: C/index.docbook:1846
2299 msgid ""
2300 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
2301 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
2302 "October/msg00006.html\">explanation</ulink>)."
2303 msgstr ""
2304
2305 #. (itstool) path: seglistitem/seg
2306 #: C/index.docbook:1852
2307 msgid "Damn, I have still no class hierarchy."
2308 msgstr "Redemo, aínda non hai herdanza de clase."
2309
2310 #. (itstool) path: seglistitem/seg
2311 #: C/index.docbook:1853
2312 msgid ""
2313 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
2314 "type>) part of the normal section (don't put this into Standard or Private "
2315 "subsections)."
2316 msgstr ""
2317
2318 #. (itstool) path: seglistitem/seg
2319 #: C/index.docbook:1860
2320 msgid "No symbol index."
2321 msgstr ""
2322
2323 #. (itstool) path: seglistitem/seg
2324 #: C/index.docbook:1861
2325 msgid ""
2326 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
2327 "index that xi:includes the generated index?"
2328 msgstr ""
2329
2330 #. (itstool) path: seglistitem/seg
2331 #: C/index.docbook:1867
2332 msgid "Symbols are not linked to their doc-section."
2333 msgstr ""
2334
2335 #. (itstool) path: seglistitem/seg
2336 #: C/index.docbook:1868
2337 msgid ""
2338 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
2339 "gtkdoc-fixxref warns about unresolvable xrefs."
2340 msgstr ""
2341
2342 #. (itstool) path: seglistitem/seg
2343 #: C/index.docbook:1874
2344 msgid "A new class does not appear in the docs."
2345 msgstr ""
2346
2347 #. (itstool) path: seglistitem/seg
2348 #: C/index.docbook:1875
2349 msgid ""
2350 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
2351 "filename>."
2352 msgstr ""
2353
2354 #. (itstool) path: seglistitem/seg
2355 #: C/index.docbook:1881
2356 msgid "A new symbol does not appear in the docs."
2357 msgstr ""
2358
2359 #. (itstool) path: seglistitem/seg
2360 #: C/index.docbook:1882
2361 msgid ""
2362 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
2363 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
2364 "xrefs. Check if the symbol is correctly listed in the <filename>&lt;"
2365 "package&gt;-sections.txt</filename> in a public subsection."
2366 msgstr ""
2367
2368 #. (itstool) path: seglistitem/seg
2369 #: C/index.docbook:1890
2370 msgid "A type is missing from the class hierarchy."
2371 msgstr ""
2372
2373 #. (itstool) path: seglistitem/seg
2374 #: C/index.docbook:1891
2375 msgid ""
2376 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
2377 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
2378 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
2379 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
2380 "or incidentialy makred private it will not be shown."
2381 msgstr ""
2382
2383 #. (itstool) path: seglistitem/seg
2384 #: C/index.docbook:1900
2385 msgid "I get foldoc links for all gobject annotations."
2386 msgstr ""
2387
2388 #. (itstool) path: seglistitem/seg
2389 #: C/index.docbook:1901
2390 msgid ""
2391 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
2392 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
2393 msgstr ""
2394
2395 #. (itstool) path: seglistitem/seg
2396 #: C/index.docbook:1909
2397 msgid "Parameter described in source code comment block but does not exist"
2398 msgstr ""
2399
2400 #. (itstool) path: seglistitem/seg
2401 #: C/index.docbook:1910
2402 msgid ""
2403 "Check if the prototype in the header has different parameter names as in the "
2404 "source."
2405 msgstr ""
2406
2407 #. (itstool) path: seglistitem/seg
2408 #: C/index.docbook:1915
2409 msgid "multiple \"IDs\" for constraint linkend: XYZ"
2410 msgstr ""
2411
2412 #. (itstool) path: seglistitem/seg
2413 #: C/index.docbook:1916
2414 msgid ""
2415 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
2416 "filename> file."
2417 msgstr ""
2418
2419 #. (itstool) path: seglistitem/seg
2420 #: C/index.docbook:1919
2421 msgid ""
2422 "Element typename in namespace '' encountered in para, but no template "
2423 "matches."
2424 msgstr ""
2425
2426 #. (itstool) path: chapter/title
2427 #: C/index.docbook:1926
2428 msgid "Tools related to gtk-doc"
2429 msgstr ""
2430
2431 #. (itstool) path: chapter/para
2432 #: C/index.docbook:1928
2433 msgid ""
2434 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
2435 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
2436 "integrates with the trac search."
2437 msgstr ""
2438
2439 #. (itstool) path: chapter/para
2440 #: C/index.docbook:1933
2441 msgid ""
2442 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
2443 "tags in the API to determine the minimum required version."
2444 msgstr ""
2445
2446 #. (itstool) path: appendixinfo/releaseinfo
2447 #: C/index.docbook:12 C/fdl-appendix.xml:12
2448 msgid "Version 1.1, March 2000"
2449 msgstr ""
2450
2451 #. (itstool) path: appendixinfo/copyright
2452 #: C/index.docbook:15
2453 msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
2454 msgstr ""
2455
2456 #. (itstool) path: para/address
2457 #: C/index.docbook:20
2458 #, no-wrap
2459 msgid ""
2460 "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
2461 " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
2462 " <postcode>02110-1301</postcode> <country>USA</country>"
2463 msgstr ""
2464
2465 #. (itstool) path: legalnotice/para
2466 #: C/index.docbook:19 C/fdl-appendix.xml:19
2467 msgid ""
2468 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
2469 "of this license document, but changing it is not allowed."
2470 msgstr ""
2471
2472 #. (itstool) path: appendix/title
2473 #. (itstool) path: para/quote
2474 #: C/index.docbook:28 C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
2475 msgid "GNU Free Documentation License"
2476 msgstr ""
2477
2478 #. (itstool) path: sect1/title
2479 #: C/index.docbook:31 C/fdl-appendix.xml:31
2480 msgid "0. PREAMBLE"
2481 msgstr ""
2482
2483 #. (itstool) path: sect1/para
2484 #: C/index.docbook:32
2485 msgid ""
2486 "The purpose of this License is to make a manual, textbook, or other written "
2487 "document <quote>free</quote> in the sense of freedom: to assure everyone the "
2488 "effective freedom to copy and redistribute it, with or without modifying it, "
2489 "either commercially or noncommercially. Secondarily, this License preserves "
2490 "for the author and publisher a way to get credit for their work, while not "
2491 "being considered responsible for modifications made by others."
2492 msgstr ""
2493
2494 #. (itstool) path: sect1/para
2495 #: C/index.docbook:43
2496 msgid ""
2497 "This License is a kind of <quote>copyleft</quote>, which means that "
2498 "derivative works of the document must themselves be free in the same sense. "
2499 "It complements the GNU General Public License, which is a copyleft license "
2500 "designed for free software."
2501 msgstr ""
2502
2503 #. (itstool) path: sect1/para
2504 #: C/index.docbook:50 C/fdl-appendix.xml:50
2505 msgid ""
2506 "We have designed this License in order to use it for manuals for free "
2507 "software, because free software needs free documentation: a free program "
2508 "should come with manuals providing the same freedoms that the software does. "
2509 "But this License is not limited to software manuals; it can be used for any "
2510 "textual work, regardless of subject matter or whether it is published as a "
2511 "printed book. We recommend this License principally for works whose purpose "
2512 "is instruction or reference."
2513 msgstr ""
2514
2515 #. (itstool) path: sect1/title
2516 #: C/index.docbook:62 C/fdl-appendix.xml:62
2517 msgid "1. APPLICABILITY AND DEFINITIONS"
2518 msgstr ""
2519
2520 #. (itstool) path: sect1/para
2521 #: C/index.docbook:63
2522 msgid ""
2523 "This License applies to any manual or other work that contains a notice "
2524 "placed by the copyright holder saying it can be distributed under the terms "
2525 "of this License. The <quote>Document</quote>, below, refers to any such "
2526 "manual or work. Any member of the public is a licensee, and is addressed as "
2527 "<quote>you</quote>."
2528 msgstr ""
2529
2530 #. (itstool) path: sect1/para
2531 #: C/index.docbook:72
2532 msgid ""
2533 "A <quote>Modified Version</quote> of the Document means any work containing "
2534 "the Document or a portion of it, either copied verbatim, or with "
2535 "modifications and/or translated into another language."
2536 msgstr ""
2537
2538 #. (itstool) path: sect1/para
2539 #: C/index.docbook:79
2540 msgid ""
2541 "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
2542 "section of the <link linkend=\"fdl-document\">Document</link> that deals "
2543 "exclusively with the relationship of the publishers or authors of the "
2544 "Document to the Document's overall subject (or to related matters) and "
2545 "contains nothing that could fall directly within that overall subject. (For "
2546 "example, if the Document is in part a textbook of mathematics, a Secondary "
2547 "Section may not explain any mathematics.) The relationship could be a matter "
2548 "of historical connection with the subject or with related matters, or of "
2549 "legal, commercial, philosophical, ethical or political position regarding "
2550 "them."
2551 msgstr ""
2552
2553 #. (itstool) path: sect1/para
2554 #: C/index.docbook:94
2555 msgid ""
2556 "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
2557 "secondary\"> Secondary Sections</link> whose titles are designated, as being "
2558 "those of Invariant Sections, in the notice that says that the <link linkend="
2559 "\"fdl-document\">Document</link> is released under this License."
2560 msgstr ""
2561
2562 #. (itstool) path: sect1/para
2563 #: C/index.docbook:103
2564 msgid ""
2565 "The <quote>Cover Texts</quote> are certain short passages of text that are "
2566 "listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says "
2567 "that the <link linkend=\"fdl-document\">Document</link> is released under "
2568 "this License."
2569 msgstr ""
2570
2571 #. (itstool) path: sect1/para
2572 #: C/index.docbook:111
2573 msgid ""
2574 "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
2575 "Document</link> means a machine-readable copy, represented in a format whose "
2576 "specification is available to the general public, whose contents can be "
2577 "viewed and edited directly and straightforwardly with generic text editors "
2578 "or (for images composed of pixels) generic paint programs or (for drawings) "
2579 "some widely available drawing editor, and that is suitable for input to text "
2580 "formatters or for automatic translation to a variety of formats suitable for "
2581 "input to text formatters. A copy made in an otherwise Transparent file "
2582 "format whose markup has been designed to thwart or discourage subsequent "
2583 "modification by readers is not Transparent. A copy that is not "
2584 "<quote>Transparent</quote> is called <quote>Opaque</quote>."
2585 msgstr ""
2586
2587 #. (itstool) path: sect1/para
2588 #: C/index.docbook:128 C/fdl-appendix.xml:128
2589 msgid ""
2590 "Examples of suitable formats for Transparent copies include plain ASCII "
2591 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
2592 "a publicly available DTD, and standard-conforming simple HTML designed for "
2593 "human modification. Opaque formats include PostScript, PDF, proprietary "
2594 "formats that can be read and edited only by proprietary word processors, "
2595 "SGML or XML for which the DTD and/or processing tools are not generally "
2596 "available, and the machine-generated HTML produced by some word processors "
2597 "for output purposes only."
2598 msgstr ""
2599
2600 #. (itstool) path: sect1/para
2601 #: C/index.docbook:141
2602 msgid ""
2603 "The <quote>Title Page</quote> means, for a printed book, the title page "
2604 "itself, plus such following pages as are needed to hold, legibly, the "
2605 "material this License requires to appear in the title page. For works in "
2606 "formats which do not have any title page as such, <quote>Title Page</quote> "
2607 "means the text near the most prominent appearance of the work's title, "
2608 "preceding the beginning of the body of the text."
2609 msgstr ""
2610
2611 #. (itstool) path: sect1/title
2612 #: C/index.docbook:153 C/fdl-appendix.xml:153
2613 msgid "2. VERBATIM COPYING"
2614 msgstr ""
2615
2616 #. (itstool) path: sect1/para
2617 #: C/index.docbook:154
2618 msgid ""
2619 "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
2620 "link> in any medium, either commercially or noncommercially, provided that "
2621 "this License, the copyright notices, and the license notice saying this "
2622 "License applies to the Document are reproduced in all copies, and that you "
2623 "add no other conditions whatsoever to those of this License. You may not use "
2624 "technical measures to obstruct or control the reading or further copying of "
2625 "the copies you make or distribute. However, you may accept compensation in "
2626 "exchange for copies. If you distribute a large enough number of copies you "
2627 "must also follow the conditions in <link linkend=\"fdl-section3\">section 3</"
2628 "link>."
2629 msgstr ""
2630
2631 #. (itstool) path: sect1/para
2632 #: C/index.docbook:169 C/fdl-appendix.xml:169
2633 msgid ""
2634 "You may also lend copies, under the same conditions stated above, and you "
2635 "may publicly display copies."
2636 msgstr ""
2637
2638 #. (itstool) path: sect1/title
2639 #: C/index.docbook:176 C/fdl-appendix.xml:176
2640 msgid "3. COPYING IN QUANTITY"
2641 msgstr "3. COPIANDO EN CANTIDADE"
2642
2643 #. (itstool) path: sect1/para
2644 #: C/index.docbook:177
2645 msgid ""
2646 "If you publish printed copies of the <link linkend=\"fdl-document"
2647 "\">Document</link> numbering more than 100, and the Document's license "
2648 "notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</link>, you "
2649 "must enclose the copies in covers that carry, clearly and legibly, all these "
2650 "Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on "
2651 "the back cover. Both covers must also clearly and legibly identify you as "
2652 "the publisher of these copies. The front cover must present the full title "
2653 "with all words of the title equally prominent and visible. You may add other "
2654 "material on the covers in addition. Copying with changes limited to the "
2655 "covers, as long as they preserve the title of the <link linkend=\"fdl-"
2656 "document\">Document</link> and satisfy these conditions, can be treated as "
2657 "verbatim copying in other respects."
2658 msgstr ""
2659
2660 #. (itstool) path: sect1/para
2661 #: C/index.docbook:195 C/fdl-appendix.xml:195
2662 msgid ""
2663 "If the required texts for either cover are too voluminous to fit legibly, "
2664 "you should put the first ones listed (as many as fit reasonably) on the "
2665 "actual cover, and continue the rest onto adjacent pages."
2666 msgstr ""
2667
2668 #. (itstool) path: sect1/para
2669 #: C/index.docbook:202
2670 msgid ""
2671 "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</link> "
2672 "copies of the <link linkend=\"fdl-document\">Document</link> numbering more "
2673 "than 100, you must either include a machine-readable <link linkend=\"fdl-"
2674 "transparent\">Transparent</link> copy along with each Opaque copy, or state "
2675 "in or with each Opaque copy a publicly-accessible computer-network location "
2676 "containing a complete Transparent copy of the Document, free of added "
2677 "material, which the general network-using public has access to download "
2678 "anonymously at no charge using public-standard network protocols. If you use "
2679 "the latter option, you must take reasonably prudent steps, when you begin "
2680 "distribution of Opaque copies in quantity, to ensure that this Transparent "
2681 "copy will remain thus accessible at the stated location until at least one "
2682 "year after the last time you distribute an Opaque copy (directly or through "
2683 "your agents or retailers) of that edition to the public."
2684 msgstr ""
2685
2686 #. (itstool) path: sect1/para
2687 #: C/index.docbook:222
2688 msgid ""
2689 "It is requested, but not required, that you contact the authors of the <link "
2690 "linkend=\"fdl-document\">Document</link> well before redistributing any "
2691 "large number of copies, to give them a chance to provide you with an updated "
2692 "version of the Document."
2693 msgstr ""
2694
2695 #. (itstool) path: sect1/title
2696 #: C/index.docbook:231 C/fdl-appendix.xml:231
2697 msgid "4. MODIFICATIONS"
2698 msgstr "4. MODIFICACIÓNS"
2699
2700 #. (itstool) path: sect1/para
2701 #: C/index.docbook:232
2702 msgid ""
2703 "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
2704 "Version</link> of the <link linkend=\"fdl-document\">Document</link> under "
2705 "the conditions of sections <link linkend=\"fdl-section2\">2</link> and <link "
2706 "linkend=\"fdl-section3\">3</link> above, provided that you release the "
2707 "Modified Version under precisely this License, with the Modified Version "
2708 "filling the role of the Document, thus licensing distribution and "
2709 "modification of the Modified Version to whoever possesses a copy of it. In "
2710 "addition, you must do these things in the Modified Version:"
2711 msgstr ""
2712
2713 #. (itstool) path: formalpara/title
2714 #: C/index.docbook:248 C/fdl-appendix.xml:248
2715 msgid "A"
2716 msgstr "A"
2717
2718 #. (itstool) path: formalpara/para
2719 #: C/index.docbook:249
2720 msgid ""
2721 "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
2722 "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
2723 "document\">Document</link>, and from those of previous versions (which "
2724 "should, if there were any, be listed in the History section of the "
2725 "Document). You may use the same title as a previous version if the original "
2726 "publisher of that version gives permission."
2727 msgstr ""
2728
2729 #. (itstool) path: formalpara/title
2730 #: C/index.docbook:264 C/fdl-appendix.xml:264
2731 msgid "B"
2732 msgstr "B"
2733
2734 #. (itstool) path: formalpara/para
2735 #: C/index.docbook:265
2736 msgid ""
2737 "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as authors, "
2738 "one or more persons or entities responsible for authorship of the "
2739 "modifications in the <link linkend=\"fdl-modified\">Modified Version</link>, "
2740 "together with at least five of the principal authors of the <link linkend="
2741 "\"fdl-document\">Document</link> (all of its principal authors, if it has "
2742 "less than five)."
2743 msgstr ""
2744
2745 #. (itstool) path: formalpara/title
2746 #: C/index.docbook:279 C/fdl-appendix.xml:279
2747 msgid "C"
2748 msgstr "C"
2749
2750 #. (itstool) path: formalpara/para
2751 #: C/index.docbook:280
2752 msgid ""
2753 "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name of "
2754 "the publisher of the <link linkend=\"fdl-modified\">Modified Version</link>, "
2755 "as the publisher."
2756 msgstr ""
2757
2758 #. (itstool) path: formalpara/title
2759 #: C/index.docbook:291 C/fdl-appendix.xml:291
2760 msgid "D"
2761 msgstr "D"
2762
2763 #. (itstool) path: formalpara/para
2764 #: C/index.docbook:292
2765 msgid ""
2766 "Preserve all the copyright notices of the <link linkend=\"fdl-document"
2767 "\">Document</link>."
2768 msgstr ""
2769
2770 #. (itstool) path: formalpara/title
2771 #: C/index.docbook:301 C/fdl-appendix.xml:301
2772 msgid "E"
2773 msgstr "E"
2774
2775 #. (itstool) path: formalpara/para
2776 #: C/index.docbook:302 C/fdl-appendix.xml:302
2777 msgid ""
2778 "Add an appropriate copyright notice for your modifications adjacent to the "
2779 "other copyright notices."
2780 msgstr ""
2781
2782 #. (itstool) path: formalpara/title
2783 #: C/index.docbook:311 C/fdl-appendix.xml:311
2784 msgid "F"
2785 msgstr "F"
2786
2787 #. (itstool) path: formalpara/para
2788 #: C/index.docbook:312
2789 msgid ""
2790 "Include, immediately after the copyright notices, a license notice giving "
2791 "the public permission to use the <link linkend=\"fdl-modified\">Modified "
2792 "Version</link> under the terms of this License, in the form shown in the "
2793 "Addendum below."
2794 msgstr ""
2795
2796 #. (itstool) path: formalpara/title
2797 #: C/index.docbook:324 C/fdl-appendix.xml:324
2798 msgid "G"
2799 msgstr "G"
2800
2801 #. (itstool) path: formalpara/para
2802 #: C/index.docbook:325
2803 msgid ""
2804 "Preserve in that license notice the full lists of <link linkend=\"fdl-"
2805 "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
2806 "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-document"
2807 "\">Document's</link> license notice."
2808 msgstr ""
2809
2810 #. (itstool) path: formalpara/title
2811 #: C/index.docbook:337 C/fdl-appendix.xml:337
2812 msgid "H"
2813 msgstr "H"
2814
2815 #. (itstool) path: formalpara/para
2816 #: C/index.docbook:338 C/fdl-appendix.xml:338
2817 msgid "Include an unaltered copy of this License."
2818 msgstr ""
2819
2820 #. (itstool) path: formalpara/title
2821 #: C/index.docbook:346 C/fdl-appendix.xml:346
2822 msgid "I"
2823 msgstr "I"
2824
2825 #. (itstool) path: formalpara/para
2826 #: C/index.docbook:347
2827 msgid ""
2828 "Preserve the section entitled <quote>History</quote>, and its title, and add "
2829 "to it an item stating at least the title, year, new authors, and publisher "
2830 "of the <link linkend=\"fdl-modified\">Modified Version</link> as given on "
2831 "the <link linkend=\"fdl-title-page\">Title Page</link>. If there is no "
2832 "section entitled <quote>History</quote> in the <link linkend=\"fdl-document"
2833 "\">Document</link>, create one stating the title, year, authors, and "
2834 "publisher of the Document as given on its Title Page, then add an item "
2835 "describing the Modified Version as stated in the previous sentence."
2836 msgstr ""
2837
2838 #. (itstool) path: formalpara/title
2839 #: C/index.docbook:365 C/fdl-appendix.xml:365
2840 msgid "J"
2841 msgstr "J"
2842
2843 #. (itstool) path: formalpara/para
2844 #: C/index.docbook:366
2845 msgid ""
2846 "Preserve the network location, if any, given in the <link linkend=\"fdl-"
2847 "document\">Document</link> for public access to a <link linkend=\"fdl-"
2848 "transparent\">Transparent</link> copy of the Document, and likewise the "
2849 "network locations given in the Document for previous versions it was based "
2850 "on. These may be placed in the <quote>History</quote> section. You may omit "
2851 "a network location for a work that was published at least four years before "
2852 "the Document itself, or if the original publisher of the version it refers "
2853 "to gives permission."
2854 msgstr ""
2855
2856 #. (itstool) path: formalpara/title
2857 #: C/index.docbook:383 C/fdl-appendix.xml:383
2858 msgid "K"
2859 msgstr "K"
2860
2861 #. (itstool) path: formalpara/para
2862 #: C/index.docbook:384
2863 msgid ""
2864 "In any section entitled <quote>Acknowledgements</quote> or "
2865 "<quote>Dedications</quote>, preserve the section's title, and preserve in "
2866 "the section all the substance and tone of each of the contributor "
2867 "acknowledgements and/or dedications given therein."
2868 msgstr ""
2869
2870 #. (itstool) path: formalpara/title
2871 #: C/index.docbook:396 C/fdl-appendix.xml:396
2872 msgid "L"
2873 msgstr "L"
2874
2875 #. (itstool) path: formalpara/para
2876 #: C/index.docbook:397
2877 msgid ""
2878 "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</link> "
2879 "of the <link linkend=\"fdl-document\">Document</link>, unaltered in their "
2880 "text and in their titles. Section numbers or the equivalent are not "
2881 "considered part of the section titles."
2882 msgstr ""
2883
2884 #. (itstool) path: formalpara/title
2885 #: C/index.docbook:409 C/fdl-appendix.xml:409
2886 msgid "M"
2887 msgstr "M"
2888
2889 #. (itstool) path: formalpara/para
2890 #: C/index.docbook:410
2891 msgid ""
2892 "Delete any section entitled <quote>Endorsements</quote>. Such a section may "
2893 "not be included in the <link linkend=\"fdl-modified\">Modified Version</"
2894 "link>."
2895 msgstr ""
2896
2897 #. (itstool) path: formalpara/title
2898 #: C/index.docbook:421 C/fdl-appendix.xml:421
2899 msgid "N"
2900 msgstr "N"
2901
2902 #. (itstool) path: formalpara/para
2903 #: C/index.docbook:422
2904 msgid ""
2905 "Do not retitle any existing section as <quote>Endorsements</quote> or to "
2906 "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
2907 "Section</link>."
2908 msgstr ""
2909
2910 #. (itstool) path: sect1/para
2911 #: C/index.docbook:432
2912 msgid ""
2913 "If the <link linkend=\"fdl-modified\">Modified Version</link> includes new "
2914 "front-matter sections or appendices that qualify as <link linkend=\"fdl-"
2915 "secondary\">Secondary Sections</link> and contain no material copied from "
2916 "the Document, you may at your option designate some or all of these sections "
2917 "as invariant. To do this, add their titles to the list of <link linkend="
2918 "\"fdl-invariant\">Invariant Sections</link> in the Modified Version's "
2919 "license notice. These titles must be distinct from any other section titles."
2920 msgstr ""
2921
2922 #. (itstool) path: sect1/para
2923 #: C/index.docbook:444
2924 msgid ""
2925 "You may add a section entitled <quote>Endorsements</quote>, provided it "
2926 "contains nothing but endorsements of your <link linkend=\"fdl-modified"
2927 "\">Modified Version</link> by various parties--for example, statements of "
2928 "peer review or that the text has been approved by an organization as the "
2929 "authoritative definition of a standard."
2930 msgstr ""
2931
2932 #. (itstool) path: sect1/para
2933 #: C/index.docbook:453
2934 msgid ""
2935 "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
2936 "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a <link "
2937 "linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of the list "
2938 "of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the <link linkend="
2939 "\"fdl-modified\">Modified Version</link>. Only one passage of Front-Cover "
2940 "Text and one of Back-Cover Text may be added by (or through arrangements "
2941 "made by) any one entity. If the <link linkend=\"fdl-document\">Document</"
2942 "link> already includes a cover text for the same cover, previously added by "
2943 "you or by arrangement made by the same entity you are acting on behalf of, "
2944 "you may not add another; but you may replace the old one, on explicit "
2945 "permission from the previous publisher that added the old one."
2946 msgstr ""
2947
2948 #. (itstool) path: sect1/para
2949 #: C/index.docbook:470
2950 msgid ""
2951 "The author(s) and publisher(s) of the <link linkend=\"fdl-document"
2952 "\">Document</link> do not by this License give permission to use their names "
2953 "for publicity for or to assert or imply endorsement of any <link linkend="
2954 "\"fdl-modified\">Modified Version </link>."
2955 msgstr ""
2956
2957 #. (itstool) path: sect1/title
2958 #: C/index.docbook:480 C/fdl-appendix.xml:480
2959 msgid "5. COMBINING DOCUMENTS"
2960 msgstr ""
2961
2962 #. (itstool) path: sect1/para
2963 #: C/index.docbook:481
2964 msgid ""
2965 "You may combine the <link linkend=\"fdl-document\">Document</link> with "
2966 "other documents released under this License, under the terms defined in "
2967 "<link linkend=\"fdl-section4\">section 4</link> above for modified versions, "
2968 "provided that you include in the combination all of the <link linkend=\"fdl-"
2969 "invariant\">Invariant Sections</link> of all of the original documents, "
2970 "unmodified, and list them all as Invariant Sections of your combined work in "
2971 "its license notice."
2972 msgstr ""
2973
2974 #. (itstool) path: sect1/para
2975 #: C/index.docbook:492
2976 msgid ""
2977 "The combined work need only contain one copy of this License, and multiple "
2978 "identical <link linkend=\"fdl-invariant\">Invariant Sections</link> may be "
2979 "replaced with a single copy. If there are multiple Invariant Sections with "
2980 "the same name but different contents, make the title of each such section "
2981 "unique by adding at the end of it, in parentheses, the name of the original "
2982 "author or publisher of that section if known, or else a unique number. Make "
2983 "the same adjustment to the section titles in the list of Invariant Sections "
2984 "in the license notice of the combined work."
2985 msgstr ""
2986
2987 #. (itstool) path: sect1/para
2988 #: C/index.docbook:505
2989 msgid ""
2990 "In the combination, you must combine any sections entitled <quote>History</"
2991 "quote> in the various original documents, forming one section entitled "
2992 "<quote>History</quote>; likewise combine any sections entitled "
2993 "<quote>Acknowledgements</quote>, and any sections entitled "
2994 "<quote>Dedications</quote>. You must delete all sections entitled "
2995 "<quote>Endorsements.</quote>"
2996 msgstr ""
2997
2998 #. (itstool) path: sect1/title
2999 #: C/index.docbook:516 C/fdl-appendix.xml:516
3000 msgid "6. COLLECTIONS OF DOCUMENTS"
3001 msgstr ""
3002
3003 #. (itstool) path: sect1/para
3004 #: C/index.docbook:517
3005 msgid ""
3006 "You may make a collection consisting of the <link linkend=\"fdl-document"
3007 "\">Document</link> and other documents released under this License, and "
3008 "replace the individual copies of this License in the various documents with "
3009 "a single copy that is included in the collection, provided that you follow "
3010 "the rules of this License for verbatim copying of each of the documents in "
3011 "all other respects."
3012 msgstr ""
3013
3014 #. (itstool) path: sect1/para
3015 #: C/index.docbook:527 C/fdl-appendix.xml:527
3016 msgid ""
3017 "You may extract a single document from such a collection, and dispbibute it "
3018 "individually under this License, provided you insert a copy of this License "
3019 "into the extracted document, and follow this License in all other respects "
3020 "regarding verbatim copying of that document."
3021 msgstr ""
3022
3023 #. (itstool) path: sect1/title
3024 #: C/index.docbook:537 C/fdl-appendix.xml:537
3025 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
3026 msgstr ""
3027
3028 #. (itstool) path: sect1/para
3029 #: C/index.docbook:538
3030 msgid ""
3031 "A compilation of the <link linkend=\"fdl-document\">Document</link> or its "
3032 "derivatives with other separate and independent documents or works, in or on "
3033 "a volume of a storage or distribution medium, does not as a whole count as a "
3034 "<link linkend=\"fdl-modified\">Modified Version</link> of the Document, "
3035 "provided no compilation copyright is claimed for the compilation. Such a "
3036 "compilation is called an <quote>aggregate</quote>, and this License does not "
3037 "apply to the other self-contained works thus compiled with the Document , on "
3038 "account of their being thus compiled, if they are not themselves derivative "
3039 "works of the Document. If the <link linkend=\"fdl-cover-texts\">Cover Text</"
3040 "link> requirement of <link linkend=\"fdl-section3\">section 3</link> is "
3041 "applicable to these copies of the Document, then if the Document is less "
3042 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
3043 "placed on covers that surround only the Document within the aggregate. "
3044 "Otherwise they must appear on covers around the whole aggregate."
3045 msgstr ""
3046
3047 #. (itstool) path: sect1/title
3048 #: C/index.docbook:561 C/fdl-appendix.xml:561
3049 msgid "8. TRANSLATION"
3050 msgstr ""
3051
3052 #. (itstool) path: sect1/para
3053 #: C/index.docbook:562
3054 msgid ""
3055 "Translation is considered a kind of modification, so you may distribute "
3056 "translations of the <link linkend=\"fdl-document\">Document</link> under the "
3057 "terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing <link "
3058 "linkend=\"fdl-invariant\"> Invariant Sections</link> with translations "
3059 "requires special permission from their copyright holders, but you may "
3060 "include translations of some or all Invariant Sections in addition to the "
3061 "original versions of these Invariant Sections. You may include a translation "
3062 "of this License provided that you also include the original English version "
3063 "of this License. In case of a disagreement between the translation and the "
3064 "original English version of this License, the original English version will "
3065 "prevail."
3066 msgstr ""
3067
3068 #. (itstool) path: sect1/title
3069 #: C/index.docbook:580 C/fdl-appendix.xml:580
3070 msgid "9. TERMINATION"
3071 msgstr ""
3072
3073 #. (itstool) path: sect1/para
3074 #: C/index.docbook:581
3075 msgid ""
3076 "You may not copy, modify, sublicense, or distribute the <link linkend=\"fdl-"
3077 "document\">Document</link> except as expressly provided for under this "
3078 "License. Any other attempt to copy, modify, sublicense or distribute the "
3079 "Document is void, and will automatically terminate your rights under this "
3080 "License. However, parties who have received copies, or rights, from you "
3081 "under this License will not have their licenses terminated so long as such "
3082 "parties remain in full compliance."
3083 msgstr ""
3084
3085 #. (itstool) path: sect1/title
3086 #: C/index.docbook:594 C/fdl-appendix.xml:594
3087 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
3088 msgstr ""
3089
3090 #. (itstool) path: sect1/para
3091 #: C/index.docbook:595
3092 msgid ""
3093 "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
3094 "Software Foundation</ulink> may publish new, revised versions of the GNU "
3095 "Free Documentation License from time to time. Such new versions will be "
3096 "similar in spirit to the present version, but may differ in detail to "
3097 "address new problems or concerns. See <ulink type=\"http\" url=\"http://www."
3098 "gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
3099 msgstr ""
3100
3101 #. (itstool) path: sect1/para
3102 #: C/index.docbook:606
3103 msgid ""
3104 "Each version of the License is given a distinguishing version number. If the "
3105 "<link linkend=\"fdl-document\">Document</link> specifies that a particular "
3106 "numbered version of this License <quote>or any later version</quote> applies "
3107 "to it, you have the option of following the terms and conditions either of "
3108 "that specified version or of any later version that has been published (not "
3109 "as a draft) by the Free Software Foundation. If the Document does not "
3110 "specify a version number of this License, you may choose any version ever "
3111 "published (not as a draft) by the Free Software Foundation."
3112 msgstr ""
3113
3114 #. (itstool) path: sect1/title
3115 #: C/index.docbook:621 C/fdl-appendix.xml:621
3116 msgid "Addendum"
3117 msgstr ""
3118
3119 #. (itstool) path: sect1/para
3120 #: C/index.docbook:622 C/fdl-appendix.xml:622
3121 msgid ""
3122 "To use this License in a document you have written, include a copy of the "
3123 "License in the document and put the following copyright and license notices "
3124 "just after the title page:"
3125 msgstr ""
3126
3127 #. (itstool) path: blockquote/para
3128 #: C/index.docbook:629 C/fdl-appendix.xml:629
3129 msgid "Copyright YEAR YOUR NAME."
3130 msgstr ""
3131
3132 #. (itstool) path: blockquote/para
3133 #: C/index.docbook:632
3134 msgid ""
3135 "Permission is granted to copy, distribute and/or modify this document under "
3136 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
3137 "version published by the Free Software Foundation; with the <link linkend="
3138 "\"fdl-invariant\">Invariant Sections</link> being LIST THEIR TITLES, with "
3139 "the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</link> being LIST, "
3140 "and with the <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link> being "
3141 "LIST. A copy of the license is included in the section entitled <quote>GNU "
3142 "Free Documentation License</quote>."
3143 msgstr ""
3144
3145 #. (itstool) path: sect1/para
3146 #: C/index.docbook:647
3147 msgid ""
3148 "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
3149 "write <quote>with no Invariant Sections</quote> instead of saying which ones "
3150 "are invariant. If you have no <link linkend=\"fdl-cover-texts\">Front-Cover "
3151 "Texts</link>, write <quote>no Front-Cover Texts</quote> instead of "
3152 "<quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="
3153 "\"fdl-cover-texts\">Back-Cover Texts</link>."
3154 msgstr ""
3155
3156 #. (itstool) path: sect1/para
3157 #: C/index.docbook:657
3158 msgid ""
3159 "If your document contains nontrivial examples of program code, we recommend "
3160 "releasing these examples in parallel under your choice of free software "
3161 "license, such as the <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
3162 "gpl.html\"> GNU General Public License</ulink>, to permit their use in free "
3163 "software."
3164 msgstr ""
3165
3166 #. (itstool) path: copyright/year
3167 #: C/fdl-appendix.xml:16
3168 msgid "2000"
3169 msgstr "2000"
3170
3171 #. (itstool) path: copyright/holder
3172 #: C/fdl-appendix.xml:16
3173 msgid "Free Software Foundation, Inc."
3174 msgstr "Free Software Foundation, Inc."
3175
3176 #. (itstool) path: address/street
3177 #: C/fdl-appendix.xml:20
3178 msgid "51 Franklin Street, Suite 330"
3179 msgstr "51 Franklin Street, Suite 330"
3180
3181 #. (itstool) path: address/city
3182 #: C/fdl-appendix.xml:21
3183 msgid "Boston"
3184 msgstr "Boston"
3185
3186 #. (itstool) path: address/state
3187 #: C/fdl-appendix.xml:21
3188 msgid "MA"
3189 msgstr "MA"
3190
3191 #. (itstool) path: address/postcode
3192 #: C/fdl-appendix.xml:22
3193 msgid "02110-1301"
3194 msgstr "02110-1301"
3195
3196 #. (itstool) path: address/country
3197 #: C/fdl-appendix.xml:22
3198 msgid "USA"
3199 msgstr "USA"
3200
3201 #. (itstool) path: para/address
3202 #: C/fdl-appendix.xml:20
3203 msgid ""
3204 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
3205 "postcode-4/> <_:country-5/>"
3206 msgstr ""
3207 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
3208 "<_:postcode-4/> <_:country-5/>"
3209
3210 #. (itstool) path: para/quote
3211 #: C/fdl-appendix.xml:34
3212 msgid "free"
3213 msgstr ""
3214
3215 #. (itstool) path: sect1/para
3216 #: C/fdl-appendix.xml:32
3217 msgid ""
3218 "The purpose of this License is to make a manual, textbook, or other written "
3219 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
3220 "effective freedom to copy and redistribute it, with or without modifying it, "
3221 "either commercially or noncommercially. Secondarily, this License preserves "
3222 "for the author and publisher a way to get credit for their work, while not "
3223 "being considered responsible for modifications made by others."
3224 msgstr ""
3225
3226 #. (itstool) path: para/quote
3227 #: C/fdl-appendix.xml:44
3228 msgid "copyleft"
3229 msgstr ""
3230
3231 #. (itstool) path: sect1/para
3232 #: C/fdl-appendix.xml:43
3233 msgid ""
3234 "This License is a kind of <_:quote-1/>, which means that derivative works of "
3235 "the document must themselves be free in the same sense. It complements the "
3236 "GNU General Public License, which is a copyleft license designed for free "
3237 "software."
3238 msgstr ""
3239
3240 #. (itstool) path: para/quote
3241 #. (itstool) path: para/link
3242 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
3243 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
3244 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
3245 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
3246 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
3247 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
3248 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
3249 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
3250 #: C/fdl-appendix.xml:608
3251 msgid "Document"
3252 msgstr ""
3253
3254 #. (itstool) path: para/quote
3255 #: C/fdl-appendix.xml:69
3256 msgid "you"
3257 msgstr ""
3258
3259 #. (itstool) path: sect1/para
3260 #: C/fdl-appendix.xml:63
3261 msgid ""
3262 "This License applies to any manual or other work that contains a notice "
3263 "placed by the copyright holder saying it can be distributed under the terms "
3264 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
3265 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
3266 msgstr ""
3267
3268 #. (itstool) path: para/quote
3269 #. (itstool) path: para/link
3270 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
3271 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
3272 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
3273 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
3274 msgid "Modified Version"
3275 msgstr ""
3276
3277 #. (itstool) path: sect1/para
3278 #: C/fdl-appendix.xml:72
3279 msgid ""
3280 "A <_:quote-1/> of the Document means any work containing the Document or a "
3281 "portion of it, either copied verbatim, or with modifications and/or "
3282 "translated into another language."
3283 msgstr ""
3284
3285 #. (itstool) path: para/quote
3286 #: C/fdl-appendix.xml:80
3287 msgid "Secondary Section"
3288 msgstr ""
3289
3290 #. (itstool) path: sect1/para
3291 #: C/fdl-appendix.xml:79
3292 msgid ""
3293 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:"
3294 "link-2/> that deals exclusively with the relationship of the publishers or "
3295 "authors of the Document to the Document's overall subject (or to related "
3296 "matters) and contains nothing that could fall directly within that overall "
3297 "subject. (For example, if the Document is in part a textbook of mathematics, "
3298 "a Secondary Section may not explain any mathematics.) The relationship could "
3299 "be a matter of historical connection with the subject or with related "
3300 "matters, or of legal, commercial, philosophical, ethical or political "
3301 "position regarding them."
3302 msgstr ""
3303
3304 #. (itstool) path: para/quote
3305 #. (itstool) path: para/link
3306 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
3307 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
3308 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
3309 msgid "Invariant Sections"
3310 msgstr ""
3311
3312 #. (itstool) path: para/link
3313 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
3314 msgid "Secondary Sections"
3315 msgstr ""
3316
3317 #. (itstool) path: sect1/para
3318 #: C/fdl-appendix.xml:94
3319 msgid ""
3320 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
3321 "being those of Invariant Sections, in the notice that says that the <_:"
3322 "link-3/> is released under this License."
3323 msgstr ""
3324
3325 #. (itstool) path: para/quote
3326 #. (itstool) path: para/link
3327 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
3328 #: C/fdl-appendix.xml:458
3329 msgid "Cover Texts"
3330 msgstr ""
3331
3332 #. (itstool) path: sect1/para
3333 #: C/fdl-appendix.xml:103
3334 msgid ""
3335 "The <_:quote-1/> are certain short passages of text that are listed, as "
3336 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:"
3337 "link-2/> is released under this License."
3338 msgstr ""
3339
3340 #. (itstool) path: para/quote
3341 #. (itstool) path: para/link
3342 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
3343 #: C/fdl-appendix.xml:369
3344 msgid "Transparent"
3345 msgstr ""
3346
3347 #. (itstool) path: para/quote
3348 #. (itstool) path: para/link
3349 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
3350 msgid "Opaque"
3351 msgstr ""
3352
3353 #. (itstool) path: sect1/para
3354 #: C/fdl-appendix.xml:111
3355 msgid ""
3356 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
3357 "represented in a format whose specification is available to the general "
3358 "public, whose contents can be viewed and edited directly and "
3359 "straightforwardly with generic text editors or (for images composed of "
3360 "pixels) generic paint programs or (for drawings) some widely available "
3361 "drawing editor, and that is suitable for input to text formatters or for "
3362 "automatic translation to a variety of formats suitable for input to text "
3363 "formatters. A copy made in an otherwise Transparent file format whose markup "
3364 "has been designed to thwart or discourage subsequent modification by readers "
3365 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
3366 msgstr ""
3367
3368 #. (itstool) path: para/quote
3369 #. (itstool) path: para/link
3370 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
3371 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
3372 msgid "Title Page"
3373 msgstr ""
3374
3375 #. (itstool) path: sect1/para
3376 #: C/fdl-appendix.xml:141
3377 msgid ""
3378 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
3379 "following pages as are needed to hold, legibly, the material this License "
3380 "requires to appear in the title page. For works in formats which do not have "
3381 "any title page as such, <_:quote-2/> means the text near the most prominent "
3382 "appearance of the work's title, preceding the beginning of the body of the "
3383 "text."
3384 msgstr ""
3385
3386 #. (itstool) path: para/link
3387 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
3388 msgid "section 3"
3389 msgstr ""
3390
3391 #. (itstool) path: sect1/para
3392 #: C/fdl-appendix.xml:154
3393 msgid ""
3394 "You may copy and distribute the <_:link-1/> in any medium, either "
3395 "commercially or noncommercially, provided that this License, the copyright "
3396 "notices, and the license notice saying this License applies to the Document "
3397 "are reproduced in all copies, and that you add no other conditions "
3398 "whatsoever to those of this License. You may not use technical measures to "
3399 "obstruct or control the reading or further copying of the copies you make or "
3400 "distribute. However, you may accept compensation in exchange for copies. If "
3401 "you distribute a large enough number of copies you must also follow the "
3402 "conditions in <_:link-2/>."
3403 msgstr ""
3404
3405 #. (itstool) path: sect1/para
3406 #: C/fdl-appendix.xml:177
3407 msgid ""
3408 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
3409 "and the Document's license notice requires <_:link-2/>, you must enclose the "
3410 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
3411 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
3412 "cover. Both covers must also clearly and legibly identify you as the "
3413 "publisher of these copies. The front cover must present the full title with "
3414 "all words of the title equally prominent and visible. You may add other "
3415 "material on the covers in addition. Copying with changes limited to the "
3416 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
3417 "these conditions, can be treated as verbatim copying in other respects."
3418 msgstr ""
3419
3420 #. (itstool) path: sect1/para
3421 #: C/fdl-appendix.xml:202
3422 msgid ""
3423 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
3424 "more than 100, you must either include a machine-readable <_:link-3/> copy "
3425 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
3426 "accessible computer-network location containing a complete Transparent copy "
3427 "of the Document, free of added material, which the general network-using "
3428 "public has access to download anonymously at no charge using public-standard "
3429 "network protocols. If you use the latter option, you must take reasonably "
3430 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
3431 "ensure that this Transparent copy will remain thus accessible at the stated "
3432 "location until at least one year after the last time you distribute an "
3433 "Opaque copy (directly or through your agents or retailers) of that edition "
3434 "to the public."
3435 msgstr ""
3436
3437 #. (itstool) path: sect1/para
3438 #: C/fdl-appendix.xml:222
3439 msgid ""
3440 "It is requested, but not required, that you contact the authors of the <_:"
3441 "link-1/> well before redistributing any large number of copies, to give them "
3442 "a chance to provide you with an updated version of the Document."
3443 msgstr ""
3444
3445 #. (itstool) path: para/link
3446 #: C/fdl-appendix.xml:236
3447 msgid "2"
3448 msgstr ""
3449
3450 #. (itstool) path: para/link
3451 #: C/fdl-appendix.xml:237
3452 msgid "3"
3453 msgstr ""
3454
3455 #. (itstool) path: sect1/para
3456 #: C/fdl-appendix.xml:232
3457 msgid ""
3458 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
3459 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
3460 "release the Modified Version under precisely this License, with the Modified "
3461 "Version filling the role of the Document, thus licensing distribution and "
3462 "modification of the Modified Version to whoever possesses a copy of it. In "
3463 "addition, you must do these things in the Modified Version:"
3464 msgstr ""
3465
3466 #. (itstool) path: formalpara/para
3467 #: C/fdl-appendix.xml:249
3468 msgid ""
3469 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
3470 "that of the <_:link-2/>, and from those of previous versions (which should, "
3471 "if there were any, be listed in the History section of the Document). You "
3472 "may use the same title as a previous version if the original publisher of "
3473 "that version gives permission."
3474 msgstr ""
3475
3476 #. (itstool) path: formalpara/para
3477 #: C/fdl-appendix.xml:265
3478 msgid ""
3479 "List on the <_:link-1/>, as authors, one or more persons or entities "
3480 "responsible for authorship of the modifications in the <_:link-2/>, together "
3481 "with at least five of the principal authors of the <_:link-3/> (all of its "
3482 "principal authors, if it has less than five)."
3483 msgstr ""
3484
3485 #. (itstool) path: formalpara/para
3486 #: C/fdl-appendix.xml:280
3487 msgid ""
3488 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
3489 "the publisher."
3490 msgstr ""
3491
3492 #. (itstool) path: formalpara/para
3493 #: C/fdl-appendix.xml:292
3494 msgid "Preserve all the copyright notices of the <_:link-1/>."
3495 msgstr ""
3496
3497 #. (itstool) path: formalpara/para
3498 #: C/fdl-appendix.xml:312
3499 msgid ""
3500 "Include, immediately after the copyright notices, a license notice giving "
3501 "the public permission to use the <_:link-1/> under the terms of this "
3502 "License, in the form shown in the Addendum below."
3503 msgstr ""
3504
3505 #. (itstool) path: para/link
3506 #: C/fdl-appendix.xml:330
3507 msgid "Document's"
3508 msgstr ""
3509
3510 #. (itstool) path: formalpara/para
3511 #: C/fdl-appendix.xml:325
3512 msgid ""
3513 "Preserve in that license notice the full lists of <_:link-1/> and required "
3514 "<_:link-2/> given in the <_:link-3/> license notice."
3515 msgstr ""
3516
3517 #. (itstool) path: para/quote
3518 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
3519 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
3520 msgid "History"
3521 msgstr ""
3522
3523 #. (itstool) path: formalpara/para
3524 #: C/fdl-appendix.xml:347
3525 msgid ""
3526 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
3527 "item stating at least the title, year, new authors, and publisher of the <_:"
3528 "link-2/> as given on the <_:link-3/>. If there is no section entitled <_:"
3529 "quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
3530 "and publisher of the Document as given on its Title Page, then add an item "
3531 "describing the Modified Version as stated in the previous sentence."
3532 msgstr ""
3533
3534 #. (itstool) path: formalpara/para
3535 #: C/fdl-appendix.xml:366
3536 msgid ""
3537 "Preserve the network location, if any, given in the <_:link-1/> for public "
3538 "access to a <_:link-2/> copy of the Document, and likewise the network "
3539 "locations given in the Document for previous versions it was based on. These "
3540 "may be placed in the <_:quote-3/> section. You may omit a network location "
3541 "for a work that was published at least four years before the Document "
3542 "itself, or if the original publisher of the version it refers to gives "
3543 "permission."
3544 msgstr ""
3545
3546 #. (itstool) path: para/quote
3547 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
3548 msgid "Acknowledgements"
3549 msgstr ""
3550
3551 #. (itstool) path: para/quote
3552 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
3553 msgid "Dedications"
3554 msgstr ""
3555
3556 #. (itstool) path: formalpara/para
3557 #: C/fdl-appendix.xml:384
3558 msgid ""
3559 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
3560 "title, and preserve in the section all the substance and tone of each of the "
3561 "contributor acknowledgements and/or dedications given therein."
3562 msgstr ""
3563
3564 #. (itstool) path: formalpara/para
3565 #: C/fdl-appendix.xml:397
3566 msgid ""
3567 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
3568 "in their titles. Section numbers or the equivalent are not considered part "
3569 "of the section titles."
3570 msgstr ""
3571
3572 #. (itstool) path: para/quote
3573 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
3574 msgid "Endorsements"
3575 msgstr ""
3576
3577 #. (itstool) path: formalpara/para
3578 #: C/fdl-appendix.xml:410
3579 msgid ""
3580 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
3581 "in the <_:link-2/>."
3582 msgstr ""
3583
3584 #. (itstool) path: para/link
3585 #: C/fdl-appendix.xml:425
3586 msgid "Invariant Section"
3587 msgstr ""
3588
3589 #. (itstool) path: formalpara/para
3590 #: C/fdl-appendix.xml:422
3591 msgid ""
3592 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
3593 "with any <_:link-2/>."
3594 msgstr ""
3595
3596 #. (itstool) path: sect1/para
3597 #: C/fdl-appendix.xml:432
3598 msgid ""
3599 "If the <_:link-1/> includes new front-matter sections or appendices that "
3600 "qualify as <_:link-2/> and contain no material copied from the Document, you "
3601 "may at your option designate some or all of these sections as invariant. To "
3602 "do this, add their titles to the list of <_:link-3/> in the Modified "
3603 "Version's license notice. These titles must be distinct from any other "
3604 "section titles."
3605 msgstr ""
3606
3607 #. (itstool) path: sect1/para
3608 #: C/fdl-appendix.xml:444
3609 msgid ""
3610 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
3611 "but endorsements of your <_:link-2/> by various parties--for example, "
3612 "statements of peer review or that the text has been approved by an "
3613 "organization as the authoritative definition of a standard."
3614 msgstr ""
3615
3616 #. (itstool) path: para/link
3617 #: C/fdl-appendix.xml:455
3618 msgid "Front-Cover Text"
3619 msgstr ""
3620
3621 #. (itstool) path: para/link
3622 #: C/fdl-appendix.xml:457
3623 msgid "Back-Cover Text"
3624 msgstr ""
3625
3626 #. (itstool) path: sect1/para
3627 #: C/fdl-appendix.xml:453
3628 msgid ""
3629 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
3630 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
3631 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
3632 "Text may be added by (or through arrangements made by) any one entity. If "
3633 "the <_:link-5/> already includes a cover text for the same cover, previously "
3634 "added by you or by arrangement made by the same entity you are acting on "
3635 "behalf of, you may not add another; but you may replace the old one, on "
3636 "explicit permission from the previous publisher that added the old one."
3637 msgstr ""
3638
3639 #. (itstool) path: sect1/para
3640 #: C/fdl-appendix.xml:470
3641 msgid ""
3642 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
3643 "give permission to use their names for publicity for or to assert or imply "
3644 "endorsement of any <_:link-2/>."
3645 msgstr ""
3646
3647 #. (itstool) path: para/link
3648 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
3649 msgid "section 4"
3650 msgstr ""
3651
3652 #. (itstool) path: sect1/para
3653 #: C/fdl-appendix.xml:481
3654 msgid ""
3655 "You may combine the <_:link-1/> with other documents released under this "
3656 "License, under the terms defined in <_:link-2/> above for modified versions, "
3657 "provided that you include in the combination all of the <_:link-3/> of all "
3658 "of the original documents, unmodified, and list them all as Invariant "
3659 "Sections of your combined work in its license notice."
3660 msgstr ""
3661
3662 #. (itstool) path: sect1/para
3663 #: C/fdl-appendix.xml:492
3664 msgid ""
3665 "The combined work need only contain one copy of this License, and multiple "
3666 "identical <_:link-1/> may be replaced with a single copy. If there are "
3667 "multiple Invariant Sections with the same name but different contents, make "
3668 "the title of each such section unique by adding at the end of it, in "
3669 "parentheses, the name of the original author or publisher of that section if "
3670 "known, or else a unique number. Make the same adjustment to the section "
3671 "titles in the list of Invariant Sections in the license notice of the "
3672 "combined work."
3673 msgstr ""
3674
3675 #. (itstool) path: para/quote
3676 #: C/fdl-appendix.xml:511
3677 msgid "Endorsements."
3678 msgstr ""
3679
3680 #. (itstool) path: sect1/para
3681 #: C/fdl-appendix.xml:505
3682 msgid ""
3683 "In the combination, you must combine any sections entitled <_:quote-1/> in "
3684 "the various original documents, forming one section entitled <_:quote-2/>; "
3685 "likewise combine any sections entitled <_:quote-3/>, and any sections "
3686 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
3687 msgstr ""
3688
3689 #. (itstool) path: sect1/para
3690 #: C/fdl-appendix.xml:517
3691 msgid ""
3692 "You may make a collection consisting of the <_:link-1/> and other documents "
3693 "released under this License, and replace the individual copies of this "
3694 "License in the various documents with a single copy that is included in the "
3695 "collection, provided that you follow the rules of this License for verbatim "
3696 "copying of each of the documents in all other respects."
3697 msgstr ""
3698
3699 #. (itstool) path: para/quote
3700 #: C/fdl-appendix.xml:546
3701 msgid "aggregate"
3702 msgstr ""
3703
3704 #. (itstool) path: para/link
3705 #: C/fdl-appendix.xml:550
3706 msgid "Cover Text"
3707 msgstr ""
3708
3709 #. (itstool) path: sect1/para
3710 #: C/fdl-appendix.xml:538
3711 msgid ""
3712 "A compilation of the <_:link-1/> or its derivatives with other separate and "
3713 "independent documents or works, in or on a volume of a storage or "
3714 "distribution medium, does not as a whole count as a <_:link-2/> of the "
3715 "Document, provided no compilation copyright is claimed for the compilation. "
3716 "Such a compilation is called an <_:quote-3/>, and this License does not "
3717 "apply to the other self-contained works thus compiled with the Document , on "
3718 "account of their being thus compiled, if they are not themselves derivative "
3719 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
3720 "applicable to these copies of the Document, then if the Document is less "
3721 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
3722 "placed on covers that surround only the Document within the aggregate. "
3723 "Otherwise they must appear on covers around the whole aggregate."
3724 msgstr ""
3725
3726 #. (itstool) path: sect1/para
3727 #: C/fdl-appendix.xml:562
3728 msgid ""
3729 "Translation is considered a kind of modification, so you may distribute "
3730 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:"
3731 "link-3/> with translations requires special permission from their copyright "
3732 "holders, but you may include translations of some or all Invariant Sections "
3733 "in addition to the original versions of these Invariant Sections. You may "
3734 "include a translation of this License provided that you also include the "
3735 "original English version of this License. In case of a disagreement between "
3736 "the translation and the original English version of this License, the "
3737 "original English version will prevail."
3738 msgstr ""
3739
3740 #. (itstool) path: sect1/para
3741 #: C/fdl-appendix.xml:581
3742 msgid ""
3743 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
3744 "as expressly provided for under this License. Any other attempt to copy, "
3745 "modify, sublicense or distribute the Document is void, and will "
3746 "automatically terminate your rights under this License. However, parties who "
3747 "have received copies, or rights, from you under this License will not have "
3748 "their licenses terminated so long as such parties remain in full compliance."
3749 msgstr ""
3750
3751 #. (itstool) path: para/ulink
3752 #: C/fdl-appendix.xml:597
3753 msgid "Free Software Foundation"
3754 msgstr ""
3755
3756 #. (itstool) path: para/ulink
3757 #: C/fdl-appendix.xml:603
3758 msgid "http://www.gnu.org/copyleft/"
3759 msgstr ""
3760
3761 #. (itstool) path: sect1/para
3762 #: C/fdl-appendix.xml:595
3763 msgid ""
3764 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
3765 "Documentation License from time to time. Such new versions will be similar "
3766 "in spirit to the present version, but may differ in detail to address new "
3767 "problems or concerns. See <_:ulink-2/>."
3768 msgstr ""
3769
3770 #. (itstool) path: para/quote
3771 #: C/fdl-appendix.xml:610
3772 msgid "or any later version"
3773 msgstr ""
3774
3775 #. (itstool) path: sect1/para
3776 #: C/fdl-appendix.xml:606
3777 msgid ""
3778 "Each version of the License is given a distinguishing version number. If the "
3779 "<_:link-1/> specifies that a particular numbered version of this License <_:"
3780 "quote-2/> applies to it, you have the option of following the terms and "
3781 "conditions either of that specified version or of any later version that has "
3782 "been published (not as a draft) by the Free Software Foundation. If the "
3783 "Document does not specify a version number of this License, you may choose "
3784 "any version ever published (not as a draft) by the Free Software Foundation."
3785 msgstr ""
3786
3787 #. (itstool) path: para/link
3788 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
3789 msgid "Front-Cover Texts"
3790 msgstr ""
3791
3792 #. (itstool) path: para/link
3793 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
3794 msgid "Back-Cover Texts"
3795 msgstr ""
3796
3797 #. (itstool) path: blockquote/para
3798 #: C/fdl-appendix.xml:632
3799 msgid ""
3800 "Permission is granted to copy, distribute and/or modify this document under "
3801 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
3802 "version published by the Free Software Foundation; with the <_:link-1/> "
3803 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:"
3804 "link-3/> being LIST. A copy of the license is included in the section "
3805 "entitled <_:quote-4/>."
3806 msgstr ""
3807
3808 #. (itstool) path: para/quote
3809 #: C/fdl-appendix.xml:649
3810 msgid "with no Invariant Sections"
3811 msgstr ""
3812
3813 #. (itstool) path: para/quote
3814 #: C/fdl-appendix.xml:652
3815 msgid "no Front-Cover Texts"
3816 msgstr ""
3817
3818 #. (itstool) path: para/quote
3819 #: C/fdl-appendix.xml:653
3820 msgid "Front-Cover Texts being LIST"
3821 msgstr ""
3822
3823 #. (itstool) path: sect1/para
3824 #: C/fdl-appendix.xml:647
3825 msgid ""
3826 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
3827 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:"
3828 "quote-5/>; likewise for <_:link-6/>."
3829 msgstr ""
3830
3831 #. (itstool) path: para/ulink
3832 #: C/fdl-appendix.xml:661
3833 msgid "GNU General Public License"
3834 msgstr ""
3835
3836 #. (itstool) path: sect1/para
3837 #: C/fdl-appendix.xml:657
3838 msgid ""
3839 "If your document contains nontrivial examples of program code, we recommend "
3840 "releasing these examples in parallel under your choice of free software "
3841 "license, such as the <_:ulink-1/>, to permit their use in free software."
3842 msgstr ""