Debian Codegraph @

help/manual/de/de.po

raw
1 # German translation of the gtk-doc manual.
2 #
3 # Mario Blättermann <[email protected]>, 2009-2010, 2012-2013, 2016, 2018, 2021.
4 # Wolfgang Stöggl <[email protected]>, 2015.
5 # Christian Kirbach <[email protected]>, 2013, 2015, 2018.
6 # Jürgen Benvenuti <[email protected]>, 2024.
7 #
8 msgid ""
9 msgstr ""
10 "Project-Id-Version: gtk-doc help master\n"
11 "POT-Creation-Date: 2024-04-01 18:02+0000\n"
12 "PO-Revision-Date: 2024-04-08 21:20+0200\n"
13 "Last-Translator: Christian Kirbach <[email protected]>\n"
14 "Language-Team: German <[email protected]>\n"
15 "Language: de\n"
16 "MIME-Version: 1.0\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
20 "X-Generator: Poedit 3.4.2\n"
21
22 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
23 msgctxt "_"
24 msgid "translator-credits"
25 msgstr ""
26 "Mario Blättermann <[email protected]>, 2009-2013, 2016, 2018, "
27 "2021\n"
28 "Christian Kirbach <[email protected]>, 2013, 2015-2024\n"
29 "Jürgen Benvenuti <[email protected]>, 2024"
30
31 #. (itstool) path: bookinfo/title
32 #: C/index.docbook:12
33 msgid "GTK-Doc Manual"
34 msgstr "GTK-Doc-Handbuch"
35
36 #. (itstool) path: bookinfo/edition
37 #: C/index.docbook:13
38 msgid "1.24.1"
39 msgstr "1.24.1"
40
41 #. (itstool) path: abstract/para
42 #: C/index.docbook:14
43 msgid "User manual for developers with instructions of GTK-Doc usage."
44 msgstr ""
45 "Benutzerhandbuch für Entwickler mit Anweisungen für die Benutzung von GTK-"
46 "Doc."
47
48 #. (itstool) path: authorgroup/author
49 #: C/index.docbook:16
50 msgid ""
51 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
52 "<address> <email>[email protected]</email> </address> </affiliation>"
53 msgstr ""
54 "<firstname>Chris</firstname> <surname>Lyttle</surname> <affiliation> "
55 "<address> <email>[email protected]</email> </address> </affiliation>"
56
57 #. (itstool) path: authorgroup/author
58 #: C/index.docbook:25
59 msgid ""
60 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
61 "<email>[email protected]</email> </address> </affiliation>"
62 msgstr ""
63 "<firstname>Dan</firstname> <surname>Mueth</surname> <affiliation> <address> "
64 "<email>[email protected]</email> </address> </affiliation>"
65
66 #. (itstool) path: authorgroup/author
67 #: C/index.docbook:34
68 msgid ""
69 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
70 "<address> <email>[email protected]</email> </address> </affiliation>"
71 msgstr ""
72 "<firstname>Stefan</firstname> <surname>Sauer (Kost)</surname> <affiliation> "
73 "<address> <email>[email protected]</email> </address> </affiliation>"
74
75 #. (itstool) path: publisher/publishername
76 #: C/index.docbook:45
77 msgid "GTK-Doc project"
78 msgstr "GTK-Doc-Projekt"
79
80 #. (itstool) path: bookinfo/publisher
81 #: C/index.docbook:44
82 msgid ""
83 "<_:publishername-1/> <address><email>[email protected]</email></address>"
84 msgstr ""
85 "<_:publishername-1/> <address><email>[email protected]</email></address>"
86
87 #. (itstool) path: bookinfo/copyright
88 #: C/index.docbook:48
89 msgid "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>"
90 msgstr "<year>2000, 2005</year> <holder>Dan Mueth und Chris Lyttle</holder>"
91
92 #. (itstool) path: bookinfo/copyright
93 #: C/index.docbook:52
94 msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
95 msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>"
96
97 #. (itstool) path: legalnotice/para
98 #: C/index.docbook:65
99 msgid ""
100 "Permission is granted to copy, distribute and/or modify this document under "
101 "the terms of the <citetitle>GNU Free Documentation License</citetitle>, "
102 "Version 1.1 or any later version published by the Free Software Foundation "
103 "with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A "
104 "copy of the license is <link linkend=\"fdl\">included</link>."
105 msgstr ""
106 "Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free "
107 "Documentation License (GFDL), Version 1.1 oder jeder späteren, von der Free "
108 "Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte "
109 "sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt "
110 "und/oder modifiziert werden. Eine Kopie der GFDL finden Sie unter diesem "
111 "<ulink type=\"help\" url=\"ghelp:fdl\">Link</ulink> oder in der mit diesem "
112 "Handbuch gelieferten Datei COPYING-DOCS."
113
114 #. (itstool) path: legalnotice/para
115 #: C/index.docbook:73
116 msgid ""
117 "Many of the names used by companies to distinguish their products and "
118 "services are claimed as trademarks. Where those names appear in any GNOME "
119 "documentation, and those trademarks are made aware to the members of the "
120 "GNOME Documentation Project, the names have been printed in caps or initial "
121 "caps."
122 msgstr ""
123 "Bei vielen der von Firmen zur Unterscheidung ihrer Produkte und "
124 "Dienstleistungen verwendeten Namen handelt es sich um Marken. An den "
125 "Stellen, an denen derartige Namen in einer GNOME-Dokumentation vorkommen und "
126 "wenn die Mitglieder des GNOME-Dokumentationsprojekts über diese Marken "
127 "informiert wurden, sind die Namen in Großbuchstaben oder mit großen "
128 "Anfangsbuchstaben geschrieben."
129
130 #. (itstool) path: revhistory/revision
131 #: C/index.docbook:83
132 msgid ""
133 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
134 "authorinitials> <revremark>gtk4 version</revremark>"
135 msgstr ""
136 "<revnumber>1.33.0</revnumber> <date>1. Oktober 2020</date> "
137 "<authorinitials>mc</authorinitials> <revremark>Gtk4-Version</revremark>"
138
139 #. (itstool) path: revhistory/revision
140 #: C/index.docbook:89
141 msgid ""
142 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
143 "authorinitials> <revremark>dev version</revremark>"
144 msgstr ""
145 "<revnumber>1.32.1</revnumber> <date>15. August 2019</date> "
146 "<authorinitials>ss</authorinitials> <revremark>Entwicklerversion</revremark>"
147
148 #. (itstool) path: revhistory/revision
149 #: C/index.docbook:95
150 msgid ""
151 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
152 "authorinitials> <revremark>hotfix release</revremark>"
153 msgstr ""
154 "<revnumber>1.32</revnumber> <date>15. August 2019</date> <authorinitials>ss</"
155 "authorinitials> <revremark>Korrekturveröffentlichung</revremark>"
156
157 #. (itstool) path: revhistory/revision
158 #: C/index.docbook:101
159 msgid ""
160 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
161 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
162 msgstr ""
163 "<revnumber>1.31</revnumber> <date>05. August 2019</date> <authorinitials>ss</"
164 "authorinitials> <revremark>Größere Umbauten und weitere Tests</revremark>"
165
166 #. (itstool) path: revhistory/revision
167 #: C/index.docbook:107
168 msgid ""
169 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
170 "authorinitials> <revremark>more test coverage</revremark>"
171 msgstr ""
172 "<revnumber>1.30</revnumber> <date>08. Mai 2019</date> <authorinitials>ss</"
173 "authorinitials> <revremark>Weitere Tests</revremark>"
174
175 #. (itstool) path: revhistory/revision
176 #: C/index.docbook:113
177 msgid ""
178 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
179 "authorinitials> <revremark>bug fixes</revremark>"
180 msgstr ""
181 "<revnumber>1.29</revnumber> <date>28. August 2018</date> <authorinitials>ss</"
182 "authorinitials> <revremark>Fehlerbehebungen</revremark>"
183
184 #. (itstool) path: revhistory/revision
185 #: C/index.docbook:119
186 msgid ""
187 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
188 "authorinitials> <revremark>bug fixes</revremark>"
189 msgstr ""
190 "<revnumber>1.28</revnumber> <date>24. März 2018</date> <authorinitials>ss</"
191 "authorinitials> <revremark>Fehlerbehebungen</revremark>"
192
193 #. (itstool) path: revhistory/revision
194 #: C/index.docbook:125
195 msgid ""
196 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
197 "authorinitials> <revremark>fine tuning of the python port</revremark>"
198 msgstr ""
199 "<revnumber>1.27</revnumber> <date>07. Dezember 2017</date>> "
200 "<authorinitials>ss</authorinitials> <revremark>Detailanpassungen der Python-"
201 "Portierung</revremark>"
202
203 #. (itstool) path: revhistory/revision
204 #: C/index.docbook:131
205 msgid ""
206 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
207 "authorinitials> <revremark>port all tools from perl/bash to python</"
208 "revremark>"
209 msgstr ""
210 "<revnumber>1.26.1</revnumber> <date>11. August 2017</date> "
211 "<authorinitials>ss</authorinitials> <revremark>Alle Werkzeuge von Perl/Bash "
212 "nach Python portiert</revremark>"
213
214 #. (itstool) path: revhistory/revision
215 #: C/index.docbook:137
216 msgid ""
217 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
218 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
219 msgstr ""
220 "<revnumber>1.25</revnumber> <date>21. März 2015</date> <authorinitials>ss</"
221 "authorinitials> <revremark>Fehlerbehebungen, Test-Cleanups</revremark>"
222
223 #. (itstool) path: revhistory/revision
224 #: C/index.docbook:143
225 msgid ""
226 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
227 "authorinitials> <revremark>bug fix</revremark>"
228 msgstr ""
229 "<revnumber>1.24</revnumber> <date>29. Mai 2015</date> <authorinitials>ss</"
230 "authorinitials> <revremark>Fehlerbehebungen</revremark>"
231
232 #. (itstool) path: revhistory/revision
233 #: C/index.docbook:149
234 msgid ""
235 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
236 "authorinitials> <revremark>bug fix</revremark>"
237 msgstr ""
238 "<revnumber>1.23</revnumber> <date>17. Mai 2015</date> <authorinitials>ss</"
239 "authorinitials> <revremark>Fehlerbehebungen</revremark>"
240
241 #. (itstool) path: revhistory/revision
242 #: C/index.docbook:155
243 msgid ""
244 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
245 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
246 "revremark>"
247 msgstr ""
248 "<revnumber>1.22</revnumber> <date>7. Mai 2015</date> <authorinitials>ss</"
249 "authorinitials> <revremark>Fehlerbehebungen, veraltete Funktionen verworfen</"
250 "revremark>"
251
252 #. (itstool) path: revhistory/revision
253 #: C/index.docbook:161
254 msgid ""
255 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
256 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
257 "revremark>"
258 msgstr ""
259 "<revnumber>1.21</revnumber> <date>17. Juli 2014</date> <authorinitials>ss</"
260 "authorinitials> <revremark>Fehlerbehebungen, veraltete Funktionen verworfen</"
261 "revremark>"
262
263 #. (itstool) path: revhistory/revision
264 #: C/index.docbook:167
265 msgid ""
266 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
267 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
268 "revremark>"
269 msgstr ""
270 "<revnumber>1.20</revnumber> <date>16. Februar 2014</date> "
271 "<authorinitials>ss</authorinitials> <revremark>Fehlerberhebungen, "
272 "Unterstützung für Markdown, Layoutverbesserungen</revremark>"
273
274 #. (itstool) path: revhistory/revision
275 #: C/index.docbook:173
276 msgid ""
277 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
278 "authorinitials> <revremark>bug fixes</revremark>"
279 msgstr ""
280 "<revnumber>1.19</revnumber> <date>05. Juni 2013</date> <authorinitials>ss</"
281 "authorinitials> <revremark>Fehlerbehebungen</revremark>"
282
283 #. (itstool) path: revhistory/revision
284 #: C/index.docbook:179
285 msgid ""
286 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
287 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
288 msgstr ""
289 "<revnumber>1.18</revnumber> <date>14. September 2011</date> "
290 "<authorinitials>ss</authorinitials> <revremark>Fehlerbehebungen, Verbesserte "
291 "Geschwindigkeit, Unterstützung für markdown</revremark>"
292
293 #. (itstool) path: revhistory/revision
294 #: C/index.docbook:185
295 msgid ""
296 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
297 "authorinitials> <revremark>urgent bug fix update</revremark>"
298 msgstr ""
299 "<revnumber>1.17</revnumber> <date>26. Februar 2011</date> "
300 "<authorinitials>sk</authorinitials> <revremark>Dringende Bugfix-"
301 "Aktualisierung</revremark>"
302
303 #. (itstool) path: revhistory/revision
304 #: C/index.docbook:191
305 msgid ""
306 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
307 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
308 msgstr ""
309 "<revnumber>1.16</revnumber> <date>14. Januar 2011</date> <authorinitials>sk</"
310 "authorinitials> <revremark>Bugfixes, Layoutverbesserungen</revremark>"
311
312 #. (itstool) path: revhistory/revision
313 #: C/index.docbook:197
314 msgid ""
315 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
316 "authorinitials> <revremark>bug and regression fixes</revremark>"
317 msgstr ""
318 "<revnumber>1.15</revnumber> <date>21. Mai 2010</date> <authorinitials>sk</"
319 "authorinitials> <revremark>Bug- und Regressionsfixes</revremark>"
320
321 #. (itstool) path: revhistory/revision
322 #: C/index.docbook:203
323 msgid ""
324 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
325 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
326 msgstr ""
327 "<revnumber>1.14</revnumber> <date>28. März 2010</date> <authorinitials>sk</"
328 "authorinitials> <revremark>Bugfixes und Leistungsverbesserungen</revremark>"
329
330 #. (itstool) path: revhistory/revision
331 #: C/index.docbook:209
332 msgid ""
333 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
334 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
335 "revremark>"
336 msgstr ""
337 "<revnumber>1.13</revnumber> <date>18. Dezember 2009</date> "
338 "<authorinitials>sk</authorinitials> <revremark>Aktualisierung eines "
339 "beschädigten Tarballs</revremark>"
340
341 #. (itstool) path: revhistory/revision
342 #: C/index.docbook:215
343 msgid ""
344 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
345 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
346 "bugfixes</revremark>"
347 msgstr ""
348 "<revnumber>1.12</revnumber> <date>18. Dezember 2009</date> "
349 "<authorinitials>sk</authorinitials> <revremark>Neue Features und Bugfixes</"
350 "revremark>"
351
352 #. (itstool) path: revhistory/revision
353 #: C/index.docbook:221
354 msgid ""
355 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
356 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
357 "revremark>"
358 msgstr ""
359 "<revnumber>1.11</revnumber> <date>16. November 2008</date> "
360 "<authorinitials>mal</authorinitials> <revremark>Migration auf die GNOME doc-"
361 "utils</revremark>"
362
363 #. (itstool) path: chapter/title
364 #: C/index.docbook:234
365 msgid "Introduction"
366 msgstr "Einführung"
367
368 #. (itstool) path: chapter/para
369 #: C/index.docbook:236
370 msgid ""
371 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
372 "it is used."
373 msgstr ""
374 "Dieses Kapitel führt in GTK-Doc ein und gibt einen Überblick darüber, worum "
375 "es sich dabei handelt und wie es benutzt wird."
376
377 #. (itstool) path: sect1/title
378 #: C/index.docbook:242
379 msgid "What is GTK-Doc?"
380 msgstr "Was ist GTK-Doc?"
381
382 #. (itstool) path: sect1/para
383 #: C/index.docbook:244
384 msgid ""
385 "GTK-Doc is used to document C code. It is typically used to document the "
386 "public API of libraries, such as the GTK+ and GNOME libraries. But it can "
387 "also be used to document application code."
388 msgstr ""
389 "GTL-Doc wird zur Dokumentation von C-Code verwendet. Üblicherweise wird "
390 "damit die öffentliche API von Bibliotheken dokumentiert, wie die der GTK+- "
391 "und GNOME-Bibliotheken. Es kann aber auch zur Dokumentation von "
392 "Anwendungscode verwendet werden."
393
394 #. (itstool) path: sect1/title
395 #: C/index.docbook:252
396 msgid "How Does GTK-Doc Work?"
397 msgstr "Wie funktioniert GTK-Doc?"
398
399 #. (itstool) path: sect1/para
400 #: C/index.docbook:254
401 msgid ""
402 "GTK-Doc works by using documentation of functions placed inside the source "
403 "files in specially-formatted comment blocks, or documentation added to the "
404 "template files which GTK-Doc uses (though note that GTK-Doc will only "
405 "document functions that are declared in header files; it won't produce "
406 "output for static functions)."
407 msgstr ""
408 "GTK-Doc verwendet Funktionsdokumentationen, die sich in den Quelldateien "
409 "innerhalb speziell formatierter Kommentarblöcke befinden, oder "
410 "Dokumentation, die zu den von GTK-Doc verwendeten Vorlagendateien "
411 "hinzugefügt wurde. Beachten Sie jedoch, dass GTK-Doc nur Funktionen "
412 "dokumentieren wird, die in den Header-Dateien deklariert sind. Es erstellt "
413 "keine Ausgaben für statische Funktionen."
414
415 #. (itstool) path: sect1/para
416 #: C/index.docbook:261
417 msgid ""
418 "GTK-Doc consists of a number of python scripts, each performing a different "
419 "step in the process."
420 msgstr ""
421 "GTK-Doc besteht aus einer Anzahl von Python-Skripten, wovon jedes einen "
422 "bestimmten Schritt in dem Prozess ausführt."
423
424 #. (itstool) path: sect1/para
425 #: C/index.docbook:266
426 msgid "There are 5 main steps in the process:"
427 msgstr "Dieser Vorgang umfasst fünf Hauptschritte:"
428
429 #. (itstool) path: listitem/para
430 #: C/index.docbook:273
431 msgid ""
432 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
433 "source files with the documentation for each function, macro, structs or "
434 "unions, etc."
435 msgstr ""
436 "<guilabel>Schreiben der Dokumentation.</guilabel> Der Autor ergänzt die "
437 "Quelldateien um die Dokumentation für jede Funktion, jedes Makro usw."
438
439 #. (itstool) path: listitem/para
440 #: C/index.docbook:282
441 msgid ""
442 "<guilabel>Gathering information about the code.</guilabel> "
443 "<application>gtkdoc-scan</application> scans the header files of the code "
444 "looking for declarations of functions, macros, enums, structs, and unions. "
445 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
446 "containing a list of the declarations, placing them into sections according "
447 "to which header file they are in. On the first run this file is copied to "
448 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
449 "the sections, and the order of the declarations within them, to produce the "
450 "final desired order. The second file it generates is <filename>&lt;"
451 "module&gt;-decl.txt</filename>. This file contains the full declarations "
452 "found by the scanner. If for some reason one would like some symbols to show "
453 "up in the docs, where the full declaration cannot be found by the scanner or "
454 "the declaration should appear differently, one can place entities similar to "
455 "the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;"
456 "module&gt;-overrides.txt</filename>."
457 msgstr ""
458 "<guilabel>Informationen über den Code sammeln.</guilabel> "
459 "<application>gtkdoc-scan</application> analysiert die Header-Dateien des "
460 "Code und sucht nach Funktionsdeklarationen, Macros, enum (Aufzählung), "
461 "struct (Strukturen) und »unions«. Es erstellt die Datei <filename>&lt;"
462 "module&gt;-decl-list.txt</filename>, welche eine Liste der Deklarationen "
463 "enthält, und platziert diese in Abschnitte entsprechend der Header-Dateien, "
464 "in der sie sind. Bei erster Ausführung wird diese Datei nach <filename>&lt;"
465 "module&gt;-sections.txt</filename> kopiert. Der Autor kann die Abschnitte "
466 "und die Reihenfolge der Deklarationen in gewünschter Reihenfolge neu "
467 "anordnen. Die zweite erstellte Datei ist <filename>&lt;module&gt;-decl.txt</"
468 "filename>. Diese Datei enthält alle Deklarationen, die vom Scanner gefunden "
469 "wurden. Wenn aus irgendeinem Grund einige Symbole in der Dokumentation "
470 "erscheinen sollen, wenn die volle Deklaration nicht vom Scanner gefunden "
471 "werden kann oder die Deklaration anders erscheinen soll, kann man Entitäten "
472 "ähnlich derer in<filename>&lt;module&gt;-decl.txt</filename> innerhalb "
473 "<filename>&lt;module&gt;-overrides.txt</filename> platzieren."
474
475 #. (itstool) path: listitem/para
476 #: C/index.docbook:299
477 msgid ""
478 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
479 "query a library about any GObject subclasses it exports. It saves "
480 "information about each object's position in the class hierarchy and about "
481 "any GObject properties and signals it provides."
482 msgstr ""
483 "<application>gtkdoc-scangobj</application> kann ebenso dazu verwendet "
484 "werden, dynamisch eine Bibliothek über irgendeine GObject-Subklasse "
485 "anzufragen, die sie exportiert. Es speichert Informationen über jede "
486 "Objektposition in der Klassenhierarchie und über alle GObjekt-Eigenschaften "
487 "und -Signale, die es bietet."
488
489 #. (itstool) path: listitem/para
490 #: C/index.docbook:305
491 msgid ""
492 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
493 "needed in the past when GObject was still GtkObject inside gtk+."
494 msgstr ""
495 "<application>gtkdoc-scanobj</application> sollte nicht weiter verwendet "
496 "werden. Es war in der Vergangenheit notwendig, als GObject noch ein "
497 "GtkObject innerhalb von gtk+ war."
498
499 #. (itstool) path: listitem/para
500 #: C/index.docbook:312
501 msgid ""
502 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
503 "mkdb</application> turns the template files into XML files in the <filename "
504 "class=\"directory\">xml/</filename> subdirectory. If the source code "
505 "contains documentation on functions, using the special comment blocks, it "
506 "gets merged in here. If there are no tmpl files used it only reads docs from "
507 "sources and introspection data."
508 msgstr ""
509 "<guilabel>Erstellen des SGML/XML und HTML/PDF.</guilabel> "
510 "<application>gtkdoc-mkdb</application> wandelt die Vorlagen-Dateien in XML-"
511 "Dateien in den Unterordner <filename class=\"directory\">xml/</filename> um. "
512 "Wenn der Quellcode Dokumentation über Funktionen mittels speziellen "
513 "Kommentarblöcken enthält, so wird diese hier eingepflegt. Wenn keine tmpl-"
514 "Dateien eingesetzt werden, so wird nur Dokumentation von den Quell- und "
515 "introspection-Daten gelesen."
516
517 #. (itstool) path: listitem/para
518 #: C/index.docbook:321
519 msgid ""
520 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
521 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
522 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
523 "document called <filename>&lt;package&gt;.pdf</filename>."
524 msgstr ""
525 "<application>gtkdoc-mkhtml</application> konvertiert die XML-Dateien in HTML-"
526 "Dateien im Unterordner <filename class=\"directory\">html/</filename>. "
527 "Ebenso konvertiert <application>gtkdoc-mkpdf</application> die XML-Dateien "
528 "in ein PDF-Dokument namens <filename>&lt;package&gt;.pdf</filename>."
529
530 #. (itstool) path: listitem/para
531 #: C/index.docbook:327
532 msgid ""
533 "Files in <filename class=\"directory\">xml/</filename> and <filename "
534 "class=\"directory\">html/</filename> directories are always overwritten. One "
535 "should never edit them directly."
536 msgstr ""
537 "Dateien in <filename class=\"directory\">xml/</filename> und <filename "
538 "class=\"directory\">html/</filename>-Ordnern werden immer überschrieben. "
539 "Niemand sollte diese direkt bearbeiten."
540
541 #. (itstool) path: listitem/para
542 #: C/index.docbook:335
543 msgid ""
544 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
545 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
546 "run to fix up any cross-references between separate documents. For example, "
547 "the GTK+ documentation contains many cross-references to types documented in "
548 "the GLib manual. When creating the source tarball for distribution, "
549 "<application>gtkdoc-rebase</application> turns all external links into web-"
550 "links. When installing distributed (pregenerated) docs the same application "
551 "will try to turn links back to local links (where those docs are installed)."
552 msgstr ""
553 "<guilabel>Querverweise zwischen Dokumenten korrigieren.</guilabel> Nach "
554 "Intallation der HTML-Dateien kann <application>gtkdoc-fixxref</application> "
555 "ausgeführt werden, um alle Querverweise zwischen separaten Dokumenten zu "
556 "korrigieren. Die GTK+-Dokumentation zum Beispiel enthält viele Querverweise "
557 "zu Typen, die im GLib-Handbuch dokumentiert sind. Beim Erstellen des Quellen-"
558 "tarball zur Verteilung wandelt <application>gtkdoc-rebase</application> alle "
559 "externen Verweise in Web-Verweise um. Beim Installieren verteilter (zuvor "
560 "erstellter) Dokumente wird dieselbe Anwendung versuchen, Verweise zurück in "
561 "lokale Verweise umzuwandeln (wo diese Dokumente installiert werden)."
562
563 #. (itstool) path: sect1/title
564 #: C/index.docbook:353
565 msgid "Getting GTK-Doc"
566 msgstr "GTK-Doc bekommen"
567
568 #. (itstool) path: sect2/title
569 #: C/index.docbook:356
570 msgid "Requirements"
571 msgstr "Erfordernisse"
572
573 #. (itstool) path: sect2/para
574 #: C/index.docbook:357
575 msgid ""
576 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
577 msgstr ""
578 "<guilabel>Python 2/3</guilabel> - Die Hauptskripte wurden in Python "
579 "geschrieben."
580
581 #. (itstool) path: sect2/para
582 #: C/index.docbook:360
583 msgid ""
584 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
585 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
586 msgstr ""
587 "<guilabel>xsltproc</guilabel> - der xslt-Verarbeiter von libxslt <ulink "
588 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
589
590 #. (itstool) path: sect2/para
591 #: C/index.docbook:364
592 msgid ""
593 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
594 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
595 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
596 msgstr ""
597 "<guilabel>docbook-xsl</guilabel> - die docbook xsl-Stilvorlagen <ulink "
598 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
599 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
600
601 #. (itstool) path: sect2/para
602 #: C/index.docbook:368
603 msgid ""
604 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
605 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
606 "examples"
607 msgstr ""
608 "<guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> oder "
609 "<guilabel>vim</guilabel> - optional - für Syntax-Hervorhebung von Beispielen"
610
611 #. (itstool) path: sect1/title
612 #: C/index.docbook:376
613 msgid "About GTK-Doc"
614 msgstr "Info zu GTK-Doc"
615
616 #. (itstool) path: sect1/para
617 #: C/index.docbook:378
618 msgid ""
619 "Historically GTK-Doc was used to generate template files from the sources "
620 "code. These template files could be used by developers to enter the API "
621 "documentation. This approach was rather inconvenient because it required to "
622 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
623 "possible to place all API information into source comments, which made the "
624 "template support obsolete. In version 1.26 template support has been removed."
625 msgstr ""
626 "In der Vergangenheit wurde GTK-Doc zur Erstellung von Vorlagendateien aus "
627 "dem Quellcode verwendet. Diese Vorlagendateien konnten von Entwicklern zur "
628 "Eingabe der API-Dokumentation verwendet werden. Jedoch war dieser Ansatz "
629 "eher unbequem, weil die erzeugten Dateien unter Versionskontrolle gehalten "
630 "werden mussten. Ab GTK-Doc 1.9 wurde es möglich, sämtliche API-Informationen "
631 "in Quellcode-Kommentaren zu platzieren, wodurch die Unterstützung für "
632 "Vorlagen obsolet wurde. In der Version 1.26 wurde die Vorlagenunterstützung "
633 "gänzlich entfernt."
634
635 #. (itstool) path: sect1/para
636 #: C/index.docbook:388 C/index.docbook:402
637 msgid "(FIXME)"
638 msgstr "(FIXME)"
639
640 #. (itstool) path: sect1/para
641 #: C/index.docbook:392
642 msgid ""
643 "(authors, web pages, mailing list, license, future plans, comparison with "
644 "other similar systems.)"
645 msgstr ""
646 "(Autoren, Webseiten, Mailingliste, Lizenz, Zukunftspläne, Vergleich mit "
647 "ähnlichen Systemen)"
648
649 #. (itstool) path: sect1/title
650 #: C/index.docbook:400
651 msgid "About this Manual"
652 msgstr "Über dieses Handbuch"
653
654 #. (itstool) path: sect1/para
655 #: C/index.docbook:406
656 msgid "(who it is meant for, where you can get it, license)"
657 msgstr "(wofür es bestimmt ist, wo Sie es erhalten können, Lizenz)"
658
659 #. (itstool) path: chapter/title
660 #: C/index.docbook:415
661 msgid "Project Setup"
662 msgstr "Einrichtung in einem Projekt"
663
664 #. (itstool) path: chapter/para
665 #: C/index.docbook:417
666 msgid ""
667 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
668 "into your project. The integration of GTK-Doc into a project includes the "
669 "following steps:"
670 msgstr ""
671 "Dieses Kapitel beschreibt die notwendigen Schritte, um GTK-Doc in Ihr "
672 "Projekt zu integrieren. Im einzelnen sind dies folgende Schritte:"
673
674 #. (itstool) path: listitem/para
675 #: C/index.docbook:425
676 msgid ""
677 "Preparation of the directory structure and creating required configuration "
678 "files for your GTK-Doc documentation (see <link "
679 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
680 msgstr ""
681 "Vorbereitung der Ordnerstruktur und Erstellung der erforderlichen "
682 "Konfigurationsdateien für Ihre GTK-Doc-Dokumentation (siehe <link "
683 "linkend=\"settingup_docfiles\">Einrichten des Grundgerüsts der "
684 "Dokumentation</link>)."
685
686 #. (itstool) path: listitem/para
687 #: C/index.docbook:433
688 msgid ""
689 "Adjusting the build system to build your documentation using the GTK-Doc "
690 "tools. Multiple build systems are supported, in this manual we describe how "
691 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
692 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link "
693 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
694 msgstr ""
695 "Anpassen des Erstellungssystems, sodass Ihre Dokumentation durch die "
696 "Werkzeuge von GTK-Doc erstellt wird. Es werden mehrere Erstellungssysteme "
697 "unterstützt. In diesem Handbuch beschreiben wir die Integration von GTK-Doc "
698 "in <link linkend=\"settingup_autotools\">Autotools</link>, <link "
699 "linkend=\"settingup_cmake\">CMake</link> und <link "
700 "linkend=\"settingup_plain_makefiles\">einfache Makefiles</link>."
701
702 #. (itstool) path: listitem/para
703 #: C/index.docbook:443
704 msgid ""
705 "Adding GTK-Doc specific files to version control and deciding which files to "
706 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
707 "control systems</link>)."
708 msgstr ""
709 "Hinzufügen GTK-Doc-spezifischer Dateien zur Versionsverwaltung, wobei zu "
710 "entscheiden ist, welche Dateien ignoriert werden sollen (siehe <link "
711 "linkend=\"settingup_vcs\">Integration in Versionsverwaltungssysteme</link>)."
712
713 #. (itstool) path: chapter/para
714 #: C/index.docbook:451
715 msgid ""
716 "The following sections assume we work on a project called <code>meep</code>. "
717 "This project contains two packages (or modules), a library called "
718 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
719 msgstr ""
720 "In den folgenden Abschnitten wird ein fiktives Projekt namens <code>meep</"
721 "code> angenommen, an dem wir arbeiten. Das Projekt enthält zwei Pakete (oder "
722 "Module), eine Bibliothek namens <code>libmeep</code> und eine Endbenutzer-"
723 "Anwendung namens <code>meeper</code>."
724
725 #. (itstool) path: sect1/title
726 #: C/index.docbook:460
727 msgid "Setting up a skeleton documentation"
728 msgstr "Einrichten des Grundgerüsts der Dokumentation"
729
730 #. (itstool) path: sect1/para
731 #: C/index.docbook:462
732 msgid ""
733 "A common convention is to place documentation into a folder called "
734 "<code>docs</code> inside your top-level project directory. We usually "
735 "distinguish between <emphasis>reference documentation</emphasis> intended "
736 "for developers and an <emphasis>user manual</emphasis> intended for end-"
737 "users. Again the convention is to have separate folders for both. We usually "
738 "place the reference documentation in a folder named <code>reference</code> "
739 "and the end-user manual in a folder named <code>help</code> as. According to "
740 "the above convention the documentation for our <code>libmeep</code> package "
741 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
742 "just one library or application the documentation could also be placed "
743 "directly into <code>docs/reference</code>. It is not mandatory to use the "
744 "above convention, but if you choose to use a different directory structure "
745 "you must adjust your build system configuration to match your directory "
746 "structure."
747 msgstr ""
748 "Üblicherweise wir die Dokumentation in einem Ordner namens <code>docs</code> "
749 "in der obersten Ebene Ihres Projektordners platziert. Wir unterscheiden "
750 "stets zwischen der für Entwickler bestimmten "
751 "<emphasis>Referenzdokumentation</emphasis> und dem "
752 "<emphasis>Benutzerhandbuch</emphasis>, das sich an Endbenutzer richtet. Es "
753 "ist wiederum üblich, dass für beide Werke getrennte Ordner verwendet werden. "
754 "Wir legen die Referenzdokumentation in einem Ordner namens <code>reference</"
755 "code> und das Benutzerhandbuch in <code>help</code>. Nach der oben gennanten "
756 "Konvention würde dann die Dokumentation für unser <code>libmeep</code>-Paket "
757 "in <code>docs/reference/libmeep</code> platziert werden. Bei Paketen, die "
758 "nur eine Bibliothek oder Anwendung enthalten, kann die Dokumentation auch "
759 "direkt in <code>docs/reference</code> abgelegt werden. Es ist nicht "
760 "obligatorisch, genau nach diesem Schema vorzugehen, aber wenn Sie von dieser "
761 "Ordnerstruktur abweichen, müssen Sie die Konfiguration Ihres "
762 "Erstellungssystems entsprechend anpassen."
763
764 #. (itstool) path: example/title
765 #: C/index.docbook:493
766 msgid "Example directory structure of <emphasis>meep</emphasis> project"
767 msgstr "Beispielhafte Ordnerstruktur des <emphasis>meep</emphasis>-Projekts"
768
769 #. (itstool) path: example/programlisting
770 #: C/index.docbook:495
771 #, no-wrap
772 msgid ""
773 "\n"
774 "meep/\n"
775 " docs/\n"
776 " reference/ # reference documentation\n"
777 " libmeep/\n"
778 " meeper/\n"
779 " help/ # optional: user manual\n"
780 " meeper/\n"
781 " src/\n"
782 " libmeep/\n"
783 " meeper/\n"
784 msgstr ""
785 "\n"
786 "meep/\n"
787 " docs/\n"
788 " reference/ # reference documentation\n"
789 " libmeep/\n"
790 " meeper/\n"
791 " help/ # optional: user manual\n"
792 " meeper/\n"
793 " src/\n"
794 " libmeep/\n"
795 " meeper/\n"
796
797 #. (itstool) path: sect1/para
798 #: C/index.docbook:487
799 msgid ""
800 "In the following sections we will assume a directory structure for our "
801 "<emphasis>meep</emphasis> project that uses the above conventions. <_:"
802 "example-1/>"
803 msgstr ""
804 "In den folgenden Abschnitten gehen wir für unser <emphasis>meep</emphasis>-"
805 "Projekt von einer Ordnerstruktur aus, die die oben genannten Konventionen "
806 "berücksichtigt. <_:example-1/>"
807
808 #. (itstool) path: sect1/title
809 #: C/index.docbook:512
810 msgid "Integration with Autotools"
811 msgstr "Integration in Autotools"
812
813 #. (itstool) path: sect1/para
814 #: C/index.docbook:513
815 msgid ""
816 "Integration of GTK-Doc into an autotools-based build system requires the "
817 "following steps:"
818 msgstr ""
819 "Für die Integration von GTK-Doc in ein Autotools-basiertes Projekt sind die "
820 "folgenden Schritte auszuführen:"
821
822 #. (itstool) path: listitem/para
823 #: C/index.docbook:519
824 msgid ""
825 "Ensure that <application>gtkdocize</application> is run once before the "
826 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
827 "script is present, adjust it to check for GTK-Doc and add a call to "
828 "<application>gtkdocize</application>."
829 msgstr ""
830 "Stellen Sie sicher, dass <application>gtkdocize</application> einmal vor dem "
831 "<filename>configure</filename>-Skript ausgeführt wird. Falls es ein "
832 "<filename>autogen.sh</filename>-Skript gibt, passen Sie es so an, dass es "
833 "nach GTK-Doc sucht und einen <application>gtkdocize</application>-Aufruf "
834 "hinzufügt."
835
836 #. (itstool) path: listitem/para
837 #: C/index.docbook:527
838 msgid ""
839 "The main purpose of <application>gtkdocize</application> is to make the "
840 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
841 "filename> macro definition file available to the build system, either by "
842 "copying or linking it into the project."
843 msgstr ""
844 "Der Hauptzweck von <application>gtkdocize</application> ist die Erstellung "
845 "der <filename>gtk-doc.make</filename>-Steuerdatei und der Makro-"
846 "Definitionsdatei <filename>gtk-doc.m4</filename> für das Erstellungssystem, "
847 "entweder durch Kopieren oder Verlinken im Projekt."
848
849 #. (itstool) path: listitem/para
850 #: C/index.docbook:536
851 msgid ""
852 "Add the necessary <application>autoconf</application> macros to "
853 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
854 "allow configuration of GTK-Doc via the generated <filename>configure</"
855 "filename> script."
856 msgstr ""
857 "Fügen Sie die notwendigen <application>autoconf</application>-Makros zu "
858 "<filename>configure.ac</filename> hinzu, um GTK-Doc in Ihrem "
859 "Erstellungssystem zu aktivieren, sodass die Konfiguration von GTK-Doc über "
860 "das erzeugte <filename>configure</filename>-Skript erfolgt."
861
862 # Das hier verstehe ich nicht so recht...
863 # CK: Das Original ist kein richtiges Englisch.
864 #. (itstool) path: listitem/para
865 #: C/index.docbook:542
866 msgid ""
867 "Among others with registers the <code>--enable-gtk-doc</code> option with "
868 "the <filename>configure</filename> script."
869 msgstr ""
870 "Unter anderem wird die Option <code>--enable-gtk-doc</code> mit dem "
871 "<filename>configure</filename>-Skript registriert."
872
873 #. (itstool) path: listitem/para
874 #: C/index.docbook:548
875 msgid ""
876 "Create an <application>automake</application> script for each application or "
877 "library in your project. In the example used in this documentation this step "
878 "applies to both <code>meeper</code> and <code>libmeep</code>."
879 msgstr ""
880 "Erstellen Sie ein <application>automake</application>-Skript für jede "
881 "Anwendung oder Bibliothek in Ihrem Projekt. In dem in dieser Dokumentation "
882 "verwendeten Beispiel wird dieser Schritt sowohl auf <code>meeper</code> als "
883 "auch <code>libmeep</code> angewendet."
884
885 #. (itstool) path: sect1/para
886 #: C/index.docbook:557
887 msgid ""
888 "In the following sections, we will perform the above steps in reverse order. "
889 "We start with the <application>automake</application> scripts and work our "
890 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
891 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
892 "build the documentation."
893 msgstr ""
894 "In den folgenden Abschnitten führen wir die oben beschriebenen Schritte in "
895 "umgekehrter Reihenfolge aus. Wir beginnen mit den <application>automake</"
896 "application>-Skripten und arbeiten uns bis hinauf zu <filename>configure.ac</"
897 "filename> und <filename>autogen.sh</filename>. Dann zeigen wir, wie GTK-Doc "
898 "im Erstellungssystem aktiviert und wie die Dokumentation erstellt wird."
899
900 #. (itstool) path: sect2/title
901 #: C/index.docbook:567
902 msgid "Integration with automake"
903 msgstr "Integration in automake"
904
905 #. (itstool) path: sect2/para
906 #: C/index.docbook:569
907 msgid ""
908 "First copy the <filename>Makefile.am</filename> from the <filename "
909 "class=\"directory\">examples</filename> sub-directory of the <ulink "
910 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile."
911 "am\"> gtkdoc-sources</ulink> to your project's reference documentation "
912 "directory (e.g. <filename class=\"directory\">docs/reference/&lt;package&gt;"
913 "</filename>). A local copy should be available under e.g. <filename>/usr/"
914 "share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If you have "
915 "multiple packages repeat this for each one."
916 msgstr ""
917 "Kopieren Sie zunächst die Datei <filename>Makefile.am</filename> aus dem "
918 "<filename class=\"directory\">examples</filename>-Unterordner der <ulink "
919 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile."
920 "am\">gtkdoc-Quellen</ulink> in den API-Dokumentationsordner Ihres Projekts "
921 "( <filename class=\"directory\">./docs/reference/&lt;package&gt;</"
922 "filename>). Eine lokale Kopie sollte beispielsweise unter <filename>/usr/"
923 "share/doc/gtk-doc-tools/examples/Makefile.am</filename> verfügbar sein. "
924 "Falls Sie mehrere Dokumentationspakete haben, müssen Sie dies für jedes "
925 "davon wiederholen."
926
927 #. (itstool) path: note/simpara
928 #: C/index.docbook:582
929 msgid ""
930 "Do not forget to add each <filename>Makefile.am</filename> to the "
931 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
932 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
933 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
934 "filename> to <function>AC_CONFIG_FILES</function>."
935 msgstr ""
936 "Vergessen Sie nicht, jedes <filename>Makefile.am</filename> zum Makro "
937 "<function>AC_CONFIG_FILES</function> in <filename>configure.ac</filename> "
938 "hinzuzufügen. Für <filename>docs/reference/libmeep/Makefile.am</filename> "
939 "müssen Sie den Eintrag <filename>docs/reference/libmeep/Makefile</filename> "
940 "zu <function>AC_CONFIG_FILES</function> hinzufügen."
941
942 #. (itstool) path: example/title
943 #: C/index.docbook:594
944 msgid "Example directory structure with <filename>Makefiles.am</filename>"
945 msgstr "Beispielhafte Ordnerstruktur mit <filename>Makefiles.am</filename>"
946
947 #. (itstool) path: example/programlisting
948 #: C/index.docbook:597
949 #, no-wrap
950 msgid ""
951 "\n"
952 "meep/\n"
953 " docs/\n"
954 " reference/ # reference documentation\n"
955 " libmeep/\n"
956 " Makefile.am\n"
957 " meeper/\n"
958 " Makefile.am\n"
959 " help/ # optional: user manual\n"
960 " meeper/\n"
961 " src/\n"
962 " libmeep/\n"
963 " meeper/\n"
964 msgstr ""
965 "\n"
966 "meep/\n"
967 " docs/\n"
968 " reference/ # reference documentation\n"
969 " libmeep/\n"
970 " Makefile.am\n"
971 " meeper/\n"
972 " Makefile.am\n"
973 " help/ # optional: user manual\n"
974 " meeper/\n"
975 " src/\n"
976 " libmeep/\n"
977 " meeper/\n"
978
979 #. (itstool) path: sect2/para
980 #: C/index.docbook:613
981 msgid ""
982 "Next, you need to customize the copied Makefiles and provide values for the "
983 "various parameters in each <filename>Makefile.am</filename>. All settings "
984 "have a comment above them that describes their purpose and how to customize "
985 "the setting. Most settings are used to supply extra flags to the respective "
986 "tools to which they apply. Every tool has a variable of the form <option>&lt;"
987 "TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</"
988 "application> has an option named <code>MKHTML_OPTIONS</code>). All the tools "
989 "support <option>--help</option> to list the supported options."
990 msgstr ""
991 "Im nächsten Schritt passen Sie die kopierten Makefiles an und geben Werte "
992 "für die verschiedenen Parameter in jedem <filename>Makefile.am</filename> "
993 "an. Allen Einstellungen ist ein Kommentar vorangestellt, der den jeweiligen "
994 "Zweck beschreibt. Die meisten Einstellungen sind zusätzliche Flags, die an "
995 "verschiedene Werkzeuge übergeben werden. Jedes der Werkzeuge hat eine "
996 "Variable der Form <option>&lt;WERKZEUGNAME&gt;_OPTIONEN</option>. Alle "
997 "Werkzeuge unterstützen <option>--help</option> zur Auflistung der "
998 "unterstützten Parameter."
999
1000 #. (itstool) path: listitem/para
1001 #: C/index.docbook:637
1002 msgid ""
1003 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1004 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1005 msgstr ""
1006 "<option>DOC_MODULE</option> stellt den Namen des Pakets bereit, das "
1007 "dokumentiert werden soll (z.B. <code>meeper</code> oder <code>libmeep</"
1008 "code>)."
1009
1010 #. (itstool) path: listitem/para
1011 #: C/index.docbook:644
1012 msgid ""
1013 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1014 "directory which GTK-Doc searches for your API documentation. This will "
1015 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1016 "directory of that directory."
1017 msgstr ""
1018 "<option>DOC_SOURCE_DIR</option> gibt den Ort des Quellordners an, wo GTK-Doc "
1019 "nach Ihrer API-Dokumentation suchen soll. Üblicherweise ist das <code> "
1020 "DOC_SOURCE_DIR=$(top_srcdir)/src </code> oder einer von dessen Unterordnern."
1021
1022 #. (itstool) path: listitem/para
1023 #: C/index.docbook:657
1024 msgid ""
1025 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1026 "dependencies. Each option take a file-glob (e.g. "
1027 "<code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). The documentation will be "
1028 "rebuilt if any of the matched files change."
1029 msgstr ""
1030 "<option>HFILE_GLOB</option> und <option>CFILE_GLOB</option> werden für "
1031 "Abhängigkeiten verwendet. Jed Option akzeptiert ein file-glob (z.B. "
1032 "<code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). Die Dokumentation wird neu "
1033 "erstellt, wenn sich eine der Dateien ändert."
1034
1035 #. (itstool) path: listitem/para
1036 #: C/index.docbook:669
1037 msgid ""
1038 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1039 "include when scanning for API documentation, which are not found under "
1040 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1041 "extra.h</code>)."
1042 msgstr ""
1043 "Mit <option>EXTRA_HFILES</option> können Sie zusätzliche einzuschließende "
1044 "Header-Dateien angeben, wenn nach API-Dokumentation gesucht wird, falls "
1045 "diese nicht unter <code>DOC_SOURCE_DIR</code> zu finden ist (z.B. <code> "
1046 "EXTRA_HFILES=$(top_srcdir}/contrib/extra.h</code>)."
1047
1048 #. (itstool) path: listitem/para
1049 #: C/index.docbook:679
1050 msgid ""
1051 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1052 "to ignore when scanning for API documentation. Use the basename of the file "
1053 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1054 "private_code_folder</code>)."
1055 msgstr ""
1056 "Mit <option>IGNORE_HFILES</option> können Sie zu ignorierende Header-Dateien "
1057 "angeben, wenn nach API-Dokumentation gesucht wird. Verwenden Sie dabei den "
1058 "Basisnamen der Datei oder des Ordners (z.B. <code> IGNORE_HFILES=gtkdebug.h "
1059 "gtkintl.h private_code_folder</code>)."
1060
1061 #. (itstool) path: listitem/para
1062 #: C/index.docbook:689
1063 msgid ""
1064 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1065 "copied into the <filename>html/</filename> directory of the generated "
1066 "documentation. If your API documentation includes any images they need to be "
1067 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1068 "stock_about_24.png</code>)."
1069 msgstr ""
1070 "In <option>HTML_IMAGES</option> können Sie Bilder angeben, die in den "
1071 "<filename>html/</filename>-Ordner der erzeugten Dokumentation kopiert "
1072 "werden. Falls Ihre API-Dokumentation Bilder enthält, müssen diese zu dieser "
1073 "Option hinzugefügt werden (z.B. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-"
1074 "icons/stock_about_24.png</code>)."
1075
1076 #. (itstool) path: listitem/para
1077 #: C/index.docbook:702
1078 msgid ""
1079 "<option>content_files</option> allows to specify extra files that are "
1080 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1081 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1082 msgstr ""
1083 "In <option>content_files</option> können Sie zusätzliche Dateien angeben, "
1084 "die in <code>$(DOC_MAIN_SGML_FILE)</code> einbezogen werden sollen (z.B. "
1085 "<code> content_files=running.xml building.xml changes-2.0.xml</code>)."
1086
1087 #. (itstool) path: listitem/para
1088 #: C/index.docbook:713
1089 msgid ""
1090 "<option>expand_content_files</option> allows to specify files where "
1091 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1092 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1093 msgstr ""
1094 "In <option>expand_content_files</option> geben Sie Dateien an, in denen "
1095 "<emphasis>gtk-doc Abkürzungen</emphasis> wie <code>#GtkWidget</code> "
1096 "expandiert werden (z.B. <code> expand_content_files=running.xml</code>)."
1097
1098 #. (itstool) path: sect2/para
1099 #: C/index.docbook:631
1100 msgid ""
1101 "The following list explains the most relevant options. Check the example "
1102 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1103 msgstr ""
1104 "In der folgenden Liste werden einige der relevantesten Optionen erläutert. "
1105 "Im Beispiel für <filename>Makefile.am</filename> finden Sie weitere "
1106 "Optionen. <_:itemizedlist-1/>"
1107
1108 #. (itstool) path: sect2/title
1109 #: C/index.docbook:728
1110 msgid "Integration with autoconf"
1111 msgstr "Integration in autoconf"
1112
1113 #. (itstool) path: sect2/para
1114 #: C/index.docbook:730
1115 msgid ""
1116 "Integration with <application>autoconf</application> is very simple and "
1117 "includes one required step and an additional optional (but recommended) "
1118 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1119 "to your <filename>configure.ac</filename> script. This registers several "
1120 "configure options to enable GTK-Doc and allows you to set default arguments "
1121 "for <application>gtkdocize</application>."
1122 msgstr ""
1123 "Die Integration in <application>autoconf</application> ist recht einfach. Es "
1124 "ist nur ein Schritt zwingend erforderlich sowie ein weiterer optional (aber "
1125 "empfehlenswert). Zunächst fügen Sie das Makro <function>GTK_DOC_CHECK</"
1126 "function> zu Ihrem <filename>configure.ac</filename> Skript hinzu. Dadurch "
1127 "werden verschiedene Konfigurationsoptionen zur Aktivierung von GTK-Doc "
1128 "registriert sowie Standardargumente für <application>gtkdocize</application> "
1129 "gesetzt."
1130
1131 #. (itstool) path: warning/simpara
1132 #: C/index.docbook:742
1133 msgid ""
1134 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1135 "macro must start at the beginning of the line and should not start with "
1136 "whitespace."
1137 msgstr ""
1138 "Achten Sie darauf, dass das <code>GTK_DOC_CHECK</code>-Makro nicht "
1139 "eingerückt ist. Es muss zwingend am Anfang der Zeile stehen und sollte nicht "
1140 "mit einem Leerzeichen beginnen."
1141
1142 #. (itstool) path: sect2/para
1143 #: C/index.docbook:749
1144 msgid ""
1145 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1146 "<filename>configure.ac</filename>. This is not required but helps "
1147 "<application>gtkdocize</application> to automatically copy the macro "
1148 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1149 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1150 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1151 "to explicitly tell the <application>aclocal</application> tool where to find "
1152 "the macro definition file."
1153 msgstr ""
1154 "Danach fügen Sie <code>AC_CONFIG_MACRO_DIR(m4)</code> zu Ihrer "
1155 "<filename>configure.ac</filename>-Datei hinzu. Dies ist nicht zwingend "
1156 "erforderlich, aber hilft <application>gtkdocize</application> dabei, die "
1157 "Makrodefinition (e.g <filename>gtk-doc.m4</filename>), welche das Makro "
1158 "<function>GTK_DOC_CHECK</function> enthält, in den Makro-Ordner Ihres "
1159 "Projekts zu kopieren. Wenn Sie diesen Schritt auslassen, könnte das Makro "
1160 "GTK_DOC_CHECK möglicherweise nicht gefunden werden, und Sie müssten den Ort "
1161 "der Makro-Definitionsdatei explizit für <application>aclocal</application> "
1162 "angeben."
1163
1164 #. (itstool) path: example/title
1165 #: C/index.docbook:762
1166 msgid "Minimal integration with autoconf"
1167 msgstr "Minimale Integration in autoconf"
1168
1169 #. (itstool) path: example/programlisting
1170 #: C/index.docbook:763
1171 #, no-wrap
1172 msgid ""
1173 "\n"
1174 "# recommended: set m4 directory\n"
1175 "AC_CONFIG_MACRO_DIR(m4)\n"
1176 "# optional: register gtk-doc in configure\n"
1177 "GTK_DOC_CHECK([1.28])\n"
1178 msgstr ""
1179 "\n"
1180 "# recommended: set m4 directory\n"
1181 "AC_CONFIG_MACRO_DIR(m4)\n"
1182 "# optional: register gtk-doc in configure\n"
1183 "GTK_DOC_CHECK([1.28])\n"
1184
1185 #. (itstool) path: example/title
1186 #: C/index.docbook:778
1187 msgid "Integration with optional gtk-doc dependency"
1188 msgstr "Integration mit optionaler Abhängigkeit zu gtk-doc"
1189
1190 #. (itstool) path: example/programlisting
1191 #: C/index.docbook:779
1192 #, no-wrap
1193 msgid ""
1194 "\n"
1195 "m4_ifdef([GTK_DOC_CHECK], [\n"
1196 "# recommended: set m4 directory\n"
1197 "AC_CONFIG_MACRO_DIR(m4)\n"
1198 "# optional: register gtk-doc in configure\n"
1199 "GTK_DOC_CHECK([1.28])\n"
1200 "],[\n"
1201 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1202 "])\n"
1203 msgstr ""
1204 "\n"
1205 "m4_ifdef([GTK_DOC_CHECK], [\n"
1206 "# recommended: set m4 directory\n"
1207 "AC_CONFIG_MACRO_DIR(m4)\n"
1208 "# optional: register gtk-doc in configure\n"
1209 "GTK_DOC_CHECK([1.28])\n"
1210 "],[\n"
1211 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1212 "])\n"
1213
1214 #. (itstool) path: sect2/para
1215 #: C/index.docbook:772
1216 msgid ""
1217 "The above example works, but will require all developers to have gtk-doc "
1218 "installed. A better way is to make building the documentation optional as "
1219 "shown in the next example: <_:example-1/>"
1220 msgstr ""
1221 "Das obige Beispiel funktioniert, aber es erfordert, dass alle Entwickler gtk-"
1222 "doc installiert haben. Eine bessere Lösung ist die optional Erstellung der "
1223 "Dokumentation, wie das nächste Beispiel zeigt: <_:example-1/>"
1224
1225 #. (itstool) path: sect2/para
1226 #: C/index.docbook:792
1227 msgid ""
1228 "The first argument is used to check for the Gtk-Doc version at configure "
1229 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1230 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1231 "configure switches:"
1232 msgstr ""
1233 "Das erste Argument wird zur Überprüfung von der Version von GTK-Doc während "
1234 "des configure-Durchlaufs benutzt. Das zweite, optionale Argument wird von "
1235 "<application>gtkdocize</application> verwendet. Das Makro "
1236 "<symbol>GTK_DOC_CHECK</symbol> fügt verschiedene Schalter für configure "
1237 "hinzu:"
1238
1239 #. (itstool) path: listitem/para
1240 #: C/index.docbook:801
1241 msgid "--with-html-dir=PATH : path to installed docs"
1242 msgstr "--with-html-dir=PATH : Pfad zur installierten Dokumentation"
1243
1244 #. (itstool) path: listitem/para
1245 #: C/index.docbook:802
1246 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1247 msgstr ""
1248 "--enable-gtk-doc : gtk-doc zur Erstellung der Dokumentation verwenden "
1249 "[Vorgabe=no]"
1250
1251 #. (itstool) path: listitem/para
1252 #: C/index.docbook:803
1253 msgid ""
1254 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1255 msgstr ""
1256 "--enable-gtk-doc-html : Erstellung der Dokumentation im HTML-Format "
1257 "[Vorgabe=yes]"
1258
1259 #. (itstool) path: listitem/para
1260 #: C/index.docbook:804
1261 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1262 msgstr ""
1263 "--enable-gtk-doc-pdf : Erstellung der Dokumentation im PDF-Format "
1264 "[Vorgabe=no]"
1265
1266 #. (itstool) path: important/para
1267 #: C/index.docbook:808
1268 msgid ""
1269 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1270 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1271 "Otherwise pregenerated documentation is installed (which makes sense for "
1272 "users but not for developers)."
1273 msgstr ""
1274 "GTK-Doc ist standardmäßig deaktiviert! Denken Sie daran, die Option "
1275 "<option>'--enable-gtk-doc'</option> beim nächsten Durchlauf von "
1276 "<filename>configure</filename> zu übergeben. Anderenfalls wird die vorher "
1277 "erstellte Dokumentation installiert. Dies ergibt für Benutzer durchaus Sinn, "
1278 "aber nicht für Entwickler."
1279
1280 #. (itstool) path: sect2/para
1281 #: C/index.docbook:816
1282 msgid ""
1283 "After all changes to <filename>configure.ac</filename> are made, update the "
1284 "<filename>configure</filename> file. This can be done by re-running "
1285 "<code>autogen.sh</code>."
1286 msgstr ""
1287 "Nachdem alle Änderungen auf <filename>configure.ac</filename> angewendet "
1288 "wurden, aktualisieren Sie die Datei <filename>configure</filename>. Dies "
1289 "geschieht durch erneutes Ausführen von <code>autogen.sh</code>."
1290
1291 #. (itstool) path: sect2/title
1292 #: C/index.docbook:824
1293 msgid "Integration with autogen"
1294 msgstr "Integration in autogen"
1295
1296 #. (itstool) path: sect2/para
1297 #: C/index.docbook:826
1298 msgid ""
1299 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1300 "the build infrastructure after the project was checked out from a version "
1301 "control system (such as git or svn). GTK-Doc comes with a script called "
1302 "<application>gtkdocize</application> which can be used to copy the necessary "
1303 "files needed by Gtk-Doc to the source directory."
1304 msgstr ""
1305 "Die meisten Projekte dürften über ein <filename>autogen.sh</filename>-Skript "
1306 "verfügen, welches die Build-Infrastruktur nach dem Auschecken aus einem "
1307 "Versionsverwaltungssystem wie SVN oder Git erzeugt. GTK-Doc liefert ein "
1308 "Werkzeug namens <application>gtkdocize</application> mit, das zum Kopieren "
1309 "der für GTK-Doc erforderlichen Dateien in den Quellordner verwendet werden "
1310 "kann."
1311
1312 #. (itstool) path: sect2/para
1313 #: C/index.docbook:834
1314 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1315 msgstr ""
1316 "Es sollte vor autoreconf, autoheader, automake oder autoconf ausgeführt "
1317 "werden."
1318
1319 #. (itstool) path: example/title
1320 #: C/index.docbook:839
1321 msgid "Running gtkdocize from autogen.sh"
1322 msgstr "Ausführen von gtkdocize durch autogen.sh"
1323
1324 #. (itstool) path: example/programlisting
1325 #: C/index.docbook:840
1326 #, no-wrap
1327 msgid ""
1328 "\n"
1329 "gtkdocize || exit 1\n"
1330 msgstr ""
1331 "\n"
1332 "gtkdocize || exit 1\n"
1333
1334 #. (itstool) path: example/title
1335 #: C/index.docbook:848
1336 msgid "Conditionally run gtkdocize from autogen.sh"
1337 msgstr "Bedingtes Ausführen von gtkdocize durch autogen.sh"
1338
1339 #. (itstool) path: example/programlisting
1340 #: C/index.docbook:849
1341 #, no-wrap
1342 msgid ""
1343 "\n"
1344 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1345 "if test $? -ne 0; then\n"
1346 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1347 "else\n"
1348 " $GTKDOCIZE || exit 1\n"
1349 "fi\n"
1350 msgstr ""
1351 "\n"
1352 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1353 "if test $? -ne 0; then\n"
1354 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1355 "else\n"
1356 " $GTKDOCIZE || exit 1\n"
1357 "fi\n"
1358
1359 #. (itstool) path: sect2/para
1360 #: C/index.docbook:860
1361 msgid ""
1362 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1363 "doc.make</filename> to your project root (or any directory specified by the "
1364 "<option>--docdir</option> option)."
1365 msgstr ""
1366 "Beim Ausführen von <application>gtkdocize</application> wird <filename>gtk-"
1367 "doc.make</filename> in die Wurzel Ihres Projekts oder in jeden anderen durch "
1368 "die Option <option>--docdir</option> festgelegten Ordner kopiert."
1369
1370 #. (itstool) path: sect2/para
1371 #: C/index.docbook:866
1372 msgid ""
1373 "<application>gtkdocize</application> checks your <filename>configure.ac</"
1374 "filename> script for the <function>GTK_DOC_CHECK</function> macro. The "
1375 "<function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments "
1376 "to the <application>gtkdocize</application> script. the 2nd parameter in the "
1377 "<function>GTK_DOC_CHECK</function> macro."
1378 msgstr ""
1379 "<application>gtkdocize</application> überprüft das <filename>configure.ac</"
1380 "filename>-Skript daraufhin, ob <function>GTK_DOC_CHECK</function> enthalten "
1381 "ist. Dieses Makro kann verwendet werden, um weitere Parameter an "
1382 "<application>gtkdocize</application> zu übergeben, den zweiten Parameter im "
1383 "<function>GTK_DOC_CHECK</function>-Makro."
1384
1385 #. (itstool) path: sect2/para
1386 #: C/index.docbook:875
1387 msgid ""
1388 "Alternatively, additional arguments can also be passed to "
1389 "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</"
1390 "function> environment variable, or by directly specifying them to "
1391 "<application>gtkdocize</application> in <filename>autogen.sh</filename>."
1392 msgstr ""
1393 "Alternativ können zusätzliche Argumente auch über die Umgebungsvariable "
1394 "<function>GTKDOCIZE_FLAGS</function> an <application>gtkdocize</application> "
1395 "übergeben werden, oder durch direktes Anfügen an <application>gtkdocize</"
1396 "application> in <filename>autogen.sh</filename>."
1397
1398 #. (itstool) path: sect2/title
1399 #: C/index.docbook:886
1400 msgid "Executing GTK-Doc from the Build System"
1401 msgstr "Aufruf von GTK-Doc aus dem Erstellungssystem heraus"
1402
1403 #. (itstool) path: sect2/para
1404 #: C/index.docbook:888
1405 msgid ""
1406 "After the previous steps it's time to run the build. First we need to rerun "
1407 "<filename>autogen.sh</filename>. If this script runs configure for you, then "
1408 "give it the <option>--enable-gtk-doc</option> option. Otherwise manually run "
1409 "<filename>configure</filename> with this option afterwards."
1410 msgstr ""
1411 "Nach den bisher absolvierten Schritten ist es Zeit für den Build-Vorgang. "
1412 "Zunächst muss <filename>autogen.sh</filename> erneut ausgeführt werden. "
1413 "Falls dieses Skript auch den configure-Aufruf enthält, sollten Sie die "
1414 "Option <option>--enable-gtk-doc</option> hinzufügen. Anderenfalls führen Sie "
1415 "danach <filename>configure</filename> manuell aus, ebenfalls mit dieser "
1416 "Option."
1417
1418 #. (itstool) path: sect2/para
1419 #: C/index.docbook:895
1420 msgid ""
1421 "The first make run generates several additional files in the doc-"
1422 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1423 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past ."
1424 "sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1425 msgstr ""
1426 "Der erste Durchlauf von make erstellt verschiedene zusätzliche Dateien in "
1427 "den Dokumentationsordnern. Die bedeutendsten davon sind: <filename>&lt;"
1428 "package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> "
1429 "(früher .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1430
1431 #. (itstool) path: example/title
1432 #: C/index.docbook:903
1433 msgid "Running the doc build"
1434 msgstr "Erstellung der Dokumentation"
1435
1436 #. (itstool) path: example/programlisting
1437 #: C/index.docbook:904
1438 #, no-wrap
1439 msgid ""
1440 "\n"
1441 "./autogen.sh --enable-gtk-doc\n"
1442 "make\n"
1443 msgstr ""
1444 "\n"
1445 "./autogen.sh --enable-gtk-doc\n"
1446 "make\n"
1447
1448 #. (itstool) path: sect2/para
1449 #: C/index.docbook:911
1450 msgid ""
1451 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1452 "index.html</filename>. With this initial setup you will only see a very "
1453 "simple document. The next chapter will teach you how to add API "
1454 "documentation to your code via special comment blocks. The Chapter "
1455 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1456 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1457 "template</link> to add additional chapters and sections to your "
1458 "documentation files."
1459 msgstr ""
1460 "Nun können Sie Ihren Browser auf <filename>docs/reference/&lt;package&gt;/"
1461 "index.html</filename> stellen. Mit dieser initialen Einrichtung werden Sie "
1462 "allerdings nur ein sehr simples Dokument sehen. Im nächsten Kapitel "
1463 "erläutern wir, wie Sie API-Dokumentation mittels spezieller Kommentarblöcke "
1464 "in Ihren Code einbauen können. Das Kapitel danach führt in <link "
1465 "linkend=\"metafiles\">zusätzliche Dateien</link> ein und zeigt, wie die "
1466 "<link linkend=\"metafiles_master\">Master-Vorlage</link> bearbeitet wird, um "
1467 "zusätzliche Kapitel und Abschnitte zu Ihren Dokumentationsdateien "
1468 "hinzuzufügen."
1469
1470 #. (itstool) path: sect1/title
1471 #: C/index.docbook:927
1472 msgid "Integration with CMake build systems"
1473 msgstr "Integration in CMake-Erstellungssysteme"
1474
1475 #. (itstool) path: sect1/para
1476 #: C/index.docbook:929
1477 msgid ""
1478 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1479 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1480 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1481 "set in your <filename>CMakeLists.txt</filename> file."
1482 msgstr ""
1483 "GTK-Doc stellt nun ein <filename>GtkDocConfig.cmake</filename>-Modul (und "
1484 "das korrespondierende <filename>GtkDocConfigVersion.cmake</filename>-Modul) "
1485 "bereit. Dadurch steht Ihnen der Befehl <literal>gtk_doc_add_module</literal> "
1486 "zur Verfügung, den Sie in die Datei <filename>CMakeLists.txt</filename> "
1487 "integrieren können."
1488
1489 #. (itstool) path: example/title
1490 #: C/index.docbook:939
1491 msgid "Example of using GTK-Doc from CMake"
1492 msgstr "Beispiel zur Verwendung von GTK-Doc mit CMake"
1493
1494 #. (itstool) path: example/programlisting
1495 #: C/index.docbook:940
1496 #, no-wrap
1497 msgid ""
1498 "\n"
1499 "find_package(GtkDoc 1.25 REQUIRED)\n"
1500 "\n"
1501 "# Create the doc-libmeep target.\n"
1502 "gtk_doc_add_module(\n"
1503 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1504 " XML meep-docs.xml\n"
1505 " LIBRARIES libmeep\n"
1506 ")\n"
1507 "\n"
1508 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1509 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1510 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1511 "\n"
1512 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1513 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1514 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1515 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1516 msgstr ""
1517 "\n"
1518 "find_package(GtkDoc 1.25 REQUIRED)\n"
1519 "\n"
1520 "# Create the doc-libmeep target.\n"
1521 "gtk_doc_add_module(\n"
1522 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1523 " XML meep-docs.xml\n"
1524 " LIBRARIES libmeep\n"
1525 ")\n"
1526 "\n"
1527 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1528 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1529 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1530 "\n"
1531 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1532 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1533 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1534 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1535
1536 #. (itstool) path: sect1/para
1537 #: C/index.docbook:937
1538 msgid "The following example shows how to use this command. <_:example-1/>"
1539 msgstr ""
1540 "Das folgende Beispiel zeigt, wie dieser Befehl eingesetzt wird. <_:example-1/"
1541 ">"
1542
1543 #. (itstool) path: sect1/title
1544 #: C/index.docbook:964
1545 msgid "Integration with plain makefiles or other build systems"
1546 msgstr "Integration in Klartext-Makefiles oder andere Erstellungssysteme"
1547
1548 #. (itstool) path: sect1/para
1549 #: C/index.docbook:966
1550 msgid ""
1551 "In the case one does not want to use automake and therefore <filename>gtk-"
1552 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1553 "in own makefiles (or other build tools)."
1554 msgstr ""
1555 "Für den Fall, dass jemand nicht automake und damit <filename>gtk-doc.mak</"
1556 "filename> einsetzen will, muss man die gtkdoc-Werkzeuge in eigenen Makefiles "
1557 "(oder andere Werkzeugen) in der richtigen Reihenfolge aufrufen."
1558
1559 #. (itstool) path: example/title
1560 #: C/index.docbook:973
1561 msgid "Documentation build steps"
1562 msgstr "Schritte zur Erstellung der Dokumentation"
1563
1564 #. (itstool) path: example/programlisting
1565 #: C/index.docbook:974
1566 #, no-wrap
1567 msgid ""
1568 "\n"
1569 "DOC_MODULE=meep\n"
1570 "// sources have changed\n"
1571 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1572 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1573 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1574 "// xml files have changed\n"
1575 "mkdir html\n"
1576 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1577 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1578 msgstr ""
1579 "\n"
1580 "DOC_MODULE=meep\n"
1581 "// sources have changed\n"
1582 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1583 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1584 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1585 "// xml files have changed\n"
1586 "mkdir html\n"
1587 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1588 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1589
1590 #. (itstool) path: sect1/para
1591 #: C/index.docbook:988
1592 msgid ""
1593 "One will need to look at the <filename>Makefile.am</filename> and "
1594 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1595 msgstr ""
1596 "Man muss sich <filename>Makefile.am</filename> und <filename>gtk-doc.mak</"
1597 "filename> anschauen, um die zusätzlich notwendigen Optionen herauszusuchen."
1598
1599 #. (itstool) path: sect1/title
1600 #: C/index.docbook:995
1601 msgid "Integration with version control systems"
1602 msgstr "Integration in Versionsverwaltungssysteme"
1603
1604 #. (itstool) path: sect1/para
1605 #: C/index.docbook:997
1606 msgid ""
1607 "As a rule of thumb, it's the files you edit which should go under version "
1608 "control. For typical projects it's these files: <filename>&lt;package&gt;."
1609 "types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1610 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, "
1611 "<filename>Makefile.am</filename>."
1612 msgstr ""
1613 "Als Faustregel gilt, dass alle von Ihnen bearbeiteten Dateien auch unter "
1614 "Versionsverwaltung stehen sollten. In typischen Projekten sind das folgende "
1615 "Dateien: <filename>&lt;package&gt;.types</filename>, <filename>&lt;"
1616 "package&gt;-docs.xml</filename> (früher .sgml), <filename>&lt;package&gt;-"
1617 "sections.txt</filename>, <filename>Makefile.am</filename>."
1618
1619 #. (itstool) path: sect1/para
1620 #: C/index.docbook:1005
1621 msgid ""
1622 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1623 "directories should not go under version control. Neither should any of the "
1624 "<filename>.stamp</filename> files."
1625 msgstr ""
1626 "Dateien in den Ordnern <filename>xml/</filename> und <filename>html/</"
1627 "filename> sollten nicht unter Versionsverwaltung gestellt werden, ebenso "
1628 "keine der <filename>.stamp</filename>-Dateien."
1629
1630 #. (itstool) path: chapter/title
1631 #: C/index.docbook:1015
1632 msgid "Documenting the code"
1633 msgstr "Dokumentieren des Codes"
1634
1635 #. (itstool) path: chapter/para
1636 #: C/index.docbook:1017
1637 msgid ""
1638 "GTK-Doc uses source code comment with a special syntax for code "
1639 "documentation. Further it retrieves information about your project structure "
1640 "from other sources. During the next section you will find all information "
1641 "about the syntax of the comments."
1642 msgstr ""
1643 "GTK-Doc benutzt Quellcode-Kommentare mit einer speziellen Syntax für Code-"
1644 "Dokumentation. Weiterhin werden Informationen über Ihre Projektstruktur aus "
1645 "anderen Quellen geholt. Im nächsten Abschnitt finden Sie umfassende "
1646 "Informationen über die Syntax der Kommentare."
1647
1648 #. (itstool) path: example/title
1649 #: C/index.docbook:1028 C/index.docbook:1054
1650 msgid "GTK-Doc comment block"
1651 msgstr "GTK-Doc-Kommentarblock"
1652
1653 #. (itstool) path: example/programlisting
1654 #: C/index.docbook:1029
1655 #, no-wrap
1656 msgid ""
1657 "\n"
1658 "#ifndef __GTK_DOC_IGNORE__\n"
1659 "/* unparseable code here */\n"
1660 "#endif\n"
1661 msgstr ""
1662 "\n"
1663 "#ifndef __GTK_DOC_IGNORE__\n"
1664 "/* unparseable code here */\n"
1665 "#endif\n"
1666
1667 #. (itstool) path: chapter/para
1668 #: C/index.docbook:1024
1669 msgid ""
1670 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1671 "of receiving warnings from the scanner that look like a special case, one "
1672 "can hint GTK-Doc to skip over them. <_:example-1/>"
1673 msgstr ""
1674 "Der Scanner von GTK-Doc kann mit den meisten C-Kopfdateien umgehen. Im Falle "
1675 "von Warnungen des Scanners, die wie ein Spezialfall aussehen, kann man GTK-"
1676 "Doc anweisen, diese zu überspringen. <_:example-1/>"
1677
1678 #. (itstool) path: note/title
1679 #: C/index.docbook:1038
1680 msgid "Limitations"
1681 msgstr "Einschränkungen"
1682
1683 #. (itstool) path: note/para
1684 #: C/index.docbook:1039
1685 msgid ""
1686 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1687 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1688 msgstr ""
1689 "Beachten Sie, dass GTK-Doc zwar <code>#ifndef(__GTK_DOC_IGNORE__)</code> "
1690 "unterstützt, aber nicht <code>#if !defined(__GTK_DOC_IGNORE__)</code> oder "
1691 "andere Kombinationen."
1692
1693 #. (itstool) path: sect1/title
1694 #: C/index.docbook:1049
1695 msgid "Documentation comments"
1696 msgstr "Kommentare zur Dokumentation"
1697
1698 #. (itstool) path: example/programlisting
1699 #: C/index.docbook:1055
1700 #, no-wrap
1701 msgid ""
1702 "\n"
1703 "/**\n"
1704 " * identifier:\n"
1705 " * documentation ...\n"
1706 " */\n"
1707 msgstr ""
1708 "\n"
1709 "/**\n"
1710 " * identifier:\n"
1711 " * documentation ...\n"
1712 " */\n"
1713
1714 #. (itstool) path: sect1/para
1715 #: C/index.docbook:1051
1716 msgid ""
1717 "A multiline comment that starts with an additional '*' marks a documentation "
1718 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1719 msgstr ""
1720 "Ein mehrzeiliger Kommentar, der mit einem zusätzlichen »*« beginnt, markiert "
1721 "einen Kommentarblock, der von den Werkzeugen in GTK-Doc verarbeitet wird. <_:"
1722 "example-1/>"
1723
1724 #. (itstool) path: sect1/para
1725 #: C/index.docbook:1064
1726 msgid ""
1727 "The 'identifier' is one line with the name of the item the comment is "
1728 "related to. The syntax differs a little depending on the item. (TODO add "
1729 "table showing identifiers)"
1730 msgstr ""
1731 "Der »identifier« ist eine Zeile mit dem Namen des Objekts, auf das sich der "
1732 "Kommentar bezieht. Die Syntax kann abhängig von der Art des Objekts "
1733 "variieren."
1734
1735 #. (itstool) path: sect1/para
1736 #: C/index.docbook:1070
1737 msgid ""
1738 "The 'documentation' block is also different for each symbol type. Symbol "
1739 "types that get parameters such as functions or macros have the parameter "
1740 "description first followed by a blank line (just a '*'). Afterwards follows "
1741 "the detailed description. All lines (outside program listings and CDATA "
1742 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1743 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1744 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1745 msgstr ""
1746 "Der Block »documentation« ist ebenfalls für jeden Symboltyp unterschiedlich. "
1747 "Symboltypen mit Parametern wie Funktionen oder Makros haben eine "
1748 "Parameterbeschreibung, auf die eine leere Zeile folgt (keine echte "
1749 "Leerzeile, sondern ein »*«). Danach folgt eine detaillierte Beschreibung. "
1750 "Alle Zeilen (außerhalb von Programmlistings und CDATA-Abschnitten), die nur "
1751 "ein » *« (Leerzeichen-Asterisk) enthalten, werden in Absatzumbrüche "
1752 "umgewandelt. Falls Sie keinen Absatzumbruch wünschen, verwenden Sie "
1753 "stattdessen ein » * «, d.h. setzen Sie ein Leerzeichen jeweils davor und "
1754 "dahinter. Dies ist in vorformatiertem Text nützlich (Code-Auflistungen)."
1755
1756 #. (itstool) path: listitem/para
1757 #: C/index.docbook:1087
1758 msgid ""
1759 "What it is: The name for a class or function can sometimes be misleading for "
1760 "people coming from a different background."
1761 msgstr ""
1762 "Was es ist: Der Name für eine Klasse oder Funktion kann manchmal irreführend "
1763 "sein für Personen, die einen anderen Hintergrund haben."
1764
1765 #. (itstool) path: listitem/para
1766 #: C/index.docbook:1093
1767 msgid ""
1768 "What it does: Tell about common uses. Put it in relation with the other API."
1769 msgstr ""
1770 "Was es ist: Berichtet über normale Anwendungsfälle. Stellen Sie es ins "
1771 "Verhältnis mit der anderen API."
1772
1773 #. (itstool) path: tip/para
1774 #: C/index.docbook:1083
1775 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1776 msgstr ""
1777 "Beim Dokumentieren von Code beschreiben Sie zwei Aspekte: <_:itemizedlist-1/>"
1778
1779 #. (itstool) path: listitem/para
1780 #: C/index.docbook:1108
1781 msgid "Use function() to refer to functions or macros which take arguments."
1782 msgstr ""
1783 "Verwenden Sie function(), um einen Bezug zu Funktionen oder Makros "
1784 "herzustellen, die Argumente akzeptieren."
1785
1786 #. (itstool) path: listitem/para
1787 #: C/index.docbook:1113
1788 msgid ""
1789 "Use @param to refer to parameters. Also use this when referring to "
1790 "parameters of other functions, related to the one being described."
1791 msgstr ""
1792 "Verwenden Sie @param, um einen Bezug zu Parametern herzustellen. Verwenden "
1793 "Sie dies auch, wenn es um einen Bezug zu Parametern anderer Funktionen geht, "
1794 "bezogen auf jene, die Sie gerade beschreiben."
1795
1796 #. (itstool) path: listitem/para
1797 #: C/index.docbook:1119
1798 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1799 msgstr ""
1800 "Benutzen Sie %constant, um einen Bezug auf eine Konstante herzustellen, z.B. "
1801 "%G_TRAVERSE_LEAFS."
1802
1803 #. (itstool) path: listitem/para
1804 #: C/index.docbook:1124
1805 msgid ""
1806 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1807 "macros which don't take arguments."
1808 msgstr ""
1809 "Verwenden Sie #symbol, um auf andere Symboltypen zu verweisen, z.B. "
1810 "»structs« und »enums« und Makros, die keine Argumente benötigen."
1811
1812 #. (itstool) path: listitem/para
1813 #: C/index.docbook:1130
1814 msgid "Use #Object::signal to refer to a GObject signal."
1815 msgstr "Verwenden Sie #Object::signal, um auf ein GObject-Signal zu verweisen."
1816
1817 #. (itstool) path: listitem/para
1818 #: C/index.docbook:1135
1819 msgid "Use #Object:property to refer to a GObject property."
1820 msgstr ""
1821 "Verwenden Sie #Object:property, um auf eine GObject-Eigenschaft zu verweisen."
1822
1823 #. (itstool) path: listitem/para
1824 #: C/index.docbook:1140
1825 msgid ""
1826 "Use #Struct.field to refer to a field inside a structure and #GObjectClass."
1827 "foo_bar() to refer to a vmethod."
1828 msgstr ""
1829 "Verwenden Sie #Struct.field, um auf ein Feld innerhalb einer Struktur zu "
1830 "verweisen und #GObjectClass.foo_bar() für eine vmethod."
1831
1832 #. (itstool) path: sect1/para
1833 #: C/index.docbook:1102
1834 msgid ""
1835 "One advantage of hyper-text over plain-text is the ability to have links in "
1836 "the document. Writing the correct markup for a link can be tedious though. "
1837 "GTK-Doc comes to help by providing several useful abbreviations. <_:"
1838 "itemizedlist-1/>"
1839 msgstr ""
1840 "Ein Vorteil von Hypertext gegenüber Klartext ist die Möglichkeit, "
1841 "Verknüpfungen im Dokument zu verwenden. Das Schreiben eines korrekten "
1842 "Markups für eine solche Verknüpfung kann allerdings langatmig sein, deshalb "
1843 "stellt GTK-Doc eine Reihe von praktischen Abkürzungen bereit. <_:"
1844 "itemizedlist-1/>"
1845
1846 #. (itstool) path: tip/para
1847 #: C/index.docbook:1149
1848 msgid ""
1849 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1850 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1851 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", \"&amp;"
1852 "commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape them "
1853 "with a backslash '\\'."
1854 msgstr ""
1855 "Falls Sie die Sonderzeichen »&lt;«, »&gt;«, »()«, »@«, »%« oder »#« in Ihrer "
1856 "Dokumentation verwenden wollen, ohne dass GTK-Doc diese ändert, können Sie "
1857 "die XML-Entitäten »&amp;lt;«, »&amp;gt;«, »&amp;lpar;«, »&amp;rpar;«, »&amp;"
1858 "commat;«, »&amp;percnt;« und »&amp;num;« verwenden oder die Zeichen mit "
1859 "einem Backslash »\\« maskieren."
1860
1861 #. (itstool) path: sect1/para
1862 #: C/index.docbook:1158
1863 msgid ""
1864 "DocBook can do more than just links. One can also have lists, examples, "
1865 "headings, and images. As of version 1.20, the preferred way is to use a "
1866 "subset of the basic text formatting syntax called <ulink url=\"http://"
1867 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1868 "versions any documentation that includes Markdown will be rendered as is. "
1869 "For example, list items will appear as lines starting with a dash."
1870 msgstr ""
1871 "DocBook kann mehr als nur Verweise zu erzeugen. Sie können Listen, "
1872 "Beispiele, Überschriften und Bilder einfügen. In Version 1.20 ist der "
1873 "bevorzugte Weg, ein Subset grundlegender Textformatierungssyntax namens "
1874 "<ulink url=\"http://daringfireball.net/projects/markdown/\">Markdown</ulink> "
1875 "zu verwenden. In älteren Versionen von GTK-Doc wird jede Dokumentation, die "
1876 "Markdown enthält, unverändert gerendert. Zum Beispiel erscheinen "
1877 "Listenobjekte als Zeilen, die mit einem Gedankenstrich beginnen."
1878
1879 #. (itstool) path: sect1/para
1880 #: C/index.docbook:1169
1881 msgid ""
1882 "While markdown is now preferred one can mix both. One limitation here is "
1883 "that one can use docbook xml within markdown, but markdown within docbook "
1884 "xml is not supported."
1885 msgstr ""
1886 "Wenngleich Markdown bevorzugt wird, können Sie beide Formate mischen. Eine "
1887 "Einschränkung ist jedoch, dass Sie DocBook XML innerhalb von Markdown "
1888 "verwenden können, während Markdown in DocBook XML nicht unterstützt wird."
1889
1890 #. (itstool) path: sect1/para
1891 #: C/index.docbook:1175
1892 msgid ""
1893 "In older GTK-Doc releases, if you need support for additional formatting, "
1894 "you would need to enable the usage of docbook XML tags inside doc-comments "
1895 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1896 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1897 "filename>."
1898 msgstr ""
1899 "Um die Nutzung der DocBook-XML-Markierungen innerhalb der "
1900 "Dokumentationskommentare zu aktivieren, übergeben Sie der Variable "
1901 "<symbol>MKDB_OPTIONS</symbol> in der Datei <filename>Makefile.am</filename> "
1902 "die Option <option>--xml-mode</option> (oder <option>--sgml-mode</option>)."
1903
1904 #. (itstool) path: example/title
1905 #: C/index.docbook:1184
1906 msgid "GTK-Doc comment block using Markdown"
1907 msgstr "GTK-Doc-Kommentarblock in Markdown-Syntax"
1908
1909 #. (itstool) path: example/programlisting
1910 #: C/index.docbook:1185
1911 #, no-wrap
1912 msgid ""
1913 "\n"
1914 "/**\n"
1915 " * identifier:\n"
1916 " *\n"
1917 " * documentation paragraph ...\n"
1918 " *\n"
1919 " * # Sub Heading #\n"
1920 " *\n"
1921 " * ## Second Sub Heading\n"
1922 " *\n"
1923 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1924 " *\n"
1925 " * more documentation:\n"
1926 " *\n"
1927 " * - list item 1\n"
1928 " *\n"
1929 " * Paragraph inside a list item.\n"
1930 " *\n"
1931 " * - list item 2\n"
1932 " *\n"
1933 " * 1. numbered list item\n"
1934 " *\n"
1935 " * 2. another numbered list item\n"
1936 " *\n"
1937 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1938 " *\n"
1939 " * ![an inline image](plot-result.png)\n"
1940 " *\n"
1941 " * [A link to the heading anchor above][heading-two]\n"
1942 " *\n"
1943 " * A C-language example:\n"
1944 " * |[&lt;!-- language=\"C\" --&gt;\n"
1945 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1946 " * ]|\n"
1947 " */\n"
1948 msgstr ""
1949 "\n"
1950 "/**\n"
1951 " * identifier:\n"
1952 " *\n"
1953 " * documentation paragraph ...\n"
1954 " *\n"
1955 " * # Sub Heading #\n"
1956 " *\n"
1957 " * ## Second Sub Heading\n"
1958 " *\n"
1959 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1960 " *\n"
1961 " * more documentation:\n"
1962 " *\n"
1963 " * - list item 1\n"
1964 " *\n"
1965 " * Paragraph inside a list item.\n"
1966 " *\n"
1967 " * - list item 2\n"
1968 " *\n"
1969 " * 1. numbered list item\n"
1970 " *\n"
1971 " * 2. another numbered list item\n"
1972 " *\n"
1973 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1974 " *\n"
1975 " * ![an inline image](plot-result.png)\n"
1976 " *\n"
1977 " * [A link to the heading anchor above][heading-two]\n"
1978 " *\n"
1979 " * A C-language example:\n"
1980 " * |[&lt;!-- language=\"C\" --&gt;\n"
1981 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1982 " * ]|\n"
1983 " */\n"
1984
1985 #. (itstool) path: sect1/para
1986 #: C/index.docbook:1224
1987 msgid ""
1988 "More examples of what markdown tags are supported can be found in the <ulink "
1989 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1990 "Documentation Markdown Syntax Reference</ulink>."
1991 msgstr ""
1992 "Weitere Beispiele zu den unterstützten Markdown-Formatierungen finden Sie in "
1993 "der <ulink url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/"
1994 "Markdown\">GTK Documentation Markdown Syntax Reference</ulink>."
1995
1996 #. (itstool) path: tip/para
1997 #: C/index.docbook:1230
1998 msgid ""
1999 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
2000 "cannot write documentation for static symbols. Nevertheless it is good to "
2001 "comment those symbols too. This helps other developers to understand your "
2002 "code. Therefore we recommend to comment these using normal comments (without "
2003 "the 2nd '*' in the first line). If later the function needs to be made "
2004 "public, all one needs to do is to add another '*' in the comment block and "
2005 "insert the symbol name at the right place inside the sections file."
2006 msgstr ""
2007 "Wie an früherer Stelle bereits erwähnt, ist GTK-Doc für das Dokumentieren "
2008 "der öffentlichen API gedacht. Daher kann man keine Dokumentation für "
2009 "statische Symbole schreiben. Nichtsdestotrotz ist es jedoch gut, diese "
2010 "Symbole trotzdem zu dokumentieren. Dies hilft anderen, Ihren Code besser zu "
2011 "verstehen. Deswegen empfehlen wir, hierfür normale Kommentare zu verwenden, "
2012 "ohne das zweite »*« in der ersten Zeile. Falls später die Funktion "
2013 "veröffentlicht werden soll, ist es lediglich nötig, im Kommentarblock ein "
2014 "zweites »*« hinzuzufügen und den Symbolnamen an der richtigen Stelle in die "
2015 "Abschnittsdatei einzubauen."
2016
2017 #. (itstool) path: sect1/title
2018 #: C/index.docbook:1245
2019 msgid "Documenting sections"
2020 msgstr "Dokumentieren in Abschnitten"
2021
2022 #. (itstool) path: sect1/para
2023 #: C/index.docbook:1247
2024 msgid ""
2025 "Each section of the documentation contains information about one class or "
2026 "module. To introduce the component one can write a section block. The short "
2027 "description is also used inside the table of contents. All the @fields are "
2028 "optional."
2029 msgstr ""
2030 "Jeder Abschnitt der Dokumentation enthält Informationen über eine Klasse "
2031 "oder ein Modul. Um eine Komponente hinzuzufügen, können Sie einen "
2032 "Abschnittsblock schreiben. Die Kurzbeschreibung wird auch im "
2033 "Inhaltsverzeichnis verwendet. Alle @-Felder sind optional."
2034
2035 #. (itstool) path: example/title
2036 #: C/index.docbook:1255
2037 msgid "Section comment block"
2038 msgstr "Abschnitts-Kommentarblock"
2039
2040 #. (itstool) path: example/programlisting
2041 #: C/index.docbook:1256
2042 #, no-wrap
2043 msgid ""
2044 "\n"
2045 "/**\n"
2046 " * SECTION:meepapp\n"
2047 " * @short_description: the application class\n"
2048 " * @title: Meep application\n"
2049 " * @section_id:\n"
2050 " * @see_also: #MeepSettings\n"
2051 " * @stability: Stable\n"
2052 " * @include: meep/app.h\n"
2053 " * @image: application.png\n"
2054 " *\n"
2055 " * The application class handles ...\n"
2056 " */\n"
2057 msgstr ""
2058 "\n"
2059 "/**\n"
2060 " * SECTION:meepapp\n"
2061 " * @short_description: the application class\n"
2062 " * @title: Meep application\n"
2063 " * @section_id:\n"
2064 " * @see_also: #MeepSettings\n"
2065 " * @stability: Stable\n"
2066 " * @include: meep/app.h\n"
2067 " * @image: application.png\n"
2068 " *\n"
2069 " * The application class handles ...\n"
2070 " */\n"
2071
2072 #. (itstool) path: varlistentry/term
2073 #: C/index.docbook:1275
2074 msgid "SECTION:&lt;name&gt;"
2075 msgstr "SECTION:&lt;name&gt;"
2076
2077 #. (itstool) path: listitem/para
2078 #: C/index.docbook:1277
2079 msgid ""
2080 "The name links the section documentation to the respective part in the "
2081 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2082 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections."
2083 "txt</filename> file."
2084 msgstr ""
2085 "Der Name verweist auf die Abschnittsdokumentation des entsprechenden Teils "
2086 "der Datei <filename>&lt;package&gt;-sections.txt</filename>. Der hier "
2087 "angegebene Name sollte der Markierung &lt;FILE&gt; in der Datei "
2088 "<filename>&lt;package&gt;-sections.txt</filename> entsprechen."
2089
2090 #. (itstool) path: varlistentry/term
2091 #: C/index.docbook:1286
2092 msgid "@short_description"
2093 msgstr "@short_description"
2094
2095 #. (itstool) path: listitem/para
2096 #: C/index.docbook:1288
2097 msgid ""
2098 "A one line description of the section, that later will appear after the "
2099 "links in the TOC and at the top of the section page."
2100 msgstr ""
2101 "Eine einzeilige Beschreibung des Abschnitts, die später hinter den Verweisen "
2102 "im Inhaltsverzeichnis und oben in der Abschnittsseite erscheint."
2103
2104 #. (itstool) path: varlistentry/term
2105 #: C/index.docbook:1295
2106 msgid "@title"
2107 msgstr "@title"
2108
2109 #. (itstool) path: listitem/para
2110 #: C/index.docbook:1297
2111 msgid ""
2112 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2113 "can be overridden with the @title field."
2114 msgstr ""
2115 "Der Abschnittstitel in der SECTION-Deklaration, Vorgabe ist &lt;name&gt;. Er "
2116 "kann im Feld @title überschrieben werden."
2117
2118 #. (itstool) path: varlistentry/term
2119 #: C/index.docbook:1304
2120 msgid "@section_id"
2121 msgstr "@section_id"
2122
2123 #. (itstool) path: listitem/para
2124 #: C/index.docbook:1306
2125 msgid ""
2126 "Overrides the use of title as a section identifier. For GObjects the &lt;"
2127 "title&gt; is used as a section_id and for other sections it is &lt;"
2128 "MODULE&gt;-&lt;title&gt;."
2129 msgstr ""
2130 "Überschreibt den Einsatz von Titeln als Abschnitts-Bezeichner. Für GObjects "
2131 "wird der &lt;Titel&gt; als section_id verwendet and für andere Abschnitte "
2132 "&lt;MODUL&gt;-&lt;Titel&gt;."
2133
2134 #. (itstool) path: varlistentry/term
2135 #: C/index.docbook:1314
2136 msgid "@see_also"
2137 msgstr "@see_also"
2138
2139 #. (itstool) path: listitem/para
2140 #: C/index.docbook:1316
2141 msgid "A list of symbols that are related to this section."
2142 msgstr "Eine Liste von Symbolen, welche sich auf diesen Abschnitt beziehen."
2143
2144 #. (itstool) path: varlistentry/term
2145 #: C/index.docbook:1322
2146 msgid "@stability"
2147 msgstr "@stability"
2148
2149 #. (itstool) path: listitem/para
2150 #: C/index.docbook:1329
2151 msgid ""
2152 "Stable - The intention of a Stable interface is to enable arbitrary third "
2153 "parties to develop applications to these interfaces, release them, and have "
2154 "confidence that they will run on all minor releases of the product (after "
2155 "the one in which the interface was introduced, and within the same major "
2156 "release). Even at a major release, incompatible changes are expected to be "
2157 "rare, and to have strong justifications."
2158 msgstr ""
2159 "Stabil - Die Absicht einer stabilen Schnittstelle ist es, beliebigen Dritten "
2160 "es zu ermöglichen, Anwendungen zu diesen Schnittstellen zu entwickeln, diese "
2161 "freizugeben und sich darauf verlassen zu können, dass diese mit allen "
2162 "Unterversionen des Produkts laufen (nach derjenigen, wo die Schnittstelle "
2163 "eingeführt wurde, und innerhalb der gleichen Hauptversion). Selbst bei einer "
2164 "Hauptversion kann man nicht von inkompatiblen Änderungen ausgehen, abgesehen "
2165 "von stark berechtigten."
2166
2167 #. (itstool) path: listitem/para
2168 #: C/index.docbook:1341
2169 msgid ""
2170 "Unstable - Unstable interfaces are experimental or transitional. They are "
2171 "typically used to give outside developers early access to new or rapidly "
2172 "changing technology, or to provide an interim solution to a problem where a "
2173 "more general solution is anticipated. No claims are made about either source "
2174 "or binary compatibility from one minor release to the next."
2175 msgstr ""
2176 "Instabil - Instabile Schnittstellen sind experimentell oder vorübergehend. "
2177 "Sie werden typischerweise verwendet, um außenstehenden Entwicklern frühen "
2178 "Zugang zu neuen oder sich schnell ändernden Technologien zu geben, oder um "
2179 "eine Übergangslösung für ein Problem zu liefern, für das eine allgemeinere "
2180 "Lösung erwartet wird. Es werden keine Garantien zu Quell- oder "
2181 "Binärkompatibilität von einer minor-Freigabe zur nächsten gegeben."
2182
2183 #. (itstool) path: listitem/para
2184 #: C/index.docbook:1353
2185 msgid ""
2186 "Private - An interface that can be used within the GNOME stack itself, but "
2187 "that is not documented for end-users. Such functions should only be used in "
2188 "specified and documented ways."
2189 msgstr ""
2190 "Privat - Eine Schnittstelle, die im GNOME-Stack selbst verwendet werden "
2191 "kann, aber nicht für Endanwender dokumentiert ist. Solche Funktionen sollten "
2192 "nur auf spezifizierte und dokumentierte Weisen verwendet werden."
2193
2194 #. (itstool) path: listitem/para
2195 #: C/index.docbook:1362
2196 msgid ""
2197 "Internal - An interface that is internal to a module and does not require "
2198 "end-user documentation. Functions that are undocumented are assumed to be "
2199 "Internal."
2200 msgstr ""
2201 "Intern - Eine Schnittstelle, die für ein Modul intern ist und keine "
2202 "Endanwender-Dokumentation erfordert. Undokumentierte Funktionen werden als "
2203 "intern angesehen."
2204
2205 #. (itstool) path: listitem/para
2206 #: C/index.docbook:1324
2207 msgid ""
2208 "An informal description of the stability level this API has. We recommend "
2209 "the use of one of these terms: <_:itemizedlist-1/>"
2210 msgstr ""
2211 "Eine informelle Beschreibung der Stabilitätsstufe dieser API. Wir empfehlen "
2212 "dafür einen der folgenden Begriffe: <_:itemizedlist-1/>"
2213
2214 #. (itstool) path: varlistentry/term
2215 #: C/index.docbook:1374
2216 msgid "@include"
2217 msgstr "@include"
2218
2219 #. (itstool) path: listitem/para
2220 #: C/index.docbook:1376
2221 msgid ""
2222 "The <literal>#include</literal> files to show in the section synopsis (a "
2223 "comma separated list), overriding the global value from the <link "
2224 "linkend=\"metafiles_sections\">section file</link> or command line. This "
2225 "item is optional."
2226 msgstr ""
2227 "Die <literal>#include</literal> -Dateien werden im Abschnitt »synopsis« "
2228 "angezeigt (eine durch Kommata getrennte Liste). Der globale Wert aus der "
2229 "<link linkend=\"metafiles_sections\">Abschnittsdatei</link> oder von der "
2230 "Befehlszeile wird überschrieben. Dieser Punkt ist optional."
2231
2232 #. (itstool) path: varlistentry/term
2233 #: C/index.docbook:1385
2234 msgid "@image"
2235 msgstr "@image"
2236
2237 #. (itstool) path: listitem/para
2238 #: C/index.docbook:1387
2239 msgid ""
2240 "The image to display at the top of the reference page for this section. This "
2241 "will often be some sort of a diagram to illustrate the visual appearance of "
2242 "a class or a diagram of its relationship to other classes. This item is "
2243 "optional."
2244 msgstr ""
2245 "Das Bild, das am Beginn einer Referenzseite für diesen Abschnitt angezeigt "
2246 "wird. Meist wird es eine Art Diagramm für das visuelle Erscheinungsbild "
2247 "einer Klasse oder ein Diagramm sein, das die Beziehungen zu anderen Klassen "
2248 "darstellt. Dieses Objekt ist optional."
2249
2250 #. (itstool) path: tip/para
2251 #: C/index.docbook:1398
2252 msgid ""
2253 "To avoid unnecessary recompilation after doc-changes put the section docs "
2254 "into the c-source where possible."
2255 msgstr ""
2256 "Um unnötiges Rekompilieren nach Dokumentationsänderungen zu vermeiden, "
2257 "platzieren Sie die Abschnittsdokumentation in die C-Quellen, wo immer es "
2258 "möglich ist."
2259
2260 #. (itstool) path: sect1/title
2261 #: C/index.docbook:1407
2262 msgid "Documenting symbols"
2263 msgstr "Dokumentieren von Symbolen"
2264
2265 #. (itstool) path: sect1/para
2266 #: C/index.docbook:1409
2267 msgid ""
2268 "Each symbol (function, macro, struct, enum, signal and property) is "
2269 "documented in a separate block. The block is best placed close to the "
2270 "definition of the symbols so that it is easy to keep them in sync. Thus "
2271 "functions are usually documented in the c-source and macros, structs and "
2272 "enums in the header file."
2273 msgstr ""
2274 "Jedes Symbol (function, macro, struct, enum, signal und property) wird in "
2275 "einem separaten Block dokumentiert. Der Block wird am besten nahe der "
2276 "Definition der Symbole platziert, sodass es leichter ist, diese synchron zu "
2277 "halten. Die Funktion wird üblicherweise in den C-Quellen definiert, »macro«, "
2278 "»struct« und »enum« dagegen in der Header-Datei."
2279
2280 #. (itstool) path: sect2/title
2281 #. (itstool) path: example/title
2282 #: C/index.docbook:1417 C/index.docbook:1483
2283 msgid "General tags"
2284 msgstr "Allgemeine Markierungen"
2285
2286 #. (itstool) path: sect2/para
2287 #: C/index.docbook:1419
2288 msgid ""
2289 "You can add versioning information to all documentation elements to tell "
2290 "when an API was introduced, or when it was deprecated."
2291 msgstr ""
2292 "Sie können Versionsinformationen zu allen Dokumentationselementen "
2293 "hinzufügen, um darauf hinzuweisen, wann eine API eingeführt oder wann sie "
2294 "als veraltet markiert wurde."
2295
2296 #. (itstool) path: variablelist/title
2297 #: C/index.docbook:1424
2298 msgid "Versioning Tags"
2299 msgstr "Versionierungs-Markierungen"
2300
2301 #. (itstool) path: varlistentry/term
2302 #: C/index.docbook:1425
2303 msgid "Since:"
2304 msgstr "Since:"
2305
2306 #. (itstool) path: listitem/para
2307 #: C/index.docbook:1427
2308 msgid "Description since which version of the code the API is available."
2309 msgstr "Beschreibung, seit welcher Version des Codes die API verfügbar ist."
2310
2311 #. (itstool) path: varlistentry/term
2312 #: C/index.docbook:1432
2313 msgid "Deprecated:"
2314 msgstr "Deprecated:"
2315
2316 #. (itstool) path: listitem/para
2317 #: C/index.docbook:1434
2318 msgid ""
2319 "Paragraph denoting that this function should no be used anymore. The "
2320 "description should point the reader to the new API."
2321 msgstr ""
2322 "Absatz, der darüber informiert, dass diese Funktion nicht mehr genutzt "
2323 "werden sollte. Die Beschreibung sollte einen Verweis auf die neue API "
2324 "enthalten."
2325
2326 #. (itstool) path: sect2/para
2327 #: C/index.docbook:1442
2328 msgid ""
2329 "You can also add stability information to all documentation elements to "
2330 "indicate whether API stability is guaranteed for them for all future minor "
2331 "releases of the project."
2332 msgstr ""
2333 "Sie können Stabilitätsinformationen zu allen Dokumentationselementen "
2334 "hinzufügen, um darauf hinzuweisen, ob API-Stabilität für alle Minor-"
2335 "Veröffentlichungen des Projekts garantiert wird."
2336
2337 #. (itstool) path: sect2/para
2338 #: C/index.docbook:1448
2339 msgid ""
2340 "The default stability level for all documentation elements can be set by "
2341 "passing the <option>--default-stability</option> argument to "
2342 "<application>gtkdoc-mkdb</application> with one of the values below."
2343 msgstr ""
2344 "Die Standard-Stabilitätsstufe für alle Dokumentationselemente setzen Sie "
2345 "durch Übergabe des Arguments <option>--default-stability</option> an "
2346 "<application>gtkdoc-mkdb</application> in einem der nachfolgend "
2347 "beschriebenen Werte."
2348
2349 #. (itstool) path: variablelist/title
2350 #: C/index.docbook:1454
2351 msgid "Stability Tags"
2352 msgstr "Stabilitäts-Markierungen"
2353
2354 #. (itstool) path: varlistentry/term
2355 #: C/index.docbook:1455
2356 msgid "Stability: Stable"
2357 msgstr "Stability: Stable"
2358
2359 #. (itstool) path: listitem/para
2360 #: C/index.docbook:1457
2361 msgid ""
2362 "Mark the element as stable. This is for public APIs which are guaranteed to "
2363 "remain stable for all future minor releases of the project."
2364 msgstr ""
2365 "Markiert das Element als stabil. Dies bezieht sich auf öffentliche APIs, für "
2366 "die für alle zukünftigen Minor-Veröffentlichungen des Projekts Stabilität "
2367 "gewährleistet ist."
2368
2369 #. (itstool) path: varlistentry/term
2370 #: C/index.docbook:1464
2371 msgid "Stability: Unstable"
2372 msgstr "Stability: Unstable"
2373
2374 #. (itstool) path: listitem/para
2375 #: C/index.docbook:1466
2376 msgid ""
2377 "Mark the element as unstable. This is for public APIs which are released as "
2378 "a preview before being stabilised."
2379 msgstr ""
2380 "Markiert das Element als instabil. Dies bezieht sich auf öffentliche APIs, "
2381 "die als Vorschau vor der endgültigen Stabilisierung gedacht sind."
2382
2383 #. (itstool) path: varlistentry/term
2384 #: C/index.docbook:1472
2385 msgid "Stability: Private"
2386 msgstr "Stability: Private"
2387
2388 #. (itstool) path: listitem/para
2389 #: C/index.docbook:1474
2390 msgid ""
2391 "Mark the element as private. This is for interfaces which can be used by "
2392 "tightly coupled modules, but not by arbitrary third parties."
2393 msgstr ""
2394 "Markiert das Element als privat. Dies bezieht sich auf Schnittstellen, die "
2395 "von eng damit verknüpften Modulen genutzt werden kann, aber nicht von "
2396 "beliebigen Drittanbietern."
2397
2398 #. (itstool) path: example/programlisting
2399 #: C/index.docbook:1484
2400 #, no-wrap
2401 msgid ""
2402 "\n"
2403 "/**\n"
2404 " * foo_get_bar:\n"
2405 " * @foo: some foo\n"
2406 " *\n"
2407 " * Retrieves @foo's bar.\n"
2408 " *\n"
2409 " * Returns: @foo's bar\n"
2410 " *\n"
2411 " * Since: 2.6\n"
2412 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2413 " */\n"
2414 "Bar *\n"
2415 "foo_get_bar(Foo *foo)\n"
2416 "{\n"
2417 "...\n"
2418 msgstr ""
2419 "\n"
2420 "/**\n"
2421 " * foo_get_bar:\n"
2422 " * @foo: some foo\n"
2423 " *\n"
2424 " * Retrieves @foo's bar.\n"
2425 " *\n"
2426 " * Returns: @foo's bar\n"
2427 " *\n"
2428 " * Since: 2.6\n"
2429 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2430 " */\n"
2431 "Bar *\n"
2432 "foo_get_bar(Foo *foo)\n"
2433 "{\n"
2434 "...\n"
2435
2436 #. (itstool) path: sect2/title
2437 #. (itstool) path: example/title
2438 #: C/index.docbook:1504 C/index.docbook:1514
2439 msgid "Annotations"
2440 msgstr "Anmerkungen"
2441
2442 #. (itstool) path: sect2/para
2443 #: C/index.docbook:1506
2444 msgid ""
2445 "Documentation blocks can contain annotation-tags. These tags will be "
2446 "rendered with tooltips describing their meaning. The tags are used by "
2447 "GObject Introspection to generate language bindings. A detailed list of the "
2448 "supported tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/"
2449 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection "
2450 "documentation</ulink>."
2451 msgstr ""
2452 "Dokumentationsblöcke können Anmerkungs-Markierungen enthalten. Diese "
2453 "Markierungen werden als Tooltips (Minihilfen) dargestellt, die die jeweilige "
2454 "Bedeutung anzeigen. Sie werden von GObject Introspection genutzt, um "
2455 "Sprachbindungen zu erzeugen. Eine detaillierte Liste der unterstützten "
2456 "Markierungen finden Sie in der <ulink url=\"https://gi.readthedocs.io/en/"
2457 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection-"
2458 "Dokumentation</ulink>."
2459
2460 #. (itstool) path: example/programlisting
2461 #: C/index.docbook:1515
2462 #, no-wrap
2463 msgid ""
2464 "\n"
2465 "/**\n"
2466 " * foo_get_bar: (annotation)\n"
2467 " * @foo: (annotation): some foo\n"
2468 " *\n"
2469 " * Retrieves @foo's bar.\n"
2470 " *\n"
2471 " * Returns: (annotation): @foo's bar\n"
2472 " */\n"
2473 "...\n"
2474 "/**\n"
2475 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2476 " * (and another annotation)\n"
2477 " * @foo: (annotation) (another annotation): some foo\n"
2478 " *\n"
2479 " * Sets bar on @foo.\n"
2480 " */\n"
2481 msgstr ""
2482 "\n"
2483 "/**\n"
2484 " * foo_get_bar: (annotation)\n"
2485 " * @foo: (annotation): some foo\n"
2486 " *\n"
2487 " * Retrieves @foo's bar.\n"
2488 " *\n"
2489 " * Returns: (annotation): @foo's bar\n"
2490 " */\n"
2491 "...\n"
2492 "/**\n"
2493 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2494 " * (and another annotation)\n"
2495 " * @foo: (annotation) (another annotation): some foo\n"
2496 " *\n"
2497 " * Sets bar on @foo.\n"
2498 " */\n"
2499
2500 #. (itstool) path: sect2/title
2501 #. (itstool) path: example/title
2502 #: C/index.docbook:1536 C/index.docbook:1565
2503 msgid "Function comment block"
2504 msgstr "Kommentarblock einer Funktion"
2505
2506 #. (itstool) path: listitem/para
2507 #: C/index.docbook:1542
2508 msgid ""
2509 "Document whether returned objects, lists, strings, etc, should be freed/"
2510 "unrefed/released."
2511 msgstr ""
2512 "Dokumentieren, ob zurückgegebene Objekte, Listen, Zeichenketten usw. befreit/"
2513 "dereferenziert/freigegeben werden."
2514
2515 #. (itstool) path: listitem/para
2516 #: C/index.docbook:1548
2517 msgid "Document whether parameters can be NULL, and what happens if they are."
2518 msgstr ""
2519 "Dokumentiert, ob Parameter NULL sein können, und was in diesem Fall "
2520 "geschieht."
2521
2522 #. (itstool) path: listitem/para
2523 #: C/index.docbook:1553
2524 msgid ""
2525 "Mention interesting pre-conditions and post-conditions where appropriate."
2526 msgstr ""
2527 "Erwähnen Sie interessante Vorbedingungen (und nachfolgende Bedingungen), wo "
2528 "es nützlich erscheint."
2529
2530 #. (itstool) path: sect2/para
2531 #: C/index.docbook:1538 C/index.docbook:1624
2532 msgid "Please remember to: <_:itemizedlist-1/>"
2533 msgstr "Bitte denken Sie an: <_:itemizedlist-1/>"
2534
2535 #. (itstool) path: sect2/para
2536 #: C/index.docbook:1560
2537 msgid ""
2538 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2539 "private. They are treated like static functions."
2540 msgstr ""
2541 "GTK-Doc nimmt an, dass alle Symbole (Makros, Funktionen), die mit »_« "
2542 "beginnen, privat sind. Sie werden wie statische Funktionen behandelt."
2543
2544 #. (itstool) path: example/programlisting
2545 #: C/index.docbook:1566
2546 #, no-wrap
2547 msgid ""
2548 "\n"
2549 "/**\n"
2550 " * function_name:\n"
2551 " * @par1: description of parameter 1. These can extend over more than\n"
2552 " * one line.\n"
2553 " * @par2: description of parameter 2\n"
2554 " * @...: a %NULL-terminated list of bars\n"
2555 " *\n"
2556 " * The function description goes here. You can use @par1 to refer to parameters\n"
2557 " * so that they are highlighted in the output. You can also use %constant\n"
2558 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2559 " * other declarations (which may be documented elsewhere).\n"
2560 " *\n"
2561 " * Returns: an integer.\n"
2562 " *\n"
2563 " * Since: 2.2\n"
2564 " * Deprecated: 2.18: Use other_function() instead.\n"
2565 " */\n"
2566 msgstr ""
2567 "\n"
2568 "/**\n"
2569 " * function_name:\n"
2570 " * @par1: description of parameter 1. These can extend over more than\n"
2571 " * one line.\n"
2572 " * @par2: description of parameter 2\n"
2573 " * @...: a %NULL-terminated list of bars\n"
2574 " *\n"
2575 " * The function description goes here. You can use @par1 to refer to parameters\n"
2576 " * so that they are highlighted in the output. You can also use %constant\n"
2577 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2578 " * other declarations (which may be documented elsewhere).\n"
2579 " *\n"
2580 " * Returns: an integer.\n"
2581 " *\n"
2582 " * Since: 2.2\n"
2583 " * Deprecated: 2.18: Use other_function() instead.\n"
2584 " */\n"
2585
2586 #. (itstool) path: variablelist/title
2587 #: C/index.docbook:1587
2588 msgid "Function tags"
2589 msgstr "Funktions-Markierungen"
2590
2591 #. (itstool) path: varlistentry/term
2592 #: C/index.docbook:1588 C/index.docbook:1795
2593 msgid "Returns:"
2594 msgstr "Returns:"
2595
2596 #. (itstool) path: listitem/para
2597 #: C/index.docbook:1590
2598 msgid "Paragraph describing the returned result."
2599 msgstr "Abschnitt, der das zurückgegebene Ergebnis beschreibt."
2600
2601 #. (itstool) path: varlistentry/term
2602 #: C/index.docbook:1595
2603 msgid "@...:"
2604 msgstr "@...:"
2605
2606 #. (itstool) path: listitem/para
2607 #: C/index.docbook:1597
2608 msgid ""
2609 "In case the function has variadic arguments, you should use this tag "
2610 "(@Varargs: does also work for historic reasons)."
2611 msgstr ""
2612 "Wenn die Funktion variadische Argumente enthält, sollten Sie diese "
2613 "Markierung verwenden (@Varargs: funktioniert aus historischen Gründen "
2614 "ebenfalls)."
2615
2616 #. (itstool) path: sect2/title
2617 #. (itstool) path: example/title
2618 #: C/index.docbook:1607 C/index.docbook:1609
2619 msgid "Property comment block"
2620 msgstr "Property-Kommentarblock"
2621
2622 #. (itstool) path: example/programlisting
2623 #: C/index.docbook:1610
2624 #, no-wrap
2625 msgid ""
2626 "\n"
2627 "/**\n"
2628 " * SomeWidget:some-property:\n"
2629 " *\n"
2630 " * Here you can document a property.\n"
2631 " */\n"
2632 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2633 msgstr ""
2634 "\n"
2635 "/**\n"
2636 " * SomeWidget:some-property:\n"
2637 " *\n"
2638 " * Here you can document a property.\n"
2639 " */\n"
2640 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2641
2642 #. (itstool) path: sect2/title
2643 #. (itstool) path: example/title
2644 #: C/index.docbook:1622 C/index.docbook:1641
2645 msgid "Signal comment block"
2646 msgstr "Signal-Kommentarblock"
2647
2648 #. (itstool) path: listitem/para
2649 #: C/index.docbook:1628
2650 msgid ""
2651 "Document when the signal is emitted and whether it is emitted before or "
2652 "after other signals."
2653 msgstr ""
2654 "Dokumentiert, wann ein Signal ausgegeben wird und ob es vor oder nach "
2655 "anderen Signalen ausgegeben wird."
2656
2657 #. (itstool) path: listitem/para
2658 #: C/index.docbook:1634
2659 msgid "Document what an application might do in the signal handler."
2660 msgstr "Dokumentiert, was eine Anwendung in dem Signal-Handler tun könnte."
2661
2662 #. (itstool) path: example/programlisting
2663 #: C/index.docbook:1642
2664 #, no-wrap
2665 msgid ""
2666 "\n"
2667 "/**\n"
2668 " * FooWidget::foobarized:\n"
2669 " * @widget: the widget that received the signal\n"
2670 " * @foo: some foo\n"
2671 " * @bar: some bar\n"
2672 " *\n"
2673 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2674 " */\n"
2675 "foo_signals[FOOBARIZED] =\n"
2676 " g_signal_new (\"foobarized\",\n"
2677 " ...\n"
2678 msgstr ""
2679 "\n"
2680 "/**\n"
2681 " * FooWidget::foobarized:\n"
2682 " * @widget: the widget that received the signal\n"
2683 " * @foo: some foo\n"
2684 " * @bar: some bar\n"
2685 " *\n"
2686 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2687 " */\n"
2688 "foo_signals[FOOBARIZED] =\n"
2689 " g_signal_new (\"foobarized\",\n"
2690 " ...\n"
2691
2692 #. (itstool) path: sect2/title
2693 #. (itstool) path: example/title
2694 #: C/index.docbook:1659 C/index.docbook:1660
2695 msgid "Struct comment block"
2696 msgstr "Struct-Kommentarblock"
2697
2698 #. (itstool) path: example/programlisting
2699 #: C/index.docbook:1661
2700 #, no-wrap
2701 msgid ""
2702 "\n"
2703 "/**\n"
2704 " * FooWidget:\n"
2705 " * @bar: some #gboolean\n"
2706 " *\n"
2707 " * This is the best widget, ever.\n"
2708 " */\n"
2709 "typedef struct _FooWidget {\n"
2710 " GtkWidget parent_instance;\n"
2711 "\n"
2712 " gboolean bar;\n"
2713 "} FooWidget;\n"
2714 msgstr ""
2715 "\n"
2716 "/**\n"
2717 " * FooWidget:\n"
2718 " * @bar: some #gboolean\n"
2719 " *\n"
2720 " * This is the best widget, ever.\n"
2721 " */\n"
2722 "typedef struct _FooWidget {\n"
2723 " GtkWidget parent_instance;\n"
2724 "\n"
2725 " gboolean bar;\n"
2726 "} FooWidget;\n"
2727
2728 #. (itstool) path: sect2/para
2729 #: C/index.docbook:1676
2730 msgid ""
2731 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2732 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2733 "behaviour."
2734 msgstr ""
2735 "Verwenden Sie <code>/*&lt; private &gt;*/</code> vor den privaten »struct«-"
2736 "Feldern, die Sie verbergen wollen. Um das umgekehrte Verhalten zu erzielen, "
2737 "verwenden Sie <code>/*&lt; public &gt;*/</code>."
2738
2739 #. (itstool) path: sect2/para
2740 #: C/index.docbook:1682
2741 msgid ""
2742 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2743 "it will be considered private automatically and doesn't need to be mentioned "
2744 "in the comment block."
2745 msgstr ""
2746 "Wenn das erste Feld »g_iface«, »parent_instance« oder »parent_class« ist, "
2747 "wird es automatisch als privat angesehen und muss nicht im Kommentarblock "
2748 "erwähnt werden."
2749
2750 #. (itstool) path: sect2/para
2751 #: C/index.docbook:1688
2752 msgid ""
2753 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2754 "is usually a good idea to add a comment block for a class, if it has "
2755 "vmethods (as this is how they can be documented). For the GObject itself one "
2756 "can use the related section docs, having a separate block for the instance "
2757 "struct would be useful if the instance has public fields. One disadvantage "
2758 "here is that this creates two index entries of the same name (the structure "
2759 "and the section)."
2760 msgstr ""
2761 "Struct-Kommentarblöcke können auch für GObjects und GObjectClasses verwendet "
2762 "werden. Es ist ratsam, einen Kommentarblock für eine Klasse hinzuzufügen, "
2763 "wenn diese vmethods enthält (dies ist die Art der Dokumentation dafür). Für "
2764 "GObject selbst können Sie die jeweiligen Abschnittsdokumentationen "
2765 "verwenden, wobei ein separater Block für das Instanz-Struct sinnvoll ist, "
2766 "sofern die Instanz öffentliche Felder enthält. Ein Nachteil ist hier, dass "
2767 "dadurch zwei gleichnamige Indexeinträge erstellt werden (die Struktur und "
2768 "der Abschnitt)."
2769
2770 #. (itstool) path: sect2/title
2771 #. (itstool) path: example/title
2772 #: C/index.docbook:1700 C/index.docbook:1701
2773 msgid "Enum comment block"
2774 msgstr "Enum-Kommentarblock"
2775
2776 #. (itstool) path: example/programlisting
2777 #: C/index.docbook:1702
2778 #, no-wrap
2779 msgid ""
2780 "\n"
2781 "/**\n"
2782 " * Something:\n"
2783 " * @SOMETHING_FOO: something foo\n"
2784 " * @SOMETHING_BAR: something bar\n"
2785 " *\n"
2786 " * Enum values used for the thing, to specify the thing.\n"
2787 " */\n"
2788 "typedef enum {\n"
2789 " SOMETHING_FOO,\n"
2790 " SOMETHING_BAR,\n"
2791 " /*&lt; private &gt;*/\n"
2792 " SOMETHING_COUNT\n"
2793 "} Something;\n"
2794 msgstr ""
2795 "\n"
2796 "/**\n"
2797 " * Something:\n"
2798 " * @SOMETHING_FOO: something foo\n"
2799 " * @SOMETHING_BAR: something bar\n"
2800 " *\n"
2801 " * Enum values used for the thing, to specify the thing.\n"
2802 " */\n"
2803 "typedef enum {\n"
2804 " SOMETHING_FOO,\n"
2805 " SOMETHING_BAR,\n"
2806 " /*&lt; private &gt;*/\n"
2807 " SOMETHING_COUNT\n"
2808 "} Something;\n"
2809
2810 #. (itstool) path: sect2/para
2811 #: C/index.docbook:1719
2812 msgid ""
2813 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2814 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2815 "behaviour."
2816 msgstr ""
2817 "Verwenden Sie <code>/*&lt; private &gt;*/</code> vor den privaten »enum«-"
2818 "Werten, die Sie verbergen wollen. Um das umgekehrte Verhalten zu erzielen, "
2819 "verwenden Sie <code>/*&lt; public &gt;*/</code>."
2820
2821 #. (itstool) path: sect1/title
2822 #: C/index.docbook:1730
2823 msgid "Inline program documentation"
2824 msgstr "Eingebettete Programmdokumentation"
2825
2826 #. (itstool) path: sect1/para
2827 #: C/index.docbook:1731
2828 msgid ""
2829 "You can document programs and their commandline interface using inline "
2830 "documentation."
2831 msgstr ""
2832 "Dokumentieren Sie ein Programm und dessen Befehlszeilen-Schnittstelle mit "
2833 "eingebetteter Dokumentation."
2834
2835 #. (itstool) path: variablelist/title
2836 #: C/index.docbook:1737
2837 msgid "Tags"
2838 msgstr "Markierungen"
2839
2840 #. (itstool) path: varlistentry/term
2841 #: C/index.docbook:1739
2842 msgid "PROGRAM"
2843 msgstr "PROGRAM"
2844
2845 #. (itstool) path: listitem/para
2846 #: C/index.docbook:1742
2847 msgid "Defines the start of a program documentation."
2848 msgstr "Definiert den Start einer Programmdokumentation."
2849
2850 #. (itstool) path: varlistentry/term
2851 #: C/index.docbook:1749
2852 msgid "@short_description:"
2853 msgstr "@short_description:"
2854
2855 #. (itstool) path: listitem/para
2856 #: C/index.docbook:1751
2857 msgid "Defines a short description of the program. (Optional)"
2858 msgstr "Definiert eine Kurzbeschreibung des Programms (optional)."
2859
2860 #. (itstool) path: varlistentry/term
2861 #: C/index.docbook:1758
2862 msgid "@synopsis:"
2863 msgstr "@synopsis:"
2864
2865 #. (itstool) path: listitem/para
2866 #: C/index.docbook:1760
2867 msgid ""
2868 "Defines the arguments, or list of arguments that the program can take. "
2869 "(Optional)"
2870 msgstr ""
2871 "Definiert die Argumente oder eine Liste von Argumenten, die das Programm "
2872 "akzeptiert (optional)."
2873
2874 #. (itstool) path: varlistentry/term
2875 #: C/index.docbook:1768
2876 msgid "@see_also:"
2877 msgstr "@see_also:"
2878
2879 #. (itstool) path: listitem/para
2880 #: C/index.docbook:1770
2881 msgid "See Also manual page section. (Optional)"
2882 msgstr ""
2883 "Der Abschnitt »SEE ALSO« in den man-Pages (Unix-Handbuchseiten, optional)."
2884
2885 #. (itstool) path: varlistentry/term
2886 #: C/index.docbook:1777
2887 msgid "@arg:"
2888 msgstr "@arg:"
2889
2890 #. (itstool) path: listitem/para
2891 #: C/index.docbook:1779
2892 msgid "Argument(s) passed to the program and their description. (Optional)"
2893 msgstr ""
2894 "Argument(e), die dem Programm übergeben wurden, und die zugehörige "
2895 "Beschreibung (optional)."
2896
2897 #. (itstool) path: varlistentry/term
2898 #: C/index.docbook:1786
2899 msgid "Description:"
2900 msgstr "Description:"
2901
2902 #. (itstool) path: listitem/para
2903 #: C/index.docbook:1788
2904 msgid "A longer description of the program."
2905 msgstr "Eine ausführlichere Beschreibung des Programms."
2906
2907 #. (itstool) path: listitem/para
2908 #: C/index.docbook:1797
2909 msgid "Specify what value(s) the program returns. (Optional)"
2910 msgstr "Geben Sie an, welche Wert(e) das Programm zurück gibt (optional)."
2911
2912 #. (itstool) path: sect2/title
2913 #: C/index.docbook:1806
2914 msgid "Example of program documentation."
2915 msgstr "Beispiel einer Programmdokumentation."
2916
2917 #. (itstool) path: example/title
2918 #: C/index.docbook:1807
2919 msgid "Program documentation block"
2920 msgstr "Programm-Dokumentationsblock"
2921
2922 # Würde ich nicht übersetzen. Ein Entwickler schreibt stets in Englisch,
2923 # die Übersetzung ist unsere Sache.
2924 #. (itstool) path: example/programlisting
2925 #: C/index.docbook:1808
2926 #, no-wrap
2927 msgid ""
2928 "\n"
2929 "/**\n"
2930 " * PROGRAM:test-program\n"
2931 " * @short_description: A test program\n"
2932 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2933 " * @see_also: test(1)\n"
2934 " * @--arg1 *arg*: set arg1 to *arg*\n"
2935 " * @--arg2 *arg*: set arg2 to *arg*\n"
2936 " * @-v, --version: Print the version number\n"
2937 " * @-h, --help: Print the help message\n"
2938 " *\n"
2939 " * Long description of program.\n"
2940 " *\n"
2941 " * Returns: Zero on success, non-zero on failure\n"
2942 " */\n"
2943 "int main(int argc, char *argv[])\n"
2944 "{\n"
2945 "\treturn 0;\n"
2946 "}\n"
2947 msgstr ""
2948 "\n"
2949 "/**\n"
2950 " * PROGRAM:test-program\n"
2951 " * @short_description: A test program\n"
2952 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2953 " * @see_also: test(1)\n"
2954 " * @--arg1 *arg*: set arg1 to *arg*\n"
2955 " * @--arg2 *arg*: set arg2 to *arg*\n"
2956 " * @-v, --version: Print the version number\n"
2957 " * @-h, --help: Print the help message\n"
2958 " *\n"
2959 " * Long description of program.\n"
2960 " *\n"
2961 " * Returns: Zero on success, non-zero on failure\n"
2962 " */\n"
2963 "int main(int argc, char *argv[])\n"
2964 "{\n"
2965 "\treturn 0;\n"
2966 "}\n"
2967
2968 #. (itstool) path: sect1/title
2969 #: C/index.docbook:1834
2970 msgid "Useful DocBook tags"
2971 msgstr "Nützliche DocBook-Markierungen"
2972
2973 #. (itstool) path: sect1/para
2974 #: C/index.docbook:1836
2975 msgid ""
2976 "Here are some DocBook tags which are most useful when documenting the code."
2977 msgstr ""
2978 "Nachfolgend finden Sie einige DocBook-Markierungen, die beim Dokumentieren "
2979 "von Code nützlich sein können."
2980
2981 #. (itstool) path: informalexample/programlisting
2982 #: C/index.docbook:1845
2983 #, no-wrap
2984 msgid ""
2985 "\n"
2986 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2987 msgstr ""
2988 "\n"
2989 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2990
2991 #. (itstool) path: sect1/para
2992 #: C/index.docbook:1841
2993 msgid ""
2994 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2995 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2996 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2997 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2998 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2999 msgstr ""
3000 "So erstellen Sie eine Verknüpfung zu einem anderen Abschnitt in den GTK-"
3001 "Docs: <_:informalexample-1/> »linkend« ist dabei die SGML-XML-Kennung des "
3002 "obersten Elements der Seite, auf welche die Verknüpfung zielt (»gtk«, »gdk«, "
3003 "»glib«), danach folgt der Seitentitel (»Hash Tables«). Für Widgets ist dies "
3004 "einfach der Klassenname. Leerzeichen und Unterstriche werden SGML/XML-"
3005 "konform in »-« umgewandelt."
3006
3007 #. (itstool) path: informalexample/programlisting
3008 #: C/index.docbook:1858
3009 #, no-wrap
3010 msgid ""
3011 "\n"
3012 "&lt;function&gt;...&lt;/function&gt;\n"
3013 msgstr ""
3014 "\n"
3015 "&lt;function&gt;...&lt;/function&gt;\n"
3016
3017 #. (itstool) path: sect1/para
3018 #: C/index.docbook:1855
3019 msgid ""
3020 "To refer to an external function, e.g. a standard C function: <_:"
3021 "informalexample-1/>"
3022 msgstr ""
3023 "Für einen Bezug zu einer externen Funktion, z.B. einer C-Standardfunktion: "
3024 "<_:informalexample-1/>"
3025
3026 #. (itstool) path: informalexample/programlisting
3027 #: C/index.docbook:1867
3028 #, no-wrap
3029 msgid ""
3030 "\n"
3031 "&lt;example&gt;\n"
3032 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3033 " &lt;programlisting language=\"C\"&gt;\n"
3034 " ...\n"
3035 " &lt;/programlisting&gt;\n"
3036 "&lt;/example&gt;\n"
3037 msgstr ""
3038 "\n"
3039 "&lt;example&gt;\n"
3040 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3041 " &lt;programlisting language=\"C\"&gt;\n"
3042 " …\n"
3043 " &lt;/programlisting&gt;\n"
3044 "&lt;/example&gt;\n"
3045
3046 #. (itstool) path: informalexample/programlisting
3047 #: C/index.docbook:1878
3048 #, no-wrap
3049 msgid ""
3050 "\n"
3051 "&lt;informalexample&gt;\n"
3052 " &lt;programlisting language=\"C\"&gt;\n"
3053 " ...\n"
3054 " &lt;/programlisting&gt;\n"
3055 "&lt;/informalexample&gt;\n"
3056 msgstr ""
3057 "\n"
3058 "&lt;informalexample&gt;\n"
3059 " &lt;programlisting language=\"C\"&gt;\n"
3060 " …\n"
3061 " &lt;/programlisting&gt;\n"
3062 "&lt;/informalexample&gt;\n"
3063
3064 #. (itstool) path: informalexample/programlisting
3065 #: C/index.docbook:1890
3066 #, no-wrap
3067 msgid ""
3068 "\n"
3069 "|[&lt;!-- language=\"C\" --&gt;\n"
3070 " ...\n"
3071 "]|\n"
3072 msgstr ""
3073 "\n"
3074 "|[&lt;!-- language=\"C\" --&gt;\n"
3075 " …\n"
3076 "]|\n"
3077
3078 #. (itstool) path: sect1/para
3079 #: C/index.docbook:1864
3080 msgid ""
3081 "To include example code: <_:informalexample-1/> or possibly this, for very "
3082 "short code fragments which don't need a title: <_:informalexample-2/> In "
3083 "both cases, the language attribute is optional and is used as a hint to the "
3084 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3085 "Doc also supports an abbreviation: <_:informalexample-3/>"
3086 msgstr ""
3087 "So fügen Sie Beispielcode ein: <placeholder-1/> Vielleicht auch so, für sehr "
3088 "kurze Codeschnipsel, die keinen Titel benötigen: <_:informalexample-2/> . In "
3089 "beiden Fällen ist das Language-Attribut optional und wird als Hinweis für "
3090 "die Syntaxhervorhebung-Engine verwnedet (Pygments für die HTML-Ausgabe). "
3091 "Außerdem unterstützt GTK-Doc auch eine Abkürzung: <_:informalexample-3/>"
3092
3093 #. (itstool) path: informalexample/programlisting
3094 #: C/index.docbook:1901
3095 #, no-wrap
3096 msgid ""
3097 "\n"
3098 "&lt;itemizedlist&gt;\n"
3099 " &lt;listitem&gt;\n"
3100 " &lt;para&gt;\n"
3101 " ...\n"
3102 " &lt;/para&gt;\n"
3103 " &lt;/listitem&gt;\n"
3104 " &lt;listitem&gt;\n"
3105 " &lt;para&gt;\n"
3106 " ...\n"
3107 " &lt;/para&gt;\n"
3108 " &lt;/listitem&gt;\n"
3109 "&lt;/itemizedlist&gt;\n"
3110 msgstr ""
3111 "\n"
3112 "&lt;itemizedlist&gt;\n"
3113 " &lt;listitem&gt;\n"
3114 " &lt;para&gt;\n"
3115 " ...\n"
3116 " &lt;/para&gt;\n"
3117 " &lt;/listitem&gt;\n"
3118 " &lt;listitem&gt;\n"
3119 " &lt;para&gt;\n"
3120 " ...\n"
3121 " &lt;/para&gt;\n"
3122 " &lt;/listitem&gt;\n"
3123 "&lt;/itemizedlist&gt;\n"
3124
3125 #. (itstool) path: sect1/para
3126 #: C/index.docbook:1898
3127 msgid "To include bulleted lists: <_:informalexample-1/>"
3128 msgstr "Für eine Liste mit Aufzählungszeichen: <_:informalexample-1/>"
3129
3130 #. (itstool) path: informalexample/programlisting
3131 #: C/index.docbook:1921
3132 #, no-wrap
3133 msgid ""
3134 "\n"
3135 "&lt;note&gt;\n"
3136 " &lt;para&gt;\n"
3137 " Make sure you free the data after use.\n"
3138 " &lt;/para&gt;\n"
3139 "&lt;/note&gt;\n"
3140 msgstr ""
3141 "\n"
3142 "&lt;note&gt;\n"
3143 " &lt;para&gt;\n"
3144 " Make sure you free the data after use.\n"
3145 " &lt;/para&gt;\n"
3146 "&lt;/note&gt;\n"
3147
3148 #. (itstool) path: sect1/para
3149 #: C/index.docbook:1918
3150 msgid ""
3151 "To include a note which stands out from the text: <_:informalexample-1/>"
3152 msgstr ""
3153 "Für eine nicht zum eigentlichen Text gehörende Notiz: <_:informalexample-1/>"
3154
3155 #. (itstool) path: informalexample/programlisting
3156 #: C/index.docbook:1934
3157 #, no-wrap
3158 msgid ""
3159 "\n"
3160 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3161 msgstr ""
3162 "\n"
3163 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3164
3165 #. (itstool) path: sect1/para
3166 #: C/index.docbook:1931
3167 msgid "To refer to a type: <_:informalexample-1/>"
3168 msgstr "Für einen Bezug zu einem Typ: <_:informalexample-1/>"
3169
3170 #. (itstool) path: informalexample/programlisting
3171 #: C/index.docbook:1943
3172 #, no-wrap
3173 msgid ""
3174 "\n"
3175 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3176 msgstr ""
3177 "\n"
3178 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3179
3180 #. (itstool) path: sect1/para
3181 #: C/index.docbook:1940
3182 msgid ""
3183 "To refer to an external structure (not one described in the GTK docs): <_:"
3184 "informalexample-1/>"
3185 msgstr ""
3186 "Für einen Bezug zu einer externen Struktur (die nicht in den GTK-Docs "
3187 "beschrieben wird): <_:informalexample-1/>"
3188
3189 #. (itstool) path: informalexample/programlisting
3190 #: C/index.docbook:1952
3191 #, no-wrap
3192 msgid ""
3193 "\n"
3194 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3195 msgstr ""
3196 "\n"
3197 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3198
3199 #. (itstool) path: sect1/para
3200 #: C/index.docbook:1949
3201 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3202 msgstr "Für einen Bezug zu einem Feld einer Struktur: <_:informalexample-1/>"
3203
3204 #. (itstool) path: informalexample/programlisting
3205 #: C/index.docbook:1961
3206 #, no-wrap
3207 msgid ""
3208 "\n"
3209 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3210 msgstr ""
3211 "\n"
3212 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3213
3214 #. (itstool) path: sect1/para
3215 #: C/index.docbook:1958
3216 msgid ""
3217 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3218 "you'll probably be using #GtkWidget instead (to automatically create a link "
3219 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3220 "abbreviations</link>)."
3221 msgstr ""
3222 "Um sich auf einen Klassennamen zu beziehen, kann man möglicherweise "
3223 "folgendes verwenden: <_:informalexample-1/> Aber Sie verwenden vermutlich "
3224 "stattdessen #GtkWidget (um automatisch eine Verknüpfung zur GtkWidget-Seite "
3225 "zu erstellen - lesen Sie <link linkend=\"documenting_syntax\">die "
3226 "Abkürzungen</link>)."
3227
3228 #. (itstool) path: informalexample/programlisting
3229 #: C/index.docbook:1972
3230 #, no-wrap
3231 msgid ""
3232 "\n"
3233 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3234 msgstr ""
3235 "\n"
3236 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3237
3238 #. (itstool) path: sect1/para
3239 #: C/index.docbook:1969
3240 msgid "To emphasize text: <_:informalexample-1/>"
3241 msgstr "Zum Hervorheben von Text: <_:informalexample-1/>"
3242
3243 #. (itstool) path: informalexample/programlisting
3244 #: C/index.docbook:1981
3245 #, no-wrap
3246 msgid ""
3247 "\n"
3248 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3249 msgstr ""
3250 "\n"
3251 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3252
3253 #. (itstool) path: sect1/para
3254 #: C/index.docbook:1978
3255 msgid "For filenames use: <_:informalexample-1/>"
3256 msgstr "Für Dateinamen: <_:informalexample-1/>"
3257
3258 #. (itstool) path: informalexample/programlisting
3259 #: C/index.docbook:1990
3260 #, no-wrap
3261 msgid ""
3262 "\n"
3263 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3264 msgstr ""
3265 "\n"
3266 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3267
3268 #. (itstool) path: sect1/para
3269 #: C/index.docbook:1987
3270 msgid "To refer to keys use: <_:informalexample-1/>"
3271 msgstr "Für einen Bezug zu einem Schlüssel: <_:informalexample-1/>"
3272
3273 #. (itstool) path: chapter/title
3274 #: C/index.docbook:2000
3275 msgid "Filling the extra files"
3276 msgstr "Füllen der zusätzlichen Dateien"
3277
3278 #. (itstool) path: chapter/para
3279 #: C/index.docbook:2002
3280 msgid ""
3281 "There are a couple of extra files, that need to be maintained along with the "
3282 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3283 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3284 "<filename>&lt;package&gt;-sections.txt</filename>."
3285 msgstr ""
3286 "Es gibt eine Menge zusätzlicher Dateien, die mit den eingebetteten Quellcode-"
3287 "Kommentaren verwaltet werden müssen: <filename>&lt;package&gt;.types</"
3288 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (früher .sgml), "
3289 "<filename>&lt;package&gt;-sections.txt</filename>."
3290
3291 #. (itstool) path: sect1/title
3292 #: C/index.docbook:2011
3293 msgid "Editing the types file"
3294 msgstr "Bearbeiten der Typendatei"
3295
3296 #. (itstool) path: sect1/para
3297 #: C/index.docbook:2013
3298 msgid ""
3299 "If your library or application includes GObjects, you want their signals, "
3300 "arguments/parameters and position in the hierarchy to be shown in the "
3301 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3302 "function> functions together with their include inside the <filename>&lt;"
3303 "package&gt;.types</filename> file."
3304 msgstr ""
3305 "Falls Ihre Bibliothek oder Anwendung GObjects beinhaltet, sollten deren "
3306 "Signale, Argumente/Parameter und Positionen in der Hierarchie in der "
3307 "Dokumentation erscheinen. Alles was Sie tun müssen, ist die "
3308 "<function>xxx_get_type</function>-Funktionen zusammen mit deren Includes in "
3309 "der Datei <filename>&lt;package&gt;.types</filename> aufzulisten."
3310
3311 #. (itstool) path: example/title
3312 #: C/index.docbook:2022
3313 msgid "Example &lt;package&gt;.types file"
3314 msgstr "Beispiel-Schnipsel einer &lt;package&gt;.types-Datei"
3315
3316 #. (itstool) path: example/programlisting
3317 #: C/index.docbook:2023
3318 #, no-wrap
3319 msgid ""
3320 "\n"
3321 "#include &lt;gtk/gtk.h&gt;\n"
3322 "\n"
3323 "gtk_accel_label_get_type\n"
3324 "gtk_adjustment_get_type\n"
3325 "gtk_alignment_get_type\n"
3326 "gtk_arrow_get_type\n"
3327 msgstr ""
3328 "\n"
3329 "#include &lt;gtk/gtk.h&gt;\n"
3330 "\n"
3331 "gtk_accel_label_get_type\n"
3332 "gtk_adjustment_get_type\n"
3333 "gtk_alignment_get_type\n"
3334 "gtk_arrow_get_type\n"
3335
3336 #. (itstool) path: sect1/para
3337 #: C/index.docbook:2034
3338 msgid ""
3339 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3340 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3341 "<filename>Makefile.am</filename>. If you use this approach you should not "
3342 "dist the types file nor have it under version control."
3343 msgstr ""
3344 "Seit GTK-Doc 1.8 kann <application>gtkdoc-scan</application> diese Liste für "
3345 "Sie erstellen. Fügen Sie einfach »--rebuild-types« zu SCAN_OPTIONS in "
3346 "<filename>Makefile.am</filename> hinzu. Wenn Sie so vorgehen, sollten Sie "
3347 "weder Typen-Datei mit veröffentlichen noch diese unter Versionsverwaltung "
3348 "stellen."
3349
3350 #. (itstool) path: sect1/title
3351 #: C/index.docbook:2043
3352 msgid "Editing the master document"
3353 msgstr "Bearbeiten des Master-Dokuments"
3354
3355 #. (itstool) path: sect1/para
3356 #: C/index.docbook:2045
3357 msgid ""
3358 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3359 "inline source comments, the GTK-Doc tools generate one documentation page "
3360 "per class or module as a separate file. The master document includes them "
3361 "and place them in an order."
3362 msgstr ""
3363 "GTK-Doc erstellt die Dokumentation in DocBook-SGML/XML. Beim Verarbeiten der "
3364 "in den Quellcode eingebetteten Kommentare erzeugt GTK-Doc eine "
3365 "Dokumentationsseite pro Klasse oder Modul als separate Datei. Das "
3366 "Hauptdokument schließt diese ein und setzt sie in die passende Reihenfolge."
3367
3368 #. (itstool) path: sect1/para
3369 #: C/index.docbook:2052
3370 msgid ""
3371 "While GTK-Doc creates a template master document for you, later runs will "
3372 "not touch it again. This means that one can freely structure the "
3373 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3374 "has now a test suite, where also the master-document is recreated from "
3375 "scratch. Its a good idea to look at this from time to time to see if there "
3376 "are some new goodies introduced there."
3377 msgstr ""
3378 "Während GTK-Doc ein Vorlagen-Hauptdokument für Sie erstellt, wird eine "
3379 "spätere Ausführung es nicht mehr verändern. Das bedeutet, dass Sie das "
3380 "Dokument beliebig strukturieren können. Dies schließt Gruppieren von Seiten "
3381 "und Hinzufügen von zusätzlichen Seiten ein. GTK-Doc hat eine neue Test-"
3382 "Suite, wo auch das Hauptdokument von Grund auf neu erstellt wird. Es ist "
3383 "ratsam, sich diese von Zeit zu Zeit anzusehen und zu schauen, ob dort einige "
3384 "Neuigkeiten eingeführt werden."
3385
3386 #. (itstool) path: tip/para
3387 #: C/index.docbook:2062
3388 msgid ""
3389 "Do not create tutorials as extra documents. Just write extra chapters. The "
3390 "benefit of directly embedding the tutorial for your library into the API "
3391 "documentation is that it is easy to link for the tutorial to symbol "
3392 "documentation. Apart chances are higher that the tutorial gets updates along "
3393 "with the library."
3394 msgstr ""
3395 "Erstellen Sie keine Schritt-für-Schritt-Anleitungen als zusätzliche "
3396 "Dokumente. Schreiben Sie lediglich zusätzliche Kapitel. Der Vorteil des "
3397 "direkten Einbettens einer Anleitung für Ihre Bibliothek in die API ist die "
3398 "Möglichkeit der einfachen Verknüpfung der Schritt-für-Schritt-Anleitung zur "
3399 "Symboldokumentation. Außerdem sind die Chancen größer, dass die Anleitung "
3400 "die gleichen Aktualisierungen erfährt wie die Bibliothek selbst."
3401
3402 #. (itstool) path: sect1/para
3403 #: C/index.docbook:2071
3404 msgid ""
3405 "So what are the things to change inside the master document? For a start is "
3406 "only a little. There are some placeholders (text in square brackets) there "
3407 "which you should take care of."
3408 msgstr ""
3409 "Was sollte nun innerhalb des Master-Dokuments geändert werden? Zunächst "
3410 "recht wenig. Es gibt einige Platzhalter (Text in eckigen Klammern), die Sie "
3411 "beachten sollten."
3412
3413 #. (itstool) path: example/title
3414 #: C/index.docbook:2078
3415 msgid "Master document header"
3416 msgstr "Kopfzeile des Master-Dokuments"
3417
3418 #. (itstool) path: example/programlisting
3419 #: C/index.docbook:2079
3420 #, no-wrap
3421 msgid ""
3422 "\n"
3423 "&lt;bookinfo&gt;\n"
3424 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3425 " &lt;releaseinfo&gt;\n"
3426 " for MODULENAME [VERSION]\n"
3427 " The latest version of this documentation can be found on-line at\n"
3428 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3429 " &lt;/releaseinfo&gt;\n"
3430 "&lt;/bookinfo&gt;\n"
3431 "\n"
3432 "&lt;chapter&gt;\n"
3433 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3434 msgstr ""
3435 "\n"
3436 "&lt;bookinfo&gt;\n"
3437 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3438 " &lt;releaseinfo&gt;\n"
3439 " for MODULENAME [VERSION]\n"
3440 " The latest version of this documentation can be found on-line at\n"
3441 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3442 " &lt;/releaseinfo&gt;\n"
3443 "&lt;/bookinfo&gt;\n"
3444 "\n"
3445 "&lt;chapter&gt;\n"
3446 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3447
3448 #. (itstool) path: sect1/para
3449 #: C/index.docbook:2095
3450 msgid ""
3451 "In addition a few option elements are created in commented form. You can "
3452 "review these and enable them as you like."
3453 msgstr ""
3454 "Zusätzlich werden einige Optionselemente in Kommentarform erstellt. Sie "
3455 "können sich diese anschauen und aktivieren, wenn Sie wollen."
3456
3457 #. (itstool) path: example/title
3458 #: C/index.docbook:2101
3459 msgid "Optional part in the master document"
3460 msgstr "Optionaler Teil im Master-Dokument"
3461
3462 #. (itstool) path: example/programlisting
3463 #: C/index.docbook:2102
3464 #, no-wrap
3465 msgid ""
3466 "\n"
3467 " &lt;!-- enable this when you use gobject introspection annotations\n"
3468 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3469 " --&gt;\n"
3470 msgstr ""
3471 "\n"
3472 " &lt;!-- aktivieren Sie dieses, wenn Sie gobject introspection-Anmerkungen verwenden\n"
3473 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3474 " --&gt;\n"
3475
3476 #. (itstool) path: sect1/para
3477 #: C/index.docbook:2110
3478 msgid ""
3479 "Finally you need to add new section whenever you introduce one. The <link "
3480 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3481 "you of newly generated xml files that are not yet included into the doc."
3482 msgstr ""
3483 "Schlussendlich müssen Sie einen neuen Abschnitt explizit einfügen, sobald "
3484 "Sie einen öffnen. Das Werkzeug <link linkend=\"modernizing-gtk-"
3485 "doc-1-16\">gtkdoc-check</link> erinnert Sie an neu erzeugte XML-Dateien, die "
3486 "in der Dokumentation noch nicht erfasst sind."
3487
3488 #. (itstool) path: example/title
3489 #: C/index.docbook:2118 C/index.docbook:2153
3490 msgid "Including generated sections"
3491 msgstr "Einbeziehen erzeugter Abschnitte"
3492
3493 #. (itstool) path: example/programlisting
3494 #: C/index.docbook:2119
3495 #, no-wrap
3496 msgid ""
3497 "\n"
3498 " &lt;chapter&gt;\n"
3499 " &lt;title&gt;my library&lt;/title&gt;\n"
3500 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3501 " ...\n"
3502 msgstr ""
3503 "\n"
3504 " &lt;chapter&gt;\n"
3505 " &lt;title&gt;my library&lt;/title&gt;\n"
3506 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3507 " ...\n"
3508
3509 #. (itstool) path: sect1/title
3510 #: C/index.docbook:2131
3511 msgid "Editing the section file"
3512 msgstr "Bearbeiten der Abschnittsdatei"
3513
3514 #. (itstool) path: sect1/para
3515 #: C/index.docbook:2133
3516 msgid ""
3517 "The section file is used to organise the documentation output by GTK-Doc. "
3518 "Here one specifies which symbol belongs to which module or class and control "
3519 "the visibility (public or private)."
3520 msgstr ""
3521 "Die Abschnittsdatei wird verwendet, um die Dokumentations-Ausgaben von GTK-"
3522 "Doc zu organisieren. Man gibt an, welches Symbol zu welchem Modul oder "
3523 "welcher Klasse gehört und regelt die Sichtbarkeit (öffentlich oder privat)."
3524
3525 #. (itstool) path: sect1/para
3526 #: C/index.docbook:2139
3527 msgid ""
3528 "The section file is a plain text file with tags delimiting sections. Blank "
3529 "lines are ignored and lines starting with a '#' are treated as comment lines."
3530 msgstr ""
3531 "Die Abschnittsdatei ist eine reine Textdatei mit Markierungen, welche die "
3532 "Abschnitte voneinander trennen. Leere Zeilen werden ignoriert und Zeilen, "
3533 "die mit »#« beginnen, werden als Kommentarzeilen behandelt."
3534
3535 #. (itstool) path: note/para
3536 #: C/index.docbook:2146
3537 msgid ""
3538 "While the tags make the file look like xml, it is not. Please do not close "
3539 "tags like &lt;SUBSECTION&gt;."
3540 msgstr ""
3541 "Zwar lassen die Markierungen die Datei wie XML erscheinen, doch der Schein "
3542 "trügt. Bitte schließen Sie keine Markierungen wie &lt;SUBSECTION&gt;."
3543
3544 #. (itstool) path: example/programlisting
3545 #: C/index.docbook:2154
3546 #, no-wrap
3547 msgid ""
3548 "\n"
3549 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3550 "\n"
3551 "&lt;SECTION&gt;\n"
3552 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3553 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3554 "MeepApp\n"
3555 "&lt;SUBSECTION Standard&gt;\n"
3556 "MEEP_APP\n"
3557 "...\n"
3558 "MeepAppClass\n"
3559 "meep_app_get_type\n"
3560 "&lt;/SECTION&gt;\n"
3561 msgstr ""
3562 "\n"
3563 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3564 "\n"
3565 "&lt;SECTION&gt;\n"
3566 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3567 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3568 "MeepApp\n"
3569 "&lt;SUBSECTION Standard&gt;\n"
3570 "MEEP_APP\n"
3571 "...\n"
3572 "MeepAppClass\n"
3573 "meep_app_get_type\n"
3574 "&lt;/SECTION&gt;\n"
3575
3576 #. (itstool) path: sect1/para
3577 #: C/index.docbook:2171
3578 msgid ""
3579 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3580 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3581 "FILE&gt;' will result in the section declarations being output in the "
3582 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3583 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3584 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3585 "(The name of the HTML file is based on the module name and the section "
3586 "title, or for GObjects it is based on the GObjects class name converted to "
3587 "lower case)."
3588 msgstr ""
3589 "Die Markierung &lt;FILE&gt; ... &lt;/FILE&gt; wird verwendet, um den "
3590 "Dateinamen ohne Suffix anzugeben. Zum Beispiel wird »&lt;FILE&gt;gnome-"
3591 "config&lt;/FILE&gt;« dazu führen, dass der Deklarationsabschnitt in die "
3592 "Vorlage-Datei <filename>tmpl/gnome-config.sgml</filename> ausgegeben wird, "
3593 "welche in die DocBook-XML-Datei <filename>sgml/gnome-config.sgml</filename> "
3594 "oder die DocBook-XML-Datei <filename>xml/gnome-config.xml</filename> "
3595 "umgewandelt wird. (Der Name der HTML-Datei basiert auf dem Modulnamen und "
3596 "dem Abschnittstitel. Für GObject basiert er auf dem GObject-Klassennamen in "
3597 "Kleinbuchstaben)."
3598
3599 #. (itstool) path: sect1/para
3600 #: C/index.docbook:2183
3601 msgid ""
3602 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3603 "section. It is only useful before the templates (if used) are initially "
3604 "created, since the title set in the template file overrides this. Also if "
3605 "one uses SECTION comment in the sources, this is obsolete."
3606 msgstr ""
3607 "Das Tag &lt;TITLE&gt; ... &lt;/TITLE&gt; wird zur Angabe des Abschnitttitels "
3608 "verwendet. Es ist nur nützlich bevor die Vorlagen (falls verwendet) anfangs "
3609 "erstellt werden, weil der Titel in der Vorlage diesen überschreibt. Wenn man "
3610 "das SECTION-Kommentar in den Quellen einsetzt, ist dies überflüssig."
3611
3612 #. (itstool) path: sect1/para
3613 #: C/index.docbook:2190
3614 msgid ""
3615 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3616 "Currently it outputs a blank line between subsections in the synopsis "
3617 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3618 "declarations (e.g. the functions like g_object_get_type and macros like "
3619 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3620 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3621 "declarations which will not be output (it is a handy way to avoid warning "
3622 "messages about unused declarations). If your library contains private types "
3623 "which you don't want to appear in the object hierarchy and the list of "
3624 "implemented or required interfaces, add them to a Private subsection. "
3625 "Whether you would place GObject and GObjectClass like structs in public or "
3626 "Standard section depends if they have public entries (variables, vmethods)."
3627 msgstr ""
3628 "Sie können Objekte im Abschnitt mittels der Markierung &lt;SUBSECTION&gt; "
3629 "gruppieren. Derzeit gibt es eine Leerzeile zwischen Unterabschnitten im "
3630 "Inhaltsangabe-Abschnitt aus. Sie können auch &lt;SUBSECTION Standard&gt; für "
3631 "Standard GObject-Deklarationen verwenden (z.B. Funktionen wie "
3632 "g_object_get_type und Makros wie G_OBJECT(), G_IS_OBJECT() etc.). Derzeit "
3633 "werden diese nicht in die Dokumentation aufgenommen. Sie können auch &lt;"
3634 "SUBSECTION Private&gt; für private Deklarationen verwenden, welche nicht "
3635 "ausgegeben werden. Dies ist eine praktische Möglichkeit, Warnmeldungen "
3636 "bezüglich ungenutzter Deklarationen zu vermeiden. Wenn Ihre Bibliothek "
3637 "private Typen enthält, die nicht in der Objekthierarchie und der Liste der "
3638 "implementierten oder benötigten Schnittstellen erscheinen sollen, fügen Sie "
3639 "diese zu einem »Private«-Unterabschnitt hinzu. Ob Sie GObject oder "
3640 "GObjectClass wie Structs im öffentlichen oder im Standardabschnitt "
3641 "einsetzen, hängt davon ab, ob öffentliche Einträge vorhanden sind "
3642 "(Variablen, vmethods)."
3643
3644 #. (itstool) path: sect1/para
3645 #: C/index.docbook:2209
3646 msgid ""
3647 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3648 "#include files which are shown in the synopsis sections. It contains a comma-"
3649 "separate list of #include files, without the angle brackets. If you set it "
3650 "outside of any sections, it acts for all sections until the end of the file. "
3651 "If you set it within a section, it only applies to that section."
3652 msgstr ""
3653 "Sie können auch &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; verwenden, um die "
3654 "#include-Dateien anzugeben, die in den Abschnitten zur Inhaltsangabe gezeigt "
3655 "werden. Es enthält eine durch Kommata getrennte Liste von #include-Dateien "
3656 "ohne eckige Klammern. Wenn Sie es außerhalb aller Abschnitte festlegen, "
3657 "wirkt es in allen Abschnitten bis zum Dateiende. Wenn Sie es innerhalb eines "
3658 "Abschnitts festlegen, wirkt es nur in diesem Abschnitt."
3659
3660 #. (itstool) path: chapter/title
3661 #: C/index.docbook:2223
3662 msgid "Controlling the result"
3663 msgstr "Überprüfung des Ergebnisses"
3664
3665 #. (itstool) path: chapter/para
3666 #: C/index.docbook:2225
3667 msgid ""
3668 "A GTK-Doc run generates report files inside the documentation directory. The "
3669 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3670 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3671 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3672 "files that can be viewed and postprocessed easily."
3673 msgstr ""
3674 "Ein GTK-Doc-Durchlauf erzeugt Protokolldateien im Dokumentationsordner. Die "
3675 "Namen der erzeugten Dateien sind: <filename>&lt;package&gt;-undocumented."
3676 "txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> und "
3677 "<filename>&lt;package&gt;-unused.txt</filename>. Sie liegen alle als "
3678 "Klartext vor und können daher einfach betrachtet und weiterverarbeitet "
3679 "werden."
3680
3681 #. (itstool) path: chapter/para
3682 #: C/index.docbook:2234
3683 msgid ""
3684 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3685 "the documentation coverage summary. Below are two sections divided by blank "
3686 "lines. The first section lists undocumented or incomplete symbols. The "
3687 "second section does the same for section docs. Incomplete entries are those, "
3688 "which have documentation, but where e.g. a new parameter has been added."
3689 msgstr ""
3690 "Die Datei <filename>&lt;package&gt;-undocumented.txt</filename> beginnt mit "
3691 "der Zusammenfassung der Dokumentation. Darunter sind zwei durch Leerzeilen "
3692 "getrennte Abschnitte. Der erste Abschnitt listet undokumentierte oder "
3693 "unvollständige Symbole. Der zweite Abschnitt macht das gleiche für "
3694 "Abschnitts-Dokumente. Unvollständige Einträge sind jene, welche "
3695 "Dokumentation haben, aber z.B. ein neuer Parameter hinzugefügt worden ist."
3696
3697 #. (itstool) path: chapter/para
3698 #: C/index.docbook:2243
3699 msgid ""
3700 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3701 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3702 "in the sources. Check if they have been removed or if they are misspelled."
3703 msgstr ""
3704 "Die Datei <filename>&lt;package&gt;-undeclared.txt</filename> listet die in "
3705 "<filename>&lt;package&gt;-sections.txt</filename> gelieferten, aber nicht in "
3706 "den Quellen gefundenen Symbole. Prüfen Sie, ob diese entfernt oder falsch "
3707 "geschrieben wurden."
3708
3709 #. (itstool) path: chapter/para
3710 #: C/index.docbook:2250
3711 msgid ""
3712 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3713 "where the GTK-Doc scanner has found documentation, but does not know where "
3714 "to put it. This means that the symbol has not yet been added to the "
3715 "<filename>&lt;package&gt;-sections.txt</filename> file."
3716 msgstr ""
3717 "Die Datei <filename>&lt;package&gt;-unused.txt</filename> listet Symbolnamen "
3718 "auf, in denen der GTK-Doc-Scanner Dokumentation gefunden hat, aber nicht "
3719 "weiß, wo sie abgelegt werden soll. Dies bedeutet, dass das Symbol noch nicht "
3720 "der Datei <filename>&lt;package&gt;-sections.txt</filename> hinzugefügt "
3721 "wurde."
3722
3723 #. (itstool) path: tip/para
3724 #: C/index.docbook:2258
3725 msgid ""
3726 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile."
3727 "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during "
3728 "<command>make check</command> run."
3729 msgstr ""
3730 "Aktivieren Sie oder fügen Sie die Zeile <option>TESTS=$(GTKDOC_CHECK)</"
3731 "option> in Makefile.am hinzu. Wenn zumindest GTK-Doc 1.9 installiert ist, so "
3732 "wird damit eine Plausibilitätsprüfung während <command>make check</command> "
3733 "ausgeführt."
3734
3735 #. (itstool) path: chapter/para
3736 #: C/index.docbook:2265
3737 msgid ""
3738 "One can also look at the files produced by the source code scanner: "
3739 "<filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;"
3740 "package&gt;-decl.txt</filename>. The first one can be compared with the "
3741 "section file if that is manually maintained. The second lists all "
3742 "declarations from the headers. If a symbol is missing one could check if "
3743 "this file contains it."
3744 msgstr ""
3745 "Man kann sich auch die Dateien ansehen, die durch den Quellcode-Scanner "
3746 "erzeugt wurden: <filename>&lt;package&gt;-decl-list.txt</filename> und "
3747 "<filename>&lt;package&gt;-decl.txt</filename>. Die erste kann mit der "
3748 "Abschnittsdatei verglichen werden, falls diese händisch verwaltet wird. Die "
3749 "zweite listet alle Deklarationen aus den Kopfdateien. Falls ein Symbol fehlt "
3750 "kann man prüfen, ob diese Datei es enthält."
3751
3752 #. (itstool) path: chapter/para
3753 #: C/index.docbook:2274
3754 msgid ""
3755 "If the project is GObject based, one can also look into the files produced "
3756 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3757 "<filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
3758 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
3759 "prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</"
3760 "filename>. If there are missing symbols in any of those, one can ask GTK-Doc "
3761 "to keep the intermediate scanner file for further analysis, by running it as "
3762 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3763 msgstr ""
3764 "Wenn das Projekt auf GObject basiert, kann man auch in die Dateien schauen, "
3765 "die der Objekt-Scanner erzeugt hat: <filename>&lt;package&gt;.args.txt</"
3766 "filename>, <filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;"
3767 "package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;."
3768 "prerequisites.txt</filename> und <filename>&lt;package&gt;.signals.txt</"
3769 "filename>. Falls in irgendeiner Datei Symbole fehlen, können Sie Gtk-Doc "
3770 "anweisen, die zwischenläufige Scanner-Datei zur weiteren Analyse zu "
3771 "behalten, indem Sie <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command> "
3772 "ausführen."
3773
3774 #. (itstool) path: chapter/title
3775 #: C/index.docbook:2289
3776 msgid "Modernizing the documentation"
3777 msgstr "Die Dokumentation modernisieren"
3778
3779 #. (itstool) path: chapter/para
3780 #: C/index.docbook:2291
3781 msgid ""
3782 "GTK-Doc has been around for quite some time. In this section we list new "
3783 "features together with the version since when it is available."
3784 msgstr ""
3785 "GTK-Doc ist schon seit längerer Zeit verfügbar. In diesem Abschnitt zeigen "
3786 "wir neue Features und die Version, mit der sie eingeführt wurden."
3787
3788 #. (itstool) path: sect1/title
3789 #: C/index.docbook:2297
3790 msgid "GTK-Doc 1.9"
3791 msgstr "GTK-Doc 1.9"
3792
3793 #. (itstool) path: sect1/para
3794 #: C/index.docbook:2299
3795 msgid ""
3796 "When using xml instead of sgml, one can actually name the master document "
3797 "<filename>&lt;package&gt;-docs.xml</filename>."
3798 msgstr ""
3799 "Wenn Sie XML anstatt SGML verwenden, können Sie das Hauptdokument "
3800 "<filename>&lt;package&gt;-docs.xml</filename> nennen."
3801
3802 #. (itstool) path: sect1/para
3803 #: C/index.docbook:2304
3804 msgid ""
3805 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3806 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3807 "package&gt;-sections.txt</filename> is autogenerated and can be removed from "
3808 "the vcs. This only works nicely for projects that have a very regular "
3809 "structure (e.g. each .{c,h} pair will create new section). If one organize a "
3810 "project close to that updating a manually maintained section file can be as "
3811 "simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-"
3812 "sections.txt</code>."
3813 msgstr ""
3814 "Diese Version unterstützt <option>SCAN_OPTIONS=--rebuild-sections</option> "
3815 "in <filename>Makefile.am</filename>. Wenn dies aktiviert ist, wird die Datei "
3816 "<filename>&lt;package&gt;-sections.txt</filename> automatisch erzeugt und "
3817 "kann aus der Versionsverwaltung entfernt werden. Dies funktioniert nur "
3818 "sauber in Projekten, die eine strikt »reguläre« Struktur haben (zum Beispiel "
3819 "erzeugt jedes .{c,h}-Paar einen neuen Abschnitt). In einem solch sauber "
3820 "organisierten Projekt kann dann mit dem Befehl <code>meld &lt;package&gt;-"
3821 "decl-list.txt &lt;package&gt;-sections.txt</code> eine manuell verwaltete "
3822 "Abschnittsdatei sehr einfach aktualisiert werden."
3823
3824 #. (itstool) path: sect1/para
3825 #: C/index.docbook:2315
3826 msgid ""
3827 "Version 1.8 already introduced the syntax for documenting sections in the "
3828 "sources instead of the separate files under <filename "
3829 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
3830 "whole doc module to not use the extra tmpl build step at all, by using "
3831 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
3832 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
3833 "your source control system and haven't yet switched, just add the flag to "
3834 "<filename>configure.ac</filename> and you are done."
3835 msgstr ""
3836 "In Version 1.8 wurde bereits die Syntax für Dokumentationsabschnitte in den "
3837 "Quelltexten anstelle von separaten Dateien unter <filename "
3838 "class=\"directory\">tmpl</filename> eingeführt. Diese Version fügt Optionen "
3839 "zur Umstellung des gesamten Dokumentationsmoduls auf das neue Verhalten "
3840 "hinzu, sodass kein zusätzlicher tmpl-Erstellungsschritt mehr nötig ist. Dazu "
3841 "dient die Option <option>--flavour no-tmpl</option> in <filename>configure."
3842 "ac</filename>. Wenn Sie keinen Ordner namens <filename "
3843 "class=\"directory\">tmpl</filename> in die Versionsverwaltung eingestellt "
3844 "haben und noch nicht umgestellt haben, fügen Sie einfach die Option zu "
3845 "<filename>configure.ac</filename> hinzu, und die Sache ist erledigt."
3846
3847 #. (itstool) path: sect1/title
3848 #: C/index.docbook:2327
3849 msgid "GTK-Doc 1.10"
3850 msgstr "GTK-Doc 1.10"
3851
3852 #. (itstool) path: sect1/para
3853 #: C/index.docbook:2329
3854 msgid ""
3855 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3856 "<filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;"
3857 "package&gt;.types</filename> is autogenerated and can be removed from the "
3858 "vcs. When using this feature it is important to also setup the "
3859 "<varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3860 "code that is build conditionally."
3861 msgstr ""
3862 "Diese Version unterstützt <option>SCAN_OPTIONS=--rebuild-typess</option> in "
3863 "<filename>Makefile.am</filename>. Wenn dies aktiviert ist, wird die Datei "
3864 "<filename>&lt;package&gt;.types</filename> automatisch erzeugt und kann aus "
3865 "der Versionsverwaltung entfernt werden. Dieses Feature erfordert die "
3866 "Einrichtung von <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</"
3867 "filename> für Code, der nur unter bestimmten Bedingungen erstellt werden "
3868 "soll."
3869
3870 #. (itstool) path: sect1/title
3871 #: C/index.docbook:2340
3872 msgid "GTK-Doc 1.16"
3873 msgstr "GTK-Doc 1.16"
3874
3875 #. (itstool) path: example/title
3876 #: C/index.docbook:2346
3877 msgid "Enable gtkdoc-check"
3878 msgstr "gtkdoc-check einschalten"
3879
3880 #. (itstool) path: example/programlisting
3881 #: C/index.docbook:2347
3882 #, no-wrap
3883 msgid ""
3884 "\n"
3885 "if ENABLE_GTK_DOC\n"
3886 "TESTS_ENVIRONMENT = \\\n"
3887 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3888 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3889 "TESTS = $(GTKDOC_CHECK)\n"
3890 "endif\n"
3891 msgstr ""
3892 "\n"
3893 "if ENABLE_GTK_DOC\n"
3894 "TESTS_ENVIRONMENT = \\\n"
3895 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3896 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3897 "TESTS = $(GTKDOC_CHECK)\n"
3898 "endif\n"
3899
3900 #. (itstool) path: sect1/para
3901 #: C/index.docbook:2342
3902 msgid ""
3903 "This version includes a new tool called gtkdoc-check. This tool can run a "
3904 "set of sanity checks on your documentation. It is enabled by adding these "
3905 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3906 msgstr ""
3907 "Diese Version führt ein neues Werkzeug namens gtkdoc-check ein. Damit können "
3908 "Sie eine Reihe von Plausibilitätsprüfungen auf Ihre Dokumentation anwenden. "
3909 "Um es zu aktivieren, fügen Sie folgende Zeilen am Ende von "
3910 "<filename>Makefile.am</filename> hinzu. <_:example-1/>"
3911
3912 #. (itstool) path: sect1/title
3913 #: C/index.docbook:2360
3914 msgid "GTK-Doc 1.20"
3915 msgstr "GTK-Doc 1.20"
3916
3917 #. (itstool) path: sect1/para
3918 #: C/index.docbook:2362
3919 msgid ""
3920 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3921 "comments is less intrusive than writing docbook xml. This version improves a "
3922 "lot on this and add a lot more styles. The section that explains the <link "
3923 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3924 msgstr ""
3925 "In Version 1.18 wurde erstmals Unterstützung für Markdown eingeführt. Die "
3926 "Verwendung von Markdown in Dokumentationskommentaren ist weniger aufwändig "
3927 "als das Schreiben von DocBook XML. Diese Version bringt diesbezüglich "
3928 "wesentliche Verbesserungen und fügt zahlreiche weitere Stile hinzu. Alle "
3929 "Details hierzu finden Sie im Abschnitt zur <link "
3930 "linkend=\"documenting_syntax\">Kommentarsyntax</link>."
3931
3932 #. (itstool) path: sect1/title
3933 #: C/index.docbook:2372
3934 msgid "GTK-Doc 1.25"
3935 msgstr "GTK-Doc 1.25"
3936
3937 #. (itstool) path: example/title
3938 #: C/index.docbook:2383
3939 msgid "Use pre-generated entities"
3940 msgstr "Vorerzeugte Entitäten verwenden"
3941
3942 #. (itstool) path: example/programlisting
3943 #: C/index.docbook:2384
3944 #, no-wrap
3945 msgid ""
3946 "\n"
3947 "&lt;?xml version=\"1.0\"?&gt;\n"
3948 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3949 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3950 "[\n"
3951 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3952 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3953 " %gtkdocentities;\n"
3954 "]&gt;\n"
3955 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3956 " &lt;bookinfo&gt;\n"
3957 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3958 " &lt;releaseinfo&gt;\n"
3959 " for &amp;package_string;.\n"
3960 " The latest version of this documentation can be found on-line at\n"
3961 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3962 " &lt;/releaseinfo&gt;\n"
3963 " &lt;/bookinfo&gt;\n"
3964 msgstr ""
3965 "\n"
3966 "&lt;?xml version=\"1.0\"?&gt;\n"
3967 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3968 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3969 "[\n"
3970 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3971 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3972 " %gtkdocentities;\n"
3973 "]&gt;\n"
3974 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3975 " &lt;bookinfo&gt;\n"
3976 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3977 " &lt;releaseinfo&gt;\n"
3978 " for &amp;package_string;.\n"
3979 " The latest version of this documentation can be found on-line at\n"
3980 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3981 " &lt;/releaseinfo&gt;\n"
3982 " &lt;/bookinfo&gt;\n"
3983
3984 #. (itstool) path: sect1/para
3985 #: C/index.docbook:2374
3986 msgid ""
3987 "The makefiles shipped with this version generate an entity file at "
3988 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3989 "package_name and package_version. You can use this e.g. in the main xml file "
3990 "to avoid hardcoding the version number. Below is an example that shows how "
3991 "the entity file is included in the master template and how the entities are "
3992 "used. The entities can also be used in all generated files, GTK-Doc will use "
3993 "the same xml header in generated xml files. <_:example-1/>"
3994 msgstr ""
3995 "Die in dieser Version enthaltenen Make-Steuerdateien erzeugen die "
3996 "Entitätsdatei <filename>xml/gtkdocentities.ent</filename>, die Entitäten für "
3997 "beispielsweise package_name und package_version enthält. Sie können diese in "
3998 "der XML-Hauptdatei verwenden, um eine fest codierte Versionsnummer zu "
3999 "vermeiden. Nachfolgend finden Sie ein Beispiel, wie die Entitätsdatei "
4000 "einbezogen wird und und wie die Einträge verwendet werden. Die Entitäten "
4001 "können auch in allen generierten Dateien verwendet werden. GTK-Doc verwendet "
4002 "die gleichen XML-Kopfeinträge auch in generierten Dateien. <_:example-1/>"
4003
4004 #. (itstool) path: chapter/title
4005 #: C/index.docbook:2409
4006 msgid "Documenting other interfaces"
4007 msgstr "Dokumentieren anderer Schnittstellen"
4008
4009 #. (itstool) path: chapter/para
4010 #: C/index.docbook:2411
4011 msgid ""
4012 "So far we have been using GTK-Doc to document the API of code. The next "
4013 "sections contain suggestions how the tools can be used to document other "
4014 "interfaces too."
4015 msgstr ""
4016 "Bis jetzt haben wir GTK-Doc nur dazu verwendet, die API des Codes zu "
4017 "dokumentieren. In den nächsten Abschnitten finden Sie Vorschläge, wie die "
4018 "Werkzeuge zum Dokumentieren anderer Schnittstellen eingesetzt werden können."
4019
4020 #. (itstool) path: sect1/title
4021 #: C/index.docbook:2418
4022 msgid "Command line options and man pages"
4023 msgstr "Befehlszeilenoptionen und Handbuchseiten"
4024
4025 #. (itstool) path: sect1/para
4026 #: C/index.docbook:2420
4027 msgid ""
4028 "As one can generate man pages for a docbook refentry as well, it sounds like "
4029 "a good idea to use it for that purpose. This way the interface is part of "
4030 "the reference and one gets the man-page for free."
4031 msgstr ""
4032 "Weil man ebenso man-Hilfeseiten für einen docbook-Referenzeintrag erstellen "
4033 "kann, klingt es nach einer guten Idee, es für diesen Zweck einzusetzen. Auf "
4034 "diese Weise ist die Schnittstelle Teil der Referenz und man erhält "
4035 "kostenfrei die man-Hilfeseite."
4036
4037 #. (itstool) path: sect2/title
4038 #: C/index.docbook:2427
4039 msgid "Document the tool"
4040 msgstr "Dokumentieren des Werkzeuges"
4041
4042 #. (itstool) path: sect2/para
4043 #: C/index.docbook:2429
4044 msgid ""
4045 "Create one refentry file per tool. Following <link "
4046 "linkend=\"settingup_docfiles\">our example</link> we would call it "
4047 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
4048 "that should be used and can look at generated file in the xml subdirectory "
4049 "as well as examples e.g. in glib."
4050 msgstr ""
4051 "Erstellen Sie eine Referenzeintragsdatei pro Werkzeug. In <link "
4052 "linkend=\"settingup_docfiles\">unserem Beispiel</link> nennen wir sie "
4053 "<filename>meep/docs/reference/meeper/meep.xml</filename>. Für die zu "
4054 "verwendenden XML-Markierungen können Sie die generierte Datei im XML-"
4055 "Unterordner oder Beispiele (z.B. in glib) ansehen."
4056
4057 #. (itstool) path: sect2/title
4058 #: C/index.docbook:2439
4059 msgid "Adding the extra configure check"
4060 msgstr "Hinzufügen der zusätzlichen Configure-Überprüfungen"
4061
4062 #. (itstool) path: example/title
4063 #: C/index.docbook:2442 C/index.docbook:2460
4064 msgid "Extra configure checks"
4065 msgstr "Zusätzliche Configure-Überprüfungen"
4066
4067 #. (itstool) path: example/programlisting
4068 #: C/index.docbook:2443
4069 #, no-wrap
4070 msgid ""
4071 "\n"
4072 "AC_ARG_ENABLE(man,\n"
4073 " [AC_HELP_STRING([--enable-man],\n"
4074 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4075 " enable_man=no)\n"
4076 "\n"
4077 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4078 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4079 msgstr ""
4080 "\n"
4081 "AC_ARG_ENABLE(man,\n"
4082 " [AC_HELP_STRING([--enable-man],\n"
4083 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4084 " enable_man=no)\n"
4085 "\n"
4086 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4087 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4088
4089 #. (itstool) path: sect2/title
4090 #: C/index.docbook:2457
4091 msgid "Adding the extra makefile rules"
4092 msgstr "Hinzufügen der zusätzlichen Makefile-Regeln"
4093
4094 #. (itstool) path: example/programlisting
4095 #: C/index.docbook:2461
4096 #, no-wrap
4097 msgid ""
4098 "\n"
4099 "man_MANS = \\\n"
4100 " meeper.1\n"
4101 "\n"
4102 "if ENABLE_GTK_DOC\n"
4103 "if ENABLE_MAN\n"
4104 "\n"
4105 "%.1 : %.xml\n"
4106 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4107 "\n"
4108 "endif\n"
4109 "endif\n"
4110 "\n"
4111 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4112 "EXTRA_DIST += meep.xml\n"
4113 msgstr ""
4114 "\n"
4115 "man_MANS = \\\n"
4116 " meeper.1\n"
4117 "\n"
4118 "if ENABLE_GTK_DOC\n"
4119 "if ENABLE_MAN\n"
4120 "\n"
4121 "%.1 : %.xml\n"
4122 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4123 "\n"
4124 "endif\n"
4125 "endif\n"
4126 "\n"
4127 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4128 "EXTRA_DIST += meep.xml\n"
4129
4130 #. (itstool) path: sect1/title
4131 #: C/index.docbook:2483
4132 msgid "DBus interfaces"
4133 msgstr "DBus-Schnittstellen"
4134
4135 #. (itstool) path: sect1/para
4136 #: C/index.docbook:2485
4137 msgid ""
4138 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4139 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4140 msgstr ""
4141 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4142 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4143
4144 #. (itstool) path: chapter/title
4145 #: C/index.docbook:2494
4146 msgid "Frequently asked questions"
4147 msgstr "Häufig gestellte Fragen"
4148
4149 #. (itstool) path: segmentedlist/segtitle
4150 #: C/index.docbook:2498
4151 msgid "Question"
4152 msgstr "Frage"
4153
4154 #. (itstool) path: segmentedlist/segtitle
4155 #: C/index.docbook:2499
4156 msgid "Answer"
4157 msgstr "Antwort"
4158
4159 #. (itstool) path: seglistitem/seg
4160 #: C/index.docbook:2501
4161 msgid "No class hierarchy."
4162 msgstr "Keine Klassenhierarchie."
4163
4164 #. (itstool) path: seglistitem/seg
4165 #: C/index.docbook:2502
4166 msgid ""
4167 "The objects <function>xxx_get_type()</function> function has not been "
4168 "entered into the <filename>&lt;package&gt;.types</filename> file."
4169 msgstr ""
4170 "Die <function>xxx_get_type()</function>-Funktion des Objekts wurde nicht in "
4171 "die Datei <filename>&lt;package&gt;.types</filename> eingegeben."
4172
4173 #. (itstool) path: seglistitem/seg
4174 #: C/index.docbook:2508
4175 msgid "Still no class hierarchy."
4176 msgstr "Noch immer keine Klassenhierarchie."
4177
4178 #. (itstool) path: seglistitem/seg
4179 #: C/index.docbook:2509
4180 msgid ""
4181 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4182 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4183 "October/msg00006.html\">explanation</ulink>)."
4184 msgstr ""
4185 "Fehlende oder falsche Benennung in der Datei <filename>&lt;Paket&gt;-"
4186 "sections.txt</filename> (lesen Sie die <ulink url=\"http://mail.gnome.org/"
4187 "archives/gtk-doc-list/2003-October/msg00006.html\">Erklärung</ulink>)."
4188
4189 #. (itstool) path: seglistitem/seg
4190 #: C/index.docbook:2515
4191 msgid "Damn, I have still no class hierarchy."
4192 msgstr "Verdammt, ich habe immer noch keine Klassenhierarchie."
4193
4194 #. (itstool) path: seglistitem/seg
4195 #: C/index.docbook:2516
4196 msgid ""
4197 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4198 "type>) part of the normal section (don't put this into Standard or Private "
4199 "subsections)."
4200 msgstr ""
4201 "Ist der Objektname (Name des Instanz-struct, z.B. <type>GtkWidget</type>) "
4202 "Teil des normalen Abschnitts (nicht in den Standard- oder Unterabschnitten)."
4203
4204 #. (itstool) path: seglistitem/seg
4205 #: C/index.docbook:2523
4206 msgid "No symbol index."
4207 msgstr "Kein Symbolindex."
4208
4209 #. (itstool) path: seglistitem/seg
4210 #: C/index.docbook:2524
4211 msgid ""
4212 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4213 "index that xi:includes the generated index?"
4214 msgstr ""
4215 "Enthält <filename>&lt;package&gt;-docs.{xml,sgml}</filename> einen Index, "
4216 "der den erstellten Index xi:enthält?"
4217
4218 #. (itstool) path: seglistitem/seg
4219 #: C/index.docbook:2530
4220 msgid "Symbols are not linked to their doc-section."
4221 msgstr "Symbole werden nicht mit deren Dokumentationsabschnitt verknüpft."
4222
4223 #. (itstool) path: seglistitem/seg
4224 #: C/index.docbook:2531
4225 msgid ""
4226 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4227 "gtkdoc-fixxref warns about unresolvable xrefs."
4228 msgstr ""
4229 "Verwendet das doc-comment das richtige Markup (hinzugefügtes »#«,»%« oder "
4230 "»()«)? Prüfen Sie, ob gtkdoc-fixxref wegen nicht auflösbarer xrefs warnt."
4231
4232 #. (itstool) path: seglistitem/seg
4233 #: C/index.docbook:2537
4234 msgid "A new class does not appear in the docs."
4235 msgstr "Eine neue Klasse erscheint nicht in der Dokumentation."
4236
4237 #. (itstool) path: seglistitem/seg
4238 #: C/index.docbook:2538
4239 msgid ""
4240 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4241 "filename>."
4242 msgstr ""
4243 "Ist die neue Seite xi:eingebunden von <filename>&lt;package&gt;-docs.{xml,"
4244 "sgml}</filename>?"
4245
4246 #. (itstool) path: seglistitem/seg
4247 #: C/index.docbook:2544
4248 msgid "A new symbol does not appear in the docs."
4249 msgstr "Ein neues Symbol erscheint nicht in der Dokumentation."
4250
4251 #. (itstool) path: seglistitem/seg
4252 #: C/index.docbook:2545
4253 msgid ""
4254 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4255 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4256 "xrefs. Check if the symbol is correctly listed in the <filename>&lt;"
4257 "package&gt;-sections.txt</filename> in a public subsection."
4258 msgstr ""
4259 "Ist doc-comment ordnungsgemäß formatiert? Prüfen Sie den Anfang des "
4260 "Dokuments auf Rechtschreibfehler im Kommentar. Prüfen Sie, ob gtkdoc-fixxref "
4261 "wegen unauflösbarer xrefs warnt. Prüfen Sie, ob das Symbol richtig in "
4262 "<filename>&lt;package&gt;-sections.txt</filename> in einem öffentlichen "
4263 "Abschnitt gelistet ist."
4264
4265 #. (itstool) path: seglistitem/seg
4266 #: C/index.docbook:2553
4267 msgid "A type is missing from the class hierarchy."
4268 msgstr "Ein Typ fehlt in der Klassenhierarchie."
4269
4270 #. (itstool) path: seglistitem/seg
4271 #: C/index.docbook:2554
4272 msgid ""
4273 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4274 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4275 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4276 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4277 "or incidentally marked private it will not be shown."
4278 msgstr ""
4279 "Wenn der Typ in <filename>&lt;package&gt;.hierarchy</filename> gelistet ist, "
4280 "aber nicht in <filename>xml/tree_index.sgml</filename>, dann prüfen Sie "
4281 "sorgfältig, ob der Typ ordnungsgemäß in <filename>&lt;package&gt;-sections."
4282 "txt</filename> abgelegt ist. Falls die Typ-Instanz (z.B. <type>GtkWidget</"
4283 "type>) nicht aufgelistet oder versehentlich als privat markiert ist, so wird "
4284 "sie nicht angezeigt."
4285
4286 #. (itstool) path: seglistitem/seg
4287 #: C/index.docbook:2563
4288 msgid "I get foldoc links for all gobject annotations."
4289 msgstr "Ich erhalte foldoc-Verweise für alle gobjekt-Anmerkungen."
4290
4291 #. (itstool) path: seglistitem/seg
4292 #: C/index.docbook:2564
4293 msgid ""
4294 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4295 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4296 msgstr ""
4297 "Prüfen Sie, ob <filename>xml/annotation-glossary.xml</filename> von "
4298 "<filename>&lt;package&gt;-docs.{xml,sgml}</filename> xi:eingebunden ist."
4299
4300 #. (itstool) path: seglistitem/seg
4301 #: C/index.docbook:2572
4302 msgid "Parameter described in source code comment block but does not exist"
4303 msgstr ""
4304 "Parameter wird im Kommentarblock des Quellcodes beschrieben, aber existiert "
4305 "nicht"
4306
4307 #. (itstool) path: seglistitem/seg
4308 #: C/index.docbook:2573
4309 msgid ""
4310 "Check if the prototype in the header has different parameter names as in the "
4311 "source."
4312 msgstr ""
4313 "Überprüfen Sie, ob die Parameternamen der Prototypen in der Quelle und im "
4314 "Header unterschiedlich sind."
4315
4316 #. (itstool) path: seglistitem/seg
4317 #: C/index.docbook:2578
4318 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4319 msgstr "Mehrfache »IDs« für »constraint linkend: XYZ«"
4320
4321 #. (itstool) path: seglistitem/seg
4322 #: C/index.docbook:2579
4323 msgid ""
4324 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4325 "filename> file."
4326 msgstr ""
4327 "Das Symbol XYZ erscheint zweifach in der Datei <filename>&lt;package&gt;-"
4328 "sections.txt</filename>."
4329
4330 #. (itstool) path: seglistitem/seg
4331 #: C/index.docbook:2582
4332 msgid ""
4333 "Element typename in namespace '' encountered in para, but no template "
4334 "matches."
4335 msgstr ""
4336 "Element-Typname im Namensraum '' in einem Abschnitt, der keiner Vorlage "
4337 "entspricht."
4338
4339 #. (itstool) path: chapter/title
4340 #: C/index.docbook:2589
4341 msgid "Tools related to gtk-doc"
4342 msgstr "Werkzeuge mit Bezug zu gtk-doc"
4343
4344 #. (itstool) path: chapter/para
4345 #: C/index.docbook:2591
4346 msgid ""
4347 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4348 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4349 "integrates with the trac search."
4350 msgstr ""
4351 "GtkDocPlugin - ein <ulink url=\"http://trac-hacks.org/wiki/"
4352 "GtkDocPlugin\">Trac GTK-Doc</ulink> Integrations-Plugin, das API-Dokumente "
4353 "zu einer trac-Seite hinzufügt und die trac-Suche einbindet."
4354
4355 #. (itstool) path: chapter/para
4356 #: C/index.docbook:2596
4357 msgid ""
4358 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4359 "tags in the API to determine the minimum required version."
4360 msgstr ""
4361 "Gtkdoc-depscan - ein Werkzeug (Teil von gtk-doc), um die verwendete API für "
4362 "die minimal erforderliche Version zu prüfen."
4363
4364 #. (itstool) path: appendixinfo/releaseinfo
4365 #: C/fdl-appendix.xml:12
4366 msgid "Version 1.1, March 2000"
4367 msgstr "Version 1.1, März 2000"
4368
4369 #. (itstool) path: copyright/year
4370 #: C/fdl-appendix.xml:16
4371 msgid "2000"
4372 msgstr "2000"
4373
4374 #. (itstool) path: copyright/holder
4375 #: C/fdl-appendix.xml:16
4376 msgid "Free Software Foundation, Inc."
4377 msgstr "Free Software Foundation, Inc."
4378
4379 #. (itstool) path: address/street
4380 #: C/fdl-appendix.xml:20
4381 msgid "51 Franklin Street, Suite 330"
4382 msgstr "51 Franklin Street, Suite 330"
4383
4384 #. (itstool) path: address/city
4385 #: C/fdl-appendix.xml:21
4386 msgid "Boston"
4387 msgstr "Boston"
4388
4389 #. (itstool) path: address/state
4390 #: C/fdl-appendix.xml:21
4391 msgid "MA"
4392 msgstr "MA"
4393
4394 #. (itstool) path: address/postcode
4395 #: C/fdl-appendix.xml:22
4396 msgid "02110-1301"
4397 msgstr "02110-1301"
4398
4399 #. (itstool) path: address/country
4400 #: C/fdl-appendix.xml:22
4401 msgid "USA"
4402 msgstr "USA"
4403
4404 #. (itstool) path: para/address
4405 #: C/fdl-appendix.xml:20
4406 msgid ""
4407 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
4408 "postcode-4/> <_:country-5/>"
4409 msgstr ""
4410 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> <_:"
4411 "postcode-4/> <_:country-5/>"
4412
4413 #. (itstool) path: legalnotice/para
4414 #: C/fdl-appendix.xml:19
4415 msgid ""
4416 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4417 "of this license document, but changing it is not allowed."
4418 msgstr ""
4419 "<_:address-1/>. Es ist jedermann erlaubt, wortwörtliche Kopien dieses "
4420 "Lizenzdokuments zu erstellen und zu verbreiten, Änderungen sind jedoch nicht "
4421 "zulässig. Dies ist eine inoffizielle Übersetzung der GNU Free Documentation "
4422 "License (GFDL), Version 1.1, ins Deutsche. Sie wurde nicht von der Free "
4423 "Software Foundation veröffentlicht, und legt nicht gesetzlich die "
4424 "Verteilungsbedingungen für Dokumente fest, die die GFDL nutzen -- nur der "
4425 "<ulink type=\"http\" url=\"http://www.gnu.org/copyleft/fdl.html\">originale "
4426 "englische Text</ulink> der GFDL tut dies. Wie auch immer, ich hoffe, dass "
4427 "sie Deutschsprachigen hilft, die GFDL besser zu verstehen. Dieser Text wurde "
4428 "von der spanischen Version übertragen."
4429
4430 #. (itstool) path: appendix/title
4431 #. (itstool) path: para/quote
4432 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4433 msgid "GNU Free Documentation License"
4434 msgstr "GNU Freie Dokumentationslizenz"
4435
4436 #. (itstool) path: sect1/title
4437 #: C/fdl-appendix.xml:31
4438 msgid "0. PREAMBLE"
4439 msgstr "0. VORWORT"
4440
4441 #. (itstool) path: para/quote
4442 #: C/fdl-appendix.xml:34
4443 msgid "free"
4444 msgstr "frei"
4445
4446 #. (itstool) path: sect1/para
4447 #: C/fdl-appendix.xml:32
4448 msgid ""
4449 "The purpose of this License is to make a manual, textbook, or other written "
4450 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4451 "effective freedom to copy and redistribute it, with or without modifying it, "
4452 "either commercially or noncommercially. Secondarily, this License preserves "
4453 "for the author and publisher a way to get credit for their work, while not "
4454 "being considered responsible for modifications made by others."
4455 msgstr ""
4456 "Der Zweck dieser Lizenz ist es, eine Anleitung, ein Textbuch oder andere "
4457 "geschriebene Dokumente <_:quote-1/> im Sinne von Freiheit zu halten: jedem "
4458 "die effektive Freiheit zu sichern, es zu kopieren und weiter zu verteilen, "
4459 "mit oder ohne es zu ändern, entweder kommerziell oder nichtkommerziell. "
4460 "Zweitens sichert diese Lizenz dem Autor und Veröffentlicher einen Weg, "
4461 "Anerkennung für seine Arbeit zu bekommen, ohne dabei für Änderungen anderer "
4462 "verantwortlich zu sein."
4463
4464 #. (itstool) path: para/quote
4465 #: C/fdl-appendix.xml:44
4466 msgid "copyleft"
4467 msgstr "copyleft"
4468
4469 #. (itstool) path: sect1/para
4470 #: C/fdl-appendix.xml:43
4471 msgid ""
4472 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4473 "the document must themselves be free in the same sense. It complements the "
4474 "GNU General Public License, which is a copyleft license designed for free "
4475 "software."
4476 msgstr ""
4477 "Diese Lizenz ist eine Art <_:quote-1/>, das heißt, dass abgeleitete Arbeiten "
4478 "des Dokumentes selbst wieder im gleichen Sinne frei sein müssen. Es ergänzt "
4479 "die GNU General Public License, die eine Copyleft-Lizenz für freie Software "
4480 "darstellt."
4481
4482 #. (itstool) path: sect1/para
4483 #: C/fdl-appendix.xml:50
4484 msgid ""
4485 "We have designed this License in order to use it for manuals for free "
4486 "software, because free software needs free documentation: a free program "
4487 "should come with manuals providing the same freedoms that the software does. "
4488 "But this License is not limited to software manuals; it can be used for any "
4489 "textual work, regardless of subject matter or whether it is published as a "
4490 "printed book. We recommend this License principally for works whose purpose "
4491 "is instruction or reference."
4492 msgstr ""
4493 "Wir haben diese Lizenz gestaltet, um sie für Anleitungen von freier Software "
4494 "zu benutzen, weil freie Software freie Dokumentation benötigt: Ein freies "
4495 "Programm sollte mit Anleitungen kommen, die dieselbe Freiheit wie die "
4496 "Software bieten. Aber diese Lizenz ist nicht auf Software-Anleitungen "
4497 "beschränkt; sie kann für alle textlichen Arbeiten verwendet werden, "
4498 "unabhängig vom Thema, oder ob es als gedrucktes Buch veröffentlicht wird. "
4499 "Wir empfehlen diese Lizenz prinzipiell für Arbeiten, deren Zweck Anleitungen "
4500 "oder Referenzen sind."
4501
4502 #. (itstool) path: sect1/title
4503 #: C/fdl-appendix.xml:62
4504 msgid "1. APPLICABILITY AND DEFINITIONS"
4505 msgstr "1. ANWENDBARKEIT UND DEFINITIONEN"
4506
4507 #. (itstool) path: para/quote
4508 #. (itstool) path: para/link
4509 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4510 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4511 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4512 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4513 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4514 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4515 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4516 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4517 #: C/fdl-appendix.xml:608
4518 msgid "Document"
4519 msgstr "Dokument"
4520
4521 #. (itstool) path: para/quote
4522 #: C/fdl-appendix.xml:69
4523 msgid "you"
4524 msgstr "Sie"
4525
4526 #. (itstool) path: sect1/para
4527 #: C/fdl-appendix.xml:63
4528 msgid ""
4529 "This License applies to any manual or other work that contains a notice "
4530 "placed by the copyright holder saying it can be distributed under the terms "
4531 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4532 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4533 msgstr ""
4534 "Diese Lizenz betrifft jede Anleitung oder andere Arbeit, die einen Hinweis "
4535 "des Copyright-Halters enthält, welcher besagt, dass sie unter den "
4536 "Bedingungen dieser Lizenz verteilt werden kann. Das <_:quote-1/>, weiter "
4537 "unten, bezieht sich auf jede dieser Anleitungen oder Arbeiten. Jedes "
4538 "Mitglied der Öffentlichkeit ist ein Lizenznehmer, und wird mit <_:quote-2/> "
4539 "bezeichnet."
4540
4541 #. (itstool) path: para/quote
4542 #. (itstool) path: para/link
4543 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4544 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4545 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4546 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4547 msgid "Modified Version"
4548 msgstr "Modifizierte Version"
4549
4550 #. (itstool) path: sect1/para
4551 #: C/fdl-appendix.xml:72
4552 msgid ""
4553 "A <_:quote-1/> of the Document means any work containing the Document or a "
4554 "portion of it, either copied verbatim, or with modifications and/or "
4555 "translated into another language."
4556 msgstr ""
4557 "Eine <_:quote-1/> von dem Dokument bezeichnet jegliche Arbeit, die das "
4558 "Dokument oder einen Teil davon enthält, entweder wortwörtlich kopiert oder "
4559 "mit Modifikationen und/oder in eine andere Sprache übersetzt."
4560
4561 #. (itstool) path: para/quote
4562 #: C/fdl-appendix.xml:80
4563 msgid "Secondary Section"
4564 msgstr "Sekundärer Abschnitt"
4565
4566 #. (itstool) path: sect1/para
4567 #: C/fdl-appendix.xml:79
4568 msgid ""
4569 "A <_:quote-1/> is a named appendix or a front-matter section of the <_:"
4570 "link-2/> that deals exclusively with the relationship of the publishers or "
4571 "authors of the Document to the Document's overall subject (or to related "
4572 "matters) and contains nothing that could fall directly within that overall "
4573 "subject. (For example, if the Document is in part a textbook of mathematics, "
4574 "a Secondary Section may not explain any mathematics.) The relationship could "
4575 "be a matter of historical connection with the subject or with related "
4576 "matters, or of legal, commercial, philosophical, ethical or political "
4577 "position regarding them."
4578 msgstr ""
4579 "Ein <_:quote-1/> ist ein benannter Anhang oder ein wichtiger Abschnitt des "
4580 "<_:link-2/>, der exklusiv mit der Beziehung des Veröffentlichers zu dem "
4581 "Gesamtthema des Dokumentes (oder verwandten Themen) handelt und nichts "
4582 "enthält, was direkt unter das Gesamtthema fällt. (Wenn zum Beispiel das "
4583 "Dokument teilweise ein Textbuch der Mathematik ist, erklärt ein "
4584 "<quote>Sekundärer Abschnitt</quote> keine Mathematik.) Die Beziehung könnte "
4585 "eine Angelegenheit einer historischen Verbindung mit dem Thema oder einer "
4586 "verwandten Sache sein, oder einer gesetzlichen, kommerziellen, "
4587 "philosophischen, ethnischen oder politischen Position ihr gegenüber."
4588
4589 #. (itstool) path: para/quote
4590 #. (itstool) path: para/link
4591 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4592 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4593 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4594 msgid "Invariant Sections"
4595 msgstr "Unveränderliche Abschnitte"
4596
4597 #. (itstool) path: para/link
4598 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4599 msgid "Secondary Sections"
4600 msgstr "Sekundäre Abschnitte"
4601
4602 #. (itstool) path: sect1/para
4603 #: C/fdl-appendix.xml:94
4604 msgid ""
4605 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
4606 "being those of Invariant Sections, in the notice that says that the <_:"
4607 "link-3/> is released under this License."
4608 msgstr ""
4609 "<_:quote-1/> sind spezielle <_:link-2/>, deren Titel in dem Hinweis, der "
4610 "besagt, dass das <_:link-3/> unter dieser Lizenz veröffentlicht ist, "
4611 "gekennzeichnet sind, Unveränderliche Abschnitte zu sein."
4612
4613 #. (itstool) path: para/quote
4614 #. (itstool) path: para/link
4615 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4616 #: C/fdl-appendix.xml:458
4617 msgid "Cover Texts"
4618 msgstr "Cover-Texte"
4619
4620 #. (itstool) path: sect1/para
4621 #: C/fdl-appendix.xml:103
4622 msgid ""
4623 "The <_:quote-1/> are certain short passages of text that are listed, as "
4624 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:"
4625 "link-2/> is released under this License."
4626 msgstr ""
4627 "Die <_:quote-1/> sind spezielle kurze Textpassagen, die, als "
4628 "Vorderseitentexte oder Rückseitentexte, in dem Hinweis aufgeführt sind, der "
4629 "besagt, dass das <_:link-2/> unter dieser Lizenz veröffentlicht ist."
4630
4631 #. (itstool) path: para/quote
4632 #. (itstool) path: para/link
4633 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4634 #: C/fdl-appendix.xml:369
4635 msgid "Transparent"
4636 msgstr "Transparent"
4637
4638 #. (itstool) path: para/quote
4639 #. (itstool) path: para/link
4640 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4641 msgid "Opaque"
4642 msgstr "Undurchsichtig"
4643
4644 #. (itstool) path: sect1/para
4645 #: C/fdl-appendix.xml:111
4646 msgid ""
4647 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4648 "represented in a format whose specification is available to the general "
4649 "public, whose contents can be viewed and edited directly and "
4650 "straightforwardly with generic text editors or (for images composed of "
4651 "pixels) generic paint programs or (for drawings) some widely available "
4652 "drawing editor, and that is suitable for input to text formatters or for "
4653 "automatic translation to a variety of formats suitable for input to text "
4654 "formatters. A copy made in an otherwise Transparent file format whose markup "
4655 "has been designed to thwart or discourage subsequent modification by readers "
4656 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
4657 msgstr ""
4658 "Eine <_:quote-1/> Kopie des <_:link-2/> meint eine maschinenlesbare Kopie, "
4659 "die in einem der Allgemeinheit zugänglichen Format repräsentiert ist, deren "
4660 "Inhalt direkt und einfach mit gebräuchlichen Texteditoren oder (bei aus "
4661 "Pixeln bestehenden Bildern) gebräuchlichen Zeichenprogrammen oder (bei "
4662 "Bildern) weit verbreiteten Bildverarbeitungsprogramm besehen und verändert "
4663 "werden kann, und das geeignet ist, in Textformatierern eingegeben werden zu "
4664 "können oder automatisch in eine Vielzahl von Formaten übersetzt werden kann, "
4665 "die geeignet sind, in Textformatierern eingegeben werden zu können. Eine "
4666 "Kopie in einem anderen Transparenten Dateiformat, dessen Aufbau gestaltet "
4667 "wurde, eine ständige Veränderung durch den Leser zu vereiteln oder "
4668 "abzuwenden, ist nicht Transparent. Eine Kopie die nicht <quote>Transparent</"
4669 "quote> ist, nennt man <quote>Undurchsichtig</quote>."
4670
4671 #. (itstool) path: sect1/para
4672 #: C/fdl-appendix.xml:128
4673 msgid ""
4674 "Examples of suitable formats for Transparent copies include plain ASCII "
4675 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4676 "a publicly available DTD, and standard-conforming simple HTML designed for "
4677 "human modification. Opaque formats include PostScript, PDF, proprietary "
4678 "formats that can be read and edited only by proprietary word processors, "
4679 "SGML or XML for which the DTD and/or processing tools are not generally "
4680 "available, and the machine-generated HTML produced by some word processors "
4681 "for output purposes only."
4682 msgstr ""
4683 "Beispiele von passenden Formaten für Transparente Kopien enthalten reines "
4684 "ASCII ohne Codierung, das Texinfo-Eingabeformat, das LaTeX-Eingabeformat, "
4685 "SGML oder XML die eine öffentlich zugängliche DTD nutzen, und dem Standard "
4686 "entsprechendes HTML, das für die Veränderung durch Menschen gestaltet wurde. "
4687 "Undurchsichtige Formate enthalten PostScript, PDF, proprietäre Formate die "
4688 "nur von proprietären Textverarbeitungen gelesen und bearbeitet werden, SGML "
4689 "oder XML für die die DTD und/oder die Verarbeitungswerkzeuge nicht allgemein "
4690 "erhältlich sind, und maschinengeneriertes HTML, das von einigen "
4691 "Textverarbeitungen nur zu Ausgabezwecken produziert wurde."
4692
4693 #. (itstool) path: para/quote
4694 #. (itstool) path: para/link
4695 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4696 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4697 msgid "Title Page"
4698 msgstr "Titelseite"
4699
4700 #. (itstool) path: sect1/para
4701 #: C/fdl-appendix.xml:141
4702 msgid ""
4703 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4704 "following pages as are needed to hold, legibly, the material this License "
4705 "requires to appear in the title page. For works in formats which do not have "
4706 "any title page as such, <_:quote-2/> means the text near the most prominent "
4707 "appearance of the work's title, preceding the beginning of the body of the "
4708 "text."
4709 msgstr ""
4710 "Die <_:quote-1/> meint bei einem gedruckten Buch die Titelseite selbst, und "
4711 "die folgenden Seiten, die gebraucht werden, um leserlich das Material zu "
4712 "beinhalten, das die Lizenz benötigt, um auf der Titelseite zu erscheinen. "
4713 "Für Arbeiten, die als solche keine Titelseiten haben, meint <_:quote-2/> den "
4714 "Text, der der wirkungsvollsten Erscheinung des Arbeitstitels am nächsten "
4715 "kommt und den Textkörper einleitet."
4716
4717 #. (itstool) path: sect1/title
4718 #: C/fdl-appendix.xml:153
4719 msgid "2. VERBATIM COPYING"
4720 msgstr "3. WORTWÖRTLICHE KOPIEN"
4721
4722 #. (itstool) path: para/link
4723 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4724 msgid "section 3"
4725 msgstr "Abschnitt 3"
4726
4727 #. (itstool) path: sect1/para
4728 #: C/fdl-appendix.xml:154
4729 msgid ""
4730 "You may copy and distribute the <_:link-1/> in any medium, either "
4731 "commercially or noncommercially, provided that this License, the copyright "
4732 "notices, and the license notice saying this License applies to the Document "
4733 "are reproduced in all copies, and that you add no other conditions "
4734 "whatsoever to those of this License. You may not use technical measures to "
4735 "obstruct or control the reading or further copying of the copies you make or "
4736 "distribute. However, you may accept compensation in exchange for copies. If "
4737 "you distribute a large enough number of copies you must also follow the "
4738 "conditions in <_:link-2/>."
4739 msgstr ""
4740 "Sie dürfen das <_:link-1/> auf jedem Medium kopieren und verteilen, entweder "
4741 "kommerziell oder nichtkommerziell, vorausgesetzt, dass die Lizenz, die "
4742 "Copyrighthinweise und der Lizenzhinweis, der besagt, dass die Lizenz für das "
4743 "Dokument gilt, in allen Kopien reproduziert werden, und dass Sie keine wie "
4744 "auch immer lautenden andere Bedingungen als die der Lizenz hinzufügen. Sie "
4745 "dürfen keine technischen Möglichkeiten nutzen, die das Lesen oder "
4746 "Weiterkopieren der Kopien, die Sie machen oder weiterkopieren, kontrollieren "
4747 "oder behindern. Wie auch immer, Sie dürfen im Gegenzug Vergütungen für "
4748 "Kopien akzeptieren. Wenn Sie eine genügend große Anzahl von Kopien "
4749 "verteilen, müssen Sie auch den Bedingungen in <_:link-2/> zustimmen."
4750
4751 #. (itstool) path: sect1/para
4752 #: C/fdl-appendix.xml:169
4753 msgid ""
4754 "You may also lend copies, under the same conditions stated above, and you "
4755 "may publicly display copies."
4756 msgstr ""
4757 "Sie dürfen auch Kopien unter den oben genannten Bedingungen verleihen, und "
4758 "Sie dürfen Kopien öffentlich zeigen."
4759
4760 #. (itstool) path: sect1/title
4761 #: C/fdl-appendix.xml:176
4762 msgid "3. COPYING IN QUANTITY"
4763 msgstr "3. KOPIEREN IN MENGEN"
4764
4765 #. (itstool) path: sect1/para
4766 #: C/fdl-appendix.xml:177
4767 msgid ""
4768 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
4769 "and the Document's license notice requires <_:link-2/>, you must enclose the "
4770 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
4771 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
4772 "cover. Both covers must also clearly and legibly identify you as the "
4773 "publisher of these copies. The front cover must present the full title with "
4774 "all words of the title equally prominent and visible. You may add other "
4775 "material on the covers in addition. Copying with changes limited to the "
4776 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
4777 "these conditions, can be treated as verbatim copying in other respects."
4778 msgstr ""
4779 "Wenn Sie mehr als 100 gedruckte Kopien des<_:link-1/> veröffentlichen, und "
4780 "die Lizenz des Dokumentes <_:link-2/> verlangt, müssen Sie die Kopien in "
4781 "Verpackungen einschließen, die sauber und leserlich all diese Cover-Texte "
4782 "enthalten: Vorderseitentexte auf der Vorderseite, und Rückseitentexte auf "
4783 "der Rückseite. Beide Seiten müssen auch sauber und leserlich Sie als den "
4784 "Veröffentlicher dieser Kopien identifizieren. Die Vorderseite muß den vollen "
4785 "Titel mit allen Wörtern des Titels gleich auffällig und sichtbar darstellen. "
4786 "Sie dürfen andere Materialien zusätzlich der Seite hinzufügen. Kopieren mit "
4787 "Veränderungen der Seiten, solange diese den Titel des <_:link-3/> "
4788 "beibehalten und diese Bedingungen erfüllen, können in anderer Hinsicht als "
4789 "wortwörtliche Kopien behandelt werden."
4790
4791 #. (itstool) path: sect1/para
4792 #: C/fdl-appendix.xml:195
4793 msgid ""
4794 "If the required texts for either cover are too voluminous to fit legibly, "
4795 "you should put the first ones listed (as many as fit reasonably) on the "
4796 "actual cover, and continue the rest onto adjacent pages."
4797 msgstr ""
4798 "Wenn die geforderten Texte für jede Seite zu groß sind, um leserlich darauf "
4799 "zu passen, sollten Sie die erstgenannten (so viele wie vernünftig darauf "
4800 "passen) auf die aktuelle Seite setzen, und mit dem Rest auf angrenzenden "
4801 "Seiten fortfahren."
4802
4803 #. (itstool) path: sect1/para
4804 #: C/fdl-appendix.xml:202
4805 msgid ""
4806 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
4807 "more than 100, you must either include a machine-readable <_:link-3/> copy "
4808 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
4809 "accessible computer-network location containing a complete Transparent copy "
4810 "of the Document, free of added material, which the general network-using "
4811 "public has access to download anonymously at no charge using public-standard "
4812 "network protocols. If you use the latter option, you must take reasonably "
4813 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
4814 "ensure that this Transparent copy will remain thus accessible at the stated "
4815 "location until at least one year after the last time you distribute an "
4816 "Opaque copy (directly or through your agents or retailers) of that edition "
4817 "to the public."
4818 msgstr ""
4819 "Wenn Sie mehr als 100 <_:link-1/> Kopien des <_:link-2/> veröffentlichen "
4820 "oder verteilen, müssen Sie entweder zusammen mit jeder Undurchsichtigen "
4821 "Kopie eine maschinenlesbare <_:link-3/> Kopie einfügen, oder in oder mit "
4822 "jeder Undurchsichtigen Kopie eine öffentlich zugängliche Computer-Netzwerk-"
4823 "Adresse angeben, die eine komplette Transparente Kopie des Dokumentes "
4824 "enthält, die frei von hinzugefügtem Material ist und die sich die allgemeine "
4825 "netzwerknutzende Öffentlichkeit mit Standard-Netzwerkprotokollen "
4826 "unentgeltlich herunterladen kann. Wenn Sie die letzte Option verwenden, "
4827 "müssen Sie, wenn Sie beginnen, Undurchsichtige Kopien in Mengen zu "
4828 "verteilen, vernünftige umsichtige Schritte unternehmen, die sicherstellen, "
4829 "dass die Transparente Kopie unter der genannten Adresse mindestens ein Jahr, "
4830 "nachdem Sie das letzte Mal eine Undurchsichtige Kopie dieser Edition (direkt "
4831 "oder über Ihre Vermittler oder Händler) an die Öffentlichkeit verteilt haben."
4832
4833 #. (itstool) path: sect1/para
4834 #: C/fdl-appendix.xml:222
4835 msgid ""
4836 "It is requested, but not required, that you contact the authors of the <_:"
4837 "link-1/> well before redistributing any large number of copies, to give them "
4838 "a chance to provide you with an updated version of the Document."
4839 msgstr ""
4840 "Es wird erbeten, aber nicht verlangt, dass Sie die Autoren des <_:link-1/> "
4841 "kontaktieren, bevor Sie eine große Anzahl an Kopien weiterverteilen, um "
4842 "ihnen zu ermöglichen, Sie mit einer aktualisierten Version des Dokumentes zu "
4843 "versorgen."
4844
4845 #. (itstool) path: sect1/title
4846 #: C/fdl-appendix.xml:231
4847 msgid "4. MODIFICATIONS"
4848 msgstr "4. MODIFIKATIONEN"
4849
4850 #. (itstool) path: para/link
4851 #: C/fdl-appendix.xml:236
4852 msgid "2"
4853 msgstr "2"
4854
4855 #. (itstool) path: para/link
4856 #: C/fdl-appendix.xml:237
4857 msgid "3"
4858 msgstr "3"
4859
4860 #. (itstool) path: sect1/para
4861 #: C/fdl-appendix.xml:232
4862 msgid ""
4863 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
4864 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
4865 "release the Modified Version under precisely this License, with the Modified "
4866 "Version filling the role of the Document, thus licensing distribution and "
4867 "modification of the Modified Version to whoever possesses a copy of it. In "
4868 "addition, you must do these things in the Modified Version:"
4869 msgstr ""
4870 "Sie dürfen eine <_:link-1/> eines <_:link-2/> unter den in den Abschnitten "
4871 "<_:link-3/> und <_:link-4/> oben stehenden Bedingungen kopieren und "
4872 "verteilen, vorausgesetzt, Sie veröffentlichen die Modifizierte Version unter "
4873 "genau dieser Lizenz, sodass die modifizierte Version die Stelle des "
4874 "Dokumentes einnimmt, folglich auch das Lizenzieren der Verteilung und "
4875 "Modifikation der Modifizierten Version an jeden, der eine Kopie davon "
4876 "besitzt. Zusätzlich müssen Sie diese Dinge in der Modifizierten Version tun:"
4877
4878 #. (itstool) path: formalpara/title
4879 #: C/fdl-appendix.xml:248
4880 msgid "A"
4881 msgstr "A"
4882
4883 #. (itstool) path: formalpara/para
4884 #: C/fdl-appendix.xml:249
4885 msgid ""
4886 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
4887 "that of the <_:link-2/>, and from those of previous versions (which should, "
4888 "if there were any, be listed in the History section of the Document). You "
4889 "may use the same title as a previous version if the original publisher of "
4890 "that version gives permission."
4891 msgstr ""
4892 "Auf der <_:link-1/> (und auf den Covern, falls vorhanden) einen Titel "
4893 "verwenden, der sich von dem des <_:link-2/> unterscheidet, und von denen "
4894 "vorhergehender Versionen (die, falls vorhanden, in dem History-Abschnitt des "
4895 "Dokumentes aufgeführt sein sollten). Sie dürfen denselben Titel wie in einer "
4896 "vorhergehenden Version nutzen, wenn der ursprüngliche Veröffentlicher sein "
4897 "Einverständnis gibt."
4898
4899 #. (itstool) path: formalpara/title
4900 #: C/fdl-appendix.xml:264
4901 msgid "B"
4902 msgstr "B"
4903
4904 #. (itstool) path: formalpara/para
4905 #: C/fdl-appendix.xml:265
4906 msgid ""
4907 "List on the <_:link-1/>, as authors, one or more persons or entities "
4908 "responsible for authorship of the modifications in the <_:link-2/>, together "
4909 "with at least five of the principal authors of the <_:link-3/> (all of its "
4910 "principal authors, if it has less than five)."
4911 msgstr ""
4912 "Auf der <_:link-1/>, eine oder mehrere Personen als Autoren benennen, die "
4913 "für das Einbringen von Veränderungen in die <_:link-2/> verantwortlich sind, "
4914 "zusammen mit mindesten fünf eigentlichen Autoren des <_:link-3/> (allen "
4915 "eigentlichen Autoren, wenn es weniger als fünf sind)."
4916
4917 #. (itstool) path: formalpara/title
4918 #: C/fdl-appendix.xml:279
4919 msgid "C"
4920 msgstr "C"
4921
4922 #. (itstool) path: formalpara/para
4923 #: C/fdl-appendix.xml:280
4924 msgid ""
4925 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
4926 "the publisher."
4927 msgstr ""
4928 "Auf der <_:link-1/> den Namen des Veröffentlichers der <_:link-2/> als "
4929 "Veröffentlicher kennzeichnen."
4930
4931 #. (itstool) path: formalpara/title
4932 #: C/fdl-appendix.xml:291
4933 msgid "D"
4934 msgstr "D"
4935
4936 #. (itstool) path: formalpara/para
4937 #: C/fdl-appendix.xml:292
4938 msgid "Preserve all the copyright notices of the <_:link-1/>."
4939 msgstr "Alle Copyright-Hinweise des <_:link-1/> beibehalten."
4940
4941 #. (itstool) path: formalpara/title
4942 #: C/fdl-appendix.xml:301
4943 msgid "E"
4944 msgstr "E"
4945
4946 #. (itstool) path: formalpara/para
4947 #: C/fdl-appendix.xml:302
4948 msgid ""
4949 "Add an appropriate copyright notice for your modifications adjacent to the "
4950 "other copyright notices."
4951 msgstr ""
4952 "Einen passenden Copyright-Hinweis für Ihre Modifikationen angrenzend an die "
4953 "anderen Copyright-Hinweise hinzufügen."
4954
4955 #. (itstool) path: formalpara/title
4956 #: C/fdl-appendix.xml:311
4957 msgid "F"
4958 msgstr "F"
4959
4960 #. (itstool) path: formalpara/para
4961 #: C/fdl-appendix.xml:312
4962 msgid ""
4963 "Include, immediately after the copyright notices, a license notice giving "
4964 "the public permission to use the <_:link-1/> under the terms of this "
4965 "License, in the form shown in the Addendum below."
4966 msgstr ""
4967 "Gleich hinter dem Copyright-Hinweis einen Lizenzhinweis einfügen, der die "
4968 "öffentliche Erlaubnis gibt, die <_:link-1/> unter den Bedingungen dieser "
4969 "Lizenz zu nutzen, in einer Form, die weiter unten im Anhang dargestellt ist."
4970
4971 #. (itstool) path: formalpara/title
4972 #: C/fdl-appendix.xml:324
4973 msgid "G"
4974 msgstr "G"
4975
4976 #. (itstool) path: para/link
4977 #: C/fdl-appendix.xml:330
4978 msgid "Document's"
4979 msgstr "des Dokuments"
4980
4981 #. (itstool) path: formalpara/para
4982 #: C/fdl-appendix.xml:325
4983 msgid ""
4984 "Preserve in that license notice the full lists of <_:link-1/> and required "
4985 "<_:link-2/> given in the <_:link-3/> license notice."
4986 msgstr ""
4987 "In dem Lizenzhinweis die volle Liste der <_:link-1/> und benötigten <_:"
4988 "link-2/>, die in dem Lizenzhinweis des <_:link-3/> gegeben ist, beibehalten."
4989
4990 #. (itstool) path: formalpara/title
4991 #: C/fdl-appendix.xml:337
4992 msgid "H"
4993 msgstr "H"
4994
4995 #. (itstool) path: formalpara/para
4996 #: C/fdl-appendix.xml:338
4997 msgid "Include an unaltered copy of this License."
4998 msgstr "Eine unveränderte Kopie dieser Lizenz einfügen."
4999
5000 #. (itstool) path: formalpara/title
5001 #: C/fdl-appendix.xml:346
5002 msgid "I"
5003 msgstr "I"
5004
5005 #. (itstool) path: para/quote
5006 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
5007 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
5008 msgid "History"
5009 msgstr "Chronik"
5010
5011 #. (itstool) path: formalpara/para
5012 #: C/fdl-appendix.xml:347
5013 msgid ""
5014 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
5015 "item stating at least the title, year, new authors, and publisher of the <_:"
5016 "link-2/> as given on the <_:link-3/>. If there is no section entitled <_:"
5017 "quote-4/> in the <_:link-5/>, create one stating the title, year, authors, "
5018 "and publisher of the Document as given on its Title Page, then add an item "
5019 "describing the Modified Version as stated in the previous sentence."
5020 msgstr ""
5021 "Den Abschnitt, der mit <_:quote-1/> betitelt ist, und seinen Titel "
5022 "beibehalten und ihn zu einem Punkt hinzufügen, der mindestens Titel, Jahr, "
5023 "neue Autoren, und Veröffentlicher der <_:link-2/> wie auf der <_:link-3/> "
5024 "gegeben, benennt. Wenn es keinen mit <_:quote-4/> betitelten Abschnitt gibt, "
5025 "erstellen Sie einen, der den Titel, Jahr, Autoren, und Veröffentlicher des "
5026 "<_:link-5/> wie auf der Titelseite gegeben, benennt, und fügen Sie dann "
5027 "einen Punkt hinzu, der die Modifizierte Version beschreibt wie im "
5028 "vorhergehenden Satz."
5029
5030 #. (itstool) path: formalpara/title
5031 #: C/fdl-appendix.xml:365
5032 msgid "J"
5033 msgstr "J"
5034
5035 #. (itstool) path: formalpara/para
5036 #: C/fdl-appendix.xml:366
5037 msgid ""
5038 "Preserve the network location, if any, given in the <_:link-1/> for public "
5039 "access to a <_:link-2/> copy of the Document, and likewise the network "
5040 "locations given in the Document for previous versions it was based on. These "
5041 "may be placed in the <_:quote-3/> section. You may omit a network location "
5042 "for a work that was published at least four years before the Document "
5043 "itself, or if the original publisher of the version it refers to gives "
5044 "permission."
5045 msgstr ""
5046 "Die Netzwerk-Adresse, falls aufgeführt, beibehalten, die im <_:link-1/> "
5047 "aufgeführt ist, um öffentlichen Zugriff zu einer <_:link-2/> Kopie des "
5048 "Dokumentes zu ermöglichen, und genauso die Netzwerk-Adressen, die im "
5049 "Dokument für frühere Versionen, auf denen es basiert, aufgeführt sind. Diese "
5050 "können in den <_:quote-3/>-Abschnitt gestellt werden. Sie können eine "
5051 "Netzwerk-Adresse für ein Werk auslassen, das mindestens vier Jahre vor dem "
5052 "Dokument selbst veröffentlicht wurde, oder wenn der ursprüngliche Autor, auf "
5053 "den sich die jeweilige Version bezieht, es erlaubt."
5054
5055 #. (itstool) path: formalpara/title
5056 #: C/fdl-appendix.xml:383
5057 msgid "K"
5058 msgstr "K"
5059
5060 #. (itstool) path: para/quote
5061 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5062 msgid "Acknowledgements"
5063 msgstr "Danksagungen"
5064
5065 #. (itstool) path: para/quote
5066 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5067 msgid "Dedications"
5068 msgstr "Widmungen"
5069
5070 #. (itstool) path: formalpara/para
5071 #: C/fdl-appendix.xml:384
5072 msgid ""
5073 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5074 "title, and preserve in the section all the substance and tone of each of the "
5075 "contributor acknowledgements and/or dedications given therein."
5076 msgstr ""
5077 "In jeglichem Abschnitt, der mit <_:quote-1/> oder <_:quote-2/> betitelt ist, "
5078 "den Titel des Abschnittes beibehalten, und in dem Abschnitt allen Inhalt und "
5079 "Ton von jeder Anerkennung und/oder Widmung jedes Beitragenden beibehalten, "
5080 "der dort aufgeführt ist."
5081
5082 #. (itstool) path: formalpara/title
5083 #: C/fdl-appendix.xml:396
5084 msgid "L"
5085 msgstr "L"
5086
5087 #. (itstool) path: formalpara/para
5088 #: C/fdl-appendix.xml:397
5089 msgid ""
5090 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5091 "in their titles. Section numbers or the equivalent are not considered part "
5092 "of the section titles."
5093 msgstr ""
5094 "Alle <_:link-1/> des <_:link-2/> beibehalten, unverändert in ihrem Text und "
5095 "ihren Titeln. Abschnittsnummern oder ähnliches werden nicht als Teil von "
5096 "Abschnittstiteln betrachtet."
5097
5098 #. (itstool) path: formalpara/title
5099 #: C/fdl-appendix.xml:409
5100 msgid "M"
5101 msgstr "M"
5102
5103 #. (itstool) path: para/quote
5104 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5105 msgid "Endorsements"
5106 msgstr "Billigungen"
5107
5108 #. (itstool) path: formalpara/para
5109 #: C/fdl-appendix.xml:410
5110 msgid ""
5111 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5112 "in the <_:link-2/>."
5113 msgstr ""
5114 "Alle Abschnitte, die mit <_:quote-1/> betitelt sind, löschen. Solche "
5115 "Abschnitte dürfen nicht mit in die <_:link-2/> aufgenommen werden."
5116
5117 #. (itstool) path: formalpara/title
5118 #: C/fdl-appendix.xml:421
5119 msgid "N"
5120 msgstr "N"
5121
5122 #. (itstool) path: para/link
5123 #: C/fdl-appendix.xml:425
5124 msgid "Invariant Section"
5125 msgstr "Unveränderlicher Abschnitt"
5126
5127 #. (itstool) path: formalpara/para
5128 #: C/fdl-appendix.xml:422
5129 msgid ""
5130 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5131 "with any <_:link-2/>."
5132 msgstr ""
5133 "Betiteln Sie keine existierenden Abschnitte mit <_:quote-1/> oder so, dass "
5134 "sie im Widerspruch zu Titeln von <_:link-2/> stehen."
5135
5136 #. (itstool) path: sect1/para
5137 #: C/fdl-appendix.xml:432
5138 msgid ""
5139 "If the <_:link-1/> includes new front-matter sections or appendices that "
5140 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5141 "may at your option designate some or all of these sections as invariant. To "
5142 "do this, add their titles to the list of <_:link-3/> in the Modified "
5143 "Version's license notice. These titles must be distinct from any other "
5144 "section titles."
5145 msgstr ""
5146 "Wenn die <_:link-1/> neue wichtige Abschnitte enthält oder Anhänge, die <_:"
5147 "link-2/> darstellen, und kein Material enthalten, das aus dem Dokument "
5148 "kopiert wurde, dürfen Sie nach Ihrer Wahl einige oder alle diese Abschnitte "
5149 "als Unveränderlich bezeichnen. Um dies zu tun, fügen Sie ihre Titel der "
5150 "Liste der <_:link-3/> in dem Lizenzhinweis der Modifizierten Version hinzu. "
5151 "Diese Titel müssen sich von allen anderen Abschnittstiteln unterscheiden."
5152
5153 #. (itstool) path: sect1/para
5154 #: C/fdl-appendix.xml:444
5155 msgid ""
5156 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5157 "but endorsements of your <_:link-2/> by various parties--for example, "
5158 "statements of peer review or that the text has been approved by an "
5159 "organization as the authoritative definition of a standard."
5160 msgstr ""
5161 "Sie dürfen einen Abschnitt <_:quote-1/> hinzufügen, vorausgesetzt, er "
5162 "enthält nichts außer Bewilligungen Ihrer <_:link-2/> von verschiedenen "
5163 "Seiten – zum Beispiel Aussagen von Beurteilungen, oder dass der Text von "
5164 "einer Organisation als für die autoritäre Definition eines Standards "
5165 "befunden wurde."
5166
5167 #. (itstool) path: para/link
5168 #: C/fdl-appendix.xml:455
5169 msgid "Front-Cover Text"
5170 msgstr "Vorderseitentext"
5171
5172 #. (itstool) path: para/link
5173 #: C/fdl-appendix.xml:457
5174 msgid "Back-Cover Text"
5175 msgstr "Rückseitentext"
5176
5177 #. (itstool) path: sect1/para
5178 #: C/fdl-appendix.xml:453
5179 msgid ""
5180 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5181 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5182 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5183 "Text may be added by (or through arrangements made by) any one entity. If "
5184 "the <_:link-5/> already includes a cover text for the same cover, previously "
5185 "added by you or by arrangement made by the same entity you are acting on "
5186 "behalf of, you may not add another; but you may replace the old one, on "
5187 "explicit permission from the previous publisher that added the old one."
5188 msgstr ""
5189 "Sie dürfen eine Passage aus bis zu fünf Wörtern als <_:link-1/> hinzufügen, "
5190 "und eine Passage von bis zu 25 Wörtern als <_:link-2/>, ans Ende der Liste "
5191 "von <_:link-3/> in der <_:link-4/>. Höchstens eine Passage von "
5192 "Vorderseitentexten und eine von Rückseitentexten darf von (oder durch "
5193 "Abmachungen von) irgendeinem Wesen hinzugefügt werden. Wenn das <_:link-5/> "
5194 "für die entsprechende Seite schon einen Covertext hat, der vorher von Ihnen "
5195 "oder durch Abmachungen von demselben Wesen, in dessen Namen Sie handeln, "
5196 "hinzugefügt wurde, dürfen Sie keinen anderen hinzufügen; aber Sie dürfen den "
5197 "alten ersetzen, wenn es der ursprüngliche Veröffentlicher, der den alten "
5198 "hinzugefügt hat, explizit erlaubt."
5199
5200 #. (itstool) path: sect1/para
5201 #: C/fdl-appendix.xml:470
5202 msgid ""
5203 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5204 "give permission to use their names for publicity for or to assert or imply "
5205 "endorsement of any <_:link-2/>."
5206 msgstr ""
5207 "Der/die Autor(en) und Veröffentlicher des <_:link-1/> erteilen durch diese "
5208 "Lizenz nicht die Erlaubnis, ihre Namen für Veröffentlichungen für "
5209 "Bewilligungen irgendeiner <_:link-2/> oder deren Durchsetzungen oder "
5210 "Andeutungen zu nutzen."
5211
5212 #. (itstool) path: sect1/title
5213 #: C/fdl-appendix.xml:480
5214 msgid "5. COMBINING DOCUMENTS"
5215 msgstr "5. DOKUMENTE KOMBINIEREN"
5216
5217 #. (itstool) path: para/link
5218 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5219 msgid "section 4"
5220 msgstr "Abschnitt 4"
5221
5222 #. (itstool) path: sect1/para
5223 #: C/fdl-appendix.xml:481
5224 msgid ""
5225 "You may combine the <_:link-1/> with other documents released under this "
5226 "License, under the terms defined in <_:link-2/> above for modified versions, "
5227 "provided that you include in the combination all of the <_:link-3/> of all "
5228 "of the original documents, unmodified, and list them all as Invariant "
5229 "Sections of your combined work in its license notice."
5230 msgstr ""
5231 "Sie dürfen das <_:link-1/> mit anderen Dokumenten, die unter dieser Lizenz "
5232 "veröffentlicht wurden, unter den Bedingungen in <_:link-2/> für Modifizierte "
5233 "Versionen kombinieren, vorausgesetzt, Sie beinhalten in der Kombination alle "
5234 "<_:link-3/> aller ursprünglichen Dokumente unverändert, und führen Sie alle "
5235 "als Unveränderliche Abschnitte Ihrer kombinierten Arbeit in deren "
5236 "Lizenzhinweis auf."
5237
5238 #. (itstool) path: sect1/para
5239 #: C/fdl-appendix.xml:492
5240 msgid ""
5241 "The combined work need only contain one copy of this License, and multiple "
5242 "identical <_:link-1/> may be replaced with a single copy. If there are "
5243 "multiple Invariant Sections with the same name but different contents, make "
5244 "the title of each such section unique by adding at the end of it, in "
5245 "parentheses, the name of the original author or publisher of that section if "
5246 "known, or else a unique number. Make the same adjustment to the section "
5247 "titles in the list of Invariant Sections in the license notice of the "
5248 "combined work."
5249 msgstr ""
5250 "Die kombinierte Arbeit braucht nur eine Kopie dieser Lizenz zu beinhalten, "
5251 "und mehrfache identische <_:link-1/> können durch eine einzige Kopie ersetzt "
5252 "werden. Wenn es mehrere Unveränderliche Abschnitte mit demselben Titel, aber "
5253 "unterschiedlichem Inhalt gibt, machen Sie den Titel jedes Abschnittes durch "
5254 "Hinzufügen (in Klammern) des Namens des ursprünglichen Autors oder "
5255 "Veröffentlichers dieses Abschnittes, falls bekannt, unverwechselbar, oder "
5256 "ansonsten durch eine einzigartige Nummer. Führen Sie dieselben Änderungen in "
5257 "der Liste der Unveränderlichen Abschnitte im Lizenzhinweis der kombinierten "
5258 "Arbeit durch."
5259
5260 #. (itstool) path: para/quote
5261 #: C/fdl-appendix.xml:511
5262 msgid "Endorsements."
5263 msgstr "Billigungen."
5264
5265 #. (itstool) path: sect1/para
5266 #: C/fdl-appendix.xml:505
5267 msgid ""
5268 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5269 "the various original documents, forming one section entitled <_:quote-2/>; "
5270 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5271 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5272 msgstr ""
5273 "In der Kombination müssen Sie alle mit <_:quote-1/> betitelten Abschnitte "
5274 "aus den verschiedenen ursprünglichen Dokumenten zusammenführen, und daraus "
5275 "einen Abschnitt <_:quote-2/> bilden; genauso kombinieren Sie jeden mit <_:"
5276 "quote-3/> betitelten Abschnitt, und jeden mit <_:quote-4/> betitelten "
5277 "Abschnitt. Sie müssen jeden mit <_:quote-5/> betitelten Abschnitt löschen."
5278
5279 #. (itstool) path: sect1/title
5280 #: C/fdl-appendix.xml:516
5281 msgid "6. COLLECTIONS OF DOCUMENTS"
5282 msgstr "6. SAMMLUNGEN VON DOKUMENTEN"
5283
5284 #. (itstool) path: sect1/para
5285 #: C/fdl-appendix.xml:517
5286 msgid ""
5287 "You may make a collection consisting of the <_:link-1/> and other documents "
5288 "released under this License, and replace the individual copies of this "
5289 "License in the various documents with a single copy that is included in the "
5290 "collection, provided that you follow the rules of this License for verbatim "
5291 "copying of each of the documents in all other respects."
5292 msgstr ""
5293 "Sie dürfen eine Sammlung erstellen, die aus dem <_:link-1/> und anderen, "
5294 "unter dieser Lizenz veröffentlichten Dokumenten besteht, und die "
5295 "individuellen Kopien der Lizenz in den einzelnen Dokumenten durch eine "
5296 "einzige Kopie ersetzen, die sich in der Sammlung befindet, vorausgesetzt, "
5297 "Sie folgen den Regeln dieser Lizenz für wortwörtliches Kopieren jedes dieser "
5298 "Dokumente in jeglicher Hinsicht."
5299
5300 #. (itstool) path: sect1/para
5301 #: C/fdl-appendix.xml:527
5302 msgid ""
5303 "You may extract a single document from such a collection, and distribute it "
5304 "individually under this License, provided you insert a copy of this License "
5305 "into the extracted document, and follow this License in all other respects "
5306 "regarding verbatim copying of that document."
5307 msgstr ""
5308 "Sie dürfen ein einzelnes Dokument aus einer solchen Sammlung heraustrennen, "
5309 "und es individuell unter dieser Lizenz verteilen, vorausgesetzt, Sie fügen "
5310 "eine Kopie dieser Lizenz in das herausgetrennte Dokument ein und folgen der "
5311 "Lizenz in jeglicher Hinsicht bezüglich dem wortwörtlichen Kopieren des "
5312 "Dokuments."
5313
5314 #. (itstool) path: sect1/title
5315 #: C/fdl-appendix.xml:537
5316 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5317 msgstr "7. AGGREGATION MIT UNABHÄNGIGEN ARBEITEN"
5318
5319 #. (itstool) path: para/quote
5320 #: C/fdl-appendix.xml:546
5321 msgid "aggregate"
5322 msgstr "Aggregate"
5323
5324 #. (itstool) path: para/link
5325 #: C/fdl-appendix.xml:550
5326 msgid "Cover Text"
5327 msgstr "Cover-Text"
5328
5329 #. (itstool) path: sect1/para
5330 #: C/fdl-appendix.xml:538
5331 msgid ""
5332 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5333 "independent documents or works, in or on a volume of a storage or "
5334 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5335 "Document, provided no compilation copyright is claimed for the compilation. "
5336 "Such a compilation is called an <_:quote-3/>, and this License does not "
5337 "apply to the other self-contained works thus compiled with the Document , on "
5338 "account of their being thus compiled, if they are not themselves derivative "
5339 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5340 "applicable to these copies of the Document, then if the Document is less "
5341 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5342 "placed on covers that surround only the Document within the aggregate. "
5343 "Otherwise they must appear on covers around the whole aggregate."
5344 msgstr ""
5345 "Eine Zusammenstellung dieses <_:link-1/> oder seinen Ableitungen mit anderen "
5346 "separaten und unabhängigen Dokumenten oder Arbeiten, in oder auf einem Teil "
5347 "eines Speicher- oder Verteilungsmediums, zählt nicht als Ganzes als <_:"
5348 "link-2/> des Dokumentes, vorausgesetzt, kein Gesamt-Copyright wurde für die "
5349 "Zusammenstellung festgelegt. Solch eine Zusammenstellung wird <_:quote-3/> "
5350 "(Mischung) genannt, und diese Lizenz gilt nicht für die anderen "
5351 "selbstenthaltenen Arbeiten, die mit dem Dokument zusammengestellt wurden, im "
5352 "Falle, dass sie zusammengestellt wurden, wenn sie nicht selbst abgeleitete "
5353 "Arbeiten des Dokumentes sind. Wenn die <_:link-4/>-Bedingung von <_:link-5/> "
5354 "auf diese Kopien des Dokumentes anwendbar ist, dann können, wenn das "
5355 "Dokument weniger als ein Viertel des gesamten Aggregates ist, die Covertexte "
5356 "des Dokumentes auf Seiten platziert werden, die nur das Dokument innerhalb "
5357 "des Aggregates umgeben. Ansonsten müssen sie auf Seiten erscheinen, die das "
5358 "gesamte Aggregat umgeben."
5359
5360 #. (itstool) path: sect1/title
5361 #: C/fdl-appendix.xml:561
5362 msgid "8. TRANSLATION"
5363 msgstr "8. ÜBERSETZUNG"
5364
5365 #. (itstool) path: sect1/para
5366 #: C/fdl-appendix.xml:562
5367 msgid ""
5368 "Translation is considered a kind of modification, so you may distribute "
5369 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:"
5370 "link-3/> with translations requires special permission from their copyright "
5371 "holders, but you may include translations of some or all Invariant Sections "
5372 "in addition to the original versions of these Invariant Sections. You may "
5373 "include a translation of this License provided that you also include the "
5374 "original English version of this License. In case of a disagreement between "
5375 "the translation and the original English version of this License, the "
5376 "original English version will prevail."
5377 msgstr ""
5378 "Übersetzung wird als eine Art Modifikation angesehen, also dürfen Sie "
5379 "Übersetzungen des <_:link-1/> unter den Bedingungen von <_:link-2/> "
5380 "verteilen. Das Ersetzen von <_:link-3/> mit Übersetzungen erfordert "
5381 "spezielle Einwilligung des Copyright-Halters, aber Sie dürfen Übersetzungen "
5382 "von einigen oder allen Unveränderlichen Abschnitten zusätzlich zu den "
5383 "ursprünglichen Versionen dieser Unveränderlichen Abschnitte einfügen. Sie "
5384 "dürfen eine Übersetzung dieser Lizenz hinzufügen, vorausgesetzt Sie "
5385 "beinhalten auch die ursprüngliche englische Version dieser Lizenz. Im Falle "
5386 "einer Nichtübereinstimmung zwischen der Übersetzung und der ursprünglichen "
5387 "englischen Version dieser Lizenz hat die ursprüngliche englische Version "
5388 "Vorrang."
5389
5390 #. (itstool) path: sect1/title
5391 #: C/fdl-appendix.xml:580
5392 msgid "9. TERMINATION"
5393 msgstr "9. TERMINATION"
5394
5395 #. (itstool) path: sect1/para
5396 #: C/fdl-appendix.xml:581
5397 msgid ""
5398 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5399 "as expressly provided for under this License. Any other attempt to copy, "
5400 "modify, sublicense or distribute the Document is void, and will "
5401 "automatically terminate your rights under this License. However, parties who "
5402 "have received copies, or rights, from you under this License will not have "
5403 "their licenses terminated so long as such parties remain in full compliance."
5404 msgstr ""
5405 "Sie dürfen das <_:link-1/> nicht kopieren, modifizieren, sublizenzieren oder "
5406 "verteilen, außer wie es diese Lizenz ausdrücklich vorschreibt. Jegliche "
5407 "andere Absicht, das Dokument zu kopieren, modifizieren, sublizenzieren oder "
5408 "verteilen, ist nichtig und beendet automatisch Ihre Rechte unter dieser "
5409 "Lizenz. Wie auch immer, Parteien, die Kopien oder Rechte von Ihnen unter "
5410 "dieser Lizenz bekommen haben, wird nicht die Lizenz beendet, solange diese "
5411 "Parteien in voller Zustimmung verbleiben."
5412
5413 #. (itstool) path: sect1/title
5414 #: C/fdl-appendix.xml:594
5415 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5416 msgstr "10. ZUKÜNFTIGE REVISIONEN DIESER LIZENZ"
5417
5418 #. (itstool) path: para/ulink
5419 #: C/fdl-appendix.xml:597
5420 msgid "Free Software Foundation"
5421 msgstr "Free Software Foundation"
5422
5423 #. (itstool) path: para/ulink
5424 #: C/fdl-appendix.xml:603
5425 msgid "http://www.gnu.org/copyleft/"
5426 msgstr "http://www.gnu.org/copyleft/"
5427
5428 #. (itstool) path: sect1/para
5429 #: C/fdl-appendix.xml:595
5430 msgid ""
5431 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5432 "Documentation License from time to time. Such new versions will be similar "
5433 "in spirit to the present version, but may differ in detail to address new "
5434 "problems or concerns. See <_:ulink-2/>."
5435 msgstr ""
5436 "Die <_:ulink-1/> kann von Zeit zu Zeit neue, revidierte Versionen der GNU "
5437 "Free Documentation License veröffentlichen. Solche neue Versionen werden vom "
5438 "Grundprinzip her der vorliegenden Version gleichen, können sich aber im "
5439 "Detail unterscheiden, um neue Probleme oder Anliegen anzusprechen. Siehe "
5440 "auch <_:ulink-2/>."
5441
5442 #. (itstool) path: para/quote
5443 #: C/fdl-appendix.xml:610
5444 msgid "or any later version"
5445 msgstr "oder jeder späteren Version"
5446
5447 #. (itstool) path: sect1/para
5448 #: C/fdl-appendix.xml:606
5449 msgid ""
5450 "Each version of the License is given a distinguishing version number. If the "
5451 "<_:link-1/> specifies that a particular numbered version of this License <_:"
5452 "quote-2/> applies to it, you have the option of following the terms and "
5453 "conditions either of that specified version or of any later version that has "
5454 "been published (not as a draft) by the Free Software Foundation. If the "
5455 "Document does not specify a version number of this License, you may choose "
5456 "any version ever published (not as a draft) by the Free Software Foundation."
5457 msgstr ""
5458 "Jeder Version dieser Lizenz wird eine unterscheidende Versionsnummer "
5459 "gegeben. Wenn das <_:link-1/> angibt, dass eine spezielle Version dieser "
5460 "Lizenz <_:quote-2/> darauf zutrifft, haben Sie die Wahl, den Bestimmungen "
5461 "und Bedingungen von entweder der angegebenen Version oder einer beliebigen "
5462 "späteren Version, die von der Free Software Foundation (nicht als Entwurf) "
5463 "veröffentlicht wurde, zu folgen. Wenn das Dokument keine Versionsnummer "
5464 "angibt, können Sie irgendeine, jemals von der Free Software Foundation "
5465 "(nicht als Entwurf) veröffentlichte Version wählen."
5466
5467 #. (itstool) path: sect1/title
5468 #: C/fdl-appendix.xml:621
5469 msgid "Addendum"
5470 msgstr "Anhang"
5471
5472 #. (itstool) path: sect1/para
5473 #: C/fdl-appendix.xml:622
5474 msgid ""
5475 "To use this License in a document you have written, include a copy of the "
5476 "License in the document and put the following copyright and license notices "
5477 "just after the title page:"
5478 msgstr ""
5479 "Um diese Lizenz in einem von Ihnen geschriebenen Dokument nutzen zu können, "
5480 "fügen Sie eine Kopie der Lizenz in das Dokument ein und setzen Sie die "
5481 "folgenden Copyright- und Lizenzhinweise gleich hinter die Titelseite:"
5482
5483 #. (itstool) path: blockquote/para
5484 #: C/fdl-appendix.xml:629
5485 msgid "Copyright YEAR YOUR NAME."
5486 msgstr "Copyright (c) JAHR IHR NAME."
5487
5488 #. (itstool) path: para/link
5489 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5490 msgid "Front-Cover Texts"
5491 msgstr "Vorderseitentexten"
5492
5493 #. (itstool) path: para/link
5494 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5495 msgid "Back-Cover Texts"
5496 msgstr "Rückseitentexten"
5497
5498 #. (itstool) path: blockquote/para
5499 #: C/fdl-appendix.xml:632
5500 msgid ""
5501 "Permission is granted to copy, distribute and/or modify this document under "
5502 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5503 "version published by the Free Software Foundation; with the <_:link-1/> "
5504 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the <_:"
5505 "link-3/> being LIST. A copy of the license is included in the section "
5506 "entitled <_:quote-4/>."
5507 msgstr ""
5508 "Es wird die Erlaubnis gegeben, dieses Dokument zu kopieren, verteilen und/"
5509 "oder zu verändern unter den Bedingungen der GNU Free Documentation License, "
5510 "Version 1.1 oder einer späteren, von der Free Software Foundation "
5511 "veröffentlichten Version; mit den <link linkend=\"fdl-"
5512 "invariant\">Unveränderlichen Abschnitten</link>. DEREN TITEL AUFGEZÄHLT "
5513 "sind, mit den <link linkend=\"fdl-cover-texts\">Vorderseitentexten</link>, "
5514 "die AUFGEZÄHLT sind, und mit den <link linkend=\"fdl-cover-"
5515 "texts\">Rückseitentexten</link>, die AUFGEZÄHLT sind. Eine Kopie dieser "
5516 "Lizenz ist im Abschnitt <_:quote-4/> enthalten."
5517
5518 #. (itstool) path: para/quote
5519 #: C/fdl-appendix.xml:649
5520 msgid "with no Invariant Sections"
5521 msgstr "ohne unveränderliche Abschnitte"
5522
5523 #. (itstool) path: para/quote
5524 #: C/fdl-appendix.xml:652
5525 msgid "no Front-Cover Texts"
5526 msgstr "keine Vorderseitentexte"
5527
5528 #. (itstool) path: para/quote
5529 #: C/fdl-appendix.xml:653
5530 msgid "Front-Cover Texts being LIST"
5531 msgstr "Vorderseitentexte aufzulisten"
5532
5533 #. (itstool) path: sect1/para
5534 #: C/fdl-appendix.xml:647
5535 msgid ""
5536 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5537 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:"
5538 "quote-5/>; likewise for <_:link-6/>."
5539 msgstr ""
5540 "Falls Sie keine <_:link-1/> haben, schreiben Sie <_:quote-2/> anstatt zu "
5541 "sagen, welche unveränderlich sind. Falls Sie keine <_:link-3/> haben, "
5542 "schreiben Sie <_:quote-4/> anstelle von <_:quote-5/>; entsprechend für <_:"
5543 "link-6/>."
5544
5545 #. (itstool) path: para/ulink
5546 #: C/fdl-appendix.xml:661
5547 msgid "GNU General Public License"
5548 msgstr "GNU General Public License"
5549
5550 #. (itstool) path: sect1/para
5551 #: C/fdl-appendix.xml:657
5552 msgid ""
5553 "If your document contains nontrivial examples of program code, we recommend "
5554 "releasing these examples in parallel under your choice of free software "
5555 "license, such as the <_:ulink-1/>, to permit their use in free software."
5556 msgstr ""
5557 "Wenn Ihr Dokument nicht-triviale Beispiele von Programmcode enthält, "
5558 "empfehlen wir, diese Beispiele parallel unter einer freien Software-Lizenz, "
5559 "wie der <_:ulink-1/>, zu veröffentlichen, um ihren Gebrauch in freier "
5560 "Software zu erlauben."
5561
5562 #~ msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5563 #~ msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5564
5565 #, no-wrap
5566 #~ msgid ""
5567 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5568 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5569 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5570 #~ msgstr ""
5571 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5572 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5573 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5574
5575 #~ msgid ""
5576 #~ "The purpose of this License is to make a manual, textbook, or other "
5577 #~ "written document <quote>free</quote> in the sense of freedom: to assure "
5578 #~ "everyone the effective freedom to copy and redistribute it, with or "
5579 #~ "without modifying it, either commercially or noncommercially. "
5580 #~ "Secondarily, this License preserves for the author and publisher a way to "
5581 #~ "get credit for their work, while not being considered responsible for "
5582 #~ "modifications made by others."
5583 #~ msgstr ""
5584 #~ "Der Zweck dieser Lizenz ist es, eine Anleitung, ein Textbuch oder andere "
5585 #~ "geschriebene Dokumente <quote>frei</quote> im Sinne von Freiheit zu "
5586 #~ "halten: jedem die effektive Freiheit zu sichern, es zu kopieren und "
5587 #~ "weiter zu verteilen, mit oder ohne es zu ändern, entweder kommerziell "
5588 #~ "oder nichtkommerziell. Zweitens sichert diese Lizenz dem Autor und "
5589 #~ "Veröffentlicher einen Weg, Anerkennung für seine Arbeit zu bekommen, ohne "
5590 #~ "dabei für Änderungen anderer verantwortlich zu sein."
5591
5592 #~ msgid ""
5593 #~ "This License is a kind of <quote>copyleft</quote>, which means that "
5594 #~ "derivative works of the document must themselves be free in the same "
5595 #~ "sense. It complements the GNU General Public License, which is a copyleft "
5596 #~ "license designed for free software."
5597 #~ msgstr ""
5598 #~ "Diese Lizenz ist eine Art <quote>copyleft</quote>, das heißt, dass "
5599 #~ "abgeleitete Arbeiten des Dokumentes selbst wieder im gleichen Sinne frei "
5600 #~ "sein müssen. Es ergänzt die GNU General Public License, die eine Copyleft-"
5601 #~ "Lizenz für freie Software darstellt."
5602
5603 #~ msgid ""
5604 #~ "This License applies to any manual or other work that contains a notice "
5605 #~ "placed by the copyright holder saying it can be distributed under the "
5606 #~ "terms of this License. The <quote>Document</quote>, below, refers to any "
5607 #~ "such manual or work. Any member of the public is a licensee, and is "
5608 #~ "addressed as <quote>you</quote>."
5609 #~ msgstr ""
5610 #~ "Diese Lizenz betrifft jede Anleitung oder andere Arbeit, die einen "
5611 #~ "Hinweis des Copyright-Halters enthält, welcher besagt, dass sie unter den "
5612 #~ "Bedingungen dieser Lizenz verteilt werden kann. Das <quote>Dokument</"
5613 #~ "quote>, weiter unten, bezieht sich auf jede dieser Anleitungen oder "
5614 #~ "Arbeiten. Jedes Mitglied der Öffentlichkeit ist ein Lizenznehmer, und "
5615 #~ "wird mit <quote>Sie</quote> bezeichnet."
5616
5617 #~ msgid ""
5618 #~ "A <quote>Modified Version</quote> of the Document means any work "
5619 #~ "containing the Document or a portion of it, either copied verbatim, or "
5620 #~ "with modifications and/or translated into another language."
5621 #~ msgstr ""
5622 #~ "Eine <quote>Modifizierte Version</quote> von dem Dokument bezeichnet "
5623 #~ "jegliche Arbeit, die das Dokument oder einen Teil davon enthält, entweder "
5624 #~ "wortwörtlich kopiert oder mit Modifikationen und/oder in eine andere "
5625 #~ "Sprache übersetzt."
5626
5627 #~ msgid ""
5628 #~ "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
5629 #~ "section of the <link linkend=\"fdl-document\">Document</link> that deals "
5630 #~ "exclusively with the relationship of the publishers or authors of the "
5631 #~ "Document to the Document's overall subject (or to related matters) and "
5632 #~ "contains nothing that could fall directly within that overall subject. "
5633 #~ "(For example, if the Document is in part a textbook of mathematics, a "
5634 #~ "Secondary Section may not explain any mathematics.) The relationship "
5635 #~ "could be a matter of historical connection with the subject or with "
5636 #~ "related matters, or of legal, commercial, philosophical, ethical or "
5637 #~ "political position regarding them."
5638 #~ msgstr ""
5639 #~ "Ein <quote>Sekundärer Abschnitt</quote> ist ein benannter Anhang oder ein "
5640 #~ "wichtiger Abschnitt des <link linkend=\"fdl-document\">Dokumentes</link>, "
5641 #~ "der exklusiv mit der Beziehung des Veröffentlichers zu dem Gesamtthema "
5642 #~ "des Dokumentes (oder verwandten Themen) handelt und nichts enthält, was "
5643 #~ "direkt unter das Gesamtthema fällt. (Wenn zum Beispiel das Dokument "
5644 #~ "teilweise ein Textbuch der Mathematik ist, erklärt ein <quote>Sekundärer "
5645 #~ "Abschnitt</quote> keine Mathematik.) Die Beziehung könnte eine "
5646 #~ "Angelegenheit einer historischen Verbindung mit dem Thema oder einer "
5647 #~ "verwandten Sache sein, oder einer gesetzlichen, kommerziellen, "
5648 #~ "philosophischen, ethnischen oder politischen Position ihr gegenüber."
5649
5650 #~ msgid ""
5651 #~ "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
5652 #~ "secondary\"> Secondary Sections</link> whose titles are designated, as "
5653 #~ "being those of Invariant Sections, in the notice that says that the <link "
5654 #~ "linkend=\"fdl-document\">Document</link> is released under this License."
5655 #~ msgstr ""
5656 #~ "<quote>Unveränderliche Abschnitte</quote> sind spezielle <link "
5657 #~ "linkend=\"fdl-secondary\">Sekundäre Abschnitte</link>, deren Titel in dem "
5658 #~ "Hinweis, der besagt, dass das <link linkend=\"fdl-document\">Dokument</"
5659 #~ "link> unter dieser Lizenz veröffentlicht ist, gekennzeichnet sind, "
5660 #~ "Unveränderte Abschnitte zu sein."
5661
5662 #~ msgid ""
5663 #~ "The <quote>Cover Texts</quote> are certain short passages of text that "
5664 #~ "are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that "
5665 #~ "says that the <link linkend=\"fdl-document\">Document</link> is released "
5666 #~ "under this License."
5667 #~ msgstr ""
5668 #~ "Die <quote>Covertexte</quote> sind spezielle kurze Textpassagen, die, als "
5669 #~ "Vorderseitentexte oder Rückseitentexte, in dem Hinweis aufgeführt sind, "
5670 #~ "der besagt, dass das <link linkend=\"fdl-document\">Dokument</link> unter "
5671 #~ "dieser Lizenz veröffentlicht ist."
5672
5673 #~ msgid ""
5674 #~ "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
5675 #~ "Document</link> means a machine-readable copy, represented in a format "
5676 #~ "whose specification is available to the general public, whose contents "
5677 #~ "can be viewed and edited directly and straightforwardly with generic text "
5678 #~ "editors or (for images composed of pixels) generic paint programs or (for "
5679 #~ "drawings) some widely available drawing editor, and that is suitable for "
5680 #~ "input to text formatters or for automatic translation to a variety of "
5681 #~ "formats suitable for input to text formatters. A copy made in an "
5682 #~ "otherwise Transparent file format whose markup has been designed to "
5683 #~ "thwart or discourage subsequent modification by readers is not "
5684 #~ "Transparent. A copy that is not <quote>Transparent</quote> is called "
5685 #~ "<quote>Opaque</quote>."
5686 #~ msgstr ""
5687 #~ "Eine <quote>Transparente</quote> Kopie des <link linkend=\"fdl-"
5688 #~ "document\">Dokumentes</link> meint eine maschinenlesbare Kopie, die in "
5689 #~ "einem der Allgemeinheit zugänglichen Format repräsentiert ist, deren "
5690 #~ "Inhalt direkt und einfach mit gebräuchlichen Texteditoren oder (bei aus "
5691 #~ "Pixeln bestehenden Bildern) gebräuchlichen Zeichenprogrammen oder (bei "
5692 #~ "Bildern) weit verbreiteten Bildverarbeitungsprogramm besehen und "
5693 #~ "verändert werden kann, und das geeignet ist, in Textformatierern "
5694 #~ "eingegeben werden zu können oder automatisch in eine Vielzahl von "
5695 #~ "Formaten übersetzt werden kann, die geeignet sind, in Textformatierern "
5696 #~ "eingegeben werden zu können. Eine Kopie in einem anderen Transparenten "
5697 #~ "Dateiformat, dessen Aufbau gestaltet wurde, eine ständige Veränderung "
5698 #~ "durch den Leser zu vereiteln oder abzuwenden, ist nicht Transparent. Eine "
5699 #~ "Kopie die nicht <quote>Transparent</quote> ist, nennt man "
5700 #~ "<quote>Undurchsichtig</quote>."
5701
5702 #~ msgid ""
5703 #~ "The <quote>Title Page</quote> means, for a printed book, the title page "
5704 #~ "itself, plus such following pages as are needed to hold, legibly, the "
5705 #~ "material this License requires to appear in the title page. For works in "
5706 #~ "formats which do not have any title page as such, <quote>Title Page</"
5707 #~ "quote> means the text near the most prominent appearance of the work's "
5708 #~ "title, preceding the beginning of the body of the text."
5709 #~ msgstr ""
5710 #~ "Die <quote>Titelseite</quote> meint bei einem gedruckten Buch die "
5711 #~ "Titelseite selbst, und die folgenden Seiten, die gebraucht werden, um "
5712 #~ "leserlich das Material zu beinhalten, das die Lizenz benötigt, um auf der "
5713 #~ "Titelseite zu erscheinen. Für Arbeiten, die als solche keine Titelseiten "
5714 #~ "haben, meint <quote>Titelseite</quote> den Text, der der wirkungsvollsten "
5715 #~ "Erscheinung des Arbeitstitels am nächsten kommt und den Textkörper "
5716 #~ "einleitet."
5717
5718 #~ msgid ""
5719 #~ "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
5720 #~ "link> in any medium, either commercially or noncommercially, provided "
5721 #~ "that this License, the copyright notices, and the license notice saying "
5722 #~ "this License applies to the Document are reproduced in all copies, and "
5723 #~ "that you add no other conditions whatsoever to those of this License. You "
5724 #~ "may not use technical measures to obstruct or control the reading or "
5725 #~ "further copying of the copies you make or distribute. However, you may "
5726 #~ "accept compensation in exchange for copies. If you distribute a large "
5727 #~ "enough number of copies you must also follow the conditions in <link "
5728 #~ "linkend=\"fdl-section3\">section 3</link>."
5729 #~ msgstr ""
5730 #~ "Sie dürfen das <link linkend=\"fdl-document\">Dokument</link> auf jedem "
5731 #~ "Medium kopieren und verteilen, entweder kommerziell oder "
5732 #~ "nichtkommerziell, vorausgesetzt, dass die Lizenz, die Copyrighthinweise "
5733 #~ "und der Lizenzhinweis, der besagt, dass die Lizenz für das Dokument gilt, "
5734 #~ "in allen Kopien reproduziert werden, und dass Sie keine wie auch immer "
5735 #~ "lautenden andere Bedingungen als die der Lizenz hinzufügen. Sie dürfen "
5736 #~ "keine technischen Möglichkeiten nutzen, die das Lesen oder Weiterkopieren "
5737 #~ "der Kopien, die Sie machen oder weiterkopieren, kontrollieren oder "
5738 #~ "behindern. Wie auch immer, Sie dürfen im Gegenzug Vergütungen für Kopien "
5739 #~ "akzeptieren. Wenn Sie eine genügend große Anzahl von Kopien verteilen, "
5740 #~ "müssen Sie auch den Bedingungen in <link linkend=\"fdl-"
5741 #~ "section3\">Abschnitt 3</link> zustimmen."
5742
5743 #~ msgid ""
5744 #~ "If you publish printed copies of the <link linkend=\"fdl-"
5745 #~ "document\">Document</link> numbering more than 100, and the Document's "
5746 #~ "license notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</"
5747 #~ "link>, you must enclose the copies in covers that carry, clearly and "
5748 #~ "legibly, all these Cover Texts: Front-Cover Texts on the front cover, and "
5749 #~ "Back-Cover Texts on the back cover. Both covers must also clearly and "
5750 #~ "legibly identify you as the publisher of these copies. The front cover "
5751 #~ "must present the full title with all words of the title equally prominent "
5752 #~ "and visible. You may add other material on the covers in addition. "
5753 #~ "Copying with changes limited to the covers, as long as they preserve the "
5754 #~ "title of the <link linkend=\"fdl-document\">Document</link> and satisfy "
5755 #~ "these conditions, can be treated as verbatim copying in other respects."
5756 #~ msgstr ""
5757 #~ "Wenn Sie mehr als 100 gedruckte Kopien des <link linkend=\"fdl-"
5758 #~ "document\">Dokumentes</link> veröffentlichen, und die Lizenz des "
5759 #~ "Dokumentes <link linkend=\"fdl-cover-texts\">Cover-Texte</link> verlangt, "
5760 #~ "müssen Sie die Kopien in Verpackungen einschließen, die sauber und "
5761 #~ "leserlich all diese Cover-Texte enthalten: Vorderseitentexte auf der "
5762 #~ "Vorderseite, und Rückseitentexte auf der Rückseite. Beide Seiten müssen "
5763 #~ "auch sauber und leserlich Sie als den Veröffentlicher dieser Kopien "
5764 #~ "identifizieren. Die Vorderseite muß den vollen Titel mit allen Wörtern "
5765 #~ "des Titels gleich auffällig und sichtbar darstellen. Sie dürfen andere "
5766 #~ "Materialien zusätzlich der Seite hinzufügen. Kopieren mit Veränderungen "
5767 #~ "der Seiten, solange diese den Titel des <link linkend=\"fdl-"
5768 #~ "document\">Dokumentes</link> absichern und diese Bedingungen erfüllen, "
5769 #~ "können in anderer Hinsicht als wortwörtliche Kopien behandelt werden."
5770
5771 #~ msgid ""
5772 #~ "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</"
5773 #~ "link> copies of the <link linkend=\"fdl-document\">Document</link> "
5774 #~ "numbering more than 100, you must either include a machine-readable <link "
5775 #~ "linkend=\"fdl-transparent\">Transparent</link> copy along with each "
5776 #~ "Opaque copy, or state in or with each Opaque copy a publicly-accessible "
5777 #~ "computer-network location containing a complete Transparent copy of the "
5778 #~ "Document, free of added material, which the general network-using public "
5779 #~ "has access to download anonymously at no charge using public-standard "
5780 #~ "network protocols. If you use the latter option, you must take reasonably "
5781 #~ "prudent steps, when you begin distribution of Opaque copies in quantity, "
5782 #~ "to ensure that this Transparent copy will remain thus accessible at the "
5783 #~ "stated location until at least one year after the last time you "
5784 #~ "distribute an Opaque copy (directly or through your agents or retailers) "
5785 #~ "of that edition to the public."
5786 #~ msgstr ""
5787 #~ "Wenn Sie mehr als 100 <link linkend=\"fdl-transparent\">Undurchsichtige "
5788 #~ "Kopien</link> des <link linkend=\"fdl-document\">Dokumentes</link> "
5789 #~ "veröffentlichen oder verteilen, müssen Sie entweder zusammen mit jeder "
5790 #~ "Undurchsichtigen Kopie eine <link linkend=\"fdl-"
5791 #~ "transparent\">Transparente Kopie</link> einfügen, oder in oder mit jeder "
5792 #~ "Undurchsichtigen Kopie eine öffentlich zugängliche Computer-Netzwerk-"
5793 #~ "Adresse angeben, die eine komplette Transparente Kopie des Dokumentes "
5794 #~ "enthält, die frei von hinzugefügtem Material ist und die sich die "
5795 #~ "allgemeine netzwerknutzende Öffentlichkeit mit Standard-"
5796 #~ "Netzwerkprotokollen unentgeltlich herunterladen kann. Wenn Sie die letzte "
5797 #~ "Option verwenden, müssen Sie, wenn Sie beginnen, Undurchsichtige Kopien "
5798 #~ "in Mengen zu verteilen, vernünftige umsichtige Schritte unternehmen, die "
5799 #~ "sicherstellen, dass die Transparente Kopie unter der genannten Adresse "
5800 #~ "mindestens ein Jahr, nachdem Sie das letzte Mal eine Undurchsichtige "
5801 #~ "Kopie dieser Edition (direkt oder über Ihre Vermittler oder Händler) an "
5802 #~ "die Öffentlichkeit verteilt haben."
5803
5804 #~ msgid ""
5805 #~ "It is requested, but not required, that you contact the authors of the "
5806 #~ "<link linkend=\"fdl-document\">Document</link> well before redistributing "
5807 #~ "any large number of copies, to give them a chance to provide you with an "
5808 #~ "updated version of the Document."
5809 #~ msgstr ""
5810 #~ "Es wird erbeten, aber nicht verlangt, dass Sie die Autoren des <link "
5811 #~ "linkend=\"fdl-document\">Dokumentes</link> kontaktieren, bevor Sie eine "
5812 #~ "große Anzahl an Kopien weiterverteilen, um ihnen zu ermöglichen, Sie mit "
5813 #~ "einer aktualisierten Version des Dokumentes zu versorgen."
5814
5815 #~ msgid ""
5816 #~ "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
5817 #~ "Version</link> of the <link linkend=\"fdl-document\">Document</link> "
5818 #~ "under the conditions of sections <link linkend=\"fdl-section2\">2</link> "
5819 #~ "and <link linkend=\"fdl-section3\">3</link> above, provided that you "
5820 #~ "release the Modified Version under precisely this License, with the "
5821 #~ "Modified Version filling the role of the Document, thus licensing "
5822 #~ "distribution and modification of the Modified Version to whoever "
5823 #~ "possesses a copy of it. In addition, you must do these things in the "
5824 #~ "Modified Version:"
5825 #~ msgstr ""
5826 #~ "Sie dürfen eine <link linkend=\"fdl-modified\">Modifizierte Version</"
5827 #~ "link> eines <link linkend=\"fdl-document\">Dokumentes</link> unter den in "
5828 #~ "den Abschnitten <link linkend=\"fdl-section2\">2</link> und <link "
5829 #~ "linkend=\"fdl-section3\">3</link> oben stehenden Bedingungen kopieren und "
5830 #~ "verteilen, vorausgesetzt, Sie veröffentlichen die Modifizierte Version "
5831 #~ "unter genau dieser Lizenz, so dass die modifizierte Version die Stelle "
5832 #~ "des Dokumentes einnimmt, folglich auch das Lizenzieren der Verteilung und "
5833 #~ "Modifikation der Modifizierten Version an jeden, der eine Kopie davon "
5834 #~ "besitzt. Zusätzlich müssen Sie diese Dinge in der Modifizierten Version "
5835 #~ "tun:"
5836
5837 #~ msgid ""
5838 #~ "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
5839 #~ "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
5840 #~ "document\">Document</link>, and from those of previous versions (which "
5841 #~ "should, if there were any, be listed in the History section of the "
5842 #~ "Document). You may use the same title as a previous version if the "
5843 #~ "original publisher of that version gives permission."
5844 #~ msgstr ""
5845 #~ "Auf der <link linkend=\"fdl-title-page\">Titelseite</link> (und auf den "
5846 #~ "Covern, falls vorhanden) einen Titel verwenden, der sich von dem des "
5847 #~ "<link linkend=\"fdl-document\">Dokumentes</link> unterscheidet, und von "
5848 #~ "denen vorhergehender Versionen (die, falls vorhanden, in dem History-"
5849 #~ "Abschnitt des Dokumentes aufgeführt sein sollten). Sie dürfen denselben "
5850 #~ "Titel wie in einer vorhergehenden Version nutzen, wenn der ursprüngliche "
5851 #~ "Veröffentlicher sein Einverständnis gibt."
5852
5853 #~ msgid ""
5854 #~ "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as "
5855 #~ "authors, one or more persons or entities responsible for authorship of "
5856 #~ "the modifications in the <link linkend=\"fdl-modified\">Modified Version</"
5857 #~ "link>, together with at least five of the principal authors of the <link "
5858 #~ "linkend=\"fdl-document\">Document</link> (all of its principal authors, "
5859 #~ "if it has less than five)."
5860 #~ msgstr ""
5861 #~ "Auf der <link linkend=\"fdl-title-page\">Titelseite</link>, eine oder "
5862 #~ "mehrere Personen als Autoren benennen, die für das Einbringen von "
5863 #~ "Veränderungen in die <link linkend=\"fdl-modified\">Modifizierte Version</"
5864 #~ "link> verantwortlich sind, zusammen mit mindesten fünf eigentlichen "
5865 #~ "Autoren des <link linkend=\"fdl-document\">Dokumentes</link> (allen "
5866 #~ "eigentlichen Autoren, wenn es weniger als fünf sind)."
5867
5868 #~ msgid ""
5869 #~ "State on the <link linkend=\"fdl-title-page\">Title Page</link> the name "
5870 #~ "of the publisher of the <link linkend=\"fdl-modified\">Modified Version</"
5871 #~ "link>, as the publisher."
5872 #~ msgstr ""
5873 #~ "Auf der <link linkend=\"fdl-title-page\">Titelseite</link> den Namen des "
5874 #~ "Veröffentlichers der <link linkend=\"fdl-modified\">Modifizierten "
5875 #~ "Version</link> als Veröffentlicher kennzeichnen."
5876
5877 #~ msgid ""
5878 #~ "Preserve all the copyright notices of the <link linkend=\"fdl-"
5879 #~ "document\">Document</link>."
5880 #~ msgstr ""
5881 #~ "Alle Copyright-Hinweise des <link linkend=\"fdl-document\">Dokumentes</"
5882 #~ "link> beibehalten."
5883
5884 #~ msgid ""
5885 #~ "Include, immediately after the copyright notices, a license notice giving "
5886 #~ "the public permission to use the <link linkend=\"fdl-modified\">Modified "
5887 #~ "Version</link> under the terms of this License, in the form shown in the "
5888 #~ "Addendum below."
5889 #~ msgstr ""
5890 #~ "Gleich hinter dem Copyright-Hinweis einen Lizenzhinweis einfügen, der die "
5891 #~ "öffentliche Erlaubnis gibt, die <link linkend=\"fdl-"
5892 #~ "modified\">Modifizierte Version</link> unter den Bedingungen dieser "
5893 #~ "Lizenz zu nutzen, in einer Form, die weiter unten im Anhang dargestellt "
5894 #~ "ist."
5895
5896 #~ msgid ""
5897 #~ "Preserve in that license notice the full lists of <link linkend=\"fdl-"
5898 #~ "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
5899 #~ "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-"
5900 #~ "document\">Document's</link> license notice."
5901 #~ msgstr ""
5902 #~ "In dem Lizenzhinweis die volle Liste der <link linkend=\"fdl-"
5903 #~ "invariant\">Unveränderlichen Abschnitte</link> und benötigten <link "
5904 #~ "linkend=\"fdl-cover-texts\">Cover-Texte</link>, die in dem Lizenzhinweis "
5905 #~ "des <link linkend=\"fdl-document\">Dokumentes</link> gegeben ist, "
5906 #~ "beibehalten."
5907
5908 #~ msgid ""
5909 #~ "Preserve the section entitled <quote>History</quote>, and its title, and "
5910 #~ "add to it an item stating at least the title, year, new authors, and "
5911 #~ "publisher of the <link linkend=\"fdl-modified\">Modified Version</link> "
5912 #~ "as given on the <link linkend=\"fdl-title-page\">Title Page</link>. If "
5913 #~ "there is no section entitled <quote>History</quote> in the <link "
5914 #~ "linkend=\"fdl-document\">Document</link>, create one stating the title, "
5915 #~ "year, authors, and publisher of the Document as given on its Title Page, "
5916 #~ "then add an item describing the Modified Version as stated in the "
5917 #~ "previous sentence."
5918 #~ msgstr ""
5919 #~ "Den Abschnitt, der mit <quote>History</quote> (Geschichte) betitelt ist, "
5920 #~ "und seinen Titel beibehalten und ihn zu einem Punkt hinzufügen, der "
5921 #~ "mindestens Titel, Jahr, neue Autoren, und Veröffentlicher der <link "
5922 #~ "linkend=\"fdl-modified\">Modifizierten Version</link> wie auf der <link "
5923 #~ "linkend=\"fdl-title-page\">Titelseite</link> gegeben, benennt. Wenn es "
5924 #~ "keinen mit <quote>History</quote> betitelten Abschnitt gibt, erstellen "
5925 #~ "Sie einen, der den Titel, Jahr, Autoren, und Veröffentlicher des <link "
5926 #~ "linkend=\"fdl-document\">Dokumentes</link> wie auf der Titelseite "
5927 #~ "gegeben, benennt, und fügen Sie dann einen Punkt hinzu, der die "
5928 #~ "Modifizierte Version beschreibt wie im vorhergehenden Satz."
5929
5930 #~ msgid ""
5931 #~ "Preserve the network location, if any, given in the <link linkend=\"fdl-"
5932 #~ "document\">Document</link> for public access to a <link linkend=\"fdl-"
5933 #~ "transparent\">Transparent</link> copy of the Document, and likewise the "
5934 #~ "network locations given in the Document for previous versions it was "
5935 #~ "based on. These may be placed in the <quote>History</quote> section. You "
5936 #~ "may omit a network location for a work that was published at least four "
5937 #~ "years before the Document itself, or if the original publisher of the "
5938 #~ "version it refers to gives permission."
5939 #~ msgstr ""
5940 #~ "Die Netzwerk-Adresse, falls aufgeführt, beibehalten, die im <link "
5941 #~ "linkend=\"fdl-document\">Dokument</link> aufgeführt ist, um öffentlichen "
5942 #~ "Zugriff zu einer <link linkend=\"fdl-transparent\">Transparenten</link> "
5943 #~ "Kopie des Dokumentes zu ermöglichen, und genauso die Netzwerk-Adressen, "
5944 #~ "die im Dokument für frühere Versionen, auf denen es basiert, aufgeführt "
5945 #~ "sind. Diese können in den <quote>History</quote>-Abschnitt gestellt "
5946 #~ "werden. Sie können eine Netzwerk-Adresse für ein Werk auslassen, das "
5947 #~ "mindestens vier Jahre vor dem Dokument selbst veröffentlicht wurde, oder "
5948 #~ "wenn der ursprüngliche Autor, auf den sich die jeweilige Version bezieht, "
5949 #~ "es erlaubt."
5950
5951 #~ msgid ""
5952 #~ "In any section entitled <quote>Acknowledgements</quote> or "
5953 #~ "<quote>Dedications</quote>, preserve the section's title, and preserve in "
5954 #~ "the section all the substance and tone of each of the contributor "
5955 #~ "acknowledgements and/or dedications given therein."
5956 #~ msgstr ""
5957 #~ "In jeglichem Abschnitt, der mit <quote>Acknowledgements</quote> "
5958 #~ "(Anerkennungen) oder <quote>Dedications</quote> (Widmungen) betitelt ist, "
5959 #~ "den Titel des Abschnittes beibehalten, und in dem Abschnitt allen Inhalt "
5960 #~ "und Ton von jeder Anerkennung und/oder Widmung jedes Beitragenden "
5961 #~ "beibehalten, der dort aufgeführt ist."
5962
5963 #~ msgid ""
5964 #~ "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</"
5965 #~ "link> of the <link linkend=\"fdl-document\">Document</link>, unaltered in "
5966 #~ "their text and in their titles. Section numbers or the equivalent are not "
5967 #~ "considered part of the section titles."
5968 #~ msgstr ""
5969 #~ "Alle <link linkend=\"fdl-invariant\">Unveränderlichen Abschnitte</link> "
5970 #~ "des <link linkend=\"fdl-document\">Dokumentes</link> beibehalten, "
5971 #~ "unverändert in ihrem Text und ihren Titeln. Abschnittsnummern oder "
5972 #~ "ähnliches werden nicht als Teil von Abschnittstiteln betrachtet."
5973
5974 #~ msgid ""
5975 #~ "Delete any section entitled <quote>Endorsements</quote>. Such a section "
5976 #~ "may not be included in the <link linkend=\"fdl-modified\">Modified "
5977 #~ "Version</link>."
5978 #~ msgstr ""
5979 #~ "Alle Abschnitte, die mit <quote>Endorsements</quote> (Billigungen) "
5980 #~ "betitelt sind, löschen. Solche Abschnitte dürfen nicht mit in die <link "
5981 #~ "linkend=\"fdl-modified\">Modifizierte Version</link> aufgenommen werden."
5982
5983 #~ msgid ""
5984 #~ "Do not retitle any existing section as <quote>Endorsements</quote> or to "
5985 #~ "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
5986 #~ "Section</link>."
5987 #~ msgstr ""
5988 #~ "Betiteln Sie keine existierenden Abschnitte mit <quote>Endorsements</"
5989 #~ "quote> oder so, dass sie im Widerspruch zu Titeln von <link linkend=\"fdl-"
5990 #~ "invariant\">Unveränderlichen Abschnitten</link> stehen."
5991
5992 #~ msgid ""
5993 #~ "If the <link linkend=\"fdl-modified\">Modified Version</link> includes "
5994 #~ "new front-matter sections or appendices that qualify as <link "
5995 #~ "linkend=\"fdl-secondary\">Secondary Sections</link> and contain no "
5996 #~ "material copied from the Document, you may at your option designate some "
5997 #~ "or all of these sections as invariant. To do this, add their titles to "
5998 #~ "the list of <link linkend=\"fdl-invariant\">Invariant Sections</link> in "
5999 #~ "the Modified Version's license notice. These titles must be distinct from "
6000 #~ "any other section titles."
6001 #~ msgstr ""
6002 #~ "Wenn die <link linkend=\"fdl-modified\">Modifizierte Version</link> neue "
6003 #~ "wichtige Abschnitte enthält oder Anhänge, die <link linkend=\"fdl-"
6004 #~ "secondary\">Sekundäre Abschnitte</link> darstellen, und kein Material "
6005 #~ "enthalten, das aus dem Dokument kopiert wurde, dürfen Sie nach Ihrer Wahl "
6006 #~ "einige oder alle diese Abschnitte als Unveränderlich bezeichnen. Um dies "
6007 #~ "zu tun, fügen Sie ihre Titel der Liste der <link linkend=\"fdl-"
6008 #~ "invariant\">Unveränderlichen Abschnitte</link> in dem Lizenzhinweis der "
6009 #~ "Modifizierten Version hinzu. Diese Titel müssen sich von allen anderen "
6010 #~ "Abschnittstiteln unterscheiden."
6011
6012 #~ msgid ""
6013 #~ "You may add a section entitled <quote>Endorsements</quote>, provided it "
6014 #~ "contains nothing but endorsements of your <link linkend=\"fdl-"
6015 #~ "modified\">Modified Version</link> by various parties--for example, "
6016 #~ "statements of peer review or that the text has been approved by an "
6017 #~ "organization as the authoritative definition of a standard."
6018 #~ msgstr ""
6019 #~ "Sie dürfen einen Abschnitt <quote>Endorsements</quote> hinzufügen, "
6020 #~ "vorausgesetzt, er enthält nichts außer Bewilligungen Ihrer <link "
6021 #~ "linkend=\"fdl-modified\">Modifizierten Version</link> von verschiedenen "
6022 #~ "Seiten -- zum Beispiel Aussagen von Beurteilungen, oder dass der Text von "
6023 #~ "einer Organisation als für die autoritäre Definition eines Standards "
6024 #~ "befunden wurde."
6025
6026 #~ msgid ""
6027 #~ "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
6028 #~ "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a "
6029 #~ "<link linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of "
6030 #~ "the list of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the "
6031 #~ "<link linkend=\"fdl-modified\">Modified Version</link>. Only one passage "
6032 #~ "of Front-Cover Text and one of Back-Cover Text may be added by (or "
6033 #~ "through arrangements made by) any one entity. If the <link linkend=\"fdl-"
6034 #~ "document\">Document</link> already includes a cover text for the same "
6035 #~ "cover, previously added by you or by arrangement made by the same entity "
6036 #~ "you are acting on behalf of, you may not add another; but you may replace "
6037 #~ "the old one, on explicit permission from the previous publisher that "
6038 #~ "added the old one."
6039 #~ msgstr ""
6040 #~ "Sie dürfen eine Passage aus bis zu fünf Wörtern als <link linkend=\"fdl-"
6041 #~ "cover-texts\">Vorderseitentext</link> hinzufügen, und eine Passage von "
6042 #~ "bis zu 25 Wörtern als <link linkend=\"fdl-cover-texts\">Rückseitentext</"
6043 #~ "link>, ans Ende der Liste von <link linkend=\"fdl-cover-"
6044 #~ "texts\">Covertexten</link> in der <link linkend=\"fdl-"
6045 #~ "modified\">Modifizierten Version</link>. Höchstens eine Passage von "
6046 #~ "Vorderseitentexten und eine von Rückseitentexten darf von (oder durch "
6047 #~ "Abmachungen von) irgendeinem Wesen hinzugefügt werden. Wenn das <link "
6048 #~ "linkend=\"fdl-document\">Dokument</link> für die entsprechende Seite "
6049 #~ "schon einen Covertext hat, der vorher von Ihnen oder durch Abmachungen "
6050 #~ "von demselben Wesen, in dessen Namen Sie handeln, hinzugefügt wurde, "
6051 #~ "dürfen Sie keinen anderen hinzufügen; aber Sie dürfen den alten, wenn es "
6052 #~ "der ursprüngliche Veröffentlicher, der den alten hinzugefügt hat, "
6053 #~ "explizit erlaubt, ersetzen."
6054
6055 #~ msgid ""
6056 #~ "The author(s) and publisher(s) of the <link linkend=\"fdl-"
6057 #~ "document\">Document</link> do not by this License give permission to use "
6058 #~ "their names for publicity for or to assert or imply endorsement of any "
6059 #~ "<link linkend=\"fdl-modified\">Modified Version </link>."
6060 #~ msgstr ""
6061 #~ "Der/die Autor(en) und Veröffentlicher des <link linkend=\"fdl-"
6062 #~ "document\">Dokumentes</link> erteilen durch diese Lizenz nicht die "
6063 #~ "Erlaubnis, ihre Namen für Veröffentlichungen für Bewilligungen "
6064 #~ "irgendeiner <link linkend=\"fdl-modified\">Modifizierten Version</link> "
6065 #~ "oder deren Durchsetzungen oder Andeutungen zu nutzen."
6066
6067 #~ msgid ""
6068 #~ "You may combine the <link linkend=\"fdl-document\">Document</link> with "
6069 #~ "other documents released under this License, under the terms defined in "
6070 #~ "<link linkend=\"fdl-section4\">section 4</link> above for modified "
6071 #~ "versions, provided that you include in the combination all of the <link "
6072 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> of all of the "
6073 #~ "original documents, unmodified, and list them all as Invariant Sections "
6074 #~ "of your combined work in its license notice."
6075 #~ msgstr ""
6076 #~ "Sie dürfen das <link linkend=\"fdl-document\">Dokument</link> mit anderen "
6077 #~ "Dokumenten, die unter dieser Lizenz veröffentlicht wurden, unter den "
6078 #~ "Bedingungen in <link linkend=\"fdl-section4\">Abschnitt 4</link> für "
6079 #~ "Modifizierte Versionen kombinieren, vorausgesetzt, Sie beinhalten in der "
6080 #~ "Kombination alle <link linkend=\"fdl-invariant\">Unveränderlichen "
6081 #~ "Abschnitte</link> aller ursprünglichen Dokumente unverändert, und führen "
6082 #~ "Sie alle als Unveränderliche Abschnitte Ihrer kombinierten Arbeit in "
6083 #~ "deren Lizenzhinweis auf."
6084
6085 #~ msgid ""
6086 #~ "The combined work need only contain one copy of this License, and "
6087 #~ "multiple identical <link linkend=\"fdl-invariant\">Invariant Sections</"
6088 #~ "link> may be replaced with a single copy. If there are multiple Invariant "
6089 #~ "Sections with the same name but different contents, make the title of "
6090 #~ "each such section unique by adding at the end of it, in parentheses, the "
6091 #~ "name of the original author or publisher of that section if known, or "
6092 #~ "else a unique number. Make the same adjustment to the section titles in "
6093 #~ "the list of Invariant Sections in the license notice of the combined work."
6094 #~ msgstr ""
6095 #~ "Die kombinierte Arbeit braucht nur eine Kopie dieser Lizenz zu "
6096 #~ "beinhalten, und mehrfache identische <link linkend=\"fdl-"
6097 #~ "invariant\">Unveränderliche Abschnitte</link> können durch eine einzige "
6098 #~ "Kopie ersetzt werden. Wenn es mehrere Unveränderliche Abschnitte mit "
6099 #~ "demselben Titel, aber unterschiedlichem Inhalt gibt, machen Sie den Titel "
6100 #~ "jedes Abschnittes durch Hinzufügen (in Klammern) des Namens des "
6101 #~ "ursprünglichen Autors oder Veröffentlichers dieses Abschnittes, falls "
6102 #~ "bekannt, unverwechselbar, oder ansonsten durch eine einzigartige Nummer. "
6103 #~ "Führen Sie dieselben Änderungen in der Liste der Unveränderlichen "
6104 #~ "Abschnitte im Lizenzhinweis der kombinierten Arbeit durch."
6105
6106 #~ msgid ""
6107 #~ "In the combination, you must combine any sections entitled "
6108 #~ "<quote>History</quote> in the various original documents, forming one "
6109 #~ "section entitled <quote>History</quote>; likewise combine any sections "
6110 #~ "entitled <quote>Acknowledgements</quote>, and any sections entitled "
6111 #~ "<quote>Dedications</quote>. You must delete all sections entitled "
6112 #~ "<quote>Endorsements.</quote>"
6113 #~ msgstr ""
6114 #~ "In der Kombination müssen Sie alle mit <quote>History</quote> betitelten "
6115 #~ "Abschnitte aus den verschiedenen ursprünglichen Dokumenten "
6116 #~ "zusammenführen, und daraus einen Abschnitt <quote>History</quote> bilden; "
6117 #~ "genauso kombinieren Sie jeden mit <quote>Acknowledgements</quote> "
6118 #~ "betitelten Abschnitt, und jeden mit <quote>Dedications</quote> betitelten "
6119 #~ "Abschnitt. Sie müssen jeden mit <quote>Endorsements</quote> betitelten "
6120 #~ "Abschnitt löschen."
6121
6122 #~ msgid ""
6123 #~ "You may make a collection consisting of the <link linkend=\"fdl-"
6124 #~ "document\">Document</link> and other documents released under this "
6125 #~ "License, and replace the individual copies of this License in the various "
6126 #~ "documents with a single copy that is included in the collection, provided "
6127 #~ "that you follow the rules of this License for verbatim copying of each of "
6128 #~ "the documents in all other respects."
6129 #~ msgstr ""
6130 #~ "Sie dürfen eine Sammlung erstellen, die aus dem <link linkend=\"fdl-"
6131 #~ "document\">Dokument</link> und anderen, unter dieser Lizenz "
6132 #~ "veröffentlichten Dokumenten besteht, und die individuellen Kopien der "
6133 #~ "Lizenz in den einzelnen Dokumenten durch eine einzige Kopie ersetzen, die "
6134 #~ "sich in der Sammlung befindet, vorausgesetzt, Sie folgen den Regeln "
6135 #~ "dieser Lizenz für wortwörtliches Kopieren jedes dieser Dokumente in "
6136 #~ "jeglicher Hinsicht."
6137
6138 #~ msgid ""
6139 #~ "A compilation of the <link linkend=\"fdl-document\">Document</link> or "
6140 #~ "its derivatives with other separate and independent documents or works, "
6141 #~ "in or on a volume of a storage or distribution medium, does not as a "
6142 #~ "whole count as a <link linkend=\"fdl-modified\">Modified Version</link> "
6143 #~ "of the Document, provided no compilation copyright is claimed for the "
6144 #~ "compilation. Such a compilation is called an <quote>aggregate</quote>, "
6145 #~ "and this License does not apply to the other self-contained works thus "
6146 #~ "compiled with the Document , on account of their being thus compiled, if "
6147 #~ "they are not themselves derivative works of the Document. If the <link "
6148 #~ "linkend=\"fdl-cover-texts\">Cover Text</link> requirement of <link "
6149 #~ "linkend=\"fdl-section3\">section 3</link> is applicable to these copies "
6150 #~ "of the Document, then if the Document is less than one quarter of the "
6151 #~ "entire aggregate, the Document's Cover Texts may be placed on covers that "
6152 #~ "surround only the Document within the aggregate. Otherwise they must "
6153 #~ "appear on covers around the whole aggregate."
6154 #~ msgstr ""
6155 #~ "Eine Zusammenstellung dieses <link linkend=\"fdl-document\">Dokumentes</"
6156 #~ "link> oder seinen Ableitungen mit anderen separaten und unabhängigen "
6157 #~ "Dokumenten oder Arbeiten, in oder auf einem Teil eines Speicher- oder "
6158 #~ "Verteilungsmediums, zählt nicht als Ganzes als <link linkend=\"fdl-"
6159 #~ "modified\">Modifizierte Version</link> des Dokumentes, vorausgesetzt, "
6160 #~ "kein Gesamt-Copyright wurde für die Zusammenstellung festgelegt. Solch "
6161 #~ "eine Zusammenstellung wird <quote>Aggregat</quote> (Mischung) genannt, "
6162 #~ "und diese Lizenz gilt nicht für die anderen selbstenthaltenen Arbeiten, "
6163 #~ "die mit dem Dokument zusammengestellt wurden, im Falle, dass sie "
6164 #~ "zusammengestellt wurden, wenn sie nicht selbst abgeleitete Arbeiten des "
6165 #~ "Dokumentes sind. Wenn die <link linkend=\"fdl-cover-texts\">Covertext</"
6166 #~ "link>-Bedingung von <link linkend=\"fdl-section3\">Abschnitt 3</link> auf "
6167 #~ "diese Kopien des Dokumentes anwendbar ist, dann können, wenn das Dokument "
6168 #~ "weniger als ein Viertel des gesamten Aggregates ist, die Covertexte des "
6169 #~ "Dokumentes auf Seiten platziert werden, die nur das Dokument innerhalb "
6170 #~ "des Aggregates umgeben. Ansonsten müssen sie auf Seiten erscheinen, die "
6171 #~ "das gesamte Aggregat umgeben."
6172
6173 #~ msgid ""
6174 #~ "Translation is considered a kind of modification, so you may distribute "
6175 #~ "translations of the <link linkend=\"fdl-document\">Document</link> under "
6176 #~ "the terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing "
6177 #~ "<link linkend=\"fdl-invariant\"> Invariant Sections</link> with "
6178 #~ "translations requires special permission from their copyright holders, "
6179 #~ "but you may include translations of some or all Invariant Sections in "
6180 #~ "addition to the original versions of these Invariant Sections. You may "
6181 #~ "include a translation of this License provided that you also include the "
6182 #~ "original English version of this License. In case of a disagreement "
6183 #~ "between the translation and the original English version of this License, "
6184 #~ "the original English version will prevail."
6185 #~ msgstr ""
6186 #~ "Übersetzung wird als eine Art Modifikation angesehen, also dürfen Sie "
6187 #~ "Übersetzungen des <link linkend=\"fdl-document\">Dokumentes</link> unter "
6188 #~ "den Bedingungen von <link linkend=\"fdl-section4\">Abschnitt 4</link> "
6189 #~ "verteilen. Das Ersetzen von <link linkend=\"fdl-"
6190 #~ "invariant\">Unveränderlichen Abschnitten</link> mit Übersetzungen "
6191 #~ "erfordert spezielle Einwilligung des Copyright-Halters, aber Sie dürfen "
6192 #~ "Übersetzungen von einigen oder allen Unveränderlichen Abschnitten "
6193 #~ "zusätzlich zu den ursprünglichen Versionen dieser Unveränderlichen "
6194 #~ "Abschnitte einfügen. Sie dürfen eine Übersetzung dieser Lizenz "
6195 #~ "hinzufügen, vorausgesetzt Sie beinhalten auch die ursprüngliche englische "
6196 #~ "Version dieser Lizenz. Im Falle einer Nichtübereinstimmung zwischen der "
6197 #~ "Übersetzung und der ursprünglichen englischen Version dieser Lizenz hat "
6198 #~ "die ursprüngliche englische Version Vorrang."
6199
6200 #~ msgid ""
6201 #~ "You may not copy, modify, sublicense, or distribute the <link "
6202 #~ "linkend=\"fdl-document\">Document</link> except as expressly provided for "
6203 #~ "under this License. Any other attempt to copy, modify, sublicense or "
6204 #~ "distribute the Document is void, and will automatically terminate your "
6205 #~ "rights under this License. However, parties who have received copies, or "
6206 #~ "rights, from you under this License will not have their licenses "
6207 #~ "terminated so long as such parties remain in full compliance."
6208 #~ msgstr ""
6209 #~ "Sie dürfen das <link linkend=\"fdl-document\">Dokument</link> nicht "
6210 #~ "kopieren, modifizieren, sublizenzieren oder verteilen, außer wie es diese "
6211 #~ "Lizenz ausdrücklich vorschreibt. Jegliche andere Absicht, das Dokument zu "
6212 #~ "kopieren, modifizieren, sublizenzieren oder verteilen, ist nichtig und "
6213 #~ "beendet automatisch Ihre Rechte unter dieser Lizenz. Wie auch immer, "
6214 #~ "Parteien, die Kopien oder Rechte von Ihnen unter dieser Lizenz bekommen "
6215 #~ "haben, wird nicht die Lizenz beendet, solange diese Parteien in voller "
6216 #~ "Zustimmung verbleiben."
6217
6218 #~ msgid ""
6219 #~ "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6220 #~ "Software Foundation</ulink> may publish new, revised versions of the GNU "
6221 #~ "Free Documentation License from time to time. Such new versions will be "
6222 #~ "similar in spirit to the present version, but may differ in detail to "
6223 #~ "address new problems or concerns. See <ulink type=\"http\" url=\"http://"
6224 #~ "www.gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
6225 #~ msgstr ""
6226 #~ "Die <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6227 #~ "Software Foundation</ulink> kann von Zeit zu Zeit neue, revidierte "
6228 #~ "Versionen der GNU Free Documentation License veröffentlichen. Solche neue "
6229 #~ "Versionen werden vom Grundprinzip her der vorliegenden Version gleichen, "
6230 #~ "können sich aber im Detail unterscheiden, um neue Probleme oder Anliegen "
6231 #~ "anzusprechen. Siehe auch <ulink type=\"http\" url=\"http://www.gnu.org/"
6232 #~ "copyleft\">http://www.gnu.org/copyleft/</ulink>."
6233
6234 #~ msgid ""
6235 #~ "Each version of the License is given a distinguishing version number. If "
6236 #~ "the <link linkend=\"fdl-document\">Document</link> specifies that a "
6237 #~ "particular numbered version of this License <quote>or any later version</"
6238 #~ "quote> applies to it, you have the option of following the terms and "
6239 #~ "conditions either of that specified version or of any later version that "
6240 #~ "has been published (not as a draft) by the Free Software Foundation. If "
6241 #~ "the Document does not specify a version number of this License, you may "
6242 #~ "choose any version ever published (not as a draft) by the Free Software "
6243 #~ "Foundation."
6244 #~ msgstr ""
6245 #~ "Jeder Version dieser Lizenz wird eine unterscheidende Versionsnummer "
6246 #~ "gegeben. Wenn das <link linkend=\"fdl-document\">Dokument</link> angibt, "
6247 #~ "dass eine spezielle Version dieser Lizenz <quote>oder eine spätere "
6248 #~ "Version</quote> darauf zutrifft, haben Sie die Wahl, den Bestimmungen und "
6249 #~ "Bedingungen von entweder der angegebenen Version oder einer beliebigen "
6250 #~ "späteren Version, die von der Free Software Foundation (nicht als "
6251 #~ "Entwurf) veröffentlicht wurde, zu folgen. Wenn das Dokument keine "
6252 #~ "Versionsnummer angibt, können Sie irgendeine, jemals von der Free "
6253 #~ "Software Foundation (nicht als Entwurf) veröffentlichte Version wählen."
6254
6255 #~ msgid ""
6256 #~ "Permission is granted to copy, distribute and/or modify this document "
6257 #~ "under the terms of the GNU Free Documentation License, Version 1.1 or any "
6258 #~ "later version published by the Free Software Foundation; with the <link "
6259 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> being LIST THEIR "
6260 #~ "TITLES, with the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</"
6261 #~ "link> being LIST, and with the <link linkend=\"fdl-cover-texts\">Back-"
6262 #~ "Cover Texts</link> being LIST. A copy of the license is included in the "
6263 #~ "section entitled <quote>GNU Free Documentation License</quote>."
6264 #~ msgstr ""
6265 #~ "Es wird die Erlaubnis gegeben, dieses Dokument zu kopieren, verteilen und/"
6266 #~ "oder zu verändern unter den Bedingungen der GNU Free Documentation "
6267 #~ "License, Version 1.1 oder einer späteren, von der Free Software "
6268 #~ "Foundation veröffentlichten Version; mit den <link linkend=\"fdl-"
6269 #~ "invariant\">Unveränderlichen Abschnitten</link>. DEREN TITEL AUFGEZÄHLT "
6270 #~ "sind, mit den <link linkend=\"fdl-cover-texts\">Vorderseitentexten</"
6271 #~ "link>, die AUFGEZÄHLT sind, und mit den <link linkend=\"fdl-cover-"
6272 #~ "texts\">Rückseitentexten</link>, die AUFGEZÄHLT sind. Eine Kopie dieser "
6273 #~ "Lizenz ist in dem Abschnitt enthalten, der mit <quote>GNU Free "
6274 #~ "Documentation License</quote> betitelt ist."
6275
6276 #~ msgid ""
6277 #~ "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
6278 #~ "write <quote>with no Invariant Sections</quote> instead of saying which "
6279 #~ "ones are invariant. If you have no <link linkend=\"fdl-cover-"
6280 #~ "texts\">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</"
6281 #~ "quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise "
6282 #~ "for <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link>."
6283 #~ msgstr ""
6284 #~ "Wenn Sie keine <link linkend=\"fdl-invariant\">Unveränderlichen "
6285 #~ "Abschnitte</link> haben, schreiben Sie <quote>mit keinen Unveränderlichen "
6286 #~ "Abschnitten</quote>, anstatt anzugeben, welche unveränderlich sind. Wenn "
6287 #~ "Sie keine <link linkend=\"fdl-cover-texts\">Vorderseitentexte</link> "
6288 #~ "haben, schreiben Sie <quote>keine Vorderseitentexte</quote> anstatt "
6289 #~ "<quote>Vorderseitentexte die AUFGEZÄHLT sind</quote>; genauso bei den "
6290 #~ "<link linkend=\"fdl-cover-texts\">Rückseitentexten</link>."
6291
6292 #~ msgid ""
6293 #~ "If your document contains nontrivial examples of program code, we "
6294 #~ "recommend releasing these examples in parallel under your choice of free "
6295 #~ "software license, such as the <ulink type=\"http\" url=\"http://www.gnu."
6296 #~ "org/copyleft/gpl.html\"> GNU General Public License</ulink>, to permit "
6297 #~ "their use in free software."
6298 #~ msgstr ""
6299 #~ "Wenn Ihr Dokument nicht-triviale Beispiele von Programmcode enthält, "
6300 #~ "empfehlen wir, diese Beispiele parallel unter einer freien Software-"
6301 #~ "Lizenz, wie der <ulink type=\"http\" url=\"http://www.gnu.org/copyleft/"
6302 #~ "gpl.html\">GNU General Public License</ulink>, zu veröffentlichen, um "
6303 #~ "ihren Gebrauch in freier Software zu erlauben."
6304
6305 #~ msgid ""
6306 #~ "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
6307 #~ "authorinitials> <revremark>development</revremark>"
6308 #~ msgstr ""
6309 #~ "<revnumber>1.29</revnumber> <date>28. August 2018</date> "
6310 #~ "<authorinitials>ss</authorinitials> <revremark>Entwicklerversion</"
6311 #~ "revremark>"