Debian Codegraph @

help/manual/en_GB/en_GB.po

raw
1 # Abigail Brady <[email protected]>, 2009.
2 # Jen Ockwell <[email protected]>, 2009
3 # Philip Withnall <[email protected]>, 2009
4 #
5 msgid ""
6 msgstr ""
7 "Project-Id-Version: GTK Doc\n"
8 "Report-Msgid-Bugs-To: \n"
9 "POT-Creation-Date: 2009-03-18 12:43+0000\n"
10 "PO-Revision-Date: 2009-03-19 20:30+0000\n"
11 "Last-Translator: Jen Ockwell <[email protected]>\n"
12 "Language-Team: British English <[email protected]>\n"
13 "MIME-Version: 1.0\n"
14 "Content-Type: text/plain; charset=UTF-8\n"
15 "Content-Transfer-Encoding: 8bit\n"
16
17 #: C/gtk-doc-manual.xml:12(title)
18 msgid "GTK-Doc Manual"
19 msgstr "GTK-Doc Manual"
20
21 #: C/gtk-doc-manual.xml:13(edition)
22 msgid "1.12"
23 msgstr "1.12"
24
25 #: C/gtk-doc-manual.xml:14(para)
26 msgid "User manual for developers with instructions of GTK-Doc usage."
27 msgstr "User manual for developers with instructions on GTK-Doc usage."
28
29 #: C/gtk-doc-manual.xml:17(firstname)
30 msgid "Chris"
31 msgstr "Chris"
32
33 #: C/gtk-doc-manual.xml:18(surname)
34 msgid "Lyttle"
35 msgstr "Lyttle"
36
37 #: C/gtk-doc-manual.xml:21(email)
38 msgid "[email protected]"
39 msgstr "[email protected]"
40
41 #: C/gtk-doc-manual.xml:26(firstname)
42 msgid "Dan"
43 msgstr "Dan"
44
45 #: C/gtk-doc-manual.xml:27(surname)
46 msgid "Mueth"
47 msgstr "Mueth"
48
49 #: C/gtk-doc-manual.xml:30(email)
50 msgid "[email protected]"
51 msgstr "[email protected]"
52
53 #: C/gtk-doc-manual.xml:35(firstname)
54 msgid "Stefan"
55 msgstr "Stefan"
56
57 #: C/gtk-doc-manual.xml:36(surname)
58 msgid "Kost"
59 msgstr "Kost"
60
61 #: C/gtk-doc-manual.xml:39(email)
62 msgid "[email protected]"
63 msgstr "[email protected]"
64
65 #: C/gtk-doc-manual.xml:45(publishername)
66 msgid "GTK-Doc project"
67 msgstr "GTK-Doc project"
68
69 #: C/gtk-doc-manual.xml:46(email)
70 msgid "[email protected]"
71 msgstr "[email protected]"
72
73 #: C/gtk-doc-manual.xml:49(year)
74 msgid "2000, 2005, 2007-2009"
75 msgstr "2000, 2005, 2007-2009"
76
77 #: C/gtk-doc-manual.xml:50(holder)
78 msgid "Dan Mueth and Chris Lyttle and Stefan Kost"
79 msgstr "Dan Mueth, Chris Lyttle and Stefan Kost"
80
81 #: C/gtk-doc-manual.xml:61(para)
82 msgid ""
83 "Permission is granted to copy, distribute and/or modify this document under "
84 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
85 "Version 1.1 or any later version published by the Free Software Foundation "
86 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
87 "copy of the license is <link linkend=\"fdl\">included</link>."
88 msgstr ""
89 "Permission is granted to copy, distribute and/or modify this document under "
90 "the terms of the <citetitle>GNU Free Documentation Licence</citetitle>, "
91 "Version 1.1 or any later version published by the Free Software Foundation "
92 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
93 "copy of the licence is <link linkend=\"fdl\">included</link>."
94
95 #: C/gtk-doc-manual.xml:69(para)
96 msgid ""
97 "Many of the names used by companies to distinguish their products and "
98 "services are claimed as trademarks. Where those names appear in any GNOME "
99 "documentation, and those trademarks are made aware to the members of the "
100 "GNOME Documentation Project, the names have been printed in caps or initial "
101 "caps."
102 msgstr ""
103 "Many of the names used by companies to distinguish their products and "
104 "services are claimed as trademarks. Where those names appear in any GNOME "
105 "documentation, and those trademarks are made aware to the members of the "
106 "GNOME Documentation Project, the names have been printed in caps or initial "
107 "caps."
108
109 #: C/gtk-doc-manual.xml:80(revnumber)
110 msgid "1.11"
111 msgstr "1.11"
112
113 #: C/gtk-doc-manual.xml:81(date)
114 msgid "22 March 2008"
115 msgstr "22 March 2008"
116
117 #: C/gtk-doc-manual.xml:82(authorinitials)
118 msgid "mal"
119 msgstr "mal"
120
121 #: C/gtk-doc-manual.xml:83(revremark)
122 msgid "GNOME doc-utils migration"
123 msgstr "GNOME doc-utils migration"
124
125 #: C/gtk-doc-manual.xml:92(title)
126 msgid "Introduction"
127 msgstr "Introduction"
128
129 #: C/gtk-doc-manual.xml:94(para)
130 msgid ""
131 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
132 "it is used."
133 msgstr ""
134 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
135 "it is used."
136
137 #: C/gtk-doc-manual.xml:100(title)
138 msgid "What is GTK-Doc?"
139 msgstr "What is GTK-Doc?"
140
141 #: C/gtk-doc-manual.xml:102(para)
142 msgid ""
143 "GTK-Doc is used to document C code. It is typically used to document the "
144 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
145 "also be used to document application code."
146 msgstr ""
147 "GTK-Doc is used to document C code. It is typically used to document the "
148 "public API of libraries, such as the GTK+ and GNOME libraries, but it can "
149 "also be used to document application code."
150
151 #: C/gtk-doc-manual.xml:110(title)
152 msgid "How Does GTK-Doc Work?"
153 msgstr "How Does GTK-Doc Work?"
154
155 #: C/gtk-doc-manual.xml:112(para)
156 msgid ""
157 "GTK-Doc works by using documentation of functions placed inside the source "
158 "files in specially-formatted comment blocks, or documentation added to the "
159 "template files which GTK-Doc uses (though note that GTK-Doc will only "
160 "document functions that are declared in header files; it won't produce "
161 "output for static functions)."
162 msgstr ""
163 "GTK-Doc works by using documentation of functions placed inside the source "
164 "files in specially-formatted comment blocks, or documentation added to the "
165 "template files which GTK-Doc uses (though note that GTK-Doc will only "
166 "document functions that are declared in header files; it won't produce "
167 "output for static functions)."
168
169 #: C/gtk-doc-manual.xml:119(para)
170 msgid ""
171 "GTK-Doc consists of a number of perl scripts, each performing a different "
172 "step in the process."
173 msgstr ""
174 "GTK-Doc consists of a number of Perl scripts, each performing a different "
175 "step in the process."
176
177 #: C/gtk-doc-manual.xml:124(para)
178 msgid "There are 5 main steps in the process:"
179 msgstr "There are 5 main steps in the process:"
180
181 #: C/gtk-doc-manual.xml:131(para)
182 msgid ""
183 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
184 "source files with the documentation for each function, macro, union etc. (In "
185 "the past information was entered in generated template files, which is not "
186 "recommended anymore)."
187 msgstr ""
188 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
189 "source files with the documentation for each function, macro, union etc. (In "
190 "the past information was entered in generated template files, which is not "
191 "recommended any more)."
192
193 #: C/gtk-doc-manual.xml:141(para)
194 msgid ""
195 "<guilabel>Gathering information about the code.</"
196 "guilabel><application>gtkdoc-scan</application> scans the header files of "
197 "the code looking for declarations of functions, macros, enums, structs, and "
198 "unions. It creates the file <filename>&lt;module&gt;-decl-list.txt</"
199 "filename> containg a list of the declarations, placing them into sections "
200 "according to which header file they are in. On the first run this file is "
201 "copied to <filename>&lt;module&gt;-sections.txt</filename> The author can "
202 "rearrange the sections, and the order of the declarations within them, to "
203 "produce the final desired order. The second file it generates is "
204 "<filename>&lt;module&gt;-decl.txt</filename>. This file contains the full "
205 "declarations found by the scanner. If for some reason one would like some "
206 "sybols to show up in the docs, where the full declaration cannot be found by "
207 "th scanner or the declaration should appear differently, one can place "
208 "enties similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> "
209 "into <filename>&lt;module&gt;-overrides.txt</filename>. <application>gtkdoc-"
210 "scanobj</application> can also be used to dynamically query a library about "
211 "any GtkObject subclasses it exports. It saves information about each "
212 "object's position in the class hierarchy and about any GTK Args and Signals "
213 "it provides."
214 msgstr ""
215 "<guilabel>Gathering information about the code.</"
216 "guilabel><application>gtkdoc-scan</application> scans the header files of "
217 "the code looking for declarations of functions, macros, enums, structs, and "
218 "unions. It creates the file <filename><replaceable>module</replaceable>-decl-list.txt</"
219 "filename> containg a list of the declarations, placing them into sections "
220 "according to which header file they are in. On the first run this file is "
221 "copied to <filename><replaceable>module</replaceable>-sections.txt</filename> The author can "
222 "rearrange the sections, and the order of the declarations within them, to "
223 "produce the final desired order. The second file it generates is "
224 "<filename><replaceable>module</replaceable>-decl.txt</filename>. This file contains the full "
225 "declarations found by the scanner. If for some reason one would like some "
226 "symbols to show up in the docs, where the full declaration cannot be found "
227 "by the scanner or the declaration should appear differently, one can place "
228 "enties similar to the ones in <filename><replaceable>module</replaceable>-decl.txt</filename> "
229 "into <filename><replaceable>module</replaceable>-overrides.txt</filename>. <application>gtkdoc-"
230 "scanobj</application> can also be used to dynamically query a library about "
231 "any GtkObject subclasses it exports. It saves information about each "
232 "object's position in the class hierarchy and about any GTK Args and Signals "
233 "it provides."
234
235 #: C/gtk-doc-manual.xml:166(para)
236 msgid ""
237 "<guilabel>Generating the \"template\" files.</guilabel><application>gtkdoc-"
238 "mktmpl</application> creates a number of files in the <filename class="
239 "\"directory\">tmpl/</filename> subdirectory, using the information gathered "
240 "in the first step. (Note that this can be run repeatedly. It will try to "
241 "ensure that no documentation is ever lost.)"
242 msgstr ""
243 "<guilabel>Generating the \"template\" files.</guilabel> <application>gtkdoc-"
244 "mktmpl</application> creates a number of files in the <filename class="
245 "\"directory\">tmpl/</filename> subdirectory, using the information gathered "
246 "in the first step. (Note that this can be run repeatedly. It will try to "
247 "ensure that no documentation is ever lost.)"
248
249 #: C/gtk-doc-manual.xml:175(para)
250 msgid ""
251 "Since gtk-doc 1.9 the templates can be avoided. We encourage people to keep "
252 "documentation in the code. <application>gtkdocize</application> supports now "
253 "a <command>--flavour no-tmpl</command> option that chooses a makefile that "
254 "skips tmpl usage totally. If you have never changed file in tmpl by hand, "
255 "please remove the dir once."
256 msgstr ""
257 "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to keep "
258 "documentation in the code. <application>gtkdocize</application> supports now "
259 "a <command>--flavour no-tmpl</command> option that chooses a makefile that "
260 "skips <filename class=\"directory\">tmpl</filename> usage totally. If you have "
261 "never changed file in <filename class=\"directory\">tmpl</filename> by hand, "
262 "please remove the directory at once."
263
264 #: C/gtk-doc-manual.xml:185(para)
265 msgid ""
266 "<guilabel>Generating the SGML/XML and HTML.</guilabel><application>gtkdoc-"
267 "mkdb</application> turns the template files into SGML or XML files in the "
268 "<filename class=\"directory\">sgml/</filename> or <filename class=\"directory"
269 "\">xml/</filename> subdirectory. If the source code contains documentation "
270 "on functions, using the special comment blocks, it gets merged in here. If "
271 "there are no tmpl files used it only reads takes docs from sources and "
272 "introspection data. <application>gtkdoc-mkhtml</application> turns the SGML "
273 "files into HTML files in the <filename class=\"directory\">html/</filename> "
274 "subdirectory. Files in <filename class=\"directory\">sgml/</filename> or "
275 "<filename class=\"directory\">xml/</filename> and <filename class=\"directory"
276 "\">html/</filename> directories are always overwritten. One should never "
277 "edit them directly."
278 msgstr ""
279 "<guilabel>Generating the SGML/XML and HTML.</guilabel> <application>gtkdoc-"
280 "mkdb</application> turns the template files into SGML or XML files in the "
281 "<filename class=\"directory\">sgml/</filename> or <filename class=\"directory"
282 "\">xml/</filename> subdirectory. If the source code contains documentation "
283 "on functions, using the special comment blocks, it gets merged in here. If "
284 "there are no <filename class=\"directory\">tmpl</filename> files used it only reads takes docs from sources and "
285 "introspection data. <application>gtkdoc-mkhtml</application> turns the SGML "
286 "files into HTML files in the <filename class=\"directory\">html/</filename> "
287 "subdirectory. Files in <filename class=\"directory\">sgml/</filename> or "
288 "<filename class=\"directory\">xml/</filename> and <filename class=\"directory"
289 "\">html/</filename> directories are always overwritten. One should never "
290 "edit them directly."
291
292 #: C/gtk-doc-manual.xml:205(para)
293 msgid ""
294 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
295 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
296 "run to fix up any cross-references between separate documents. For example, "
297 "the GTK+ documentation contains many cross-references to types documented in "
298 "the GLib manual. When creating the source tarball for distribution, "
299 "<application>gtkdoc-rebase</application> turns all external links into web-"
300 "links. When installing distributed (pregenerated) docs the same application "
301 "will try to turn links back to local links (where those docs are installed)."
302 msgstr ""
303 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
304 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
305 "run to fix up any cross-references between separate documents. For example, "
306 "the GTK+ documentation contains many cross-references to types documented in "
307 "the GLib manual. When creating the source tarball for distribution, "
308 "<application>gtkdoc-rebase</application> turns all external links into web-"
309 "links. When installing distributed (pre-generated) docs the same application "
310 "will try to turn links back to local links (where those docs are installed)."
311
312 #: C/gtk-doc-manual.xml:223(title)
313 msgid "Getting GTK-Doc"
314 msgstr "Getting GTK-Doc"
315
316 #: C/gtk-doc-manual.xml:226(title)
317 msgid "Requirements"
318 msgstr "Requirements"
319
320 #: C/gtk-doc-manual.xml:227(para)
321 msgid "<guilabel>Perl v5</guilabel> - the main scripts are in Perl."
322 msgstr "<guilabel>Perl v5</guilabel> — the main scripts are in Perl."
323
324 #: C/gtk-doc-manual.xml:230(para)
325 msgid ""
326 "<guilabel>DocBook DTD v3.0</guilabel> - This is the DocBook SGML DTD. <ulink "
327 "url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora.com/"
328 "davenport</ulink>"
329 msgstr ""
330 "<guilabel>DocBook DTD v3.0</guilabel> — This is the DocBook SGML DTD. <ulink "
331 "url=\"http://www.ora.com/davenport\" type=\"http\">http://www.ora.com/"
332 "davenport</ulink>"
333
334 #: C/gtk-doc-manual.xml:234(para)
335 msgid ""
336 "<guilabel>Jade v1.1</guilabel> - This is a DSSSL processor for converting "
337 "SGML to various formats. <ulink url=\"http://www.jclark.com/jade\" type="
338 "\"http\">http://www.jclark.com/jade</ulink>"
339 msgstr ""
340 "<guilabel>Jade v1.1</guilabel> — This is a DSSSL processor for converting "
341 "SGML to various formats. <ulink url=\"http://www.jclark.com/jade\" type="
342 "\"http\">http://www.jclark.com/jade</ulink>"
343
344 #: C/gtk-doc-manual.xml:238(para)
345 msgid ""
346 "<guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code to "
347 "convert DocBook to HTML (and a few other formats). It's used together with "
348 "jade. I've customized the DSSSL code slightly, in gtk-doc.dsl, to colour the "
349 "program code listings/declarations, and to support global cross-reference "
350 "indices in the generated HTML. <ulink url=\"http://nwalsh.com/docbook/dsssl"
351 "\" type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>"
352 msgstr ""
353 "<guilabel>Modular DocBook Stylesheets</guilabel> This is the DSSSL code to "
354 "convert DocBook to HTML (and a few other formats). It's used together with "
355 "jade. The DSSSL code has been customised slightly, in gtk-doc.dsl, to colour the "
356 "program code listings/declarations, and to support global cross-reference "
357 "indices in the generated HTML. <ulink url=\"http://nwalsh.com/docbook/dsssl"
358 "\" type=\"http\">http://nwalsh.com/docbook/dsssl</ulink>"
359
360 #: C/gtk-doc-manual.xml:247(para)
361 msgid ""
362 "<guilabel>docbook-to-man</guilabel> - if you want to create man pages from "
363 "the DocBook. I've customized the 'translation spec' slightly, to capitalise "
364 "section headings and add the 'GTK Library' title at the top of the pages and "
365 "the revision date at the bottom. There is a link to this on <ulink url="
366 "\"http://www.ora.com/davenport\" type=\"http\">http://www.ora.com/davenport</"
367 "ulink> NOTE: This does not work yet."
368 msgstr ""
369 "<guilabel>docbook-to-man</guilabel> — if you want to create man pages from "
370 "the DocBook. The 'translation spec' has been customised slightly, to capitalise "
371 "section headings and add the 'GTK Library' title at the top of the pages and "
372 "the revision date at the bottom. There is a link to this on <ulink url="
373 "\"http://www.ora.com/davenport\" type=\"http\">http://www.ora.com/davenport</"
374 "ulink> NOTE: This does not work yet."
375
376 #: C/gtk-doc-manual.xml:258(title)
377 msgid "Installation"
378 msgstr "Installation"
379
380 #: C/gtk-doc-manual.xml:259(para)
381 msgid ""
382 "There is no standard place where the DocBook Modular Stylesheets are "
383 "installed."
384 msgstr ""
385 "There is no standard place where the DocBook Modular Stylesheets are "
386 "installed."
387
388 #: C/gtk-doc-manual.xml:262(para)
389 msgid "gtk-doc's configure script searches these 3 directories automatically:"
390 msgstr "GTK-Doc's configure script searches these 3 directories automatically:"
391
392 #: C/gtk-doc-manual.xml:265(para)
393 msgid ""
394 "<filename> /usr/lib/sgml/stylesheets/nwalsh-modular </filename> (used by "
395 "RedHat)"
396 msgstr ""
397 "<filename>/usr/lib/sgml/stylesheets/nwalsh-modular</filename> (used by "
398 "Red Hat)"
399
400 #: C/gtk-doc-manual.xml:268(para)
401 msgid ""
402 "<filename> /usr/lib/dsssl/stylesheets/docbook </filename> (used by Debian)"
403 msgstr ""
404 "<filename>/usr/lib/dsssl/stylesheets/docbook</filename> (used by Debian)"
405
406 #: C/gtk-doc-manual.xml:271(para)
407 msgid "<filename> /usr/share/sgml/docbkdsl </filename> (used by SuSE)"
408 msgstr "<filename>/usr/share/sgml/docbkdsl</filename> (used by SuSE)"
409
410 #: C/gtk-doc-manual.xml:274(para)
411 msgid ""
412 "If you have the stylesheets installed somewhere else, you need to configure "
413 "gtk-doc using the option: <command> --with-dsssl-dir=&lt;"
414 "PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>"
415 msgstr ""
416 "If you have the stylesheets installed somewhere else, you need to configure "
417 "GTK-Doc using the option: <command> --with-dsssl-dir=&lt;"
418 "PATH_TO_TOPLEVEL_STYLESHEETS_DIR&gt; </command>"
419
420 #: C/gtk-doc-manual.xml:297(title)
421 msgid "About GTK-Doc"
422 msgstr "About GTK-Doc"
423
424 #: C/gtk-doc-manual.xml:299(para) C/gtk-doc-manual.xml:313(para)
425 msgid "(FIXME)"
426 msgstr "(FIXME)"
427
428 #: C/gtk-doc-manual.xml:303(para)
429 msgid ""
430 "(History, authors, web pages, license, future plans, comparison with other "
431 "similar systems.)"
432 msgstr ""
433 "(History, authors, web pages, licence, future plans, comparison with other "
434 "similar systems.)"
435
436 #: C/gtk-doc-manual.xml:311(title)
437 msgid "About this Manual"
438 msgstr "About this Manual"
439
440 #: C/gtk-doc-manual.xml:317(para)
441 msgid "(who it is meant for, where you can get it, license)"
442 msgstr "(who it is meant for, where you can get it, licence)"
443
444 #: C/gtk-doc-manual.xml:326(title)
445 msgid "Setting up your project"
446 msgstr "Setting up your project"
447
448 #: C/gtk-doc-manual.xml:328(para)
449 msgid ""
450 "The next sections describe what steps to perform to integrate GTK-Doc into "
451 "your project. Theses section assume we work on a project called 'meep'. This "
452 "project contains a library called 'libmeep' and an end-user app called "
453 "'meeper'."
454 msgstr ""
455 "The next sections describe what steps to perform to integrate GTK-Doc into "
456 "your project. Theses section assume we work on a project called 'meep'. This "
457 "project contains a library called 'libmeep' and an end-user app called "
458 "'meeper'."
459
460 #: C/gtk-doc-manual.xml:336(title)
461 msgid "Setting up a skeleton documentation"
462 msgstr "Setting up a skeleton documentation"
463
464 #: C/gtk-doc-manual.xml:338(para)
465 msgid ""
466 "Under your top-level project directory create folders called docs/reference "
467 "(this way you can also have docs/help for end-user documentation). It is "
468 "recommended to create another subdirectory with the name of the doc-package. "
469 "For packages with just one library this step is not necessary."
470 msgstr ""
471 "Under your top-level project directory create a folder called <filename class=\"directory\">docs/reference</filename> "
472 "(this way you can also have <filename class=\"directory\">docs/help</filename> for end-user documentation). It is "
473 "recommended to create another subdirectory with the name of the doc-package. "
474 "For packages with just one library this step is not necessary."
475
476 #: C/gtk-doc-manual.xml:347(title)
477 msgid "Example directory structure"
478 msgstr "Example directory structure"
479
480 #: C/gtk-doc-manual.xml:345(para)
481 msgid "This can then look as show below: <placeholder-1/>"
482 msgstr "This can then look as show below: <placeholder-1/>"
483
484 #: C/gtk-doc-manual.xml:365(title) C/gtk-doc-manual.xml:372(title)
485 msgid "Integration with autoconf"
486 msgstr "Integration with autoconf"
487
488 #: C/gtk-doc-manual.xml:367(para)
489 msgid ""
490 "Very easy! Just add one line to your <filename>configure.ac</filename> "
491 "script."
492 msgstr ""
493 "Very easy! Just add one line to your <filename>configure.ac</filename> "
494 "script."
495
496 #: C/gtk-doc-manual.xml:382(para)
497 msgid ""
498 "Besides checking for the required Gtk-Doc version, this adds two configure "
499 "switches:"
500 msgstr ""
501 "Besides checking for the required GTK-Doc version, this adds two configure "
502 "switches:"
503
504 #: C/gtk-doc-manual.xml:387(para)
505 msgid "--with-html-dir=PATH : path to installed docs"
506 msgstr "--with-html-dir=PATH : path to installed docs"
507
508 #: C/gtk-doc-manual.xml:388(para)
509 msgid "--enable-gtk-doc : use gtk-doc to build documentation"
510 msgstr "--enable-gtk-doc : use gtk-doc to build documentation"
511
512 #: C/gtk-doc-manual.xml:392(para)
513 msgid ""
514 "Gtk-Doc is disabled by default! Remember to pass the option <option>'--"
515 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
516 "Otherwise pregenerated documentation is installed (which makes sense for "
517 "users but not for developers)."
518 msgstr ""
519 "GTK-Doc is disabled by default! Remember to pass the option <option>--"
520 "enable-gtk-doc</option> to the next <filename>configure</filename> run. "
521 "Otherwise pre-generated documentation is installed (which makes sense for "
522 "users but not for developers)."
523
524 #: C/gtk-doc-manual.xml:400(para)
525 msgid ""
526 "Furthermore it is recommended that you have the following line inside you "
527 "<filename>configure.ac</filename> script. This allows <filename>gtkdocize</"
528 "filename> to automatically copy the macro definition for "
529 "<function>GTK_DOC_CHECK</function> to your project."
530 msgstr ""
531 "Furthermore it is recommended that you have the following line inside your "
532 "<filename>configure.ac</filename> script. This allows <filename>gtkdocize</"
533 "filename> to automatically copy the macro definition for "
534 "<function>GTK_DOC_CHECK</function> to your project."
535
536 #: C/gtk-doc-manual.xml:408(title)
537 msgid "Preparation for gtkdocize"
538 msgstr "Preparation for gtkdocize"
539
540 #: C/gtk-doc-manual.xml:419(title)
541 msgid "Integration with automake"
542 msgstr "Integration with automake"
543
544 #: C/gtk-doc-manual.xml:421(para)
545 msgid ""
546 "First copy the <filename>Makefile.am</filename> from the examples "
547 "subdirectory of the gtkdoc-sources to your project's API documentation "
548 "directory ( <filename class=\"directory\">./docs/reference/&lt;package&gt;</"
549 "filename>). If you have multiple doc-packages repeat this for each one."
550 msgstr ""
551 "First copy the <filename>Makefile.am</filename> from the <filename class=\"directory\">examples</filename> "
552 "subdirectory of the GTK-Doc sources to your project's API documentation "
553 "directory (<filename class=\"directory\">./docs/reference/<replaceable>package</replaceable></"
554 "filename>). If you have multiple doc-packages, repeat this for each one."
555
556 #: C/gtk-doc-manual.xml:428(para)
557 msgid ""
558 "The next step is to edit the setting inside the <filename>Makefile.am</"
559 "filename>. All the settings have a comment above that describes their "
560 "purpose. Most settings are extra flags passed to the respective tools. Every "
561 "tool has a variable of the form <option>&lt;TOOLNAME&gt;_OPTIONS</option>. "
562 "All the tools support <option>--help</option> to list the supported "
563 "parameters."
564 msgstr ""
565 "The next step is to edit the settings inside the <filename>Makefile.am</"
566 "filename>. All the settings have a comment above that describes their "
567 "purpose. Most settings are extra flags passed to the respective tools. Every "
568 "tool has a variable of the form <option><replaceable>TOOLNAME</replaceable>_OPTIONS</option>. "
569 "All the tools support <option>--help</option> to list the supported "
570 "parameters."
571
572 #. FIXME: explain options ?
573 #: C/gtk-doc-manual.xml:439(para)
574 msgid ""
575 "You may also want to enable gtk-doc for the distcheckmake target. Just add "
576 "then one-liner show in the next example to you top-level <filename>Makefile."
577 "am</filename>:"
578 msgstr ""
579 "You may also want to enable GTK-Doc for the <literal>distcheckmake</literal> target. Just add "
580 "the line shown in the next example to your top-level <filename>Makefile."
581 "am</filename>:"
582
583 #: C/gtk-doc-manual.xml:446(title)
584 msgid "Enable gtk-doc during make distcheck"
585 msgstr "Enable GTK-Doc during make distcheck"
586
587 #: C/gtk-doc-manual.xml:458(title)
588 msgid "Integration with autogen"
589 msgstr "Integration with autogen"
590
591 #: C/gtk-doc-manual.xml:460(para)
592 msgid ""
593 "Most projects will have an <filename>autogen.sh</filename> script to setup "
594 "the build infrastructure after a checkout from version control system (such "
595 "as cvs). Gtk-Doc comes with a tool called <filename>gtkdocize</filename> "
596 "which can be used in such a script. It should be run before autoheader, "
597 "automake or autoconf."
598 msgstr ""
599 "Most projects will have an <filename>autogen.sh</filename> script to set up "
600 "the build infrastructure after a checkout from version control system (such "
601 "as CVS). GTK-Doc comes with a tool called <filename>gtkdocize</filename> "
602 "which can be used in such a script. It should be run before autoheader, "
603 "automake or autoconf."
604
605 #: C/gtk-doc-manual.xml:469(title)
606 msgid "Running gtkdocize from autogen.sh"
607 msgstr "Running gtkdocize from autogen.sh"
608
609 #: C/gtk-doc-manual.xml:478(para)
610 msgid ""
611 "When running <filename>gtkdocize</filename> it copies <filename>gtk-doc."
612 "make</filename> to you project root (or any directory specified by the --"
613 "docdir option). If also check you configure script for the "
614 "<function>GTK_DOC_CHECK</function> invocation."
615 msgstr ""
616 "When running <filename>gtkdocize</filename> it copies <filename>gtk-doc."
617 "make</filename> to your project root (or any directory specified by the <option>--"
618 "docdir</option> option). It also checks your configure script for the "
619 "<function>GTK_DOC_CHECK</function> invocation."
620
621 #: C/gtk-doc-manual.xml:485(para)
622 msgid ""
623 "Historically gtk-doc was gerating template files where developers entered "
624 "the docs. this turned out to be not so good. Since a few version gtk-doc "
625 "could also get all the information from source comments. Since gtk-doc 1.9 "
626 "the templates can be avoided. We encourage people to keep documentation in "
627 "the code. <application>gtkdocize</application> supports now a --flavour=no-"
628 "tmpl option that chooses a makefile that skips tmpl usage totally. If you "
629 "have never changed file in tmpl by hand, please remove the dir once."
630 msgstr ""
631 "Historically GTK-Doc was generating template files where developers entered "
632 "the docs. this turned out to be not so good. Since a few versions ago, GTK-Doc "
633 "can also get all the information from source comments. Since GTK-Doc 1.9 "
634 "the templates can be avoided. We encourage people to keep documentation in "
635 "the code. <application>gtkdocize</application> now supports a <option>--flavour=no-"
636 "tmpl</option> option that chooses a makefile that skips <filename class=\"directory\">tmpl</filename> usage totally. If you "
637 "have never changed a file in <filename class=\"directory\">tmpl</filename> by hand, please remove the directory at once."
638
639 #: C/gtk-doc-manual.xml:497(title) C/gtk-doc-manual.xml:514(title)
640 msgid "Running the doc build"
641 msgstr "Running the doc build"
642
643 #: C/gtk-doc-manual.xml:499(para)
644 msgid ""
645 "After the previous steps it's time to run the build. First we need to rerun "
646 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
647 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
648 "<filename>configure</filename> with this option afterwards."
649 msgstr ""
650 "After the previous steps it is time to run the build. First we need to rerun "
651 "<filename>autogen.sh</filename>. If this script runs <filename>configure</filename> for you, then "
652 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
653 "<filename>configure</filename> with this option afterwards."
654
655 #: C/gtk-doc-manual.xml:506(para)
656 msgid ""
657 "The first make run generates several additional files in the doc-dirs. The "
658 "important ones are: <filename>&lt;package&gt;.types</filename>, "
659 "<filename>&lt;package&gt;-docs.sgml</filename>, <filename>&lt;package&gt;-"
660 "sections.txt</filename>."
661 msgstr ""
662 "The first make run generates several additional files in the doc-dirs. The "
663 "important ones are: <filename><replaceable>package</replaceable>.types</filename>, "
664 "<filename><replaceable>package</replaceable>-docs.sgml</filename> and <filename><replaceable>package</replaceable>-"
665 "sections.txt</filename>."
666
667 #: C/gtk-doc-manual.xml:523(para)
668 msgid ""
669 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
670 "index.html</filename>. Yes, it's a bit disappointing still. But hang-on, "
671 "during the next chapter we tell you how to fill the pages with life."
672 msgstr ""
673 "Now you can point your browser to <filename>docs/reference/<replaceable>package</replaceable>/"
674 "index.html</filename>. Yes, it's a bit disappointing still. But hang on; "
675 "during the next chapter we tell you how to fill the pages with life."
676
677 #: C/gtk-doc-manual.xml:531(title)
678 msgid "Integration with version control systems"
679 msgstr "Integration with version control systems"
680
681 #: C/gtk-doc-manual.xml:533(para)
682 msgid ""
683 "As a rule of the thumb, it's those files you edit, that should go under "
684 "version control. For typical projects it's these files: <filename>&lt;"
685 "package&gt;.types</filename><filename>&lt;package&gt;-docs.sgml</"
686 "filename><filename>&lt;package&gt;-sections.txt</filename><filename>Makefile."
687 "am</filename>"
688 msgstr ""
689 "As a rule of thumb, it is the files you edit that should go under version "
690 "control. For typical projects it's these files: <filename><replaceable>package</replaceable>."
691 "types</filename>, <filename><replaceable>package</replaceable>-docs.sgml</filename>, <filename><replaceable>"
692 "package</replaceable>-sections.txt</filename> and <filename>Makefile.am</filename>."
693
694 #: C/gtk-doc-manual.xml:546(title)
695 msgid "Documenting the code"
696 msgstr "Documenting the code"
697
698 #: C/gtk-doc-manual.xml:548(para)
699 msgid ""
700 "GTK-Doc uses source code comment with a special syntax for code "
701 "documentation. Further it retrieves information about your project structure "
702 "from other sources. During the next section you find all information about "
703 "the syntax of the comments."
704 msgstr ""
705 "GTK-Doc uses source code comment with a special syntax for code "
706 "documentation. Furthermore, it retrieves information about your project structure "
707 "from other sources. During the next section you will find all the information about "
708 "the syntax of the comments."
709
710 #: C/gtk-doc-manual.xml:556(title)
711 msgid "Documentation placement"
712 msgstr "Documentation placement"
713
714 #: C/gtk-doc-manual.xml:557(para)
715 msgid ""
716 "In the past most documentation had to be filled into files residing inside "
717 "the <filename>tmpl</filename> directory. This has the disadvantages that the "
718 "information is often not updated and also that the file tend to cause "
719 "conflicts with version control systems."
720 msgstr ""
721 "In the past most documentation had to be filled into files residing inside "
722 "the <filename class=\"directory\">tmpl</filename> directory. This has the disadvantages that the "
723 "information is often not updated and also that the file tend to cause "
724 "conflicts with version control systems."
725
726 #: C/gtk-doc-manual.xml:563(para)
727 msgid ""
728 "The avoid the aforementioned problems we suggest putting the documentation "
729 "inside the sources. This manual will only describe this way of documenting "
730 "code."
731 msgstr ""
732 "To avoid the aforementioned problems we suggest putting the documentation "
733 "inside the sources. This manual will only describe this way of documenting "
734 "code."
735
736 #: C/gtk-doc-manual.xml:573(title)
737 msgid "Documentation comments"
738 msgstr "Documentation comments"
739
740 #: C/gtk-doc-manual.xml:578(title)
741 msgid "Gtk-Doc comment block"
742 msgstr "GTK-Doc comment block"
743
744 #: C/gtk-doc-manual.xml:575(para)
745 msgid ""
746 "A multiline comment that starts with an additional '*' marks a documentation "
747 "block that will be processed by the Gtk-Doc tools. <placeholder-1/>"
748 msgstr ""
749 "A multiline comment that starts with an additional <literal>*</literal> marks a documentation "
750 "block that will be processed by the GTK-Doc tools. <placeholder-1/>"
751
752 #: C/gtk-doc-manual.xml:590(para)
753 msgid ""
754 "The 'identifier' is one line with the name of the item the comment is "
755 "related to. The syntax differs a little depending on the item. (TODO add "
756 "table showing identifiers)"
757 msgstr ""
758 "The 'identifier' is one line with the name of the item to which the comment is "
759 "related. The syntax differs a little depending on the item. (TODO add "
760 "table showing identifiers)"
761
762 #: C/gtk-doc-manual.xml:596(para)
763 msgid ""
764 "The 'documentation' block is also different for each symbol type. Symbol "
765 "types that get parameters such as functions or macros have the parameter "
766 "description first followed by a blank line (just a '*'). Afterwards follows "
767 "the detailed description. All lines (outside program- listings and CDATA "
768 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
769 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
770 "asterisk-blank-blank)."
771 msgstr ""
772 "The 'documentation' block is also different for each symbol type. Symbol "
773 "types that get parameters such as functions or macros have the parameter "
774 "description first followed by a blank line (just a <literal>*</literal>). Afterwards follows "
775 "the detailed description. All lines (outside program listings and CDATA "
776 "sections) just containing a <literal> *</literal> (blank-asterisk) are converted to paragraph "
777 "breaks. If you don't want a paragraph break, change that into <literal> * </literal> (blank-"
778 "asterisk-blank-blank)."
779
780 #: C/gtk-doc-manual.xml:613(para)
781 msgid "Use function() to refer to functions or macros which take arguments."
782 msgstr "Use <literal>function()</literal> to refer to functions or macros which take arguments."
783
784 #: C/gtk-doc-manual.xml:618(para)
785 msgid ""
786 "Use @param to refer to parameters. Also use this when referring to "
787 "parameters of other functions, related to the one being described."
788 msgstr ""
789 "Use <literal>@param</literal> to refer to parameters. Also use this when referring to "
790 "parameters of other functions, related to the one being described."
791
792 #: C/gtk-doc-manual.xml:624(para)
793 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
794 msgstr "Use <literal>%constant</literal> to refer to a constant, e.g. <literal>%G_TRAVERSE_LEAFS</literal>."
795
796 #: C/gtk-doc-manual.xml:629(para)
797 msgid ""
798 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
799 "macros which don't take arguments."
800 msgstr ""
801 "Use <literal>#symbol</literal> to refer to other types of symbol, e.g. structs and enums and "
802 "macros which don't take arguments."
803
804 #: C/gtk-doc-manual.xml:635(para)
805 msgid "Use #Object::signal to refer to a GObject signal"
806 msgstr "Use <literal>#Object::signal</literal> to refer to a GObject signal"
807
808 #: C/gtk-doc-manual.xml:640(para)
809 msgid "Use #Object:property to refer to a GObject property"
810 msgstr "Use <literal>#Object:property</literal> to refer to a GObject property"
811
812 #: C/gtk-doc-manual.xml:645(para)
813 msgid "Use #Struct.field to refer to a field inside a structure."
814 msgstr "Use <literal>#Struct.field</literal> to refer to a field inside a structure."
815
816 #: C/gtk-doc-manual.xml:607(para)
817 msgid ""
818 "One advantage of hyper-text over plain-text is the ability to have links in "
819 "the document. Writing the correct markup for a link can be tedious though. "
820 "Gtk-Doc comes to help by providing several useful abbreviations. "
821 "<placeholder-1/>"
822 msgstr ""
823 "One advantage of hyper-text over plain-text is the ability to have links in "
824 "the document. Writing the correct markup for a link can be tedious though. "
825 "GTK-Doc comes to help by providing several useful abbreviations. "
826 "<placeholder-1/>"
827
828 #: C/gtk-doc-manual.xml:653(para)
829 msgid ""
830 "If you need to use the special characters '()', '@', '%', or '#' in your "
831 "documentation without gtk-doc changing them you can use the XML entities "
832 "\"&amp;lpar;\", \"&amp;rpar;\", \"&amp;commat;\", \"&amp;percnt;\" and "
833 "\"&amp;num;\" respectively or escape them with a backslash '\\'."
834 msgstr ""
835 "If you need to use the special characters '()', '@', '%', or '#' in your "
836 "documentation without GTK-Doc changing them you can use the XML entities "
837 "\"&amp;lpar;\", \"&amp;rpar;\", \"&amp;commat;\", \"&amp;percnt;\" and "
838 "\"&amp;num;\" respectively or escape them with a backslash '\\'."
839
840 #: C/gtk-doc-manual.xml:662(para)
841 msgid ""
842 "DocBook can do more that just links. One can also have lists, tables and "
843 "examples. To enable the usage of SGML/XML tags inside doc-comments you need "
844 "to have <option>--sgml-mode</option> in the variable <symbol>MKDB_OPTIONS</"
845 "symbol> inside <filename>Makefile.am</filename>."
846 msgstr ""
847 "DocBook can do more that just links. One can also have lists, tables and "
848 "examples. To enable the usage of SGML/XML tags inside doc-comments you need "
849 "to have <option>--sgml-mode</option> in the variable <symbol>MKDB_OPTIONS</"
850 "symbol> inside <filename>Makefile.am</filename>."
851
852 #: C/gtk-doc-manual.xml:670(para)
853 msgid ""
854 "As already mentioned earlier Gtk-Doc is for documenting public API. Thus one "
855 "cannot write documentation for static symbols. Nevertheless it is good to "
856 "comment those symbols too. This helps other to understand you code. "
857 "Therefore we recommend to comment these using normal comments (without the "
858 "2nd '*' in the first line). If later the function needs to be made public, "
859 "all one needs to do is to add another '*' in the comment block and insert "
860 "the symbol name at the right place inside the sections file."
861 msgstr ""
862 "As already mentioned earlier, GTK-Doc is for documenting public API. Thus one "
863 "cannot write documentation for static symbols. Nevertheless it is good to "
864 "comment those symbols too; this helps other to understand your code. "
865 "Therefore we recommend to comment these using normal comments (without the "
866 "second <literal>*</literal> in the first line). If later the function needs to be made public, "
867 "all one needs to do is to add another <literal>*</literal> in the comment block and insert "
868 "the symbol name at the right place inside the sections file."
869
870 #: C/gtk-doc-manual.xml:684(title)
871 msgid "Documenting sections"
872 msgstr "Documenting sections"
873
874 #: C/gtk-doc-manual.xml:686(para)
875 msgid ""
876 "Each section of the documentation contains information about one class or "
877 "module. To introduce the component one can write a section block. The short "
878 "description is also used inside the table of contents."
879 msgstr ""
880 "Each section of the documentation contains information about one class or "
881 "module. To introduce the component one can write a section block. The short "
882 "description is also used inside the table of contents."
883
884 #: C/gtk-doc-manual.xml:693(title)
885 msgid "Section comment block"
886 msgstr "Section comment block"
887
888 #: C/gtk-doc-manual.xml:712(term)
889 msgid "@short_description"
890 msgstr "@short_description"
891
892 #: C/gtk-doc-manual.xml:714(para)
893 msgid ""
894 "A one line description of the section, that later will appear after the "
895 "links in the TOC and at the top of the section page."
896 msgstr ""
897 "A one line description of the section that later will appear after the links "
898 "in the TOC and at the top of the section page."
899
900 #: C/gtk-doc-manual.xml:721(term)
901 msgid "@see_also"
902 msgstr "@see_also"
903
904 #: C/gtk-doc-manual.xml:723(para)
905 msgid "A list of symbols that are related to this section.."
906 msgstr "A list of symbols that are related to this section."
907
908 #: C/gtk-doc-manual.xml:729(term)
909 msgid "@stability"
910 msgstr "@stability"
911
912 #: C/gtk-doc-manual.xml:736(para)
913 msgid ""
914 "Stable - The intention of a Stable interface is to enable arbitrary third "
915 "parties to develop applications to these interfaces, release them, and have "
916 "confidence that they will run on all minor releases of the product (after "
917 "the one in which the interface was introduced, and within the same major "
918 "release). Even at a major release, incompatible changes are expected to be "
919 "rare, and to have strong justifications."
920 msgstr ""
921 "Stable — The intention of a Stable interface is to enable arbitrary third "
922 "parties to develop applications to these interfaces, release them, and have "
923 "confidence that they will run on all minor releases of the product (after "
924 "the one in which the interface was introduced, and within the same major "
925 "release). Even at a major release, incompatible changes are expected to be "
926 "rare, and to have strong justifications."
927
928 #: C/gtk-doc-manual.xml:748(para)
929 msgid ""
930 "Unstable - Unstable interfaces are experimental or transitional. They are "
931 "typically used to give outside developers early access to new or rapidly "
932 "changing technology, or to provide an interim solution to a problem where a "
933 "more general solution is anticipated. No claims are made about either source "
934 "or binary compatibility from one minor release to the next."
935 msgstr ""
936 "Unstable — Unstable interfaces are experimental or transitional. They are "
937 "typically used to give outside developers early access to new or rapidly-"
938 "changing technology, or to provide an interim solution to a problem where a "
939 "more general solution is anticipated. No claims are made about either source "
940 "or binary compatibility from one minor release to the next."
941
942 #: C/gtk-doc-manual.xml:760(para)
943 msgid ""
944 "Private - An interface that can be used within the GNOME stack itself, but "
945 "that is not documented for end-users. Such functions should only be used in "
946 "specified and documented ways."
947 msgstr ""
948 "Private — An interface that can be used within the GNOME stack itself, but "
949 "that is not documented for end-users. Such functions should only be used in "
950 "specified and documented ways."
951
952 #: C/gtk-doc-manual.xml:769(para)
953 msgid ""
954 "Internal - An interface that is internal to a module and does not require "
955 "end-user documentation. Functions that are undocumented are assumed to be "
956 "Internal."
957 msgstr ""
958 "Internal — An interface that is internal to a module and does not require "
959 "end-user documentation. Functions that are undocumented are assumed to be "
960 "Internal."
961
962 #: C/gtk-doc-manual.xml:731(para)
963 msgid ""
964 "A informal description of the stability level this API has. We recommend the "
965 "use of one of these terms: <placeholder-1/>"
966 msgstr ""
967 "A informal description of the stability level this API has. We recommend the "
968 "use of one of these terms: <placeholder-1/>"
969
970 #: C/gtk-doc-manual.xml:781(term)
971 msgid "@include"
972 msgstr "@include"
973
974 #: C/gtk-doc-manual.xml:783(para)
975 msgid ""
976 "The <literal>#include</literal> files to show in the section synopsis (a "
977 "comma separated list), overriding the global value from the <link linkend="
978 "\"metafiles_sections\">section file</link> or command line. This item is "
979 "optional."
980 msgstr ""
981 "The <literal>#include</literal> files to show in the section synopsis (a "
982 "comma-separated list), overriding the global value from the <link linkend="
983 "\"metafiles_sections\">section file</link> or command line. This item is "
984 "optional."
985
986 #: C/gtk-doc-manual.xml:793(para)
987 msgid ""
988 "FIXME having @title here, would put this title into a newly generated "
989 "section file, but later would be obsolete (right?)"
990 msgstr ""
991 "FIXME having @title here, would put this title into a newly generated "
992 "section file, but later would be obsolete (right?)"
993
994 #: C/gtk-doc-manual.xml:800(para)
995 msgid ""
996 "To avoid unnecessary recompilation after doc-changes put the section docs "
997 "into the c-source where possible."
998 msgstr ""
999 "To avoid unnecessary recompilation after doc-changes put the section docs "
1000 "into the C source where possible."
1001
1002 #: C/gtk-doc-manual.xml:809(title)
1003 msgid "Documenting symbols"
1004 msgstr "Documenting symbols"
1005
1006 #: C/gtk-doc-manual.xml:811(para)
1007 msgid ""
1008 "Each symbol (function, macro, struct, enum, signal and property) is "
1009 "documented in a separate block. The block is best placed close to the "
1010 "definition of the symbols so that it is easy to keep them in sync. Thus "
1011 "function are usually documented in the c-source and macros, struct and enum "
1012 "in the header file."
1013 msgstr ""
1014 "Each symbol (function, macro, struct, enum, signal and property) is "
1015 "documented in a separate block. The block is best placed close to the "
1016 "definition of the symbols so that it is easy to keep them in synchronisation. Thus "
1017 "functions are usually documented in the C source and macros, structs and enums "
1018 "in the header files."
1019
1020 #: C/gtk-doc-manual.xml:820(title)
1021 msgid "Function comment block"
1022 msgstr "Function comment block"
1023
1024 #: C/gtk-doc-manual.xml:843(term)
1025 msgid "Returns:"
1026 msgstr "Returns:"
1027
1028 #: C/gtk-doc-manual.xml:845(para)
1029 msgid "Paragraph describing the returned result."
1030 msgstr "Paragraph describing the returned result."
1031
1032 #: C/gtk-doc-manual.xml:851(term)
1033 msgid "Deprecated:"
1034 msgstr "Deprecated:"
1035
1036 #: C/gtk-doc-manual.xml:853(para)
1037 msgid ""
1038 "Paragraph denoting that this function should no be used anymore. The "
1039 "description should point the reader to the new API."
1040 msgstr ""
1041 "Paragraph denoting that this function should no be used any more. The "
1042 "description should point the reader to the new API."
1043
1044 #: C/gtk-doc-manual.xml:860(term)
1045 msgid "Since:"
1046 msgstr "Since:"
1047
1048 #: C/gtk-doc-manual.xml:862(para)
1049 msgid "Description since which version of the code the API is available."
1050 msgstr "Description since which version of the code the API is available."
1051
1052 #: C/gtk-doc-manual.xml:869(para)
1053 msgid ""
1054 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
1055 "private. They are treated like static functions."
1056 msgstr ""
1057 "GTK-Doc assumes all symbols (macros, functions) starting with <literal>_</literal> are "
1058 "private. They are treated like static functions."
1059
1060 #: C/gtk-doc-manual.xml:874(para)
1061 msgid "(FIXME) (stability) (glib-enums, ...)"
1062 msgstr "(FIXME) (stability) (glib-enums, ...)"
1063
1064 #: C/gtk-doc-manual.xml:880(title)
1065 msgid "Property comment block"
1066 msgstr "Property comment block"
1067
1068 #: C/gtk-doc-manual.xml:892(title)
1069 msgid "Signal comment block"
1070 msgstr "Signal comment block"
1071
1072 #: C/gtk-doc-manual.xml:909(title)
1073 msgid "Struct comment block"
1074 msgstr "Struct comment block"
1075
1076 #: C/gtk-doc-manual.xml:928(title)
1077 msgid "Useful DocBook tags"
1078 msgstr "Useful DocBook tags"
1079
1080 #: C/gtk-doc-manual.xml:930(para)
1081 msgid ""
1082 "Here are some DocBook tags which are most useful when documenting the code."
1083 msgstr ""
1084 "Here are some DocBook tags which are most useful when documenting the code."
1085
1086 #: C/gtk-doc-manual.xml:935(para)
1087 msgid ""
1088 "To link to another section in the GTK docs: <placeholder-1/> The linkend is "
1089 "the SGML id on the top item of the page you want to link to. For most pages "
1090 "this is currently the part (\"gtk\", \"gdk\", glib\") and then the page "
1091 "title (\"Hash Tables\"). For widgets it is just the class name. Spaces and "
1092 "underscores are converted to '-' to conform to SGML."
1093 msgstr ""
1094 "To link to another section in the GTK docs: <placeholder-1/> The linkend is "
1095 "the SGML ID on the top item of the page to which you want to link. For most pages "
1096 "this is currently the part (\"gtk\", \"gdk\", glib\") and then the page "
1097 "title (\"Hash Tables\"). For widgets it is just the class name. Spaces and "
1098 "underscores are converted to <literal>-</literal> to conform to SGML."
1099
1100 #: C/gtk-doc-manual.xml:951(para)
1101 msgid ""
1102 "To refer to an external function, e.g. a standard C function: <placeholder-1/"
1103 ">"
1104 msgstr ""
1105 "To refer to an external function, e.g. a standard C function: <placeholder-1/"
1106 ">"
1107
1108 #: C/gtk-doc-manual.xml:962(para)
1109 msgid ""
1110 "To include example code: <placeholder-1/> or possibly this, for very short "
1111 "code fragments which don't need a title: <placeholder-2/> For the latter gtk-"
1112 "doc also supports an abbreviation: <![CDATA[\n"
1113 "|[\n"
1114 " ...\n"
1115 "]|\n"
1116 "]]>"
1117 msgstr ""
1118 "To include example code: <placeholder-1/> or possibly this, for very short "
1119 "code fragments which don't need a title: <placeholder-2/> For the latter, GTK-"
1120 "Doc also supports an abbreviation: <![CDATA[\n"
1121 "|[\n"
1122 " ...\n"
1123 "]|\n"
1124 "]]>"
1125
1126 #: C/gtk-doc-manual.xml:996(para)
1127 msgid "To include bulleted lists: <placeholder-1/>"
1128 msgstr "To include bulleted lists: <placeholder-1/>"
1129
1130 #: C/gtk-doc-manual.xml:1018(para)
1131 msgid "To include a note which stands out from the text: <placeholder-1/>"
1132 msgstr "To include a note which stands out from the text: <placeholder-1/>"
1133
1134 #: C/gtk-doc-manual.xml:1033(para)
1135 msgid "To refer to a type: <placeholder-1/>"
1136 msgstr "To refer to a type: <placeholder-1/>"
1137
1138 #: C/gtk-doc-manual.xml:1044(para)
1139 msgid ""
1140 "To refer to an external structure (not one described in the GTK docs): "
1141 "<placeholder-1/>"
1142 msgstr ""
1143 "To refer to an external structure (not one described in the GTK docs): "
1144 "<placeholder-1/>"
1145
1146 #: C/gtk-doc-manual.xml:1055(para)
1147 msgid "To refer to a field of a structure: <placeholder-1/>"
1148 msgstr "To refer to a field of a structure: <placeholder-1/>"
1149
1150 #: C/gtk-doc-manual.xml:1066(para)
1151 msgid ""
1152 "To refer to a class name, we could possibly use: <placeholder-1/> but you'll "
1153 "probably be using #GtkWidget instead (to automatically create a link to the "
1154 "GtkWidget page - see <link linkend=\"documenting_syntax\">the abbreviations</"
1155 "link>)."
1156 msgstr ""
1157 "To refer to a class name, we could possibly use: <placeholder-1/> but you'll "
1158 "probably be using <literal>#GtkWidget</literal> instead (to automatically create a link to the "
1159 "GtkWidget page — see <link linkend=\"documenting_syntax\">the abbreviations</"
1160 "link>)."
1161
1162 #: C/gtk-doc-manual.xml:1079(para)
1163 msgid "To emphasize text: <placeholder-1/>"
1164 msgstr "To emphasise text: <placeholder-1/>"
1165
1166 #: C/gtk-doc-manual.xml:1090(para)
1167 msgid "For filenames use: <placeholder-1/>"
1168 msgstr "For filenames use: <placeholder-1/>"
1169
1170 #: C/gtk-doc-manual.xml:1105(title)
1171 msgid "Filling the extra files"
1172 msgstr "Filling the extra files"
1173
1174 #: C/gtk-doc-manual.xml:1107(para)
1175 msgid ""
1176 "There are a couple of extra file, that need to be maintained along with the "
1177 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
1178 "<filename>&lt;package&gt;-docs.sgml</filename>, <filename>&lt;package&gt;-"
1179 "sections.txt</filename>."
1180 msgstr ""
1181 "There are a couple of extra files that need to be maintained along with the "
1182 "inline source code comments: <filename><replaceable>package</replaceable>.types</filename>, "
1183 "<filename><replaceable>package</replaceable>-docs.sgml</filename> and <filename><replaceable>package</replaceable>-"
1184 "sections.txt</filename>."
1185
1186 #: C/gtk-doc-manual.xml:1116(title)
1187 msgid "Editing the types file"
1188 msgstr "Editing the types file"
1189
1190 #: C/gtk-doc-manual.xml:1118(para)
1191 msgid ""
1192 "If your library or application includes GtkObjects/GObjects, you want their "
1193 "signals, arguments/parameters and position in the hierarchy to be shown in "
1194 "the documentation. All you need to do, is to list the "
1195 "<function>xxx_get_type</function> functions together with their include "
1196 "inside the <filename>&lt;package&gt;.types</filename> file."
1197 msgstr ""
1198 "If your library or application includes GtkObjects/GObjects, you want their "
1199 "signals, arguments/parameters and position in the hierarchy to be shown in "
1200 "the documentation. All you need to do is to list the "
1201 "<function>xxx_get_type</function> functions together with their include "
1202 "inside the <filename><replaceable>package</replaceable>.types</filename> file."
1203
1204 #: C/gtk-doc-manual.xml:1127(title)
1205 msgid "Example types file snippet"
1206 msgstr "Example types file snippet"
1207
1208 #: C/gtk-doc-manual.xml:1141(para)
1209 msgid ""
1210 "Since gtk-doc 1.8 <application>gtkdoc-scan</application> can generate this "
1211 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
1212 "<filename>Makefile.am</filename>. If you use this approach you should not "
1213 "dist the types file nor have it under version control."
1214 msgstr ""
1215 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
1216 "list for you. Just add <option>--rebuild-types</option> to <symbol>SCAN_OPTIONS</symbol> in "
1217 "<filename>Makefile.am</filename>. If you use this approach you should not "
1218 "distribute the types file, nor have it under version control."
1219
1220 #: C/gtk-doc-manual.xml:1150(title)
1221 msgid "Editing the master document"
1222 msgstr "Editing the master document"
1223
1224 #: C/gtk-doc-manual.xml:1152(para)
1225 msgid ""
1226 "Gtk-Doc produces documentation in DocBook SGML/XML. When processing the "
1227 "inline source comments, the Gtk-Doc tools generate one documentation page "
1228 "per class or module as a separate file. The master document includes them "
1229 "and place them in a order."
1230 msgstr ""
1231 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
1232 "inline source comments, the GTK-Doc tools generate one documentation page "
1233 "per class or module as a separate file. The master document includes them "
1234 "and place them in a order."
1235
1236 #: C/gtk-doc-manual.xml:1159(para)
1237 msgid ""
1238 "While Gtk-Doc creates a template master document for you, later run will not "
1239 "touch it again. This means that one can freely structure the documentation. "
1240 "That includes grouping pages and adding extra pages. Gtk-doc has now a test "
1241 "suite, where also the master-document is recreated from scratch. Its a good "
1242 "idea to look at this from time to time to see if there are some new goodies "
1243 "introduced there."
1244 msgstr ""
1245 "While GTK-Doc creates a template master document for you, later runs will not "
1246 "touch it again. This means that one can freely structure the documentation. "
1247 "That includes grouping pages and adding extra pages. GTK-doc has now a test "
1248 "suite, where the master-document is also recreated from scratch. It is a good "
1249 "idea to look at this from time to time to see if there are some new goodies "
1250 "introduced there."
1251
1252 #: C/gtk-doc-manual.xml:1169(para)
1253 msgid ""
1254 "Do not create tutorials as extra documents. Just write extra chapters. The "
1255 "benefit of directly embedding the tutorial for your library into the API "
1256 "documentation is that it is easy to link for the tutorial to symbol "
1257 "documentation. Apart chances are higher that the tutorial gets updates along "
1258 "with the library."
1259 msgstr ""
1260 "Do not create tutorials as extra documents. Just write extra chapters. The "
1261 "benefit of directly embedding the tutorial for your library into the API "
1262 "documentation is that it is easy to link for the tutorial to symbol "
1263 "documentation. Also, chances are higher that the tutorial gets updates along "
1264 "with the library."
1265
1266 #: C/gtk-doc-manual.xml:1178(para)
1267 msgid ""
1268 "So what are the things to change inside the master document? For a start is "
1269 "only a little. There are some placeholders (text in square brackets) there "
1270 "which you should take care of."
1271 msgstr ""
1272 "So what are the things to change inside the master document? "
1273 "There are some placeholders (text in square brackets) there "
1274 "which you should take care of."
1275
1276 #: C/gtk-doc-manual.xml:1185(title)
1277 msgid "Master document header"
1278 msgstr "Master document header"
1279
1280 #: C/gtk-doc-manual.xml:1207(title)
1281 msgid "Editing the section file"
1282 msgstr "Editing the section file"
1283
1284 #: C/gtk-doc-manual.xml:1209(para)
1285 msgid ""
1286 "The section file is used to organise the documentation output by Gtk-Doc. "
1287 "Here one specifies which symbol belongs to which module or class and control "
1288 "the visibility (public or private)."
1289 msgstr ""
1290 "The section file is used to organise the documentation output by GTK-Doc. "
1291 "Here one specifies which symbol belongs to which module or class and control "
1292 "the visibility (public or private)."
1293
1294 #: C/gtk-doc-manual.xml:1215(para)
1295 msgid ""
1296 "The section file is a plain test file with xml like syntax (using tags). "
1297 "Blank lines are ignored and lines starting with a '#' are treated as comment "
1298 "lines."
1299 msgstr ""
1300 "The section file is a plain test file with XML-like syntax (using tags). "
1301 "Blank lines are ignored and lines starting with a <literal>#</literal> are treated as comment "
1302 "lines."
1303
1304 #: C/gtk-doc-manual.xml:1221(para)
1305 msgid ""
1306 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
1307 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
1308 "FILE&gt;' will result in the section declarations being output in the "
1309 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
1310 "converted into the DocBook SGML file <filename>sgml/gnome-config.sgml</"
1311 "filename> or .DocBook XML file <filename>xml/gnome-config.xml</filename>. "
1312 "(The name of the html file is based on the module name and the section "
1313 "title, or for gobjects it is based on the gobjects class name converted to "
1314 "lower case)."
1315 msgstr ""
1316 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the filename, "
1317 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
1318 "FILE&gt;' will result in the section declarations being output in the "
1319 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
1320 "converted into the DocBook SGML file <filename>sgml/gnome-config.sgml</"
1321 "filename> or DocBook XML file <filename>xml/gnome-config.xml</filename>. "
1322 "(The name of the HTML file is based on the module name and the section "
1323 "title, or for GObjects it is based on the GObject's class name converted to "
1324 "lowercase)."
1325
1326 #: C/gtk-doc-manual.xml:1233(para)
1327 msgid ""
1328 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
1329 "section. It is only useful before the templates are initially created, since "
1330 "the title set in the template file overrides this."
1331 msgstr ""
1332 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
1333 "section. It is only useful before the templates are initially created, since "
1334 "the title set in the template file overrides this."
1335
1336 #: C/gtk-doc-manual.xml:1239(para)
1337 msgid ""
1338 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
1339 "Currently it outputs a blank line between subsections in the synopsis "
1340 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
1341 "declarations (e.g. the functions like g_object_get_type and macros like "
1342 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
1343 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
1344 "declarations which will not be output (It is a handy way to avoid warning "
1345 "messages about unused declarations.). If your library contains private types "
1346 "which you don't want to appear in the object hierarchy and the list of "
1347 "implemented or required interfaces, add them to a Private subsection."
1348 msgstr ""
1349 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
1350 "Currently it outputs a blank line between subsections in the synopsis "
1351 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
1352 "declarations (e.g. the functions like <function>g_object_get_type</function> and macros like "
1353 "<symbol>G_OBJECT()</symbol>, <symbol>G_IS_OBJECT()</symbol> etc.). Currently these are left out of the "
1354 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
1355 "declarations which will not be output (it is a handy way to avoid warning "
1356 "messages about unused declarations). If your library contains private types "
1357 "which you don't want to appear in the object hierarchy and the list of "
1358 "implemented or required interfaces, add them to a Private subsection."
1359
1360 #: C/gtk-doc-manual.xml:1255(para)
1361 msgid ""
1362 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
1363 "#include files which are shown in the synopsis sections. It contains a comma-"
1364 "separate list of #include files, without the angle brackets. If you set it "
1365 "outside of any sections, it acts for all sections until the end of the file. "
1366 "If you set it within a section, it only applies to that section."
1367 msgstr ""
1368 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
1369 "<literal>#include</literal> files which are shown in the synopsis sections. It contains a comma-"
1370 "separated list of <literal>#include</literal> files, without the angle brackets. If you set it "
1371 "outside of any sections, it acts for all sections until the end of the file. "
1372 "If you set it within a section, it only applies to that section."
1373
1374 #: C/gtk-doc-manual.xml:1269(title)
1375 msgid "Controlling the result"
1376 msgstr "Controlling the result"
1377
1378 #: C/gtk-doc-manual.xml:1271(para)
1379 msgid ""
1380 "A Gtk-Doc run generates report files inside the documentation directory. The "
1381 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
1382 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
1383 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
1384 "files that can be viewed and postprocessed easily."
1385 msgstr ""
1386 "A GTK-Doc run generates report files inside the documentation directory. The "
1387 "generated files are named: <filename><replaceable>package</replaceable>-undocumented.txt</"
1388 "filename>, <filename><replaceable>package</replaceable>-undeclared.txt</filename> and "
1389 "<filename><replaceable>package</replaceable>-unused.txt</filename>. All those are plain text "
1390 "files that can be viewed and postprocessed easily."
1391
1392 #: C/gtk-doc-manual.xml:1280(para)
1393 msgid ""
1394 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
1395 "the documentation coverage summary. Below are two sections divided by blank "
1396 "lines. The first section lists undocumented or incomplete symbols. The "
1397 "second section does the same for section docs. Incomplete entries are those, "
1398 "which have documentation, but where e.g. a new parameter has been added."
1399 msgstr ""
1400 "The <filename><replaceable>package</replaceable>-undocumented.txt</filename> file starts with "
1401 "the documentation coverage summary. Below are two sections divided by blank "
1402 "lines. The first section lists undocumented or incomplete symbols. The "
1403 "second section does the same for section docs. Incomplete entries are those, "
1404 "which have documentation, but where e.g. a new parameter has been added."
1405
1406 #: C/gtk-doc-manual.xml:1289(para)
1407 msgid ""
1408 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
1409 "given in the <filename>&lt;package&gt;-section.txt</filename> but not found "
1410 "in the sources. Check if they have been removed or if they are misspelled."
1411 msgstr ""
1412 "The <filename><replaceable>package</replaceable>-undeclared.txt</filename> file lists symbols "
1413 "given in the <filename><replaceable>package</replaceable>-section.txt</filename> but not found "
1414 "in the sources. Check if they have been removed or if they are misspelled."
1415
1416 #: C/gtk-doc-manual.xml:1296(para)
1417 msgid ""
1418 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
1419 "where the Gtk-Doc scanner has found documentation, but does not know where "
1420 "to put it. This means that the symbol has not yet been added to the "
1421 "<filename>&lt;package&gt;-section.txt</filename> file."
1422 msgstr ""
1423 "The <filename><replaceable>package</replaceable>-unused.txt</filename> file lists symbol names "
1424 "where the GTK-Doc scanner has found documentation, but does not know where "
1425 "to put it. This means that the symbol has not yet been added to the "
1426 "<filename><replaceable>package</replaceable>-section.txt</filename> file."
1427
1428 #: C/gtk-doc-manual.xml:1304(para)
1429 msgid ""
1430 "Enable or add the <option>TESTS=($GTKDOC_CHECK)</option> line in Makefile."
1431 "am. If at least gtk-doc 1.9 is installed, this will run sanity checks during "
1432 "make check run."
1433 msgstr ""
1434 "Enable or add the <option>TESTS=($GTKDOC_CHECK)</option> line in Makefile."
1435 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
1436 "<command>make check</command> run."
1437
1438 #: C/gtk-doc-manual.xml:1314(title)
1439 msgid "Frequently asked question"
1440 msgstr "Frequently asked questions"
1441
1442 #: C/gtk-doc-manual.xml:1318(segtitle)
1443 msgid "Question"
1444 msgstr "Question"
1445
1446 #: C/gtk-doc-manual.xml:1319(segtitle)
1447 msgid "Answer"
1448 msgstr "Answer"
1449
1450 #: C/gtk-doc-manual.xml:1321(seg)
1451 msgid "No class hierarchy."
1452 msgstr "No class hierarchy."
1453
1454 #: C/gtk-doc-manual.xml:1322(filename)
1455 msgid ".types"
1456 msgstr ".types"
1457
1458 #: C/gtk-doc-manual.xml:1322(seg)
1459 msgid ""
1460 "The objects _get_type() function has not been entered into the <placeholder-"
1461 "1/> file."
1462 msgstr ""
1463 "The object's <function>_get_type()</function> function has not been entered into the <placeholder-"
1464 "1/> file."
1465
1466 #: C/gtk-doc-manual.xml:1325(seg)
1467 msgid "Still no class hierarchy."
1468 msgstr "Still no class hierarchy."
1469
1470 #: C/gtk-doc-manual.xml:1326(ulink)
1471 msgid "explanation"
1472 msgstr "explanation"
1473
1474 #: C/gtk-doc-manual.xml:1326(seg)
1475 msgid "Wrong naming in section file (see <placeholder-1/>)"
1476 msgstr "Wrong naming in section file (see <placeholder-1/>)"
1477
1478 #: C/gtk-doc-manual.xml:1329(seg)
1479 msgid "Damn, I have still no class hierarchy."
1480 msgstr "Damn, I still have no class hierarchy."
1481
1482 #: C/gtk-doc-manual.xml:1330(seg)
1483 msgid ""
1484 "Is the object name (name of the instance struct) part of the normal section "
1485 "(don't put this into Standard or Private)."
1486 msgstr ""
1487 "Is the object name (name of the instance struct) part of the normal section "
1488 "(don't put this into Standard or Private)?"
1489
1490 #: C/gtk-doc-manual.xml:1333(seg)
1491 msgid "No symbol index."
1492 msgstr "No symbol index."
1493
1494 #: C/gtk-doc-manual.xml:1334(seg)
1495 msgid "FIXME (&lt;index&gt; tag in main sgml file)"
1496 msgstr "FIXME (&lt;index&gt; tag in main sgml file)"
1497
1498 #: C/gtk-doc-manual.xml:1337(seg)
1499 msgid "Symbols are not linked to their doc-section."
1500 msgstr "Symbols are not linked to their doc-section."
1501
1502 #: C/gtk-doc-manual.xml:1338(seg)
1503 msgid "FIXME (added #,% or () ?)"
1504 msgstr "FIXME (added #,% or () ?)"
1505
1506 #: C/gtk-doc-manual.xml:1341(seg)
1507 msgid "A new class does not appear in the docs."
1508 msgstr "A new class does not appear in the docs."
1509
1510 #: C/gtk-doc-manual.xml:1342(seg)
1511 msgid "FIXME (section file, types file, main-sgml file)"
1512 msgstr "FIXME (section file, types file, main-sgml file)"
1513
1514 #: C/gtk-doc-manual.xml:1345(seg)
1515 msgid "A new symbol does not appear in the docs."
1516 msgstr "A new symbol does not appear in the docs."
1517
1518 #: C/gtk-doc-manual.xml:1346(seg)
1519 msgid "FIXME (section file, proper doc comment)"
1520 msgstr "FIXME (section file, proper doc comment)"
1521
1522 #: C/gtk-doc-manual.xml:1351(seg)
1523 msgid "Parameter described in source code comment block but does not exist"
1524 msgstr "Parameter described in source code comment block but does not exist"
1525
1526 #: C/gtk-doc-manual.xml:1352(seg)
1527 msgid ""
1528 "Check if the prototype in the header has different parameter names as in the "
1529 "source."
1530 msgstr ""
1531 "Check if the prototype in the header has different parameter names to the "
1532 "source."
1533
1534 #: C/gtk-doc-manual.xml:1356(seg)
1535 msgid "multiple \"IDs\" for constraint linkend: XYZ"
1536 msgstr "multiple \"IDs\" for constraint linkend: XYZ"
1537
1538 #: C/gtk-doc-manual.xml:1357(seg)
1539 msgid "Symbol XYZ appears twice in -section.txt file."
1540 msgstr "Symbol XYZ appears twice in the -section.txt file."
1541
1542 #: C/gtk-doc-manual.xml:1360(seg)
1543 msgid ""
1544 "Element typename in namespace '' encountered in para, but no template "
1545 "matches."
1546 msgstr ""
1547 "Element typename in namespace '' encountered in para, but no template "
1548 "matches."
1549
1550 #: C/gtk-doc-manual.xml:12(releaseinfo)
1551 msgid "Version 1.1, March 2000"
1552 msgstr "Version 1.1, March 2000"
1553
1554 #: C/gtk-doc-manual.xml:16(year)
1555 msgid "2000"
1556 msgstr "2000"
1557
1558 #: C/gtk-doc-manual.xml:16(holder)
1559 msgid "Free Software Foundation, Inc."
1560 msgstr "Free Software Foundation, Inc."
1561
1562 #: C/gtk-doc-manual.xml:19(para)
1563 msgid ""
1564 "<address>Free Software Foundation, Inc. <street>51 Franklin Street, Suite "
1565 "330</street>, <city>Boston</city>, <state>MA</state><postcode>02110-1301</"
1566 "postcode><country>USA</country></address> Everyone is permitted to copy and "
1567 "distribute verbatim copies of this license document, but changing it is not "
1568 "allowed."
1569 msgstr ""
1570 "<address>Free Software Foundation, Inc. <street>51 Franklin Street, Suite "
1571 "330</street>, <city>Boston</city>, <state>MA</state><postcode>02110-1301</"
1572 "postcode><country>USA</country></address> Everyone is permitted to copy and "
1573 "distribute verbatim copies of this licence document, but changing it is not "
1574 "allowed."
1575
1576 #: C/gtk-doc-manual.xml:28(title)
1577 msgid "GNU Free Documentation License"
1578 msgstr "GNU Free Documentation Licence"
1579
1580 #: C/gtk-doc-manual.xml:31(title)
1581 msgid "0. PREAMBLE"
1582 msgstr "0. PREAMBLE"
1583
1584 #: C/gtk-doc-manual.xml:32(para)
1585 msgid ""
1586 "The purpose of this License is to make a manual, textbook, or other written "
1587 "document <quote>free</quote> in the sense of freedom: to assure everyone the "
1588 "effective freedom to copy and redistribute it, with or without modifying it, "
1589 "either commercially or noncommercially. Secondarily, this License preserves "
1590 "for the author and publisher a way to get credit for their work, while not "
1591 "being considered responsible for modifications made by others."
1592 msgstr ""
1593 "The purpose of this Licence is to make a manual, textbook, or other written "
1594 "document <quote>free</quote> in the sense of freedom: to assure everyone the "
1595 "effective freedom to copy and redistribute it, with or without modifying it, "
1596 "either commercially or noncommercially. Secondarily, this Licence preserves "
1597 "for the author and publisher a way to get credit for their work, while not "
1598 "being considered responsible for modifications made by others."
1599
1600 #: C/gtk-doc-manual.xml:43(para)
1601 msgid ""
1602 "This License is a kind of <quote>copyleft</quote>, which means that "
1603 "derivative works of the document must themselves be free in the same sense. "
1604 "It complements the GNU General Public License, which is a copyleft license "
1605 "designed for free software."
1606 msgstr ""
1607 "This Licence is a kind of <quote>copyleft</quote>, which means that "
1608 "derivative works of the document must themselves be free in the same sense. "
1609 "It complements the GNU General Public Licence, which is a copyleft licence "
1610 "designed for free software."
1611
1612 #: C/gtk-doc-manual.xml:50(para)
1613 msgid ""
1614 "We have designed this License in order to use it for manuals for free "
1615 "software, because free software needs free documentation: a free program "
1616 "should come with manuals providing the same freedoms that the software does. "
1617 "But this License is not limited to software manuals; it can be used for any "
1618 "textual work, regardless of subject matter or whether it is published as a "
1619 "printed book. We recommend this License principally for works whose purpose "
1620 "is instruction or reference."
1621 msgstr ""
1622 "We have designed this Licence in order to use it for manuals for free "
1623 "software, because free software needs free documentation: a free program "
1624 "should come with manuals providing the same freedoms that the software does. "
1625 "But this Licence is not limited to software manuals; it can be used for any "
1626 "textual work, regardless of subject matter or whether it is published as a "
1627 "printed book. We recommend this Licence principally for works whose purpose "
1628 "is instruction or reference."
1629
1630 #: C/gtk-doc-manual.xml:62(title)
1631 msgid "1. APPLICABILITY AND DEFINITIONS"
1632 msgstr "1. APPLICABILITY AND DEFINITIONS"
1633
1634 #: C/gtk-doc-manual.xml:63(para)
1635 msgid ""
1636 "This License applies to any manual or other work that contains a notice "
1637 "placed by the copyright holder saying it can be distributed under the terms "
1638 "of this License. The <quote>Document</quote>, below, refers to any such "
1639 "manual or work. Any member of the public is a licensee, and is addressed as "
1640 "<quote>you</quote>."
1641 msgstr ""
1642 "This Licence applies to any manual or other work that contains a notice "
1643 "placed by the copyright holder saying it can be distributed under the terms "
1644 "of this Licence. The <quote>Document</quote>, below, refers to any such "
1645 "manual or work. Any member of the public is a licencee, and is addressed as "
1646 "<quote>you</quote>."
1647
1648 #: C/gtk-doc-manual.xml:72(para)
1649 msgid ""
1650 "A <quote>Modified Version</quote> of the Document means any work containing "
1651 "the Document or a portion of it, either copied verbatim, or with "
1652 "modifications and/or translated into another language."
1653 msgstr ""
1654 "A <quote>Modified Version</quote> of the Document means any work containing "
1655 "the Document or a portion of it, either copied verbatim, or with "
1656 "modifications and/or translated into another language."
1657
1658 #: C/gtk-doc-manual.xml:79(para)
1659 msgid ""
1660 "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
1661 "section of the <link linkend=\"fdl-document\">Document</link> that deals "
1662 "exclusively with the relationship of the publishers or authors of the "
1663 "Document to the Document's overall subject (or to related matters) and "
1664 "contains nothing that could fall directly within that overall subject. (For "
1665 "example, if the Document is in part a textbook of mathematics, a Secondary "
1666 "Section may not explain any mathematics.) The relationship could be a matter "
1667 "of historical connection with the subject or with related matters, or of "
1668 "legal, commercial, philosophical, ethical or political position regarding "
1669 "them."
1670 msgstr ""
1671 "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
1672 "section of the <link linkend=\"fdl-document\">Document</link> that deals "
1673 "exclusively with the relationship of the publishers or authors of the "
1674 "Document to the Document's overall subject (or to related matters) and "
1675 "contains nothing that could fall directly within that overall subject. (For "
1676 "example, if the Document is in part a textbook of mathematics, a Secondary "
1677 "Section may not explain any mathematics.) The relationship could be a matter "
1678 "of historical connection with the subject or with related matters, or of "
1679 "legal, commercial, philosophical, ethical or political position regarding "
1680 "them."
1681
1682 #: C/gtk-doc-manual.xml:94(para)
1683 msgid ""
1684 "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
1685 "secondary\"> Secondary Sections</link> whose titles are designated, as being "
1686 "those of Invariant Sections, in the notice that says that the <link linkend="
1687 "\"fdl-document\">Document</link> is released under this License."
1688 msgstr ""
1689 "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
1690 "secondary\"> Secondary Sections</link> whose titles are designated, as being "
1691 "those of Invariant Sections, in the notice that says that the <link linkend="
1692 "\"fdl-document\">Document</link> is released under this Licence."
1693
1694 #: C/gtk-doc-manual.xml:103(para)
1695 msgid ""
1696 "The <quote>Cover Texts</quote> are certain short passages of text that are "
1697 "listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says "
1698 "that the <link linkend=\"fdl-document\">Document</link> is released under "
1699 "this License."
1700 msgstr ""
1701 "The <quote>Cover Texts</quote> are certain short passages of text that are "
1702 "listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says "
1703 "that the <link linkend=\"fdl-document\">Document</link> is released under "
1704 "this Licence."
1705
1706 #: C/gtk-doc-manual.xml:111(para)
1707 msgid ""
1708 "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
1709 "Document</link> means a machine-readable copy, represented in a format whose "
1710 "specification is available to the general public, whose contents can be "
1711 "viewed and edited directly and straightforwardly with generic text editors "
1712 "or (for images composed of pixels) generic paint programs or (for drawings) "
1713 "some widely available drawing editor, and that is suitable for input to text "
1714 "formatters or for automatic translation to a variety of formats suitable for "
1715 "input to text formatters. A copy made in an otherwise Transparent file "
1716 "format whose markup has been designed to thwart or discourage subsequent "
1717 "modification by readers is not Transparent. A copy that is not "
1718 "<quote>Transparent</quote> is called <quote>Opaque</quote>."
1719 msgstr ""
1720 "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
1721 "Document</link> means a machine-readable copy, represented in a format whose "
1722 "specification is available to the general public, whose contents can be "
1723 "viewed and edited directly and straightforwardly with generic text editors "
1724 "or (for images composed of pixels) generic paint programs or (for drawings) "
1725 "some widely available drawing editor, and that is suitable for input to text "
1726 "formatters or for automatic translation to a variety of formats suitable for "
1727 "input to text formatters. A copy made in an otherwise Transparent file "
1728 "format whose markup has been designed to thwart or discourage subsequent "
1729 "modification by readers is not Transparent. A copy that is not "
1730 "<quote>Transparent</quote> is called <quote>Opaque</quote>."
1731
1732 #: C/gtk-doc-manual.xml:128(para)
1733 msgid ""
1734 "Examples of suitable formats for Transparent copies include plain ASCII "
1735 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
1736 "a publicly available DTD, and standard-conforming simple HTML designed for "
1737 "human modification. Opaque formats include PostScript, PDF, proprietary "
1738 "formats that can be read and edited only by proprietary word processors, "
1739 "SGML or XML for which the DTD and/or processing tools are not generally "
1740 "available, and the machine-generated HTML produced by some word processors "
1741 "for output purposes only."
1742 msgstr ""
1743 "Examples of suitable formats for Transparent copies include plain ASCII "
1744 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
1745 "a publicly available DTD, and standard-conforming simple HTML designed for "
1746 "human modification. Opaque formats include PostScript, PDF, proprietary "
1747 "formats that can be read and edited only by proprietary word processors, "
1748 "SGML or XML for which the DTD and/or processing tools are not generally "
1749 "available, and the machine-generated HTML produced by some word processors "
1750 "for output purposes only."
1751
1752 #: C/gtk-doc-manual.xml:141(para)
1753 msgid ""
1754 "The <quote>Title Page</quote> means, for a printed book, the title page "
1755 "itself, plus such following pages as are needed to hold, legibly, the "
1756 "material this License requires to appear in the title page. For works in "
1757 "formats which do not have any title page as such, <quote>Title Page</quote> "
1758 "means the text near the most prominent appearance of the work's title, "
1759 "preceding the beginning of the body of the text."
1760 msgstr ""
1761 "The <quote>Title Page</quote> means, for a printed book, the title page "
1762 "itself, plus such following pages as are needed to hold, legibly, the "
1763 "material this Licence requires to appear in the title page. For works in "
1764 "formats which do not have any title page as such, <quote>Title Page</quote> "
1765 "means the text near the most prominent appearance of the work's title, "
1766 "preceding the beginning of the body of the text."
1767
1768 #: C/gtk-doc-manual.xml:153(title)
1769 msgid "2. VERBATIM COPYING"
1770 msgstr "2. VERBATIM COPYING"
1771
1772 #: C/gtk-doc-manual.xml:154(para)
1773 msgid ""
1774 "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
1775 "link> in any medium, either commercially or noncommercially, provided that "
1776 "this License, the copyright notices, and the license notice saying this "
1777 "License applies to the Document are reproduced in all copies, and that you "
1778 "add no other conditions whatsoever to those of this License. You may not use "
1779 "technical measures to obstruct or control the reading or further copying of "
1780 "the copies you make or distribute. However, you may accept compensation in "
1781 "exchange for copies. If you distribute a large enough number of copies you "
1782 "must also follow the conditions in <link linkend=\"fdl-section3\">section 3</"
1783 "link>."
1784 msgstr ""
1785 "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
1786 "link> in any medium, either commercially or noncommercially, provided that "
1787 "this Licence, the copyright notices, and the licence notice saying this "
1788 "Licence applies to the Document are reproduced in all copies, and that you "
1789 "add no other conditions whatsoever to those of this Licence. You may not use "
1790 "technical measures to obstruct or control the reading or further copying of "
1791 "the copies you make or distribute. However, you may accept compensation in "
1792 "exchange for copies. If you distribute a large enough number of copies you "
1793 "must also follow the conditions in <link linkend=\"fdl-section3\">section 3</"
1794 "link>."
1795
1796 #: C/gtk-doc-manual.xml:169(para)
1797 msgid ""
1798 "You may also lend copies, under the same conditions stated above, and you "
1799 "may publicly display copies."
1800 msgstr ""
1801 "You may also lend copies, under the same conditions stated above, and you "
1802 "may publicly display copies."
1803
1804 #: C/gtk-doc-manual.xml:176(title)
1805 msgid "3. COPYING IN QUANTITY"
1806 msgstr "3. COPYING IN QUANTITY"
1807
1808 #: C/gtk-doc-manual.xml:177(para)
1809 msgid ""
1810 "If you publish printed copies of the <link linkend=\"fdl-document"
1811 "\">Document</link> numbering more than 100, and the Document's license "
1812 "notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</link>, you "
1813 "must enclose the copies in covers that carry, clearly and legibly, all these "
1814 "Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on "
1815 "the back cover. Both covers must also clearly and legibly identify you as "
1816 "the publisher of these copies. The front cover must present the full title "
1817 "with all words of the title equally prominent and visible. You may add other "
1818 "material on the covers in addition. Copying with changes limited to the "
1819 "covers, as long as they preserve the title of the <link linkend=\"fdl-"
1820 "document\">Document</link> and satisfy these conditions, can be treated as "
1821 "verbatim copying in other respects."
1822 msgstr ""
1823 "If you publish printed copies of the <link linkend=\"fdl-document"
1824 "\">Document</link> numbering more than 100, and the Document's licence "
1825 "notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</link>, you "
1826 "must enclose the copies in covers that carry, clearly and legibly, all these "
1827 "Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on "
1828 "the back cover. Both covers must also clearly and legibly identify you as "
1829 "the publisher of these copies. The front cover must present the full title "
1830 "with all words of the title equally prominent and visible. You may add other "
1831 "material on the covers in addition. Copying with changes limited to the "
1832 "covers, as long as they preserve the title of the <link linkend=\"fdl-"
1833 "document\">Document</link> and satisfy these conditions, can be treated as "
1834 "verbatim copying in other respects."
1835
1836 #: C/gtk-doc-manual.xml:195(para)
1837 msgid ""
1838 "If the required texts for either cover are too voluminous to fit legibly, "
1839 "you should put the first ones listed (as many as fit reasonably) on the "
1840 "actual cover, and continue the rest onto adjacent pages."
1841 msgstr ""
1842 "If the required texts for either cover are too voluminous to fit legibly, "
1843 "you should put the first ones listed (as many as fit reasonably) on the "
1844 "actual cover, and continue the rest onto adjacent pages."
1845
1846 #: C/gtk-doc-manual.xml:202(para)
1847 msgid ""
1848 "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</link> "
1849 "copies of the <link linkend=\"fdl-document\">Document</link> numbering more "
1850 "than 100, you must either include a machine-readable <link linkend=\"fdl-"
1851 "transparent\">Transparent</link> copy along with each Opaque copy, or state "
1852 "in or with each Opaque copy a publicly-accessible computer-network location "
1853 "containing a complete Transparent copy of the Document, free of added "
1854 "material, which the general network-using public has access to download "
1855 "anonymously at no charge using public-standard network protocols. If you use "
1856 "the latter option, you must take reasonably prudent steps, when you begin "
1857 "distribution of Opaque copies in quantity, to ensure that this Transparent "
1858 "copy will remain thus accessible at the stated location until at least one "
1859 "year after the last time you distribute an Opaque copy (directly or through "
1860 "your agents or retailers) of that edition to the public."
1861 msgstr ""
1862 "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</link> "
1863 "copies of the <link linkend=\"fdl-document\">Document</link> numbering more "
1864 "than 100, you must either include a machine-readable <link linkend=\"fdl-"
1865 "transparent\">Transparent</link> copy along with each Opaque copy, or state "
1866 "in or with each Opaque copy a publicly-accessible computer-network location "
1867 "containing a complete Transparent copy of the Document, free of added "
1868 "material, which the general network-using public has access to download "
1869 "anonymously at no charge using public-standard network protocols. If you use "
1870 "the latter option, you must take reasonably prudent steps, when you begin "
1871 "distribution of Opaque copies in quantity, to ensure that this Transparent "
1872 "copy will remain thus accessible at the stated location until at least one "
1873 "year after the last time you distribute an Opaque copy (directly or through "
1874 "your agents or retailers) of that edition to the public."
1875
1876 #: C/gtk-doc-manual.xml:222(para)
1877 msgid ""
1878 "It is requested, but not required, that you contact the authors of the <link "
1879 "linkend=\"fdl-document\">Document</link> well before redistributing any "
1880 "large number of copies, to give them a chance to provide you with an updated "
1881 "version of the Document."
1882 msgstr ""
1883 "It is requested, but not required, that you contact the authors of the <link "
1884 "linkend=\"fdl-document\">Document</link> well before redistributing any "
1885 "large number of copies, to give them a chance to provide you with an updated "
1886 "version of the Document."
1887
1888 #: C/gtk-doc-manual.xml:231(title)
1889 msgid "4. MODIFICATIONS"
1890 msgstr "4. MODIFICATIONS"
1891
1892 #: C/gtk-doc-manual.xml:232(para)
1893 msgid ""
1894 "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
1895 "Version</link> of the <link linkend=\"fdl-document\">Document</link> under "
1896 "the conditions of sections <link linkend=\"fdl-section2\">2</link> and <link "
1897 "linkend=\"fdl-section3\">3</link> above, provided that you release the "
1898 "Modified Version under precisely this License, with the Modified Version "
1899 "filling the role of the Document, thus licensing distribution and "
1900 "modification of the Modified Version to whoever possesses a copy of it. In "
1901 "addition, you must do these things in the Modified Version:"
1902 msgstr ""
1903 "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
1904 "Version</link> of the <link linkend=\"fdl-document\">Document</link> under "
1905 "the conditions of sections <link linkend=\"fdl-section2\">2</link> and <link "
1906 "linkend=\"fdl-section3\">3</link> above, provided that you release the "
1907 "Modified Version under precisely this Licence, with the Modified Version "
1908 "filling the role of the Document, thus licensing distribution and "
1909 "modification of the Modified Version to whoever possesses a copy of it. In "
1910 "addition, you must do these things in the Modified Version:"
1911
1912 #: C/gtk-doc-manual.xml:248(title)
1913 msgid "A"
1914 msgstr "A"
1915
1916 #: C/gtk-doc-manual.xml:249(para)
1917 msgid ""
1918 "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
1919 "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
1920 "document\">Document</link>, and from those of previous versions (which "
1921 "should, if there were any, be listed in the History section of the "
1922 "Document). You may use the same title as a previous version if the original "
1923 "publisher of that version gives permission."
1924 msgstr ""
1925 "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
1926 "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
1927 "document\">Document</link>, and from those of previous versions (which "
1928 "should, if there were any, be listed in the History section of the "
1929 "Document). You may use the same title as a previous version if the original "
1930 "publisher of that version gives permission."
1931
1932 #: C/gtk-doc-manual.xml:264(title)
1933 msgid "B"
1934 msgstr "B"
1935
1936 #: C/gtk-doc-manual.xml:265(para)
1937 msgid ""
1938 "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as authors, "
1939 "one or more persons or entities responsible for authorship of the "
1940 "modifications in the <link linkend=\"fdl-modified\">Modified Version</link>, "
1941 "together with at least five of the principal authors of the <link linkend="
1942 "\"fdl-document\">Document</link> (all of its principal authors, if it has "
1943 "less than five)."
1944 msgstr ""
1945 "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as authors, "
1946 "one or more persons or entities responsible for authorship of the "
1947 "modifications in the <link linkend=\"fdl-modified\">Modified Version</link>, "
1948 "together with at least five of the principal authors of the <link linkend="
1949 "\"fdl-document\">Document</link> (all of its principal authors, if it has "
1950 "less than five)."
1951
1952 #: C/gtk-doc-manual.xml:279(title)
1953 msgid "C"
1954 msgstr "C"
1955
1956 #: C/gtk-doc-manual.xml:280(para)
1957 msgid ""
1958 "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name of "
1959 "the publisher of the <link linkend=\"fdl-modified\">Modified Version</link>, "
1960 "as the publisher."
1961 msgstr ""
1962 "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name of "
1963 "the publisher of the <link linkend=\"fdl-modified\">Modified Version</link>, "
1964 "as the publisher."
1965
1966 #: C/gtk-doc-manual.xml:291(title)
1967 msgid "D"
1968 msgstr "D"
1969
1970 #: C/gtk-doc-manual.xml:292(para)
1971 msgid ""
1972 "Preserve all the copyright notices of the <link linkend=\"fdl-document"
1973 "\">Document</link>."
1974 msgstr ""
1975 "Preserve all the copyright notices of the <link linkend=\"fdl-document"
1976 "\">Document</link>."
1977
1978 #: C/gtk-doc-manual.xml:301(title)
1979 msgid "E"
1980 msgstr "E"
1981
1982 #: C/gtk-doc-manual.xml:302(para)
1983 msgid ""
1984 "Add an appropriate copyright notice for your modifications adjacent to the "
1985 "other copyright notices."
1986 msgstr ""
1987 "Add an appropriate copyright notice for your modifications adjacent to the "
1988 "other copyright notices."
1989
1990 #: C/gtk-doc-manual.xml:311(title)
1991 msgid "F"
1992 msgstr "F"
1993
1994 #: C/gtk-doc-manual.xml:312(para)
1995 msgid ""
1996 "Include, immediately after the copyright notices, a license notice giving "
1997 "the public permission to use the <link linkend=\"fdl-modified\">Modified "
1998 "Version</link> under the terms of this License, in the form shown in the "
1999 "Addendum below."
2000 msgstr ""
2001 "Include, immediately after the copyright notices, a licence notice giving "
2002 "the public permission to use the <link linkend=\"fdl-modified\">Modified "
2003 "Version</link> under the terms of this Licence, in the form shown in the "
2004 "Addendum below."
2005
2006 #: C/gtk-doc-manual.xml:324(title)
2007 msgid "G"
2008 msgstr "G"
2009
2010 #: C/gtk-doc-manual.xml:325(para)
2011 msgid ""
2012 "Preserve in that license notice the full lists of <link linkend=\"fdl-"
2013 "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
2014 "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-document"
2015 "\">Document's</link> license notice."
2016 msgstr ""
2017 "Preserve in that licence notice the full lists of <link linkend=\"fdl-"
2018 "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
2019 "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-document"
2020 "\">Document's</link> licence notice."
2021
2022 #: C/gtk-doc-manual.xml:337(title)
2023 msgid "H"
2024 msgstr "H"
2025
2026 #: C/gtk-doc-manual.xml:338(para)
2027 msgid "Include an unaltered copy of this License."
2028 msgstr "Include an unaltered copy of this Licence."
2029
2030 #: C/gtk-doc-manual.xml:346(title)
2031 msgid "I"
2032 msgstr "I"
2033
2034 #: C/gtk-doc-manual.xml:347(para)
2035 msgid ""
2036 "Preserve the section entitled <quote>History</quote>, and its title, and add "
2037 "to it an item stating at least the title, year, new authors, and publisher "
2038 "of the <link linkend=\"fdl-modified\">Modified Version </link>as given on "
2039 "the <link linkend=\"fdl-title-page\">Title Page</link>. If there is no "
2040 "section entitled <quote>History</quote> in the <link linkend=\"fdl-document"
2041 "\">Document</link>, create one stating the title, year, authors, and "
2042 "publisher of the Document as given on its Title Page, then add an item "
2043 "describing the Modified Version as stated in the previous sentence."
2044 msgstr ""
2045 "Preserve the section entitled <quote>History</quote>, and its title, and add "
2046 "to it an item stating at least the title, year, new authors, and publisher "
2047 "of the <link linkend=\"fdl-modified\">Modified Version </link>as given on "
2048 "the <link linkend=\"fdl-title-page\">Title Page</link>. If there is no "
2049 "section entitled <quote>History</quote> in the <link linkend=\"fdl-document"
2050 "\">Document</link>, create one stating the title, year, authors, and "
2051 "publisher of the Document as given on its Title Page, then add an item "
2052 "describing the Modified Version as stated in the previous sentence."
2053
2054 #: C/gtk-doc-manual.xml:365(title)
2055 msgid "J"
2056 msgstr "J"
2057
2058 #: C/gtk-doc-manual.xml:366(para)
2059 msgid ""
2060 "Preserve the network location, if any, given in the <link linkend=\"fdl-"
2061 "document\">Document</link> for public access to a <link linkend=\"fdl-"
2062 "transparent\">Transparent</link> copy of the Document, and likewise the "
2063 "network locations given in the Document for previous versions it was based "
2064 "on. These may be placed in the <quote>History</quote> section. You may omit "
2065 "a network location for a work that was published at least four years before "
2066 "the Document itself, or if the original publisher of the version it refers "
2067 "to gives permission."
2068 msgstr ""
2069 "Preserve the network location, if any, given in the <link linkend=\"fdl-"
2070 "document\">Document</link> for public access to a <link linkend=\"fdl-"
2071 "transparent\">Transparent</link> copy of the Document, and likewise the "
2072 "network locations given in the Document for previous versions it was based "
2073 "on. These may be placed in the <quote>History</quote> section. You may omit "
2074 "a network location for a work that was published at least four years before "
2075 "the Document itself, or if the original publisher of the version it refers "
2076 "to gives permission."
2077
2078 #: C/gtk-doc-manual.xml:383(title)
2079 msgid "K"
2080 msgstr "K"
2081
2082 #: C/gtk-doc-manual.xml:384(para)
2083 msgid ""
2084 "In any section entitled <quote>Acknowledgements</quote> or "
2085 "<quote>Dedications</quote>, preserve the section's title, and preserve in "
2086 "the section all the substance and tone of each of the contributor "
2087 "acknowledgements and/or dedications given therein."
2088 msgstr ""
2089 "In any section entitled <quote>Acknowledgements</quote> or "
2090 "<quote>Dedications</quote>, preserve the section's title, and preserve in "
2091 "the section all the substance and tone of each of the contributor "
2092 "acknowledgements and/or dedications given therein."
2093
2094 #: C/gtk-doc-manual.xml:396(title)
2095 msgid "L"
2096 msgstr "L"
2097
2098 #: C/gtk-doc-manual.xml:397(para)
2099 msgid ""
2100 "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</link> "
2101 "of the <link linkend=\"fdl-document\">Document</link>, unaltered in their "
2102 "text and in their titles. Section numbers or the equivalent are not "
2103 "considered part of the section titles."
2104 msgstr ""
2105 "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</link> "
2106 "of the <link linkend=\"fdl-document\">Document</link>, unaltered in their "
2107 "text and in their titles. Section numbers or the equivalent are not "
2108 "considered part of the section titles."
2109
2110 #: C/gtk-doc-manual.xml:409(title)
2111 msgid "M"
2112 msgstr "M"
2113
2114 #: C/gtk-doc-manual.xml:410(para)
2115 msgid ""
2116 "Delete any section entitled <quote>Endorsements</quote>. Such a section may "
2117 "not be included in the <link linkend=\"fdl-modified\">Modified Version</"
2118 "link>."
2119 msgstr ""
2120 "Delete any section entitled <quote>Endorsements</quote>. Such a section may "
2121 "not be included in the <link linkend=\"fdl-modified\">Modified Version</"
2122 "link>."
2123
2124 #: C/gtk-doc-manual.xml:421(title)
2125 msgid "N"
2126 msgstr "N"
2127
2128 #: C/gtk-doc-manual.xml:422(para)
2129 msgid ""
2130 "Do not retitle any existing section as <quote>Endorsements</quote> or to "
2131 "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
2132 "Section</link>."
2133 msgstr ""
2134 "Do not retitle any existing section as <quote>Endorsements</quote> or to "
2135 "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
2136 "Section</link>."
2137
2138 #: C/gtk-doc-manual.xml:432(para)
2139 msgid ""
2140 "If the <link linkend=\"fdl-modified\">Modified Version</link> includes new "
2141 "front-matter sections or appendices that qualify as <link linkend=\"fdl-"
2142 "secondary\">Secondary Sections</link> and contain no material copied from "
2143 "the Document, you may at your option designate some or all of these sections "
2144 "as invariant. To do this, add their titles to the list of <link linkend="
2145 "\"fdl-invariant\">Invariant Sections</link> in the Modified Version's "
2146 "license notice. These titles must be distinct from any other section titles."
2147 msgstr ""
2148 "If the <link linkend=\"fdl-modified\">Modified Version</link> includes new "
2149 "front-matter sections or appendices that qualify as <link linkend=\"fdl-"
2150 "secondary\">Secondary Sections</link> and contain no material copied from "
2151 "the Document, you may at your option designate some or all of these sections "
2152 "as invariant. To do this, add their titles to the list of <link linkend="
2153 "\"fdl-invariant\">Invariant Sections</link> in the Modified Version's "
2154 "licence notice. These titles must be distinct from any other section titles."
2155
2156 #: C/gtk-doc-manual.xml:444(para)
2157 msgid ""
2158 "You may add a section entitled <quote>Endorsements</quote>, provided it "
2159 "contains nothing but endorsements of your <link linkend=\"fdl-modified"
2160 "\">Modified Version</link> by various parties--for example, statements of "
2161 "peer review or that the text has been approved by an organization as the "
2162 "authoritative definition of a standard."
2163 msgstr ""
2164 "You may add a section entitled <quote>Endorsements</quote>, provided it "
2165 "contains nothing but endorsements of your <link linkend=\"fdl-modified"
2166 "\">Modified Version</link> by various parties--for example, statements of "
2167 "peer review or that the text has been approved by an organisation as the "
2168 "authoritative definition of a standard."
2169
2170 #: C/gtk-doc-manual.xml:453(para)
2171 msgid ""
2172 "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
2173 "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a <link "
2174 "linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of the list "
2175 "of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the <link linkend="
2176 "\"fdl-modified\">Modified Version</link>. Only one passage of Front-Cover "
2177 "Text and one of Back-Cover Text may be added by (or through arrangements "
2178 "made by) any one entity. If the <link linkend=\"fdl-document\">Document</"
2179 "link> already includes a cover text for the same cover, previously added by "
2180 "you or by arrangement made by the same entity you are acting on behalf of, "
2181 "you may not add another; but you may replace the old one, on explicit "
2182 "permission from the previous publisher that added the old one."
2183 msgstr ""
2184 "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
2185 "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a <link "
2186 "linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of the list "
2187 "of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the <link linkend="
2188 "\"fdl-modified\">Modified Version</link>. Only one passage of Front-Cover "
2189 "Text and one of Back-Cover Text may be added by (or through arrangements "
2190 "made by) any one entity. If the <link linkend=\"fdl-document\">Document</"
2191 "link> already includes a cover text for the same cover, previously added by "
2192 "you or by arrangement made by the same entity you are acting on behalf of, "
2193 "you may not add another; but you may replace the old one, on explicit "
2194 "permission from the previous publisher that added the old one."
2195
2196 #: C/gtk-doc-manual.xml:470(para)
2197 msgid ""
2198 "The author(s) and publisher(s) of the <link linkend=\"fdl-document"
2199 "\">Document</link> do not by this License give permission to use their names "
2200 "for publicity for or to assert or imply endorsement of any <link linkend="
2201 "\"fdl-modified\">Modified Version </link>."
2202 msgstr ""
2203 "The author(s) and publisher(s) of the <link linkend=\"fdl-document"
2204 "\">Document</link> do not by this Licence give permission to use their names "
2205 "for publicity for or to assert or imply endorsement of any <link linkend="
2206 "\"fdl-modified\">Modified Version </link>."
2207
2208 #: C/gtk-doc-manual.xml:480(title)
2209 msgid "5. COMBINING DOCUMENTS"
2210 msgstr "5. COMBINING DOCUMENTS"
2211
2212 #: C/gtk-doc-manual.xml:481(para)
2213 msgid ""
2214 "You may combine the <link linkend=\"fdl-document\">Document</link> with "
2215 "other documents released under this License, under the terms defined in "
2216 "<link linkend=\"fdl-section4\">section 4</link> above for modified versions, "
2217 "provided that you include in the combination all of the <link linkend=\"fdl-"
2218 "invariant\">Invariant Sections</link> of all of the original documents, "
2219 "unmodified, and list them all as Invariant Sections of your combined work in "
2220 "its license notice."
2221 msgstr ""
2222 "You may combine the <link linkend=\"fdl-document\">Document</link> with "
2223 "other documents released under this Licence, under the terms defined in "
2224 "<link linkend=\"fdl-section4\">section 4</link> above for modified versions, "
2225 "provided that you include in the combination all of the <link linkend=\"fdl-"
2226 "invariant\">Invariant Sections</link> of all of the original documents, "
2227 "unmodified, and list them all as Invariant Sections of your combined work in "
2228 "its licence notice."
2229
2230 #: C/gtk-doc-manual.xml:492(para)
2231 msgid ""
2232 "The combined work need only contain one copy of this License, and multiple "
2233 "identical <link linkend=\"fdl-invariant\">Invariant Sections</link> may be "
2234 "replaced with a single copy. If there are multiple Invariant Sections with "
2235 "the same name but different contents, make the title of each such section "
2236 "unique by adding at the end of it, in parentheses, the name of the original "
2237 "author or publisher of that section if known, or else a unique number. Make "
2238 "the same adjustment to the section titles in the list of Invariant Sections "
2239 "in the license notice of the combined work."
2240 msgstr ""
2241 "The combined work need only contain one copy of this Licence, and multiple "
2242 "identical <link linkend=\"fdl-invariant\">Invariant Sections</link> may be "
2243 "replaced with a single copy. If there are multiple Invariant Sections with "
2244 "the same name but different contents, make the title of each such section "
2245 "unique by adding at the end of it, in parentheses, the name of the original "
2246 "author or publisher of that section if known, or else a unique number. Make "
2247 "the same adjustment to the section titles in the list of Invariant Sections "
2248 "in the licence notice of the combined work."
2249
2250 #: C/gtk-doc-manual.xml:505(para)
2251 msgid ""
2252 "In the combination, you must combine any sections entitled <quote>History</"
2253 "quote> in the various original documents, forming one section entitled "
2254 "<quote>History</quote>; likewise combine any sections entitled "
2255 "<quote>Acknowledgements</quote>, and any sections entitled "
2256 "<quote>Dedications</quote>. You must delete all sections entitled "
2257 "<quote>Endorsements.</quote>"
2258 msgstr ""
2259 "In the combination, you must combine any sections entitled <quote>History</"
2260 "quote> in the various original documents, forming one section entitled "
2261 "<quote>History</quote>; likewise combine any sections entitled "
2262 "<quote>Acknowledgements</quote>, and any sections entitled "
2263 "<quote>Dedications</quote>. You must delete all sections entitled "
2264 "<quote>Endorsements.</quote>"
2265
2266 #: C/gtk-doc-manual.xml:516(title)
2267 msgid "6. COLLECTIONS OF DOCUMENTS"
2268 msgstr "6. COLLECTIONS OF DOCUMENTS"
2269
2270 #: C/gtk-doc-manual.xml:517(para)
2271 msgid ""
2272 "You may make a collection consisting of the <link linkend=\"fdl-document"
2273 "\">Document</link> and other documents released under this License, and "
2274 "replace the individual copies of this License in the various documents with "
2275 "a single copy that is included in the collection, provided that you follow "
2276 "the rules of this License for verbatim copying of each of the documents in "
2277 "all other respects."
2278 msgstr ""
2279 "You may make a collection consisting of the <link linkend=\"fdl-document"
2280 "\">Document</link> and other documents released under this Licence, and "
2281 "replace the individual copies of this Licence in the various documents with "
2282 "a single copy that is included in the collection, provided that you follow "
2283 "the rules of this Licence for verbatim copying of each of the documents in "
2284 "all other respects."
2285
2286 #: C/gtk-doc-manual.xml:527(para)
2287 msgid ""
2288 "You may extract a single document from such a collection, and dispbibute it "
2289 "individually under this License, provided you insert a copy of this License "
2290 "into the extracted document, and follow this License in all other respects "
2291 "regarding verbatim copying of that document."
2292 msgstr ""
2293 "You may extract a single document from such a collection, and distribute it "
2294 "individually under this Licence, provided you insert a copy of this Licence "
2295 "into the extracted document, and follow this Licence in all other respects "
2296 "regarding verbatim copying of that document."
2297
2298 #: C/gtk-doc-manual.xml:537(title)
2299 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
2300 msgstr "7. AGGREGATION WITH INDEPENDENT WORKS"
2301
2302 #: C/gtk-doc-manual.xml:538(para)
2303 msgid ""
2304 "A compilation of the <link linkend=\"fdl-document\">Document</link> or its "
2305 "derivatives with other separate and independent documents or works, in or on "
2306 "a volume of a storage or distribution medium, does not as a whole count as a "
2307 "<link linkend=\"fdl-modified\">Modified Version</link> of the Document, "
2308 "provided no compilation copyright is claimed for the compilation. Such a "
2309 "compilation is called an <quote>aggregate</quote>, and this License does not "
2310 "apply to the other self-contained works thus compiled with the Document , on "
2311 "account of their being thus compiled, if they are not themselves derivative "
2312 "works of the Document. If the <link linkend=\"fdl-cover-texts\">Cover Text</"
2313 "link> requirement of <link linkend=\"fdl-section3\">section 3</link> is "
2314 "applicable to these copies of the Document, then if the Document is less "
2315 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
2316 "placed on covers that surround only the Document within the aggregate. "
2317 "Otherwise they must appear on covers around the whole aggregate."
2318 msgstr ""
2319 "A compilation of the <link linkend=\"fdl-document\">Document</link> or its "
2320 "derivatives with other separate and independent documents or works, in or on "
2321 "a volume of a storage or distribution medium, does not as a whole count as a "
2322 "<link linkend=\"fdl-modified\">Modified Version</link> of the Document, "
2323 "provided no compilation copyright is claimed for the compilation. Such a "
2324 "compilation is called an <quote>aggregate</quote>, and this Licence does not "
2325 "apply to the other self-contained works thus compiled with the Document , on "
2326 "account of their being thus compiled, if they are not themselves derivative "
2327 "works of the Document. If the <link linkend=\"fdl-cover-texts\">Cover Text</"
2328 "link> requirement of <link linkend=\"fdl-section3\">section 3</link> is "
2329 "applicable to these copies of the Document, then if the Document is less "
2330 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
2331 "placed on covers that surround only the Document within the aggregate. "
2332 "Otherwise they must appear on covers around the whole aggregate."
2333
2334 #: C/gtk-doc-manual.xml:561(title)
2335 msgid "8. TRANSLATION"
2336 msgstr "8. TRANSLATION"
2337
2338 #: C/gtk-doc-manual.xml:562(para)
2339 msgid ""
2340 "Translation is considered a kind of modification, so you may distribute "
2341 "translations of the <link linkend=\"fdl-document\">Document</link> under the "
2342 "terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing <link "
2343 "linkend=\"fdl-invariant\"> Invariant Sections</link> with translations "
2344 "requires special permission from their copyright holders, but you may "
2345 "include translations of some or all Invariant Sections in addition to the "
2346 "original versions of these Invariant Sections. You may include a translation "
2347 "of this License provided that you also include the original English version "
2348 "of this License. In case of a disagreement between the translation and the "
2349 "original English version of this License, the original English version will "
2350 "prevail."
2351 msgstr ""
2352 "Translation is considered a kind of modification, so you may distribute "
2353 "translations of the <link linkend=\"fdl-document\">Document</link> under the "
2354 "terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing <link "
2355 "linkend=\"fdl-invariant\"> Invariant Sections</link> with translations "
2356 "requires special permission from their copyright holders, but you may "
2357 "include translations of some or all Invariant Sections in addition to the "
2358 "original versions of these Invariant Sections. You may include a translation "
2359 "of this Licence provided that you also include the original English version "
2360 "of this Licence. In case of a disagreement between the translation and the "
2361 "original English version of this Licence, the original English version will "
2362 "prevail."
2363
2364 #: C/gtk-doc-manual.xml:580(title)
2365 msgid "9. TERMINATION"
2366 msgstr "9. TERMINATION"
2367
2368 #: C/gtk-doc-manual.xml:581(para)
2369 msgid ""
2370 "You may not copy, modify, sublicense, or distribute the <link linkend=\"fdl-"
2371 "document\">Document</link> except as expressly provided for under this "
2372 "License. Any other attempt to copy, modify, sublicense or distribute the "
2373 "Document is void, and will automatically terminate your rights under this "
2374 "License. However, parties who have received copies, or rights, from you "
2375 "under this License will not have their licenses terminated so long as such "
2376 "parties remain in full compliance."
2377 msgstr ""
2378 "You may not copy, modify, sublicence, or distribute the <link linkend=\"fdl-"
2379 "document\">Document</link> except as expressly provided for under this "
2380 "Licence. Any other attempt to copy, modify, sublicence or distribute the "
2381 "Document is void, and will automatically terminate your rights under this "
2382 "Licence. However, parties who have received copies, or rights, from you "
2383 "under this Licence will not have their licences terminated so long as such "
2384 "parties remain in full compliance."
2385
2386 #: C/gtk-doc-manual.xml:594(title)
2387 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
2388 msgstr "10. FUTURE REVISIONS OF THIS LICENCE"
2389
2390 #: C/gtk-doc-manual.xml:595(para)
2391 msgid ""
2392 "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
2393 "Software Foundation</ulink> may publish new, revised versions of the GNU "
2394 "Free Documentation License from time to time. Such new versions will be "
2395 "similar in spirit to the present version, but may differ in detail to "
2396 "address new problems or concerns. See <ulink type=\"http\" url=\"http://www."
2397 "gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
2398 msgstr ""
2399 "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
2400 "Software Foundation</ulink> may publish new, revised versions of the GNU "
2401 "Free Documentation Licence from time to time. Such new versions will be "
2402 "similar in spirit to the present version, but may differ in detail to "
2403 "address new problems or concerns. See <ulink type=\"http\" url=\"http://www."
2404 "gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
2405
2406 #: C/gtk-doc-manual.xml:606(para)
2407 msgid ""
2408 "Each version of the License is given a distinguishing version number. If the "
2409 "<link linkend=\"fdl-document\">Document</link> specifies that a particular "
2410 "numbered version of this License <quote>or any later version</quote> applies "
2411 "to it, you have the option of following the terms and conditions either of "
2412 "that specified version or of any later version that has been published (not "
2413 "as a draft) by the Free Software Foundation. If the Document does not "
2414 "specify a version number of this License, you may choose any version ever "
2415 "published (not as a draft) by the Free Software Foundation."
2416 msgstr ""
2417 "Each version of the Licence is given a distinguishing version number. If the "
2418 "<link linkend=\"fdl-document\">Document</link> specifies that a particular "
2419 "numbered version of this Licence <quote>or any later version</quote> applies "
2420 "to it, you have the option of following the terms and conditions either of "
2421 "that specified version or of any later version that has been published (not "
2422 "as a draft) by the Free Software Foundation. If the Document does not "
2423 "specify a version number of this Licence, you may choose any version ever "
2424 "published (not as a draft) by the Free Software Foundation."
2425
2426 #: C/gtk-doc-manual.xml:621(title)
2427 msgid "Addendum"
2428 msgstr "Addendum"
2429
2430 #: C/gtk-doc-manual.xml:622(para)
2431 msgid ""
2432 "To use this License in a document you have written, include a copy of the "
2433 "License in the document and put the following copyright and license notices "
2434 "just after the title page:"
2435 msgstr ""
2436 "To use this Licence in a document you have written, include a copy of the "
2437 "Licence in the document and put the following copyright and licence notices "
2438 "just after the title page:"
2439
2440 #: C/gtk-doc-manual.xml:629(para)
2441 msgid "Copyright YEAR YOUR NAME."
2442 msgstr "Copyright YEAR YOUR NAME."
2443
2444 #: C/gtk-doc-manual.xml:632(para)
2445 msgid ""
2446 "Permission is granted to copy, distribute and/or modify this document under "
2447 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
2448 "version published by the Free Software Foundation; with the <link linkend="
2449 "\"fdl-invariant\">Invariant Sections</link> being LIST THEIR TITLES, with "
2450 "the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</link> being LIST, "
2451 "and with the <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link> being "
2452 "LIST. A copy of the license is included in the section entitled <quote>GNU "
2453 "Free Documentation License</quote>."
2454 msgstr ""
2455 "Permission is granted to copy, distribute and/or modify this document under "
2456 "the terms of the GNU Free Documentation Licence, Version 1.1 or any later "
2457 "version published by the Free Software Foundation; with the <link linkend="
2458 "\"fdl-invariant\">Invariant Sections</link> being LIST THEIR TITLES, with "
2459 "the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</link> being LIST, "
2460 "and with the <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link> being "
2461 "LIST. A copy of the licence is included in the section entitled <quote>GNU "
2462 "Free Documentation Licence</quote>."
2463
2464 #: C/gtk-doc-manual.xml:647(para)
2465 msgid ""
2466 "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
2467 "write <quote>with no Invariant Sections</quote> instead of saying which ones "
2468 "are invariant. If you have no <link linkend=\"fdl-cover-texts\">Front-Cover "
2469 "Texts</link>, write <quote>no Front-Cover Texts</quote> instead of "
2470 "<quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="
2471 "\"fdl-cover-texts\">Back-Cover Texts</link>."
2472 msgstr ""
2473 "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
2474 "write <quote>with no Invariant Sections</quote> instead of saying which ones "
2475 "are invariant. If you have no <link linkend=\"fdl-cover-texts\">Front-Cover "
2476 "Texts</link>, write <quote>no Front-Cover Texts</quote> instead of "
2477 "<quote>Front-Cover Texts being LIST</quote>; likewise for <link linkend="
2478 "\"fdl-cover-texts\">Back-Cover Texts</link>."
2479
2480 #: C/gtk-doc-manual.xml:657(para)
2481 msgid ""
2482 "If your document contains nontrivial examples of program code, we recommend "
2483 "releasing these examples in parallel under your choice of free software "
2484 "license, such as the <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
2485 "gpl.html\"> GNU General Public License</ulink>, to permit their use in free "
2486 "software."
2487 msgstr ""
2488 "If your document contains nontrivial examples of program code, we recommend "
2489 "releasing these examples in parallel under your choice of free software "
2490 "licence, such as the <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
2491 "gpl.html\"> GNU General Public Licence</ulink>, to permit their use in free "
2492 "software."
2493
2494 #. Put one translator per line, in the form of NAME <EMAIL>, YEAR1, YEAR2.
2495 #: C/gtk-doc-manual.xml:0(None)
2496 msgid "translator-credits"
2497 msgstr "Jen Ockwell <[email protected]>, 2009\n"
2498 "Philip Withnall <[email protected]>, 2009"