Debian Codegraph @

help/manual/sv/sv.po

raw
1 # Swedish translation of gtk-doc.
2 # Copyright © 2009-2026 Free Software Foundation, Inc.
3 # This file is distributed under the same license as the gtk-doc package.
4 # Daniel Nylander <[email protected]>, 2009.
5 # Sebastian Rasmussen <[email protected]>, 2016.
6 # Anders Jonsson <[email protected]>, 2017, 2018, 2019, 2020, 2021, 2024, 2026.
7 #
8 msgid ""
9 msgstr ""
10 "Project-Id-Version: gtk-doc master\n"
11 "POT-Creation-Date: 2026-03-10 18:31+0000\n"
12 "PO-Revision-Date: 2026-03-11 21:42+0100\n"
13 "Last-Translator: Anders Jonsson <[email protected]>\n"
14 "Language-Team: Swedish <[email protected]>\n"
15 "Language: sv\n"
16 "MIME-Version: 1.0\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "X-Generator: Poedit 3.8\n"
20
21 #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2
22 msgctxt "_"
23 msgid "translator-credits"
24 msgstr ""
25 "Sebastian Rasmussen <[email protected]>, 2016\n"
26 "Daniel Nylander <[email protected]>, 2009\n"
27 "Marcus Rejås och Alexander Nordström <[email protected]>, 2004\n"
28 "\n"
29 "Skicka kommentarer om översättningen\n"
30 "till svenska till <[email protected]>"
31
32 #. (itstool) path: bookinfo/title
33 #: C/index.docbook:12
34 msgid "GTK-Doc Manual"
35 msgstr "Handbok för GTK-Doc"
36
37 #. (itstool) path: bookinfo/edition
38 #: C/index.docbook:13
39 msgid "1.24.1"
40 msgstr "1.24.1"
41
42 #. (itstool) path: abstract/para
43 #: C/index.docbook:14
44 msgid "User manual for developers with instructions of GTK-Doc usage."
45 msgstr ""
46 "Användarhandbok för utvecklare med användningsinstruktioner för GTK-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-projektet"
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 and 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 "Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges "
107 "under villkoren i <citetitle>GNU Free Documentation License</citetitle>, "
108 "version 1.1 eller senare, utgivet av Free Software Foundation utan "
109 "standardavsnitt och omslagstexter. En kopia av licensen finns <link "
110 "linkend=\"fdl\">inkluderad</link>."
111
112 #. (itstool) path: legalnotice/para
113 #: C/index.docbook:73
114 msgid ""
115 "Many of the names used by companies to distinguish their products and "
116 "services are claimed as trademarks. Where those names appear in any GNOME "
117 "documentation, and those trademarks are made aware to the members of the "
118 "GNOME Documentation Project, the names have been printed in caps or initial "
119 "caps."
120 msgstr ""
121 "Flera namn på produkter och tjänster är registrerade varumärken. I de fall "
122 "dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-"
123 "dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med "
124 "versaler eller med inledande versal."
125
126 #. (itstool) path: revhistory/revision
127 #: C/index.docbook:83
128 msgid ""
129 "<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</"
130 "authorinitials> <revremark>gtk4 version</revremark>"
131 msgstr ""
132 "<revnumber>1.33.0</revnumber> <date>1 okt 2020</date> <authorinitials>mc</"
133 "authorinitials> <revremark>gtk4-version</revremark>"
134
135 #. (itstool) path: revhistory/revision
136 #: C/index.docbook:89
137 msgid ""
138 "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
139 "authorinitials> <revremark>dev version</revremark>"
140 msgstr ""
141 "<revnumber>1.32.1</revnumber> <date>15 aug 2019</date> <authorinitials>ss</"
142 "authorinitials> <revremark>utveckling</revremark>"
143
144 #. (itstool) path: revhistory/revision
145 #: C/index.docbook:95
146 msgid ""
147 "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</"
148 "authorinitials> <revremark>hotfix release</revremark>"
149 msgstr ""
150 "<revnumber>1.32</revnumber> <date>15 aug 2019</date> <authorinitials>ss</"
151 "authorinitials> <revremark>snabb fixutgåva</revremark>"
152
153 #. (itstool) path: revhistory/revision
154 #: C/index.docbook:101
155 msgid ""
156 "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</"
157 "authorinitials> <revremark>refactorings and more test coverage</revremark>"
158 msgstr ""
159 "<revnumber>1.31</revnumber> <date>05 aug 2019</date> <authorinitials>ss</"
160 "authorinitials> <revremark>omstrukturering och större testtäckning</"
161 "revremark>"
162
163 #. (itstool) path: revhistory/revision
164 #: C/index.docbook:107
165 msgid ""
166 "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</"
167 "authorinitials> <revremark>more test coverage</revremark>"
168 msgstr ""
169 "<revnumber>1.30</revnumber> <date>08 maj 2019</date> <authorinitials>ss</"
170 "authorinitials> <revremark>större testtäckning</revremark>"
171
172 #. (itstool) path: revhistory/revision
173 #: C/index.docbook:113
174 msgid ""
175 "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
176 "authorinitials> <revremark>bug fixes</revremark>"
177 msgstr ""
178 "<revnumber>1.29</revnumber> <date>28 aug 2018</date> <authorinitials>ss</"
179 "authorinitials> <revremark>programfixar</revremark>"
180
181 #. (itstool) path: revhistory/revision
182 #: C/index.docbook:119
183 msgid ""
184 "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</"
185 "authorinitials> <revremark>bug fixes</revremark>"
186 msgstr ""
187 "<revnumber>1.28</revnumber> <date>24 mar 2018</date> <authorinitials>ss</"
188 "authorinitials> <revremark>programfixar</revremark>"
189
190 #. (itstool) path: revhistory/revision
191 #: C/index.docbook:125
192 msgid ""
193 "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</"
194 "authorinitials> <revremark>fine tuning of the python port</revremark>"
195 msgstr ""
196 "<revnumber>1.27</revnumber> <date>07 dec 2017</date> <authorinitials>ss</"
197 "authorinitials> <revremark>finjustering av python-porteringen</revremark>"
198
199 #. (itstool) path: revhistory/revision
200 #: C/index.docbook:131
201 msgid ""
202 "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</"
203 "authorinitials> <revremark>port all tools from perl/bash to python</"
204 "revremark>"
205 msgstr ""
206 "<revnumber>1.26</revnumber> <date>11 aug 2017</date> <authorinitials>ss</"
207 "authorinitials> <revremark>portera alla verktyg från perl/bash till python</"
208 "revremark>"
209
210 #. (itstool) path: revhistory/revision
211 #: C/index.docbook:137
212 msgid ""
213 "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</"
214 "authorinitials> <revremark>bug fixes, test cleanups</revremark>"
215 msgstr ""
216 "<revnumber>1.25</revnumber> <date>21 mars 2016</date> <authorinitials>ss</"
217 "authorinitials> <revremark>programfixar, uppstädning av tester</revremark>"
218
219 #. (itstool) path: revhistory/revision
220 #: C/index.docbook:143
221 msgid ""
222 "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</"
223 "authorinitials> <revremark>bug fix</revremark>"
224 msgstr ""
225 "<revnumber>1.24</revnumber> <date>29 maj 2015</date> <authorinitials>ss</"
226 "authorinitials> <revremark>programfix</revremark>"
227
228 #. (itstool) path: revhistory/revision
229 #: C/index.docbook:149
230 msgid ""
231 "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</"
232 "authorinitials> <revremark>bug fix</revremark>"
233 msgstr ""
234 "<revnumber>1.23</revnumber> <date>17 maj 2015</date> <authorinitials>ss</"
235 "authorinitials> <revremark>programfix</revremark>"
236
237 #. (itstool) path: revhistory/revision
238 #: C/index.docbook:155
239 msgid ""
240 "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</"
241 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
242 "revremark>"
243 msgstr ""
244 "<revnumber>1.22</revnumber> <date>07 maj 2015</date> <authorinitials>ss</"
245 "authorinitials> <revremark>programfixar, borttagning av föråldrade "
246 "funktioner</revremark>"
247
248 #. (itstool) path: revhistory/revision
249 #: C/index.docbook:161
250 msgid ""
251 "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</"
252 "authorinitials> <revremark>bug fixes, dropping deprecated features</"
253 "revremark>"
254 msgstr ""
255 "<revnumber>1.21</revnumber> <date>17 jul 2014</date> <authorinitials>ss</"
256 "authorinitials> <revremark>programfixar, borttagning av föråldrade "
257 "funktioner</revremark>"
258
259 #. (itstool) path: revhistory/revision
260 #: C/index.docbook:167
261 msgid ""
262 "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</"
263 "authorinitials> <revremark>bug fixes, markdown support, style improvements</"
264 "revremark>"
265 msgstr ""
266 "<revnumber>1.20</revnumber> <date>16 feb 2014</date> <authorinitials>ss</"
267 "authorinitials> <revremark>programfixar, stöd för markdown, "
268 "stilförbättringar</revremark>"
269
270 #. (itstool) path: revhistory/revision
271 #: C/index.docbook:173
272 msgid ""
273 "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</"
274 "authorinitials> <revremark>bug fixes</revremark>"
275 msgstr ""
276 "<revnumber>1.19</revnumber> <date>05 jun 2013</date> <authorinitials>ss</"
277 "authorinitials> <revremark>programfixar</revremark>"
278
279 #. (itstool) path: revhistory/revision
280 #: C/index.docbook:179
281 msgid ""
282 "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</"
283 "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>"
284 msgstr ""
285 "<revnumber>1.18</revnumber> <date>14 sep 2011</date> <authorinitials>ss</"
286 "authorinitials> <revremark>programfixar, uppsnabbningar, stöd för markdown</"
287 "revremark>"
288
289 #. (itstool) path: revhistory/revision
290 #: C/index.docbook:185
291 msgid ""
292 "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</"
293 "authorinitials> <revremark>urgent bug fix update</revremark>"
294 msgstr ""
295 "<revnumber>1.17</revnumber> <date>26 feb 2011</date> <authorinitials>sk</"
296 "authorinitials> <revremark>brådskande programfixuppdatering</revremark>"
297
298 #. (itstool) path: revhistory/revision
299 #: C/index.docbook:191
300 msgid ""
301 "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</"
302 "authorinitials> <revremark>bugfixes, layout improvements</revremark>"
303 msgstr ""
304 "<revnumber>1.16</revnumber> <date>14 jan 2011</date> <authorinitials>sk</"
305 "authorinitials> <revremark>programfixar, layoutförbättringar</revremark>"
306
307 #. (itstool) path: revhistory/revision
308 #: C/index.docbook:197
309 msgid ""
310 "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</"
311 "authorinitials> <revremark>bug and regression fixes</revremark>"
312 msgstr ""
313 "<revnumber>1.15</revnumber> <date>21 maj 2010</date> <authorinitials>sk</"
314 "authorinitials> <revremark>program- och regressionsfixar</revremark>"
315
316 #. (itstool) path: revhistory/revision
317 #: C/index.docbook:203
318 msgid ""
319 "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</"
320 "authorinitials> <revremark>bugfixes and performance improvements</revremark>"
321 msgstr ""
322 "<revnumber>1.14</revnumber> <date>28 mars 2010</date> <authorinitials>sk</"
323 "authorinitials> <revremark>programfixar och prestandaförbättringar</"
324 "revremark>"
325
326 #. (itstool) path: revhistory/revision
327 #: C/index.docbook:209
328 msgid ""
329 "<revnumber>1.13</revnumber> <date>18 December 2009</date> "
330 "<authorinitials>sk</authorinitials> <revremark>broken tarball update</"
331 "revremark>"
332 msgstr ""
333 "<revnumber>1.13</revnumber> <date>18 december 2009</date> "
334 "<authorinitials>sk</authorinitials> <revremark>uppdatering på grund av "
335 "trasigt tar-arkiv</revremark>"
336
337 #. (itstool) path: revhistory/revision
338 #: C/index.docbook:215
339 msgid ""
340 "<revnumber>1.12</revnumber> <date>18 December 2009</date> "
341 "<authorinitials>sk</authorinitials> <revremark>new tool features and "
342 "bugfixes</revremark>"
343 msgstr ""
344 "<revnumber>1.12</revnumber> <date>18 december 2009</date> "
345 "<authorinitials>sk</authorinitials> <revremark>nya verktygsfunktioner och "
346 "programfixar</revremark>"
347
348 #. (itstool) path: revhistory/revision
349 #: C/index.docbook:221
350 msgid ""
351 "<revnumber>1.11</revnumber> <date>16 November 2008</date> "
352 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
353 "revremark>"
354 msgstr ""
355 "<revnumber>1.11</revnumber> <date>16 november 2008</date> "
356 "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</"
357 "revremark>"
358
359 #. (itstool) path: chapter/title
360 #: C/index.docbook:234
361 msgid "Introduction"
362 msgstr "Introduktion"
363
364 #. (itstool) path: chapter/para
365 #: C/index.docbook:236
366 msgid ""
367 "This chapter introduces GTK-Doc and gives an overview of what it is and how "
368 "it is used."
369 msgstr ""
370 "Detta kapitel introducerar GTK-Doc och ger en överblick över vad det är och "
371 "hur det används."
372
373 #. (itstool) path: sect1/title
374 #: C/index.docbook:242
375 msgid "What is GTK-Doc?"
376 msgstr "Vad är GTK-Doc?"
377
378 #. (itstool) path: sect1/para
379 #: C/index.docbook:244
380 msgid ""
381 "GTK-Doc is used to document C code. It is typically used to document the "
382 "public API of libraries, such as GLib-based libraries, but it can also be "
383 "used to document application code."
384 msgstr ""
385 "GTK-Doc används för att dokumentera C-kod. Det används vanligen för att "
386 "dokumentera det publika API:t för bibliotek, såsom GLib-baserade bibliotek, "
387 "men det kan också användas för att dokumentera programkod."
388
389 #. (itstool) path: sect1/title
390 #: C/index.docbook:252
391 msgid "How Does GTK-Doc Work?"
392 msgstr "Hur fungerar GTK-Doc?"
393
394 # sebras: how do I translate header files?
395 #. (itstool) path: sect1/para
396 #: C/index.docbook:254
397 msgid ""
398 "GTK-Doc works by reading specially-formatted comment blocks placed inside "
399 "the source files to document symbols such as functions, macros, structs, "
400 "enums, etc. (though note that for most kind of symbols GTK-Doc will only "
401 "document the symbols that are declared in header files; for example it won't "
402 "produce output for static functions)."
403 msgstr ""
404 "GTK-Doc fungerar genom att läsa speciellt formaterade kommentarsblock "
405 "placerade inuti källkodsfilerna för att dokumentera symboler som funktioner, "
406 "makron, struturer, uppräkningar o.s.v. (notera dock att GTK-Doc endast "
407 "kommer att dokumentera symboler som deklarerats i huvudfiler; det kommer "
408 "inte att producera utdata för statiska funktioner)."
409
410 #. (itstool) path: sect1/para
411 #: C/index.docbook:262
412 msgid ""
413 "GTK-Doc also reads template files where documentation can be added there as "
414 "well."
415 msgstr "GTK-Doc läser även mallfiler där dokumentation också kan läggas till."
416
417 #. (itstool) path: sect1/para
418 #: C/index.docbook:267
419 msgid ""
420 "GTK-Doc consists of a number of programs, each performing a different step "
421 "in the process."
422 msgstr ""
423 "GTK-Doc består av ett antal program som vart och ett utför olika steg i "
424 "processen."
425
426 #. (itstool) path: sect1/para
427 #: C/index.docbook:272
428 msgid "The main steps are:"
429 msgstr "Huvudstegen är:"
430
431 #. (itstool) path: listitem/para
432 #: C/index.docbook:279
433 msgid ""
434 "<guilabel>Writing the documentation.</guilabel> The author fills in the "
435 "source files with the documentation for each function, macro, structs or "
436 "unions, etc."
437 msgstr ""
438 "<guilabel>Skriva dokumentationen.</guilabel> Författaren fyller i "
439 "källkodsfilerna med dokumentation för varje funktion, makro, struct eller "
440 "union, o.s.v."
441
442 # sebras: more header files...
443 #. (itstool) path: listitem/para
444 #: C/index.docbook:288
445 msgid ""
446 "<guilabel>Gathering information about the code.</guilabel> "
447 "<application>gtkdoc-scan</application> scans the header files of the code "
448 "looking for declarations of functions, macros, enums, structs, and unions. "
449 "It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> "
450 "containing a list of the declarations, placing them into sections according "
451 "to which header file they are in. On the first run this file is copied to "
452 "<filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange "
453 "the sections, and the order of the declarations within them, to produce the "
454 "final desired order. The second file it generates is "
455 "<filename>&lt;module&gt;-decl.txt</filename>. This file contains the full "
456 "declarations found by the scanner. If for some reason one would like some "
457 "symbols to show up in the docs, where the full declaration cannot be found "
458 "by the scanner or the declaration should appear differently, one can place "
459 "entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> "
460 "into <filename>&lt;module&gt;-overrides.txt</filename>."
461 msgstr ""
462 "<guilabel>Samla ihop information om koden.</guilabel> <application>gtkdoc-"
463 "scan</application> söker genom huvudfilerna för koden och letar efter "
464 "deklarationer av funktioner, makron, uppräkningar, strukturer och unioner. "
465 "Det skapar sedan filen <filename>&lt;module&gt;-decl-list.txt</filename> som "
466 "innehåller en lista över deklarationerna, och placerar dem i avsnitt efter "
467 "vilken huvudfil de finns i. Vid första körningen kommer denna fil att "
468 "kopieras till <filename>&lt;module&gt;-sections.txt</filename>. Författaren "
469 "kan, genom att omarrangera avsnitten och ändra ordningen för deklarationerna "
470 "inom dem, framställa den önskade, slutgiltiga ordningen. Den andra filen det "
471 "genererar är <filename>&lt;module&gt;-decl.txt</filename>. Denna fil "
472 "innehåller de fullständiga deklarationerna som hittats av detektorn. Om man "
473 "av något skäl vill att vissa symboler ska visas i dokumentation då den "
474 "fullständiga deklarationen inte kan hittas av detektorn, eller om "
475 "deklarationen ska visas annorlunda, kan man placera rader liknande de som "
476 "finns i <filename>&lt;module&gt;-decl.txt</filename> i "
477 "<filename>&lt;module&gt;-overrides.txt</filename>."
478
479 #. (itstool) path: listitem/para
480 #: C/index.docbook:308
481 msgid ""
482 "<application>gtkdoc-scangobj</application> can also be used to dynamically "
483 "query a library about any GObject subclasses it exports. It saves "
484 "information about each object's position in the class hierarchy and about "
485 "any GObject properties and signals it provides."
486 msgstr ""
487 "<application>gtkdoc-scangobj</application> kan också användas för att "
488 "dynamiskt fråga ett bibliotek om vilka GObject-underklasser det exporterar. "
489 "Det sparar information om varje objekts position i klasshierarkin och om "
490 "vilka GObject-egenskaper och signaler det tillhandahåller."
491
492 #. (itstool) path: listitem/para
493 #: C/index.docbook:314
494 msgid ""
495 "<application>gtkdoc-scanobj</application> should not be used anymore. It was "
496 "needed in the past when GObject was still GtkObject inside GTK."
497 msgstr ""
498 "<application>gtkdoc-scanobj</application> bör inte användas längre. Det "
499 "behövdes tidigare när GObject fortfarande var GtkObject inuti GTK."
500
501 #. (itstool) path: listitem/para
502 #: C/index.docbook:322
503 msgid ""
504 "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-"
505 "mkdb</application> turns the template files into XML files in the <filename "
506 "class=\"directory\">xml/</filename> subdirectory. If the source code "
507 "contains documentation for symbols, using the special comment blocks, it "
508 "gets merged in here. If there are no tmpl files used it only reads docs from "
509 "sources and introspection data."
510 msgstr ""
511 "<guilabel>Generera XML och HTML/PDF.</guilabel> <application>gtkdoc-mkdb</"
512 "application> förvandlar mallfilerna till XML-filer i underkatalogen "
513 "<filename class=\"directory\">xml/</filename>. Om källkoden innehåller "
514 "dokumentation för symboler i speciella kommentarsblock, så kommer denna att "
515 "sammanfogas här. Om det inte finns några tmpl-filer som används så kommer "
516 "det endast att läsa dokumentation från källkoden och introspektionsdata."
517
518 #. (itstool) path: listitem/para
519 #: C/index.docbook:332
520 msgid ""
521 "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files "
522 "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise "
523 "<application>gtkdoc-mkpdf</application> turns the XML files into a PDF "
524 "document called <filename>&lt;package&gt;.pdf</filename>."
525 msgstr ""
526 "<application>gtkdoc-mkhtml</application> förvandlar XML-filer till HTML-"
527 "filer i underkatalogen <filename class=\"directory\">html/</filename>. På "
528 "samma sätt förvandlar <application>gtkdoc-mkpdf</application> XML-filerna "
529 "till ett PDF-dokument kallat <filename>&lt;package&gt;.pdf</filename>."
530
531 #. (itstool) path: listitem/para
532 #: C/index.docbook:339
533 msgid ""
534 "Files in <filename class=\"directory\">xml/</filename> and <filename "
535 "class=\"directory\">html/</filename> directories are always overwritten. One "
536 "should never edit them directly."
537 msgstr ""
538 "Filer i <filename class=\"directory\">xml/</filename>- och <filename "
539 "class=\"directory\">html/</filename>-katalogerna skrivs alltid över. Man bör "
540 "aldrig redigera dem direkt."
541
542 #. (itstool) path: listitem/para
543 #: C/index.docbook:347
544 msgid ""
545 "<guilabel>Fixing up cross-references between documents.</guilabel> After "
546 "installing the HTML files, <application>gtkdoc-fixxref</application> can be "
547 "run to fix up any cross-references between separate documents. For example, "
548 "the GTK documentation contains many cross-references to types documented in "
549 "the GLib manual."
550 msgstr ""
551 "<guilabel>Fixa korsreferenser mellan dokument.</guilabel> Efter att ha "
552 "installerat HTML-filerna kan <application>gtkdoc-fixxref</application> köras "
553 "för att fixa korsreferenser mellan separata dokument. Till exempel GTK-"
554 "dokumentationen innehåller många korsreferenser till typer som dokumenterats "
555 "i GLib-manualen."
556
557 #. (itstool) path: listitem/para
558 #: C/index.docbook:356
559 msgid ""
560 "When creating the source tarball for distribution, <application>gtkdoc-"
561 "rebase</application> turns all external links into web-links. When "
562 "installing distributed (pregenerated) docs the same application will try to "
563 "turn links back to local links (where those docs are installed)."
564 msgstr ""
565 "När tar-arkivet med källkod skapas för distribution, förvandlar "
566 "<application>gtkdoc-rebase</application> alla externa länkar till "
567 "webblänkar. När (förgenererad) distribuerad dokumentation installeras kommer "
568 "samma program att försöka att förvandla länkarna tillbaka till lokala länkar "
569 "(där dokumentationen finns installerad)."
570
571 #. (itstool) path: sect1/title
572 #: C/index.docbook:369
573 msgid "Getting GTK-Doc"
574 msgstr "Hämta GTK-Doc"
575
576 #. (itstool) path: sect2/title
577 #: C/index.docbook:372
578 msgid "Requirements"
579 msgstr "Krav"
580
581 #. (itstool) path: sect2/para
582 #: C/index.docbook:373
583 msgid ""
584 "<guilabel>python 2/3</guilabel> - the main scripts are written in python."
585 msgstr "<guilabel>python 2/3</guilabel> - huvudskripten är skrivna i python."
586
587 #. (itstool) path: sect2/para
588 #: C/index.docbook:376
589 msgid ""
590 "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink "
591 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
592 msgstr ""
593 "<guilabel>xsltproc</guilabel> - xslt-processorn från libxslt <ulink "
594 "url=\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>"
595
596 #. (itstool) path: sect2/para
597 #: C/index.docbook:380
598 msgid ""
599 "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink "
600 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
601 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
602 msgstr ""
603 "<guilabel>docbook-xsl</guilabel> - docbook xsl-stilmallar <ulink "
604 "url=\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" "
605 "type=\"http\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>"
606
607 # sebras: remind me how was highlighting translated..?
608 #. (itstool) path: sect2/para
609 #: C/index.docbook:384
610 msgid ""
611 "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> "
612 "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of "
613 "examples"
614 msgstr ""
615 "Endera av <guilabel>source-highlight</guilabel>, <guilabel>highlight</"
616 "guilabel> eller <guilabel>vim</guilabel> - valfritt - används för "
617 "syntaxfärgning av exempel"
618
619 #. (itstool) path: sect1/title
620 #: C/index.docbook:392
621 msgid "About GTK-Doc"
622 msgstr "Om GTK-Doc"
623
624 # TODO: https://gitlab.gnome.org/GNOME/gtk-doc/issues/52
625 # +sources code
626 #. (itstool) path: sect1/para
627 #: C/index.docbook:394
628 msgid ""
629 "Historically GTK-Doc was used to generate template files from the sources "
630 "code. These template files could be used by developers to enter the API "
631 "documentation. This approach was rather inconvenient because it required to "
632 "keep the generated files under version control. Since GTK-Doc 1.9 it became "
633 "possible to place all API information into source comments, which made the "
634 "template support obsolete. In version 1.26 template support has been removed."
635 msgstr ""
636 "Historiskt användes GTK-Doc för att generera mallfiler från källkoden. Dessa "
637 "mallfiler kunde användas av utvecklare för att ange API-dokumentationen. "
638 "Detta tillvägagångssätt var ganska obekvämt då det krävde att genererade "
639 "filer hölls under versionshantering. Sedan GTK-Doc 1.9 är det möjligt att "
640 "placera all API-information i källkodskommentarer, vilket gör mallstödet "
641 "föråldrat. I version 1.26 har mallstödet tagits bort."
642
643 #. (itstool) path: sect1/para
644 #: C/index.docbook:404 C/index.docbook:418
645 msgid "(FIXME)"
646 msgstr "(FIXME)"
647
648 #. (itstool) path: sect1/para
649 #: C/index.docbook:408
650 msgid ""
651 "(authors, web pages, mailing list, license, future plans, comparison with "
652 "other similar systems.)"
653 msgstr ""
654 "(författare, webbsidor, sändlistor, licens, framtida planer, jämförelse med "
655 "andra liknande system.)"
656
657 #. (itstool) path: sect1/title
658 #: C/index.docbook:416
659 msgid "About this Manual"
660 msgstr "Om denna handbok"
661
662 #. (itstool) path: sect1/para
663 #: C/index.docbook:422
664 msgid "(who it is meant for, where you can get it, license)"
665 msgstr "(vem är den avsett för, var kan du få tag i den, licens)"
666
667 #. (itstool) path: chapter/title
668 #: C/index.docbook:431
669 msgid "Project Setup"
670 msgstr "Projektkonfiguration"
671
672 #. (itstool) path: chapter/para
673 #: C/index.docbook:433
674 msgid ""
675 "This Chapter describes the steps that are necessary to integrate GTK-Doc "
676 "into your project. The integration of GTK-Doc into a project includes the "
677 "following steps:"
678 msgstr ""
679 "Detta kapitel beskriver stegen som är nödvändiga för att integrera GTK-Doc i "
680 "ditt projekt. Integreringen av GTK-Doc till ett projekt inkluderar följande "
681 "steg:"
682
683 #. (itstool) path: listitem/para
684 #: C/index.docbook:441
685 msgid ""
686 "Preparation of the directory structure and creating required configuration "
687 "files for your GTK-Doc documentation (see <link "
688 "linkend=\"settingup_docfiles\"> Setting up a skeleton documentation</link>)."
689 msgstr ""
690 "Förberedelse av katalogstrukturen och skapande av konfigurationsfiler som "
691 "krävs för din GTK-Doc-dokumentation (se <link "
692 "linkend=\"settingup_docfiles\"> Att ställa in en skelettstruktur för "
693 "dokumentation</link>)."
694
695 #. (itstool) path: listitem/para
696 #: C/index.docbook:449
697 msgid ""
698 "Adjusting the build system to build your documentation using the GTK-Doc "
699 "tools. Multiple build systems are supported, in this manual we describe how "
700 "to integrate GTK-Doc with <link linkend=\"settingup_autotools\">Autotools</"
701 "link>, <link linkend=\"settingup_cmake\">CMake</link>, and <link "
702 "linkend=\"settingup_plain_makefiles\">plain Makefiles</link>."
703 msgstr ""
704 "Justering av byggsystemet för att bygga din dokumentation med GTK-Doc-"
705 "verktygen. Flera byggsystem stöds, i denna handbok beskriver vi hur GTK-Doc "
706 "kan integreras med <link linkend=\"settingup_autotools\">Autotools</link>, "
707 "<link linkend=\"settingup_cmake\">CMake</link> och <link "
708 "linkend=\"settingup_plain_makefiles\">vanliga Makefiler</link>."
709
710 #. (itstool) path: listitem/para
711 #: C/index.docbook:459
712 msgid ""
713 "Adding GTK-Doc specific files to version control and deciding which files to "
714 "ignore (see <link linkend=\"settingup_vcs\"> Integration with version "
715 "control systems</link>)."
716 msgstr ""
717 "Tillägg av GTK-Doc-specifika filer till versionshantering och att bestämma "
718 "vilka filer som ska ignoreras (se <link linkend=\"settingup_vcs\"> "
719 "Integrering med versionshanteringssystem</link>)."
720
721 #. (itstool) path: chapter/para
722 #: C/index.docbook:467
723 msgid ""
724 "The following sections assume we work on a project called <code>meep</code>. "
725 "This project contains two packages (or modules), a library called "
726 "<code>libmeep</code> and an end-user app called <code>meeper</code>."
727 msgstr ""
728 "De följande avsnitten utgår från att vi arbetar på ett projekt som kallas "
729 "<code>meep</code>. Detta projekt innehåller två paket (eller moduler), ett "
730 "bibliotek som kallas <code>libmeep</code> och ett program för slutanvändare "
731 "som kallas <code>meeper</code>."
732
733 #. (itstool) path: sect1/title
734 #: C/index.docbook:476
735 msgid "Setting up a skeleton documentation"
736 msgstr "Att ställa in en skelettstruktur för dokumentation"
737
738 # https://gitlab.gnome.org/GNOME/gtk-doc/issues/52
739 #. (itstool) path: sect1/para
740 #: C/index.docbook:478
741 msgid ""
742 "A common convention is to place documentation into a folder called "
743 "<code>docs</code> inside your top-level project directory. We usually "
744 "distinguish between <emphasis>reference documentation</emphasis> intended "
745 "for developers and an <emphasis>user manual</emphasis> intended for end-"
746 "users. Again the convention is to have separate folders for both. We usually "
747 "place the reference documentation in a folder named <code>reference</code> "
748 "and the end-user manual in a folder named <code>help</code> as. According to "
749 "the above convention the documentation for our <code>libmeep</code> package "
750 "would be placed into: <code>docs/reference/libmeep</code>. For packages with "
751 "just one library or application the documentation could also be placed "
752 "directly into <code>docs/reference</code>. It is not mandatory to use the "
753 "above convention, but if you choose to use a different directory structure "
754 "you must adjust your build system configuration to match your directory "
755 "structure."
756 msgstr ""
757 "En vanlig konvention är att placera dokumentation i en mapp kallad "
758 "<code>docs</code> i toppnivåkatalogen för ditt projekt. Vi skiljer vanligen "
759 "mellan <emphasis>referensdokumentation</emphasis> som är avsedd för "
760 "utvecklare och en <emphasis>användarhandbok</emphasis> som är avsedd för "
761 "slutanvändare. Konventionen är återigen att ha olika mappar för båda. Vi "
762 "placerar vanligen referensdokumentationen i en mapp med namnet "
763 "<code>reference</code> handboken för slutanvändare i en mapp med namnet "
764 "<code>help</code>. Enligt konventionen ovan skulle dokumentationen för vårt "
765 "paket <code>libmeep</code> placeras i: <code>docs/reference/libmeep</code>. "
766 "För paket med bara ett bibliotek eller program kan dokumentationen också "
767 "placeras direkt i <code>docs/reference</code>. Det är inte obligatoriskt att "
768 "använda konventionen ovan, men om du väljer att använda en annan "
769 "katalogstruktur måste du anpassa din konfiguration för byggsystemet så att "
770 "den matchar din katalogstruktur."
771
772 #. (itstool) path: example/title
773 #: C/index.docbook:509
774 msgid "Example directory structure of <emphasis>meep</emphasis> project"
775 msgstr "Exempel på katalogstruktur för projektet <emphasis>meep</emphasis>"
776
777 #. (itstool) path: example/programlisting
778 #: C/index.docbook:511
779 #, no-wrap
780 msgid ""
781 "\n"
782 "meep/\n"
783 " docs/\n"
784 " reference/ # reference documentation\n"
785 " libmeep/\n"
786 " meeper/\n"
787 " help/ # optional: user manual\n"
788 " meeper/\n"
789 " src/\n"
790 " libmeep/\n"
791 " meeper/\n"
792 msgstr ""
793 "\n"
794 "meep/\n"
795 " docs/\n"
796 " reference/ # referensdokumentation\n"
797 " libmeep/\n"
798 " meeper/\n"
799 " help/ # valfritt: användarhandbok\n"
800 " meeper/\n"
801 " src/\n"
802 " libmeep/\n"
803 " meeper/\n"
804
805 #. (itstool) path: sect1/para
806 #: C/index.docbook:503
807 msgid ""
808 "In the following sections we will assume a directory structure for our "
809 "<emphasis>meep</emphasis> project that uses the above conventions. "
810 "<_:example-1/>"
811 msgstr ""
812 "I avsnitten som följer kommer vi anta en katalogstruktur för vårt projekt "
813 "<emphasis>meep</emphasis> som följer konventionerna ovan. <_:example-1/>"
814
815 #. (itstool) path: sect1/title
816 #: C/index.docbook:528
817 msgid "Integration with Autotools"
818 msgstr "Integrering med Autotools"
819
820 #. (itstool) path: sect1/para
821 #: C/index.docbook:529
822 msgid ""
823 "Integration of GTK-Doc into an autotools-based build system requires the "
824 "following steps:"
825 msgstr ""
826 "Integrering av GTK-Doc i ett autotools-baserat byggsystem kräver följande "
827 "steg:"
828
829 #. (itstool) path: listitem/para
830 #: C/index.docbook:535
831 msgid ""
832 "Ensure that <application>gtkdocize</application> is run once before the "
833 "<filename>configure</filename> script. If an <filename>autogen.sh</filename> "
834 "script is present, adjust it to check for GTK-Doc and add a call to "
835 "<application>gtkdocize</application>."
836 msgstr ""
837 "Säkerställ att <application>gtkdocize</application> körs en gång innan "
838 "skriptet <filename>configure</filename>. Om skriptet <filename>autogen.sh</"
839 "filename> finns tillgängligt, justera det så att det söker efter GTK-Doc och "
840 "lägg till ett anrop till <application>gtkdocize</application>."
841
842 #. (itstool) path: listitem/para
843 #: C/index.docbook:543
844 msgid ""
845 "The main purpose of <application>gtkdocize</application> is to make the "
846 "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</"
847 "filename> macro definition file available to the build system, either by "
848 "copying or linking it into the project."
849 msgstr ""
850 "Huvudsyftet med <application>gtkdocize</application> är att göra Makefilen "
851 "<filename>gtk-doc.make</filename> och makrodefinitionsfilen <filename>gtk-"
852 "doc.m4</filename> tillgängliga för byggsystemet, antingen genom att kopiera "
853 "eller länka in dem i projektet."
854
855 #. (itstool) path: listitem/para
856 #: C/index.docbook:552
857 msgid ""
858 "Add the necessary <application>autoconf</application> macros to "
859 "<filename>configure.ac</filename> to enable GTK-Doc in your build system to "
860 "allow configuration of GTK-Doc via the generated <filename>configure</"
861 "filename> script."
862 msgstr ""
863 "Lägg till de nödvändiga <application>autoconf</application>-makrona till "
864 "<filename>configure.ac</filename> för att aktivera GTK-Doc i ditt byggsystem "
865 "för att tillåta konfiguration av GTK-Doc via det genererade "
866 "<filename>configure</filename>-skriptet."
867
868 # TODO: What? Can't parse this one.
869 #. (itstool) path: listitem/para
870 #: C/index.docbook:558
871 msgid ""
872 "Among others with registers the <code>--enable-gtk-doc</code> option with "
873 "the <filename>configure</filename> script."
874 msgstr ""
875 "Bland andra med register flaggan <code>--enable-gtk-doc</code> med "
876 "<filename>configure</filename>-skriptet."
877
878 #. (itstool) path: listitem/para
879 #: C/index.docbook:564
880 msgid ""
881 "Create an <application>automake</application> script for each application or "
882 "library in your project. In the example used in this documentation this step "
883 "applies to both <code>meeper</code> and <code>libmeep</code>."
884 msgstr ""
885 "Skapa ett <application>automake</application>-skript för varje program eller "
886 "bibliotek i ditt projekt. I exemplet som används i denna dokumentation "
887 "tillämpas detta steg för både <code>meeper</code> och <code>libmeep</code>."
888
889 # TODO: how *TO* enable
890 #. (itstool) path: sect1/para
891 #: C/index.docbook:573
892 msgid ""
893 "In the following sections, we will perform the above steps in reverse order. "
894 "We start with the <application>automake</application> scripts and work our "
895 "way up to <filename>configure.ac</filename> and <filename>autogen.sh</"
896 "filename>. Then we show how enable Gtk-Doc in the build system and how to "
897 "build the documentation."
898 msgstr ""
899 "I de följande avsnitten utför vi stegen ovan i omvänd ordning. Vi börjar med "
900 "<application>automake</application>-skripten och arbetar vår väg upp till "
901 "<filename>configure.ac</filename> och <filename>autogen.sh</filename>. Sedan "
902 "visar vi hur Gtk-Doc aktiveras i byggsystemet och hur dokumentationen byggs."
903
904 #. (itstool) path: sect2/title
905 #: C/index.docbook:583
906 msgid "Integration with automake"
907 msgstr "Integrering med automake"
908
909 #. (itstool) path: sect2/para
910 #: C/index.docbook:585
911 msgid ""
912 "First copy the <filename>Makefile.am</filename> from the <filename "
913 "class=\"directory\">examples</filename> sub-directory of the <ulink "
914 "url=\"https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/"
915 "Makefile.am\"> gtkdoc-sources</ulink> to your project's reference "
916 "documentation directory (e.g. <filename class=\"directory\">docs/reference/"
917 "&lt;package&gt;</filename>). A local copy should be available under e.g. "
918 "<filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If "
919 "you have multiple packages repeat this for each one."
920 msgstr ""
921 "Kopiera först <filename>Makefile.am</filename> från underkatalogen <filename "
922 "class=\"directory\">examples</filename> från <ulink url=\"https://"
923 "gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am\">gtkdoc-"
924 "sources</ulink> till ditt projekts referensdokumentationskatalog (t.ex. "
925 "<filename class=\"directory\">docs/reference/&lt;paket&gt;</filename>). En "
926 "lokal kopia bör finnas tillgänglig under t.ex. <filename>/usr/share/doc/gtk-"
927 "doc-tools/examples/Makefile.am</filename>. Om du har flera paket, repetera "
928 "detta för vart och ett."
929
930 #. (itstool) path: note/simpara
931 #: C/index.docbook:598
932 msgid ""
933 "Do not forget to add each <filename>Makefile.am</filename> to the "
934 "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</"
935 "filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you "
936 "will need to add the entry <filename>docs/reference/libmeep/Makefile</"
937 "filename> to <function>AC_CONFIG_FILES</function>."
938 msgstr ""
939 "Glöm inte att lägga till varje <filename>Makefile.am</filename> till makrot "
940 "<function>AC_CONFIG_FILES</function> i <filename>configure.ac</filename>. "
941 "För <filename>docs/reference/libmeep/Makefile.am</filename> kommer du behöva "
942 "lägga till posten <filename>docs/reference/libmeep/Makefile</filename> till "
943 "<function>AC_CONFIG_FILES</function>."
944
945 #. (itstool) path: example/title
946 #: C/index.docbook:610
947 msgid "Example directory structure with <filename>Makefiles.am</filename>"
948 msgstr "Exempelkatalogstruktur med <filename>Makefiles.am</filename>"
949
950 #. (itstool) path: example/programlisting
951 #: C/index.docbook:613
952 #, no-wrap
953 msgid ""
954 "\n"
955 "meep/\n"
956 " docs/\n"
957 " reference/ # reference documentation\n"
958 " libmeep/\n"
959 " Makefile.am\n"
960 " meeper/\n"
961 " Makefile.am\n"
962 " help/ # optional: user manual\n"
963 " meeper/\n"
964 " src/\n"
965 " libmeep/\n"
966 " meeper/\n"
967 msgstr ""
968 "\n"
969 "meep/\n"
970 " docs/\n"
971 " reference/ # referensdokumentation\n"
972 " libmeep/\n"
973 " Makefile.am\n"
974 " meeper/\n"
975 " Makefile.am\n"
976 " help/ # valfritt: användarhandbok\n"
977 " meeper/\n"
978 " src/\n"
979 " libmeep/\n"
980 " meeper/\n"
981
982 #. (itstool) path: sect2/para
983 #: C/index.docbook:629
984 msgid ""
985 "Next, you need to customize the copied Makefiles and provide values for the "
986 "various parameters in each <filename>Makefile.am</filename>. All settings "
987 "have a comment above them that describes their purpose and how to customize "
988 "the setting. Most settings are used to supply extra flags to the respective "
989 "tools to which they apply. Every tool has a variable of the form "
990 "<option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-"
991 "mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All "
992 "the tools support <option>--help</option> to list the supported options."
993 msgstr ""
994 "Härnäst behöver du anpassa de kopierade Makefilerna och tillhandahålla "
995 "värden för de olika parametrarna i varje <filename>Makefile.am</filename>. "
996 "Alla inställningarna har en kommentar ovanför som beskriver deras syfte och "
997 "hur inställningen kan anpassas. De flesta inställningarna används för att "
998 "tillhandahålla extraflaggor till respektive verktyg för vilket de är "
999 "aktuella. Varje verktyg har en variabel på formen "
1000 "<option>&lt;VERKTYGSNAMN&gt;_OPTIONS</option> (t.ex. har verktyget "
1001 "<application>gtkdoc-mkhtml</application> en flagga med namnet "
1002 "<code>MKHTML_OPTIONS</code>). Alla verktygen har stöd för <option>--help</"
1003 "option> för att lista de flaggor som stöds."
1004
1005 #. (itstool) path: listitem/para
1006 #: C/index.docbook:653
1007 msgid ""
1008 "<option>DOC_MODULE</option> is used to provide the name of the package that "
1009 "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)."
1010 msgstr ""
1011 "<option>DOC_MODULE</option> används för att tillhandahålla namnet på paketet "
1012 "som dokumenteras (t.ex. <code>meeper</code> eller <code>libmeep</code>)."
1013
1014 #. (itstool) path: listitem/para
1015 #: C/index.docbook:660
1016 msgid ""
1017 "<option>DOC_SOURCE_DIR</option> is used to specify the location of source "
1018 "directory which GTK-Doc searches for your API documentation. This will "
1019 "usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-"
1020 "directory of that directory."
1021 msgstr ""
1022 "<option>DOC_SOURCE_DIR</option> används för att ange platsen för "
1023 "källkatalogen där GTK-Doc söker efter din API-dokumentation. Detta kommer "
1024 "vanligen vara <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> eller en "
1025 "underkatalog till den katalogen."
1026
1027 #. (itstool) path: listitem/para
1028 #: C/index.docbook:673
1029 msgid ""
1030 "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for "
1031 "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$"
1032 "(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of "
1033 "the matched files change."
1034 msgstr ""
1035 "<option>HFILE_GLOB</option> och <option>CFILE_GLOB</option> används för "
1036 "beroenden. Varje flagga tar en file-glob (t.ex. <code>HFILE_GLOB=$"
1037 "(top_srcdir)/src/*.c</code>). Dokumentationen kommer att byggas om ifall "
1038 "någon av de matchande filerna ändras."
1039
1040 # TODO: (top_srcdir)
1041 #. (itstool) path: listitem/para
1042 #: C/index.docbook:685
1043 msgid ""
1044 "<option>EXTRA_HFILES</option> allows to specify extra header files to "
1045 "include when scanning for API documentation, which are not found under "
1046 "<code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1047 "extra.h</code>)."
1048 msgstr ""
1049 "<option>EXTRA_HFILES</option> låter dig ange extra huvudfiler som ska "
1050 "inkluderas då API-dokumentation eftersöks, vilka inte hittas under "
1051 "<code>DOC_SOURCE_DIR</code> (t.ex. <code> EXTRA_HFILES=$(top_srcdir}/contrib/"
1052 "extra.h</code>)."
1053
1054 #. (itstool) path: listitem/para
1055 #: C/index.docbook:695
1056 msgid ""
1057 "<option>IGNORE_HFILES</option> allows to specify header files or directories "
1058 "to ignore when scanning for API documentation. Use the basename of the file "
1059 "or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1060 "private_code_folder</code>)."
1061 msgstr ""
1062 "<option>IGNORE_HFILES</option> låter dig ange huvudfiler eller kataloger som "
1063 "ska ignoreras då API-dokumentation eftersöks. Använd basnamnet på filen "
1064 "eller katalogen (t.ex. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h "
1065 "private_code_folder</code>)."
1066
1067 # TODO: *image files*
1068 #. (itstool) path: listitem/para
1069 #: C/index.docbook:705
1070 msgid ""
1071 "<option>HTML_IMAGES</option> allows to specify images files which will be "
1072 "copied into the <filename>html/</filename> directory of the generated "
1073 "documentation. If your API documentation includes any images they need to be "
1074 "added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/"
1075 "stock_about_24.png</code>)."
1076 msgstr ""
1077 "<option>HTML_IMAGES</option> låter dig ange bildfiler som kommer att "
1078 "kopieras till katalogen <filename>html/</filename> av den genererade "
1079 "dokumentationen. Om din API-dokumentation inkluderar några bilder behöver de "
1080 "läggas till i denna flagga (t.ex. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-"
1081 "icons/stock_about_24.png</code>)."
1082
1083 #. (itstool) path: listitem/para
1084 #: C/index.docbook:718
1085 msgid ""
1086 "<option>content_files</option> allows to specify extra files that are "
1087 "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> "
1088 "content_files=running.xml building.xml changes-2.0.xml</code>)."
1089 msgstr ""
1090 "<option>content_files</option> låter dig ange extrafiler som inkluderas av "
1091 "<code>$(DOC_MAIN_SGML_FILE)</code> (t.ex. <code> content_files=running.xml "
1092 "building.xml changes-2.0.xml</code>)."
1093
1094 #. (itstool) path: listitem/para
1095 #: C/index.docbook:729
1096 msgid ""
1097 "<option>expand_content_files</option> allows to specify files where "
1098 "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> "
1099 "are expanded (e.g. <code> expand_content_files=running.xml</code>)."
1100 msgstr ""
1101 "<option>expand_content_files</option> låter dig ange filer där <emphasis>gtk-"
1102 "doc-förkortningar</emphasis> så som <code>#GtkWidget</code> expanderas "
1103 "(t.ex. <code> expand_content_files=running.xml</code>)."
1104
1105 #. (itstool) path: sect2/para
1106 #: C/index.docbook:647
1107 msgid ""
1108 "The following list explains the most relevant options. Check the example "
1109 "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>"
1110 msgstr ""
1111 "Följande lista förklarar de mest relevanta flaggorna. Se "
1112 "<filename>Makefile.am</filename>-exemplet för ytterligare flaggor. "
1113 "<_:itemizedlist-1/>"
1114
1115 #. (itstool) path: sect2/title
1116 #: C/index.docbook:744
1117 msgid "Integration with autoconf"
1118 msgstr "Integrering med autoconf"
1119
1120 #. (itstool) path: sect2/para
1121 #: C/index.docbook:746
1122 msgid ""
1123 "Integration with <application>autoconf</application> is very simple and "
1124 "includes one required step and an additional optional (but recommended) "
1125 "step. The first step is to add the <function>GTK_DOC_CHECK</function> macro "
1126 "to your <filename>configure.ac</filename> script. This registers several "
1127 "configure options to enable GTK-Doc and allows you to set default arguments "
1128 "for <application>gtkdocize</application>."
1129 msgstr ""
1130 "Integrering med <application>autoconf</application> är väldigt enkel och "
1131 "inkluderar ett obligatoriskt steg och ett ytterligare valfritt (men "
1132 "rekommenderat) steg. Det första steget är att lägga till "
1133 "<function>GTK_DOC_CHECK</function>-makrot till ditt <filename>configure.ac</"
1134 "filename>-skript. Detta registrerar flera konfigurationsflaggor för att "
1135 "aktivera GTK-Doc och låter dig ställa in standardargument för "
1136 "<application>gtkdocize</application>."
1137
1138 #. (itstool) path: warning/simpara
1139 #: C/index.docbook:758
1140 msgid ""
1141 "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The "
1142 "macro must start at the beginning of the line and should not start with "
1143 "whitespace."
1144 msgstr ""
1145 "Säkerställ att makrot <code>GTK_DOC_CHECK</code> inte är indenterat. Makrot "
1146 "måste inledas på början av raden och får inte börja med blanktecken."
1147
1148 #. (itstool) path: sect2/para
1149 #: C/index.docbook:765
1150 msgid ""
1151 "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your "
1152 "<filename>configure.ac</filename>. This is not required but helps "
1153 "<application>gtkdocize</application> to automatically copy the macro "
1154 "definition (e.g <filename>gtk-doc.m4</filename>) which contains the "
1155 "<function>GTK_DOC_CHECK</function> macro to your project's macro directory. "
1156 "Without this, the GTK_DOC_CHECK macro might not be found and you would need "
1157 "to explicitly tell the <application>aclocal</application> tool where to find "
1158 "the macro definition file."
1159 msgstr ""
1160 "Det andra steget är att lägga till <code>AC_CONFIG_MACRO_DIR(m4)</code> till "
1161 "din <filename>configure.ac</filename>. Detta krävs inte men hjälper "
1162 "<application>gtkdocize</application> att automatiskt kopiera "
1163 "makrodefinitionen (t.ex. <filename>gtk-doc.m4</filename>) som innehåller "
1164 "<function>GTK_DOC_CHECK</function>-makrot till ditt projekts makrokatalog. "
1165 "Utan detta kanske GTK_DOC_CHECK-makrot inte hittas och du skulle behöva "
1166 "explicit berätta för <application>aclocal</application>-verktyget var "
1167 "makrodefinitionsfilen kan hittas."
1168
1169 #. (itstool) path: example/title
1170 #: C/index.docbook:778
1171 msgid "Minimal integration with autoconf"
1172 msgstr "Minimal integrering med autoconf"
1173
1174 #. (itstool) path: example/programlisting
1175 #: C/index.docbook:779
1176 #, no-wrap
1177 msgid ""
1178 "\n"
1179 "# recommended: set m4 directory\n"
1180 "AC_CONFIG_MACRO_DIR(m4)\n"
1181 "# optional: register gtk-doc in configure\n"
1182 "GTK_DOC_CHECK([1.28])\n"
1183 msgstr ""
1184 "\n"
1185 "# rekommenderat: ställ in m4-katalog\n"
1186 "AC_CONFIG_MACRO_DIR(m4)\n"
1187 "# valfritt: registrera gtk-doc i configure\n"
1188 "GTK_DOC_CHECK([1.28])\n"
1189
1190 #. (itstool) path: example/title
1191 #: C/index.docbook:794
1192 msgid "Integration with optional gtk-doc dependency"
1193 msgstr "Integrering med valfritt gtk-doc-beroende"
1194
1195 #. (itstool) path: example/programlisting
1196 #: C/index.docbook:795
1197 #, no-wrap
1198 msgid ""
1199 "\n"
1200 "m4_ifdef([GTK_DOC_CHECK], [\n"
1201 "# recommended: set m4 directory\n"
1202 "AC_CONFIG_MACRO_DIR(m4)\n"
1203 "# optional: register gtk-doc in configure\n"
1204 "GTK_DOC_CHECK([1.28])\n"
1205 "],[\n"
1206 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1207 "])\n"
1208 msgstr ""
1209 "\n"
1210 "m4_ifdef([GTK_DOC_CHECK], [\n"
1211 "# rekommenderat: ställ in m4-katalog\n"
1212 "AC_CONFIG_MACRO_DIR(m4)\n"
1213 "# valfritt: registrera gtk-doc i configure\n"
1214 "GTK_DOC_CHECK([1.28])\n"
1215 "],[\n"
1216 "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
1217 "])\n"
1218
1219 #. (itstool) path: sect2/para
1220 #: C/index.docbook:788
1221 msgid ""
1222 "The above example works, but will require all developers to have gtk-doc "
1223 "installed. A better way is to make building the documentation optional as "
1224 "shown in the next example: <_:example-1/>"
1225 msgstr ""
1226 "Exemplet ovan fungerar, men skulle kräva att alla utvecklare har gtk-doc "
1227 "installerat. Ett bättre sätt är att göra byggande av dokumentationen "
1228 "valfritt på det sätt som visas i nästa exempel: <_:example-1/>"
1229
1230 # sebras: <function> or <symbol>?
1231 #. (itstool) path: sect2/para
1232 #: C/index.docbook:808
1233 msgid ""
1234 "The first argument is used to check for the Gtk-Doc version at configure "
1235 "time. The 2nd, optional argument is used by <application>gtkdocize</"
1236 "application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several "
1237 "configure switches:"
1238 msgstr ""
1239 "Det första argumentet används för att leta efter Gtk-Doc-versionen under "
1240 "konfigurationen. Det andra, valfria, argumentet används av "
1241 "<application>gtkdocize</application>. Makrot <symbol>GTK_DOC_CHECK</symbol> "
1242 "lägger också till flera configure-flaggor:"
1243
1244 #. (itstool) path: listitem/para
1245 #: C/index.docbook:817
1246 msgid "--with-html-dir=PATH : path to installed docs"
1247 msgstr "--with-html-dir=SÖKVÄG : sökväg till installerad dokumentation"
1248
1249 #. (itstool) path: listitem/para
1250 #: C/index.docbook:818
1251 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]"
1252 msgstr ""
1253 "--enable-gtk-doc : använd gtk-doc för att bygga dokumentation "
1254 "[standardvärde=no]"
1255
1256 #. (itstool) path: listitem/para
1257 #: C/index.docbook:819
1258 msgid ""
1259 "--enable-gtk-doc-html : build documentation in html format [default=yes]"
1260 msgstr ""
1261 "--enable-gtk-doc-html : bygg dokumentation i html-format [standardvärde=yes]"
1262
1263 #. (itstool) path: listitem/para
1264 #: C/index.docbook:820
1265 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]"
1266 msgstr ""
1267 "--enable-gtk-doc-pdf : bygg dokumentation i pdf-format [standardvärde=no]"
1268
1269 #. (itstool) path: important/para
1270 #: C/index.docbook:824
1271 msgid ""
1272 "GTK-Doc is disabled by default! Remember to pass the option <option>'--"
1273 "enable-gtk-doc'</option> to the next <filename>configure</filename> run. "
1274 "Otherwise pregenerated documentation is installed (which makes sense for "
1275 "users but not for developers)."
1276 msgstr ""
1277 "GTK-Doc är inaktiverat som standard! Kom ihåg att skicka flaggan <option>”--"
1278 "enable-gtk-doc”</option> vid nästa körning av <filename>configure</"
1279 "filename>. Annars kommer förgenererad dokumentation att installeras (vilket "
1280 "är rimligt för användare men inte för utvecklare)."
1281
1282 #. (itstool) path: sect2/para
1283 #: C/index.docbook:832
1284 msgid ""
1285 "After all changes to <filename>configure.ac</filename> are made, update the "
1286 "<filename>configure</filename> file. This can be done by re-running "
1287 "<code>autogen.sh</code>."
1288 msgstr ""
1289 "Efter att alla ändringar i <filename>configure.ac</filename> är gjorda, "
1290 "uppdatera filen <filename>configure</filename>. Detta kan göras genom att "
1291 "köra om <code>autogen.sh</code>."
1292
1293 #. (itstool) path: sect2/title
1294 #: C/index.docbook:840
1295 msgid "Integration with autogen"
1296 msgstr "Integrering med autogen"
1297
1298 #. (itstool) path: sect2/para
1299 #: C/index.docbook:842
1300 msgid ""
1301 "Most projects will have an <filename>autogen.sh</filename> script to setup "
1302 "the build infrastructure after the project was checked out from a version "
1303 "control system (such as git or svn). GTK-Doc comes with a script called "
1304 "<application>gtkdocize</application> which can be used to copy the necessary "
1305 "files needed by Gtk-Doc to the source directory."
1306 msgstr ""
1307 "De flesta projekt kommer att ha ett <filename>autogen.sh</filename>-skript "
1308 "för att ställa in infrastrukturen för bygget efter utcheckning från ett "
1309 "versionshanteringssystem (så som git eller svn). GTK-Doc kommer med ett "
1310 "skript som heter <application>gtkdocize</application> som kan användas för "
1311 "att kopiera nödvändiga filer som behövs av Gtk-Doc till källkatalogen."
1312
1313 #. (itstool) path: sect2/para
1314 #: C/index.docbook:850
1315 msgid "It should be run before autoreconf, autoheader, automake or autoconf."
1316 msgstr "Det bör köras före autoreconf, autoheader, automake eller autoconf."
1317
1318 #. (itstool) path: example/title
1319 #: C/index.docbook:855
1320 msgid "Running gtkdocize from autogen.sh"
1321 msgstr "Köra gtkdocize från autogen.sh"
1322
1323 #. (itstool) path: example/programlisting
1324 #: C/index.docbook:856
1325 #, no-wrap
1326 msgid ""
1327 "\n"
1328 "gtkdocize || exit 1\n"
1329 msgstr ""
1330 "\n"
1331 "gtkdocize || exit 1\n"
1332
1333 #. (itstool) path: example/title
1334 #: C/index.docbook:864
1335 msgid "Conditionally run gtkdocize from autogen.sh"
1336 msgstr "Köra gtkdocize villkorligt från autogen.sh"
1337
1338 #. (itstool) path: example/programlisting
1339 #: C/index.docbook:865
1340 #, no-wrap
1341 msgid ""
1342 "\n"
1343 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1344 "if test $? -ne 0; then\n"
1345 " echo \"No gtk-doc support found. You can't build the docs.\"\n"
1346 "else\n"
1347 " $GTKDOCIZE || exit 1\n"
1348 "fi\n"
1349 msgstr ""
1350 "\n"
1351 "GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)\n"
1352 "if test $? -ne 0; then\n"
1353 " echo \"Inget gtk-doc-stöd funnet. Du kan inte bygga dokumentationen.\"\n"
1354 "else\n"
1355 " $GTKDOCIZE || exit 1\n"
1356 "fi\n"
1357
1358 #. (itstool) path: sect2/para
1359 #: C/index.docbook:876
1360 msgid ""
1361 "When running <application>gtkdocize</application> it copies <filename>gtk-"
1362 "doc.make</filename> to your project root (or any directory specified by the "
1363 "<option>--docdir</option> option)."
1364 msgstr ""
1365 "När <application>gtkdocize</application> kör kopierar det <filename>gtk-"
1366 "doc.make</filename> till din projektrot (eller den katalog som anges med "
1367 "flaggan <option>--docdir</option>)."
1368
1369 # TODO: Strange last sentence
1370 #. (itstool) path: sect2/para
1371 #: C/index.docbook:882
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> söker i ditt <filename>configure.ac</"
1380 "filename>-skript efter makrot <function>GTK_DOC_CHECK</function>. Makrot "
1381 "<function>GTK_DOC_CHECK</function> kan användas för att skicka extra "
1382 "argument till skriptet <application>gtkdocize</application>. den andra "
1383 "parametern i <function>GTK_DOC_CHECK</function>-makrot."
1384
1385 #. (itstool) path: sect2/para
1386 #: C/index.docbook:891
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 "Alternativt kan ytterligare argument också skickas till "
1394 "<application>gtkdocize</application> via miljövariabeln "
1395 "<function>GTKDOCIZE_FLAGS</function>, eller genom att ange dem direkt till "
1396 "<application>gtkdocize</application> i <filename>autogen.sh</filename>."
1397
1398 #. (itstool) path: sect2/title
1399 #: C/index.docbook:902
1400 msgid "Executing GTK-Doc from the Build System"
1401 msgstr "Köra GTK-Doc från byggsystemet"
1402
1403 #. (itstool) path: sect2/para
1404 #: C/index.docbook:904
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 "Efter de tidigare stegen är det dags att köra bygget. Först måste vi köra om "
1412 "<filename>autogen.sh</filename>. Om detta skript kör configure åt dig, kan "
1413 "du ge det flaggan <option>--enable-gtk-doc</option>. Annars kör manuellt "
1414 "<filename>configure</filename> med denna flagga efteråt."
1415
1416 #. (itstool) path: sect2/para
1417 #: C/index.docbook:911
1418 msgid ""
1419 "The first make run generates several additional files in the doc-"
1420 "directories. The important ones are: <filename>&lt;package&gt;.types</"
1421 "filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the "
1422 "past .sgml), <filename>&lt;package&gt;-sections.txt</filename>."
1423 msgstr ""
1424 "Den första körningen av make genererar flera extra filer i doc-katalogerna. "
1425 "De viktiga är <filename>&lt;paket&gt;.types</filename>, "
1426 "<filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), "
1427 "<filename>&lt;paket&gt;-sections.txt</filename>."
1428
1429 #. (itstool) path: example/title
1430 #: C/index.docbook:919
1431 msgid "Running the doc build"
1432 msgstr "Att köra dokumentationsbygget"
1433
1434 #. (itstool) path: example/programlisting
1435 #: C/index.docbook:920
1436 #, no-wrap
1437 msgid ""
1438 "\n"
1439 "./autogen.sh --enable-gtk-doc\n"
1440 "make\n"
1441 msgstr ""
1442 "\n"
1443 "./autogen.sh --enable-gtk-doc\n"
1444 "make\n"
1445
1446 #. (itstool) path: sect2/para
1447 #: C/index.docbook:927
1448 msgid ""
1449 "Now you can point your browser to <filename>docs/reference/&lt;package&gt;/"
1450 "index.html</filename>. With this initial setup you will only see a very "
1451 "simple document. The next chapter will teach you how to add API "
1452 "documentation to your code via special comment blocks. The Chapter "
1453 "afterwards introduces <link linkend=\"metafiles\">additional files</link> "
1454 "and shows how to edit the <link linkend=\"metafiles_master\">master "
1455 "template</link> to add additional chapters and sections to your "
1456 "documentation files."
1457 msgstr ""
1458 "Nu kan du peka din webbläsare till <filename>docs/reference/&lt;paket&gt;/"
1459 "index.html</filename>. Med denna ursprungliga konfiguration kommer du bara "
1460 "se ett väldigt enkelt dokument. Nästa kapitel kommer att lära dig hur du "
1461 "lägger till API-dokumentation till din kod via speciella kommentarsblock. "
1462 "Kapitlet efteråt introducerar <link linkend=\"metafiles\">ytterligare filer</"
1463 "link> och visar hur <link linkend=\"metafiles_master\">huvudmallen</link> "
1464 "redigeras för att lägga till ytterligare kapitel och avsnitt till dina "
1465 "dokumentationsfiler."
1466
1467 #. (itstool) path: sect1/title
1468 #: C/index.docbook:943
1469 msgid "Integration with CMake build systems"
1470 msgstr "Integrering med CMake-byggsystem"
1471
1472 #. (itstool) path: sect1/para
1473 #: C/index.docbook:945
1474 msgid ""
1475 "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and "
1476 "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). "
1477 "This provides a <literal>gtk_doc_add_module</literal> command that you can "
1478 "set in your <filename>CMakeLists.txt</filename> file."
1479 msgstr ""
1480 "GTK-Doc kommer nu att producera en <filename>GtkDocConfig.cmake</filename>-"
1481 "modul (och motsvarande <filename>GtkDocConfigVersion.cmake</filename>-"
1482 "modul). Detta tillhandahåller ett <literal>gtk_doc_add_module</literal>-"
1483 "kommando som du kan ställa in i din <filename>CMakeLists.txt</filename>-fil."
1484
1485 #. (itstool) path: example/title
1486 #: C/index.docbook:955
1487 msgid "Example of using GTK-Doc from CMake"
1488 msgstr "Exempel på användning av GTK-Doc från CMake"
1489
1490 #. (itstool) path: example/programlisting
1491 #: C/index.docbook:956
1492 #, no-wrap
1493 msgid ""
1494 "\n"
1495 "find_package(GtkDoc 1.25 REQUIRED)\n"
1496 "\n"
1497 "# Create the doc-libmeep target.\n"
1498 "gtk_doc_add_module(\n"
1499 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1500 " XML meep-docs.xml\n"
1501 " LIBRARIES libmeep\n"
1502 ")\n"
1503 "\n"
1504 "# Build doc-libmeep as part of the default target. Without this, you would\n"
1505 "# have to explicitly run something like `make doc-libmeep` to build the docs.\n"
1506 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1507 "\n"
1508 "# Install the docs. (This assumes you're using the GNUInstallDirs CMake module\n"
1509 "# to set the CMAKE_INSTALL_DOCDIR variable correctly).\n"
1510 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1511 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1512 msgstr ""
1513 "\n"
1514 "find_package(GtkDoc 1.25 REQUIRED)\n"
1515 "\n"
1516 "# Skapa målet doc-libmeep.\n"
1517 "gtk_doc_add_module(\n"
1518 " libmeep ${CMAKE_SOURCE_DIR}/libmeep\n"
1519 " XML meep-docs.xml\n"
1520 " LIBRARIES libmeep\n"
1521 ")\n"
1522 "\n"
1523 "# Bygg doc-libmeep som standardmålet. Utan detta måste du uttryckligen\n"
1524 "# köra något i stil med `make doc-libmeep` för att bygga dokumentationen.\n"
1525 "add_custom_target(documentation ALL DEPENDS doc-libmeep)\n"
1526 "\n"
1527 "# Installera dokumentationen. (Detta förutsätter att du använder CMake-modulen\n"
1528 "# GNUInstallDirs för att ställa in variabeln CMAKE_INSTALL_DOCDIR korrekt).\n"
1529 "install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html\n"
1530 " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n"
1531
1532 #. (itstool) path: sect1/para
1533 #: C/index.docbook:953
1534 msgid "The following example shows how to use this command. <_:example-1/>"
1535 msgstr ""
1536 "Det följande exemplet visar hur du använder detta kommando. <_:example-1/>"
1537
1538 #. (itstool) path: sect1/title
1539 #: C/index.docbook:980
1540 msgid "Integration with plain makefiles or other build systems"
1541 msgstr "Integrering med vanliga makefiler eller andra byggsystem"
1542
1543 #. (itstool) path: sect1/para
1544 #: C/index.docbook:982
1545 msgid ""
1546 "In the case one does not want to use automake and therefore <filename>gtk-"
1547 "doc.mak</filename> one will need to call the gtkdoc tools in the right order "
1548 "in own makefiles (or other build tools)."
1549 msgstr ""
1550 "I det fall man inte vill använda automake och därför inte heller "
1551 "<filename>gtk-doc.mak</filename> kommer man att behöva anropa gtkdoc-"
1552 "verktygen i rätt ordning i sina egna makefiler (eller andra byggverktyg)."
1553
1554 #. (itstool) path: example/title
1555 #: C/index.docbook:989
1556 msgid "Documentation build steps"
1557 msgstr "Byggsteg för dokumentation"
1558
1559 #. (itstool) path: example/programlisting
1560 #: C/index.docbook:990
1561 #, no-wrap
1562 msgid ""
1563 "\n"
1564 "DOC_MODULE=meep\n"
1565 "// sources have changed\n"
1566 "gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;\n"
1567 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1568 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;\n"
1569 "// xml files have changed\n"
1570 "mkdir html\n"
1571 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1572 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1573 msgstr ""
1574 "\n"
1575 "DOC_MODULE=meep\n"
1576 "// källkod har ändrats\n"
1577 "gtkdoc-scan --module=$(DOC_MODULE) &lt;källkodskatalog&gt;\n"
1578 "gtkdoc-scangobj --module=$(DOC_MODULE)\n"
1579 "gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;källkodskatalog&gt;\n"
1580 "// xml-filer har ändrats\n"
1581 "mkdir html\n"
1582 "cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml\n"
1583 "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n"
1584
1585 #. (itstool) path: sect1/para
1586 #: C/index.docbook:1004
1587 msgid ""
1588 "One will need to look at the <filename>Makefile.am</filename> and "
1589 "<filename>gtk-doc.mak</filename> to pick the extra options needed."
1590 msgstr ""
1591 "Man kommer att behöva titta i <filename>Makefile.am</filename> och "
1592 "<filename>gtk-doc.mak</filename> för att plocka ut de extra flaggor som "
1593 "behövs."
1594
1595 #. (itstool) path: sect1/title
1596 #: C/index.docbook:1011
1597 msgid "Integration with version control systems"
1598 msgstr "Integrering med versionshanteringssystem"
1599
1600 #. (itstool) path: sect1/para
1601 #: C/index.docbook:1013
1602 msgid ""
1603 "As a rule of thumb, it's the files you edit which should go under version "
1604 "control. For typical projects it's these files: "
1605 "<filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-"
1606 "docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-"
1607 "sections.txt</filename>, <filename>Makefile.am</filename>."
1608 msgstr ""
1609 "Som en tumregel är det filerna du redigerar som bör versionshanteras. För "
1610 "typiska projekt är det följande filer: <filename>&lt;paket&gt;.types</"
1611 "filename>, <filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), "
1612 "<filename>&lt;paket&gt;-sections.txt</filename>, <filename>Makefile.am</"
1613 "filename>."
1614
1615 #. (itstool) path: sect1/para
1616 #: C/index.docbook:1021
1617 msgid ""
1618 "Files in the <filename>xml/</filename> and <filename>html/</filename> "
1619 "directories should not go under version control. Neither should any of the "
1620 "<filename>.stamp</filename> files."
1621 msgstr ""
1622 "Filer i katalogerna <filename>xml/</filename> och <filename>html/</filename> "
1623 "bör inte versionshanteras. Detsamma gäller <filename>.stamp</filename>-"
1624 "filerna."
1625
1626 #. (itstool) path: chapter/title
1627 #: C/index.docbook:1031
1628 msgid "Documenting the code"
1629 msgstr "Att dokumentera koden"
1630
1631 #. (itstool) path: chapter/para
1632 #: C/index.docbook:1033
1633 msgid ""
1634 "GTK-Doc uses source code comment with a special syntax for code "
1635 "documentation. Further it retrieves information about your project structure "
1636 "from other sources. During the next section you will find all information "
1637 "about the syntax of the comments."
1638 msgstr ""
1639 "GTK-Doc använder källkodskommentarer med en speciell syntax för "
1640 "koddokumentation. Vidare så hämtar det information om din projektstruktur "
1641 "från olika källor. Under nästa avsnitt kommer du att hitta information om "
1642 "syntaxen i kommentarerna."
1643
1644 #. (itstool) path: example/title
1645 #: C/index.docbook:1044 C/index.docbook:1070
1646 msgid "GTK-Doc comment block"
1647 msgstr "GTK-Doc-kommentarsblock"
1648
1649 #. (itstool) path: example/programlisting
1650 #: C/index.docbook:1045
1651 #, no-wrap
1652 msgid ""
1653 "\n"
1654 "#ifndef __GTK_DOC_IGNORE__\n"
1655 "/* unparseable code here */\n"
1656 "#endif\n"
1657 msgstr ""
1658 "\n"
1659 "#ifndef __GTK_DOC_IGNORE__\n"
1660 "/* unparseable code here */\n"
1661 "#endif\n"
1662
1663 #. (itstool) path: chapter/para
1664 #: C/index.docbook:1040
1665 msgid ""
1666 "The GTK-Doc scanner can handle the majority of C headers fine. In the case "
1667 "of receiving warnings from the scanner that look like a special case, one "
1668 "can hint GTK-Doc to skip over them. <_:example-1/>"
1669 msgstr ""
1670 "GTK-Doc-detektorn kan hantera majoriteten av C-huvuden bra. I det fall när "
1671 "du får varningar från detektorn som ser ut som ett specialfall, kan du tipsa "
1672 "GTK-Doc att hoppa över dem. <_:example-1/>"
1673
1674 #. (itstool) path: note/title
1675 #: C/index.docbook:1054
1676 msgid "Limitations"
1677 msgstr "Begränsningar"
1678
1679 # sebras: no 's in the original
1680 #. (itstool) path: note/para
1681 #: C/index.docbook:1055
1682 msgid ""
1683 "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but "
1684 "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations."
1685 msgstr ""
1686 "Notera att GTK-Doc har stöd för <code>#ifndef(__GTK_DOC_IGNORE__)</code> men "
1687 "inte <code>#if !defined(__GTK_DOC_IGNORE__)</code> eller andra kombinationer."
1688
1689 #. (itstool) path: sect1/title
1690 #: C/index.docbook:1065
1691 msgid "Documentation comments"
1692 msgstr "Dokumentationskommentarer"
1693
1694 #. (itstool) path: example/programlisting
1695 #: C/index.docbook:1071
1696 #, no-wrap
1697 msgid ""
1698 "\n"
1699 "/**\n"
1700 " * identifier:\n"
1701 " * documentation ...\n"
1702 " */\n"
1703 msgstr ""
1704 "\n"
1705 "/**\n"
1706 " * identifierare:\n"
1707 " * dokumentation …\n"
1708 " */\n"
1709
1710 #. (itstool) path: sect1/para
1711 #: C/index.docbook:1067
1712 msgid ""
1713 "A multiline comment that starts with an additional '*' marks a documentation "
1714 "block that will be processed by the GTK-Doc tools. <_:example-1/>"
1715 msgstr ""
1716 "En flerradskommentar som börjar med en extra ”*” markerar ett "
1717 "dokumentationsblock som kommer att hanteras av GTK-Doc-verktygen. "
1718 "<_:example-1/>"
1719
1720 #. (itstool) path: sect1/para
1721 #: C/index.docbook:1080
1722 msgid ""
1723 "The 'identifier' is one line with the name of the item the comment is "
1724 "related to. The syntax differs a little depending on the item. (TODO add "
1725 "table showing identifiers)"
1726 msgstr ""
1727 "'Identifierare' är en rad med namnet på det objekt som kommentaren är "
1728 "relaterad till. Syntaxen skiljer sig lite beroende på objekt. (TODO lägg "
1729 "till tabell som visar identifierare)"
1730
1731 #. (itstool) path: sect1/para
1732 #: C/index.docbook:1086
1733 msgid ""
1734 "The 'documentation' block is also different for each symbol type. Symbol "
1735 "types that get parameters such as functions or macros have the parameter "
1736 "description first followed by a blank line (just a '*'). Afterwards follows "
1737 "the detailed description. All lines (outside program listings and CDATA "
1738 "sections) just containing a ' *' (blank-asterisk) are converted to paragraph "
1739 "breaks. If you don't want a paragraph break, change that into ' * ' (blank-"
1740 "asterisk-blank-blank). This is useful in preformatted text (code listings)."
1741 msgstr ""
1742 "Blocket 'dokumentation' skiljer sig också för varje symboltyp. Symboltyper "
1743 "som får parametrar så som funktioner eller makron har en "
1744 "parameterbeskrivning först, åtföljd av en blankrad (bara en ”*”). Efteråt "
1745 "följer den detaljerade beskrivningen. Alla rader (utanför programlistningar "
1746 "och CDATA-avsnitt) som endast innehåller ” *” (blanksteg-asterisk) "
1747 "konverteras till styckeavgränsare. Om du inte vill ha en styckeavgränsare, "
1748 "ändra till ” * ” (blanksteg-asterisk-blanksteg-blanksteg). Detta är "
1749 "användbart i förformaterad text (kodlistningar)."
1750
1751 #. (itstool) path: listitem/para
1752 #: C/index.docbook:1103
1753 msgid ""
1754 "What it is: The name for a class or function can sometimes be misleading for "
1755 "people coming from a different background."
1756 msgstr ""
1757 "Vad är detta: Namnet på en klass eller en funktion kan ibland vara "
1758 "vilseledande för personer med annan bakgrund."
1759
1760 #. (itstool) path: listitem/para
1761 #: C/index.docbook:1109
1762 msgid ""
1763 "What it does: Tell about common uses. Put it in relation with the other API."
1764 msgstr ""
1765 "Vad gör det: Berättar om vanliga användningsfall. Sätter det i relation med "
1766 "det andra API:t."
1767
1768 #. (itstool) path: tip/para
1769 #: C/index.docbook:1099
1770 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>"
1771 msgstr "När du dokumenterar kod, beskriv två aspekter: <_:itemizedlist-1/>"
1772
1773 #. (itstool) path: listitem/para
1774 #: C/index.docbook:1124
1775 msgid "Use function() to refer to functions or macros which take arguments."
1776 msgstr ""
1777 "Använd funktion() för att referera till funktioner eller makron som tar "
1778 "argument."
1779
1780 #. (itstool) path: listitem/para
1781 #: C/index.docbook:1129
1782 msgid ""
1783 "Use @param to refer to parameters. Also use this when referring to "
1784 "parameters of other functions, related to the one being described."
1785 msgstr ""
1786 "Använd @param för att referera till parametrar. Använd också detta när du "
1787 "refererar till parametrar för andra funktioner, relaterade till den som "
1788 "beskrivs."
1789
1790 #. (itstool) path: listitem/para
1791 #: C/index.docbook:1135
1792 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS."
1793 msgstr ""
1794 "Använd %konstant för att referera till en konstant, t.ex. %G_TRAVERSE_LEAFS."
1795
1796 #. (itstool) path: listitem/para
1797 #: C/index.docbook:1140
1798 msgid ""
1799 "Use #symbol to refer to other types of symbol, e.g. structs and enums and "
1800 "macros which don't take arguments."
1801 msgstr ""
1802 "Använd #symbol för att referera till andra typer av symboler, t.ex. "
1803 "strukturer eller uppräkningar och makron som inte tar argument."
1804
1805 #. (itstool) path: listitem/para
1806 #: C/index.docbook:1146
1807 msgid "Use #Object::signal to refer to a GObject signal."
1808 msgstr "Använd #Objekt::signal för att referera till en GObject-signal."
1809
1810 #. (itstool) path: listitem/para
1811 #: C/index.docbook:1151
1812 msgid "Use #Object:property to refer to a GObject property."
1813 msgstr "Använd #Objekt:egenskap för att referera till en GObject-egenskap."
1814
1815 #. (itstool) path: listitem/para
1816 #: C/index.docbook:1156
1817 msgid ""
1818 "Use #Struct.field to refer to a field inside a structure and "
1819 "#GObjectClass.foo_bar() to refer to a vmethod."
1820 msgstr ""
1821 "Använd #Struktur.fält för att referera till ett fält inuti en struktur och "
1822 "#GObjectKlass.foo_bar() för att referera till en virtuell metod."
1823
1824 #. (itstool) path: sect1/para
1825 #: C/index.docbook:1118
1826 msgid ""
1827 "One advantage of hyper-text over plain-text is the ability to have links in "
1828 "the document. Writing the correct markup for a link can be tedious though. "
1829 "GTK-Doc comes to help by providing several useful abbreviations. "
1830 "<_:itemizedlist-1/>"
1831 msgstr ""
1832 "En fördel med hypertext framför vanlig text är möjligheten att ha länkar i "
1833 "dokumentet. Att skriva korrekta taggar för en länk kan dock vara tröttsamt. "
1834 "GTK-Doc hjälper då till med att tillhandahålla flera användbara "
1835 "förkortningar. <_:itemizedlist-1/>"
1836
1837 #. (itstool) path: tip/para
1838 #: C/index.docbook:1165
1839 msgid ""
1840 "If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or "
1841 "'#' in your documentation without GTK-Doc changing them you can use the XML "
1842 "entities \"&amp;lt;\", \"&amp;gt;\", \"&amp;lpar;\", \"&amp;rpar;\", "
1843 "\"&amp;commat;\", \"&amp;percnt;\" and \"&amp;num;\" respectively or escape "
1844 "them with a backslash '\\'."
1845 msgstr ""
1846 "Om du behöver använda specialtecken ”&lt;”, ”&gt;”, ”()”, ”@”, ”%” eller ”#” "
1847 "i din dokumentation utan att GTK-Doc ändrar dem kan du använda XML-"
1848 "entiteterna ”&amp;lt;”, ”&amp;gt;”, ”&amp;lpar;”, ”&amp;rpar;”, "
1849 "”&amp;commat;”, ”&amp;percnt;” respektive ”&amp;num;” eller använda "
1850 "kontrollsekvensen ”\\”."
1851
1852 #. (itstool) path: sect1/para
1853 #: C/index.docbook:1174
1854 msgid ""
1855 "DocBook can do more than just links. One can also have lists, examples, "
1856 "headings, and images. As of version 1.20, the preferred way is to use a "
1857 "subset of the basic text formatting syntax called <ulink url=\"http://"
1858 "daringfireball.net/projects/markdown/\">Markdown</ulink>. On older GTK-Doc "
1859 "versions any documentation that includes Markdown will be rendered as is. "
1860 "For example, list items will appear as lines starting with a dash."
1861 msgstr ""
1862 "DocBook kan mer än bara länkar. Du kan också ha listor, exempel, rubriker "
1863 "och bilder. Från och med version 1.20, är det föredragna sättet att använda "
1864 "en delmängd av den grundläggande textformateringssyntaxen som kallas <ulink "
1865 "url=\"http://daringfireball.net/projects/markdown/\">Markdown</ulink>. Äldre "
1866 "GTK-Doc-versioner kommer dokumentation som inkluderar markdown att renderas "
1867 "som den är. Till exempel kommer listobjekt att visas som att de börjar med "
1868 "ett bindestreck."
1869
1870 #. (itstool) path: sect1/para
1871 #: C/index.docbook:1185
1872 msgid ""
1873 "While markdown is now preferred one can mix both. One limitation here is "
1874 "that one can use docbook xml within markdown, but markdown within docbook "
1875 "xml is not supported."
1876 msgstr ""
1877 "Då markdown numera föredras kan du blanda båda. En begränsning här är att du "
1878 "kan använda docbook-xml inuti markdown, men markdown inuti docbook-xml stöds "
1879 "inte."
1880
1881 #. (itstool) path: sect1/para
1882 #: C/index.docbook:1191
1883 msgid ""
1884 "In older GTK-Doc releases, if you need support for additional formatting, "
1885 "you would need to enable the usage of docbook XML tags inside doc-comments "
1886 "by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in "
1887 "the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</"
1888 "filename>."
1889 msgstr ""
1890 "I äldre GTK-Doc-versioner var du tvungen, om du ville ha stöd för "
1891 "ytterligare formatering, att aktivera användningen av docbook-XML-taggar "
1892 "inuti dok-kommentarer genom att lägga till <option>--xml-mode</option> "
1893 "(eller <option>--sgml-mode</option>) i variabeln <symbol>MKDB_OPTIONS</"
1894 "symbol> inuti <filename>Makefile.am</filename>."
1895
1896 # sebras: markdown or Markdown?
1897 #. (itstool) path: example/title
1898 #: C/index.docbook:1200
1899 msgid "GTK-Doc comment block using Markdown"
1900 msgstr "GTK-Doc-kommentarsblock som använder Markdown"
1901
1902 #. (itstool) path: example/programlisting
1903 #: C/index.docbook:1201
1904 #, no-wrap
1905 msgid ""
1906 "\n"
1907 "/**\n"
1908 " * identifier:\n"
1909 " *\n"
1910 " * documentation paragraph ...\n"
1911 " *\n"
1912 " * # Sub Heading #\n"
1913 " *\n"
1914 " * ## Second Sub Heading\n"
1915 " *\n"
1916 " * # Sub Heading With a Link Anchor # {#heading-two}\n"
1917 " *\n"
1918 " * more documentation:\n"
1919 " *\n"
1920 " * - list item 1\n"
1921 " *\n"
1922 " * Paragraph inside a list item.\n"
1923 " *\n"
1924 " * - list item 2\n"
1925 " *\n"
1926 " * 1. numbered list item\n"
1927 " *\n"
1928 " * 2. another numbered list item\n"
1929 " *\n"
1930 " * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)\n"
1931 " *\n"
1932 " * ![an inline image](plot-result.png)\n"
1933 " *\n"
1934 " * [A link to the heading anchor above][heading-two]\n"
1935 " *\n"
1936 " * A C-language example:\n"
1937 " * |[&lt;!-- language=\"C\" --&gt;\n"
1938 " * GtkWidget *label = gtk_label_new (\"Gorgeous!\");\n"
1939 " * ]|\n"
1940 " */\n"
1941 msgstr ""
1942 "\n"
1943 "/**\n"
1944 " * Identifierare:\n"
1945 " *\n"
1946 " * stycke med dokumentation …\n"
1947 " *\n"
1948 " * # Underrubrik #\n"
1949 " *\n"
1950 " * ## Underunderrubrik\n"
1951 " *\n"
1952 " * # Underrubrik med länkankare # {#andra-rubriken}\n"
1953 " *\n"
1954 " * mer dokumentation:\n"
1955 " *\n"
1956 " * - listobjekt 1\n"
1957 " *\n"
1958 " * Stycke inuti listobjekt.\n"
1959 " *\n"
1960 " * - listobjekt 2\n"
1961 " *\n"
1962 " * 1. numrerat listobjekt\n"
1963 " *\n"
1964 " * 2. ytterligare ett numrerat listobjekt\n"
1965 " *\n"
1966 " * Ett annat stycke. [En länk till GNOME:s webbplats](http://www.gnome.org/)\n"
1967 " *\n"
1968 " * ![en bild](resultatgraf.png)\n"
1969 " *\n"
1970 " * [En länk till rubrikankaret ovan][andra-rubriken]\n"
1971 " *\n"
1972 " * Ett C-exempel:\n"
1973 " * |[&lt;!-- language=\"C\" --&gt;\n"
1974 " * GtkWidget *label = gtk_label_new (\"Vackert!\");\n"
1975 " * ]|\n"
1976 " */\n"
1977
1978 #. (itstool) path: sect1/para
1979 #: C/index.docbook:1240
1980 msgid ""
1981 "More examples of what markdown tags are supported can be found in the <ulink "
1982 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK "
1983 "Documentation Markdown Syntax Reference</ulink>."
1984 msgstr ""
1985 "Fler exempel på vilka markdown-taggar som stöds hittas i <ulink "
1986 "url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/"
1987 "Markdown\">Referensen för GTK-dokumentationens markdown-syntax</ulink>."
1988
1989 #. (itstool) path: tip/para
1990 #: C/index.docbook:1246
1991 msgid ""
1992 "As already mentioned earlier GTK-Doc is for documenting public API. Thus one "
1993 "cannot write documentation for static symbols. Nevertheless it is good to "
1994 "comment those symbols too. This helps other developers to understand your "
1995 "code. Therefore we recommend to comment these using normal comments (without "
1996 "the 2nd '*' in the first line). If later the function needs to be made "
1997 "public, all one needs to do is to add another '*' in the comment block and "
1998 "insert the symbol name at the right place inside the sections file."
1999 msgstr ""
2000 "Som redan nämnts är GTK-Doc avsett för att dokumentera publika API:er. Du "
2001 "kan därför inte skriva dokumentation för statiska symboler. Likväl är det "
2002 "bra att kommentera även dessa symboler. Det hjälper andra utvecklare att "
2003 "förstå din kod. Därför rekommenderar vi att du kommenterar dessa med normala "
2004 "kommentarer (utan den andra ”*” på den första raden). Om funktionen vid ett "
2005 "senare tillfälle måste göras publik är allt du behöver göra att lägga till "
2006 "ytterligare en ”*” i kommentarsblocket och infoga symbolnamnet på rätt "
2007 "ställe i avsnittsfilen."
2008
2009 #. (itstool) path: sect1/title
2010 #: C/index.docbook:1261
2011 msgid "Documenting sections"
2012 msgstr "Dokumentationsavsnitt"
2013
2014 #. (itstool) path: sect1/para
2015 #: C/index.docbook:1263
2016 msgid ""
2017 "Each section of the documentation contains information about one class or "
2018 "module. To introduce the component one can write a section block. The short "
2019 "description is also used inside the table of contents. All the @fields are "
2020 "optional."
2021 msgstr ""
2022 "Varje avsnitt av dokumentation innehåller information om en klass eller en "
2023 "modul. För att introducera komponenten kan man skriva ett avsnittsblock. Den "
2024 "korta beskrivningen används också i innehållsförteckningen. Alla @fälten är "
2025 "valfria."
2026
2027 #. (itstool) path: example/title
2028 #: C/index.docbook:1271
2029 msgid "Section comment block"
2030 msgstr "Kommentarsblock för avsnitt"
2031
2032 #. (itstool) path: example/programlisting
2033 #: C/index.docbook:1272
2034 #, no-wrap
2035 msgid ""
2036 "\n"
2037 "/**\n"
2038 " * SECTION:meepapp\n"
2039 " * @short_description: the application class\n"
2040 " * @title: Meep application\n"
2041 " * @section_id:\n"
2042 " * @see_also: #MeepSettings\n"
2043 " * @stability: Stable\n"
2044 " * @include: meep/app.h\n"
2045 " * @image: application.png\n"
2046 " *\n"
2047 " * The application class handles ...\n"
2048 " */\n"
2049 msgstr ""
2050 "\n"
2051 "/**\n"
2052 " * SECTION:meepapp\n"
2053 " * @short_description: programklassen\n"
2054 " * @title: Meep-programmet\n"
2055 " * @section_id:\n"
2056 " * @see_also: #MeepSettings\n"
2057 " * @stability: Stable\n"
2058 " * @include: meep/app.h\n"
2059 " * @image: application.png\n"
2060 " *\n"
2061 " * Programklassen hanterar …\n"
2062 " */\n"
2063
2064 #. (itstool) path: varlistentry/term
2065 #: C/index.docbook:1291
2066 msgid "SECTION:&lt;name&gt;"
2067 msgstr "SECTION:&lt;namn&gt;"
2068
2069 #. (itstool) path: listitem/para
2070 #: C/index.docbook:1293
2071 msgid ""
2072 "The name links the section documentation to the respective part in the "
2073 "<filename>&lt;package&gt;-sections.txt</filename> file. The name given here "
2074 "should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-"
2075 "sections.txt</filename> file."
2076 msgstr ""
2077 "Namnet länkar till avsnittsdokumentationen för respektive del i filen "
2078 "<filename>&lt;paket&gt;-sections.txt</filename>. Namnet som anges här bör "
2079 "matcha taggen &lt;FILE&gt; i filen <filename>&lt;paket&gt;-sections.txt</"
2080 "filename>."
2081
2082 #. (itstool) path: varlistentry/term
2083 #: C/index.docbook:1302
2084 msgid "@short_description"
2085 msgstr "@short_description"
2086
2087 #. (itstool) path: listitem/para
2088 #: C/index.docbook:1304
2089 msgid ""
2090 "A one line description of the section, that later will appear after the "
2091 "links in the TOC and at the top of the section page."
2092 msgstr ""
2093 "En enradsbeskrivning av avsnittet som senare kommer att visas efter länkar i "
2094 "innehållsförteckningen och lägst upp på avsnittssidan."
2095
2096 #. (itstool) path: varlistentry/term
2097 #: C/index.docbook:1311
2098 msgid "@title"
2099 msgstr "@title"
2100
2101 #. (itstool) path: listitem/para
2102 #: C/index.docbook:1313
2103 msgid ""
2104 "The section title defaults to &lt;name&gt; from the SECTION declaration. It "
2105 "can be overridden with the @title field."
2106 msgstr ""
2107 "Avsnittstiteln är som standard &lt;namn&gt; från SECTION-deklarationen. Den "
2108 "kan åsidosättas med fältet @title."
2109
2110 #. (itstool) path: varlistentry/term
2111 #: C/index.docbook:1320
2112 msgid "@section_id"
2113 msgstr "@section_id"
2114
2115 #. (itstool) path: listitem/para
2116 #: C/index.docbook:1322
2117 msgid ""
2118 "Overrides the use of title as a section identifier. For GObjects the "
2119 "&lt;title&gt; is used as a section_id and for other sections it is "
2120 "&lt;MODULE&gt;-&lt;title&gt;."
2121 msgstr ""
2122 "Åsidosätter användningen av titeln som avsnittsidentifierare. För GObjects "
2123 "används &lt;title&gt; som ett section_id och för andra avsnitt är det "
2124 "&lt;MODULE&gt;-&lt;title&gt;."
2125
2126 #. (itstool) path: varlistentry/term
2127 #: C/index.docbook:1330
2128 msgid "@see_also"
2129 msgstr "@see_also"
2130
2131 #. (itstool) path: listitem/para
2132 #: C/index.docbook:1332
2133 msgid "A list of symbols that are related to this section."
2134 msgstr "En lista över symboler som är relaterade till detta avsnitt."
2135
2136 #. (itstool) path: varlistentry/term
2137 #: C/index.docbook:1338
2138 msgid "@stability"
2139 msgstr "@stability"
2140
2141 #. (itstool) path: listitem/para
2142 #: C/index.docbook:1345
2143 msgid ""
2144 "Stable - The intention of a Stable interface is to enable arbitrary third "
2145 "parties to develop applications to these interfaces, release them, and have "
2146 "confidence that they will run on all minor releases of the product (after "
2147 "the one in which the interface was introduced, and within the same major "
2148 "release). Even at a major release, incompatible changes are expected to be "
2149 "rare, and to have strong justifications."
2150 msgstr ""
2151 "Stable - Avsikten med ett stabilt gränssnitt är att möjliggöra för tredje "
2152 "parter att utveckla program mot dessa gränssnitt, släppa dem och vara säkra "
2153 "på att de kommer att köra på alla programfixversioner av produkten (efter "
2154 "den i vilken gränssnittet introducerats, och inom samma huvudversion). Även "
2155 "vid en ny huvudversion förväntas inkompatibla ändringar vara få och vara väl "
2156 "motiverade."
2157
2158 #. (itstool) path: listitem/para
2159 #: C/index.docbook:1357
2160 msgid ""
2161 "Unstable - Unstable interfaces are experimental or transitional. They are "
2162 "typically used to give outside developers early access to new or rapidly "
2163 "changing technology, or to provide an interim solution to a problem where a "
2164 "more general solution is anticipated. No claims are made about either source "
2165 "or binary compatibility from one minor release to the next."
2166 msgstr ""
2167 "Unstable - Instabila gränssnitt är experimentella eller i en övergångsfas. "
2168 "De används typiskt för att ge utomstående utvecklare tidig tillgång till ny "
2169 "eller snabbt föränderlig teknologi, eller för att tillhandahålla "
2170 "provisoriska lösningar för ett problem där en mer generell lösning förutses. "
2171 "Inga påståenden görs om endera källkods- eller binärkompatibilitet från en "
2172 "programfixversion till nästa."
2173
2174 #. (itstool) path: listitem/para
2175 #: C/index.docbook:1369
2176 msgid ""
2177 "Private - An interface that can be used within the GNOME stack itself, but "
2178 "that is not documented for end-users. Such functions should only be used in "
2179 "specified and documented ways."
2180 msgstr ""
2181 "Private - Ett gränssnitt som kan användas inom GNOME-stacken i sig, men som "
2182 "inte dokumenterats för slutanvändare. Sådana funktioner bör endast användas "
2183 "på angivna och dokumenterade sätt."
2184
2185 #. (itstool) path: listitem/para
2186 #: C/index.docbook:1378
2187 msgid ""
2188 "Internal - An interface that is internal to a module and does not require "
2189 "end-user documentation. Functions that are undocumented are assumed to be "
2190 "Internal."
2191 msgstr ""
2192 "Internal - ett gränssnitt som är internt för en modul och inte behöver "
2193 "slutanvändardokumentation. Funktioner som är odokumenterade förutsätts vara "
2194 "interna."
2195
2196 #. (itstool) path: listitem/para
2197 #: C/index.docbook:1340
2198 msgid ""
2199 "An informal description of the stability level this API has. We recommend "
2200 "the use of one of these terms: <_:itemizedlist-1/>"
2201 msgstr ""
2202 "En informell beskrivning över stabiliteten för detta API. Vi rekommenderar "
2203 "att använda en av dessa termer: <_:itemizedlist-1/>"
2204
2205 #. (itstool) path: varlistentry/term
2206 #: C/index.docbook:1390
2207 msgid "@include"
2208 msgstr "@include"
2209
2210 #. (itstool) path: listitem/para
2211 #: C/index.docbook:1392
2212 msgid ""
2213 "The <literal>#include</literal> files to show in the section synopsis (a "
2214 "comma separated list), overriding the global value from the <link "
2215 "linkend=\"metafiles_sections\">section file</link> or command line. This "
2216 "item is optional."
2217 msgstr ""
2218 "<literal>#include</literal>-filerna som ska visas i avsnittssammanfattningen "
2219 "(en kommaavgränsad lista), vilket åsidosätter det globala värdet från <link "
2220 "linkend=\"metafiles_sections\">avsnittsfilen</link> eller kommandoraden. "
2221 "Detta objekt är valfritt."
2222
2223 #. (itstool) path: varlistentry/term
2224 #: C/index.docbook:1401
2225 msgid "@image"
2226 msgstr "@image"
2227
2228 #. (itstool) path: listitem/para
2229 #: C/index.docbook:1403
2230 msgid ""
2231 "The image to display at the top of the reference page for this section. This "
2232 "will often be some sort of a diagram to illustrate the visual appearance of "
2233 "a class or a diagram of its relationship to other classes. This item is "
2234 "optional."
2235 msgstr ""
2236 "Bilden som ska visas längst upp på referenssidan för detta avsnitt. Detta "
2237 "kommer ofta att vara någon form av diagram för att illustrera det visuella "
2238 "utseendet för en klass eller ett diagram över dess relationer med andra "
2239 "klasser. Detta objekt är valfritt."
2240
2241 #. (itstool) path: tip/para
2242 #: C/index.docbook:1414
2243 msgid ""
2244 "To avoid unnecessary recompilation after doc-changes put the section docs "
2245 "into the c-source where possible."
2246 msgstr ""
2247 "För att undvika onödig omkompilering efter dokumentationsändringar, placera "
2248 "avsnittsdokumentationen i c-källkoden där möjligt."
2249
2250 #. (itstool) path: sect1/title
2251 #: C/index.docbook:1423
2252 msgid "Documenting symbols"
2253 msgstr "Dokumentationssymboler"
2254
2255 #. (itstool) path: sect1/para
2256 #: C/index.docbook:1425
2257 msgid ""
2258 "Each symbol (function, macro, struct, enum, signal and property) is "
2259 "documented in a separate block. The block is best placed close to the "
2260 "definition of the symbols so that it is easy to keep them in sync. Thus "
2261 "functions are usually documented in the c-source and macros, structs and "
2262 "enums in the header file."
2263 msgstr ""
2264 "Varje symbol (funktion, makro, struktur, uppräkning, signal och egenskap) är "
2265 "dokumenterad i ett separat block. Blocket placeras bäst intill definitionen "
2266 "av symbolerna så att det är enkelt att hålla dem synkroniserade. Därför "
2267 "dokumenteras funktioner vanligtvis i c-källkoden och makron, strukturer och "
2268 "uppräkningar i huvudfilen."
2269
2270 #. (itstool) path: sect2/title
2271 #. (itstool) path: example/title
2272 #: C/index.docbook:1433 C/index.docbook:1499
2273 msgid "General tags"
2274 msgstr "Generella taggar"
2275
2276 #. (itstool) path: sect2/para
2277 #: C/index.docbook:1435
2278 msgid ""
2279 "You can add versioning information to all documentation elements to tell "
2280 "when an API was introduced, or when it was deprecated."
2281 msgstr ""
2282 "Du kan lägga till versioneringsinformation i alla dokumentationselement för "
2283 "att berätta när ett API introducerats eller blev föråldrat."
2284
2285 #. (itstool) path: variablelist/title
2286 #: C/index.docbook:1440
2287 msgid "Versioning Tags"
2288 msgstr "Versioneringstaggar"
2289
2290 #. (itstool) path: varlistentry/term
2291 #: C/index.docbook:1441
2292 msgid "Since:"
2293 msgstr "Since:"
2294
2295 #. (itstool) path: listitem/para
2296 #: C/index.docbook:1443
2297 msgid "Description since which version of the code the API is available."
2298 msgstr ""
2299 "Beskrivning över från och med vilken version av koden som API:t är "
2300 "tillgängligt."
2301
2302 #. (itstool) path: varlistentry/term
2303 #: C/index.docbook:1448
2304 msgid "Deprecated:"
2305 msgstr "Deprecated:"
2306
2307 #. (itstool) path: listitem/para
2308 #: C/index.docbook:1450
2309 msgid ""
2310 "Paragraph denoting that this function should no be used anymore. The "
2311 "description should point the reader to the new API."
2312 msgstr ""
2313 "Stycke som betecknar att denna funktion inte bör användas längre. "
2314 "Beskrivningen bör peka läsaren vidare till det nya API:t."
2315
2316 #. (itstool) path: sect2/para
2317 #: C/index.docbook:1458
2318 msgid ""
2319 "You can also add stability information to all documentation elements to "
2320 "indicate whether API stability is guaranteed for them for all future minor "
2321 "releases of the project."
2322 msgstr ""
2323 "Du kan också lägga till stabilitetsinformation för alla "
2324 "dokumentationselement för att indikera huruvida API-stabilitet är garanterad "
2325 "för dem för alla framtida programfix-versioner av projektet."
2326
2327 #. (itstool) path: sect2/para
2328 #: C/index.docbook:1464
2329 msgid ""
2330 "The default stability level for all documentation elements can be set by "
2331 "passing the <option>--default-stability</option> argument to "
2332 "<application>gtkdoc-mkdb</application> with one of the values below."
2333 msgstr ""
2334 "Standardvärdet för stabilitetsnivån för alla dokumentations element kan "
2335 "ställas in genom att ange argumentet <option>--default-stability</option> "
2336 "till <application>gtkdoc-mkdb</application> med endera av värdena nedan."
2337
2338 #. (itstool) path: variablelist/title
2339 #: C/index.docbook:1470
2340 msgid "Stability Tags"
2341 msgstr "Stabilitetstaggar"
2342
2343 #. (itstool) path: varlistentry/term
2344 #: C/index.docbook:1471
2345 msgid "Stability: Stable"
2346 msgstr "Stability: Stable"
2347
2348 #. (itstool) path: listitem/para
2349 #: C/index.docbook:1473
2350 msgid ""
2351 "Mark the element as stable. This is for public APIs which are guaranteed to "
2352 "remain stable for all future minor releases of the project."
2353 msgstr ""
2354 "Markera elementet som stabilt. Detta är för publika API:er som är "
2355 "garanterade att hållas stabila i alla framtida programfix-versioner av "
2356 "projektet."
2357
2358 #. (itstool) path: varlistentry/term
2359 #: C/index.docbook:1480
2360 msgid "Stability: Unstable"
2361 msgstr "Stability: Unstable"
2362
2363 #. (itstool) path: listitem/para
2364 #: C/index.docbook:1482
2365 msgid ""
2366 "Mark the element as unstable. This is for public APIs which are released as "
2367 "a preview before being stabilised."
2368 msgstr ""
2369 "Markera elementet som instabilt. Detta är för publika API:er som är släppta "
2370 "på förhand innan de blivit stabiliserade."
2371
2372 #. (itstool) path: varlistentry/term
2373 #: C/index.docbook:1488
2374 msgid "Stability: Private"
2375 msgstr "Stability: Private"
2376
2377 #. (itstool) path: listitem/para
2378 #: C/index.docbook:1490
2379 msgid ""
2380 "Mark the element as private. This is for interfaces which can be used by "
2381 "tightly coupled modules, but not by arbitrary third parties."
2382 msgstr ""
2383 "Markera element som privat. Detta är avsett för gränssnitt som kan användas "
2384 "av tätt sammankopplade moduler, men inte av godtyckliga tredje parter."
2385
2386 #. (itstool) path: example/programlisting
2387 #: C/index.docbook:1500
2388 #, no-wrap
2389 msgid ""
2390 "\n"
2391 "/**\n"
2392 " * foo_get_bar:\n"
2393 " * @foo: some foo\n"
2394 " *\n"
2395 " * Retrieves @foo's bar.\n"
2396 " *\n"
2397 " * Returns: @foo's bar\n"
2398 " *\n"
2399 " * Since: 2.6\n"
2400 " * Deprecated: 2.12: Use foo_baz_get_bar() instead.\n"
2401 " */\n"
2402 "Bar *\n"
2403 "foo_get_bar(Foo *foo)\n"
2404 "{\n"
2405 "...\n"
2406 msgstr ""
2407 "\n"
2408 "/**\n"
2409 " * foo_get_bar:\n"
2410 " * @foo: någon foo\n"
2411 " *\n"
2412 " * Hämtar bar från @foo.\n"
2413 " *\n"
2414 " * Returns: bar från @foo\n"
2415 " *\n"
2416 " * Since: 2.6\n"
2417 " * Deprecated: 2.12: Använd foo_baz_get_bar() i stället.\n"
2418 " */\n"
2419 "Bar *\n"
2420 "foo_get_bar(Foo *foo)\n"
2421 "{\n"
2422 "…\n"
2423
2424 #. (itstool) path: sect2/title
2425 #. (itstool) path: example/title
2426 #: C/index.docbook:1520 C/index.docbook:1530
2427 msgid "Annotations"
2428 msgstr "Noteringar"
2429
2430 #. (itstool) path: sect2/para
2431 #: C/index.docbook:1522
2432 msgid ""
2433 "Documentation blocks can contain annotation-tags. These tags will be "
2434 "rendered with tooltips describing their meaning. The tags are used by "
2435 "GObject Introspection to generate language bindings. A detailed list of the "
2436 "supported tags can be found in the <ulink url=\"https://gi.readthedocs.io/en/"
2437 "latest/annotations/giannotations.html\" type=\"http\">GObject Introspection "
2438 "documentation</ulink>."
2439 msgstr ""
2440 "Dokumentationsblock kan innehålla noteringstaggar. Dessa taggar kommer att "
2441 "renderas med inforutor som beskriver deras syfte. Taggarna används av "
2442 "GObject Introspection för att generera språkbindningar. En detaljerad lista "
2443 "över vilka taggar som stöds hittas i <ulink url=\"https://gi.readthedocs.io/"
2444 "en/latest/annotations/giannotations.html\" type=\"http\">dokumentationen för "
2445 "GObject Introspection</ulink>."
2446
2447 #. (itstool) path: example/programlisting
2448 #: C/index.docbook:1531
2449 #, no-wrap
2450 msgid ""
2451 "\n"
2452 "/**\n"
2453 " * foo_get_bar: (annotation)\n"
2454 " * @foo: (annotation): some foo\n"
2455 " *\n"
2456 " * Retrieves @foo's bar.\n"
2457 " *\n"
2458 " * Returns: (annotation): @foo's bar\n"
2459 " */\n"
2460 "...\n"
2461 "/**\n"
2462 " * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)\n"
2463 " * (and another annotation)\n"
2464 " * @foo: (annotation) (another annotation): some foo\n"
2465 " *\n"
2466 " * Sets bar on @foo.\n"
2467 " */\n"
2468 msgstr ""
2469 "\n"
2470 "/**\n"
2471 " * foo_get_bar: (notering)\n"
2472 " * @foo: (notering): någon foo\n"
2473 " *\n"
2474 " * Hämtar bar från @foo.\n"
2475 " *\n"
2476 " * Returns: (notering): bar från @foo\n"
2477 " */\n"
2478 "...\n"
2479 "/**\n"
2480 " * foo_set_bar_using_the_frobnicator: (notering) (an annan notering)\n"
2481 " * (ytterligare en annan notering)\n"
2482 " * @foo: (notering) (en annan notering): någon foo\n"
2483 " *\n"
2484 " * Ställer in bar i @foo.\n"
2485 " */\n"
2486
2487 #. (itstool) path: sect2/title
2488 #. (itstool) path: example/title
2489 #: C/index.docbook:1552 C/index.docbook:1581
2490 msgid "Function comment block"
2491 msgstr "Kommentarsblock för funktioner"
2492
2493 #. (itstool) path: listitem/para
2494 #: C/index.docbook:1558
2495 msgid ""
2496 "Document whether returned objects, lists, strings, etc, should be freed/"
2497 "unrefed/released."
2498 msgstr ""
2499 "Dokumentera huruvida returnerade objekt, listor, strängar, etc. bör frigöras/"
2500 "avrefereras/släppas."
2501
2502 #. (itstool) path: listitem/para
2503 #: C/index.docbook:1564
2504 msgid "Document whether parameters can be NULL, and what happens if they are."
2505 msgstr ""
2506 "Dokumentera huruvida parametrar tillåts vara NULL och vad som händer om de "
2507 "är NULL."
2508
2509 #. (itstool) path: listitem/para
2510 #: C/index.docbook:1569
2511 msgid ""
2512 "Mention interesting pre-conditions and post-conditions where appropriate."
2513 msgstr "Nämn intressanta förvillkor och eftervillkor där lämpligt."
2514
2515 #. (itstool) path: sect2/para
2516 #: C/index.docbook:1554 C/index.docbook:1640
2517 msgid "Please remember to: <_:itemizedlist-1/>"
2518 msgstr "Kom ihåg att: <_:itemizedlist-1/>"
2519
2520 # sebras: Gtk-doc? GTK-Doc? gtk-doc? macros and functions?
2521 #. (itstool) path: sect2/para
2522 #: C/index.docbook:1576
2523 msgid ""
2524 "Gtk-doc assumes all symbols (macros, functions) starting with '_' are "
2525 "private. They are treated like static functions."
2526 msgstr ""
2527 "Gtk-doc förutsätter att alla symboler (makron, funktioner) som börjar med "
2528 "”_” är privata. De behandlas på samma sätt som statiska funktioner."
2529
2530 # sebras: how to translate highlight?
2531 #. (itstool) path: example/programlisting
2532 #: C/index.docbook:1582
2533 #, no-wrap
2534 msgid ""
2535 "\n"
2536 "/**\n"
2537 " * function_name:\n"
2538 " * @par1: description of parameter 1. These can extend over more than\n"
2539 " * one line.\n"
2540 " * @par2: description of parameter 2\n"
2541 " * @...: a %NULL-terminated list of bars\n"
2542 " *\n"
2543 " * The function description goes here. You can use @par1 to refer to parameters\n"
2544 " * so that they are highlighted in the output. You can also use %constant\n"
2545 " * for constants, function_name2() for functions and #GtkWidget for links to\n"
2546 " * other declarations (which may be documented elsewhere).\n"
2547 " *\n"
2548 " * Returns: an integer.\n"
2549 " *\n"
2550 " * Since: 2.2\n"
2551 " * Deprecated: 2.18: Use other_function() instead.\n"
2552 " */\n"
2553 msgstr ""
2554 "\n"
2555 "/**\n"
2556 " * funktionsnamn:\n"
2557 " * @par1: beskrivning av parameter 1. Dessa kan sträcka sig\n"
2558 " * över mer än en rad.\n"
2559 " * @par2: beskrivning av parameter 2\n"
2560 " * @...: en %NULL-terminerad lista av flera bar\n"
2561 " *\n"
2562 " * Funktionsbeskrivningen ska vara här. Du kan använda @par1 för att\n"
2563 " * referera till parametrar så att de färgmarkeras i utdata. Du kan också\n"
2564 " * använda %konstant för konstanter, funktionsnamn2() för funktioner och\n"
2565 " * #GtkWidget för länkar till andra deklarationer (vilka kan vara dokumenterade\n"
2566 " * på annat håll).\n"
2567 " *\n"
2568 " * Returns: ett heltal.\n"
2569 " *\n"
2570 " * Since: 2.2\n"
2571 " * Deprecated: 2.18: Använd annan_funktion() i stället.\n"
2572 " */\n"
2573
2574 #. (itstool) path: variablelist/title
2575 #: C/index.docbook:1603
2576 msgid "Function tags"
2577 msgstr "Funktions-taggar"
2578
2579 #. (itstool) path: varlistentry/term
2580 #: C/index.docbook:1604 C/index.docbook:1811
2581 msgid "Returns:"
2582 msgstr "Returns:"
2583
2584 #. (itstool) path: listitem/para
2585 #: C/index.docbook:1606
2586 msgid "Paragraph describing the returned result."
2587 msgstr "Stycke som beskriver det returnerade resultatet."
2588
2589 #. (itstool) path: varlistentry/term
2590 #: C/index.docbook:1611
2591 msgid "@...:"
2592 msgstr "@...:"
2593
2594 # sebras: variadic?
2595 #. (itstool) path: listitem/para
2596 #: C/index.docbook:1613
2597 msgid ""
2598 "In case the function has variadic arguments, you should use this tag "
2599 "(@Varargs: does also work for historic reasons)."
2600 msgstr ""
2601 "Om funktionen har variadiska argument bör du använda denna tagg (@Varargs: "
2602 "fungerar också på grund av historiska skäl)."
2603
2604 #. (itstool) path: sect2/title
2605 #. (itstool) path: example/title
2606 #: C/index.docbook:1623 C/index.docbook:1625
2607 msgid "Property comment block"
2608 msgstr "Kommentarsblock för egenskaper"
2609
2610 #. (itstool) path: example/programlisting
2611 #: C/index.docbook:1626
2612 #, no-wrap
2613 msgid ""
2614 "\n"
2615 "/**\n"
2616 " * SomeWidget:some-property:\n"
2617 " *\n"
2618 " * Here you can document a property.\n"
2619 " */\n"
2620 "g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);\n"
2621 msgstr ""
2622 "\n"
2623 "/**\n"
2624 " * EnKomponent:en-egenskap:\n"
2625 " *\n"
2626 " * Här kan du dokumentera en egenskap.\n"
2627 " */\n"
2628 "g_object_class_install_property (object_class, PROP_EN_EGENSKAP, …);\n"
2629
2630 #. (itstool) path: sect2/title
2631 #. (itstool) path: example/title
2632 #: C/index.docbook:1638 C/index.docbook:1657
2633 msgid "Signal comment block"
2634 msgstr "Kommentarsblock för signaler"
2635
2636 #. (itstool) path: listitem/para
2637 #: C/index.docbook:1644
2638 msgid ""
2639 "Document when the signal is emitted and whether it is emitted before or "
2640 "after other signals."
2641 msgstr ""
2642 "Dokumentera när en signal sänds ut och huruvida den sänds ut före eller "
2643 "efter andra signaler."
2644
2645 #. (itstool) path: listitem/para
2646 #: C/index.docbook:1650
2647 msgid "Document what an application might do in the signal handler."
2648 msgstr "Dokumentera vad ett program kan göra i signalhanteraren."
2649
2650 #. (itstool) path: example/programlisting
2651 #: C/index.docbook:1658
2652 #, no-wrap
2653 msgid ""
2654 "\n"
2655 "/**\n"
2656 " * FooWidget::foobarized:\n"
2657 " * @widget: the widget that received the signal\n"
2658 " * @foo: some foo\n"
2659 " * @bar: some bar\n"
2660 " *\n"
2661 " * The ::foobarized signal is emitted each time someone tries to foobarize @widget.\n"
2662 " */\n"
2663 "foo_signals[FOOBARIZED] =\n"
2664 " g_signal_new (\"foobarized\",\n"
2665 " ...\n"
2666 msgstr ""
2667 "\n"
2668 "/**\n"
2669 " * FooWidget::foobariserad:\n"
2670 " * @widget: komponenten som erhåller signalen\n"
2671 " * @foo: någon foo\n"
2672 " * @bar: någon bar\n"
2673 " *\n"
2674 " * Signalen ::foobariserad sänds ut varje gång någon försöker att foobarisera @widget.\n"
2675 " */\n"
2676 "foo_signals[FOOBARIZE] =\n"
2677 " g_signal_new (\"foobariserad\",\n"
2678 " ...\n"
2679
2680 #. (itstool) path: sect2/title
2681 #. (itstool) path: example/title
2682 #: C/index.docbook:1675 C/index.docbook:1676
2683 msgid "Struct comment block"
2684 msgstr "Kommentarsblock för strukturer"
2685
2686 #. (itstool) path: example/programlisting
2687 #: C/index.docbook:1677
2688 #, no-wrap
2689 msgid ""
2690 "\n"
2691 "/**\n"
2692 " * FooWidget:\n"
2693 " * @bar: some #gboolean\n"
2694 " *\n"
2695 " * This is the best widget, ever.\n"
2696 " */\n"
2697 "typedef struct _FooWidget {\n"
2698 " GtkWidget parent_instance;\n"
2699 "\n"
2700 " gboolean bar;\n"
2701 "} FooWidget;\n"
2702 msgstr ""
2703 "\n"
2704 "/**\n"
2705 " * FooWidget:\n"
2706 " * @bar: någon #gboolean\n"
2707 " *\n"
2708 " * Detta är den bästa komponenten någonsin.\n"
2709 " */\n"
2710 "typedef struct _FooWidget {\n"
2711 " GtkWidget parent_instance;\n"
2712 "\n"
2713 " gboolean bar;\n"
2714 "} FooWidget;\n"
2715
2716 #. (itstool) path: sect2/para
2717 #: C/index.docbook:1692
2718 msgid ""
2719 "Use <code>/*&lt; private &gt;*/</code> before the private struct fields you "
2720 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2721 "behaviour."
2722 msgstr ""
2723 "Använd<code>/*&lt; private &gt;*/</code> före privata strukturfält som du "
2724 "vill gömma. Använd <code>/*&lt; public &gt;*/</code> för det omvända "
2725 "beteendet."
2726
2727 #. (itstool) path: sect2/para
2728 #: C/index.docbook:1698
2729 msgid ""
2730 "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" "
2731 "it will be considered private automatically and doesn't need to be mentioned "
2732 "in the comment block."
2733 msgstr ""
2734 "Om det första fältet är ”g_iface”, ”parent_instance” eller ”parent_class” "
2735 "kommer det att anses vara privat automatiskt och behöver inte nämnas i "
2736 "kommentarsblocket."
2737
2738 #. (itstool) path: sect2/para
2739 #: C/index.docbook:1704
2740 msgid ""
2741 "Struct comment blocks can also be used for GObjects and GObjectClasses. It "
2742 "is usually a good idea to add a comment block for a class, if it has "
2743 "vmethods (as this is how they can be documented). For the GObject itself one "
2744 "can use the related section docs, having a separate block for the instance "
2745 "struct would be useful if the instance has public fields. One disadvantage "
2746 "here is that this creates two index entries of the same name (the structure "
2747 "and the section)."
2748 msgstr ""
2749 "Kommentarsblock för strukturer kan också användas för GObject och "
2750 "GObjectClass. Det är vanligtvis en bra idé att lägga till ett "
2751 "kommentarsblock för en klass om den har virtuella metoder (då detta är "
2752 "sättet på vilket de kan dokumenteras). För GObject i sig kan man använda den "
2753 "relaterade avsnittsdokumentationen, och ha ett separat block för varje "
2754 "instansstruktur vore användbart om instansen har publika fält. En nackdel "
2755 "här är att det skapar två indexposter med samma namn (strukturen och "
2756 "avsnittet)."
2757
2758 #. (itstool) path: sect2/title
2759 #. (itstool) path: example/title
2760 #: C/index.docbook:1716 C/index.docbook:1717
2761 msgid "Enum comment block"
2762 msgstr "Kommentarsblock för uppräkningar"
2763
2764 #. (itstool) path: example/programlisting
2765 #: C/index.docbook:1718
2766 #, no-wrap
2767 msgid ""
2768 "\n"
2769 "/**\n"
2770 " * Something:\n"
2771 " * @SOMETHING_FOO: something foo\n"
2772 " * @SOMETHING_BAR: something bar\n"
2773 " *\n"
2774 " * Enum values used for the thing, to specify the thing.\n"
2775 " */\n"
2776 "typedef enum {\n"
2777 " SOMETHING_FOO,\n"
2778 " SOMETHING_BAR,\n"
2779 " /*&lt; private &gt;*/\n"
2780 " SOMETHING_COUNT\n"
2781 "} Something;\n"
2782 msgstr ""
2783 "\n"
2784 "/**\n"
2785 " * Something:\n"
2786 " * @SOMETHING_FOO: någonting foo\n"
2787 " * @SOMETHING_BAR: någonting bar\n"
2788 " *\n"
2789 " * Uppräkningsvärden som används för saken, för att specificera saken.\n"
2790 " */\n"
2791 "typedef enum {\n"
2792 " SOMETHING_FOO,\n"
2793 " SOMETHING_BAR,\n"
2794 " /*&lt; private &gt;*/\n"
2795 " SOMETHING_COUNT\n"
2796 "} Something;\n"
2797
2798 #. (itstool) path: sect2/para
2799 #: C/index.docbook:1735
2800 msgid ""
2801 "Use <code>/*&lt; private &gt;*/</code> before the private enum values you "
2802 "want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse "
2803 "behaviour."
2804 msgstr ""
2805 "Använd <code>/*&lt; private &gt;*/</code> före privata uppräkningsvärden som "
2806 "du vill gömma. Använd <code>/*&lt; public &gt;*/</code> för det omvända "
2807 "beteendet."
2808
2809 #. (itstool) path: sect1/title
2810 #: C/index.docbook:1746
2811 msgid "Inline program documentation"
2812 msgstr "Infogad programdokumentation"
2813
2814 # sebras: how to translate inline?
2815 #. (itstool) path: sect1/para
2816 #: C/index.docbook:1747
2817 msgid ""
2818 "You can document programs and their commandline interface using inline "
2819 "documentation."
2820 msgstr ""
2821 "Du kan dokumentera program och deras kommandoradsgränssnitt med infogad "
2822 "dokumentation."
2823
2824 #. (itstool) path: variablelist/title
2825 #: C/index.docbook:1753
2826 msgid "Tags"
2827 msgstr "Taggar"
2828
2829 #. (itstool) path: varlistentry/term
2830 #: C/index.docbook:1755
2831 msgid "PROGRAM"
2832 msgstr "PROGRAM"
2833
2834 #. (itstool) path: listitem/para
2835 #: C/index.docbook:1758
2836 msgid "Defines the start of a program documentation."
2837 msgstr "Definierar början av programdokumentationen."
2838
2839 #. (itstool) path: varlistentry/term
2840 #: C/index.docbook:1765
2841 msgid "@short_description:"
2842 msgstr "@short_description:"
2843
2844 #. (itstool) path: listitem/para
2845 #: C/index.docbook:1767
2846 msgid "Defines a short description of the program. (Optional)"
2847 msgstr "Definierar en kort beskrivning av programmet. (Valfritt)"
2848
2849 #. (itstool) path: varlistentry/term
2850 #: C/index.docbook:1774
2851 msgid "@synopsis:"
2852 msgstr "@synopsis:"
2853
2854 #. (itstool) path: listitem/para
2855 #: C/index.docbook:1776
2856 msgid ""
2857 "Defines the arguments, or list of arguments that the program can take. "
2858 "(Optional)"
2859 msgstr ""
2860 "Definierar argumenten, eller en lista av argument som programmet kan ta. "
2861 "(Valfritt)"
2862
2863 #. (itstool) path: varlistentry/term
2864 #: C/index.docbook:1784
2865 msgid "@see_also:"
2866 msgstr "@see_also:"
2867
2868 #. (itstool) path: listitem/para
2869 #: C/index.docbook:1786
2870 msgid "See Also manual page section. (Optional)"
2871 msgstr "Se vidare i manualavsnitt. (Valfritt)"
2872
2873 #. (itstool) path: varlistentry/term
2874 #: C/index.docbook:1793
2875 msgid "@arg:"
2876 msgstr "@arg:"
2877
2878 #. (itstool) path: listitem/para
2879 #: C/index.docbook:1795
2880 msgid "Argument(s) passed to the program and their description. (Optional)"
2881 msgstr ""
2882 "Argument som skickas vidare till programmet och deras beskrivningar. "
2883 "(Valfritt)"
2884
2885 #. (itstool) path: varlistentry/term
2886 #: C/index.docbook:1802
2887 msgid "Description:"
2888 msgstr "Beskrivning:"
2889
2890 #. (itstool) path: listitem/para
2891 #: C/index.docbook:1804
2892 msgid "A longer description of the program."
2893 msgstr "En längre beskrivning av programmet."
2894
2895 #. (itstool) path: listitem/para
2896 #: C/index.docbook:1813
2897 msgid "Specify what value(s) the program returns. (Optional)"
2898 msgstr "Ange vilka värden programmet returnerar. (Valfritt)"
2899
2900 #. (itstool) path: sect2/title
2901 #: C/index.docbook:1822
2902 msgid "Example of program documentation."
2903 msgstr "Exempel på programdokumentation."
2904
2905 #. (itstool) path: example/title
2906 #: C/index.docbook:1823
2907 msgid "Program documentation block"
2908 msgstr "Dokumentationsblock för program"
2909
2910 #. (itstool) path: example/programlisting
2911 #: C/index.docbook:1824
2912 #, no-wrap
2913 msgid ""
2914 "\n"
2915 "/**\n"
2916 " * PROGRAM:test-program\n"
2917 " * @short_description: A test program\n"
2918 " * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*\n"
2919 " * @see_also: test(1)\n"
2920 " * @--arg1 *arg*: set arg1 to *arg*\n"
2921 " * @--arg2 *arg*: set arg2 to *arg*\n"
2922 " * @-v, --version: Print the version number\n"
2923 " * @-h, --help: Print the help message\n"
2924 " *\n"
2925 " * Long description of program.\n"
2926 " *\n"
2927 " * Returns: Zero on success, non-zero on failure\n"
2928 " */\n"
2929 "int main(int argc, char *argv[])\n"
2930 "{\n"
2931 "\treturn 0;\n"
2932 "}\n"
2933 msgstr ""
2934 "\n"
2935 "/**\n"
2936 " * PROGRAM:test-program\n"
2937 " * @short_description: Ett testprogram\n"
2938 " * @synopsis: test-program [*FLAGGOR*...] --arg1 *arg* *FIL*\n"
2939 " * @see_also: test(1)\n"
2940 " * @--arg1 *arg*: ställ in arg1 på *arg*\n"
2941 " * @--arg2 *arg*: ställ in arg2 på *arg*\n"
2942 " * @-v, --version: Skriv ut versionsinformation\n"
2943 " * @-h, --help: Skriv ut hjälpmeddelandet\n"
2944 " *\n"
2945 " * En längre beskrivning av programmet.\n"
2946 " *\n"
2947 " * Returns: Noll vid framgång, icke-noll vid fel\n"
2948 " */\n"
2949 "int main(int argc, char *argv[])\n"
2950 "{\n"
2951 "\treturn 0;\n"
2952 "}\n"
2953
2954 #. (itstool) path: sect1/title
2955 #: C/index.docbook:1850
2956 msgid "Useful DocBook tags"
2957 msgstr "Användbara DocBook-taggar"
2958
2959 #. (itstool) path: sect1/para
2960 #: C/index.docbook:1852
2961 msgid ""
2962 "Here are some DocBook tags which are most useful when documenting the code."
2963 msgstr ""
2964 "Här är några DocBook-taggar som är användbara när man dokumenterar koden."
2965
2966 #. (itstool) path: informalexample/programlisting
2967 #: C/index.docbook:1861
2968 #, no-wrap
2969 msgid ""
2970 "\n"
2971 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hash Tables&lt;/link&gt;\n"
2972 msgstr ""
2973 "\n"
2974 "&lt;link linkend=\"glib-Hash-Tables\"&gt;Hashtabeller&lt;/link&gt;\n"
2975
2976 #. (itstool) path: sect1/para
2977 #: C/index.docbook:1857
2978 msgid ""
2979 "To link to another section in the GTK docs: <_:informalexample-1/> The "
2980 "linkend is the SGML/XML id on the top item of the page you want to link to. "
2981 "For most pages this is currently the part (\"gtk\", \"gdk\", \"glib\") and "
2982 "then the page title (\"Hash Tables\"). For widgets it is just the class "
2983 "name. Spaces and underscores are converted to '-' to conform to SGML/XML."
2984 msgstr ""
2985 "För att länka till ett annat avsnitt i GTK-dokumentationen: "
2986 "<_:informalexample-1/> Länkslutet är XGML/XML-id:t för toppnivåobjektet på "
2987 "sidan du vill länka till. För de flesta sidorna är detta för närvarande "
2988 "delen (”gtk”, ”gdk”, ”glib”) och sedan sidans titel (”Hashtabeller”). För "
2989 "komponenter är detta helt enkelt klassnamnet. Blanksteg och understreck "
2990 "konverteras till ”-” för att överensstämma med SGML/XML."
2991
2992 #. (itstool) path: informalexample/programlisting
2993 #: C/index.docbook:1874
2994 #, no-wrap
2995 msgid ""
2996 "\n"
2997 "&lt;function&gt;...&lt;/function&gt;\n"
2998 msgstr ""
2999 "\n"
3000 "&lt;function&gt;…&lt;/function&gt;\n"
3001
3002 #. (itstool) path: sect1/para
3003 #: C/index.docbook:1871
3004 msgid ""
3005 "To refer to an external function, e.g. a standard C function: "
3006 "<_:informalexample-1/>"
3007 msgstr ""
3008 "För att referera till en extern funktion, t.ex. en standardfunktion i C: "
3009 "<_:informalexample-1/>"
3010
3011 #. (itstool) path: informalexample/programlisting
3012 #: C/index.docbook:1883
3013 #, no-wrap
3014 msgid ""
3015 "\n"
3016 "&lt;example&gt;\n"
3017 " &lt;title&gt;Using a GHashTable.&lt;/title&gt;\n"
3018 " &lt;programlisting language=\"C\"&gt;\n"
3019 " ...\n"
3020 " &lt;/programlisting&gt;\n"
3021 "&lt;/example&gt;\n"
3022 msgstr ""
3023 "\n"
3024 "&lt;example&gt;\n"
3025 " &lt;title&gt;Att använda en GHashTable.&lt;/title&gt;\n"
3026 " &lt;programlisting language=\"C\"&gt;\n"
3027 " ...\n"
3028 " &lt;/programlisting&gt;\n"
3029 "&lt;/example&gt;\n"
3030
3031 #. (itstool) path: informalexample/programlisting
3032 #: C/index.docbook:1894
3033 #, no-wrap
3034 msgid ""
3035 "\n"
3036 "&lt;informalexample&gt;\n"
3037 " &lt;programlisting language=\"C\"&gt;\n"
3038 " ...\n"
3039 " &lt;/programlisting&gt;\n"
3040 "&lt;/informalexample&gt;\n"
3041 msgstr ""
3042 "\n"
3043 "&lt;informalexample&gt;\n"
3044 " &lt;programlisting language=\"C\"&gt;\n"
3045 " ...\n"
3046 " &lt;/programlisting&gt;\n"
3047 "&lt;/informalexample&gt;\n"
3048
3049 #. (itstool) path: informalexample/programlisting
3050 #: C/index.docbook:1906
3051 #, no-wrap
3052 msgid ""
3053 "\n"
3054 "|[&lt;!-- language=\"C\" --&gt;\n"
3055 " ...\n"
3056 "]|\n"
3057 msgstr ""
3058 "\n"
3059 "|[&lt;!-- language=\"C\" --&gt;\n"
3060 " ...\n"
3061 "]|\n"
3062
3063 #. (itstool) path: sect1/para
3064 #: C/index.docbook:1880
3065 msgid ""
3066 "To include example code: <_:informalexample-1/> or possibly this, for very "
3067 "short code fragments which don't need a title: <_:informalexample-2/> In "
3068 "both cases, the language attribute is optional and is used as a hint to the "
3069 "syntax highlighting engine (pygments for html output). For the latter GTK-"
3070 "Doc also supports an abbreviation: <_:informalexample-3/>"
3071 msgstr ""
3072 "För att inkludera exempelkod: <_:informalexample-1/> eller möjligen "
3073 "följande, för väldigt korta kodfragment som inte behöver en titel: "
3074 "<_:informalexample-2/> I båda fallen är språkattributet valfritt och används "
3075 "som ett tips för syntaxmarkeringsmotorn (pygments för html-utmatning). För "
3076 "det senare fallet har GTK-Doc också stöd för en förkortning: "
3077 "<_:informalexample-3/>"
3078
3079 #. (itstool) path: informalexample/programlisting
3080 #: C/index.docbook:1917
3081 #, no-wrap
3082 msgid ""
3083 "\n"
3084 "&lt;itemizedlist&gt;\n"
3085 " &lt;listitem&gt;\n"
3086 " &lt;para&gt;\n"
3087 " ...\n"
3088 " &lt;/para&gt;\n"
3089 " &lt;/listitem&gt;\n"
3090 " &lt;listitem&gt;\n"
3091 " &lt;para&gt;\n"
3092 " ...\n"
3093 " &lt;/para&gt;\n"
3094 " &lt;/listitem&gt;\n"
3095 "&lt;/itemizedlist&gt;\n"
3096 msgstr ""
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
3111 #. (itstool) path: sect1/para
3112 #: C/index.docbook:1914
3113 msgid "To include bulleted lists: <_:informalexample-1/>"
3114 msgstr "För att inkludera punktlistor: <_:informalexample-1/>"
3115
3116 #. (itstool) path: informalexample/programlisting
3117 #: C/index.docbook:1937
3118 #, no-wrap
3119 msgid ""
3120 "\n"
3121 "&lt;note&gt;\n"
3122 " &lt;para&gt;\n"
3123 " Make sure you free the data after use.\n"
3124 " &lt;/para&gt;\n"
3125 "&lt;/note&gt;\n"
3126 msgstr ""
3127 "\n"
3128 "&lt;note&gt;\n"
3129 " &lt;para&gt;\n"
3130 " Säkerställ att du frigjort data efter användning.\n"
3131 " &lt;/para&gt;\n"
3132 "&lt;/note&gt;\n"
3133
3134 #. (itstool) path: sect1/para
3135 #: C/index.docbook:1934
3136 msgid ""
3137 "To include a note which stands out from the text: <_:informalexample-1/>"
3138 msgstr ""
3139 "För att inkludera en not som skiljer sig från texten: <_:informalexample-1/>"
3140
3141 #. (itstool) path: informalexample/programlisting
3142 #: C/index.docbook:1950
3143 #, no-wrap
3144 msgid ""
3145 "\n"
3146 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3147 msgstr ""
3148 "\n"
3149 "&lt;type&gt;unsigned char&lt;/type&gt;\n"
3150
3151 #. (itstool) path: sect1/para
3152 #: C/index.docbook:1947
3153 msgid "To refer to a type: <_:informalexample-1/>"
3154 msgstr "För att refera till en typ: <_:informalexample-1/>"
3155
3156 #. (itstool) path: informalexample/programlisting
3157 #: C/index.docbook:1959
3158 #, no-wrap
3159 msgid ""
3160 "\n"
3161 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3162 msgstr ""
3163 "\n"
3164 "&lt;structname&gt;XFontStruct&lt;/structname&gt;\n"
3165
3166 #. (itstool) path: sect1/para
3167 #: C/index.docbook:1956
3168 msgid ""
3169 "To refer to an external structure (not one described in the GTK docs): "
3170 "<_:informalexample-1/>"
3171 msgstr ""
3172 "För att referera till en extern struktur (som inte beskrivs i GTK-"
3173 "dokumentationen): <_:informalexample-1/>"
3174
3175 #. (itstool) path: informalexample/programlisting
3176 #: C/index.docbook:1968
3177 #, no-wrap
3178 msgid ""
3179 "\n"
3180 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3181 msgstr ""
3182 "\n"
3183 "&lt;structfield&gt;len&lt;/structfield&gt;\n"
3184
3185 #. (itstool) path: sect1/para
3186 #: C/index.docbook:1965
3187 msgid "To refer to a field of a structure: <_:informalexample-1/>"
3188 msgstr "För att referera till ett fält för en struktur: <_:informalexample-1/>"
3189
3190 #. (itstool) path: informalexample/programlisting
3191 #: C/index.docbook:1977
3192 #, no-wrap
3193 msgid ""
3194 "\n"
3195 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3196 msgstr ""
3197 "\n"
3198 "&lt;classname&gt;GtkWidget&lt;/classname&gt;\n"
3199
3200 #. (itstool) path: sect1/para
3201 #: C/index.docbook:1974
3202 msgid ""
3203 "To refer to a class name, we could possibly use: <_:informalexample-1/> but "
3204 "you'll probably be using #GtkWidget instead (to automatically create a link "
3205 "to the GtkWidget page - see <link linkend=\"documenting_syntax\">the "
3206 "abbreviations</link>)."
3207 msgstr ""
3208 "För att referera till ett klassnamn kan vi möjligen använda: "
3209 "<_:informalexample-1/> men du kommer troligt att använda #GtkWidget i "
3210 "stället (för att automatiskt skapa en länk till GtkWidget-sidan - se <link "
3211 "linkend=\"documenting_syntax\">förkortningarna</link>)."
3212
3213 #. (itstool) path: informalexample/programlisting
3214 #: C/index.docbook:1988
3215 #, no-wrap
3216 msgid ""
3217 "\n"
3218 "&lt;emphasis&gt;This is important&lt;/emphasis&gt;\n"
3219 msgstr ""
3220 "\n"
3221 "&lt;emphasis&gt;Detta är viktigt&lt;/emphasis&gt;\n"
3222
3223 #. (itstool) path: sect1/para
3224 #: C/index.docbook:1985
3225 msgid "To emphasize text: <_:informalexample-1/>"
3226 msgstr "För att betona text: <_:informalexample-1/>"
3227
3228 #. (itstool) path: informalexample/programlisting
3229 #: C/index.docbook:1997
3230 #, no-wrap
3231 msgid ""
3232 "\n"
3233 "&lt;filename&gt;/home/user/documents&lt;/filename&gt;\n"
3234 msgstr ""
3235 "\n"
3236 "&lt;filename&gt;/home/användare/dokument&lt;/filename&gt;\n"
3237
3238 #. (itstool) path: sect1/para
3239 #: C/index.docbook:1994
3240 msgid "For filenames use: <_:informalexample-1/>"
3241 msgstr "För filnamn använd: <_:informalexample-1/>"
3242
3243 #. (itstool) path: informalexample/programlisting
3244 #: C/index.docbook:2006
3245 #, no-wrap
3246 msgid ""
3247 "\n"
3248 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3249 msgstr ""
3250 "\n"
3251 "&lt;keycombo&gt;&lt;keycap&gt;Control&lt;/keycap&gt;&lt;keycap&gt;L&lt;/keycap&gt;&lt;/keycombo&gt;\n"
3252
3253 #. (itstool) path: sect1/para
3254 #: C/index.docbook:2003
3255 msgid "To refer to keys use: <_:informalexample-1/>"
3256 msgstr "För att referera till tangenter använd: <_:informalexample-1/>"
3257
3258 #. (itstool) path: chapter/title
3259 #: C/index.docbook:2016
3260 msgid "Filling the extra files"
3261 msgstr "Fylla i de extra filerna"
3262
3263 #. (itstool) path: chapter/para
3264 #: C/index.docbook:2018
3265 msgid ""
3266 "There are a couple of extra files, that need to be maintained along with the "
3267 "inline source code comments: <filename>&lt;package&gt;.types</filename>, "
3268 "<filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), "
3269 "<filename>&lt;package&gt;-sections.txt</filename>."
3270 msgstr ""
3271 "Det finns ett antal extra filer som behöver underhållas tillsammans med de "
3272 "infogade källkodskommentarerna: <filename>&lt;paket&gt;.types</filename>, "
3273 "<filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), "
3274 "<filename>&lt;paket&gt;-sections.txt</filename>."
3275
3276 #. (itstool) path: sect1/title
3277 #: C/index.docbook:2027
3278 msgid "Editing the types file"
3279 msgstr "Redigera typfilen"
3280
3281 #. (itstool) path: sect1/para
3282 #: C/index.docbook:2029
3283 msgid ""
3284 "If your library or application includes GObjects, you want their signals, "
3285 "arguments/parameters and position in the hierarchy to be shown in the "
3286 "documentation. All you need to do, is to list the <function>xxx_get_type</"
3287 "function> functions together with their include inside the "
3288 "<filename>&lt;package&gt;.types</filename> file."
3289 msgstr ""
3290 "Om ditt bibliotek eller program inkluderar GObject så kommer du att vilja "
3291 "att deras signaler, argument/parametrar och position i hierarkin visas i "
3292 "dokumentationen. Allt du behöver göra är att lista <function>xxx_get_type</"
3293 "function>-funktionerna tillsammans med deras huvudfil i filen "
3294 "<filename>&lt;paket&gt;.types</filename>."
3295
3296 #. (itstool) path: example/title
3297 #: C/index.docbook:2038
3298 msgid "Example &lt;package&gt;.types file"
3299 msgstr "Exempel på filen &lt;paket&gt;.types"
3300
3301 #. (itstool) path: example/programlisting
3302 #: C/index.docbook:2039
3303 #, no-wrap
3304 msgid ""
3305 "\n"
3306 "#include &lt;gtk/gtk.h&gt;\n"
3307 "\n"
3308 "gtk_accel_label_get_type\n"
3309 "gtk_adjustment_get_type\n"
3310 "gtk_alignment_get_type\n"
3311 "gtk_arrow_get_type\n"
3312 msgstr ""
3313 "\n"
3314 "#include &lt;gtk/gtk.h&gt;\n"
3315 "\n"
3316 "gtk_accel_label_get_type\n"
3317 "gtk_adjustment_get_type\n"
3318 "gtk_alignment_get_type\n"
3319 "gtk_arrow_get_type\n"
3320
3321 #. (itstool) path: sect1/para
3322 #: C/index.docbook:2050
3323 msgid ""
3324 "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this "
3325 "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in "
3326 "<filename>Makefile.am</filename>. If you use this approach you should not "
3327 "dist the types file nor have it under version control."
3328 msgstr ""
3329 "Sedan GTK-Doc 1.8 kan <application>gtkdoc-scan</application> generera denna "
3330 "lista åt dig. Lägg bara till ”--rebuild-types” i SCAN_OPTIONS i "
3331 "<filename>Makefile.am</filename>. Om du använder detta tillvägagångssätt bör "
3332 "du inte distribuera typfilen eller versionshantera den."
3333
3334 #. (itstool) path: sect1/title
3335 #: C/index.docbook:2059
3336 msgid "Editing the master document"
3337 msgstr "Redigera huvuddokumentet"
3338
3339 #. (itstool) path: sect1/para
3340 #: C/index.docbook:2061
3341 msgid ""
3342 "GTK-Doc produces documentation in DocBook SGML/XML. When processing the "
3343 "inline source comments, the GTK-Doc tools generate one documentation page "
3344 "per class or module as a separate file. The master document includes them "
3345 "and place them in an order."
3346 msgstr ""
3347 "GTK-Doc producerar dokumentation i DocBook SGML/XML. När infogade "
3348 "källkodskommentarer behandlas genererar GTK-Doc en dokumentationssida per "
3349 "klass eller modul som en separat fil. Huvuddokumentet inkluderar dem och "
3350 "placerar dem i en ordning."
3351
3352 # sebras: Its -> it's
3353 #. (itstool) path: sect1/para
3354 #: C/index.docbook:2068
3355 msgid ""
3356 "While GTK-Doc creates a template master document for you, later runs will "
3357 "not touch it again. This means that one can freely structure the "
3358 "documentation. That includes grouping pages and adding extra pages. GTK-Doc "
3359 "has now a test suite, where also the master-document is recreated from "
3360 "scratch. Its a good idea to look at this from time to time to see if there "
3361 "are some new goodies introduced there."
3362 msgstr ""
3363 "Även om GTK-Doc skapar en mall för huvuddokumentet åt dig kommer senare "
3364 "körningar inte att röra det igen. Detta innebär att man är fri att "
3365 "strukturera om dokumentationen. Detta inkluderar att gruppera sidor och "
3366 "lägga till extra sidor. GTK-Doc har numera en testsvit där också "
3367 "huvuddokumentet återskapas från grunden. Det är en bra idé att titta på "
3368 "detta då och då för att se om några nya godsaker införts där."
3369
3370 # sebras: for -> from Apart -> together/embedded...
3371 #. (itstool) path: tip/para
3372 #: C/index.docbook:2078
3373 msgid ""
3374 "Do not create tutorials as extra documents. Just write extra chapters. The "
3375 "benefit of directly embedding the tutorial for your library into the API "
3376 "documentation is that it is easy to link for the tutorial to symbol "
3377 "documentation. Apart chances are higher that the tutorial gets updates along "
3378 "with the library."
3379 msgstr ""
3380 "Skapa inte handledningar som extra dokument. Skriv bara extra kapitel. "
3381 "Fördelen med att bädda in handledningen direkt i ditt biblioteks "
3382 "gränssnittsdokumentation är att det är enkelt att länka från handledningen "
3383 "till symboldokumentationen. Inbäddad är det större chans att handledningen "
3384 "blir uppdaterad tillsammans med biblioteket."
3385
3386 #. (itstool) path: sect1/para
3387 #: C/index.docbook:2087
3388 msgid ""
3389 "So what are the things to change inside the master document? For a start is "
3390 "only a little. There are some placeholders (text in square brackets) there "
3391 "which you should take care of."
3392 msgstr ""
3393 "Så vilka saker ska ändras i huvuddokumentet? I början är det väldigt lite. "
3394 "Det finns en del platshållare (text i hakparenteser) som du bör ta hand om."
3395
3396 #. (itstool) path: example/title
3397 #: C/index.docbook:2094
3398 msgid "Master document header"
3399 msgstr "Huvuddokumentets huvud"
3400
3401 #. (itstool) path: example/programlisting
3402 #: C/index.docbook:2095
3403 #, no-wrap
3404 msgid ""
3405 "\n"
3406 "&lt;bookinfo&gt;\n"
3407 " &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;\n"
3408 " &lt;releaseinfo&gt;\n"
3409 " for MODULENAME [VERSION]\n"
3410 " The latest version of this documentation can be found on-line at\n"
3411 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULENAME/index.html\"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.\n"
3412 " &lt;/releaseinfo&gt;\n"
3413 "&lt;/bookinfo&gt;\n"
3414 "\n"
3415 "&lt;chapter&gt;\n"
3416 " &lt;title&gt;[Insert title here]&lt;/title&gt;\n"
3417 msgstr ""
3418 "\n"
3419 "&lt;bookinfo&gt;\n"
3420 " &lt;title&gt;MODULNAMN handbok&lt;/title&gt;\n"
3421 " &lt;releaseinfo&gt;\n"
3422 " för MODULNAMN [VERSION]\n"
3423 " Den senaste versionen av detta dokument kan hittas på nätet på\n"
3424 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/MODULNAMN/index.html\"&gt;http://[SERVER]/MODULNAMN/&lt;/ulink&gt;.\n"
3425 " &lt;/releaseinfo&gt;\n"
3426 "&lt;/bookinfo&gt;\n"
3427 "\n"
3428 "&lt;chapter&gt;\n"
3429 " &lt;title&gt;[Infoga titel här]&lt;/title&gt;\n"
3430
3431 #. (itstool) path: sect1/para
3432 #: C/index.docbook:2111
3433 msgid ""
3434 "In addition a few option elements are created in commented form. You can "
3435 "review these and enable them as you like."
3436 msgstr ""
3437 "Dessutom finns det ett antal valfria element som skapas i kommenterad form. "
3438 "Du kan granska dessa och aktivera dem enligt dina egna önskemål."
3439
3440 #. (itstool) path: example/title
3441 #: C/index.docbook:2117
3442 msgid "Optional part in the master document"
3443 msgstr "Valfri del i huvuddokumentet"
3444
3445 #. (itstool) path: example/programlisting
3446 #: C/index.docbook:2118
3447 #, no-wrap
3448 msgid ""
3449 "\n"
3450 " &lt;!-- enable this when you use gobject introspection annotations\n"
3451 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3452 " --&gt;\n"
3453 msgstr ""
3454 "\n"
3455 " &lt;!-- aktivera detta om du vill använda gobject introspection-noteringar\n"
3456 " &lt;xi:include href=\"xml/annotation-glossary.xml\"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;\n"
3457 " --&gt;\n"
3458
3459 #. (itstool) path: sect1/para
3460 #: C/index.docbook:2126
3461 msgid ""
3462 "Finally you need to add new section whenever you introduce one. The <link "
3463 "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind "
3464 "you of newly generated xml files that are not yet included into the doc."
3465 msgstr ""
3466 "Slutligen behöver du lägga till ett nytt avsnitt när du infogar det. "
3467 "Verktyget <link linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> "
3468 "kommer att påminna dig om nyligen genererade xml-filer som ännu inte "
3469 "infogats i dokumentationen."
3470
3471 #. (itstool) path: example/title
3472 #: C/index.docbook:2134 C/index.docbook:2169
3473 msgid "Including generated sections"
3474 msgstr "Inkludera genererade avsnitt"
3475
3476 #. (itstool) path: example/programlisting
3477 #: C/index.docbook:2135
3478 #, no-wrap
3479 msgid ""
3480 "\n"
3481 " &lt;chapter&gt;\n"
3482 " &lt;title&gt;my library&lt;/title&gt;\n"
3483 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3484 " ...\n"
3485 msgstr ""
3486 "\n"
3487 " &lt;chapter&gt;\n"
3488 " &lt;title&gt;mitt bibliotek&lt;/title&gt;\n"
3489 " &lt;xi:include href=\"xml/object.xml\"/&gt;\n"
3490 " ...\n"
3491
3492 #. (itstool) path: sect1/title
3493 #: C/index.docbook:2147
3494 msgid "Editing the section file"
3495 msgstr "Redigera avsnittsfilen"
3496
3497 #. (itstool) path: sect1/para
3498 #: C/index.docbook:2149
3499 msgid ""
3500 "The section file is used to organise the documentation output by GTK-Doc. "
3501 "Here one specifies which symbol belongs to which module or class and control "
3502 "the visibility (public or private)."
3503 msgstr ""
3504 "Avsnittsfilen används för att organisera dokumentationsutdata från GTK-Doc. "
3505 "Här kan man ange vilken symbol som hör till vilken modul eller klass och "
3506 "styra synligheten (publik eller privat)."
3507
3508 #. (itstool) path: sect1/para
3509 #: C/index.docbook:2155
3510 msgid ""
3511 "The section file is a plain text file with tags delimiting sections. Blank "
3512 "lines are ignored and lines starting with a '#' are treated as comment lines."
3513 msgstr ""
3514 "Avsnittsfilen är en vanlig textfil med taggar som avgränsar avsnitt. "
3515 "Blankrader ignoreras och rader som börjar med ett ”#” behandlas som "
3516 "kommentarsrader."
3517
3518 #. (itstool) path: note/para
3519 #: C/index.docbook:2162
3520 msgid ""
3521 "While the tags make the file look like xml, it is not. Please do not close "
3522 "tags like &lt;SUBSECTION&gt;."
3523 msgstr ""
3524 "Även om taggarna får filen att se ut som xml, är det inte det. Avsluta inte "
3525 "taggar så som &lt;SUBSECTION&gt;."
3526
3527 #. (itstool) path: example/programlisting
3528 #: C/index.docbook:2170
3529 #, no-wrap
3530 msgid ""
3531 "\n"
3532 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3533 "\n"
3534 "&lt;SECTION&gt;\n"
3535 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3536 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3537 "MeepApp\n"
3538 "&lt;SUBSECTION Standard&gt;\n"
3539 "MEEP_APP\n"
3540 "...\n"
3541 "MeepAppClass\n"
3542 "meep_app_get_type\n"
3543 "&lt;/SECTION&gt;\n"
3544 msgstr ""
3545 "\n"
3546 "&lt;INCLUDE&gt;libmeep/meep.h&lt;/INCLUDE&gt;\n"
3547 "\n"
3548 "&lt;SECTION&gt;\n"
3549 "&lt;FILE&gt;meepapp&lt;/FILE&gt;\n"
3550 "&lt;TITLE&gt;MeepApp&lt;/TITLE&gt;\n"
3551 "MeepApp\n"
3552 "&lt;SUBSECTION Standard&gt;\n"
3553 "MEEP_APP\n"
3554 "...\n"
3555 "MeepAppClass\n"
3556 "meep_app_get_type\n"
3557 "&lt;/SECTION&gt;\n"
3558
3559 #. (itstool) path: sect1/para
3560 #: C/index.docbook:2187
3561 msgid ""
3562 "The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, "
3563 "without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/"
3564 "FILE&gt;' will result in the section declarations being output in the "
3565 "template file <filename>tmpl/gnome-config.sgml</filename>, which will be "
3566 "converted into the DocBook XML file <filename>xml/gnome-config.sgml</"
3567 "filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. "
3568 "(The name of the HTML file is based on the module name and the section "
3569 "title, or for GObjects it is based on the GObjects class name converted to "
3570 "lower case)."
3571 msgstr ""
3572 "Taggen &lt;FILE&gt; … &lt;/FILE&gt; används för att ange filnamnet, utan "
3573 "något suffix. Om man t.ex. använder ”&lt;FILE&gt;gnome-config&lt;/FILE&gt;” "
3574 "blir resultatet att avsnittsdeklarationerna matas ut i mallfilen "
3575 "<filename>tmpl/gnome-config.sgml</filename>, som kommer att konverteras till "
3576 "DocBook XML-filen <filename>xml/gnome-config.sgml</filename> eller DocBook "
3577 "XML-filen <filename>xml/gnome-config.xml</filename>. (Namnet på HTML-filen "
3578 "baseras på modulnamnet och avsnittstiteln, för GObject baseras det på "
3579 "klassnamnet för GObjectet konverterat till gemener)."
3580
3581 #. (itstool) path: sect1/para
3582 #: C/index.docbook:2199
3583 msgid ""
3584 "The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the "
3585 "section. It is only useful before the templates (if used) are initially "
3586 "created, since the title set in the template file overrides this. Also if "
3587 "one uses SECTION comment in the sources, this is obsolete."
3588 msgstr ""
3589 "Taggen &lt;TITLE&gt; … &lt;/TITLE&gt; används för att ange titeln på "
3590 "avsnittet. Det är bara användbart före mallar skapas initialt (om de "
3591 "används), eftersom titeln som ställs in i avsnittsfilen åsidosätter denna. "
3592 "Vidare är detta föråldrat om man använder SECTIONS-kommentarer i källkoden."
3593
3594 #. (itstool) path: sect1/para
3595 #: C/index.docbook:2206
3596 msgid ""
3597 "You can group items in the section by using the &lt;SUBSECTION&gt; tag. "
3598 "Currently it outputs a blank line between subsections in the synopsis "
3599 "section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject "
3600 "declarations (e.g. the functions like g_object_get_type and macros like "
3601 "G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the "
3602 "documentation. You can also use &lt;SUBSECTION Private&gt; for private "
3603 "declarations which will not be output (it is a handy way to avoid warning "
3604 "messages about unused declarations). If your library contains private types "
3605 "which you don't want to appear in the object hierarchy and the list of "
3606 "implemented or required interfaces, add them to a Private subsection. "
3607 "Whether you would place GObject and GObjectClass like structs in public or "
3608 "Standard section depends if they have public entries (variables, vmethods)."
3609 msgstr ""
3610 "Du kan gruppera objekt i avsnittet genom att använda taggen "
3611 "&lt;SUBSECTION&gt;. För närvarande matas en blankrad ut mellan underavsnitt "
3612 "i sammanfattningsavsnittet. Du kan också använda &lt;SUBSECTION Standard&gt; "
3613 "för standard GObject-deklarationer (t.ex. funktioner så som "
3614 "g_object_get_type och makron som G_OBJECT(), G_IS_OBJECT(), etc.). För "
3615 "närvarande utelämnas dessa ur dokumentationen. Du kan också använda "
3616 "&lt;SUBSECTION Private&gt; för privata deklarationer som inte kommer att "
3617 "matas ut (det är ett bekvämt sätt att undvika varningsmeddelanden om "
3618 "oanvända deklarationer). Om ditt bibliotek innehåller privata typer som du "
3619 "inte vill ska dyka upp i objekthierarkin och i listan över implementerade "
3620 "eller krävda gränssnitt, lägg till dem i ett privat avsnitt. Huruvida du "
3621 "vill placera GObject och GObjectClass-liknande strukturer i publika eller "
3622 "standardavsnitt beror på om de har publika poster (variabler, virtuella "
3623 "metoder)."
3624
3625 #. (itstool) path: sect1/para
3626 #: C/index.docbook:2225
3627 msgid ""
3628 "You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the "
3629 "#include files which are shown in the synopsis sections. It contains a comma-"
3630 "separate list of #include files, without the angle brackets. If you set it "
3631 "outside of any sections, it acts for all sections until the end of the file. "
3632 "If you set it within a section, it only applies to that section."
3633 msgstr ""
3634 "Du kan också använda &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; för att ange "
3635 "#include-filerna som ska visas i sammanfattningsavsnitten. Den innehåller en "
3636 "kommaavgränsad lista av #include-filer, utan vinkelparenteser. Om du ställer "
3637 "in det utanför några avsnitt kommer det att påverka alla avsnitt tills "
3638 "slutet på filen. Om du ställer in det inom ett avsnitt kommer det bara att "
3639 "påverka det avsnittet."
3640
3641 #. (itstool) path: chapter/title
3642 #: C/index.docbook:2239
3643 msgid "Controlling the result"
3644 msgstr "Kontrollera resultatet"
3645
3646 #. (itstool) path: chapter/para
3647 #: C/index.docbook:2241
3648 msgid ""
3649 "A GTK-Doc run generates report files inside the documentation directory. The "
3650 "generated files are named: <filename>&lt;package&gt;-undocumented.txt</"
3651 "filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and "
3652 "<filename>&lt;package&gt;-unused.txt</filename>. All those are plain text "
3653 "files that can be viewed and postprocessed easily."
3654 msgstr ""
3655 "En GTK-Doc-körning genererar rapportfiler inuti dokumentationskatalogen. De "
3656 "genererade filerna heter: <filename>&lt;paket&gt;-undocumented.txt</"
3657 "filename>, <filename>&lt;paket&gt;-undeclared.txt</filename> och "
3658 "<filename>&lt;paket&gt;-unused.txt</filename>. Alla är vanliga textfiler och "
3659 "kan visas eller efterbehandlas enkelt."
3660
3661 #. (itstool) path: chapter/para
3662 #: C/index.docbook:2250
3663 msgid ""
3664 "The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with "
3665 "the documentation coverage summary. Below are two sections divided by blank "
3666 "lines. The first section lists undocumented or incomplete symbols. The "
3667 "second section does the same for section docs. Incomplete entries are those, "
3668 "which have documentation, but where e.g. a new parameter has been added."
3669 msgstr ""
3670 "Filen <filename>&lt;paket&gt;-undocumented.txt</filename> inleds med en "
3671 "sammanfattning över hur mycket dokumentation som skrivits. Under det finns "
3672 "två avsnitt avgränsade av blankrader. Det första avsnittet listar "
3673 "odokumenterade eller ofullständiga symboler. Det andra avsnittet gör "
3674 "detsamma för avsnittsdokumentation. Ofullständiga poster är de som har "
3675 "dokumentation, men där en ny parameter har lagts till."
3676
3677 #. (itstool) path: chapter/para
3678 #: C/index.docbook:2259
3679 msgid ""
3680 "The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols "
3681 "given in the <filename>&lt;package&gt;-sections.txt</filename> but not found "
3682 "in the sources. Check if they have been removed or if they are misspelled."
3683 msgstr ""
3684 "Filen <filename>&lt;paket&gt;-undeclared.txt</filename> listar symboler som "
3685 "anges i <filename>&lt;paket&gt;-sections.txt</filename> men inte hittas i "
3686 "källkoden. Kontrollera om de har tagits bort eller om de är felstavade."
3687
3688 #. (itstool) path: chapter/para
3689 #: C/index.docbook:2266
3690 msgid ""
3691 "The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, "
3692 "where the GTK-Doc scanner has found documentation, but does not know where "
3693 "to put it. This means that the symbol has not yet been added to the "
3694 "<filename>&lt;package&gt;-sections.txt</filename> file."
3695 msgstr ""
3696 "Filen <filename>&lt;paket&gt;-unused.txt</filename> listar symbolnamn där "
3697 "GTK-Doc-detektorn har hittat dokumentation men inte vet var den ska "
3698 "placeras. Detta innebär att symbolen ännu inte har lagts till i filen "
3699 "<filename>&lt;package&gt;-sections.txt</filename>."
3700
3701 # sebras: <filename>?
3702 #. (itstool) path: tip/para
3703 #: C/index.docbook:2274
3704 msgid ""
3705 "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in "
3706 "Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity "
3707 "checks during <command>make check</command> run."
3708 msgstr ""
3709 "Aktivera eller lägg till raden <option>TESTS=$(GTKDOC_CHECK)</option> i "
3710 "Makefile.am. Om åtminstone GTK-Doc 1.9 finns installerat kommer detta att "
3711 "köra rimlighetskontroller under körning av <command>make check</command>."
3712
3713 #. (itstool) path: chapter/para
3714 #: C/index.docbook:2281
3715 msgid ""
3716 "One can also look at the files produced by the source code scanner: "
3717 "<filename>&lt;package&gt;-decl-list.txt</filename> and "
3718 "<filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared "
3719 "with the section file if that is manually maintained. The second lists all "
3720 "declarations from the headers. If a symbol is missing one could check if "
3721 "this file contains it."
3722 msgstr ""
3723 "Man kan också titta på filerna som producerats av källkodsdetektorn: "
3724 "<filename>&lt;paket&gt;-decl-list.txt</filename> och <filename>&lt;paket&gt;-"
3725 "decl.txt</filename>. Den första kan jämföras med avsnittsfilen om den "
3726 "underhålls manuellt. Den andra listar alla deklarationer från huvudena. Om "
3727 "en symbol saknas bör man kontrollera om denna filen innehåller den."
3728
3729 #. (itstool) path: chapter/para
3730 #: C/index.docbook:2290
3731 msgid ""
3732 "If the project is GObject based, one can also look into the files produced "
3733 "by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, "
3734 "<filename>&lt;package&gt;.hierarchy.txt</filename>, "
3735 "<filename>&lt;package&gt;.interfaces.txt</filename>, "
3736 "<filename>&lt;package&gt;.prerequisites.txt</filename> and "
3737 "<filename>&lt;package&gt;.signals.txt</filename>. If there are missing "
3738 "symbols in any of those, one can ask GTK-Doc to keep the intermediate "
3739 "scanner file for further analysis, by running it as "
3740 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3741 msgstr ""
3742 "Om projektet är GObject-baserat kan man också titta på filerna som "
3743 "producerats av objekt-detektorn: <filename>&lt;paket&gt;.args.txt</"
3744 "filename>, <filename>&lt;paket&gt;.hierarchy.txt</filename>, "
3745 "<filename>&lt;paket&gt;.interfaces.txt</filename>, "
3746 "<filename>&lt;paket&gt;.prerequisites.txt</filename> och "
3747 "<filename>&lt;paket&gt;.signals.txt</filename>. Om det saknas symboler i "
3748 "någon av dem kan man be GTK-Doc att bibehålla de temporära detektorfilerna "
3749 "för vidare analys, genom att köra det som "
3750 "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>."
3751
3752 #. (itstool) path: chapter/title
3753 #: C/index.docbook:2305
3754 msgid "Modernizing the documentation"
3755 msgstr "Modernisera dokumentationen"
3756
3757 #. (itstool) path: chapter/para
3758 #: C/index.docbook:2307
3759 msgid ""
3760 "GTK-Doc has been around for quite some time. In this section we list new "
3761 "features together with the version since when it is available."
3762 msgstr ""
3763 "GTK-Doc har funnits ett tag. I detta avsnitt listar vi nya funktioner "
3764 "tillsammans med vilken version de gjordes tillgängliga."
3765
3766 #. (itstool) path: sect1/title
3767 #: C/index.docbook:2313
3768 msgid "GTK-Doc 1.9"
3769 msgstr "GTK-Doc 1.9"
3770
3771 #. (itstool) path: sect1/para
3772 #: C/index.docbook:2315
3773 msgid ""
3774 "When using xml instead of sgml, one can actually name the master document "
3775 "<filename>&lt;package&gt;-docs.xml</filename>."
3776 msgstr ""
3777 "När man använder xml i stället för sgml, kan man faktiskt kalla "
3778 "huvuddokumentet <filename>&lt;paket&gt;-docs.xml</filename>."
3779
3780 #. (itstool) path: sect1/para
3781 #: C/index.docbook:2320
3782 msgid ""
3783 "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in "
3784 "<filename>Makefile.am</filename>. When this is enabled, the "
3785 "<filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can "
3786 "be removed from the vcs. This only works nicely for projects that have a "
3787 "very regular structure (e.g. each .{c,h} pair will create new section). If "
3788 "one organize a project close to that updating a manually maintained section "
3789 "file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt "
3790 "&lt;package&gt;-sections.txt</code>."
3791 msgstr ""
3792 "Denna version har stöd för <option>SCAN_OPTIONS=--rebuild-sections</option> "
3793 "i <filename>Makefile.am</filename>. När detta är aktiverat kommer "
3794 "<filename>&lt;paket&gt;-sections.txt</filename> att autogenereras och kan "
3795 "tas bort från versionshanteringssystemet. Detta fungerar bra för projekt som "
3796 "har en väldigt standardiserad struktur (t.ex. kommer varje .{c,h}-par att "
3797 "skapa ett nytt avsnitt). Om man organiserar ett projekt likt detta kommer "
3798 "den manuella uppdateringen av en avsnittsfil att vara så enkelt som att köra "
3799 "<code>meld &lt;paket&gt;-decl-list.txt &lt;paket&gt;-sections.txt</code>."
3800
3801 #. (itstool) path: sect1/para
3802 #: C/index.docbook:2331
3803 msgid ""
3804 "Version 1.8 already introduced the syntax for documenting sections in the "
3805 "sources instead of the separate files under <filename "
3806 "class=\"directory\">tmpl</filename>. This version adds options to switch the "
3807 "whole doc module to not use the extra tmpl build step at all, by using "
3808 "<option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If "
3809 "you don't have a <filename class=\"directory\">tmpl</filename> checked into "
3810 "your source control system and haven't yet switched, just add the flag to "
3811 "<filename>configure.ac</filename> and you are done."
3812 msgstr ""
3813 "Redan version 1.8 introducerade syntaxen för avsnittsdokumentation i "
3814 "källkoden i stället för separata filer under <filename "
3815 "class=\"directory\">tmpl</filename>. Denna version lägger till flaggor för "
3816 "att kunna ställa om hela dokumentationsmodulen till att inte använda det "
3817 "extra tmpl-byggsteget alls, genom att använda <option>--flavour no-tmpl</"
3818 "option> i <filename>configure.ac</filename>. Om du inte har <filename "
3819 "class=\"directory\">tmpl</filename> incheckat i ditt "
3820 "versionshanteringssystem just nu och inte har gått över än bara lägg till "
3821 "flaggan i <filename>configure.ac</filename> så är du klar."
3822
3823 #. (itstool) path: sect1/title
3824 #: C/index.docbook:2343
3825 msgid "GTK-Doc 1.10"
3826 msgstr "GTK-Doc 1.10"
3827
3828 #. (itstool) path: sect1/para
3829 #: C/index.docbook:2345
3830 msgid ""
3831 "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in "
3832 "<filename>Makefile.am</filename>. When this is enabled, the "
3833 "<filename>&lt;package&gt;.types</filename> is autogenerated and can be "
3834 "removed from the vcs. When using this feature it is important to also setup "
3835 "the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for "
3836 "code that is build conditionally."
3837 msgstr ""
3838 "Denna version har stöd för <option>SCAN_OPTIONS=--rebuild-types</option> i "
3839 "<filename>Makefile.am</filename>. När det är aktiverat kommer "
3840 "<filename>&lt;package&gt;.types</filename> att autogenereras och kan tas "
3841 "bort från versionshanteringssystemet. När denna funktion används är det "
3842 "viktigt att också ställa in <varname>IGNORE_HFILES</varname> i "
3843 "<filename>Makefile.am</filename> för kod som bara byggs ibland."
3844
3845 #. (itstool) path: sect1/title
3846 #: C/index.docbook:2356
3847 msgid "GTK-Doc 1.16"
3848 msgstr "GTK-Doc 1.16"
3849
3850 #. (itstool) path: example/title
3851 #: C/index.docbook:2362
3852 msgid "Enable gtkdoc-check"
3853 msgstr "Aktivera gtkdoc-check"
3854
3855 #. (itstool) path: example/programlisting
3856 #: C/index.docbook:2363
3857 #, no-wrap
3858 msgid ""
3859 "\n"
3860 "if ENABLE_GTK_DOC\n"
3861 "TESTS_ENVIRONMENT = \\\n"
3862 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3863 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3864 "TESTS = $(GTKDOC_CHECK)\n"
3865 "endif\n"
3866 msgstr ""
3867 "\n"
3868 "if ENABLE_GTK_DOC\n"
3869 "TESTS_ENVIRONMENT = \\\n"
3870 " DOC_MODULE=$(DOC_MODULE) DOC_MAIN_SGML_FILE=$(DOC_MAIN_SGML_FILE) \\\n"
3871 " SRCDIR=$(abs_srcdir) BUILDDIR=$(abs_builddir)\n"
3872 "TESTS = $(GTKDOC_CHECK)\n"
3873 "endif\n"
3874
3875 #. (itstool) path: sect1/para
3876 #: C/index.docbook:2358
3877 msgid ""
3878 "This version includes a new tool called gtkdoc-check. This tool can run a "
3879 "set of sanity checks on your documentation. It is enabled by adding these "
3880 "lines to the end of <filename>Makefile.am</filename>. <_:example-1/>"
3881 msgstr ""
3882 "Denna version har stöd för ett nytt verktyg som heter gtkdoc-check. Detta "
3883 "verktyg kan köra en uppsättning kontroller på din dokumentation. Det "
3884 "aktiveras genom att lägga till dessa raderna i slutet av "
3885 "<filename>Makefile.am</filename>. <_:example-1/>"
3886
3887 #. (itstool) path: sect1/title
3888 #: C/index.docbook:2376
3889 msgid "GTK-Doc 1.20"
3890 msgstr "GTK-Doc 1.20"
3891
3892 #. (itstool) path: sect1/para
3893 #: C/index.docbook:2378
3894 msgid ""
3895 "Version 1.18 brought some initial markdown support. Using markdown in doc "
3896 "comments is less intrusive than writing docbook xml. This version improves a "
3897 "lot on this and add a lot more styles. The section that explains the <link "
3898 "linkend=\"documenting_syntax\">comment syntax</link> has all the details."
3899 msgstr ""
3900 "Version 1.18 införde inledande stöd för markdown. Att använda markdown i "
3901 "dokumentationskommentarer är mindre påträngande än att skriva docbook xml. "
3902 "Denna version förbättrar detta väsentligt och lägger till många fler stilar. "
3903 "Avsnittet som beskriver <link "
3904 "linkend=\"documenting_syntax\">kommentarsyntax</link> finnas alla detaljer."
3905
3906 #. (itstool) path: sect1/title
3907 #: C/index.docbook:2388
3908 msgid "GTK-Doc 1.25"
3909 msgstr "GTK-Doc 1.25"
3910
3911 #. (itstool) path: example/title
3912 #: C/index.docbook:2399
3913 msgid "Use pre-generated entities"
3914 msgstr "Att använda förgenererade entiteter"
3915
3916 #. (itstool) path: example/programlisting
3917 #: C/index.docbook:2400
3918 #, no-wrap
3919 msgid ""
3920 "\n"
3921 "&lt;?xml version=\"1.0\"?&gt;\n"
3922 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3923 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3924 "[\n"
3925 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3926 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3927 " %gtkdocentities;\n"
3928 "]&gt;\n"
3929 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3930 " &lt;bookinfo&gt;\n"
3931 " &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;\n"
3932 " &lt;releaseinfo&gt;\n"
3933 " for &amp;package_string;.\n"
3934 " The latest version of this documentation can be found on-line at\n"
3935 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3936 " &lt;/releaseinfo&gt;\n"
3937 " &lt;/bookinfo&gt;\n"
3938 msgstr ""
3939 "\n"
3940 "&lt;?xml version=\"1.0\"?&gt;\n"
3941 "&lt;!DOCTYPE book PUBLIC \"-//OASIS//DTD DocBook XML V4.3//EN\"\n"
3942 " \"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd\"\n"
3943 "[\n"
3944 " &lt;!ENTITY % local.common.attrib \"xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'\"&gt;\n"
3945 " &lt;!ENTITY % gtkdocentities SYSTEM \"xml/gtkdocentities.ent\"&gt;\n"
3946 " %gtkdocentities;\n"
3947 "]&gt;\n"
3948 "&lt;book id=\"index\" xmlns:xi=\"http://www.w3.org/2003/XInclude\"&gt;\n"
3949 " &lt;bookinfo&gt;\n"
3950 " &lt;title&gt;&amp;package_name; handbok&lt;/title&gt;\n"
3951 " &lt;releaseinfo&gt;\n"
3952 " för &amp;package_string;.\n"
3953 " Den senaste versionen av detta dokument kan hittas på nätet på\n"
3954 " &lt;ulink role=\"online-location\" url=\"http://[SERVER]/&amp;package_name;/index.html\"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.\n"
3955 " &lt;/releaseinfo&gt;\n"
3956 " &lt;/bookinfo&gt;\n"
3957
3958 #. (itstool) path: sect1/para
3959 #: C/index.docbook:2390
3960 msgid ""
3961 "The makefiles shipped with this version generate an entity file at "
3962 "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. "
3963 "package_name and package_version. You can use this e.g. in the main xml file "
3964 "to avoid hardcoding the version number. Below is an example that shows how "
3965 "the entity file is included in the master template and how the entities are "
3966 "used. The entities can also be used in all generated files, GTK-Doc will use "
3967 "the same xml header in generated xml files. <_:example-1/>"
3968 msgstr ""
3969 "Makefilerna som skeppas med denna version genererar en entitetsfil vid namn "
3970 "<filename>xml/gtkdocentities.ent</filename> som innehåller entiteter för "
3971 "t.ex. package_name och package_version. Du kan använda detta för att t.ex. i "
3972 "filen main xml undvika att hårdkoda versionsnumret. Nedan finns ett exempel "
3973 "som visar hur entitetsfilen inkluderas i huvudmallen och hur entiteterna "
3974 "används. Entiteterna kan också användas i alla genererade filer, GTK-Doc "
3975 "kommer att använda samma xml-huvud i genererade xml-filer. <_:example-1/>"
3976
3977 #. (itstool) path: chapter/title
3978 #: C/index.docbook:2425
3979 msgid "Documenting other interfaces"
3980 msgstr "Dokumentera andra gränssnitt"
3981
3982 #. (itstool) path: chapter/para
3983 #: C/index.docbook:2427
3984 msgid ""
3985 "So far we have been using GTK-Doc to document the API of code. The next "
3986 "sections contain suggestions how the tools can be used to document other "
3987 "interfaces too."
3988 msgstr ""
3989 "Så här långt har vi använt GTK-Doc för att dokumentera API:t för koden. "
3990 "Följande avsnitt innehåller förslag om hur verktyget kan användas för att "
3991 "också dokumentera andra gränssnitt."
3992
3993 #. (itstool) path: sect1/title
3994 #: C/index.docbook:2434
3995 msgid "Command line options and man pages"
3996 msgstr "Kommandoradsflaggor och mansidor"
3997
3998 #. (itstool) path: sect1/para
3999 #: C/index.docbook:2436
4000 msgid ""
4001 "As one can generate man pages for a docbook refentry as well, it sounds like "
4002 "a good idea to use it for that purpose. This way the interface is part of "
4003 "the reference and one gets the man-page for free."
4004 msgstr ""
4005 "Då man också kan generera mansidor för ett docbook-refentry, låter det som "
4006 "en bra idé att använda det för detta ändamål. På detta sättet kommer "
4007 "gränssnittet att vara en del av referensen och man får mansidan gratis."
4008
4009 #. (itstool) path: sect2/title
4010 #: C/index.docbook:2443
4011 msgid "Document the tool"
4012 msgstr "Dokumentera verktyget"
4013
4014 # sebras: strange English
4015 #. (itstool) path: sect2/para
4016 #: C/index.docbook:2445
4017 msgid ""
4018 "Create one refentry file per tool. Following <link "
4019 "linkend=\"settingup_docfiles\">our example</link> we would call it "
4020 "<filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags "
4021 "that should be used and can look at generated file in the xml subdirectory "
4022 "as well as examples e.g. in glib."
4023 msgstr ""
4024 "Skapa en refentry-fil per verktyg. Om du följer <link "
4025 "linkend=\"settingup_docfiles\">vårt exempel</link> borde vi kalla det "
4026 "<filename>meep/docs/reference/meeper/meep.xml</filename>. För xml-taggarna "
4027 "bör detta användas och man kan studera den genererade filen i xml-"
4028 "underkatalogen så väl som exempel i glib."
4029
4030 #. (itstool) path: sect2/title
4031 #: C/index.docbook:2455
4032 msgid "Adding the extra configure check"
4033 msgstr "Lägga till den extra configure-kontrollen"
4034
4035 #. (itstool) path: example/title
4036 #: C/index.docbook:2458 C/index.docbook:2476
4037 msgid "Extra configure checks"
4038 msgstr "Lägga till extra configure-kontroller"
4039
4040 #. (itstool) path: example/programlisting
4041 #: C/index.docbook:2459
4042 #, no-wrap
4043 msgid ""
4044 "\n"
4045 "AC_ARG_ENABLE(man,\n"
4046 " [AC_HELP_STRING([--enable-man],\n"
4047 " [regenerate man pages from Docbook [default=no]])],enable_man=yes,\n"
4048 " enable_man=no)\n"
4049 "\n"
4050 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4051 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4052 msgstr ""
4053 "\n"
4054 "AC_ARG_ENABLE(man,\n"
4055 " [AC_HELP_STRING([--enable-man],\n"
4056 " [omgenerera mansidor från Docbook [standardvärde=no]])],enable_man=yes,\n"
4057 " enable_man=no)\n"
4058 "\n"
4059 "AC_PATH_PROG([XSLTPROC], [xsltproc])\n"
4060 "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n"
4061
4062 #. (itstool) path: sect2/title
4063 #: C/index.docbook:2473
4064 msgid "Adding the extra makefile rules"
4065 msgstr "Lägga till de extra makefilsreglerna"
4066
4067 #. (itstool) path: example/programlisting
4068 #: C/index.docbook:2477
4069 #, no-wrap
4070 msgid ""
4071 "\n"
4072 "man_MANS = \\\n"
4073 " meeper.1\n"
4074 "\n"
4075 "if ENABLE_GTK_DOC\n"
4076 "if ENABLE_MAN\n"
4077 "\n"
4078 "%.1 : %.xml\n"
4079 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4080 "\n"
4081 "endif\n"
4082 "endif\n"
4083 "\n"
4084 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4085 "EXTRA_DIST += meep.xml\n"
4086 msgstr ""
4087 "\n"
4088 "man_MANS = \\\n"
4089 " meeper.1\n"
4090 "\n"
4091 "if ENABLE_GTK_DOC\n"
4092 "if ENABLE_MAN\n"
4093 "\n"
4094 "%.1 : %.xml\n"
4095 " @XSLTPROC@ -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $&lt;\n"
4096 "\n"
4097 "endif\n"
4098 "endif\n"
4099 "\n"
4100 "BUILT_EXTRA_DIST = $(man_MANS)\n"
4101 "EXTRA_DIST += meep.xml\n"
4102
4103 #. (itstool) path: sect1/title
4104 #: C/index.docbook:2499
4105 msgid "DBus interfaces"
4106 msgstr "DBus-gränssnitt"
4107
4108 #. (itstool) path: sect1/para
4109 #: C/index.docbook:2501
4110 msgid ""
4111 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4112 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4113 msgstr ""
4114 "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://"
4115 "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)"
4116
4117 #. (itstool) path: chapter/title
4118 #: C/index.docbook:2510
4119 msgid "Frequently asked questions"
4120 msgstr "Frågor och svar"
4121
4122 #. (itstool) path: segmentedlist/segtitle
4123 #: C/index.docbook:2514
4124 msgid "Question"
4125 msgstr "Fråga"
4126
4127 #. (itstool) path: segmentedlist/segtitle
4128 #: C/index.docbook:2515
4129 msgid "Answer"
4130 msgstr "Svar"
4131
4132 #. (itstool) path: seglistitem/seg
4133 #: C/index.docbook:2517
4134 msgid "No class hierarchy."
4135 msgstr "Ingen klasshierarki."
4136
4137 #. (itstool) path: seglistitem/seg
4138 #: C/index.docbook:2518
4139 msgid ""
4140 "The objects <function>xxx_get_type()</function> function has not been "
4141 "entered into the <filename>&lt;package&gt;.types</filename> file."
4142 msgstr ""
4143 "Objektens <function>xxx_get_type()</function>-funktion har inte matats in i "
4144 "filen <filename>&lt;paket&gt;.types</filename>."
4145
4146 #. (itstool) path: seglistitem/seg
4147 #: C/index.docbook:2524
4148 msgid "Still no class hierarchy."
4149 msgstr "Fortfarande ingen klasshierarki."
4150
4151 #. (itstool) path: seglistitem/seg
4152 #: C/index.docbook:2525
4153 msgid ""
4154 "Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> "
4155 "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4156 "October/msg00006.html\">explanation</ulink>)."
4157 msgstr ""
4158 "Saknat eller fel namn i filen <filename>&lt;paket&gt;-sections.txt</"
4159 "filename> (se <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-"
4160 "October/msg00006.html\">förklaring</ulink>)."
4161
4162 #. (itstool) path: seglistitem/seg
4163 #: C/index.docbook:2531
4164 msgid "Damn, I have still no class hierarchy."
4165 msgstr "Förbannat, jag har fortfarande ingen klasshierarki."
4166
4167 #. (itstool) path: seglistitem/seg
4168 #: C/index.docbook:2532
4169 msgid ""
4170 "Is the object name (name of the instance struct, e.g. <type>GtkWidget</"
4171 "type>) part of the normal section (don't put this into Standard or Private "
4172 "subsections)."
4173 msgstr ""
4174 "Är objektnamnet (namnet på instansstrukturen, t.ex. <type>GtkWidget</type>) "
4175 "del av det normala avsnittet (stoppa inte detta i underavsnitt så som "
4176 "Standard eller Private)."
4177
4178 #. (itstool) path: seglistitem/seg
4179 #: C/index.docbook:2539
4180 msgid "No symbol index."
4181 msgstr "Inget symbolindex."
4182
4183 #. (itstool) path: seglistitem/seg
4184 #: C/index.docbook:2540
4185 msgid ""
4186 "Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a "
4187 "index that xi:includes the generated index?"
4188 msgstr ""
4189 "Innehåller <filename>&lt;paket&gt;-docs.{xml,sgml}</filename> ett index som "
4190 "inkluderar det genererade indexet med xi:include?"
4191
4192 #. (itstool) path: seglistitem/seg
4193 #: C/index.docbook:2546
4194 msgid "Symbols are not linked to their doc-section."
4195 msgstr "Symboler är inte länkade till deras dokumentationsavsnitt."
4196
4197 #. (itstool) path: seglistitem/seg
4198 #: C/index.docbook:2547
4199 msgid ""
4200 "Is the doc-comment using the correct markup (added #,% or ())? Check if the "
4201 "gtkdoc-fixxref warns about unresolvable xrefs."
4202 msgstr ""
4203 "Använder dokumentationskommentaren korrekta taggar (har du lagt till #, % "
4204 "eller ())? Kontrollera om gtkdoc-fixxref varnar om oupplösbara "
4205 "korsreferenser."
4206
4207 #. (itstool) path: seglistitem/seg
4208 #: C/index.docbook:2553
4209 msgid "A new class does not appear in the docs."
4210 msgstr "En ny klass dyker inte upp i dokumentationen."
4211
4212 #. (itstool) path: seglistitem/seg
4213 #: C/index.docbook:2554
4214 msgid ""
4215 "Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</"
4216 "filename>."
4217 msgstr ""
4218 "Är den nya sidan inkluderad med xi:include från <filename>&lt;package&gt;-"
4219 "docs.{xml,sgml}</filename>."
4220
4221 #. (itstool) path: seglistitem/seg
4222 #: C/index.docbook:2560
4223 msgid "A new symbol does not appear in the docs."
4224 msgstr "En ny symbol dyker inte upp i dokumentationen."
4225
4226 #. (itstool) path: seglistitem/seg
4227 #: C/index.docbook:2561
4228 msgid ""
4229 "Is the doc-comment properly formatted. Check for spelling mistakes in the "
4230 "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable "
4231 "xrefs. Check if the symbol is correctly listed in the "
4232 "<filename>&lt;package&gt;-sections.txt</filename> in a public subsection."
4233 msgstr ""
4234 "Är dokumentationskommentaren korrekt formaterad. Leta efter stavfel i början "
4235 "av kommentaren. Kontrollera om gtkdoc-fixxref varnar om oupplösbara "
4236 "korsreferenser. Kontrollera om symbolen finns korrekt listad i "
4237 "<filename>&lt;paket&gt;-sections.txt</filename> i ett publikt avsnitt."
4238
4239 #. (itstool) path: seglistitem/seg
4240 #: C/index.docbook:2569
4241 msgid "A type is missing from the class hierarchy."
4242 msgstr "En typ saknas från klasshierarkin."
4243
4244 #. (itstool) path: seglistitem/seg
4245 #: C/index.docbook:2570
4246 msgid ""
4247 "If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but "
4248 "not in <filename>xml/tree_index.sgml</filename> then double check that the "
4249 "type is correctly placed in the <filename>&lt;package&gt;-sections.txt</"
4250 "filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed "
4251 "or incidentally marked private it will not be shown."
4252 msgstr ""
4253 "Om typen finns listad i <filename>&lt;paket&gt;.hierarchy</filename> men "
4254 "inte i <filename>xml/tree_index.sgml</filename>, dubbelkolla då att typen "
4255 "finns korrekt placerad i <filename>&lt;paket&gt;-sections.txt</filename>. Om "
4256 "typinstansen (t.ex. <type>GtkWidget</type>) inte visas eller är markerad "
4257 "privat kommer den inte att visas."
4258
4259 #. (itstool) path: seglistitem/seg
4260 #: C/index.docbook:2579
4261 msgid "I get foldoc links for all gobject annotations."
4262 msgstr "Jag får foldoc-länkar för alla gobject-noteringar."
4263
4264 #. (itstool) path: seglistitem/seg
4265 #: C/index.docbook:2580
4266 msgid ""
4267 "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included "
4268 "from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>."
4269 msgstr ""
4270 "Kontrollera att <filename>xml/annotation-glossary.xml</filename> är "
4271 "inkluderad med xi:include från <filename>&lt;package&gt;-docs.{xml,sgml}</"
4272 "filename>."
4273
4274 #. (itstool) path: seglistitem/seg
4275 #: C/index.docbook:2588
4276 msgid "Parameter described in source code comment block but does not exist"
4277 msgstr "Parameter beskriven i kommentarsblock i källkoden men existerar inte"
4278
4279 #. (itstool) path: seglistitem/seg
4280 #: C/index.docbook:2589
4281 msgid ""
4282 "Check if the prototype in the header has different parameter names as in the "
4283 "source."
4284 msgstr ""
4285 "Kontrollera om prototypen i huvudet har andra parameternamn än i källkoden."
4286
4287 #. (itstool) path: seglistitem/seg
4288 #: C/index.docbook:2594
4289 msgid "multiple \"IDs\" for constraint linkend: XYZ"
4290 msgstr "multipla ”ID:n” för begränsat länkslut: XYZ"
4291
4292 #. (itstool) path: seglistitem/seg
4293 #: C/index.docbook:2595
4294 msgid ""
4295 "Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</"
4296 "filename> file."
4297 msgstr ""
4298 "Symbolen XYZ förekommer två gånger i filen <filename>&lt;paket&gt;-"
4299 "sections.txt</filename>."
4300
4301 #. (itstool) path: seglistitem/seg
4302 #: C/index.docbook:2598
4303 msgid ""
4304 "Element typename in namespace '' encountered in para, but no template "
4305 "matches."
4306 msgstr "Elementtypnamn i namnrymd ”” påträffat i para, men ingen mall matchar."
4307
4308 #. (itstool) path: chapter/title
4309 #: C/index.docbook:2605
4310 msgid "Tools related to gtk-doc"
4311 msgstr "Verktyg relaterade till gtk-doc"
4312
4313 #. (itstool) path: chapter/para
4314 #: C/index.docbook:2607
4315 msgid ""
4316 "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac "
4317 "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and "
4318 "integrates with the trac search."
4319 msgstr ""
4320 "GtkDocPlugin - en insticksmodul för <ulink url=\"http://trac-hacks.org/wiki/"
4321 "GtkDocPlugin\">Trac GTK-Doc</ulink>-integrering som lägger till API-"
4322 "dokumentation till en trac-webbplats och integrerar med trac-sökningen."
4323
4324 #. (itstool) path: chapter/para
4325 #: C/index.docbook:2612
4326 msgid ""
4327 "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since "
4328 "tags in the API to determine the minimum required version."
4329 msgstr ""
4330 "Gtkdoc-depscan - ett verktyg (del av gtk-doc) för att kontrollera använda "
4331 "API mot since-taggar i API:t för att avgöra minsta version som krävs."
4332
4333 #. (itstool) path: appendixinfo/releaseinfo
4334 #: C/fdl-appendix.xml:12
4335 msgid "Version 1.1, March 2000"
4336 msgstr "Version 1.1, mars 2000"
4337
4338 #. (itstool) path: copyright/year
4339 #: C/fdl-appendix.xml:16
4340 msgid "2000"
4341 msgstr "2000"
4342
4343 #. (itstool) path: copyright/holder
4344 #: C/fdl-appendix.xml:16
4345 msgid "Free Software Foundation, Inc."
4346 msgstr "Free Software Foundation, Inc."
4347
4348 #. (itstool) path: address/street
4349 #: C/fdl-appendix.xml:20
4350 msgid "51 Franklin Street, Suite 330"
4351 msgstr "51 Franklin Street, Suite 330"
4352
4353 #. (itstool) path: address/city
4354 #: C/fdl-appendix.xml:21
4355 msgid "Boston"
4356 msgstr "Boston"
4357
4358 #. (itstool) path: address/state
4359 #: C/fdl-appendix.xml:21
4360 msgid "MA"
4361 msgstr "MA"
4362
4363 #. (itstool) path: address/postcode
4364 #: C/fdl-appendix.xml:22
4365 msgid "02110-1301"
4366 msgstr "02110-1301"
4367
4368 #. (itstool) path: address/country
4369 #: C/fdl-appendix.xml:22
4370 msgid "USA"
4371 msgstr "USA"
4372
4373 #. (itstool) path: para/address
4374 #: C/fdl-appendix.xml:20
4375 msgid ""
4376 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4377 "<_:postcode-4/> <_:country-5/>"
4378 msgstr ""
4379 "Free Software Foundation, Inc. <_:street-1/>, <_:city-2/>, <_:state-3/> "
4380 "<_:postcode-4/> <_:country-5/>"
4381
4382 #. (itstool) path: legalnotice/para
4383 #: C/fdl-appendix.xml:19
4384 msgid ""
4385 "<_:address-1/> Everyone is permitted to copy and distribute verbatim copies "
4386 "of this license document, but changing it is not allowed."
4387 msgstr ""
4388 "<_:address-1/>. Alla är tillåtna kopiera och distribuera ordagranna kopior "
4389 "av detta licensdokument, men att ändra det är ej tillåtet."
4390
4391 #. (itstool) path: appendix/title
4392 #. (itstool) path: para/quote
4393 #: C/fdl-appendix.xml:28 C/fdl-appendix.xml:642
4394 msgid "GNU Free Documentation License"
4395 msgstr "GNU Free Documentation License"
4396
4397 #. (itstool) path: sect1/title
4398 #: C/fdl-appendix.xml:31
4399 msgid "0. PREAMBLE"
4400 msgstr "0. BAKGRUND"
4401
4402 #. (itstool) path: para/quote
4403 #: C/fdl-appendix.xml:34
4404 msgid "free"
4405 msgstr "fritt"
4406
4407 #. (itstool) path: sect1/para
4408 #: C/fdl-appendix.xml:32
4409 msgid ""
4410 "The purpose of this License is to make a manual, textbook, or other written "
4411 "document <_:quote-1/> in the sense of freedom: to assure everyone the "
4412 "effective freedom to copy and redistribute it, with or without modifying it, "
4413 "either commercially or noncommercially. Secondarily, this License preserves "
4414 "for the author and publisher a way to get credit for their work, while not "
4415 "being considered responsible for modifications made by others."
4416 msgstr ""
4417 "Syftet med denna licens är att göra en handbok, bok, eller annat praktiskt "
4418 "och användbart dokument <_:quote-1/> som i frihet: att försäkra var och en "
4419 "den faktiska friheten att kopiera och sprida det vidare, med eller utan "
4420 "förändringar, antingen kommersiellt eller ideellt. Sekundärt bevarar denna "
4421 "licens ett sätt för författaren och förläggaren att få ära för deras arbete "
4422 "utan att de anses vara ansvariga för förändringar gjorda av andra."
4423
4424 #. (itstool) path: para/quote
4425 #: C/fdl-appendix.xml:44
4426 msgid "copyleft"
4427 msgstr "copyleft"
4428
4429 #. (itstool) path: sect1/para
4430 #: C/fdl-appendix.xml:43
4431 msgid ""
4432 "This License is a kind of <_:quote-1/>, which means that derivative works of "
4433 "the document must themselves be free in the same sense. It complements the "
4434 "GNU General Public License, which is a copyleft license designed for free "
4435 "software."
4436 msgstr ""
4437 "Denna Licens är en sorts <_:quote-1/>, vilket betyder att derivativa verk av "
4438 "detta dokument själva måste vara fria på samma sätt. Den kompletterar GNU "
4439 "General Public License, som är en copyleft-licens utformad för fri "
4440 "programvara."
4441
4442 #. (itstool) path: sect1/para
4443 #: C/fdl-appendix.xml:50
4444 msgid ""
4445 "We have designed this License in order to use it for manuals for free "
4446 "software, because free software needs free documentation: a free program "
4447 "should come with manuals providing the same freedoms that the software does. "
4448 "But this License is not limited to software manuals; it can be used for any "
4449 "textual work, regardless of subject matter or whether it is published as a "
4450 "printed book. We recommend this License principally for works whose purpose "
4451 "is instruction or reference."
4452 msgstr ""
4453 "Vi har utformat denna licens för att den skall användas för handböcker till "
4454 "fri programvara, eftersom fri programvara behöver fri dokumentation: ett "
4455 "fritt program bör ha en handbok som erbjuder samma friheter som programmet "
4456 "gör. Men denna licens är inte begränsad till programvaruhandböcker; den kan "
4457 "användas för vilket textverk som helst oavsett ämne eller huruvida det är en "
4458 "utgiven, tryckt bok. Vi rekommenderar denna licens huvudsakligen för alla "
4459 "verk vars syfte är instruktion eller referens."
4460
4461 #. (itstool) path: sect1/title
4462 #: C/fdl-appendix.xml:62
4463 msgid "1. APPLICABILITY AND DEFINITIONS"
4464 msgstr "1. TILLÄMPNINGSOMRÅDE OCH DEFINITIONER"
4465
4466 #. (itstool) path: para/quote
4467 #. (itstool) path: para/link
4468 #: C/fdl-appendix.xml:67 C/fdl-appendix.xml:82 C/fdl-appendix.xml:99
4469 #: C/fdl-appendix.xml:107 C/fdl-appendix.xml:113 C/fdl-appendix.xml:156
4470 #: C/fdl-appendix.xml:179 C/fdl-appendix.xml:190 C/fdl-appendix.xml:205
4471 #: C/fdl-appendix.xml:224 C/fdl-appendix.xml:235 C/fdl-appendix.xml:253
4472 #: C/fdl-appendix.xml:271 C/fdl-appendix.xml:294 C/fdl-appendix.xml:354
4473 #: C/fdl-appendix.xml:368 C/fdl-appendix.xml:400 C/fdl-appendix.xml:462
4474 #: C/fdl-appendix.xml:472 C/fdl-appendix.xml:482 C/fdl-appendix.xml:519
4475 #: C/fdl-appendix.xml:540 C/fdl-appendix.xml:565 C/fdl-appendix.xml:583
4476 #: C/fdl-appendix.xml:608
4477 msgid "Document"
4478 msgstr "Dokument"
4479
4480 #. (itstool) path: para/quote
4481 #: C/fdl-appendix.xml:69
4482 msgid "you"
4483 msgstr "du"
4484
4485 #. (itstool) path: sect1/para
4486 #: C/fdl-appendix.xml:63
4487 msgid ""
4488 "This License applies to any manual or other work that contains a notice "
4489 "placed by the copyright holder saying it can be distributed under the terms "
4490 "of this License. The <_:quote-1/>, below, refers to any such manual or work. "
4491 "Any member of the public is a licensee, and is addressed as <_:quote-2/>."
4492 msgstr ""
4493 "Denna licens [det engelska originalet] gäller för varje handbok eller annat "
4494 "verk, oavsett uttrycksform, som innehåller ett meddelande där "
4495 "upphovsrättsinnehavaren stadgat att verket kan spridas enligt villkoren i "
4496 "GNU Free Documentation License. Ett sådant meddelande ger en internationell "
4497 "frihet utan krav på ersättning och utan tidsbegränsning att använda verket "
4498 "under villkoren i denna licens [det engelska originalet]. <_:quote-1/> nedan "
4499 "syftar på godtycklig handbok eller verk. Var och en är licenstagare och "
4500 "benämns som <_:quote-2/>."
4501
4502 #. (itstool) path: para/quote
4503 #. (itstool) path: para/link
4504 #: C/fdl-appendix.xml:73 C/fdl-appendix.xml:234 C/fdl-appendix.xml:269
4505 #: C/fdl-appendix.xml:283 C/fdl-appendix.xml:315 C/fdl-appendix.xml:351
4506 #: C/fdl-appendix.xml:413 C/fdl-appendix.xml:433 C/fdl-appendix.xml:447
4507 #: C/fdl-appendix.xml:459 C/fdl-appendix.xml:475 C/fdl-appendix.xml:543
4508 msgid "Modified Version"
4509 msgstr "förändrad version"
4510
4511 #. (itstool) path: sect1/para
4512 #: C/fdl-appendix.xml:72
4513 msgid ""
4514 "A <_:quote-1/> of the Document means any work containing the Document or a "
4515 "portion of it, either copied verbatim, or with modifications and/or "
4516 "translated into another language."
4517 msgstr ""
4518 "En <_:quote-1/> av dokumentet avser varje verk som innehåller dokumentet "
4519 "eller en del av det, antingen ordagranna kopior, eller med ändringar och/"
4520 "eller översatt till ett annat språk."
4521
4522 #. (itstool) path: para/quote
4523 #: C/fdl-appendix.xml:80
4524 msgid "Secondary Section"
4525 msgstr "sekundärt avsnitt"
4526
4527 #. (itstool) path: sect1/para
4528 #: C/fdl-appendix.xml:79
4529 msgid ""
4530 "A <_:quote-1/> is a named appendix or a front-matter section of the "
4531 "<_:link-2/> that deals exclusively with the relationship of the publishers "
4532 "or authors of the Document to the Document's overall subject (or to related "
4533 "matters) and contains nothing that could fall directly within that overall "
4534 "subject. (For example, if the Document is in part a textbook of mathematics, "
4535 "a Secondary Section may not explain any mathematics.) The relationship could "
4536 "be a matter of historical connection with the subject or with related "
4537 "matters, or of legal, commercial, philosophical, ethical or political "
4538 "position regarding them."
4539 msgstr ""
4540 "Ett <_:quote-1/> är en märkt bilaga eller förord till <link linkend=\"fdl-"
4541 "document\">dokumentet</link> som exklusivt behandlar förhållandet mellan "
4542 "dokumentets förläggare eller författare och dokumentets huvudsakliga ämne "
4543 "(eller till relaterade ämnen) och som inte innehåller något som direkt "
4544 "faller under det huvudsakliga ämnet. (Således, om dokumentet delvis är en "
4545 "lärobok i matematik så får ett sekundärt avsnitt inte förklara någon "
4546 "matematik.) Förhållandet kan vara en historisk koppling till ämnet eller "
4547 "något relaterat, eller en juridisk, kommersiell, filosofisk, etisk eller "
4548 "politisk ställning till det."
4549
4550 #. (itstool) path: para/quote
4551 #. (itstool) path: para/link
4552 #: C/fdl-appendix.xml:95 C/fdl-appendix.xml:327 C/fdl-appendix.xml:398
4553 #: C/fdl-appendix.xml:439 C/fdl-appendix.xml:486 C/fdl-appendix.xml:494
4554 #: C/fdl-appendix.xml:567 C/fdl-appendix.xml:637 C/fdl-appendix.xml:648
4555 msgid "Invariant Sections"
4556 msgstr "oföränderliga avsnitten"
4557
4558 #. (itstool) path: para/link
4559 #: C/fdl-appendix.xml:96 C/fdl-appendix.xml:435
4560 msgid "Secondary Sections"
4561 msgstr "sekundära avsnitt"
4562
4563 #. (itstool) path: sect1/para
4564 #: C/fdl-appendix.xml:94
4565 msgid ""
4566 "The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as "
4567 "being those of Invariant Sections, in the notice that says that the "
4568 "<_:link-3/> is released under this License."
4569 msgstr ""
4570 "De <_:quote-1/> är <_:link-2/> vars titlar är angivna som oföränderliga "
4571 "avsnitt i meddelandet som stadgar att <_:link-3/> är utgivet under denna "
4572 "licens [det engelska originalet]."
4573
4574 #. (itstool) path: para/quote
4575 #. (itstool) path: para/link
4576 #: C/fdl-appendix.xml:104 C/fdl-appendix.xml:181 C/fdl-appendix.xml:328
4577 #: C/fdl-appendix.xml:458
4578 msgid "Cover Texts"
4579 msgstr "Omslagstexterna"
4580
4581 #. (itstool) path: sect1/para
4582 #: C/fdl-appendix.xml:103
4583 msgid ""
4584 "The <_:quote-1/> are certain short passages of text that are listed, as "
4585 "Front-Cover Texts or Back-Cover Texts, in the notice that says that the "
4586 "<_:link-2/> is released under this License."
4587 msgstr ""
4588 "<_:quote-1/> är speciella korta ordföljder som är listade som "
4589 "framsidestexter eller baksidestexter i meddelandet som stadgar att <_:link-2/"
4590 "> är utgivet under denna licens [det engelska originalet]."
4591
4592 #. (itstool) path: para/quote
4593 #. (itstool) path: para/link
4594 #: C/fdl-appendix.xml:112 C/fdl-appendix.xml:124 C/fdl-appendix.xml:207
4595 #: C/fdl-appendix.xml:369
4596 msgid "Transparent"
4597 msgstr "transparent"
4598
4599 #. (itstool) path: para/quote
4600 #. (itstool) path: para/link
4601 #: C/fdl-appendix.xml:125 C/fdl-appendix.xml:204
4602 msgid "Opaque"
4603 msgstr "opak"
4604
4605 #. (itstool) path: sect1/para
4606 #: C/fdl-appendix.xml:111
4607 msgid ""
4608 "A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, "
4609 "represented in a format whose specification is available to the general "
4610 "public, whose contents can be viewed and edited directly and "
4611 "straightforwardly with generic text editors or (for images composed of "
4612 "pixels) generic paint programs or (for drawings) some widely available "
4613 "drawing editor, and that is suitable for input to text formatters or for "
4614 "automatic translation to a variety of formats suitable for input to text "
4615 "formatters. A copy made in an otherwise Transparent file format whose markup "
4616 "has been designed to thwart or discourage subsequent modification by readers "
4617 "is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>."
4618 msgstr ""
4619 "En <_:quote-1/> kopia av <_:link-2/> är en maskinläsbar kopia, representerad "
4620 "i ett format vars specifikation finns tillgänglig för allmänheten, som "
4621 "lämpar sig för att revidera dokumentet på ett enkelt sätt med generella "
4622 "textredigeringsprogram eller (för pixelbaserade bilder) generella "
4623 "grafikprogram eller (för ritningar) något väl tillgängligt ritprogram, och "
4624 "som är passande som indata till textformaterare eller för automatisk "
4625 "konvertering till en mängd format som passar som indata till "
4626 "textformaterare. En kopia i ett för övrigt transparent filformat vars "
4627 "markeringar, eller avsaknad av markeringar, har ordnats för att hindra eller "
4628 "motverka att vidare förändring vidtas av läsare är inte transparent. En "
4629 "kopia som inte är <_:quote-3/> kallas <_:quote-4/>."
4630
4631 #. (itstool) path: sect1/para
4632 #: C/fdl-appendix.xml:128
4633 msgid ""
4634 "Examples of suitable formats for Transparent copies include plain ASCII "
4635 "without markup, Texinfo input format, LaTeX input format, SGML or XML using "
4636 "a publicly available DTD, and standard-conforming simple HTML designed for "
4637 "human modification. Opaque formats include PostScript, PDF, proprietary "
4638 "formats that can be read and edited only by proprietary word processors, "
4639 "SGML or XML for which the DTD and/or processing tools are not generally "
4640 "available, and the machine-generated HTML produced by some word processors "
4641 "for output purposes only."
4642 msgstr ""
4643 "Exempel på passande format för transparenta kopior innefattar ren ASCII utan "
4644 "markeringar, Texinfo indataformat, LaTeX indataformat, SGML eller XML som "
4645 "använder en publikt tillgänglig DTD, och standardenlig HTML, PostScript "
4646 "eller PDF utformat för mänsklig förändring. Opaka format innefattar "
4647 "Postscript, PDF, leverantörsspecifika format som bara kan läsas och editeras "
4648 "med leverantörsspecifika ordbehandlare, SGML eller XML för vilket DTD och/"
4649 "eller verktyg för behandling inte finns allmänt tillgängliga, och den "
4650 "maskingenererade HTML som produceras av vissa ordbehandlare enbart avsett "
4651 "som utdata."
4652
4653 #. (itstool) path: para/quote
4654 #. (itstool) path: para/link
4655 #: C/fdl-appendix.xml:142 C/fdl-appendix.xml:146 C/fdl-appendix.xml:250
4656 #: C/fdl-appendix.xml:266 C/fdl-appendix.xml:281 C/fdl-appendix.xml:352
4657 msgid "Title Page"
4658 msgstr "Titelsidan"
4659
4660 #. (itstool) path: sect1/para
4661 #: C/fdl-appendix.xml:141
4662 msgid ""
4663 "The <_:quote-1/> means, for a printed book, the title page itself, plus such "
4664 "following pages as are needed to hold, legibly, the material this License "
4665 "requires to appear in the title page. For works in formats which do not have "
4666 "any title page as such, <_:quote-2/> means the text near the most prominent "
4667 "appearance of the work's title, preceding the beginning of the body of the "
4668 "text."
4669 msgstr ""
4670 "<_:quote-1/> innebär, för en tryckt bok, titelsidan själv, och sådana därpå "
4671 "följande sidor som krävs för att göra det material som enligt denna licens "
4672 "skall synas på titelsidan läsbart. För verk i sådana format som inte har "
4673 "någon egentlig titelsida, avses med <_:quote-2/> den text som är närmast den "
4674 "mest framstående förekomsten av verkets titel, föregående den huvudsakliga "
4675 "textmassan."
4676
4677 #. (itstool) path: sect1/title
4678 #: C/fdl-appendix.xml:153
4679 msgid "2. VERBATIM COPYING"
4680 msgstr "2. ORDAGRANN KOPIERING"
4681
4682 #. (itstool) path: para/link
4683 #: C/fdl-appendix.xml:166 C/fdl-appendix.xml:551
4684 msgid "section 3"
4685 msgstr "paragraf 3"
4686
4687 #. (itstool) path: sect1/para
4688 #: C/fdl-appendix.xml:154
4689 msgid ""
4690 "You may copy and distribute the <_:link-1/> in any medium, either "
4691 "commercially or noncommercially, provided that this License, the copyright "
4692 "notices, and the license notice saying this License applies to the Document "
4693 "are reproduced in all copies, and that you add no other conditions "
4694 "whatsoever to those of this License. You may not use technical measures to "
4695 "obstruct or control the reading or further copying of the copies you make or "
4696 "distribute. However, you may accept compensation in exchange for copies. If "
4697 "you distribute a large enough number of copies you must also follow the "
4698 "conditions in <_:link-2/>."
4699 msgstr ""
4700 "Du äger kopiera och sprida <_:link-1/> på valfritt medium, antingen "
4701 "kommersiellt eller ideellt, förutsatt att denna licens [det engelska "
4702 "originalet], upphovsrättsklausul, och meddelandet som stadgar att GNU Free "
4703 "Documentation License gäller för dokumentet finns med på alla kopior, och "
4704 "att du inte lägger till några som helst andra villkor än de som ingår i "
4705 "denna licens. Du äger inte vidta tekniska åtgärder för att begränsa eller "
4706 "kontrollera läsande eller vidare kopiering av de kopior du skapar eller "
4707 "sprider. Dock äger du ta emot kompensation i utbyte mot kopior. Om du "
4708 "sprider tillräckligt många kopior måste du också följa villkoren i <_:link-2/"
4709 ">."
4710
4711 #. (itstool) path: sect1/para
4712 #: C/fdl-appendix.xml:169
4713 msgid ""
4714 "You may also lend copies, under the same conditions stated above, and you "
4715 "may publicly display copies."
4716 msgstr ""
4717 "Du äger också låna ut kopior, under samma villkor som ovan, och du äger visa "
4718 "kopior offentligt."
4719
4720 #. (itstool) path: sect1/title
4721 #: C/fdl-appendix.xml:176
4722 msgid "3. COPYING IN QUANTITY"
4723 msgstr "3. OMFATTANDE KOPIERING"
4724
4725 #. (itstool) path: sect1/para
4726 #: C/fdl-appendix.xml:177
4727 msgid ""
4728 "If you publish printed copies of the <_:link-1/> numbering more than 100, "
4729 "and the Document's license notice requires <_:link-2/>, you must enclose the "
4730 "copies in covers that carry, clearly and legibly, all these Cover Texts: "
4731 "Front-Cover Texts on the front cover, and Back-Cover Texts on the back "
4732 "cover. Both covers must also clearly and legibly identify you as the "
4733 "publisher of these copies. The front cover must present the full title with "
4734 "all words of the title equally prominent and visible. You may add other "
4735 "material on the covers in addition. Copying with changes limited to the "
4736 "covers, as long as they preserve the title of the <_:link-3/> and satisfy "
4737 "these conditions, can be treated as verbatim copying in other respects."
4738 msgstr ""
4739 "Om du publicerar tryckta kopior (eller kopior i medier som normalt har "
4740 "tryckta omslag) av <_:link-1/>, i en upplaga överstigande 100 exemplar, och "
4741 "dokumentets licensmeddelande kräver <_:link-2/>, så måste du förse kopiorna "
4742 "med omslag som, klart och tydligt, visar alla omslagstexter: framsidestexter "
4743 "på framsidan och baksidestexter på baksidan. Båda omslagen måste klart och "
4744 "tydligt identifiera dig som utgivare av dessa kopior. Framsidan måste "
4745 "presentera dokumentets hela titel, med alla ord i titeln lika framträdande "
4746 "och synliga. Du äger lägga till ytterligare stoff på omslagen. Kopiering med "
4747 "förändringar gjorda bara på omslaget, så länge som de bevarar titeln för "
4748 "<_:link-3/> och i övrigt uppfyller dessa krav kan anses vara ordagrann "
4749 "kopiering i andra avseenden."
4750
4751 #. (itstool) path: sect1/para
4752 #: C/fdl-appendix.xml:195
4753 msgid ""
4754 "If the required texts for either cover are too voluminous to fit legibly, "
4755 "you should put the first ones listed (as many as fit reasonably) on the "
4756 "actual cover, and continue the rest onto adjacent pages."
4757 msgstr ""
4758 "Om de obligatoriska texterna för något omslag är för omfattande för att "
4759 "rymmas i läsbart skick skall du placera de första (så många som får plats) "
4760 "på det egentliga omslaget, och fortsätta med resten på de direkt "
4761 "intilliggande sidorna."
4762
4763 #. (itstool) path: sect1/para
4764 #: C/fdl-appendix.xml:202
4765 msgid ""
4766 "If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering "
4767 "more than 100, you must either include a machine-readable <_:link-3/> copy "
4768 "along with each Opaque copy, or state in or with each Opaque copy a publicly-"
4769 "accessible computer-network location containing a complete Transparent copy "
4770 "of the Document, free of added material, which the general network-using "
4771 "public has access to download anonymously at no charge using public-standard "
4772 "network protocols. If you use the latter option, you must take reasonably "
4773 "prudent steps, when you begin distribution of Opaque copies in quantity, to "
4774 "ensure that this Transparent copy will remain thus accessible at the stated "
4775 "location until at least one year after the last time you distribute an "
4776 "Opaque copy (directly or through your agents or retailers) of that edition "
4777 "to the public."
4778 msgstr ""
4779 "Om du publicerar <_:link-1/>a kopior av <_:link-2/> i upplagor om mer än "
4780 "100, måste du antingen bifoga en maskinläsbar <_:link-3/> kopia med varje "
4781 "opak kopia, eller ange i eller med varje opak kopia en nätverksadress som är "
4782 "tillgänglig för den allmänna nätverksanvändande massan där man, med öppet "
4783 "standardiserade protokoll, anonymt och utan kostnad kan ladda ner en "
4784 "komplett transparent kopia av dokumentet, utan extra material. Om du väljer "
4785 "det senare alternativet, måste du vidta skäliga åtgärder, när du börjar "
4786 "sprida opaka kopior i kvantitet, för att denna transparenta kopia skall "
4787 "förbli tillgänglig på angivna platsen till åtminstone ett år efter den sista "
4788 "gången du spred en opak kopia (direkt eller via ombud eller återförsäljare) "
4789 "av den utgåvan till allmänheten."
4790
4791 #. (itstool) path: sect1/para
4792 #: C/fdl-appendix.xml:222
4793 msgid ""
4794 "It is requested, but not required, that you contact the authors of the "
4795 "<_:link-1/> well before redistributing any large number of copies, to give "
4796 "them a chance to provide you with an updated version of the Document."
4797 msgstr ""
4798 "Det är önskvärt, men inte ett krav, att du kontaktar författarna till "
4799 "<_:link-1/> i god tid innan du sprider något större antal kopior, för att ge "
4800 "dem en chans att förse dig med en uppdaterad version av dokumentet."
4801
4802 #. (itstool) path: sect1/title
4803 #: C/fdl-appendix.xml:231
4804 msgid "4. MODIFICATIONS"
4805 msgstr "4. FÖRÄNDRINGAR"
4806
4807 #. (itstool) path: para/link
4808 #: C/fdl-appendix.xml:236
4809 msgid "2"
4810 msgstr "2"
4811
4812 #. (itstool) path: para/link
4813 #: C/fdl-appendix.xml:237
4814 msgid "3"
4815 msgstr "3"
4816
4817 #. (itstool) path: sect1/para
4818 #: C/fdl-appendix.xml:232
4819 msgid ""
4820 "You may copy and distribute a <_:link-1/> of the <_:link-2/> under the "
4821 "conditions of sections <_:link-3/> and <_:link-4/> above, provided that you "
4822 "release the Modified Version under precisely this License, with the Modified "
4823 "Version filling the role of the Document, thus licensing distribution and "
4824 "modification of the Modified Version to whoever possesses a copy of it. In "
4825 "addition, you must do these things in the Modified Version:"
4826 msgstr ""
4827 "Du äger kopiera och sprida en <_:link-1/> av <_:link-2/> under de villkor "
4828 "som beskrivs i paragraf <_:link-3/> och <_:link-4/> av GNU Free "
4829 "Documentation License, förutsatt att du släpper den förändrade versionen "
4830 "under exakt denna licens, och att den förändrade versionen antar dokumentets "
4831 "roll, och således medger spridning och förändring av den förändrade "
4832 "versionen till envar som erhåller en kopia av den. Utöver detta måste du "
4833 "göra följande med den ändrade versionen:"
4834
4835 #. (itstool) path: formalpara/title
4836 #: C/fdl-appendix.xml:248
4837 msgid "A"
4838 msgstr "A"
4839
4840 #. (itstool) path: formalpara/para
4841 #: C/fdl-appendix.xml:249
4842 msgid ""
4843 "Use in the <_:link-1/> (and on the covers, if any) a title distinct from "
4844 "that of the <_:link-2/>, and from those of previous versions (which should, "
4845 "if there were any, be listed in the History section of the Document). You "
4846 "may use the same title as a previous version if the original publisher of "
4847 "that version gives permission."
4848 msgstr ""
4849 "På <_:link-1/> (och omslagen om det finns några) använda en titel skild från "
4850 "den som [original]<_:link-2/> har, och skild från tidigare versioners titel "
4851 "(som skall, om det finns några, finnas listade i historikavsnittet i "
4852 "dokumentet). Du äger använda samma titel som det föregående dokumentet om "
4853 "den ursprungliga utgivaren ger sitt tillstånd."
4854
4855 #. (itstool) path: formalpara/title
4856 #: C/fdl-appendix.xml:264
4857 msgid "B"
4858 msgstr "B"
4859
4860 #. (itstool) path: formalpara/para
4861 #: C/fdl-appendix.xml:265
4862 msgid ""
4863 "List on the <_:link-1/>, as authors, one or more persons or entities "
4864 "responsible for authorship of the modifications in the <_:link-2/>, together "
4865 "with at least five of the principal authors of the <_:link-3/> (all of its "
4866 "principal authors, if it has less than five)."
4867 msgstr ""
4868 "Lista på <_:link-1/>, som författare, en eller flera personer eller "
4869 "juridiska personer som ansvarat för förändringarna i <_:link-2/>, "
4870 "tillsammans med minst fem av de huvudsakliga författarna av <_:link-3/> "
4871 "(alla dess huvudsakliga författare, om det har mindre än fem)."
4872
4873 #. (itstool) path: formalpara/title
4874 #: C/fdl-appendix.xml:279
4875 msgid "C"
4876 msgstr "C"
4877
4878 #. (itstool) path: formalpara/para
4879 #: C/fdl-appendix.xml:280
4880 msgid ""
4881 "State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as "
4882 "the publisher."
4883 msgstr "Ange namnet på utgivaren av <_:link-1/>, som utgivare, på <_:link-2/>."
4884
4885 #. (itstool) path: formalpara/title
4886 #: C/fdl-appendix.xml:291
4887 msgid "D"
4888 msgstr "D"
4889
4890 #. (itstool) path: formalpara/para
4891 #: C/fdl-appendix.xml:292
4892 msgid "Preserve all the copyright notices of the <_:link-1/>."
4893 msgstr "Bibehålla alla upphovsrättsklausuler för <_:link-1/>."
4894
4895 #. (itstool) path: formalpara/title
4896 #: C/fdl-appendix.xml:301
4897 msgid "E"
4898 msgstr "E"
4899
4900 #. (itstool) path: formalpara/para
4901 #: C/fdl-appendix.xml:302
4902 msgid ""
4903 "Add an appropriate copyright notice for your modifications adjacent to the "
4904 "other copyright notices."
4905 msgstr ""
4906 "Lägga till en upphovsrättsklausul för dina förändringar angränsande till de "
4907 "andra upphovsrättsklausulerna."
4908
4909 #. (itstool) path: formalpara/title
4910 #: C/fdl-appendix.xml:311
4911 msgid "F"
4912 msgstr "F"
4913
4914 #. (itstool) path: formalpara/para
4915 #: C/fdl-appendix.xml:312
4916 msgid ""
4917 "Include, immediately after the copyright notices, a license notice giving "
4918 "the public permission to use the <_:link-1/> under the terms of this "
4919 "License, in the form shown in the Addendum below."
4920 msgstr ""
4921 "Direkt efter upphovsrättsklausulerna innefatta ett meddelande som ger "
4922 "allmänheten tillstånd att använda <_:link-1/> under villkoren i denna licens "
4923 "[det engelska originalet] i den form som visas i Tillägg nedan."
4924
4925 #. (itstool) path: formalpara/title
4926 #: C/fdl-appendix.xml:324
4927 msgid "G"
4928 msgstr "G"
4929
4930 #. (itstool) path: para/link
4931 #: C/fdl-appendix.xml:330
4932 msgid "Document's"
4933 msgstr "dokumentets"
4934
4935 #. (itstool) path: formalpara/para
4936 #: C/fdl-appendix.xml:325
4937 msgid ""
4938 "Preserve in that license notice the full lists of <_:link-1/> and required "
4939 "<_:link-2/> given in the <_:link-3/> license notice."
4940 msgstr ""
4941 "I meddelandet om licensen bevara den fullständiga listan över <_:link-1/> "
4942 "och obligatoriska <_:link-2/> som finns i <_:link-3/> meddelande om licensen."
4943
4944 #. (itstool) path: formalpara/title
4945 #: C/fdl-appendix.xml:337
4946 msgid "H"
4947 msgstr "H"
4948
4949 #. (itstool) path: formalpara/para
4950 #: C/fdl-appendix.xml:338
4951 msgid "Include an unaltered copy of this License."
4952 msgstr ""
4953 "Inkludera en oförändrad kopia av denna licens [Det är den engelska "
4954 "originalversionen som avses]."
4955
4956 #. (itstool) path: formalpara/title
4957 #: C/fdl-appendix.xml:346
4958 msgid "I"
4959 msgstr "I"
4960
4961 #. (itstool) path: para/quote
4962 #: C/fdl-appendix.xml:348 C/fdl-appendix.xml:353 C/fdl-appendix.xml:372
4963 #: C/fdl-appendix.xml:507 C/fdl-appendix.xml:508
4964 msgid "History"
4965 msgstr "historik"
4966
4967 #. (itstool) path: formalpara/para
4968 #: C/fdl-appendix.xml:347
4969 msgid ""
4970 "Preserve the section entitled <_:quote-1/>, and its title, and add to it an "
4971 "item stating at least the title, year, new authors, and publisher of the "
4972 "<_:link-2/> as given on the <_:link-3/>. If there is no section entitled "
4973 "<_:quote-4/> in the <_:link-5/>, create one stating the title, year, "
4974 "authors, and publisher of the Document as given on its Title Page, then add "
4975 "an item describing the Modified Version as stated in the previous sentence."
4976 msgstr ""
4977 "Bevara avsnittet med titeln <_:quote-1/> (History), bevara dess titel och "
4978 "lägg i avsnittet till en post med åtminstone titeln, året, nya författare "
4979 "och utgivaren av <_:link-2/> så som angivet på <_:link-3/>. Om det inte "
4980 "finns något avsnitt med titeln <_:quote-4/> (History) i <_:link-5/> så skapa "
4981 "en med titeln, året, författare och utgivaren av dokumentet så som det står "
4982 "på [original]dokumentets titelsida. Lägg sedan till en post som beskriver "
4983 "den förändrade versionen så som beskrivits ovan."
4984
4985 #. (itstool) path: formalpara/title
4986 #: C/fdl-appendix.xml:365
4987 msgid "J"
4988 msgstr "J"
4989
4990 #. (itstool) path: formalpara/para
4991 #: C/fdl-appendix.xml:366
4992 msgid ""
4993 "Preserve the network location, if any, given in the <_:link-1/> for public "
4994 "access to a <_:link-2/> copy of the Document, and likewise the network "
4995 "locations given in the Document for previous versions it was based on. These "
4996 "may be placed in the <_:quote-3/> section. You may omit a network location "
4997 "for a work that was published at least four years before the Document "
4998 "itself, or if the original publisher of the version it refers to gives "
4999 "permission."
5000 msgstr ""
5001 "Bevara den nätverksadress, om det finns någon, angiven i <_:link-1/> till "
5002 "den allmänt tillgängliga <_:link-2/>a kopian av dokumentet, och likaså "
5003 "nätverksadresserna till de föregående versioner som dokumentet baseras på. "
5004 "Dessa får placeras i avsnittet <_:quote-3/> (History). Du äger utelämna en "
5005 "nätverksadress för ett verk som är publicerat mer än fyra år före dokumentet "
5006 "självt, eller om den ursprunglige utgivaren vars verk nätverksadressen "
5007 "hänvisar till ger sitt tillstånd."
5008
5009 #. (itstool) path: formalpara/title
5010 #: C/fdl-appendix.xml:383
5011 msgid "K"
5012 msgstr "K"
5013
5014 #. (itstool) path: para/quote
5015 #: C/fdl-appendix.xml:385 C/fdl-appendix.xml:509
5016 msgid "Acknowledgements"
5017 msgstr "tillkännagivanden"
5018
5019 #. (itstool) path: para/quote
5020 #: C/fdl-appendix.xml:386 C/fdl-appendix.xml:510
5021 msgid "Dedications"
5022 msgstr "dedikationer"
5023
5024 #. (itstool) path: formalpara/para
5025 #: C/fdl-appendix.xml:384
5026 msgid ""
5027 "In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's "
5028 "title, and preserve in the section all the substance and tone of each of the "
5029 "contributor acknowledgements and/or dedications given therein."
5030 msgstr ""
5031 "För alla avsnitt med titlarna <_:quote-1/> (Acknowledgements) eller "
5032 "<_:quote-2/> (Dedications), bevara titeln på avsnittet, och bevara allt "
5033 "innehåll och prägel på alla tillkännagivanden och/eller dedikationer gjorda "
5034 "av varje bidragsgivare."
5035
5036 #. (itstool) path: formalpara/title
5037 #: C/fdl-appendix.xml:396
5038 msgid "L"
5039 msgstr "L"
5040
5041 #. (itstool) path: formalpara/para
5042 #: C/fdl-appendix.xml:397
5043 msgid ""
5044 "Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and "
5045 "in their titles. Section numbers or the equivalent are not considered part "
5046 "of the section titles."
5047 msgstr ""
5048 "Bevara alla <_:link-1/> i <_:link-2/> oförändrade till text och titel. "
5049 "Avsnittsnummer eller motsvarande anses inte tillhöra avsnittets titel."
5050
5051 #. (itstool) path: formalpara/title
5052 #: C/fdl-appendix.xml:409
5053 msgid "M"
5054 msgstr "M"
5055
5056 #. (itstool) path: para/quote
5057 #: C/fdl-appendix.xml:412 C/fdl-appendix.xml:424 C/fdl-appendix.xml:445
5058 msgid "Endorsements"
5059 msgstr "endossering"
5060
5061 #. (itstool) path: formalpara/para
5062 #: C/fdl-appendix.xml:410
5063 msgid ""
5064 "Delete any section entitled <_:quote-1/>. Such a section may not be included "
5065 "in the <_:link-2/>."
5066 msgstr ""
5067 "Radera varje avsnitt med titeln <_:quote-1/> (Endorsements). Ett sådant "
5068 "avsnitt får inte inkluderas i en <_:link-2/>."
5069
5070 #. (itstool) path: formalpara/title
5071 #: C/fdl-appendix.xml:421
5072 msgid "N"
5073 msgstr "N"
5074
5075 #. (itstool) path: para/link
5076 #: C/fdl-appendix.xml:425
5077 msgid "Invariant Section"
5078 msgstr "oföränderligt avsnitt"
5079
5080 #. (itstool) path: formalpara/para
5081 #: C/fdl-appendix.xml:422
5082 msgid ""
5083 "Do not retitle any existing section as <_:quote-1/> or to conflict in title "
5084 "with any <_:link-2/>."
5085 msgstr ""
5086 "Inte byta titel på något existerande avsnitt så att det blir <_:quote-1/> "
5087 "(Endorsements) eller så att titeln kan förväxlas med något <_:link-2/>."
5088
5089 #. (itstool) path: sect1/para
5090 #: C/fdl-appendix.xml:432
5091 msgid ""
5092 "If the <_:link-1/> includes new front-matter sections or appendices that "
5093 "qualify as <_:link-2/> and contain no material copied from the Document, you "
5094 "may at your option designate some or all of these sections as invariant. To "
5095 "do this, add their titles to the list of <_:link-3/> in the Modified "
5096 "Version's license notice. These titles must be distinct from any other "
5097 "section titles."
5098 msgstr ""
5099 "Om <_:link-1/> innehåller nya framsidestexter eller bilagor som är att anses "
5100 "som <_:link-2/> och inte innehåller något material kopierat från dokumentet, "
5101 "så äger du, om du vill, benämna några eller samtliga av dessa som "
5102 "oföränderliga. För att göra detta, lägg deras titlar till listan över "
5103 "<_:link-3/> i den förändrade versionens licensmeddelande. Dessa titlar måste "
5104 "vara skilda från alla andra avsnitts titlar."
5105
5106 #. (itstool) path: sect1/para
5107 #: C/fdl-appendix.xml:444
5108 msgid ""
5109 "You may add a section entitled <_:quote-1/>, provided it contains nothing "
5110 "but endorsements of your <_:link-2/> by various parties--for example, "
5111 "statements of peer review or that the text has been approved by an "
5112 "organization as the authoritative definition of a standard."
5113 msgstr ""
5114 "Du äger lägga till ett avsnitt med titeln <_:quote-1/> (Endorsements), "
5115 "förutsatt att det inte innehåller något annat än endosseringar för din "
5116 "<_:link-2/> från olika aktörer -- till exempel, meddelanden om utförd "
5117 "korrekturläsning eller att texten har godkänts av en organisation som en "
5118 "officiell definition av en standard."
5119
5120 #. (itstool) path: para/link
5121 #: C/fdl-appendix.xml:455
5122 msgid "Front-Cover Text"
5123 msgstr "framsidestext"
5124
5125 #. (itstool) path: para/link
5126 #: C/fdl-appendix.xml:457
5127 msgid "Back-Cover Text"
5128 msgstr "baksidestext"
5129
5130 #. (itstool) path: sect1/para
5131 #: C/fdl-appendix.xml:453
5132 msgid ""
5133 "You may add a passage of up to five words as a <_:link-1/>, and a passage of "
5134 "up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in "
5135 "the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover "
5136 "Text may be added by (or through arrangements made by) any one entity. If "
5137 "the <_:link-5/> already includes a cover text for the same cover, previously "
5138 "added by you or by arrangement made by the same entity you are acting on "
5139 "behalf of, you may not add another; but you may replace the old one, on "
5140 "explicit permission from the previous publisher that added the old one."
5141 msgstr ""
5142 "Du äger lägga till ett textavsnitt på upp till fem ord som <_:link-1/>, och "
5143 "ett textavsnitt på upp till 25 ord som <_:link-2/> i listan över <_:link-3/> "
5144 "i <_:link-4/>. Bara ett textavsnitt med framsidestexter och ett med "
5145 "baksidestexter får läggas till av (eller genom försorg av) en enda juridisk "
5146 "person. Om <_:link-5/> redan innehåller en omslagstext för något av "
5147 "omslagen, tidigare tillagd av dig eller genom försorg av samma juridiska "
5148 "person som du företräder, äger du inte lägga till en till, men du äger ändra "
5149 "den gamla med tillstånd från den tidigare utgivaren som lade till den förra."
5150
5151 #. (itstool) path: sect1/para
5152 #: C/fdl-appendix.xml:470
5153 msgid ""
5154 "The author(s) and publisher(s) of the <_:link-1/> do not by this License "
5155 "give permission to use their names for publicity for or to assert or imply "
5156 "endorsement of any <_:link-2/>."
5157 msgstr ""
5158 "Författaren (författarna) och utgivaren (utgivarna) av <_:link-1/> ger inte "
5159 "via denna licens sitt tillstånd att använda sina namn för publicitet eller "
5160 "för att lägga till eller antyda endossering av någon <_:link-2/>."
5161
5162 #. (itstool) path: sect1/title
5163 #: C/fdl-appendix.xml:480
5164 msgid "5. COMBINING DOCUMENTS"
5165 msgstr "5. KOMBINERA DOKUMENT"
5166
5167 #. (itstool) path: para/link
5168 #: C/fdl-appendix.xml:484 C/fdl-appendix.xml:566
5169 msgid "section 4"
5170 msgstr "paragraf 4"
5171
5172 #. (itstool) path: sect1/para
5173 #: C/fdl-appendix.xml:481
5174 msgid ""
5175 "You may combine the <_:link-1/> with other documents released under this "
5176 "License, under the terms defined in <_:link-2/> above for modified versions, "
5177 "provided that you include in the combination all of the <_:link-3/> of all "
5178 "of the original documents, unmodified, and list them all as Invariant "
5179 "Sections of your combined work in its license notice."
5180 msgstr ""
5181 "Du äger kombinera <_:link-1/> med andra dokument som är utgivna under denna "
5182 "licens, under de villkor som definieras i <_:link-2/> av GNU Free "
5183 "Documentation License för förändrade versioner, förutsatt att du, i det "
5184 "kombinerade dokumentet, innefattar alla <_:link-3/> från originaldokumenten, "
5185 "omodifierade, och listar dem som oföränderliga avsnitt i ditt kombinerade "
5186 "verk i dess licensklausul, och att du bevarar alla deras "
5187 "garantiavsägelseklausuler."
5188
5189 #. (itstool) path: sect1/para
5190 #: C/fdl-appendix.xml:492
5191 msgid ""
5192 "The combined work need only contain one copy of this License, and multiple "
5193 "identical <_:link-1/> may be replaced with a single copy. If there are "
5194 "multiple Invariant Sections with the same name but different contents, make "
5195 "the title of each such section unique by adding at the end of it, in "
5196 "parentheses, the name of the original author or publisher of that section if "
5197 "known, or else a unique number. Make the same adjustment to the section "
5198 "titles in the list of Invariant Sections in the license notice of the "
5199 "combined work."
5200 msgstr ""
5201 "Det kombinerade verket behöver bara innehålla en enstaka kopia av denna "
5202 "licens [engelska originalversionen], och flera identiska <_:link-1/> kan "
5203 "ersättas med en kopia. Om det finns flera oföränderliga stycken med samma "
5204 "namn men olika innehåll, se till att titeln på varje sådant avsnitt är unik "
5205 "genom att i slutet på den, inom parentes, lägga till namnet på den "
5206 "ursprunglige författaren eller utgivaren av det avsnittet om dessa är kända, "
5207 "annars ett unikt nummer. Gör samma justeringar av titlarna i listan över "
5208 "oföränderliga avsnitt i licensklausulen i det kombinerade verket."
5209
5210 #. (itstool) path: para/quote
5211 #: C/fdl-appendix.xml:511
5212 msgid "Endorsements."
5213 msgstr "endossering"
5214
5215 #. (itstool) path: sect1/para
5216 #: C/fdl-appendix.xml:505
5217 msgid ""
5218 "In the combination, you must combine any sections entitled <_:quote-1/> in "
5219 "the various original documents, forming one section entitled <_:quote-2/>; "
5220 "likewise combine any sections entitled <_:quote-3/>, and any sections "
5221 "entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>"
5222 msgstr ""
5223 "I det kombinerade verket måste du kombinera alla avsnitt med titlarna "
5224 "<_:quote-1/> (History) i de ursprungliga dokumenten, till ett avsnitt med "
5225 "titeln <_:quote-2/> (History); på samma sätt skall alla avsnitt med titlarna "
5226 "<_:quote-3/> (Acknowledgements), alla avsnitt med titlarna <_:quote-4/> "
5227 "(Dedications) kombineras. Du måste ta bort alla avsnitt med titlarna "
5228 "<_:quote-5/> (Endorsements)."
5229
5230 #. (itstool) path: sect1/title
5231 #: C/fdl-appendix.xml:516
5232 msgid "6. COLLECTIONS OF DOCUMENTS"
5233 msgstr "6. SAMLINGAR AV DOKUMENT"
5234
5235 #. (itstool) path: sect1/para
5236 #: C/fdl-appendix.xml:517
5237 msgid ""
5238 "You may make a collection consisting of the <_:link-1/> and other documents "
5239 "released under this License, and replace the individual copies of this "
5240 "License in the various documents with a single copy that is included in the "
5241 "collection, provided that you follow the rules of this License for verbatim "
5242 "copying of each of the documents in all other respects."
5243 msgstr ""
5244 "Du äger skapa en samling bestående av <_:link-1/> och andra dokument som är "
5245 "släppta under GNU Free Documentation License, och ersätta individuella "
5246 "kopior i dokumenten av denna licens med en enda kopia [av den engelska "
5247 "originalversionen] som inkluderas i samlingen, förutsatt att du följer "
5248 "villkoren för ordagrann kopiering i denna licens för varje inkluderat "
5249 "dokument i alla andra avseenden."
5250
5251 #. (itstool) path: sect1/para
5252 #: C/fdl-appendix.xml:527
5253 msgid ""
5254 "You may extract a single document from such a collection, and distribute it "
5255 "individually under this License, provided you insert a copy of this License "
5256 "into the extracted document, and follow this License in all other respects "
5257 "regarding verbatim copying of that document."
5258 msgstr ""
5259 "Du äger lyfta ut ett dokument från en sådan samling, och sprida det enskilt "
5260 "under GNU Free Documentation License, förutsatt att du lägger till en kopia "
5261 "av denna licens [den engelska originalversionen] i det utlyfta dokumentet, "
5262 "och följer villkoren för ordagrann kopiering i denna licens för det utlyfta "
5263 "dokumentet i alla andra avseenden."
5264
5265 #. (itstool) path: sect1/title
5266 #: C/fdl-appendix.xml:537
5267 msgid "7. AGGREGATION WITH INDEPENDENT WORKS"
5268 msgstr "7. SAMMANSLAGNING MED OBEROENDE VERK"
5269
5270 #. (itstool) path: para/quote
5271 #: C/fdl-appendix.xml:546
5272 msgid "aggregate"
5273 msgstr "sammanslagning"
5274
5275 #. (itstool) path: para/link
5276 #: C/fdl-appendix.xml:550
5277 msgid "Cover Text"
5278 msgstr "Omslagstext"
5279
5280 # sebras
5281 #. (itstool) path: sect1/para
5282 #: C/fdl-appendix.xml:538
5283 msgid ""
5284 "A compilation of the <_:link-1/> or its derivatives with other separate and "
5285 "independent documents or works, in or on a volume of a storage or "
5286 "distribution medium, does not as a whole count as a <_:link-2/> of the "
5287 "Document, provided no compilation copyright is claimed for the compilation. "
5288 "Such a compilation is called an <_:quote-3/>, and this License does not "
5289 "apply to the other self-contained works thus compiled with the Document , on "
5290 "account of their being thus compiled, if they are not themselves derivative "
5291 "works of the Document. If the <_:link-4/> requirement of <_:link-5/> is "
5292 "applicable to these copies of the Document, then if the Document is less "
5293 "than one quarter of the entire aggregate, the Document's Cover Texts may be "
5294 "placed on covers that surround only the Document within the aggregate. "
5295 "Otherwise they must appear on covers around the whole aggregate."
5296 msgstr ""
5297 "En samling av <_:link-1/> eller av dess derivat med andra separata och "
5298 "oberoende dokument eller verk, på eller i en lagringsvolym eller ett "
5299 "spridningsmedium, kallas för en <quote>sammanslagning</quote> om den "
5300 "sammanslagna upphovsrätten inte används för att begränsa samlingens "
5301 "användares rättigheter som de enskilda dokumenten medger. När dokumentet "
5302 "ingår i en sådan sammanslagning, gäller inte denna licens de andra verken i "
5303 "samlingen som inte själva är deriverat av dokumentet. Om kravet på <link "
5304 "linkend=\"fdl-cover-texts\">omslagstexter</link> enligt <link linkend=\"fdl-"
5305 "section3\">paragraf 3</link> är tillämpligt på dessa kopior av dokumentet, "
5306 "så kan dokumentets omslagstexter, om dokumentet utgör mindre än en fjärdedel "
5307 "av hela samlingen, placeras på det omslag som omger dokumentet inuti "
5308 "samlingen, eller den elektroniska motsvarigheten till omslag om dokumentet "
5309 "är i elektronisk form. Annars måste de synas på det omslag som omger hela "
5310 "samlingen."
5311
5312 #. (itstool) path: sect1/title
5313 #: C/fdl-appendix.xml:561
5314 msgid "8. TRANSLATION"
5315 msgstr "8. ÖVERSÄTTNING"
5316
5317 #. (itstool) path: sect1/para
5318 #: C/fdl-appendix.xml:562
5319 msgid ""
5320 "Translation is considered a kind of modification, so you may distribute "
5321 "translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing "
5322 "<_:link-3/> with translations requires special permission from their "
5323 "copyright holders, but you may include translations of some or all Invariant "
5324 "Sections in addition to the original versions of these Invariant Sections. "
5325 "You may include a translation of this License provided that you also include "
5326 "the original English version of this License. In case of a disagreement "
5327 "between the translation and the original English version of this License, "
5328 "the original English version will prevail."
5329 msgstr ""
5330 "Översättning anses vara en sorts förändring, så du äger sprida "
5331 "översättningar av <_:link-1/> enligt de villkor som sätts i <_:link-2/>. "
5332 "<_:link-3/> som ersätts med översättningar kräver tillstånd från deras "
5333 "upphovsrättsinnehavare, men du äger inkludera översättningar av alla eller "
5334 "vissa av dessa oföränderliga avsnitt tillsammans med originalversionerna av "
5335 "dessa oföränderliga avsnitt. Du äger inkludera en översättning av denna "
5336 "licens, och alla licensklausuler i dokumentet, och alla garantiavsägelser, "
5337 "förutsatt att du också innefattar den engelska originalversionen av denna "
5338 "licens och originalversionerna av dessa klausuler. Skulle det finnas "
5339 "skillnader mellan översättningen och originalversionen av denna licens eller "
5340 "någon klausul så gäller originalversionen."
5341
5342 #. (itstool) path: sect1/title
5343 #: C/fdl-appendix.xml:580
5344 msgid "9. TERMINATION"
5345 msgstr "9. UPPHÖRANDE"
5346
5347 #. (itstool) path: sect1/para
5348 #: C/fdl-appendix.xml:581
5349 msgid ""
5350 "You may not copy, modify, sublicense, or distribute the <_:link-1/> except "
5351 "as expressly provided for under this License. Any other attempt to copy, "
5352 "modify, sublicense or distribute the Document is void, and will "
5353 "automatically terminate your rights under this License. However, parties who "
5354 "have received copies, or rights, from you under this License will not have "
5355 "their licenses terminated so long as such parties remain in full compliance."
5356 msgstr ""
5357 "Du äger inte kopiera, förändra, omlicensiera eller sprida <_:link-1/> annat "
5358 "än enligt villkoren i GNU Free Documentation License. Alla övriga försök att "
5359 "kopiera, modifiera, omlicensiera, eller sprida dokumentet är ogiltiga och "
5360 "kommer automatiskt medföra att du förlorar dina rättigheter enligt denna "
5361 "licens. Tredje man som har mottagit kopior eller rättigheter från dig enligt "
5362 "dessa licensvillkor kommer dock inte att förlora sina rättigheter så länge "
5363 "de följer licensvillkoren."
5364
5365 #. (itstool) path: sect1/title
5366 #: C/fdl-appendix.xml:594
5367 msgid "10. FUTURE REVISIONS OF THIS LICENSE"
5368 msgstr "10. FRAMTIDA VERSIONER AV DENNA LICENS"
5369
5370 #. (itstool) path: para/ulink
5371 #: C/fdl-appendix.xml:597
5372 msgid "Free Software Foundation"
5373 msgstr "Free Software Foundation"
5374
5375 #. (itstool) path: para/ulink
5376 #: C/fdl-appendix.xml:603
5377 msgid "http://www.gnu.org/copyleft/"
5378 msgstr "http://www.gnu.org/copyleft/"
5379
5380 #. (itstool) path: sect1/para
5381 #: C/fdl-appendix.xml:595
5382 msgid ""
5383 "The <_:ulink-1/> may publish new, revised versions of the GNU Free "
5384 "Documentation License from time to time. Such new versions will be similar "
5385 "in spirit to the present version, but may differ in detail to address new "
5386 "problems or concerns. See <_:ulink-2/>."
5387 msgstr ""
5388 "<_:ulink-1/> kan publicera nya, reviderade versioner av GNU Free "
5389 "Documentation License då och då. Sådana nya versioner kommer att vara "
5390 "likadana i andemening som den nuvarande versionen, men kan skilja i detalj "
5391 "för att behandla nya problem eller angelägenheter. Se <_:ulink-2/>."
5392
5393 #. (itstool) path: para/quote
5394 #: C/fdl-appendix.xml:610
5395 msgid "or any later version"
5396 msgstr "eller valfri senare version"
5397
5398 #. (itstool) path: sect1/para
5399 #: C/fdl-appendix.xml:606
5400 msgid ""
5401 "Each version of the License is given a distinguishing version number. If the "
5402 "<_:link-1/> specifies that a particular numbered version of this License "
5403 "<_:quote-2/> applies to it, you have the option of following the terms and "
5404 "conditions either of that specified version or of any later version that has "
5405 "been published (not as a draft) by the Free Software Foundation. If the "
5406 "Document does not specify a version number of this License, you may choose "
5407 "any version ever published (not as a draft) by the Free Software Foundation."
5408 msgstr ""
5409 "Varje version av licensen ges ett unikt versionsnummer. Om <_:link-1/> "
5410 "stadgar att en specifik numrerad version av denna licens <_:quote-2/> gäller "
5411 "för det, så äger du rätten att följa villkoren enligt antingen den angivna "
5412 "versionen eller vilken senare version som helst som publicerats (inte som "
5413 "utkast) av Free Software Foundation. Om dokumentet inte anger en version av "
5414 "denna licens, äger du välja vilken version som helst som publicerats (inte "
5415 "som utkast) av Free Software Foundation."
5416
5417 #. (itstool) path: sect1/title
5418 #: C/fdl-appendix.xml:621
5419 msgid "Addendum"
5420 msgstr "TILLÄGG"
5421
5422 #. (itstool) path: sect1/para
5423 #: C/fdl-appendix.xml:622
5424 msgid ""
5425 "To use this License in a document you have written, include a copy of the "
5426 "License in the document and put the following copyright and license notices "
5427 "just after the title page:"
5428 msgstr ""
5429 "För att använda GNU Free Documentation License för ett dokument du har "
5430 "skrivit, inkludera en kopia av licensen [det engelska originalet] i "
5431 "dokumentet och placera följande copyrightklausul omedelbart efter titelsidan:"
5432
5433 #. (itstool) path: blockquote/para
5434 #: C/fdl-appendix.xml:629
5435 msgid "Copyright YEAR YOUR NAME."
5436 msgstr "Copyright © YEAR YOUR NAME."
5437
5438 #. (itstool) path: para/link
5439 #: C/fdl-appendix.xml:639 C/fdl-appendix.xml:651
5440 msgid "Front-Cover Texts"
5441 msgstr "Front-Cover Texts"
5442
5443 #. (itstool) path: para/link
5444 #: C/fdl-appendix.xml:640 C/fdl-appendix.xml:654
5445 msgid "Back-Cover Texts"
5446 msgstr "Back-Cover Texts"
5447
5448 # <_:link-1/> blir "oföränderliga avsnitten"
5449 #. (itstool) path: blockquote/para
5450 #: C/fdl-appendix.xml:632
5451 msgid ""
5452 "Permission is granted to copy, distribute and/or modify this document under "
5453 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5454 "version published by the Free Software Foundation; with the <_:link-1/> "
5455 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the "
5456 "<_:link-3/> being LIST. A copy of the license is included in the section "
5457 "entitled <_:quote-4/>."
5458 msgstr ""
5459 "Permission is granted to copy, distribute and/or modify this document under "
5460 "the terms of the GNU Free Documentation License, Version 1.1 or any later "
5461 "version published by the Free Software Foundation; with the <_:link-1/> "
5462 "being LIST THEIR TITLES, with the <_:link-2/> being LIST, and with the "
5463 "<_:link-3/> being LIST. A copy of the license is included in the section "
5464 "entitled <_:quote-4/>."
5465
5466 #. (itstool) path: para/quote
5467 #: C/fdl-appendix.xml:649
5468 msgid "with no Invariant Sections"
5469 msgstr "with no Invariant Sections"
5470
5471 #. (itstool) path: para/quote
5472 #: C/fdl-appendix.xml:652
5473 msgid "no Front-Cover Texts"
5474 msgstr "no Front-Cover Texts"
5475
5476 #. (itstool) path: para/quote
5477 #: C/fdl-appendix.xml:653
5478 msgid "Front-Cover Texts being LIST"
5479 msgstr "Front-Cover Texts being LIST"
5480
5481 #. (itstool) path: sect1/para
5482 #: C/fdl-appendix.xml:647
5483 msgid ""
5484 "If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones "
5485 "are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of "
5486 "<_:quote-5/>; likewise for <_:link-6/>."
5487 msgstr ""
5488 "Om du inte har några <_:link-1/>, skriv <_:quote-2/> istället för att ange "
5489 "vilka som är oföränderliga. Om du inte har några <_:link-3/>, skriv "
5490 "<_:quote-4/> istället för <_:quote-5/>; såväl som för <_:link-6/>."
5491
5492 #. (itstool) path: para/ulink
5493 #: C/fdl-appendix.xml:661
5494 msgid "GNU General Public License"
5495 msgstr "GNU General Public License"
5496
5497 #. (itstool) path: sect1/para
5498 #: C/fdl-appendix.xml:657
5499 msgid ""
5500 "If your document contains nontrivial examples of program code, we recommend "
5501 "releasing these examples in parallel under your choice of free software "
5502 "license, such as the <_:ulink-1/>, to permit their use in free software."
5503 msgstr ""
5504 "Om ditt dokument innehåller icke-triviala exempel med programkod, så "
5505 "rekommenderar vi att du släpper dessa exempel parallellt under en, av dig "
5506 "vald, fri programvarulicens, som till exempel <_:ulink-1/>, för att "
5507 "möjliggöra deras användning i fri programvara."
5508
5509 #~ msgid "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5510 #~ msgstr "<year>2000</year><holder>Free Software Foundation, Inc.</holder>"
5511
5512 #, no-wrap
5513 #~ msgid ""
5514 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5515 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5516 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5517 #~ msgstr ""
5518 #~ "Free Software Foundation, Inc. <street>51 Franklin Street, \n"
5519 #~ " Suite 330</street>, <city>Boston</city>, <state>MA</state> \n"
5520 #~ " <postcode>02110-1301</postcode> <country>USA</country>"
5521
5522 #~ msgid ""
5523 #~ "The purpose of this License is to make a manual, textbook, or other "
5524 #~ "written document <quote>free</quote> in the sense of freedom: to assure "
5525 #~ "everyone the effective freedom to copy and redistribute it, with or "
5526 #~ "without modifying it, either commercially or noncommercially. "
5527 #~ "Secondarily, this License preserves for the author and publisher a way to "
5528 #~ "get credit for their work, while not being considered responsible for "
5529 #~ "modifications made by others."
5530 #~ msgstr ""
5531 #~ "Syftet med denna licens är att göra en handbok, bok, eller annat "
5532 #~ "praktiskt och användbart dokument <quote>fritt</quote> som i frihet: att "
5533 #~ "försäkra var och en den faktiska friheten att kopiera och sprida det "
5534 #~ "vidare, med eller utan förändringar, antingen kommersiellt eller ideellt. "
5535 #~ "Sekundärt bevarar denna licens ett sätt för författaren och förläggaren "
5536 #~ "att få ära för deras arbete utan att de anses vara ansvariga för "
5537 #~ "förändringar gjorda av andra."
5538
5539 #~ msgid ""
5540 #~ "This License is a kind of <quote>copyleft</quote>, which means that "
5541 #~ "derivative works of the document must themselves be free in the same "
5542 #~ "sense. It complements the GNU General Public License, which is a copyleft "
5543 #~ "license designed for free software."
5544 #~ msgstr ""
5545 #~ "Denna Licens är en sorts <quote>copyleft</quote>, vilket betyder att "
5546 #~ "derivativa verk av detta dokument själva måste vara fria på samma sätt. "
5547 #~ "Den kompletterar GNU General Public License, som är en copyleft-licens "
5548 #~ "utformad för fri programvara."
5549
5550 #~ msgid ""
5551 #~ "This License applies to any manual or other work that contains a notice "
5552 #~ "placed by the copyright holder saying it can be distributed under the "
5553 #~ "terms of this License. The <quote>Document</quote>, below, refers to any "
5554 #~ "such manual or work. Any member of the public is a licensee, and is "
5555 #~ "addressed as <quote>you</quote>."
5556 #~ msgstr ""
5557 #~ "Denna licens [det engelska originalet] gäller för varje handbok eller "
5558 #~ "annat verk, oavsett uttrycksform, som innehåller ett meddelande där "
5559 #~ "upphovsrättsinnehavaren stadgat att verket kan spridas enligt villkoren i "
5560 #~ "GNU Free Documentation License. Ett sådant meddelande ger en "
5561 #~ "internationell frihet utan krav på ersättning och utan tidsbegränsning "
5562 #~ "att använda verket under villkoren i denna licens [det engelska "
5563 #~ "originalet]. <quote>Dokument</quote> nedan syftar på godtycklig handbok "
5564 #~ "eller verk. Var och en är licenstagare och benämns som <quote>du</quote>."
5565
5566 #~ msgid ""
5567 #~ "A <quote>Modified Version</quote> of the Document means any work "
5568 #~ "containing the Document or a portion of it, either copied verbatim, or "
5569 #~ "with modifications and/or translated into another language."
5570 #~ msgstr ""
5571 #~ "En <quote>förändrad version</quote> av dokumentet avser varje verk som "
5572 #~ "innehåller dokumentet eller en del av det, antingen ordagranna kopior, "
5573 #~ "eller med ändringar och/eller översatt till ett annat språk."
5574
5575 #~ msgid ""
5576 #~ "A <quote>Secondary Section</quote> is a named appendix or a front-matter "
5577 #~ "section of the <link linkend=\"fdl-document\">Document</link> that deals "
5578 #~ "exclusively with the relationship of the publishers or authors of the "
5579 #~ "Document to the Document's overall subject (or to related matters) and "
5580 #~ "contains nothing that could fall directly within that overall subject. "
5581 #~ "(For example, if the Document is in part a textbook of mathematics, a "
5582 #~ "Secondary Section may not explain any mathematics.) The relationship "
5583 #~ "could be a matter of historical connection with the subject or with "
5584 #~ "related matters, or of legal, commercial, philosophical, ethical or "
5585 #~ "political position regarding them."
5586 #~ msgstr ""
5587 #~ "Ett <quote>sekundärt avsnitt</quote> är en märkt bilaga eller förord till "
5588 #~ "<link linkend=\"fdl-document\">dokumentet</link> som exklusivt behandlar "
5589 #~ "förhållandet mellan dokumentets förläggare eller författare och "
5590 #~ "dokumentets huvudsakliga ämne (eller till relaterade ämnen) och som inte "
5591 #~ "innehåller något som direkt faller under det huvudsakliga ämnet. "
5592 #~ "(Således, om dokumentet delvis är en lärobok i matematik så får ett "
5593 #~ "sekundärt avsnitt inte förklara någon matematik.) Förhållandet kan vara "
5594 #~ "en historisk koppling till ämnet eller något relaterat, eller en "
5595 #~ "juridisk, kommersiell, filosofisk, etisk eller politisk ställning till "
5596 #~ "det."
5597
5598 #~ msgid ""
5599 #~ "The <quote>Invariant Sections</quote> are certain <link linkend=\"fdl-"
5600 #~ "secondary\"> Secondary Sections</link> whose titles are designated, as "
5601 #~ "being those of Invariant Sections, in the notice that says that the <link "
5602 #~ "linkend=\"fdl-document\">Document</link> is released under this License."
5603 #~ msgstr ""
5604 #~ "De <quote>oföränderliga avsnitten</quote> är <link linkend=\"fdl-"
5605 #~ "secondary\">sekundära avsnitt</link> vars titlar är angivna som "
5606 #~ "oföränderliga avsnitt i meddelandet som stadgar att <link linkend=\"fdl-"
5607 #~ "document\">dokumentet</link> är utgivet under denna licens [det engelska "
5608 #~ "originalet]."
5609
5610 #~ msgid ""
5611 #~ "The <quote>Cover Texts</quote> are certain short passages of text that "
5612 #~ "are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that "
5613 #~ "says that the <link linkend=\"fdl-document\">Document</link> is released "
5614 #~ "under this License."
5615 #~ msgstr ""
5616 #~ "<quote>Omslagstexterna</quote> är speciella korta ordföljder som är "
5617 #~ "listade som framsidestexter eller baksidestexter i meddelandet som "
5618 #~ "stadgar att <link linkend=\"fdl-document\">dokumentet</link> är utgivet "
5619 #~ "under denna licens [det engelska originalet]."
5620
5621 #~ msgid ""
5622 #~ "A <quote>Transparent</quote> copy of the <link linkend=\"fdl-document\"> "
5623 #~ "Document</link> means a machine-readable copy, represented in a format "
5624 #~ "whose specification is available to the general public, whose contents "
5625 #~ "can be viewed and edited directly and straightforwardly with generic text "
5626 #~ "editors or (for images composed of pixels) generic paint programs or (for "
5627 #~ "drawings) some widely available drawing editor, and that is suitable for "
5628 #~ "input to text formatters or for automatic translation to a variety of "
5629 #~ "formats suitable for input to text formatters. A copy made in an "
5630 #~ "otherwise Transparent file format whose markup has been designed to "
5631 #~ "thwart or discourage subsequent modification by readers is not "
5632 #~ "Transparent. A copy that is not <quote>Transparent</quote> is called "
5633 #~ "<quote>Opaque</quote>."
5634 #~ msgstr ""
5635 #~ "En <quote>transparent</quote> kopia av <link linkend=\"fdl-"
5636 #~ "document\">dokumentet</link> är en maskinläsbar kopia, representerad i "
5637 #~ "ett format vars specifikation finns tillgänglig för allmänheten, som "
5638 #~ "lämpar sig för att revidera dokumentet på ett enkelt sätt med generella "
5639 #~ "textredigeringsprogram eller (för pixelbaserade bilder) generella "
5640 #~ "grafikprogram eller (för ritningar) något väl tillgängligt ritprogram, "
5641 #~ "och som är passande som indata till textformaterare eller för automatisk "
5642 #~ "konvertering till en mängd format som passar som indata till "
5643 #~ "textformaterare. En kopia i ett för övrigt transparent filformat vars "
5644 #~ "markeringar, eller avsaknad av markeringar, har ordnats för att hindra "
5645 #~ "eller motverka att vidare förändring vidtas av läsare är inte "
5646 #~ "transparent. En kopia som inte är <quote>transparent</quote> kallas "
5647 #~ "<quote>opak</quote>."
5648
5649 #~ msgid ""
5650 #~ "The <quote>Title Page</quote> means, for a printed book, the title page "
5651 #~ "itself, plus such following pages as are needed to hold, legibly, the "
5652 #~ "material this License requires to appear in the title page. For works in "
5653 #~ "formats which do not have any title page as such, <quote>Title Page</"
5654 #~ "quote> means the text near the most prominent appearance of the work's "
5655 #~ "title, preceding the beginning of the body of the text."
5656 #~ msgstr ""
5657 #~ "<quote>Titelsidan</quote> innebär, för en tryckt bok, titelsidan själv, "
5658 #~ "och sådana därpå följande sidor som krävs för att göra det material som "
5659 #~ "enligt denna licens skall synas på titelsidan läsbart. För verk i sådana "
5660 #~ "format som inte har någon egentlig titelsida, avses med <quote>titelsida</"
5661 #~ "quote> den text som är närmast den mest framstående förekomsten av "
5662 #~ "verkets titel, föregående den huvudsakliga textmassan."
5663
5664 #~ msgid ""
5665 #~ "You may copy and distribute the <link linkend=\"fdl-document\">Document</"
5666 #~ "link> in any medium, either commercially or noncommercially, provided "
5667 #~ "that this License, the copyright notices, and the license notice saying "
5668 #~ "this License applies to the Document are reproduced in all copies, and "
5669 #~ "that you add no other conditions whatsoever to those of this License. You "
5670 #~ "may not use technical measures to obstruct or control the reading or "
5671 #~ "further copying of the copies you make or distribute. However, you may "
5672 #~ "accept compensation in exchange for copies. If you distribute a large "
5673 #~ "enough number of copies you must also follow the conditions in <link "
5674 #~ "linkend=\"fdl-section3\">section 3</link>."
5675 #~ msgstr ""
5676 #~ "Du äger kopiera och sprida <link linkend=\"fdl-document\">dokumentet</"
5677 #~ "link> på valfritt medium, antingen kommersiellt eller ideellt, förutsatt "
5678 #~ "att denna licens [det engelska originalet], upphovsrättsklausul, och "
5679 #~ "meddelandet som stadgar att GNU Free Documentation License gäller för "
5680 #~ "dokumentet finns med på alla kopior, och att du inte lägger till några "
5681 #~ "som helst andra villkor än de som ingår i denna licens. Du äger inte "
5682 #~ "vidta tekniska åtgärder för att begränsa eller kontrollera läsande eller "
5683 #~ "vidare kopiering av de kopior du skapar eller sprider. Dock äger du ta "
5684 #~ "emot kompensation i utbyte mot kopior. Om du sprider tillräckligt många "
5685 #~ "kopior måste du också följa villkoren i <link linkend=\"fdl-"
5686 #~ "section3\">paragraf 3</link>."
5687
5688 #~ msgid ""
5689 #~ "If you publish printed copies of the <link linkend=\"fdl-"
5690 #~ "document\">Document</link> numbering more than 100, and the Document's "
5691 #~ "license notice requires <link linkend=\"fdl-cover-texts\">Cover Texts</"
5692 #~ "link>, you must enclose the copies in covers that carry, clearly and "
5693 #~ "legibly, all these Cover Texts: Front-Cover Texts on the front cover, and "
5694 #~ "Back-Cover Texts on the back cover. Both covers must also clearly and "
5695 #~ "legibly identify you as the publisher of these copies. The front cover "
5696 #~ "must present the full title with all words of the title equally prominent "
5697 #~ "and visible. You may add other material on the covers in addition. "
5698 #~ "Copying with changes limited to the covers, as long as they preserve the "
5699 #~ "title of the <link linkend=\"fdl-document\">Document</link> and satisfy "
5700 #~ "these conditions, can be treated as verbatim copying in other respects."
5701 #~ msgstr ""
5702 #~ "Om du publicerar tryckta kopior (eller kopior i medier som normalt har "
5703 #~ "tryckta omslag) av <link linkend=\"fdl-document\">dokumentet</link>, i en "
5704 #~ "upplaga överstigande 100 exemplar, och dokumentets licensmeddelande "
5705 #~ "kräver <link linkend=\"fdl-cover-texts\">omslagstexter</link>, så måste "
5706 #~ "du förse kopiorna med omslag som, klart och tydligt, visar alla "
5707 #~ "omslagstexter: framsidestexter på framsidan och baksidestexter på "
5708 #~ "baksidan. Båda omslagen måste klart och tydligt identifiera dig som "
5709 #~ "utgivare av dessa kopior. Framsidan måste presentera dokumentets hela "
5710 #~ "titel, med alla ord i titeln lika framträdande och synliga. Du äger lägga "
5711 #~ "till ytterligare stoff på omslagen. Kopiering med förändringar gjorda "
5712 #~ "bara på omslaget, så länge som de bevarar <link linkend=\"fdl-"
5713 #~ "document\">dokumentets</link> titel och i övrigt uppfyller dessa krav kan "
5714 #~ "anses vara ordagrann kopiering i andra avseenden."
5715
5716 #~ msgid ""
5717 #~ "If you publish or distribute <link linkend=\"fdl-transparent\">Opaque</"
5718 #~ "link> copies of the <link linkend=\"fdl-document\">Document</link> "
5719 #~ "numbering more than 100, you must either include a machine-readable <link "
5720 #~ "linkend=\"fdl-transparent\">Transparent</link> copy along with each "
5721 #~ "Opaque copy, or state in or with each Opaque copy a publicly-accessible "
5722 #~ "computer-network location containing a complete Transparent copy of the "
5723 #~ "Document, free of added material, which the general network-using public "
5724 #~ "has access to download anonymously at no charge using public-standard "
5725 #~ "network protocols. If you use the latter option, you must take reasonably "
5726 #~ "prudent steps, when you begin distribution of Opaque copies in quantity, "
5727 #~ "to ensure that this Transparent copy will remain thus accessible at the "
5728 #~ "stated location until at least one year after the last time you "
5729 #~ "distribute an Opaque copy (directly or through your agents or retailers) "
5730 #~ "of that edition to the public."
5731 #~ msgstr ""
5732 #~ "Om du publicerar <link linkend=\"fdl-transparent\">opaka</link> kopior av "
5733 #~ "<link linkend=\"fdl-document\">dokumentet</link> i upplagor om mer än "
5734 #~ "100, måste du antingen bifoga en maskinläsbar <link linkend=\"fdl-"
5735 #~ "transparent\">transparent</link> kopia med varje opak kopia, eller ange i "
5736 #~ "eller med varje opak kopia en nätverksadress som är tillgänglig för den "
5737 #~ "allmänna nätverksanvändande massan där man, med öppet standardiserade "
5738 #~ "protokoll, anonymt och utan kostnad kan ladda ner en komplett transparent "
5739 #~ "kopia av dokumentet, utan extra material. Om du väljer det senare "
5740 #~ "alternativet, måste du vidta skäliga åtgärder, när du börjar sprida opaka "
5741 #~ "kopior i kvantitet, för att denna transparenta kopia skall förbli "
5742 #~ "tillgänglig på angivna platsen till åtminstone ett år efter den sista "
5743 #~ "gången du spred en opak kopia (direkt eller via ombud eller "
5744 #~ "återförsäljare) av den utgåvan till allmänheten."
5745
5746 #~ msgid ""
5747 #~ "It is requested, but not required, that you contact the authors of the "
5748 #~ "<link linkend=\"fdl-document\">Document</link> well before redistributing "
5749 #~ "any large number of copies, to give them a chance to provide you with an "
5750 #~ "updated version of the Document."
5751 #~ msgstr ""
5752 #~ "Det är önskvärt, men inte ett krav, att du kontaktar författarna till "
5753 #~ "<link linkend=\"fdl-document\">dokumentet</link> i god tid innan du "
5754 #~ "sprider något större antal kopior, för att ge dem en chans att förse dig "
5755 #~ "med en uppdaterad version av dokumentet."
5756
5757 #~ msgid ""
5758 #~ "You may copy and distribute a <link linkend=\"fdl-modified\">Modified "
5759 #~ "Version</link> of the <link linkend=\"fdl-document\">Document</link> "
5760 #~ "under the conditions of sections <link linkend=\"fdl-section2\">2</link> "
5761 #~ "and <link linkend=\"fdl-section3\">3</link> above, provided that you "
5762 #~ "release the Modified Version under precisely this License, with the "
5763 #~ "Modified Version filling the role of the Document, thus licensing "
5764 #~ "distribution and modification of the Modified Version to whoever "
5765 #~ "possesses a copy of it. In addition, you must do these things in the "
5766 #~ "Modified Version:"
5767 #~ msgstr ""
5768 #~ "Du äger kopiera och sprida en <link linkend=\"fdl-modified\">förändrad "
5769 #~ "version</link> av <link linkend=\"fdl-document\">dokumentet</link> under "
5770 #~ "de villkor som beskrivs i paragraf <link linkend=\"fdl-section2\">2</"
5771 #~ "link> och <link linkend=\"fdl-section3\">3</link> av GNU Free "
5772 #~ "Documentation License, förutsatt att du släpper den förändrade versionen "
5773 #~ "under exakt denna licens, och att den förändrade versionen antar "
5774 #~ "dokumentets roll, och således medger spridning och förändring av den "
5775 #~ "förändrade versionen till envar som erhåller en kopia av den. Utöver "
5776 #~ "detta måste du göra följande med den ändrade versionen:"
5777
5778 #~ msgid ""
5779 #~ "Use in the <link linkend=\"fdl-title-page\">Title Page</link> (and on the "
5780 #~ "covers, if any) a title distinct from that of the <link linkend=\"fdl-"
5781 #~ "document\">Document</link>, and from those of previous versions (which "
5782 #~ "should, if there were any, be listed in the History section of the "
5783 #~ "Document). You may use the same title as a previous version if the "
5784 #~ "original publisher of that version gives permission."
5785 #~ msgstr ""
5786 #~ "På <link linkend=\"fdl-title-page\">titelsidan</link> (och omslagen om "
5787 #~ "det finns några) använda en titel skild från den som [original]<link "
5788 #~ "linkend=\"fdl-document\">dokumentet</link> har, och skild från tidigare "
5789 #~ "versioners titel (som skall, om det finns några, finnas listade i "
5790 #~ "historikavsnittet i dokumentet). Du äger använda samma titel som det "
5791 #~ "föregående dokumentet om den ursprungliga utgivaren ger sitt tillstånd."
5792
5793 #~ msgid ""
5794 #~ "List on the <link linkend=\"fdl-title-page\">Title Page</link>, as "
5795 #~ "authors, one or more persons or entities responsible for authorship of "
5796 #~ "the modifications in the <link linkend=\"fdl-modified\">Modified Version</"
5797 #~ "link>, together with at least five of the principal authors of the <link "
5798 #~ "linkend=\"fdl-document\">Document</link> (all of its principal authors, "
5799 #~ "if it has less than five)."
5800 #~ msgstr ""
5801 #~ "Lista på <link linkend=\"fdl-title-page\">titelsidan</link>, som "
5802 #~ "författare, en eller flera personer eller juridiska personer som ansvarat "
5803 #~ "för förändringarna i den <link linkend=\"fdl-modified\">förändrade "
5804 #~ "versionen</link>, tillsammans med minst fem av de huvudsakliga "
5805 #~ "författarna av <link linkend=\"fdl-document\">dokumentet</link> (alla "
5806 #~ "dess huvudsakliga författare, om det har mindre än fem)."
5807
5808 #~ msgid ""
5809 #~ "Preserve all the copyright notices of the <link linkend=\"fdl-"
5810 #~ "document\">Document</link>."
5811 #~ msgstr ""
5812 #~ "Bibehålla <link linkend=\"fdl-document\">dokumentets</link> alla "
5813 #~ "upphovsrättsklausuler."
5814
5815 #~ msgid ""
5816 #~ "Include, immediately after the copyright notices, a license notice giving "
5817 #~ "the public permission to use the <link linkend=\"fdl-modified\">Modified "
5818 #~ "Version</link> under the terms of this License, in the form shown in the "
5819 #~ "Addendum below."
5820 #~ msgstr ""
5821 #~ "Direkt efter upphovsrättsklausulerna innefatta ett meddelande som ger "
5822 #~ "allmänheten tillstånd att använda den <link linkend=\"fdl-"
5823 #~ "modified\">förändrade versionen</link> under villkoren i denna licens "
5824 #~ "[det engelska originalet] i den form som visas i Tillägg nedan."
5825
5826 #~ msgid ""
5827 #~ "Preserve in that license notice the full lists of <link linkend=\"fdl-"
5828 #~ "invariant\"> Invariant Sections</link> and required <link linkend=\"fdl-"
5829 #~ "cover-texts\">Cover Texts</link> given in the <link linkend=\"fdl-"
5830 #~ "document\">Document's</link> license notice."
5831 #~ msgstr ""
5832 #~ "I meddelandet om licensen bevara den fullständiga listan över <link "
5833 #~ "linkend=\"fdl-invariant\">oföränderliga avsnitt</link> och obligatoriska "
5834 #~ "<link linkend=\"fdl-cover-texts\">omslagstexter</link> som finns i <link "
5835 #~ "linkend=\"fdl-document\">dokumentets</link> meddelande om licensen."
5836
5837 #~ msgid ""
5838 #~ "Preserve the section entitled <quote>History</quote>, and its title, and "
5839 #~ "add to it an item stating at least the title, year, new authors, and "
5840 #~ "publisher of the <link linkend=\"fdl-modified\">Modified Version</link> "
5841 #~ "as given on the <link linkend=\"fdl-title-page\">Title Page</link>. If "
5842 #~ "there is no section entitled <quote>History</quote> in the <link "
5843 #~ "linkend=\"fdl-document\">Document</link>, create one stating the title, "
5844 #~ "year, authors, and publisher of the Document as given on its Title Page, "
5845 #~ "then add an item describing the Modified Version as stated in the "
5846 #~ "previous sentence."
5847 #~ msgstr ""
5848 #~ "Bevara avsnittet med titeln <quote>historik</quote> (History), bevara "
5849 #~ "dess titel och lägg i avsnittet till en post med åtminstone titeln, året, "
5850 #~ "nya författare och utgivaren av den <link linkend=\"fdl-"
5851 #~ "modified\">förändrade versionen</link> så som angivet på <link "
5852 #~ "linkend=\"fdl-title-page\">titelsidan</link>. Om det inte finns något "
5853 #~ "avsnitt med titeln <quote>historik</quote> (History) i <link "
5854 #~ "linkend=\"fdl-document\">dokumentet</link> så skapa en med titeln, året, "
5855 #~ "författare och utgivaren av dokumentet så som det står på "
5856 #~ "[original]dokumentets titelsida. Lägg sedan till en post som beskriver "
5857 #~ "den förändrade versionen så som beskrivits ovan."
5858
5859 #~ msgid ""
5860 #~ "Preserve the network location, if any, given in the <link linkend=\"fdl-"
5861 #~ "document\">Document</link> for public access to a <link linkend=\"fdl-"
5862 #~ "transparent\">Transparent</link> copy of the Document, and likewise the "
5863 #~ "network locations given in the Document for previous versions it was "
5864 #~ "based on. These may be placed in the <quote>History</quote> section. You "
5865 #~ "may omit a network location for a work that was published at least four "
5866 #~ "years before the Document itself, or if the original publisher of the "
5867 #~ "version it refers to gives permission."
5868 #~ msgstr ""
5869 #~ "Bevara den nätverksadress, om det finns någon, angiven i <link "
5870 #~ "linkend=\"fdl-document\">dokumentet</link> till den allmänt tillgängliga "
5871 #~ "<link linkend=\"fdl-transparent\">transparenta</link> kopian av "
5872 #~ "dokumentet, och likaså nätverksadresserna till de föregående versioner "
5873 #~ "som dokumentet baseras på. Dessa får placeras i avsnittet "
5874 #~ "<quote>historik</quote> (History). Du äger utelämna en nätverksadress för "
5875 #~ "ett verk som är publicerat mer än fyra år före dokumentet självt, eller "
5876 #~ "om den ursprunglige utgivaren vars verk nätverksadressen hänvisar till "
5877 #~ "ger sitt tillstånd."
5878
5879 #~ msgid ""
5880 #~ "In any section entitled <quote>Acknowledgements</quote> or "
5881 #~ "<quote>Dedications</quote>, preserve the section's title, and preserve in "
5882 #~ "the section all the substance and tone of each of the contributor "
5883 #~ "acknowledgements and/or dedications given therein."
5884 #~ msgstr ""
5885 #~ "För alla avsnitt med titlarna <quote>tillkännagivanden</quote> "
5886 #~ "(Acknowledgements) eller <quote>dedikationer</quote> (Dedications), "
5887 #~ "bevara titeln på avsnittet, och bevara allt innehåll och prägel på alla "
5888 #~ "tillkännagivanden och/eller dedikationer gjorda av varje bidragsgivare."
5889
5890 #~ msgid ""
5891 #~ "Preserve all the <link linkend=\"fdl-invariant\">Invariant Sections</"
5892 #~ "link> of the <link linkend=\"fdl-document\">Document</link>, unaltered in "
5893 #~ "their text and in their titles. Section numbers or the equivalent are not "
5894 #~ "considered part of the section titles."
5895 #~ msgstr ""
5896 #~ "Bevara alla <link linkend=\"fdl-invariant\">oföränderliga avsnitt</link> "
5897 #~ "i <link linkend=\"fdl-document\">dokumentet</link> oförändrade till text "
5898 #~ "och titel. Avsnittsnummer eller motsvarande anses inte tillhöra "
5899 #~ "avsnittets titel."
5900
5901 #~ msgid ""
5902 #~ "Delete any section entitled <quote>Endorsements</quote>. Such a section "
5903 #~ "may not be included in the <link linkend=\"fdl-modified\">Modified "
5904 #~ "Version</link>."
5905 #~ msgstr ""
5906 #~ "Radera varje avsnitt med titeln <quote>endossering</quote> "
5907 #~ "(Endorsements). Ett sådant avsnitt får inte inkluderas i en <link "
5908 #~ "linkend=\"fdl-modified\">förändrad version</link>."
5909
5910 #~ msgid ""
5911 #~ "Do not retitle any existing section as <quote>Endorsements</quote> or to "
5912 #~ "conflict in title with any <link linkend=\"fdl-invariant\">Invariant "
5913 #~ "Section</link>."
5914 #~ msgstr ""
5915 #~ "Inte byta titel på något existerande avsnitt så att det blir "
5916 #~ "<quote>endossering</quote> (Endorsements) eller så att titeln kan "
5917 #~ "förväxlas med något <link linkend=\"fdl-invariant\">oföränderligt "
5918 #~ "avsnitt</link>."
5919
5920 #~ msgid ""
5921 #~ "If the <link linkend=\"fdl-modified\">Modified Version</link> includes "
5922 #~ "new front-matter sections or appendices that qualify as <link "
5923 #~ "linkend=\"fdl-secondary\">Secondary Sections</link> and contain no "
5924 #~ "material copied from the Document, you may at your option designate some "
5925 #~ "or all of these sections as invariant. To do this, add their titles to "
5926 #~ "the list of <link linkend=\"fdl-invariant\">Invariant Sections</link> in "
5927 #~ "the Modified Version's license notice. These titles must be distinct from "
5928 #~ "any other section titles."
5929 #~ msgstr ""
5930 #~ "Om den <link linkend=\"fdl-modified\">förändrade versionen</link> "
5931 #~ "innehåller nya framsidestexter eller bilagor som är att anses som <link "
5932 #~ "linkend=\"fdl-secondary\">sekundära avsnitt</link> och inte innehåller "
5933 #~ "något material kopierat från dokumentet, så äger du, om du vill, benämna "
5934 #~ "några eller samtliga av dessa som oföränderliga. För att göra detta, lägg "
5935 #~ "deras titlar till listan över <link linkend=\"fdl-"
5936 #~ "invariant\">oföränderliga avsnitt</link> i den förändrade versionens "
5937 #~ "licensmeddelande. Dessa titlar måste vara skilda från alla andra avsnitts "
5938 #~ "titlar."
5939
5940 #~ msgid ""
5941 #~ "You may add a section entitled <quote>Endorsements</quote>, provided it "
5942 #~ "contains nothing but endorsements of your <link linkend=\"fdl-"
5943 #~ "modified\">Modified Version</link> by various parties--for example, "
5944 #~ "statements of peer review or that the text has been approved by an "
5945 #~ "organization as the authoritative definition of a standard."
5946 #~ msgstr ""
5947 #~ "Du äger lägga till ett avsnitt med titeln <quote>endossering</quote> "
5948 #~ "(Endorsements), förutsatt att det inte innehåller något annat än "
5949 #~ "endosseringar för din <link linkend=\"fdl-modified\">förändrade version</"
5950 #~ "link> från olika aktörer -- till exempel, meddelanden om utförd "
5951 #~ "korrekturläsning eller att texten har godkänts av en organisation som en "
5952 #~ "officiell definition av en standard."
5953
5954 #~ msgid ""
5955 #~ "You may add a passage of up to five words as a <link linkend=\"fdl-cover-"
5956 #~ "texts\">Front-Cover Text</link>, and a passage of up to 25 words as a "
5957 #~ "<link linkend=\"fdl-cover-texts\">Back-Cover Text</link>, to the end of "
5958 #~ "the list of <link linkend=\"fdl-cover-texts\">Cover Texts</link> in the "
5959 #~ "<link linkend=\"fdl-modified\">Modified Version</link>. Only one passage "
5960 #~ "of Front-Cover Text and one of Back-Cover Text may be added by (or "
5961 #~ "through arrangements made by) any one entity. If the <link linkend=\"fdl-"
5962 #~ "document\">Document</link> already includes a cover text for the same "
5963 #~ "cover, previously added by you or by arrangement made by the same entity "
5964 #~ "you are acting on behalf of, you may not add another; but you may replace "
5965 #~ "the old one, on explicit permission from the previous publisher that "
5966 #~ "added the old one."
5967 #~ msgstr ""
5968 #~ "Du äger lägga till ett textavsnitt på upp till fem ord som <link "
5969 #~ "linkend=\"fdl-cover-texts\">framsidestext</link>, och ett textavsnitt på "
5970 #~ "upp till 25 ord som <link linkend=\"fdl-cover-texts\">baksidestext</link> "
5971 #~ "i listan över <link linkend=\"fdl-cover-texts\">omslagstexter</link> i "
5972 #~ "den <link linkend=\"fdl-modified\">förändrade versionen</link>. Bara ett "
5973 #~ "textavsnitt med framsidestexter och ett med baksidestexter får läggas "
5974 #~ "till av (eller genom försorg av) en enda juridisk person. Om <link "
5975 #~ "linkend=\"fdl-document\">dokumentet</link> redan innehåller en "
5976 #~ "omslagstext för något av omslagen, tidigare tillagd av dig eller genom "
5977 #~ "försorg av samma juridiska person som du företräder, äger du inte lägga "
5978 #~ "till en till, men du äger ändra den gamla med tillstånd från den tidigare "
5979 #~ "utgivaren som lade till den förra."
5980
5981 #~ msgid ""
5982 #~ "The author(s) and publisher(s) of the <link linkend=\"fdl-"
5983 #~ "document\">Document</link> do not by this License give permission to use "
5984 #~ "their names for publicity for or to assert or imply endorsement of any "
5985 #~ "<link linkend=\"fdl-modified\">Modified Version </link>."
5986 #~ msgstr ""
5987 #~ "Författaren (författarna) och utgivaren (utgivarna) av <link "
5988 #~ "linkend=\"fdl-document\">dokumentet</link> ger inte via denna licens sitt "
5989 #~ "tillstånd att använda sina namn för publicitet eller för att lägga till "
5990 #~ "eller antyda endossering av någon <link linkend=\"fdl-"
5991 #~ "modified\">förändrad version</link>."
5992
5993 #~ msgid ""
5994 #~ "You may combine the <link linkend=\"fdl-document\">Document</link> with "
5995 #~ "other documents released under this License, under the terms defined in "
5996 #~ "<link linkend=\"fdl-section4\">section 4</link> above for modified "
5997 #~ "versions, provided that you include in the combination all of the <link "
5998 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> of all of the "
5999 #~ "original documents, unmodified, and list them all as Invariant Sections "
6000 #~ "of your combined work in its license notice."
6001 #~ msgstr ""
6002 #~ "Du äger kombinera <link linkend=\"fdl-document\">dokumentet</link> med "
6003 #~ "andra dokument som är utgivna under denna licens, under de villkor som "
6004 #~ "definieras i <link linkend=\"fdl-section4\">paragraf 4</link> av GNU Free "
6005 #~ "Documentation License för förändrade versioner, förutsatt att du, i det "
6006 #~ "kombinerade dokumentet, innefattar alla <link linkend=\"fdl-"
6007 #~ "invariant\">oföränderliga avsnitt</link> från originaldokumenten, "
6008 #~ "omodifierade, och listar dem som oföränderliga avsnitt i ditt kombinerade "
6009 #~ "verk i dess licensklausul, och att du bevarar alla deras "
6010 #~ "garantiavsägelseklausuler."
6011
6012 #~ msgid ""
6013 #~ "The combined work need only contain one copy of this License, and "
6014 #~ "multiple identical <link linkend=\"fdl-invariant\">Invariant Sections</"
6015 #~ "link> may be replaced with a single copy. If there are multiple Invariant "
6016 #~ "Sections with the same name but different contents, make the title of "
6017 #~ "each such section unique by adding at the end of it, in parentheses, the "
6018 #~ "name of the original author or publisher of that section if known, or "
6019 #~ "else a unique number. Make the same adjustment to the section titles in "
6020 #~ "the list of Invariant Sections in the license notice of the combined work."
6021 #~ msgstr ""
6022 #~ "Det kombinerade verket behöver bara innehålla en enstaka kopia av denna "
6023 #~ "licens [engelska originalversionen], och flera identiska <link "
6024 #~ "linkend=\"fdl-invariant\">oföränderliga stycken</link> kan ersättas med "
6025 #~ "en kopia. Om det finns flera oföränderliga stycken med samma namn men "
6026 #~ "olika innehåll, se till att titeln på varje sådant avsnitt är unik genom "
6027 #~ "att i slutet på den, inom parentes, lägga till namnet på den ursprunglige "
6028 #~ "författaren eller utgivaren av det avsnittet om dessa är kända, annars "
6029 #~ "ett unikt nummer. Gör samma justeringar av titlarna i listan över "
6030 #~ "oföränderliga avsnitt i licensklausulen i det kombinerade verket."
6031
6032 #~ msgid ""
6033 #~ "In the combination, you must combine any sections entitled "
6034 #~ "<quote>History</quote> in the various original documents, forming one "
6035 #~ "section entitled <quote>History</quote>; likewise combine any sections "
6036 #~ "entitled <quote>Acknowledgements</quote>, and any sections entitled "
6037 #~ "<quote>Dedications</quote>. You must delete all sections entitled "
6038 #~ "<quote>Endorsements.</quote>"
6039 #~ msgstr ""
6040 #~ "I det kombinerade verket måste du kombinera alla avsnitt med titlarna "
6041 #~ "<quote>historik</quote> (History) i de ursprungliga dokumenten, till ett "
6042 #~ "avsnitt med titeln <quote>historik</quote> (History); på samma sätt skall "
6043 #~ "alla avsnitt med titlarna <quote>tillkännagivanden</quote> "
6044 #~ "(Acknowledgements), alla avsnitt med titlarna <quote>dedikationer</quote> "
6045 #~ "(Dedications) kombineras. Du måste ta bort alla avsnitt med titlarna "
6046 #~ "<quote>endossering</quote> (Endorsements)."
6047
6048 #~ msgid ""
6049 #~ "You may make a collection consisting of the <link linkend=\"fdl-"
6050 #~ "document\">Document</link> and other documents released under this "
6051 #~ "License, and replace the individual copies of this License in the various "
6052 #~ "documents with a single copy that is included in the collection, provided "
6053 #~ "that you follow the rules of this License for verbatim copying of each of "
6054 #~ "the documents in all other respects."
6055 #~ msgstr ""
6056 #~ "Du äger skapa en samling bestående av <link linkend=\"fdl-"
6057 #~ "document\">dokumentet</link> och andra dokument som är släppta under GNU "
6058 #~ "Free Documentation License, och ersätta individuella kopior i dokumenten "
6059 #~ "av denna licens med en enda kopia [av den engelska originalversionen] som "
6060 #~ "inkluderas i samlingen, förutsatt att du följer villkoren för ordagrann "
6061 #~ "kopiering i denna licens för varje inkluderat dokument i alla andra "
6062 #~ "avseenden."
6063
6064 #~ msgid ""
6065 #~ "Translation is considered a kind of modification, so you may distribute "
6066 #~ "translations of the <link linkend=\"fdl-document\">Document</link> under "
6067 #~ "the terms of <link linkend=\"fdl-section4\">section 4</link>. Replacing "
6068 #~ "<link linkend=\"fdl-invariant\"> Invariant Sections</link> with "
6069 #~ "translations requires special permission from their copyright holders, "
6070 #~ "but you may include translations of some or all Invariant Sections in "
6071 #~ "addition to the original versions of these Invariant Sections. You may "
6072 #~ "include a translation of this License provided that you also include the "
6073 #~ "original English version of this License. In case of a disagreement "
6074 #~ "between the translation and the original English version of this License, "
6075 #~ "the original English version will prevail."
6076 #~ msgstr ""
6077 #~ "Översättning anses vara en sorts förändring, så du äger sprida "
6078 #~ "översättningar av <link linkend=\"fdl-document\">dokumentet</link> enligt "
6079 #~ "de villkor som sätts i <link linkend=\"fdl-section4\">paragraf 4</link>. "
6080 #~ "<link linkend=\"fdl-invariant\">Oföränderliga avsnitt</link> som ersätts "
6081 #~ "med översättningar kräver tillstånd från deras upphovsrättsinnehavare, "
6082 #~ "men du äger inkludera översättningar av alla eller vissa av dessa "
6083 #~ "oföränderliga avsnitt tillsammans med originalversionerna av dessa "
6084 #~ "oföränderliga avsnitt. Du äger inkludera en översättning av denna licens, "
6085 #~ "och alla licensklausuler i dokumentet, och alla garantiavsägelser, "
6086 #~ "förutsatt att du också innefattar den engelska originalversionen av denna "
6087 #~ "licens och originalversionerna av dessa klausuler. Skulle det finnas "
6088 #~ "skillnader mellan översättningen och originalversionen av denna licens "
6089 #~ "eller någon klausul så gäller originalversionen."
6090
6091 #~ msgid ""
6092 #~ "You may not copy, modify, sublicense, or distribute the <link "
6093 #~ "linkend=\"fdl-document\">Document</link> except as expressly provided for "
6094 #~ "under this License. Any other attempt to copy, modify, sublicense or "
6095 #~ "distribute the Document is void, and will automatically terminate your "
6096 #~ "rights under this License. However, parties who have received copies, or "
6097 #~ "rights, from you under this License will not have their licenses "
6098 #~ "terminated so long as such parties remain in full compliance."
6099 #~ msgstr ""
6100 #~ "Du äger inte kopiera, förändra, omlicensiera eller sprida <link "
6101 #~ "linkend=\"fdl-document\">dokumentet</link> annat än enligt villkoren i "
6102 #~ "GNU Free Documentation License. Alla övriga försök att kopiera, "
6103 #~ "modifiera, omlicensiera, eller sprida dokumentet är ogiltiga och kommer "
6104 #~ "automatiskt medföra att du förlorar dina rättigheter enligt denna licens. "
6105 #~ "Tredje man som har mottagit kopior eller rättigheter från dig enligt "
6106 #~ "dessa licensvillkor kommer dock inte att förlora sina rättigheter så "
6107 #~ "länge de följer licensvillkoren."
6108
6109 #~ msgid ""
6110 #~ "The <ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6111 #~ "Software Foundation</ulink> may publish new, revised versions of the GNU "
6112 #~ "Free Documentation License from time to time. Such new versions will be "
6113 #~ "similar in spirit to the present version, but may differ in detail to "
6114 #~ "address new problems or concerns. See <ulink type=\"http\" url=\"http://"
6115 #~ "www.gnu.org/copyleft\">http://www.gnu.org/copyleft/</ulink>."
6116 #~ msgstr ""
6117 #~ "<ulink type=\"http\" url=\"http://www.gnu.org/fsf/fsf.html\">Free "
6118 #~ "Software Foundation</ulink> kan publicera nya, reviderade versioner av "
6119 #~ "GNU Free Documentation License då och då. Sådana nya versioner kommer att "
6120 #~ "vara likadana i andemening som den nuvarande versionen, men kan skilja i "
6121 #~ "detalj för att behandla nya problem eller angelägenheter. Se <ulink "
6122 #~ "type=\"http\" url=\"http://www.gnu.org/copyleft\">http://www.gnu.org/"
6123 #~ "copyleft/</ulink>."
6124
6125 #~ msgid ""
6126 #~ "Each version of the License is given a distinguishing version number. If "
6127 #~ "the <link linkend=\"fdl-document\">Document</link> specifies that a "
6128 #~ "particular numbered version of this License <quote>or any later version</"
6129 #~ "quote> applies to it, you have the option of following the terms and "
6130 #~ "conditions either of that specified version or of any later version that "
6131 #~ "has been published (not as a draft) by the Free Software Foundation. If "
6132 #~ "the Document does not specify a version number of this License, you may "
6133 #~ "choose any version ever published (not as a draft) by the Free Software "
6134 #~ "Foundation."
6135 #~ msgstr ""
6136 #~ "Varje version av licensen ges ett unikt versionsnummer. Om <link "
6137 #~ "linkend=\"fdl-document\">dokumentet</link> stadgar att en specifik "
6138 #~ "numrerad version av denna licens <quote>eller valfri senare version</"
6139 #~ "quote> gäller för det, så äger du rätten att följa villkoren enligt "
6140 #~ "antingen den angivna versionen eller vilken senare version som helst som "
6141 #~ "publicerats (inte som utkast) av Free Software Foundation. Om dokumentet "
6142 #~ "inte anger en version av denna licens, äger du välja vilken version som "
6143 #~ "helst som publicerats (inte som utkast) av Free Software Foundation."
6144
6145 #~ msgid ""
6146 #~ "Permission is granted to copy, distribute and/or modify this document "
6147 #~ "under the terms of the GNU Free Documentation License, Version 1.1 or any "
6148 #~ "later version published by the Free Software Foundation; with the <link "
6149 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> being LIST THEIR "
6150 #~ "TITLES, with the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</"
6151 #~ "link> being LIST, and with the <link linkend=\"fdl-cover-texts\">Back-"
6152 #~ "Cover Texts</link> being LIST. A copy of the license is included in the "
6153 #~ "section entitled <quote>GNU Free Documentation License</quote>."
6154 #~ msgstr ""
6155 #~ "Permission is granted to copy, distribute and/or modify this document "
6156 #~ "under the terms of the GNU Free Documentation License, Version 1.1 or any "
6157 #~ "later version published by the Free Software Foundation; with the <link "
6158 #~ "linkend=\"fdl-invariant\">Invariant Sections</link> being LIST THEIR "
6159 #~ "TITLES, with the <link linkend=\"fdl-cover-texts\">Front-Cover Texts</"
6160 #~ "link> being LIST, and with the <link linkend=\"fdl-cover-texts\">Back-"
6161 #~ "Cover Texts</link> being LIST. A copy of the license is included in the "
6162 #~ "section entitled <quote>GNU Free Documentation License</quote>."
6163
6164 #~ msgid ""
6165 #~ "If you have no <link linkend=\"fdl-invariant\">Invariant Sections</link>, "
6166 #~ "write <quote>with no Invariant Sections</quote> instead of saying which "
6167 #~ "ones are invariant. If you have no <link linkend=\"fdl-cover-"
6168 #~ "texts\">Front-Cover Texts</link>, write <quote>no Front-Cover Texts</"
6169 #~ "quote> instead of <quote>Front-Cover Texts being LIST</quote>; likewise "
6170 #~ "for <link linkend=\"fdl-cover-texts\">Back-Cover Texts</link>."
6171 #~ msgstr ""
6172 #~ "Om du inte har några <link linkend=\"fdl-invariant\">oföränderliga "
6173 #~ "avsnitt</link>, skriv <quote>with no Invariant Sections</quote> istället "
6174 #~ "för att ange vilka som är oföränderliga. Om du inte har några <link "
6175 #~ "linkend=\"fdl-cover-texts\">framsidestexter</link>, skriv <quote>no Front-"
6176 #~ "Cover Texts</quote> istället för <quote>Front-Cover Texts being LIST</"
6177 #~ "quote>; såväl som för <link linkend=\"fdl-cover-texts\">baksidestexter</"
6178 #~ "link>."
6179
6180 #~ msgid ""
6181 #~ "If your document contains nontrivial examples of program code, we "
6182 #~ "recommend releasing these examples in parallel under your choice of free "
6183 #~ "software license, such as the <ulink type=\"http\" url=\"http://"
6184 #~ "www.gnu.org/copyleft/gpl.html\"> GNU General Public License</ulink>, to "
6185 #~ "permit their use in free software."
6186 #~ msgstr ""
6187 #~ "Om ditt dokument innehåller icke-triviala exempel med programkod, så "
6188 #~ "rekommenderar vi att du släpper dessa exempel parallellt under en, av dig "
6189 #~ "vald, fri programvarulicens, som till exempel <ulink type=\"http\" "
6190 #~ "url=\"http://www.gnu.org/copyleft/gpl.html\">GNU General Public License</"
6191 #~ "ulink>, för att möjliggöra deras användning i fri programvara."
6192
6193 #~ msgid ""
6194 #~ "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</"
6195 #~ "authorinitials> <revremark>development</revremark>"
6196 #~ msgstr ""
6197 #~ "<revnumber>1.29</revnumber> <date>28 aug 2018</date> <authorinitials>ss</"
6198 #~ "authorinitials> <revremark>utveckling</revremark>"
6199
6200 #~ msgid "Setting up your project"
6201 #~ msgstr "Att ställa in ditt projekt"
6202
6203 #~ msgid ""
6204 #~ "The next sections describe what steps to perform to integrate GTK-Doc "
6205 #~ "into your project. Theses sections assume we work on a project called "
6206 #~ "'meep'. This project contains a library called 'libmeep' and an end-user "
6207 #~ "app called 'meeper'. We also assume you will be using autoconf and "
6208 #~ "automake. In addition section <link linkend=\"plain_makefiles\">plain "
6209 #~ "makefiles or other build systems</link> will describe the basics needed "
6210 #~ "to work in a different build setup."
6211 #~ msgstr ""
6212 #~ "De följande avsnitten beskriver vilka steg du måste utföra för att "
6213 #~ "integrera GTK-Doc i ditt projekt. Dessa avsnitt förutsätter att vi "
6214 #~ "arbetar på ett projekt kallat ”meep”. Detta projekt innehåller ett "
6215 #~ "bibliotek kallat ”libmeep” och ett slutanvändarprogram kallat ”meeper”. "
6216 #~ "Vi förutsätter också att du kommer att använda autoconf och automake. "
6217 #~ "Dessutom kommer avsnittet <link linkend=\"plain_makefiles\">vanliga "
6218 #~ "makefiler eller andra byggsystem</link> att beskriva de grundläggande "
6219 #~ "sakerna som behöver fungera i ett annat byggsystem."
6220
6221 #~ msgid ""
6222 #~ "Under your top-level project directory create folders called docs/"
6223 #~ "reference (this way you can also have docs/help for end-user "
6224 #~ "documentation). It is recommended to create another subdirectory with the "
6225 #~ "name of the doc-package. For packages with just one library this step is "
6226 #~ "not necessary."
6227 #~ msgstr ""
6228 #~ "Under toppnivåkatalogen för ditt projekt, skapa mappar kallade docs/"
6229 #~ "reference (på detta sättet kan du också ha docs/help för "
6230 #~ "slutanvändardokumentation). Det rekommenderas att skapa en annan "
6231 #~ "underkatalog med namnet på dokumentations-paketet. För paket med bara ett "
6232 #~ "bibliotek är detta steg inte nödvändigt."
6233
6234 #~ msgid "Example directory structure"
6235 #~ msgstr "Exempel på katalogstruktur"
6236
6237 #~ msgid "This can then look as shown below: <_:example-1/>"
6238 #~ msgstr "Detta kan se ut enligt nedan: <_:example-1/>"
6239
6240 #~ msgid ""
6241 #~ "Very easy! Just add one line to your <filename>configure.ac</filename> "
6242 #~ "script."
6243 #~ msgstr ""
6244 #~ "Väldigt enkelt! Bara lägg till en rad till ditt <filename>configure.ac</"
6245 #~ "filename>-skript."
6246
6247 #~ msgid ""
6248 #~ "\n"
6249 #~ "# check for gtk-doc\n"
6250 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6251 #~ msgstr ""
6252 #~ "\n"
6253 #~ "# check for gtk-doc\n"
6254 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6255
6256 #~ msgid "Keep gtk-doc optional"
6257 #~ msgstr "Låt gtk-doc vara valfritt"
6258
6259 #~ msgid ""
6260 #~ "\n"
6261 #~ "# check for gtk-doc\n"
6262 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6263 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6264 #~ "],[\n"
6265 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6266 #~ "])\n"
6267 #~ msgstr ""
6268 #~ "\n"
6269 #~ "# check for gtk-doc\n"
6270 #~ "m4_ifdef([GTK_DOC_CHECK], [\n"
6271 #~ "GTK_DOC_CHECK([1.14],[--flavour no-tmpl])\n"
6272 #~ "],[\n"
6273 #~ "AM_CONDITIONAL([ENABLE_GTK_DOC], false)\n"
6274 #~ "])\n"
6275
6276 #~ msgid ""
6277 #~ "This will require all developers to have gtk-doc installed. If it is okay "
6278 #~ "for your project to have optional api-doc build setup, you can solve this "
6279 #~ "as below. Keep it as is, as gtkdocize is looking for "
6280 #~ "<function>GTK_DOC_CHECK</function> at the start of a line. <_:example-1/>"
6281 #~ msgstr ""
6282 #~ "Detta kommer att kräva att alla utvecklare har gtk-doc installerat. Om "
6283 #~ "det är okej för ditt projekt att ha ett valfritt api-dokumentation bygge, "
6284 #~ "kan du lösa det enligt nedan. Behåll det som det är eftersom gtkdocize "
6285 #~ "letar efter <function>GTK_DOC_CHECK</function> i början på en rad. "
6286 #~ "<_:example-1/>"
6287
6288 #~ msgid ""
6289 #~ "Furthermore it is recommended that you have the following line inside "
6290 #~ "your <filename>configure.ac</filename> script. This allows "
6291 #~ "<application>gtkdocize</application> to automatically copy the macro "
6292 #~ "definition for <function>GTK_DOC_CHECK</function> to your project."
6293 #~ msgstr ""
6294 #~ "Vidare rekommenderas det att du har följande rad i ditt "
6295 #~ "<filename>configure.ac</filename>-skript. Den låter "
6296 #~ "<application>gtkdocize</application> automatiskt kopiera "
6297 #~ "makrodefinitionen för <function>GTK_DOC_CHECK</function> till ditt "
6298 #~ "projekt."
6299
6300 #~ msgid "Preparation for gtkdocize"
6301 #~ msgstr "Förberedelse för gtkdocize"
6302
6303 #~ msgid ""
6304 #~ "\n"
6305 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6306 #~ msgstr ""
6307 #~ "\n"
6308 #~ "AC_CONFIG_MACRO_DIR(m4)\n"
6309
6310 # sebras: e.g. because of,... it can be...any files in tmpl...and is migrating...<symbol> or <function>? gtkdoc or GTK-Doc
6311 #~ msgid ""
6312 #~ "Historically GTK-Doc was generating template files where developers "
6313 #~ "entered the docs. This turned out to be not so good (e.g. the need for "
6314 #~ "having generated files under version control). Since GTK-Doc 1.9 the "
6315 #~ "tools can get all the information from source comments and thus the "
6316 #~ "templates can be avoided. We encourage people to keep documentation in "
6317 #~ "the code. <application>gtkdocize</application> supports now a <option>--"
6318 #~ "flavour no-tmpl</option> option that chooses a makefile that skips tmpl "
6319 #~ "usage totally. Besides adding the option directly to the command "
6320 #~ "invocation, they can be added also to an environment variable called "
6321 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> or set as a 2nd parameter in "
6322 #~ "<symbol>GTK_DOC_CHECK</symbol> macro in the configure script. If you have "
6323 #~ "never changed file in tmpl by hand and migrating from older gtkdoc "
6324 #~ "versions, please remove the directory (e.g. from version control system)."
6325 #~ msgstr ""
6326 #~ "Historiskt genererade GTK-Doc mallfiler i vilka utvecklare skrev in "
6327 #~ "dokumentationen. Detta visade sig inte vara så bra (t.ex. på grund av "
6328 #~ "behovet att ha genererade filer under versionskontroll). Sedan GTK-Doc "
6329 #~ "1.9 kan verktygen hämta all information från källkodskommentarer och "
6330 #~ "mallar kan därför undvikas. Vi rekommenderar att hålla dokumentationen i "
6331 #~ "koden. <application>gtkdocize</application> har nu stöd för flaggan "
6332 #~ "<option>--flavour no-tmpl</option> som väljer en makefil som hoppar över "
6333 #~ "tmpl-användning helt. Förutom att lägga till flaggan direkt vid körning "
6334 #~ "av kommandot, kan den också läggas till i en miljövariabel kallad "
6335 #~ "<symbol>GTKDOCIZE_FLAGS</symbol> eller inställd som en andra parameter i "
6336 #~ "makrot <symbol>GTK_DOC_CHECK</symbol> i configure-skriptet. Om du inte "
6337 #~ "har ändrat någon fil i tmpl för hand och migrerar från äldre gtkdoc-"
6338 #~ "versioner, ta bort katalogen (t.ex. från versionshanteringssystemet)."
6339
6340 #~ msgid ""
6341 #~ "Now you can point your browser to <filename>docs/reference/"
6342 #~ "&lt;package&gt;/index.html</filename>. Yes, it's a bit disappointing "
6343 #~ "still. But hang-on, during the next chapter we tell you how to fill the "
6344 #~ "pages with life."
6345 #~ msgstr ""
6346 #~ "Du kan nu peka din webbläsare till <filename>docs/reference/&lt;paket&gt;/"
6347 #~ "index.html</filename>. Ja, den är fortfarande lite sorglig. Men häng "
6348 #~ "kvar, i nästa kapitel kommer vi att berätta för dig hur du fyller sidorna "
6349 #~ "med liv."
6350
6351 #~ msgid "Documentation placement"
6352 #~ msgstr "Dokumentationsplacering"
6353
6354 #~ msgid ""
6355 #~ "In the past most documentation had to be filled into files residing "
6356 #~ "inside the <filename>tmpl</filename> directory. This has the "
6357 #~ "disadvantages that the information is often not updated and also that the "
6358 #~ "file tend to cause conflicts with version control systems."
6359 #~ msgstr ""
6360 #~ "Tidigare var det tvunget att fylla i största delen av dokumentationen i "
6361 #~ "filer som fanns i katalogen <filename>tmpl</filename>. Detta hade "
6362 #~ "nackdelen att informationen ofta inte uppdaterades och att filen också "
6363 #~ "ofta orsakade konflikter med versionshanteringssystem."
6364
6365 #~ msgid ""
6366 #~ "The avoid the aforementioned problems we suggest putting the "
6367 #~ "documentation inside the sources. This manual will only describe this way "
6368 #~ "of documenting code."
6369 #~ msgstr ""
6370 #~ "För att undvika de nämnda problemen föreslår vi att placera "
6371 #~ "dokumentationen i källkoden. Denna manual kommer endast att beskriva "
6372 #~ "detta sättet att dokumentera kod."
6373
6374 #~ msgid "<guilabel>Python</guilabel> - optional - for gtkdoc-depscan"
6375 #~ msgstr "<guilabel>Python</guilabel> - valfritt - för gtkdoc-depscan"
6376
6377 #~ msgid ""
6378 #~ "<guilabel>Generating the \"template\" files.</guilabel> "
6379 #~ "<application>gtkdoc-mktmpl</application> creates a number of files in the "
6380 #~ "<filename class=\"directory\">tmpl/</filename> subdirectory, using the "
6381 #~ "information gathered in the first step. (Note that this can be run "
6382 #~ "repeatedly. It will try to ensure that no documentation is ever lost.)"
6383 #~ msgstr ""
6384 #~ "<guilabel>Generera ”mall”-filerna.</guilabel> <application>gtkdoc-mktmpl</"
6385 #~ "application> skapar ett antal filer i underkatalogen <filename "
6386 #~ "class=\"directory\">tmpl/</filename>, från information som samlats ihop i "
6387 #~ "det första steget. (Notera att detta kan köras upprepade gånger. Det "
6388 #~ "kommer att försöka att säkerställa att ingen dokumentation någonsin går "
6389 #~ "förlorad.)"
6390
6391 #~ msgid ""
6392 #~ "Since GTK-Doc 1.9 the templates can be avoided. We encourage people to "
6393 #~ "keep documentation in the code. <application>gtkdocize</application> "
6394 #~ "supports now a <option>--flavour no-tmpl</option> option that chooses a "
6395 #~ "makefile that skips tmpl usage totally. If you have never changed file in "
6396 #~ "tmpl by hand, please remove the directory (e.g. from version control "
6397 #~ "system)."
6398 #~ msgstr ""
6399 #~ "Sedan GTK-Doc 1.9 kan mallar undvikas. Vi rekommenderar att hålla "
6400 #~ "dokumentationen i koden. <application>gtkdocize</application> har nu stöd "
6401 #~ "för flaggan <option>--flavour no-tmpl</option> som väljer en makefil som "
6402 #~ "helt hoppar över tmpl-användning. Om du inte ändrat i någon fil i tmpl "
6403 #~ "för hand, ta bort katalogen (t.ex. från versionshanteringssystemet)."
6404
6405 #~ msgid "explanation"
6406 #~ msgstr "förklaring"