gtk-doc master - en to sv translation catalogue (433 entries)

note: (itstool) path: bookinfo/title
en: GTK-Doc Manual
sv: Handbok för GTK-Doc

note: (itstool) path: abstract/para
en: User manual for developers with instructions of GTK-Doc usage.
sv: Användarhandbok för utvecklare med användningsinstruktioner för GTK-Doc.

note: (itstool) path: publisher/publishername
en: GTK-Doc project
sv: GTK-Doc-projektet

note: (itstool) path: legalnotice/para
en: Permission is granted to copy, distribute and/or modify this document under the terms of the <citetitle>GNU Free Documentation License</citetitle>, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is <link linkend="fdl">included</link>.
sv: Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges under villkoren i <citetitle>GNU Free Documentation License</citetitle>, version 1.1 eller senare, utgivet av Free Software Foundation utan standardavsnitt och omslagstexter.  En kopia av licensen finns <link linkend="fdl">inkluderad</link>.

note: (itstool) path: legalnotice/para
en: Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.
sv: Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.

note: (itstool) path: revhistory/revision
en: <revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</authorinitials> <revremark>gtk4 version</revremark>
sv: <revnumber>1.33.0</revnumber> <date>1 okt 2020</date> <authorinitials>mc</authorinitials> <revremark>gtk4-version</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>dev version</revremark>
sv: <revnumber>1.32.1</revnumber> <date>15 aug 2019</date> <authorinitials>ss</authorinitials> <revremark>utveckling</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>hotfix release</revremark>
sv: <revnumber>1.32</revnumber> <date>15 aug 2019</date> <authorinitials>ss</authorinitials> <revremark>snabb fixutgåva</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</authorinitials> <revremark>refactorings and more test coverage</revremark>
sv: <revnumber>1.31</revnumber> <date>05 aug 2019</date> <authorinitials>ss</authorinitials> <revremark>omstrukturering och större testtäckning</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</authorinitials> <revremark>more test coverage</revremark>
sv: <revnumber>1.30</revnumber> <date>08 maj 2019</date> <authorinitials>ss</authorinitials> <revremark>större testtäckning</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>
sv: <revnumber>1.29</revnumber> <date>28 aug 2018</date> <authorinitials>ss</authorinitials> <revremark>programfixar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>
sv: <revnumber>1.28</revnumber> <date>24 mar 2018</date> <authorinitials>ss</authorinitials> <revremark>programfixar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</authorinitials> <revremark>fine tuning of the python port</revremark>
sv: <revnumber>1.27</revnumber> <date>07 dec 2017</date> <authorinitials>ss</authorinitials> <revremark>finjustering av python-porteringen</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</authorinitials> <revremark>port all tools from perl/bash to python</revremark>
sv: <revnumber>1.26</revnumber> <date>11 aug 2017</date> <authorinitials>ss</authorinitials> <revremark>portera alla verktyg från perl/bash till python</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, test cleanups</revremark>
sv: <revnumber>1.25</revnumber> <date>21 mars 2016</date> <authorinitials>ss</authorinitials> <revremark>programfixar, uppstädning av tester</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
sv: <revnumber>1.24</revnumber> <date>29 maj 2015</date> <authorinitials>ss</authorinitials> <revremark>programfix</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fix</revremark>
sv: <revnumber>1.23</revnumber> <date>17 maj 2015</date> <authorinitials>ss</authorinitials> <revremark>programfix</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
sv: <revnumber>1.22</revnumber> <date>07 maj 2015</date> <authorinitials>ss</authorinitials> <revremark>programfixar, borttagning av föråldrade funktioner</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, dropping deprecated features</revremark>
sv: <revnumber>1.21</revnumber> <date>17 jul 2014</date> <authorinitials>ss</authorinitials> <revremark>programfixar, borttagning av föråldrade funktioner</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, markdown support, style improvements</revremark>
sv: <revnumber>1.20</revnumber> <date>16 feb 2014</date> <authorinitials>ss</authorinitials> <revremark>programfixar, stöd för markdown, stilförbättringar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</authorinitials> <revremark>bug fixes</revremark>
sv: <revnumber>1.19</revnumber> <date>05 jun 2013</date> <authorinitials>ss</authorinitials> <revremark>programfixar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>
sv: <revnumber>1.18</revnumber> <date>14 sep 2011</date> <authorinitials>ss</authorinitials> <revremark>programfixar, uppsnabbningar, stöd för markdown</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</authorinitials> <revremark>urgent bug fix update</revremark>
sv: <revnumber>1.17</revnumber> <date>26 feb 2011</date> <authorinitials>sk</authorinitials> <revremark>brådskande programfixuppdatering</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</authorinitials> <revremark>bugfixes, layout improvements</revremark>
sv: <revnumber>1.16</revnumber> <date>14 jan 2011</date> <authorinitials>sk</authorinitials> <revremark>programfixar, layoutförbättringar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</authorinitials> <revremark>bug and regression fixes</revremark>
sv: <revnumber>1.15</revnumber> <date>21 maj 2010</date> <authorinitials>sk</authorinitials> <revremark>program- och regressionsfixar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</authorinitials> <revremark>bugfixes and performance improvements</revremark>
sv: <revnumber>1.14</revnumber> <date>28 mars 2010</date> <authorinitials>sk</authorinitials> <revremark>programfixar och prestandaförbättringar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.13</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>broken tarball update</revremark>
sv: <revnumber>1.13</revnumber> <date>18 december 2009</date> <authorinitials>sk</authorinitials> <revremark>uppdatering på grund av trasigt tar-arkiv</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.12</revnumber> <date>18 December 2009</date> <authorinitials>sk</authorinitials> <revremark>new tool features and bugfixes</revremark>
sv: <revnumber>1.12</revnumber> <date>18 december 2009</date> <authorinitials>sk</authorinitials> <revremark>nya verktygsfunktioner och programfixar</revremark>

note: (itstool) path: revhistory/revision
en: <revnumber>1.11</revnumber> <date>16 November 2008</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</revremark>
sv: <revnumber>1.11</revnumber> <date>16 november 2008</date> <authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</revremark>

note: (itstool) path: chapter/title
en: Introduction
sv: Introduktion

note: (itstool) path: chapter/para
en: This chapter introduces GTK-Doc and gives an overview of what it is and how it is used.
sv: Detta kapitel introducerar GTK-Doc och ger en överblick över vad det är och hur det används.

note: (itstool) path: sect1/title
en: What is GTK-Doc?
sv: Vad är GTK-Doc?

note: (itstool) path: sect1/para
en: GTK-Doc is used to document C code. It is typically used to document the public API of libraries, such as the GTK+ and GNOME libraries. But it can also be used to document application code.
sv: GTK-Doc används för att dokumentera C-kod. Det används vanligen för att dokumentera det publika API:t för bibliotek, så som GTK+- och GNOME-biblioteken. Men det kan också användas för att dokumentera programkod.

note: (itstool) path: sect1/title
en: How Does GTK-Doc Work?
sv: Hur fungerar GTK-Doc?

note: (itstool) path: sect1/para
en: GTK-Doc works by using documentation of functions placed inside the source files in specially-formatted comment blocks, or documentation added to the template files which GTK-Doc uses (though note that GTK-Doc will only document functions that are declared in header files; it won't produce output for static functions).
sv: GTK-Doc fungerar så att det använder dokumentation för funktioner placerad inuti källkodsfilerna i speciellt formaterade kommentarsblock, eller dokumentation som lagts till i mallfilerna som GTK-Doc använder (notera dock att GTK-Doc endast kommer att dokumentera funktioner som deklarerats i huvudfiler; det kommer inte att producera utdata för statiska funktioner).

note: (itstool) path: sect1/para
en: GTK-Doc consists of a number of python scripts, each performing a different step in the process.
sv: GTK-Doc består av ett antal python-skript som vart och ett utför olika steg i processen.

note: (itstool) path: sect1/para
en: There are 5 main steps in the process:
sv: Det finns 5 huvudsteg i processen:

note: (itstool) path: listitem/para
en: <guilabel>Writing the documentation.</guilabel> The author fills in the source files with the documentation for each function, macro, structs or unions, etc.
sv: <guilabel>Skriva dokumentationen.</guilabel> Författaren fyller i källkodsfilerna med dokumentation för varje funktion, makro, struct eller union, o.s.v.

note: (itstool) path: listitem/para
en: <guilabel>Gathering information about the code.</guilabel> <application>gtkdoc-scan</application> scans the header files of the code looking for declarations of functions, macros, enums, structs, and unions. It creates the file <filename>&lt;module&gt;-decl-list.txt</filename> containing a list of the declarations, placing them into sections according to which header file they are in. On the first run this file is copied to <filename>&lt;module&gt;-sections.txt</filename>. The author can rearrange the sections, and the order of the declarations within them, to produce the final desired order. The second file it generates is <filename>&lt;module&gt;-decl.txt</filename>. This file contains the full declarations found by the scanner. If for some reason one would like some symbols to show up in the docs, where the full declaration cannot be found by the scanner or the declaration should appear differently, one can place entities similar to the ones in <filename>&lt;module&gt;-decl.txt</filename> into <filename>&lt;module&gt;-overrides.txt</filename>.
sv: <guilabel>Samla ihop information om koden.</guilabel> <application>gtkdoc-scan</application> söker genom huvudfilerna för koden och letar efter deklarationer av funktioner, makron, uppräkningar, strukturer och unioner. Det skapar sedan filen <filename>&lt;module&gt;-decl-list.txt</filename> som innehåller en lista över deklarationerna, och placerar dem i avsnitt efter vilken huvudfil de finns i. Vid första körningen kommer denna fil att kopieras till <filename>&lt;module&gt;-sections.txt</filename>. Författaren kan, genom att omarrangera avsnitten och ändra ordningen för deklarationerna inom dem, framställa den önskade, slutgiltiga ordningen. Den andra filen det genererar är <filename>&lt;module&gt;-decl.txt</filename>. Denna fil innehåller de fullständiga deklarationerna som hittats av detektorn. Om man av något skäl vill att vissa symboler ska visas i dokumentation då den fullständiga deklarationen inte kan hittas av detektorn, eller om deklarationen ska visas annorlunda, kan man placera rader liknande de som finns i <filename>&lt;module&gt;-decl.txt</filename> i <filename>&lt;module&gt;-overrides.txt</filename>.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scangobj</application> can also be used to dynamically query a library about any GObject subclasses it exports. It saves information about each object's position in the class hierarchy and about any GObject properties and signals it provides.
sv: <application>gtkdoc-scangobj</application> kan också användas för att dynamiskt fråga ett bibliotek om vilka GObject-underklasser det exporterar. Det sparar information om varje objekts position i klasshierarkin och om vilka GObject-egenskaper och signaler det tillhandahåller.

note: (itstool) path: listitem/para
en: <application>gtkdoc-scanobj</application> should not be used anymore. It was needed in the past when GObject was still GtkObject inside gtk+.
sv: <application>gtkdoc-scanobj</application> bör inte användas längre. Det behövdes tidigare när GObject fortfarande var GtkObject inuti gtk+.

note: (itstool) path: listitem/para
en: <guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-mkdb</application> turns the template files into XML files in the <filename class="directory">xml/</filename> subdirectory. If the source code contains documentation on functions, using the special comment blocks, it gets merged in here. If there are no tmpl files used it only reads docs from sources and introspection data.
sv: <guilabel>Generera XML och HTML/PDF.</guilabel> <application>gtkdoc-mkdb</application> förvandlar mallfilerna till XML-filer i underkatalogen <filename class="directory">xml/</filename>. Om källkoden innehåller dokumentation över funktioner i speciella kommentarsblock, så kommer denna att sammanfogas här. Om det inte finns några tmpl-filer som används så kommer det endast att läsa dokumentation från källkoden och introspektionsdata.

note: (itstool) path: listitem/para
en: <application>gtkdoc-mkhtml</application> turns the XML files into HTML files in the <filename class="directory">html/</filename> subdirectory. Likewise <application>gtkdoc-mkpdf</application> turns the XML files into a PDF document called <filename>&lt;package&gt;.pdf</filename>.
sv: <application>gtkdoc-mkhtml</application> förvandlar XML-filer till HTML-filer i underkatalogen <filename class="directory">html/</filename>. På samma sätt förvandlar <application>gtkdoc-mkpdf</application> XML-filerna till ett PDF-dokument kallat <filename>&lt;package&gt;.pdf</filename>.

note: (itstool) path: listitem/para
en: Files in <filename class="directory">xml/</filename> and <filename class="directory">html/</filename> directories are always overwritten. One should never edit them directly.
sv: Filer i <filename class="directory">xml/</filename>- och <filename class="directory">html/</filename>-katalogerna skrivs alltid över. Man bör aldrig redigera dem direkt.

note: (itstool) path: listitem/para
en: <guilabel>Fixing up cross-references between documents.</guilabel> After installing the HTML files, <application>gtkdoc-fixxref</application> can be run to fix up any cross-references between separate documents. For example, the GTK+ documentation contains many cross-references to types documented in the GLib manual. When creating the source tarball for distribution, <application>gtkdoc-rebase</application> turns all external links into web-links. When installing distributed (pregenerated) docs the same application will try to turn links back to local links (where those docs are installed).
sv: <guilabel>Fixa korsreferenser mellan dokument.</guilabel> Efter att ha installerat HTML-filerna kan <application>gtkdoc-fixxref</application> köras för att fixa korsreferenser mellan separata dokument. Till exempel GTK+-dokumentationen innehåller många korsreferenser till typer som dokumenterats i GLib-manualen. När tar-arkivet med källkod skapas för distribution, förvandlar <application>gtkdoc-rebase</application> alla externa länkar till webblänkar. När (förgenererad) distribuerad dokumentation installeras kommer samma program att försöka att förvandla länkarna tillbaka till lokala länkar (i de fall där dokumentationen finns installerad).

note: (itstool) path: sect1/title
en: Getting GTK-Doc
sv: Hämta GTK-Doc

note: (itstool) path: sect2/title
en: Requirements
sv: Krav

note: (itstool) path: sect2/para
en: <guilabel>python 2/3</guilabel> - the main scripts are written in python.
sv: <guilabel>python 2/3</guilabel> - huvudskripten är skrivna i python.

note: (itstool) path: sect2/para
en: <guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url="http://xmlsoft.org/XSLT/" type="http">xmlsoft.org/XSLT/</ulink>
sv: <guilabel>xsltproc</guilabel> - xslt-processorn från libxslt <ulink url="http://xmlsoft.org/XSLT/" type="http">xmlsoft.org/XSLT/</ulink>

note: (itstool) path: sect2/para
en: <guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url="http://sourceforge.net/projects/docbook/files/docbook-xsl/" type="http">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>
sv: <guilabel>docbook-xsl</guilabel> - docbook xsl-stilmallar <ulink url="http://sourceforge.net/projects/docbook/files/docbook-xsl/" type="http">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>

note: (itstool) path: sect2/para
en: One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> or <guilabel>vim</guilabel> - optional - used for syntax highlighting of examples
sv: Endera av <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> eller <guilabel>vim</guilabel> - valfritt - används för syntaxfärgning av exempel

note: (itstool) path: sect1/title
en: About GTK-Doc
sv: Om GTK-Doc

note: (itstool) path: sect1/para
en: Historically GTK-Doc was used to generate template files from the sources code. These template files could be used by developers to enter the API documentation. This approach was rather inconvenient because it required to keep the generated files under version control. Since GTK-Doc 1.9 it became possible to place all API information into source comments, which made the template support obsolete. In version 1.26 template support has been removed.
sv: Historiskt användes GTK-Doc för att generera mallfiler från källkoden. Dessa mallfiler kunde användas av utvecklare för att ange API-dokumentationen. Detta tillvägagångssätt var ganska obekvämt då det krävde att genererade filer hölls under versionshantering. Sedan GTK-Doc 1.9 är det möjligt att placera all API-information i källkodskommentarer, vilket gör mallstödet föråldrat. I version 1.26 har mallstödet tagits bort.

note: (itstool) path: sect1/para
en: (authors, web pages, mailing list, license, future plans, comparison with other similar systems.)
sv: (författare, webbsidor, sändlistor, licens, framtida planer, jämförelse med andra liknande system.)

note: (itstool) path: sect1/title
en: About this Manual
sv: Om denna handbok

note: (itstool) path: sect1/para
en: (who it is meant for, where you can get it, license)
sv: (vem är den avsett för, var kan du få tag i den, licens)

note: (itstool) path: chapter/title
en: Project Setup
sv: Projektkonfiguration

note: (itstool) path: chapter/para
en: This Chapter describes the steps that are necessary to integrate GTK-Doc into your project. The integration of GTK-Doc into a project includes the following steps:
sv: Detta kapitel beskriver stegen som är nödvändiga för att integrera GTK-Doc i ditt projekt. Integreringen av GTK-Doc till ett projekt inkluderar följande steg:

note: (itstool) path: listitem/para
en: Preparation of the directory structure and creating required configuration files for your GTK-Doc documentation (see <link linkend="settingup_docfiles"> Setting up a skeleton documentation</link>).
sv: Förberedelse av katalogstrukturen och skapande av konfigurationsfiler som krävs för din GTK-Doc-dokumentation (se <link linkend="settingup_docfiles"> Att ställa in en skelettstruktur för dokumentation</link>).

note: (itstool) path: listitem/para
en: Adjusting the build system to build your documentation using the GTK-Doc tools. Multiple build systems are supported, in this manual we describe how to integrate GTK-Doc with <link linkend="settingup_autotools">Autotools</link>, <link linkend="settingup_cmake">CMake</link>, and <link linkend="settingup_plain_makefiles">plain Makefiles</link>.
sv: Justering av byggsystemet för att bygga din dokumentation med GTK-Doc-verktygen. Flera byggsystem stöds, i denna handbok beskriver vi hur GTK-Doc kan integreras med <link linkend="settingup_autotools">Autotools</link>, <link linkend="settingup_cmake">CMake</link> och <link linkend="settingup_plain_makefiles">vanliga Makefiler</link>.

note: (itstool) path: listitem/para
en: Adding GTK-Doc specific files to version control and deciding which files to ignore (see <link linkend="settingup_vcs"> Integration with version control systems</link>).
sv: Tillägg av GTK-Doc-specifika filer till versionshantering och att bestämma vilka filer som ska ignoreras (se <link linkend="settingup_vcs"> Integrering med versionshanteringssystem</link>).

note: (itstool) path: chapter/para
en: The following sections assume we work on a project called <code>meep</code>. This project contains two packages (or modules), a library called <code>libmeep</code> and an end-user app called <code>meeper</code>.
sv: De följande avsnitten utgår från att vi arbetar på ett projekt som kallas <code>meep</code>. Detta projekt innehåller två paket (eller moduler), ett bibliotek som kallas <code>libmeep</code> och ett program för slutanvändare som kallas <code>meeper</code>.

note: (itstool) path: sect1/title
en: Setting up a skeleton documentation
sv: Att ställa in en skelettstruktur för dokumentation

note: (itstool) path: sect1/para
en: A common convention is to place documentation into a folder called <code>docs</code> inside your top-level project directory. We usually distinguish between <emphasis>reference documentation</emphasis> intended for developers and an <emphasis>user manual</emphasis> intended for end-users. Again the convention is to have separate folders for both. We usually place the reference documentation in a folder named <code>reference</code> and the end-user manual in a folder named <code>help</code> as. According to the above convention the documentation for our <code>libmeep</code> package would be placed into: <code>docs/reference/libmeep</code>. For packages with just one library or application the documentation could also be placed directly into <code>docs/reference</code>. It is not mandatory to use the above convention, but if you choose to use a different directory structure you must adjust your build system configuration to match your directory structure.
sv: En vanlig konvention är att placera dokumentation i en mapp kallad <code>docs</code> i toppnivåkatalogen för ditt projekt. Vi skiljer vanligen mellan <emphasis>referensdokumentation</emphasis> som är avsedd för utvecklare och en <emphasis>användarhandbok</emphasis> som är avsedd för slutanvändare. Konventionen är återigen att ha olika mappar för båda. Vi placerar vanligen referensdokumentationen i en mapp med namnet <code>reference</code> handboken för slutanvändare i en mapp med namnet <code>help</code>. Enligt konventionen ovan skulle dokumentationen för vårt paket <code>libmeep</code> placeras i: <code>docs/reference/libmeep</code>. För paket med bara ett bibliotek eller program kan dokumentationen också placeras direkt i <code>docs/reference</code>. Det är inte obligatoriskt att använda konventionen ovan, men om du väljer att använda en annan katalogstruktur måste du anpassa din konfiguration för byggsystemet så att den matchar din katalogstruktur.

note: (itstool) path: example/title
en: Example directory structure of <emphasis>meep</emphasis> project
sv: Exempel på katalogstruktur för projektet <emphasis>meep</emphasis>

note: (itstool) path: example/programlisting
en: 
    meep/
      docs/
        reference/  # reference documentation
          libmeep/
          meeper/
        help/       # optional: user manual
          meeper/
      src/
        libmeep/
        meeper/
sv: 
    meep/
      docs/
        reference/  # referensdokumentation
          libmeep/
          meeper/
        help/       # valfritt: användarhandbok
          meeper/
      src/
        libmeep/
        meeper/

note: (itstool) path: sect1/para
en: In the following sections we will assume a directory structure for our <emphasis>meep</emphasis> project that uses the above conventions. <_:example-1/>
sv: I avsnitten som följer kommer vi anta en katalogstruktur för vårt projekt <emphasis>meep</emphasis> som följer konventionerna ovan. <_:example-1/>

note: (itstool) path: sect1/title
en: Integration with Autotools
sv: Integrering med Autotools

note: (itstool) path: sect1/para
en: Integration of GTK-Doc into an autotools-based build system requires the following steps:
sv: Integrering av GTK-Doc i ett autotools-baserat byggsystem kräver följande steg:

note: (itstool) path: listitem/para
en: Ensure that <application>gtkdocize</application> is run once before the <filename>configure</filename> script. If an <filename>autogen.sh</filename> script is present, adjust it to check for GTK-Doc and add a call to <application>gtkdocize</application>.
sv: Säkerställ att <application>gtkdocize</application> körs en gång innan skriptet <filename>configure</filename>. Om skriptet <filename>autogen.sh</filename> finns tillgängligt, justera det så att det söker efter GTK-Doc och lägg till ett anrop till <application>gtkdocize</application>.

note: (itstool) path: listitem/para
en: The main purpose of <application>gtkdocize</application> is to make the <filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</filename> macro definition file available to the build system, either by copying or linking it into the project.
sv: Huvudsyftet med <application>gtkdocize</application> är att göra Makefilen <filename>gtk-doc.make</filename> och makrodefinitionsfilen <filename>gtk-doc.m4</filename> tillgängliga för byggsystemet, antingen genom att kopiera eller länka in dem i projektet.

note: (itstool) path: listitem/para
en: Add the necessary <application>autoconf</application> macros to <filename>configure.ac</filename> to enable GTK-Doc in your build system to allow configuration of GTK-Doc via the generated <filename>configure</filename> script.
sv: Lägg till de nödvändiga <application>autoconf</application>-makrona till <filename>configure.ac</filename> för att aktivera GTK-Doc i ditt byggsystem för att tillåta konfiguration av GTK-Doc via det genererade <filename>configure</filename>-skriptet.

note: (itstool) path: listitem/para
en: Among others with registers the <code>--enable-gtk-doc</code> option with the <filename>configure</filename> script.
sv: Bland andra med register flaggan <code>--enable-gtk-doc</code> med <filename>configure</filename>-skriptet.

note: (itstool) path: listitem/para
en: Create an <application>automake</application> script for each application or library in your project. In the example used in this documentation this step applies to both <code>meeper</code> and <code>libmeep</code>.
sv: Skapa ett <application>automake</application>-skript för varje program eller bibliotek i ditt projekt. I exemplet som används i denna dokumentation tillämpas detta steg för både <code>meeper</code> och <code>libmeep</code>.

note: (itstool) path: sect1/para
en: In the following sections, we will perform the above steps in reverse order. We start with the <application>automake</application> scripts and work our way up to <filename>configure.ac</filename> and <filename>autogen.sh</filename>. Then we show how enable Gtk-Doc in the build system and how to build the documentation.
sv: I de följande avsnitten utför vi stegen ovan i omvänd ordning. Vi börjar med <application>automake</application>-skripten och arbetar vår väg upp till <filename>configure.ac</filename> och <filename>autogen.sh</filename>. Sedan visar vi hur Gtk-Doc aktiveras i byggsystemet och hur dokumentationen byggs.

note: (itstool) path: sect2/title
en: Integration with automake
sv: Integrering med automake

note: (itstool) path: sect2/para
en: First copy the <filename>Makefile.am</filename> from the <filename class="directory">examples</filename> sub-directory of the <ulink url="https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am"> gtkdoc-sources</ulink> to your project's reference documentation directory (e.g. <filename class="directory">docs/reference/&lt;package&gt;</filename>). A local copy should be available under e.g. <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. If you have multiple packages repeat this for each one.
sv: Kopiera först <filename>Makefile.am</filename> från underkatalogen <filename class="directory">examples</filename> från <ulink url="https://gitlab.gnome.org/GNOME/gtk-doc/raw/master/examples/Makefile.am">gtkdoc-sources</ulink> till ditt projekts referensdokumentationskatalog (t.ex. <filename class="directory">docs/reference/&lt;paket&gt;</filename>). En lokal kopia bör finnas tillgänglig under t.ex. <filename>/usr/share/doc/gtk-doc-tools/examples/Makefile.am</filename>. Om du har flera paket, repetera detta för vart och ett.

note: (itstool) path: note/simpara
en: Do not forget to add each <filename>Makefile.am</filename> to the <function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</filename>. For <filename>docs/reference/libmeep/Makefile.am</filename> you will need to add the entry <filename>docs/reference/libmeep/Makefile</filename> to <function>AC_CONFIG_FILES</function>.
sv: Glöm inte att lägga till varje <filename>Makefile.am</filename> till makrot <function>AC_CONFIG_FILES</function> i <filename>configure.ac</filename>. För <filename>docs/reference/libmeep/Makefile.am</filename> kommer du behöva lägga till posten <filename>docs/reference/libmeep/Makefile</filename> till <function>AC_CONFIG_FILES</function>.

note: (itstool) path: example/title
en: Example directory structure with <filename>Makefiles.am</filename>
sv: Exempelkatalogstruktur med <filename>Makefiles.am</filename>

note: (itstool) path: example/programlisting
en: 
    meep/
      docs/
        reference/  # reference documentation
          libmeep/
            Makefile.am
          meeper/
            Makefile.am
        help/       # optional: user manual
          meeper/
      src/
        libmeep/
        meeper/
sv: 
    meep/
      docs/
        reference/  # referensdokumentation
          libmeep/
            Makefile.am
          meeper/
            Makefile.am
        help/       # valfritt: användarhandbok
          meeper/
      src/
        libmeep/
        meeper/

note: (itstool) path: sect2/para
en: Next, you need to customize the copied Makefiles and provide values for the various parameters in each <filename>Makefile.am</filename>. All settings have a comment above them that describes their purpose and how to customize the setting. Most settings are used to supply extra flags to the respective tools to which they apply. Every tool has a variable of the form <option>&lt;TOOLNAME&gt;_OPTIONS</option> (e.g. the tool <application>gtkdoc-mkhtml</application> has an option named <code>MKHTML_OPTIONS</code>). All the tools support <option>--help</option> to list the supported options.
sv: Härnäst behöver du anpassa de kopierade Makefilerna och tillhandahålla värden för de olika parametrarna i varje <filename>Makefile.am</filename>. Alla inställningarna har en kommentar ovanför som beskriver deras syfte och hur inställningen kan anpassas. De flesta inställningarna används för att tillhandahålla extraflaggor till respektive verktyg för vilket de är aktuella. Varje verktyg har en variabel på formen <option>&lt;VERKTYGSNAMN&gt;_OPTIONS</option> (t.ex. har verktyget <application>gtkdoc-mkhtml</application> en flagga med namnet <code>MKHTML_OPTIONS</code>). Alla verktygen har stöd för <option>--help</option> för att lista de flaggor som stöds.

note: (itstool) path: listitem/para
en: <option>DOC_MODULE</option> is used to provide the name of the package that is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>).
sv: <option>DOC_MODULE</option> används för att tillhandahålla namnet på paketet som dokumenteras (t.ex. <code>meeper</code> eller <code>libmeep</code>).

note: (itstool) path: listitem/para
en: <option>DOC_SOURCE_DIR</option> is used to specify the location of source directory which GTK-Doc searches for your API documentation. This will usually be <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> or a sub-directory of that directory.
sv: <option>DOC_SOURCE_DIR</option> används för att ange platsen för källkatalogen där GTK-Doc söker efter din API-dokumentation. Detta kommer vanligen vara <code> DOC_SOURCE_DIR=$(top_srcdir)/src </code> eller en underkatalog till den katalogen.

note: (itstool) path: listitem/para
en: <option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). The documentation will be rebuilt if any of the matched files change.
sv: <option>HFILE_GLOB</option> och <option>CFILE_GLOB</option> används för beroenden. Varje flagga tar en file-glob (t.ex. <code>HFILE_GLOB=$(top_srcdir)/src/*.c</code>). Dokumentationen kommer att byggas om ifall någon av de matchande filerna ändras.

note: (itstool) path: listitem/para
en: <option>EXTRA_HFILES</option> allows to specify extra header files to include when scanning for API documentation, which are not found under <code>DOC_SOURCE_DIR</code> (e.g. <code> EXTRA_HFILES=$(top_srcdir}/contrib/extra.h</code>).
sv: <option>EXTRA_HFILES</option> låter dig ange extra huvudfiler som ska inkluderas då API-dokumentation eftersöks, vilka inte hittas under <code>DOC_SOURCE_DIR</code> (t.ex. <code> EXTRA_HFILES=$(top_srcdir}/contrib/extra.h</code>).

note: (itstool) path: listitem/para
en: <option>IGNORE_HFILES</option> allows to specify header files or directories to ignore when scanning for API documentation. Use the basename of the file or directory (e.g. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>).
sv: <option>IGNORE_HFILES</option> låter dig ange huvudfiler eller kataloger som ska ignoreras då API-dokumentation eftersöks. Använd basnamnet på filen eller katalogen (t.ex. <code> IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>).

note: (itstool) path: listitem/para
en: <option>HTML_IMAGES</option> allows to specify images files which will be copied into the <filename>html/</filename> directory of the generated documentation. If your API documentation includes any images they need to be added to this option (e.g. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png</code>).
sv: <option>HTML_IMAGES</option> låter dig ange bildfiler som kommer att kopieras till katalogen <filename>html/</filename> av den genererade dokumentationen. Om din API-dokumentation inkluderar några bilder behöver de läggas till i denna flagga (t.ex. <code> HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png</code>).

note: (itstool) path: listitem/para
en: <option>content_files</option> allows to specify extra files that are included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> content_files=running.xml building.xml changes-2.0.xml</code>).
sv: <option>content_files</option> låter dig ange extrafiler som inkluderas av <code>$(DOC_MAIN_SGML_FILE)</code> (t.ex. <code> content_files=running.xml building.xml changes-2.0.xml</code>).

note: (itstool) path: listitem/para
en: <option>expand_content_files</option> allows to specify files where <emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> are expanded (e.g. <code> expand_content_files=running.xml</code>).
sv: <option>expand_content_files</option> låter dig ange filer där <emphasis>gtk-doc-förkortningar</emphasis> så som <code>#GtkWidget</code> expanderas (t.ex. <code> expand_content_files=running.xml</code>).

note: (itstool) path: sect2/para
en: The following list explains the most relevant options. Check the example <filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>
sv: Följande lista förklarar de mest relevanta flaggorna. Se <filename>Makefile.am</filename>-exemplet för ytterligare flaggor. <_:itemizedlist-1/>

note: (itstool) path: sect2/title
en: Integration with autoconf
sv: Integrering med autoconf

note: (itstool) path: sect2/para
en: Integration with <application>autoconf</application> is very simple and includes one required step and an additional optional (but recommended) step. The first step is to add the <function>GTK_DOC_CHECK</function> macro to your <filename>configure.ac</filename> script. This registers several configure options to enable GTK-Doc and allows you to set default arguments for <application>gtkdocize</application>.
sv: Integrering med <application>autoconf</application> är väldigt enkel och inkluderar ett obligatoriskt steg och ett ytterligare valfritt (men rekommenderat) steg. Det första steget är att lägga till <function>GTK_DOC_CHECK</function>-makrot till ditt <filename>configure.ac</filename>-skript. Detta registrerar flera konfigurationsflaggor för att aktivera GTK-Doc och låter dig ställa in standardargument för <application>gtkdocize</application>.

note: (itstool) path: warning/simpara
en: Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The macro must start at the beginning of the line and should not start with whitespace.
sv: Säkerställ att makrot <code>GTK_DOC_CHECK</code> inte är indenterat. Makrot måste inledas på början av raden och får inte börja med blanktecken.

note: (itstool) path: sect2/para
en: The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your <filename>configure.ac</filename>. This is not required but helps <application>gtkdocize</application> to automatically copy the macro definition (e.g <filename>gtk-doc.m4</filename>) which contains the <function>GTK_DOC_CHECK</function> macro to your project's macro directory. Without this, the GTK_DOC_CHECK macro might not be found and you would need to explicitly tell the <application>aclocal</application> tool where to find the macro definition file.
sv: Det andra steget är att lägga till <code>AC_CONFIG_MACRO_DIR(m4)</code> till din <filename>configure.ac</filename>. Detta krävs inte men hjälper <application>gtkdocize</application> att automatiskt kopiera makrodefinitionen (t.ex. <filename>gtk-doc.m4</filename>) som innehåller <function>GTK_DOC_CHECK</function>-makrot till ditt projekts makrokatalog. Utan detta kanske GTK_DOC_CHECK-makrot inte hittas och du skulle behöva explicit berätta för <application>aclocal</application>-verktyget var makrodefinitionsfilen kan hittas.

note: (itstool) path: example/title
en: Minimal integration with autoconf
sv: Minimal integrering med autoconf

note: (itstool) path: example/programlisting
en: 
    # recommended: set m4 directory
    AC_CONFIG_MACRO_DIR(m4)
    # optional: register gtk-doc in configure
    GTK_DOC_CHECK([1.28])
sv: 
    # rekommenderat: ställ in m4-katalog
    AC_CONFIG_MACRO_DIR(m4)
    # valfritt: registrera gtk-doc i configure
    GTK_DOC_CHECK([1.28])

note: (itstool) path: example/title
en: Integration with optional gtk-doc dependency
sv: Integrering med valfritt gtk-doc-beroende

note: (itstool) path: example/programlisting
en: 
    m4_ifdef([GTK_DOC_CHECK], [
    # recommended: set m4 directory
    AC_CONFIG_MACRO_DIR(m4)
    # optional: register gtk-doc in configure
    GTK_DOC_CHECK([1.28])
    ],[
    AM_CONDITIONAL([ENABLE_GTK_DOC], false)
    ])
sv: 
    m4_ifdef([GTK_DOC_CHECK], [
    # rekommenderat: ställ in m4-katalog
    AC_CONFIG_MACRO_DIR(m4)
    # valfritt: registrera gtk-doc i configure
    GTK_DOC_CHECK([1.28])
    ],[
    AM_CONDITIONAL([ENABLE_GTK_DOC], false)
    ])

note: (itstool) path: sect2/para
en: The above example works, but will require all developers to have gtk-doc installed. A better way is to make building the documentation optional as shown in the next example: <_:example-1/>
sv: Exemplet ovan fungerar, men skulle kräva att alla utvecklare har gtk-doc installerat. Ett bättre sätt är att göra byggande av dokumentationen valfritt på det sätt som visas i nästa exempel: <_:example-1/>

note: (itstool) path: sect2/para
en: The first argument is used to check for the Gtk-Doc version at configure time. The 2nd, optional argument is used by <application>gtkdocize</application>. The <symbol>GTK_DOC_CHECK</symbol> macro also adds several configure switches:
sv: Det första argumentet används för att leta efter Gtk-Doc-versionen under konfigurationen. Det andra, valfria, argumentet används av <application>gtkdocize</application>. Makrot <symbol>GTK_DOC_CHECK</symbol> lägger också till flera configure-flaggor:

note: (itstool) path: listitem/para
en: --with-html-dir=PATH : path to installed docs
sv: --with-html-dir=SÖKVÄG : sökväg till installerad dokumentation

note: (itstool) path: listitem/para
en: --enable-gtk-doc : use gtk-doc to build documentation [default=no]
sv: --enable-gtk-doc : använd gtk-doc för att bygga dokumentation [standardvärde=no]

note: (itstool) path: listitem/para
en: --enable-gtk-doc-html : build documentation in html format [default=yes]
sv: --enable-gtk-doc-html : bygg dokumentation i html-format [standardvärde=yes]

note: (itstool) path: listitem/para
en: --enable-gtk-doc-pdf : build documentation in pdf format [default=no]
sv: --enable-gtk-doc-pdf : bygg dokumentation i pdf-format [standardvärde=no]

note: (itstool) path: important/para
en: GTK-Doc is disabled by default! Remember to pass the option <option>'--enable-gtk-doc'</option> to the next <filename>configure</filename> run. Otherwise pregenerated documentation is installed (which makes sense for users but not for developers).
sv: GTK-Doc är inaktiverat som standard! Kom ihåg att skicka flaggan <option>”--enable-gtk-doc”</option> vid nästa körning av <filename>configure</filename>. Annars kommer förgenererad dokumentation att installeras (vilket är rimligt för användare men inte för utvecklare).

note: (itstool) path: sect2/para
en: After all changes to <filename>configure.ac</filename> are made, update the <filename>configure</filename> file. This can be done by re-running <code>autogen.sh</code>.
sv: Efter att alla ändringar i <filename>configure.ac</filename> är gjorda, uppdatera filen <filename>configure</filename>. Detta kan göras genom att köra om <code>autogen.sh</code>.

note: (itstool) path: sect2/title
en: Integration with autogen
sv: Integrering med autogen

note: (itstool) path: sect2/para
en: Most projects will have an <filename>autogen.sh</filename> script to setup the build infrastructure after the project was checked out from a version control system (such as git or svn). GTK-Doc comes with a script called <application>gtkdocize</application> which can be used to copy the necessary files needed by Gtk-Doc to the source directory.
sv: De flesta projekt kommer att ha ett <filename>autogen.sh</filename>-skript för att ställa in infrastrukturen för bygget efter utcheckning från ett versionshanteringssystem (så som git eller svn). GTK-Doc kommer med ett skript som heter <application>gtkdocize</application> som kan användas för att kopiera nödvändiga filer som behövs av Gtk-Doc till källkatalogen.

note: (itstool) path: sect2/para
en: It should be run before autoreconf, autoheader, automake or autoconf.
sv: Det bör köras före autoreconf, autoheader, automake eller autoconf.

note: (itstool) path: example/title
en: Running gtkdocize from autogen.sh
sv: Köra gtkdocize från autogen.sh

note: (itstool) path: example/title
en: Conditionally run gtkdocize from autogen.sh
sv: Köra gtkdocize villkorligt från autogen.sh

note: (itstool) path: example/programlisting
en: 
    GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)
    if test $? -ne 0; then
      echo "No gtk-doc support found. You can't build the docs."
    else
      $GTKDOCIZE || exit 1
    fi
sv: 
    GTKDOCIZE=$(which gtkdocize 2&gt;/dev/null)
    if test $? -ne 0; then
      echo "Inget gtk-doc-stöd funnet. Du kan inte bygga dokumentationen."
    else
      $GTKDOCIZE || exit 1
    fi

note: (itstool) path: sect2/para
en: When running <application>gtkdocize</application> it copies <filename>gtk-doc.make</filename> to your project root (or any directory specified by the <option>--docdir</option> option).
sv: När <application>gtkdocize</application> kör kopierar det <filename>gtk-doc.make</filename> till din projektrot (eller den katalog som anges med flaggan <option>--docdir</option>).

note: (itstool) path: sect2/para
en: <application>gtkdocize</application> checks your <filename>configure.ac</filename> script for the <function>GTK_DOC_CHECK</function> macro. The <function>GTK_DOC_CHECK</function> macro can be used to pass extra arguments to the <application>gtkdocize</application> script. the 2nd parameter in the <function>GTK_DOC_CHECK</function> macro.
sv: <application>gtkdocize</application> söker i ditt <filename>configure.ac</filename>-skript efter makrot <function>GTK_DOC_CHECK</function>. Makrot <function>GTK_DOC_CHECK</function> kan användas för att skicka extra argument till skriptet <application>gtkdocize</application>. den andra parametern i <function>GTK_DOC_CHECK</function>-makrot.

note: (itstool) path: sect2/para
en: Alternatively, additional arguments can also be passed to <application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</function> environment variable, or by directly specifying them to <application>gtkdocize</application> in <filename>autogen.sh</filename>.
sv: Alternativt kan ytterligare argument också skickas till <application>gtkdocize</application> via miljövariabeln <function>GTKDOCIZE_FLAGS</function>, eller genom att ange dem direkt till <application>gtkdocize</application> i <filename>autogen.sh</filename>.

note: (itstool) path: sect2/title
en: Executing GTK-Doc from the Build System
sv: Köra GTK-Doc från byggsystemet

note: (itstool) path: sect2/para
en: After the previous steps it's time to run the build. First we need to rerun <filename>autogen.sh</filename>. If this script runs configure for you, then give it the <option>--enable-gtk-doc</option> option. Otherwise manually run <filename>configure</filename> with this option afterwards.
sv: Efter de tidigare stegen är det dags att köra bygget. Först måste vi köra om <filename>autogen.sh</filename>. Om detta skript kör configure åt dig, kan du ge det flaggan <option>--enable-gtk-doc</option>. Annars kör manuellt <filename>configure</filename> med denna flagga efteråt.

note: (itstool) path: sect2/para
en: The first make run generates several additional files in the doc-directories. The important ones are: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
sv: Den första körningen av make genererar flera extra filer i doc-katalogerna. De viktiga är <filename>&lt;paket&gt;.types</filename>, <filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), <filename>&lt;paket&gt;-sections.txt</filename>.

note: (itstool) path: example/title
en: Running the doc build
sv: Att köra dokumentationsbygget

note: (itstool) path: sect2/para
en: Now you can point your browser to <filename>docs/reference/&lt;package&gt;/index.html</filename>. With this initial setup you will only see a very simple document. The next chapter will teach you how to add API documentation to your code via special comment blocks. The Chapter afterwards introduces <link linkend="metafiles">additional files</link> and shows how to edit the <link linkend="metafiles_master">master template</link> to add additional chapters and sections to your documentation files.
sv: Nu kan du peka din webbläsare till <filename>docs/reference/&lt;paket&gt;/index.html</filename>. Med denna ursprungliga konfiguration kommer du bara se ett väldigt enkelt dokument. Nästa kapitel kommer att lära dig hur du lägger till API-dokumentation till din kod via speciella kommentarsblock. Kapitlet efteråt introducerar <link linkend="metafiles">ytterligare filer</link> och visar hur <link linkend="metafiles_master">huvudmallen</link> redigeras för att lägga till ytterligare kapitel och avsnitt till dina dokumentationsfiler.

note: (itstool) path: sect1/title
en: Integration with CMake build systems
sv: Integrering med CMake-byggsystem

note: (itstool) path: sect1/para
en: GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). This provides a <literal>gtk_doc_add_module</literal> command that you can set in your <filename>CMakeLists.txt</filename> file.
sv: GTK-Doc kommer nu att producera en <filename>GtkDocConfig.cmake</filename>-modul (och motsvarande <filename>GtkDocConfigVersion.cmake</filename>-modul). Detta tillhandahåller ett <literal>gtk_doc_add_module</literal>-kommando som du kan ställa in i din <filename>CMakeLists.txt</filename>-fil.

note: (itstool) path: example/title
en: Example of using GTK-Doc from CMake
sv: Exempel på användning av GTK-Doc från CMake

note: (itstool) path: example/programlisting
en: 
    find_package(GtkDoc 1.25 REQUIRED)
    
    # Create the doc-libmeep target.
    gtk_doc_add_module(
       libmeep ${CMAKE_SOURCE_DIR}/libmeep
          XML meep-docs.xml
          LIBRARIES libmeep
    )
    
    # Build doc-libmeep as part of the default target. Without this, you would
    # have to explicitly run something like `make doc-libmeep` to build the docs.
    add_custom_target(documentation ALL DEPENDS doc-libmeep)
    
    # Install the docs. (This assumes you're using the GNUInstallDirs CMake module
    # to set the CMAKE_INSTALL_DOCDIR variable correctly).
    install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html
            DESTINATION ${CMAKE_INSTALL_DOCDIR})
sv: 
    find_package(GtkDoc 1.25 REQUIRED)
    
    # Skapa målet doc-libmeep.
    gtk_doc_add_module(
       libmeep ${CMAKE_SOURCE_DIR}/libmeep
          XML meep-docs.xml
          LIBRARIES libmeep
    )
    
    # Bygg doc-libmeep som standardmålet. Utan detta måste du uttryckligen
    # köra något i stil med `make doc-libmeep` för att bygga dokumentationen.
    add_custom_target(documentation ALL DEPENDS doc-libmeep)
    
    # Installera dokumentationen. (Detta förutsätter att du använder CMake-modulen
    # GNUInstallDirs för att ställa in variabeln CMAKE_INSTALL_DOCDIR korrekt).
    install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/libmeep/html
            DESTINATION ${CMAKE_INSTALL_DOCDIR})

note: (itstool) path: sect1/para
en: The following example shows how to use this command. <_:example-1/>
sv: Det följande exemplet visar hur du använder detta kommando. <_:example-1/>

note: (itstool) path: sect1/title
en: Integration with plain makefiles or other build systems
sv: Integrering med vanliga makefiler eller andra byggsystem

note: (itstool) path: sect1/para
en: In the case one does not want to use automake and therefore <filename>gtk-doc.mak</filename> one will need to call the gtkdoc tools in the right order in own makefiles (or other build tools).
sv: I det fall man inte vill använda automake och därför inte heller <filename>gtk-doc.mak</filename> kommer man att behöva anropa gtkdoc-verktygen i rätt ordning i sina egna makefiler (eller andra byggverktyg).

note: (itstool) path: example/title
en: Documentation build steps
sv: Byggsteg för dokumentation

note: (itstool) path: example/programlisting
en: 
    DOC_MODULE=meep
    // sources have changed
    gtkdoc-scan --module=$(DOC_MODULE) &lt;source-dir&gt;
    gtkdoc-scangobj --module=$(DOC_MODULE)
    gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;source-dir&gt;
    // xml files have changed
    mkdir html
    cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml
    gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html
sv: 
    DOC_MODULE=meep
    // källkod har ändrats
    gtkdoc-scan --module=$(DOC_MODULE) &lt;källkodskatalog&gt;
    gtkdoc-scangobj --module=$(DOC_MODULE)
    gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --source-dir=&lt;källkodskatalog&gt;
    // xml-filer har ändrats
    mkdir html
    cd html &amp;&amp; gtkdoc-mkhtml $(DOC_MODULE) ../meep-docs.xml
    gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html

note: (itstool) path: sect1/para
en: One will need to look at the <filename>Makefile.am</filename> and <filename>gtk-doc.mak</filename> to pick the extra options needed.
sv: Man kommer att behöva titta i <filename>Makefile.am</filename> och <filename>gtk-doc.mak</filename> för att plocka ut de extra flaggor som behövs.

note: (itstool) path: sect1/title
en: Integration with version control systems
sv: Integrering med versionshanteringssystem

note: (itstool) path: sect1/para
en: As a rule of thumb, it's the files you edit which should go under version control. For typical projects it's these files: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>, <filename>Makefile.am</filename>.
sv: Som en tumregel är det filerna du redigerar som bör versionshanteras. För typiska projekt är det följande filer: <filename>&lt;paket&gt;.types</filename>, <filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), <filename>&lt;paket&gt;-sections.txt</filename>, <filename>Makefile.am</filename>.

note: (itstool) path: sect1/para
en: Files in the <filename>xml/</filename> and <filename>html/</filename> directories should not go under version control. Neither should any of the <filename>.stamp</filename> files.
sv: Filer i katalogerna <filename>xml/</filename> och <filename>html/</filename> bör inte versionshanteras. Detsamma gäller <filename>.stamp</filename>-filerna.

note: (itstool) path: chapter/title
en: Documenting the code
sv: Att dokumentera koden

note: (itstool) path: chapter/para
en: GTK-Doc uses source code comment with a special syntax for code documentation. Further it retrieves information about your project structure from other sources. During the next section you will find all information about the syntax of the comments.
sv: GTK-Doc använder källkodskommentarer med en speciell syntax för koddokumentation. Vidare så hämtar det information om din projektstruktur från olika källor. Under nästa avsnitt kommer du att hitta information om syntaxen i kommentarerna.

note: (itstool) path: example/title
en: GTK-Doc comment block
sv: GTK-Doc-kommentarsblock

note: (itstool) path: chapter/para
en: The GTK-Doc scanner can handle the majority of C headers fine. In the case of receiving warnings from the scanner that look like a special case, one can hint GTK-Doc to skip over them. <_:example-1/>
sv: GTK-Doc-detektorn kan hantera majoriteten av C-huvuden bra. I det fall när du får varningar från detektorn som ser ut som ett specialfall, kan du tipsa GTK-Doc att hoppa över dem. <_:example-1/>

note: (itstool) path: note/title
en: Limitations
sv: Begränsningar

note: (itstool) path: note/para
en: Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations.
sv: Notera att GTK-Doc har stöd för <code>#ifndef(__GTK_DOC_IGNORE__)</code> men inte <code>#if !defined(__GTK_DOC_IGNORE__)</code> eller andra kombinationer.

note: (itstool) path: sect1/title
en: Documentation comments
sv: Dokumentationskommentarer

note: (itstool) path: example/programlisting
en: 
    /**
     * identifier:
     * documentation ...
     */
sv: 
    /**
     * identifierare:
     * dokumentation …
     */

note: (itstool) path: sect1/para
en: A multiline comment that starts with an additional '*' marks a documentation block that will be processed by the GTK-Doc tools. <_:example-1/>
sv: En flerradskommentar som börjar med en extra ”*” markerar ett dokumentationsblock som kommer att hanteras av GTK-Doc-verktygen. <_:example-1/>

note: (itstool) path: sect1/para
en: The 'identifier' is one line with the name of the item the comment is related to. The syntax differs a little depending on the item. (TODO add table showing identifiers)
sv: 'Identifierare' är en rad med namnet på det objekt som kommentaren är relaterad till. Syntaxen skiljer sig lite beroende på objekt. (TODO lägg till tabell som visar identifierare)

note: (itstool) path: sect1/para
en: The 'documentation' block is also different for each symbol type. Symbol types that get parameters such as functions or macros have the parameter description first followed by a blank line (just a '*'). Afterwards follows the detailed description. All lines (outside program listings and CDATA sections) just containing a ' *' (blank-asterisk) are converted to paragraph breaks. If you don't want a paragraph break, change that into ' * ' (blank-asterisk-blank-blank). This is useful in preformatted text (code listings).
sv: Blocket 'dokumentation' skiljer sig också för varje symboltyp. Symboltyper som får parametrar så som funktioner eller makron har en parameterbeskrivning först, åtföljd av en blankrad (bara en ”*”). Efteråt följer den detaljerade beskrivningen. Alla rader (utanför programlistningar och CDATA-avsnitt) som endast innehåller ” *” (blanksteg-asterisk) konverteras till styckeavgränsare. Om du inte vill ha en styckeavgränsare, ändra till ” *  ” (blanksteg-asterisk-blanksteg-blanksteg). Detta är användbart i förformaterad text (kodlistningar).

note: (itstool) path: listitem/para
en: What it is: The name for a class or function can sometimes be misleading for people coming from a different background.
sv: Vad är detta: Namnet på en klass eller en funktion kan ibland vara vilseledande för personer med annan bakgrund.

note: (itstool) path: listitem/para
en: What it does: Tell about common uses. Put it in relation with the other API.
sv: Vad gör det: Berättar om vanliga användningsfall. Sätter det i relation med det andra API:t.

note: (itstool) path: tip/para
en: When documenting code, describe two aspects: <_:itemizedlist-1/>
sv: När du dokumenterar kod, beskriv två aspekter: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: Use function() to refer to functions or macros which take arguments.
sv: Använd funktion() för att referera till funktioner eller makron som tar argument.

note: (itstool) path: listitem/para
en: Use @param to refer to parameters. Also use this when referring to parameters of other functions, related to the one being described.
sv: Använd @param för att referera till parametrar. Använd också detta när du refererar till parametrar för andra funktioner, relaterade till den som beskrivs.

note: (itstool) path: listitem/para
en: Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS.
sv: Använd %konstant för att referera till en konstant, t.ex. %G_TRAVERSE_LEAFS.

note: (itstool) path: listitem/para
en: Use #symbol to refer to other types of symbol, e.g. structs and enums and macros which don't take arguments.
sv: Använd #symbol för att referera till andra typer av symboler, t.ex. strukturer eller uppräkningar och makron som inte tar argument.

note: (itstool) path: listitem/para
en: Use #Object::signal to refer to a GObject signal.
sv: Använd #Objekt::signal för att referera till en GObject-signal.

note: (itstool) path: listitem/para
en: Use #Object:property to refer to a GObject property.
sv: Använd #Objekt:egenskap för att referera till en GObject-egenskap.

note: (itstool) path: listitem/para
en: Use #Struct.field to refer to a field inside a structure and #GObjectClass.foo_bar() to refer to a vmethod.
sv: Använd #Struktur.fält för att referera till ett fält inuti en struktur och #GObjectKlass.foo_bar() för att referera till en virtuell metod.

note: (itstool) path: sect1/para
en: One advantage of hyper-text over plain-text is the ability to have links in the document. Writing the correct markup for a link can be tedious though. GTK-Doc comes to help by providing several useful abbreviations. <_:itemizedlist-1/>
sv: En fördel med hypertext framför vanlig text är möjligheten att ha länkar i dokumentet. Att skriva korrekta taggar för en länk kan dock vara tröttsamt. GTK-Doc hjälper då till med att tillhandahålla flera användbara förkortningar. <_:itemizedlist-1/>

note: (itstool) path: tip/para
en: If you need to use the special characters '&lt;', '&gt;', '()', '@', '%', or '#' in your documentation without GTK-Doc changing them you can use the XML entities "&amp;lt;", "&amp;gt;", "&amp;lpar;", "&amp;rpar;", "&amp;commat;", "&amp;percnt;" and "&amp;num;" respectively or escape them with a backslash '\'.
sv: Om du behöver använda specialtecken ”&lt;”, ”&gt;”, ”()”, ”@”, ”%” eller ”#” i din dokumentation utan att GTK-Doc ändrar dem kan du använda XML-entiteterna ”&amp;lt;”, ”&amp;gt;”, ”&amp;lpar;”, ”&amp;rpar;”, ”&amp;commat;”, ”&amp;percnt;” respektive ”&amp;num;” eller använda kontrollsekvensen ”\”.

note: (itstool) path: sect1/para
en: DocBook can do more than just links. One can also have lists, examples, headings, and images. As of version 1.20, the preferred way is to use a subset of the basic text formatting syntax called <ulink url="http://daringfireball.net/projects/markdown/">Markdown</ulink>. On older GTK-Doc versions any documentation that includes Markdown will be rendered as is. For example, list items will appear as lines starting with a dash.
sv: DocBook kan mer än bara länkar. Du kan också ha listor, exempel, rubriker och bilder. Från och med version 1.20, är det föredragna sättet att använda en delmängd av den grundläggande textformateringssyntaxen som kallas <ulink url="http://daringfireball.net/projects/markdown/">Markdown</ulink>. Äldre GTK-Doc-versioner kommer dokumentation som inkluderar markdown att renderas som den är. Till exempel kommer listobjekt att visas som att de börjar med ett bindestreck.

note: (itstool) path: sect1/para
en: While markdown is now preferred one can mix both. One limitation here is that one can use docbook xml within markdown, but markdown within docbook xml is not supported.
sv: Då markdown numera föredras kan du blanda båda. En begränsning här är att du kan använda docbook-xml inuti markdown, men markdown inuti docbook-xml stöds inte.

note: (itstool) path: sect1/para
en: In older GTK-Doc releases, if you need support for additional formatting, you would need to enable the usage of docbook XML tags inside doc-comments by putting <option>--xml-mode</option> (or <option>--sgml-mode</option>) in the variable <symbol>MKDB_OPTIONS</symbol> inside <filename>Makefile.am</filename>.
sv: I äldre GTK-Doc-versioner var du tvungen, om du ville ha stöd för ytterligare formatering, att aktivera användningen av docbook-XML-taggar inuti dok-kommentarer genom att lägga till <option>--xml-mode</option> (eller <option>--sgml-mode</option>) i variabeln <symbol>MKDB_OPTIONS</symbol> inuti <filename>Makefile.am</filename>.

note: (itstool) path: example/title
en: GTK-Doc comment block using Markdown
sv: GTK-Doc-kommentarsblock som använder Markdown

note: (itstool) path: example/programlisting
en: 
    /**
     * identifier:
     *
     * documentation paragraph ...
     *
     * # Sub Heading #
     *
     * ## Second Sub Heading
     *
     * # Sub Heading With a Link Anchor # {#heading-two}
     *
     * more documentation:
     *
     * - list item 1
     *
     *   Paragraph inside a list item.
     *
     * - list item 2
     *
     * 1. numbered list item
     *
     * 2. another numbered list item
     *
     * Another paragraph. [A Link to the GNOME Website](http://www.gnome.org/)
     *
     * ![an inline image](plot-result.png)
     *
     * [A link to the heading anchor above][heading-two]
     *
     * A C-language example:
     * |[&lt;!-- language="C" --&gt;
     * GtkWidget *label = gtk_label_new ("Gorgeous!");
     * ]|
     */
sv: 
    /**
     * Identifierare:
     *
     * stycke med dokumentation …
     *
     * # Underrubrik #
     *
     * ## Underunderrubrik
     *
     * # Underrubrik med länkankare # {#andra-rubriken}
     *
     * mer dokumentation:
     *
     * - listobjekt 1
     *
     *   Stycke inuti listobjekt.
     *
     * - listobjekt 2
     *
     * 1. numrerat listobjekt
     *
     * 2. ytterligare ett numrerat listobjekt
     *
     * Ett annat stycke. [En länk till GNOME:s webbplats](http://www.gnome.org/)
     *
     * ![en bild](resultatgraf.png)
     *
     * [En länk till rubrikankaret ovan][andra-rubriken]
     *
     * Ett C-exempel:
     * |[&lt;!-- language="C" --&gt;
     * GtkWidget *label = gtk_label_new ("Vackert!");
     * ]|
     */

note: (itstool) path: sect1/para
en: More examples of what markdown tags are supported can be found in the <ulink url="https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown">GTK Documentation Markdown Syntax Reference</ulink>.
sv: Fler exempel på vilka markdown-taggar som stöds hittas i <ulink url="https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown">Referensen för GTK-dokumentationens markdown-syntax</ulink>.

note: (itstool) path: tip/para
en: As already mentioned earlier GTK-Doc is for documenting public API. Thus one cannot write documentation for static symbols. Nevertheless it is good to comment those symbols too. This helps other developers to understand your code. Therefore we recommend to comment these using normal comments (without the 2nd '*' in the first line). If later the function needs to be made public, all one needs to do is to add another '*' in the comment block and insert the symbol name at the right place inside the sections file.
sv: Som redan nämnts är GTK-Doc avsett för att dokumentera publika API:er. Du kan därför inte skriva dokumentation för statiska symboler. Likväl är det bra att kommentera även dessa symboler. Det hjälper andra utvecklare att förstå din kod. Därför rekommenderar vi att du kommenterar dessa med normala kommentarer (utan den andra ”*” på den första raden). Om funktionen vid ett senare tillfälle måste göras publik är allt du behöver göra att lägga till ytterligare en ”*” i kommentarsblocket och infoga symbolnamnet på rätt ställe i avsnittsfilen.

note: (itstool) path: sect1/title
en: Documenting sections
sv: Dokumentationsavsnitt

note: (itstool) path: sect1/para
en: Each section of the documentation contains information about one class or module. To introduce the component one can write a section block. The short description is also used inside the table of contents. All the @fields are optional.
sv: Varje avsnitt av dokumentation innehåller information om en klass eller en modul. För att introducera komponenten kan man skriva ett avsnittsblock. Den korta beskrivningen används också i innehållsförteckningen. Alla @fälten är valfria.

note: (itstool) path: example/title
en: Section comment block
sv: Kommentarsblock för avsnitt

note: (itstool) path: example/programlisting
en: 
    /**
     * SECTION:meepapp
     * @short_description: the application class
     * @title: Meep application
     * @section_id:
     * @see_also: #MeepSettings
     * @stability: Stable
     * @include: meep/app.h
     * @image: application.png
     *
     * The application class handles ...
     */
sv: 
    /**
     * SECTION:meepapp
     * @short_description: programklassen
     * @title: Meep-programmet
     * @section_id:
     * @see_also: #MeepSettings
     * @stability: Stable
     * @include: meep/app.h
     * @image: application.png
     *
     * Programklassen hanterar …
     */

note: (itstool) path: varlistentry/term
en: SECTION:&lt;name&gt;
sv: SECTION:&lt;namn&gt;

note: (itstool) path: listitem/para
en: The name links the section documentation to the respective part in the <filename>&lt;package&gt;-sections.txt</filename> file. The name given here should match the &lt;FILE&gt; tag in the <filename>&lt;package&gt;-sections.txt</filename> file.
sv: Namnet länkar till avsnittsdokumentationen för respektive del i filen <filename>&lt;paket&gt;-sections.txt</filename>. Namnet som anges här bör matcha taggen &lt;FILE&gt; i filen <filename>&lt;paket&gt;-sections.txt</filename>.

note: (itstool) path: listitem/para
en: A one line description of the section, that later will appear after the links in the TOC and at the top of the section page.
sv: En enradsbeskrivning av avsnittet som senare kommer att visas efter länkar i innehållsförteckningen och lägst upp på avsnittssidan.

note: (itstool) path: listitem/para
en: The section title defaults to &lt;name&gt; from the SECTION declaration. It can be overridden with the @title field.
sv: Avsnittstiteln är som standard &lt;namn&gt; från SECTION-deklarationen. Den kan åsidosättas med fältet @title.

note: (itstool) path: listitem/para
en: Overrides the use of title as a section identifier. For GObjects the &lt;title&gt; is used as a section_id and for other sections it is &lt;MODULE&gt;-&lt;title&gt;.
sv: Åsidosätter användningen av titeln som avsnittsidentifierare. För GObjects används &lt;title&gt; som ett section_id och för andra avsnitt är det &lt;MODULE&gt;-&lt;title&gt;.

note: (itstool) path: listitem/para
en: A list of symbols that are related to this section.
sv: En lista över symboler som är relaterade till detta avsnitt.

note: (itstool) path: listitem/para
en: Stable - The intention of a Stable interface is to enable arbitrary third parties to develop applications to these interfaces, release them, and have confidence that they will run on all minor releases of the product (after the one in which the interface was introduced, and within the same major release). Even at a major release, incompatible changes are expected to be rare, and to have strong justifications.
sv: Stable - Avsikten med ett stabilt gränssnitt är att möjliggöra för tredje parter att utveckla program mot dessa gränssnitt, släppa dem och vara säkra på att de kommer att köra på alla programfixversioner av produkten (efter den i vilken gränssnittet introducerats, och inom samma huvudversion). Även vid en ny huvudversion förväntas inkompatibla ändringar vara få och vara väl motiverade.

note: (itstool) path: listitem/para
en: Unstable - Unstable interfaces are experimental or transitional. They are typically used to give outside developers early access to new or rapidly changing technology, or to provide an interim solution to a problem where a more general solution is anticipated. No claims are made about either source or binary compatibility from one minor release to the next.
sv: Unstable - Instabila gränssnitt är experimentella eller i en övergångsfas. De används typiskt för att ge utomstående utvecklare tidig tillgång till ny eller snabbt föränderlig teknologi, eller för att tillhandahålla provisoriska lösningar för ett problem där en mer generell lösning förutses. Inga påståenden görs om endera källkods- eller binärkompatibilitet från en programfixversion till nästa.

note: (itstool) path: listitem/para
en: Private - An interface that can be used within the GNOME stack itself, but that is not documented for end-users. Such functions should only be used in specified and documented ways.
sv: Private - Ett gränssnitt som kan användas inom GNOME-stacken i sig, men som inte dokumenterats för slutanvändare. Sådana funktioner bör endast användas på angivna och dokumenterade sätt.

note: (itstool) path: listitem/para
en: Internal - An interface that is internal to a module and does not require end-user documentation. Functions that are undocumented are assumed to be Internal.
sv: Internal - ett gränssnitt som är internt för en modul och inte behöver slutanvändardokumentation. Funktioner som är odokumenterade förutsätts vara interna.

note: (itstool) path: listitem/para
en: An informal description of the stability level this API has. We recommend the use of one of these terms: <_:itemizedlist-1/>
sv: En informell beskrivning över stabiliteten för detta API. Vi rekommenderar att använda en av dessa termer: <_:itemizedlist-1/>

note: (itstool) path: listitem/para
en: The <literal>#include</literal> files to show in the section synopsis (a comma separated list), overriding the global value from the <link linkend="metafiles_sections">section file</link> or command line. This item is optional.
sv: <literal>#include</literal>-filerna som ska visas i avsnittssammanfattningen (en kommaavgränsad lista), vilket åsidosätter det globala värdet från <link linkend="metafiles_sections">avsnittsfilen</link> eller kommandoraden. Detta objekt är valfritt.

note: (itstool) path: listitem/para
en: The image to display at the top of the reference page for this section. This will often be some sort of a diagram to illustrate the visual appearance of a class or a diagram of its relationship to other classes. This item is optional.
sv: Bilden som ska visas längst upp på referenssidan för detta avsnitt. Detta kommer ofta att vara någon form av diagram för att illustrera det visuella utseendet för en klass eller ett diagram över dess relationer med andra klasser. Detta objekt är valfritt.

note: (itstool) path: tip/para
en: To avoid unnecessary recompilation after doc-changes put the section docs into the c-source where possible.
sv: För att undvika onödig omkompilering efter dokumentationsändringar, placera avsnittsdokumentationen i c-källkoden där möjligt.

note: (itstool) path: sect1/title
en: Documenting symbols
sv: Dokumentationssymboler

note: (itstool) path: sect1/para
en: Each symbol (function, macro, struct, enum, signal and property) is documented in a separate block. The block is best placed close to the definition of the symbols so that it is easy to keep them in sync. Thus functions are usually documented in the c-source and macros, structs and enums in the header file.
sv: Varje symbol (funktion, makro, struktur, uppräkning, signal och egenskap) är dokumenterad i ett separat block. Blocket placeras bäst intill definitionen av symbolerna så att det är enkelt att hålla dem synkroniserade. Därför dokumenteras funktioner vanligtvis i c-källkoden och makron, strukturer och uppräkningar i huvudfilen.

note: (itstool) path: sect2/title (itstool) path: example/title
en: General tags
sv: Generella taggar

note: (itstool) path: sect2/para
en: You can add versioning information to all documentation elements to tell when an API was introduced, or when it was deprecated.
sv: Du kan lägga till versioneringsinformation i alla dokumentationselement för att berätta när ett API introducerats eller blev föråldrat.

note: (itstool) path: variablelist/title
en: Versioning Tags
sv: Versioneringstaggar

note: (itstool) path: listitem/para
en: Description since which version of the code the API is available.
sv: Beskrivning över från och med vilken version av koden som API:t är tillgängligt.

note: (itstool) path: listitem/para
en: Paragraph denoting that this function should no be used anymore. The description should point the reader to the new API.
sv: Stycke som betecknar att denna funktion inte bör användas längre. Beskrivningen bör peka läsaren vidare till det nya API:t.

note: (itstool) path: sect2/para
en: You can also add stability information to all documentation elements to indicate whether API stability is guaranteed for them for all future minor releases of the project.
sv: Du kan också lägga till stabilitetsinformation för alla dokumentationselement för att indikera huruvida API-stabilitet är garanterad för dem för alla framtida programfix-versioner av projektet.

note: (itstool) path: sect2/para
en: The default stability level for all documentation elements can be set by passing the <option>--default-stability</option> argument to <application>gtkdoc-mkdb</application> with one of the values below.
sv: Standardvärdet för stabilitetsnivån för alla dokumentations element kan ställas in genom att ange argumentet <option>--default-stability</option> till <application>gtkdoc-mkdb</application> med endera av värdena nedan.

note: (itstool) path: variablelist/title
en: Stability Tags
sv: Stabilitetstaggar

note: (itstool) path: listitem/para
en: Mark the element as stable. This is for public APIs which are guaranteed to remain stable for all future minor releases of the project.
sv: Markera elementet som stabilt. Detta är för publika API:er som är garanterade att hållas stabila i alla framtida programfix-versioner av projektet.

note: (itstool) path: listitem/para
en: Mark the element as unstable. This is for public APIs which are released as a preview before being stabilised.
sv: Markera elementet som instabilt. Detta är för publika API:er som är släppta på förhand innan de blivit stabiliserade.

note: (itstool) path: listitem/para
en: Mark the element as private. This is for interfaces which can be used by tightly coupled modules, but not by arbitrary third parties.
sv: Markera element som privat. Detta är avsett för gränssnitt som kan användas av tätt sammankopplade moduler, men inte av godtyckliga tredje parter.

note: (itstool) path: example/programlisting
en: 
    /**
     * foo_get_bar:
     * @foo: some foo
     *
     * Retrieves @foo's bar.
     *
     * Returns: @foo's bar
     *
     * Since: 2.6
     * Deprecated: 2.12: Use foo_baz_get_bar() instead.
     */
    Bar *
    foo_get_bar(Foo *foo)
    {
    ...
sv: 
    /**
     * foo_get_bar:
     * @foo: någon foo
     *
     * Hämtar bar från @foo.
     *
     * Returns: bar från @foo
     *
     * Since: 2.6
     * Deprecated: 2.12: Använd foo_baz_get_bar() istället.
     */
    Bar *
    foo_get_bar(Foo *foo)
    {
    …

note: (itstool) path: sect2/title (itstool) path: example/title
en: Annotations
sv: Noteringar

note: (itstool) path: sect2/para
en: Documentation blocks can contain annotation-tags. These tags will be rendered with tooltips describing their meaning. The tags are used by GObject Introspection to generate language bindings. A detailed list of the supported tags can be found in the <ulink url="https://gi.readthedocs.io/en/latest/annotations/giannotations.html" type="http">GObject Introspection documentation</ulink>.
sv: Dokumentationsblock kan innehålla noteringstaggar. Dessa taggar kommer att renderas med inforutor som beskriver deras syfte. Taggarna används av GObject Introspection för att generera språkbindningar. En detaljerad lista över vilka taggar som stöds hittas i <ulink url="https://gi.readthedocs.io/en/latest/annotations/giannotations.html" type="http">dokumentationen för GObject Introspection</ulink>.

note: (itstool) path: example/programlisting
en: 
    /**
     * foo_get_bar: (annotation)
     * @foo: (annotation): some foo
     *
     * Retrieves @foo's bar.
     *
     * Returns: (annotation): @foo's bar
     */
    ...
    /**
     * foo_set_bar_using_the_frobnicator: (annotation) (another annotation)
     *                                    (and another annotation)
     * @foo: (annotation) (another annotation): some foo
     *
     * Sets bar on @foo.
     */
sv: 
    /**
     * foo_get_bar: (notering)
     * @foo: (notering): någon foo
     *
     * Hämtar bar från @foo.
     *
     * Returns: (notering): bar från @foo
     */
    ...
    /**
     * foo_set_bar_using_the_frobnicator: (notering) (an annan notering)
     *                                    (ytterligare en annan notering)
     * @foo: (notering) (en annan notering): någon foo
     *
     * Ställer in bar i @foo.
     */

note: (itstool) path: sect2/title (itstool) path: example/title
en: Function comment block
sv: Kommentarsblock för funktioner

note: (itstool) path: listitem/para
en: Document whether returned objects, lists, strings, etc, should be freed/unrefed/released.
sv: Dokumentera huruvida returnerade objekt, listor, strängar, etc. bör frigöras/avrefereras/släppas.

note: (itstool) path: listitem/para
en: Document whether parameters can be NULL, and what happens if they are.
sv: Dokumentera huruvida parametrar tillåts vara NULL och vad som händer om de är NULL.

note: (itstool) path: listitem/para
en: Mention interesting pre-conditions and post-conditions where appropriate.
sv: Nämn intressanta förvillkor och eftervillkor där lämpligt.

note: (itstool) path: sect2/para
en: Please remember to: <_:itemizedlist-1/>
sv: Kom ihåg att: <_:itemizedlist-1/>

note: (itstool) path: sect2/para
en: Gtk-doc assumes all symbols (macros, functions) starting with '_' are private. They are treated like static functions.
sv: Gtk-doc förutsätter att alla symboler (makron, funktioner) som börjar med ”_” är privata. De behandlas på samma sätt som statiska funktioner.

note: (itstool) path: example/programlisting
en: 
    /**
     * function_name:
     * @par1:  description of parameter 1. These can extend over more than
     * one line.
     * @par2:  description of parameter 2
     * @...: a %NULL-terminated list of bars
     *
     * The function description goes here. You can use @par1 to refer to parameters
     * so that they are highlighted in the output. You can also use %constant
     * for constants, function_name2() for functions and #GtkWidget for links to
     * other declarations (which may be documented elsewhere).
     *
     * Returns: an integer.
     *
     * Since: 2.2
     * Deprecated: 2.18: Use other_function() instead.
     */
sv: 
    /**
     * funktionsnamn:
     * @par1:  beskrivning av parameter 1. Dessa kan sträcka sig
     *  över mer än en rad.
     * @par2:  beskrivning av parameter 2
     * @...: en %NULL-terminerad lista av flera bar
     *
     * Funktionsbeskrivningen ska vara här. Du kan använda @par1 för att
     * referera till parametrar så att de färgmarkeras i utdata. Du kan också
     * använda %konstant för konstanter, funktionsnamn2() för funktioner och
     * #GtkWidget för länkar till andra deklarationer (vilka kan vara dokumenterade
     * på annat håll).
     *
     * Returns: ett heltal.
     *
     * Since: 2.2
     * Deprecated: 2.18: Använd annan_funktion() istället.
     */

note: (itstool) path: variablelist/title
en: Function tags
sv: Funktions-taggar

note: (itstool) path: listitem/para
en: Paragraph describing the returned result.
sv: Stycke som beskriver det returnerade resultatet.

note: (itstool) path: listitem/para
en: In case the function has variadic arguments, you should use this tag (@Varargs: does also work for historic reasons).
sv: Om funktionen har variadiska argument bör du använda denna tagg (@Varargs: fungerar också på grund av historiska skäl).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Property comment block
sv: Kommentarsblock för egenskaper

note: (itstool) path: example/programlisting
en: 
    /**
     * SomeWidget:some-property:
     *
     * Here you can document a property.
     */
    g_object_class_install_property (object_class, PROP_SOME_PROPERTY, ...);
sv: 
    /**
     * EnKomponent:en-egenskap:
     *
     * Här kan du dokumentera en egenskap.
     */
    g_object_class_install_property (object_class, PROP_EN_EGENSKAP, …);

note: (itstool) path: sect2/title (itstool) path: example/title
en: Signal comment block
sv: Kommentarsblock för signaler

note: (itstool) path: listitem/para
en: Document when the signal is emitted and whether it is emitted before or after other signals.
sv: Dokumentera när en signal sänds ut och huruvida den sänds ut före eller efter andra signaler.

note: (itstool) path: listitem/para
en: Document what an application might do in the signal handler.
sv: Dokumentera vad ett program kan göra i signalhanteraren.

note: (itstool) path: example/programlisting
en: 
    /**
     * FooWidget::foobarized:
     * @widget: the widget that received the signal
     * @foo: some foo
     * @bar: some bar
     *
     * The ::foobarized signal is emitted each time someone tries to foobarize @widget.
     */
    foo_signals[FOOBARIZED] =
      g_signal_new ("foobarized",
                    ...
sv: 
    /**
     * FooWidget::foobariserad:
     * @widget: komponenten som erhåller signalen
     * @foo: någon foo
     * @bar: någon bar
     *
     * Signalen ::foobariserad sänds ut varje gång någon försöker att foobarisera @widget.
     */
    foo_signals[FOOBARIZE] =
      g_signal_new ("foobariserad",
                    ...

note: (itstool) path: sect2/title (itstool) path: example/title
en: Struct comment block
sv: Kommentarsblock för strukturer

note: (itstool) path: example/programlisting
en: 
    /**
     * FooWidget:
     * @bar: some #gboolean
     *
     * This is the best widget, ever.
     */
    typedef struct _FooWidget {
      GtkWidget parent_instance;
    
      gboolean bar;
    } FooWidget;
sv: 
    /**
     * FooWidget:
     * @bar: någon #gboolean
     *
     * Detta är den bästa komponenten någonsin.
     */
    typedef struct _FooWidget {
      GtkWidget parent_instance;
    
      gboolean bar;
    } FooWidget;

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private struct fields you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
sv: Använd<code>/*&lt; private &gt;*/</code> före privata strukturfält som du vill gömma. Använd <code>/*&lt; public &gt;*/</code> för det omvända beteendet.

note: (itstool) path: sect2/para
en: If the first field is "g_iface", "parent_instance" or "parent_class" it will be considered private automatically and doesn't need to be mentioned in the comment block.
sv: Om det första fältet är ”g_iface”, ”parent_instance” eller ”parent_class” kommer det att anses vara privat automatiskt och behöver inte nämnas i kommentarsblocket.

note: (itstool) path: sect2/para
en: Struct comment blocks can also be used for GObjects and GObjectClasses. It is usually a good idea to add a comment block for a class, if it has vmethods (as this is how they can be documented). For the GObject itself one can use the related section docs, having a separate block for the instance struct would be useful if the instance has public fields. One disadvantage here is that this creates two index entries of the same name (the structure and the section).
sv: Kommentarsblock för strukturer kan också användas för GObject och GObjectClass. Det är vanligtvis en bra idé att lägga till ett kommentarsblock för en klass om den har virtuella metoder (då detta är sättet på vilket de kan dokumenteras). För GObject i sig kan man använda den relaterade avsnittsdokumentationen, och ha ett separat block för varje instansstruktur vore användbart om instansen har publika fält. En nackdel här är att det skapar två indexposter med samma namn (strukturen och avsnittet).

note: (itstool) path: sect2/title (itstool) path: example/title
en: Enum comment block
sv: Kommentarsblock för uppräkningar

note: (itstool) path: example/programlisting
en: 
    /**
     * Something:
     * @SOMETHING_FOO: something foo
     * @SOMETHING_BAR: something bar
     *
     * Enum values used for the thing, to specify the thing.
     */
    typedef enum {
      SOMETHING_FOO,
      SOMETHING_BAR,
      /*&lt; private &gt;*/
      SOMETHING_COUNT
    } Something;
sv: 
    /**
     * Something:
     * @SOMETHING_FOO: någonting foo
     * @SOMETHING_BAR: någonting bar
     *
     * Uppräkningsvärden som används för saken, för att specificera saken.
     */
    typedef enum {
      SOMETHING_FOO,
      SOMETHING_BAR,
      /*&lt; private &gt;*/
      SOMETHING_COUNT
    } Something;

note: (itstool) path: sect2/para
en: Use <code>/*&lt; private &gt;*/</code> before the private enum values you want to hide. Use <code>/*&lt; public &gt;*/</code> for the reverse behaviour.
sv: Använd <code>/*&lt; private &gt;*/</code> före privata uppräkningsvärden som du vill gömma. Använd <code>/*&lt; public &gt;*/</code> för det omvända beteendet.

note: (itstool) path: sect1/title
en: Inline program documentation
sv: Infogad programdokumentation

note: (itstool) path: sect1/para
en: You can document programs and their commandline interface using inline documentation.
sv: Du kan dokumentera program och deras kommandoradsgränssnitt med infogad dokumentation.

note: (itstool) path: variablelist/title
en: Tags
sv: Taggar

note: (itstool) path: listitem/para
en: Defines the start of a program documentation.
sv: Definierar början av programdokumentationen.

note: (itstool) path: listitem/para
en: Defines a short description of the program. (Optional)
sv: Definierar en kort beskrivning av programmet. (Valfritt)

note: (itstool) path: listitem/para
en: Defines the arguments, or list of arguments that the program can take. (Optional)
sv: Definierar argumenten, eller en lista av argument som programmet kan ta. (Valfritt)

note: (itstool) path: listitem/para
en: See Also manual page section. (Optional)
sv: Se vidare i manualavsnitt. (Valfritt)

note: (itstool) path: listitem/para
en: Argument(s) passed to the program and their description. (Optional)
sv: Argument som skickas vidare till programmet och deras beskrivningar. (Valfritt)

note: (itstool) path: varlistentry/term
en: Description:
sv: Beskrivning:

note: (itstool) path: listitem/para
en: A longer description of the program.
sv: En längre beskrivning av programmet.

note: (itstool) path: listitem/para
en: Specify what value(s) the program returns. (Optional)
sv: Ange vilka värden programmet returnerar. (Valfritt)

note: (itstool) path: sect2/title
en: Example of program documentation.
sv: Exempel på programdokumentation.

note: (itstool) path: example/title
en: Program documentation block
sv: Dokumentationsblock för program

note: (itstool) path: example/programlisting
en: 
    /**
     * PROGRAM:test-program
     * @short_description: A test program
     * @synopsis: test-program [*OPTIONS*...] --arg1 *arg* *FILE*
     * @see_also: test(1)
     * @--arg1 *arg*: set arg1 to *arg*
     * @--arg2 *arg*: set arg2 to *arg*
     * @-v, --version: Print the version number
     * @-h, --help: Print the help message
     *
     * Long description of program.
     *
     * Returns: Zero on success, non-zero on failure
     */
    int main(int argc, char *argv[])
    {
    	return 0;
    }
sv: 
    /**
     * PROGRAM:test-program
     * @short_description: Ett testprogram
     * @synopsis: test-program [*FLAGGOR*...] --arg1 *arg* *FIL*
     * @see_also: test(1)
     * @--arg1 *arg*: ställ in arg1 på *arg*
     * @--arg2 *arg*: ställ in arg2 på *arg*
     * @-v, --version: Skriv ut versionsinformation
     * @-h, --help: Skriv ut hjälpmeddelandet
     *
     * En längre beskrivning av programmet.
     *
     * Returns: Noll vid framgång, icke-noll vid fel
     */
    int main(int argc, char *argv[])
    {
    	return 0;
    }

note: (itstool) path: sect1/title
en: Useful DocBook tags
sv: Användbara DocBook-taggar

note: (itstool) path: sect1/para
en: Here are some DocBook tags which are most useful when documenting the code.
sv: Här är några DocBook-taggar som är användbara när man dokumenterar koden.

note: (itstool) path: informalexample/programlisting
en: 
    &lt;link linkend="glib-Hash-Tables"&gt;Hash Tables&lt;/link&gt;
sv: 
    &lt;link linkend="glib-Hash-Tables"&gt;Hashtabeller&lt;/link&gt;

note: (itstool) path: sect1/para
en: To link to another section in the GTK docs: <_:informalexample-1/> The linkend is the SGML/XML id on the top item of the page you want to link to. For most pages this is currently the part ("gtk", "gdk", "glib") and then the page title ("Hash Tables"). For widgets it is just the class name. Spaces and underscores are converted to '-' to conform to SGML/XML.
sv: För att länka till ett annat avsnitt i GTK-dokumentationen: <_:informalexample-1/> Länkslutet är XGML/XML-id:t för toppnivåobjektet på sidan du vill länka till. För de flesta sidorna är detta för närvarande delen (”gtk”, ”gdk”, ”glib”) och sedan sidans titel (”Hashtabeller”). För komponenter är detta helt enkelt klassnamnet. Blanksteg och understreck konverteras till ”-” för att överensstämma med SGML/XML.

note: (itstool) path: informalexample/programlisting
en: 
    &lt;function&gt;...&lt;/function&gt;
sv: 
    &lt;function&gt;…&lt;/function&gt;

note: (itstool) path: sect1/para
en: To refer to an external function, e.g. a standard C function: <_:informalexample-1/>
sv: För att referera till en extern funktion, t.ex. en standardfunktion i C: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;example&gt;
      &lt;title&gt;Using a GHashTable.&lt;/title&gt;
      &lt;programlisting language="C"&gt;
          ...
      &lt;/programlisting&gt;
    &lt;/example&gt;
sv: 
    &lt;example&gt;
      &lt;title&gt;Att använda en GHashTable.&lt;/title&gt;
      &lt;programlisting language="C"&gt;
          ...
      &lt;/programlisting&gt;
    &lt;/example&gt;

note: (itstool) path: sect1/para
en: To include example code: <_:informalexample-1/> or possibly this, for very short code fragments which don't need a title: <_:informalexample-2/> In both cases, the language attribute is optional and is used as a hint to the syntax highlighting engine (pygments for html output). For the latter GTK-Doc also supports an abbreviation: <_:informalexample-3/>
sv: För att inkludera exempelkod: <_:informalexample-1/> eller möjligen följande, för väldigt korta kodfragment som inte behöver en titel: <_:informalexample-2/> I båda fallen är språkattributet valfritt och används som ett tips för syntaxmarkeringsmotorn (pygments för html-utmatning). För det senare fallet har GTK-Doc också stöd för en förkortning: <_:informalexample-3/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;itemizedlist&gt;
      &lt;listitem&gt;
        &lt;para&gt;
          ...
        &lt;/para&gt;
      &lt;/listitem&gt;
      &lt;listitem&gt;
        &lt;para&gt;
          ...
        &lt;/para&gt;
      &lt;/listitem&gt;
    &lt;/itemizedlist&gt;
sv: 
    &lt;itemizedlist&gt;
      &lt;listitem&gt;
        &lt;para&gt;
          …
        &lt;/para&gt;
      &lt;/listitem&gt;
      &lt;listitem&gt;
        &lt;para&gt;
          …
        &lt;/para&gt;
      &lt;/listitem&gt;
    &lt;/itemizedlist&gt;

note: (itstool) path: sect1/para
en: To include bulleted lists: <_:informalexample-1/>
sv: För att inkludera punktlistor: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;note&gt;
      &lt;para&gt;
        Make sure you free the data after use.
      &lt;/para&gt;
    &lt;/note&gt;
sv: 
    &lt;note&gt;
      &lt;para&gt;
        Säkerställ att du frigjort data efter användning.
      &lt;/para&gt;
    &lt;/note&gt;

note: (itstool) path: sect1/para
en: To include a note which stands out from the text: <_:informalexample-1/>
sv: För att inkludera en not som skiljer sig från texten: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a type: <_:informalexample-1/>
sv: För att refera till en typ: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to an external structure (not one described in the GTK docs): <_:informalexample-1/>
sv: För att referera till en extern struktur (som inte beskrivs i GTK-dokumentationen): <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a field of a structure: <_:informalexample-1/>
sv: För att referera till ett fält för en struktur: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to a class name, we could possibly use: <_:informalexample-1/> but you'll probably be using #GtkWidget instead (to automatically create a link to the GtkWidget page - see <link linkend="documenting_syntax">the abbreviations</link>).
sv: För att referera till ett klassnamn kan vi möjligen använda: <_:informalexample-1/> men du kommer troligt att använda #GtkWidget istället (för att automatiskt skapa en länk till GtkWidget-sidan - se <link linkend="documenting_syntax">förkortningarna</link>).

note: (itstool) path: informalexample/programlisting
en: 
    &lt;emphasis&gt;This is important&lt;/emphasis&gt;
sv: 
    &lt;emphasis&gt;Detta är viktigt&lt;/emphasis&gt;

note: (itstool) path: sect1/para
en: To emphasize text: <_:informalexample-1/>
sv: För att betona text: <_:informalexample-1/>

note: (itstool) path: informalexample/programlisting
en: 
    &lt;filename&gt;/home/user/documents&lt;/filename&gt;
sv: 
    &lt;filename&gt;/home/användare/dokument&lt;/filename&gt;

note: (itstool) path: sect1/para
en: For filenames use: <_:informalexample-1/>
sv: För filnamn använd: <_:informalexample-1/>

note: (itstool) path: sect1/para
en: To refer to keys use: <_:informalexample-1/>
sv: För att referera till tangenter använd: <_:informalexample-1/>

note: (itstool) path: chapter/title
en: Filling the extra files
sv: Fylla i de extra filerna

note: (itstool) path: chapter/para
en: There are a couple of extra files, that need to be maintained along with the inline source code comments: <filename>&lt;package&gt;.types</filename>, <filename>&lt;package&gt;-docs.xml</filename> (in the past .sgml), <filename>&lt;package&gt;-sections.txt</filename>.
sv: Det finns ett antal extra filer som behöver underhållas tillsammans med de infogade källkodskommentarerna: <filename>&lt;paket&gt;.types</filename>, <filename>&lt;paket&gt;-docs.xml</filename> (tidigare .sgml), <filename>&lt;paket&gt;-sections.txt</filename>.

note: (itstool) path: sect1/title
en: Editing the types file
sv: Redigera typfilen

note: (itstool) path: sect1/para
en: If your library or application includes GObjects, you want their signals, arguments/parameters and position in the hierarchy to be shown in the documentation. All you need to do, is to list the <function>xxx_get_type</function> functions together with their include inside the <filename>&lt;package&gt;.types</filename> file.
sv: Om ditt bibliotek eller program inkluderar GObject så kommer du att vilja att deras signaler, argument/parametrar och position i hierarkin visas i dokumentationen. Allt du behöver göra är att lista <function>xxx_get_type</function>-funktionerna tillsammans med deras huvudfil i filen <filename>&lt;paket&gt;.types</filename>.

note: (itstool) path: example/title
en: Example &lt;package&gt;.types file
sv: Exempel på filen &lt;paket&gt;.types

note: (itstool) path: sect1/para
en: Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this list for you. Just add "--rebuild-types" to SCAN_OPTIONS in <filename>Makefile.am</filename>. If you use this approach you should not dist the types file nor have it under version control.
sv: Sedan GTK-Doc 1.8 kan <application>gtkdoc-scan</application> generera denna lista åt dig. Lägg bara till ”--rebuild-types” i SCAN_OPTIONS i <filename>Makefile.am</filename>. Om du använder detta tillvägagångssätt bör du inte distribuera typfilen eller versionshantera den.

note: (itstool) path: sect1/title
en: Editing the master document
sv: Redigera huvuddokumentet

note: (itstool) path: sect1/para
en: GTK-Doc produces documentation in DocBook SGML/XML. When processing the inline source comments, the GTK-Doc tools generate one documentation page per class or module as a separate file. The master document includes them and place them in an order.
sv: GTK-Doc producerar dokumentation i DocBook SGML/XML. När infogade källkodskommentarer behandlas genererar GTK-Doc en dokumentationssida per klass eller modul som en separat fil. Huvuddokumentet inkluderar dem och placerar dem i en ordning.

note: (itstool) path: sect1/para
en: While GTK-Doc creates a template master document for you, later runs will not touch it again. This means that one can freely structure the documentation. That includes grouping pages and adding extra pages. GTK-Doc has now a test suite, where also the master-document is recreated from scratch. Its a good idea to look at this from time to time to see if there are some new goodies introduced there.
sv: Även om GTK-Doc skapar en mall för huvuddokumentet åt dig kommer senare körningar inte att röra det igen. Detta innebär att man är fri att strukturera om dokumentationen. Detta inkluderar att gruppera sidor och lägga till extra sidor. GTK-Doc har numera en testsvit där också huvuddokumentet återskapas från grunden. Det är en bra idé att titta på detta då och då för att se om några nya godsaker införts där.

note: (itstool) path: tip/para
en: Do not create tutorials as extra documents. Just write extra chapters. The benefit of directly embedding the tutorial for your library into the API documentation is that it is easy to link for the tutorial to symbol documentation. Apart chances are higher that the tutorial gets updates along with the library.
sv: Skapa inte handledningar som extra dokument. Skriv bara extra kapitel. Fördelen med att bädda in handledningen direkt i ditt biblioteks gränssnittsdokumentation är att det är enkelt att länka från handledningen till symboldokumentationen. Inbäddad är det större chans att handledningen blir uppdaterad tillsammans med biblioteket.

note: (itstool) path: sect1/para
en: So what are the things to change inside the master document? For a start is only a little. There are some placeholders (text in square brackets) there which you should take care of.
sv: Så vilka saker ska ändras i huvuddokumentet? I början är det väldigt lite. Det finns en del platshållare (text i hakparenteser) som du bör ta hand om.

note: (itstool) path: example/title
en: Master document header
sv: Huvuddokumentets huvud

note: (itstool) path: example/programlisting
en: 
    &lt;bookinfo&gt;
      &lt;title&gt;MODULENAME Reference Manual&lt;/title&gt;
      &lt;releaseinfo&gt;
        for MODULENAME [VERSION]
        The latest version of this documentation can be found on-line at
        &lt;ulink role="online-location" url="http://[SERVER]/MODULENAME/index.html"&gt;http://[SERVER]/MODULENAME/&lt;/ulink&gt;.
      &lt;/releaseinfo&gt;
    &lt;/bookinfo&gt;
    
    &lt;chapter&gt;
      &lt;title&gt;[Insert title here]&lt;/title&gt;
sv: 
    &lt;bookinfo&gt;
      &lt;title&gt;MODULNAMN handbok&lt;/title&gt;
      &lt;releaseinfo&gt;
        för MODULNAMN [VERSION]
        Den senaste versionen av detta dokument kan hittas på nätet på
        &lt;ulink role="online-location" url="http://[SERVER]/MODULNAMN/index.html"&gt;http://[SERVER]/MODULNAMN/&lt;/ulink&gt;.
      &lt;/releaseinfo&gt;
    &lt;/bookinfo&gt;
    
    &lt;chapter&gt;
      &lt;title&gt;[Infoga titel här]&lt;/title&gt;

note: (itstool) path: sect1/para
en: In addition a few option elements are created in commented form. You can review these and enable them as you like.
sv: Dessutom finns det ett antal valfria element som skapas i kommenterad form. Du kan granska dessa och aktivera dem enligt dina egna önskemål.

note: (itstool) path: example/title
en: Optional part in the master document
sv: Valfri del i huvuddokumentet

note: (itstool) path: example/programlisting
en: 
      &lt;!-- enable this when you use gobject introspection annotations
      &lt;xi:include href="xml/annotation-glossary.xml"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;
      --&gt;
sv: 
      &lt;!-- aktivera detta om du vill använda gobject introspection-noteringar
      &lt;xi:include href="xml/annotation-glossary.xml"&gt;&lt;xi:fallback /&gt;&lt;/xi:include&gt;
      --&gt;

note: (itstool) path: sect1/para
en: Finally you need to add new section whenever you introduce one. The <link linkend="modernizing-gtk-doc-1-16">gtkdoc-check</link> tool will remind you of newly generated xml files that are not yet included into the doc.
sv: Slutligen behöver du lägga till ett nytt avsnitt när du infogar det. Verktyget <link linkend="modernizing-gtk-doc-1-16">gtkdoc-check</link> kommer att påminna dig om nyligen genererade xml-filer som ännu inte infogats i dokumentationen.

note: (itstool) path: example/title
en: Including generated sections
sv: Inkludera genererade avsnitt

note: (itstool) path: example/programlisting
en: 
      &lt;chapter&gt;
        &lt;title&gt;my library&lt;/title&gt;
          &lt;xi:include href="xml/object.xml"/&gt;
          ...
sv: 
      &lt;chapter&gt;
        &lt;title&gt;mitt bibliotek&lt;/title&gt;
          &lt;xi:include href="xml/object.xml"/&gt;
          ...

note: (itstool) path: sect1/title
en: Editing the section file
sv: Redigera avsnittsfilen

note: (itstool) path: sect1/para
en: The section file is used to organise the documentation output by GTK-Doc. Here one specifies which symbol belongs to which module or class and control the visibility (public or private).
sv: Avsnittsfilen används för att organisera dokumentationsutdata från GTK-Doc. Här kan man ange vilken symbol som hör till vilken modul eller klass och styra synligheten (publik eller privat).

note: (itstool) path: sect1/para
en: The section file is a plain text file with tags delimiting sections. Blank lines are ignored and lines starting with a '#' are treated as comment lines.
sv: Avsnittsfilen är en vanlig textfil med taggar som avgränsar avsnitt. Blankrader ignoreras och rader som börjar med ett ”#” behandlas som kommentarsrader.

note: (itstool) path: note/para
en: While the tags make the file look like xml, it is not. Please do not close tags like &lt;SUBSECTION&gt;.
sv: Även om taggarna får filen att se ut som xml, är det inte det. Avsluta inte taggar så som &lt;SUBSECTION&gt;.

note: (itstool) path: sect1/para
en: The &lt;FILE&gt; ... &lt;/FILE&gt; tag is used to specify the file name, without any suffix. For example, using '&lt;FILE&gt;gnome-config&lt;/FILE&gt;' will result in the section declarations being output in the template file <filename>tmpl/gnome-config.sgml</filename>, which will be converted into the DocBook XML file <filename>xml/gnome-config.sgml</filename> or the DocBook XML file <filename>xml/gnome-config.xml</filename>. (The name of the HTML file is based on the module name and the section title, or for GObjects it is based on the GObjects class name converted to lower case).
sv: Taggen &lt;FILE&gt; … &lt;/FILE&gt; används för att ange filnamnet, utan något suffix. Om man t.ex. använder ”&lt;FILE&gt;gnome-config&lt;/FILE&gt;” blir resultatet att avsnittsdeklarationerna matas ut i mallfilen <filename>tmpl/gnome-config.sgml</filename>, som kommer att konverteras till DocBook XML-filen <filename>xml/gnome-config.sgml</filename> eller DocBook XML-filen <filename>xml/gnome-config.xml</filename>. (Namnet på HTML-filen baseras på modulnamnet och avsnittstiteln, för GObject baseras det på klassnamnet för GObjectet konverterat till gemener).

note: (itstool) path: sect1/para
en: The &lt;TITLE&gt; ... &lt;/TITLE&gt; tag is used to specify the title of the section. It is only useful before the templates (if used) are initially created, since the title set in the template file overrides this. Also if one uses SECTION comment in the sources, this is obsolete.
sv: Taggen &lt;TITLE&gt; … &lt;/TITLE&gt; används för att ange titeln på avsnittet. Det är bara användbart före mallar skapas initialt (om de används), eftersom titeln som ställs in i avsnittsfilen åsidosätter denna. Vidare är detta föråldrat om man använder SECTIONS-kommentarer i källkoden.

note: (itstool) path: sect1/para
en: You can group items in the section by using the &lt;SUBSECTION&gt; tag. Currently it outputs a blank line between subsections in the synopsis section. You can also use &lt;SUBSECTION Standard&gt; for standard GObject declarations (e.g. the functions like g_object_get_type and macros like G_OBJECT(), G_IS_OBJECT() etc.). Currently these are left out of the documentation. You can also use &lt;SUBSECTION Private&gt; for private declarations which will not be output (it is a handy way to avoid warning messages about unused declarations). If your library contains private types which you don't want to appear in the object hierarchy and the list of implemented or required interfaces, add them to a Private subsection. Whether you would place GObject and GObjectClass like structs in public or Standard section depends if they have public entries (variables, vmethods).
sv: Du kan gruppera objekt i avsnittet genom att använda taggen &lt;SUBSECTION&gt;. För närvarande matas en blankrad ut mellan underavsnitt i sammanfattningsavsnittet. Du kan också använda &lt;SUBSECTION Standard&gt; för standard GObject-deklarationer (t.ex. funktioner så som g_object_get_type och makron som G_OBJECT(), G_IS_OBJECT(), etc.). För närvarande utelämnas dessa ur dokumentationen. Du kan också använda &lt;SUBSECTION Private&gt; för privata deklarationer som inte kommer att matas ut (det är ett bekvämt sätt att undvika varningsmeddelanden om oanvända deklarationer). Om ditt bibliotek innehåller privata typer som du inte vill ska dyka upp i objekthierarkin och i listan över implementerade eller krävda gränssnitt, lägg till dem i ett privat avsnitt. Huruvida du vill placera GObject och GObjectClass-liknande strukturer i publika eller standardavsnitt beror på om de har publika poster (variabler, virtuella metoder).

note: (itstool) path: sect1/para
en: You can also use &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; to specify the #include files which are shown in the synopsis sections. It contains a comma-separate list of #include files, without the angle brackets. If you set it outside of any sections, it acts for all sections until the end of the file. If you set it within a section, it only applies to that section.
sv: Du kan också använda &lt;INCLUDE&gt; ... &lt;/INCLUDE&gt; för att ange #include-filerna som ska visas i sammanfattningsavsnitten. Den innehåller en kommaavgränsad lista av #include-filer, utan vinkelparenteser. Om du ställer in det utanför några avsnitt kommer det att påverka alla avsnitt tills slutet på filen. Om du ställer in det inom ett avsnitt kommer det bara att påverka det avsnittet.

note: (itstool) path: chapter/title
en: Controlling the result
sv: Kontrollera resultatet

note: (itstool) path: chapter/para
en: A GTK-Doc run generates report files inside the documentation directory. The generated files are named: <filename>&lt;package&gt;-undocumented.txt</filename>, <filename>&lt;package&gt;-undeclared.txt</filename> and <filename>&lt;package&gt;-unused.txt</filename>. All those are plain text files that can be viewed and postprocessed easily.
sv: En GTK-Doc-körning genererar rapportfiler inuti dokumentationskatalogen. De genererade filerna heter: <filename>&lt;paket&gt;-undocumented.txt</filename>, <filename>&lt;paket&gt;-undeclared.txt</filename> och <filename>&lt;paket&gt;-unused.txt</filename>. Alla är vanliga textfiler och kan visas eller efterbehandlas enkelt.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undocumented.txt</filename> file starts with the documentation coverage summary. Below are two sections divided by blank lines. The first section lists undocumented or incomplete symbols. The second section does the same for section docs. Incomplete entries are those, which have documentation, but where e.g. a new parameter has been added.
sv: Filen <filename>&lt;paket&gt;-undocumented.txt</filename> inleds med en sammanfattning över hur mycket dokumentation som skrivits. Under det finns två avsnitt avgränsade av blankrader. Det första avsnittet listar odokumenterade eller ofullständiga symboler. Det andra avsnittet gör detsamma för avsnittsdokumentation. Ofullständiga poster är de som har dokumentation, men där en ny parameter har lagts till.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-undeclared.txt</filename> file lists symbols given in the <filename>&lt;package&gt;-sections.txt</filename> but not found in the sources. Check if they have been removed or if they are misspelled.
sv: Filen <filename>&lt;paket&gt;-undeclared.txt</filename> listar symboler som anges i <filename>&lt;paket&gt;-sections.txt</filename> men inte hittas i källkoden. Kontrollera om de har tagits bort eller om de är felstavade.

note: (itstool) path: chapter/para
en: The <filename>&lt;package&gt;-unused.txt</filename> file lists symbol names, where the GTK-Doc scanner has found documentation, but does not know where to put it. This means that the symbol has not yet been added to the <filename>&lt;package&gt;-sections.txt</filename> file.
sv: Filen <filename>&lt;paket&gt;-unused.txt</filename> listar symbolnamn där GTK-Doc-detektorn har hittat dokumentation men inte vet var den ska placeras. Detta innebär att symbolen ännu inte har lagts till i filen <filename>&lt;package&gt;-sections.txt</filename>.

note: (itstool) path: tip/para
en: Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile.am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during <command>make check</command> run.
sv: Aktivera eller lägg till raden <option>TESTS=$(GTKDOC_CHECK)</option> i Makefile.am. Om åtminstone GTK-Doc 1.9 finns installerat kommer detta att köra rimlighetskontroller under körning av <command>make check</command>.

note: (itstool) path: chapter/para
en: One can also look at the files produced by the source code scanner: <filename>&lt;package&gt;-decl-list.txt</filename> and <filename>&lt;package&gt;-decl.txt</filename>. The first one can be compared with the section file if that is manually maintained. The second lists all declarations from the headers. If a symbol is missing one could check if this file contains it.
sv: Man kan också titta på filerna som producerats av källkodsdetektorn: <filename>&lt;paket&gt;-decl-list.txt</filename> och <filename>&lt;paket&gt;-decl.txt</filename>. Den första kan jämföras med avsnittsfilen om den underhålls manuellt. Den andra listar alla deklarationer från huvudena. Om en symbol saknas bör man kontrollera om denna filen innehåller den.

note: (itstool) path: chapter/para
en: If the project is GObject based, one can also look into the files produced by the object scanner: <filename>&lt;package&gt;.args.txt</filename>, <filename>&lt;package&gt;.hierarchy.txt</filename>, <filename>&lt;package&gt;.interfaces.txt</filename>, <filename>&lt;package&gt;.prerequisites.txt</filename> and <filename>&lt;package&gt;.signals.txt</filename>. If there are missing symbols in any of those, one can ask GTK-Doc to keep the intermediate scanner file for further analysis, by running it as <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>.
sv: Om projektet är GObject-baserat kan man också titta på filerna som producerats av objekt-detektorn: <filename>&lt;paket&gt;.args.txt</filename>, <filename>&lt;paket&gt;.hierarchy.txt</filename>, <filename>&lt;paket&gt;.interfaces.txt</filename>, <filename>&lt;paket&gt;.prerequisites.txt</filename> och <filename>&lt;paket&gt;.signals.txt</filename>. Om det saknas symboler i någon av dem kan man be GTK-Doc att bibehålla de temporära detektorfilerna för vidare analys, genom att köra det som <command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>.

note: (itstool) path: chapter/title
en: Modernizing the documentation
sv: Modernisera dokumentationen

note: (itstool) path: chapter/para
en: GTK-Doc has been around for quite some time. In this section we list new features together with the version since when it is available.
sv: GTK-Doc har funnits ett tag. I detta avsnitt listar vi nya funktioner tillsammans med vilken version de gjordes tillgängliga.

note: (itstool) path: sect1/para
en: When using xml instead of sgml, one can actually name the master document <filename>&lt;package&gt;-docs.xml</filename>.
sv: När man använder xml istället för sgml, kan man faktiskt kalla huvuddokumentet <filename>&lt;paket&gt;-docs.xml</filename>.

note: (itstool) path: sect1/para
en: This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in <filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;package&gt;-sections.txt</filename> is autogenerated and can be removed from the vcs. This only works nicely for projects that have a very regular structure (e.g. each .{c,h} pair will create new section). If one organize a project close to that updating a manually maintained section file can be as simple as running <code>meld &lt;package&gt;-decl-list.txt &lt;package&gt;-sections.txt</code>.
sv: Denna version har stöd för <option>SCAN_OPTIONS=--rebuild-sections</option> i <filename>Makefile.am</filename>. När detta är aktiverat kommer <filename>&lt;paket&gt;-sections.txt</filename> att autogenereras och kan tas bort från versionshanteringssystemet. Detta fungerar bra för projekt som har en väldigt standardiserad struktur (t.ex. kommer varje .{c,h}-par att skapa ett nytt avsnitt). Om man organiserar ett projekt likt detta kommer den manuella uppdateringen av en avsnittsfil att vara så enkelt som att köra <code>meld &lt;paket&gt;-decl-list.txt &lt;paket&gt;-sections.txt</code>.

note: (itstool) path: sect1/para
en: Version 1.8 already introduced the syntax for documenting sections in the sources instead of the separate files under <filename class="directory">tmpl</filename>. This version adds options to switch the whole doc module to not use the extra tmpl build step at all, by using <option>--flavour no-tmpl</option> in <filename>configure.ac</filename>. If you don't have a <filename class="directory">tmpl</filename> checked into your source control system and haven't yet switched, just add the flag to <filename>configure.ac</filename> and you are done.
sv: Redan version 1.8 introducerade syntaxen för avsnittsdokumentation i källkoden istället för separata filer under <filename class="directory">tmpl</filename>. Denna version lägger till flaggor för att kunna ställa om hela dokumentationsmodulen till att inte använda det extra tmpl-byggsteget alls, genom att använda <option>--flavour no-tmpl</option> i <filename>configure.ac</filename>. Om du inte har <filename class="directory">tmpl</filename> incheckat i ditt versionshanteringssystem just nu och inte har gått över än bara lägg till flaggan i <filename>configure.ac</filename> så är du klar.

note: (itstool) path: sect1/para
en: This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in <filename>Makefile.am</filename>. When this is enabled, the <filename>&lt;package&gt;.types</filename> is autogenerated and can be removed from the vcs. When using this feature it is important to also setup the <varname>IGNORE_HFILES</varname> in <filename>Makefile.am</filename> for code that is build conditionally.
sv: Denna version har stöd för <option>SCAN_OPTIONS=--rebuild-types</option> i <filename>Makefile.am</filename>. När det är aktiverat kommer <filename>&lt;package&gt;.types</filename> att autogenereras och kan tas bort från versionshanteringssystemet. När denna funktion används är det viktigt att också ställa in <varname>IGNORE_HFILES</varname> i <filename>Makefile.am</filename> för kod som bara byggs ibland.

note: (itstool) path: example/title
en: Enable gtkdoc-check
sv: Aktivera gtkdoc-check

note: (itstool) path: sect1/para
en: This version includes a new tool called gtkdoc-check. This tool can run a set of sanity checks on your documentation. It is enabled by adding these lines to the end of <filename>Makefile.am</filename>. <_:example-1/>
sv: Denna version har stöd för ett nytt verktyg som heter gtkdoc-check. Detta verktyg kan köra en uppsättning kontroller på din dokumentation. Det aktiveras genom att lägga till dessa raderna i slutet av <filename>Makefile.am</filename>. <_:example-1/>

note: (itstool) path: sect1/para
en: Version 1.18 brought some initial markdown support. Using markdown in doc comments is less intrusive than writing docbook xml. This version improves a lot on this and add a lot more styles. The section that explains the <link linkend="documenting_syntax">comment syntax</link> has all the details.
sv: Version 1.18 införde inledande stöd för markdown. Att använda markdown i dokumentationskommentarer är mindre påträngande än att skriva docbook xml. Denna version förbättrar detta väsentligt och lägger till många fler stilar. Avsnittet som beskriver <link linkend="documenting_syntax">kommentarsyntax</link> finnas alla detaljer.

note: (itstool) path: example/title
en: Use pre-generated entities
sv: Att använda förgenererade entiteter

note: (itstool) path: example/programlisting
en: 
    &lt;?xml version="1.0"?&gt;
    &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
    [
      &lt;!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'"&gt;
      &lt;!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent"&gt;
      %gtkdocentities;
    ]&gt;
    &lt;book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"&gt;
      &lt;bookinfo&gt;
        &lt;title&gt;&amp;package_name; Reference Manual&lt;/title&gt;
        &lt;releaseinfo&gt;
          for &amp;package_string;.
          The latest version of this documentation can be found on-line at
          &lt;ulink role="online-location" url="http://[SERVER]/&amp;package_name;/index.html"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.
        &lt;/releaseinfo&gt;
      &lt;/bookinfo&gt;
sv: 
    &lt;?xml version="1.0"?&gt;
    &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
    [
      &lt;!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'"&gt;
      &lt;!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent"&gt;
      %gtkdocentities;
    ]&gt;
    &lt;book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"&gt;
      &lt;bookinfo&gt;
        &lt;title&gt;&amp;package_name; handbok&lt;/title&gt;
        &lt;releaseinfo&gt;
          för &amp;package_string;.
          Den senaste versionen av detta dokument kan hittas på nätet på
          &lt;ulink role="online-location" url="http://[SERVER]/&amp;package_name;/index.html"&gt;http://[SERVER]/&amp;package_name;/&lt;/ulink&gt;.
        &lt;/releaseinfo&gt;
      &lt;/bookinfo&gt;

note: (itstool) path: sect1/para
en: The makefiles shipped with this version generate an entity file at <filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. package_name and package_version. You can use this e.g. in the main xml file to avoid hardcoding the version number. Below is an example that shows how the entity file is included in the master template and how the entities are used. The entities can also be used in all generated files, GTK-Doc will use the same xml header in generated xml files. <_:example-1/>
sv: Makefilerna som skeppas med denna version genererar en entitetsfil vid namn <filename>xml/gtkdocentities.ent</filename> som innehåller entiteter för t.ex. package_name och package_version. Du kan använda detta för att t.ex. i filen main xml undvika att hårdkoda versionsnumret. Nedan finns ett exempel som visar hur entitetsfilen inkluderas i huvudmallen och hur entiteterna används. Entiteterna kan också användas i alla genererade filer, GTK-Doc kommer att använda samma xml-huvud i genererade xml-filer. <_:example-1/>

note: (itstool) path: chapter/title
en: Documenting other interfaces
sv: Dokumentera andra gränssnitt

note: (itstool) path: chapter/para
en: So far we have been using GTK-Doc to document the API of code. The next sections contain suggestions how the tools can be used to document other interfaces too.
sv: Så här långt har vi använt GTK-Doc för att dokumentera API:t för koden. Följande avsnitt innehåller förslag om hur verktyget kan användas för att också dokumentera andra gränssnitt.

note: (itstool) path: sect1/title
en: Command line options and man pages
sv: Kommandoradsflaggor och mansidor

note: (itstool) path: sect1/para
en: As one can generate man pages for a docbook refentry as well, it sounds like a good idea to use it for that purpose. This way the interface is part of the reference and one gets the man-page for free.
sv: Då man också kan generera mansidor för ett docbook-refentry, låter det som en bra idé att använda det för detta ändamål. På detta sättet kommer gränssnittet att vara en del av referensen och man får mansidan gratis.

note: (itstool) path: sect2/title
en: Document the tool
sv: Dokumentera verktyget

note: (itstool) path: sect2/para
en: Create one refentry file per tool. Following <link linkend="settingup_docfiles">our example</link> we would call it <filename>meep/docs/reference/meeper/meep.xml</filename>. For the xml tags that should be used and can look at generated file in the xml subdirectory as well as examples e.g. in glib.
sv: Skapa en refentry-fil per verktyg. Om du följer <link linkend="settingup_docfiles">vårt exempel</link> borde vi kalla det <filename>meep/docs/reference/meeper/meep.xml</filename>. För xml-taggarna bör detta användas och man kan studera den genererade filen i xml-underkatalogen så väl som exempel i glib.

note: (itstool) path: sect2/title
en: Adding the extra configure check
sv: Lägga till den extra configure-kontrollen

note: (itstool) path: example/title
en: Extra configure checks
sv: Lägga till extra configure-kontroller

note: (itstool) path: example/programlisting
en: 
    AC_ARG_ENABLE(man,
                  [AC_HELP_STRING([--enable-man],
                                  [regenerate man pages from Docbook [default=no]])],enable_man=yes,
                  enable_man=no)
    
    AC_PATH_PROG([XSLTPROC], [xsltproc])
    AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)
sv: 
    AC_ARG_ENABLE(man,
                  [AC_HELP_STRING([--enable-man],
                                  [omgenerera mansidor från Docbook [standardvärde=no]])],enable_man=yes,
                  enable_man=no)
    
    AC_PATH_PROG([XSLTPROC], [xsltproc])
    AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)

note: (itstool) path: sect2/title
en: Adding the extra makefile rules
sv: Lägga till de extra makefilsreglerna

note: (itstool) path: sect1/title
en: DBus interfaces
sv: DBus-gränssnitt

note: (itstool) path: chapter/title
en: Frequently asked questions
sv: Frågor och svar

note: (itstool) path: segmentedlist/segtitle
en: Question
sv: Fråga

note: (itstool) path: segmentedlist/segtitle
en: Answer
sv: Svar

note: (itstool) path: seglistitem/seg
en: No class hierarchy.
sv: Ingen klasshierarki.

note: (itstool) path: seglistitem/seg
en: The objects <function>xxx_get_type()</function> function has not been entered into the <filename>&lt;package&gt;.types</filename> file.
sv: Objektens <function>xxx_get_type()</function>-funktion har inte matats in i filen <filename>&lt;paket&gt;.types</filename>.

note: (itstool) path: seglistitem/seg
en: Still no class hierarchy.
sv: Fortfarande ingen klasshierarki.

note: (itstool) path: seglistitem/seg
en: Missing or wrong naming in <filename>&lt;package&gt;-sections.txt</filename> file (see <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">explanation</ulink>).
sv: Saknat eller fel namn i filen <filename>&lt;paket&gt;-sections.txt</filename> (se <ulink url="http://mail.gnome.org/archives/gtk-doc-list/2003-October/msg00006.html">förklaring</ulink>).

note: (itstool) path: seglistitem/seg
en: Damn, I have still no class hierarchy.
sv: Förbannat, jag har fortfarande ingen klasshierarki.

note: (itstool) path: seglistitem/seg
en: Is the object name (name of the instance struct, e.g. <type>GtkWidget</type>) part of the normal section (don't put this into Standard or Private subsections).
sv: Är objektnamnet (namnet på instansstrukturen, t.ex. <type>GtkWidget</type>) del av det normala avsnittet (stoppa inte detta i underavsnitt så som Standard eller Private).

note: (itstool) path: seglistitem/seg
en: No symbol index.
sv: Inget symbolindex.

note: (itstool) path: seglistitem/seg
en: Does the <filename>&lt;package&gt;-docs.{xml,sgml}</filename> contain a index that xi:includes the generated index?
sv: Innehåller <filename>&lt;paket&gt;-docs.{xml,sgml}</filename> ett index som inkluderar det genererade indexet med xi:include?

note: (itstool) path: seglistitem/seg
en: Symbols are not linked to their doc-section.
sv: Symboler är inte länkade till deras dokumentationsavsnitt.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment using the correct markup (added #,% or ())? Check if the gtkdoc-fixxref warns about unresolvable xrefs.
sv: Använder dokumentationskommentaren korrekta taggar (har du lagt till #, % eller ())? Kontrollera om gtkdoc-fixxref varnar om oupplösbara korsreferenser.

note: (itstool) path: seglistitem/seg
en: A new class does not appear in the docs.
sv: En ny klass dyker inte upp i dokumentationen.

note: (itstool) path: seglistitem/seg
en: Is the new page xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
sv: Är den nya sidan inkluderad med xi:include från <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.

note: (itstool) path: seglistitem/seg
en: A new symbol does not appear in the docs.
sv: En ny symbol dyker inte upp i dokumentationen.

note: (itstool) path: seglistitem/seg
en: Is the doc-comment properly formatted. Check for spelling mistakes in the begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable xrefs. Check if the symbol is correctly listed in the <filename>&lt;package&gt;-sections.txt</filename> in a public subsection.
sv: Är dokumentationskommentaren korrekt formaterad. Leta efter stavfel i början av kommentaren. Kontrollera om gtkdoc-fixxref varnar om oupplösbara korsreferenser. Kontrollera om symbolen finns korrekt listad i <filename>&lt;paket&gt;-sections.txt</filename> i ett publikt avsnitt.

note: (itstool) path: seglistitem/seg
en: A type is missing from the class hierarchy.
sv: En typ saknas från klasshierarkin.

note: (itstool) path: seglistitem/seg
en: If the type is listed in <filename>&lt;package&gt;.hierarchy</filename> but not in <filename>xml/tree_index.sgml</filename> then double check that the type is correctly placed in the <filename>&lt;package&gt;-sections.txt</filename>. If the type instance (e.g. <type>GtkWidget</type>) is not listed or incidentally marked private it will not be shown.
sv: Om typen finns listad i <filename>&lt;paket&gt;.hierarchy</filename> men inte i <filename>xml/tree_index.sgml</filename>, dubbelkolla då att typen finns korrekt placerad i <filename>&lt;paket&gt;-sections.txt</filename>. Om typinstansen (t.ex. <type>GtkWidget</type>) inte visas eller är markerad privat kommer den inte att visas.

note: (itstool) path: seglistitem/seg
en: I get foldoc links for all gobject annotations.
sv: Jag får foldoc-länkar för alla gobject-noteringar.

note: (itstool) path: seglistitem/seg
en: Check that <filename>xml/annotation-glossary.xml</filename> is xi:included from <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.
sv: Kontrollera att <filename>xml/annotation-glossary.xml</filename> är inkluderad med xi:include från <filename>&lt;package&gt;-docs.{xml,sgml}</filename>.

note: (itstool) path: seglistitem/seg
en: Parameter described in source code comment block but does not exist
sv: Parameter beskriven i kommentarsblock i källkoden men existerar inte

note: (itstool) path: seglistitem/seg
en: Check if the prototype in the header has different parameter names as in the source.
sv: Kontrollera om prototypen i huvudet har andra parameternamn än i källkoden.

note: (itstool) path: seglistitem/seg
en: multiple "IDs" for constraint linkend: XYZ
sv: multipla ”ID:n” för begränsat länkslut: XYZ

note: (itstool) path: seglistitem/seg
en: Symbol XYZ appears twice in <filename>&lt;package&gt;-sections.txt</filename> file.
sv: Symbolen XYZ förekommer två gånger i filen <filename>&lt;paket&gt;-sections.txt</filename>.

note: (itstool) path: seglistitem/seg
en: Element typename in namespace '' encountered in para, but no template matches.
sv: Elementtypnamn i namnrymd ”” påträffat i para, men ingen mall matchar.

note: (itstool) path: chapter/title
en: Tools related to gtk-doc
sv: Verktyg relaterade till gtk-doc

note: (itstool) path: chapter/para
en: GtkDocPlugin - a <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and integrates with the trac search.
sv: GtkDocPlugin - en insticksmodul för <ulink url="http://trac-hacks.org/wiki/GtkDocPlugin">Trac GTK-Doc</ulink>-integrering som lägger till API-dokumentation till en trac-webbplats och integrerar med trac-sökningen.

note: (itstool) path: chapter/para
en: Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since tags in the API to determine the minimum required version.
sv: Gtkdoc-depscan - ett verktyg (del av gtk-doc) för att kontrollera använda API mot since-taggar i API:t för att avgöra minsta version som krävs.

note: (itstool) path: appendixinfo/releaseinfo
en: Version 1.1, March 2000
sv: Version 1.1, mars 2000

note: (itstool) path: legalnotice/para
en: <_:address-1/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
sv: <_:address-1/>. Alla är tillåtna kopiera och distribuera ordagranna kopior av detta licensdokument, men att ändra det är ej tillåtet.

note: (itstool) path: sect1/title
en: 0. PREAMBLE
sv: 0. BAKGRUND

note: (itstool) path: para/quote
en: free
sv: fritt

note: (itstool) path: sect1/para
en: The purpose of this License is to make a manual, textbook, or other written document <_:quote-1/> in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
sv: Syftet med denna licens är att göra en handbok, bok, eller annat praktiskt och användbart dokument <_:quote-1/> som i frihet: att försäkra var och en den faktiska friheten att kopiera och sprida det vidare, med eller utan förändringar, antingen kommersiellt eller ideellt. Sekundärt bevarar denna licens ett sätt för författaren och förläggaren att få ära för deras arbete utan att de anses vara ansvariga för förändringar gjorda av andra.

note: (itstool) path: sect1/para
en: This License is a kind of <_:quote-1/>, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
sv: Denna Licens är en sorts <_:quote-1/>, vilket betyder att derivativa verk av detta dokument själva måste vara fria på samma sätt. Den kompletterar GNU General Public License, som är en copyleft-licens utformad för fri programvara.

note: (itstool) path: sect1/para
en: We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
sv: Vi har utformat denna licens för att den skall användas för handböcker till fri programvara, eftersom fri programvara behöver fri dokumentation: ett fritt program bör ha en handbok som erbjuder samma friheter som programmet gör. Men denna licens är inte begränsad till programvaruhandböcker; den kan användas för vilket textverk som helst oavsett ämne eller huruvida det är en utgiven, tryckt bok. Vi rekommenderar denna licens huvudsakligen för alla verk vars syfte är instruktion eller referens.

note: (itstool) path: sect1/title
en: 1. APPLICABILITY AND DEFINITIONS
sv: 1. TILLÄMPNINGSOMRÅDE OCH DEFINITIONER

note: (itstool) path: para/quote (itstool) path: para/link
en: Document
sv: Dokument

note: (itstool) path: para/quote
en: you
sv: du

note: (itstool) path: sect1/para
en: This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The <_:quote-1/>, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as <_:quote-2/>.
sv: Denna licens [det engelska originalet] gäller för varje handbok eller annat verk, oavsett uttrycksform, som innehåller ett meddelande där upphovsrättsinnehavaren stadgat att verket kan spridas enligt villkoren i GNU Free Documentation License. Ett sådant meddelande ger en internationell frihet utan krav på ersättning och utan tidsbegränsning att använda verket under villkoren i denna licens [det engelska originalet]. <_:quote-1/> nedan syftar på godtycklig handbok eller verk. Var och en är licenstagare och benämns som <_:quote-2/>.

note: (itstool) path: para/quote (itstool) path: para/link
en: Modified Version
sv: förändrad version

note: (itstool) path: sect1/para
en: A <_:quote-1/> of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
sv: En <_:quote-1/> av dokumentet avser varje verk som innehåller dokumentet eller en del av det, antingen ordagranna kopior, eller med ändringar och/eller översatt till ett annat språk.

note: (itstool) path: para/quote
en: Secondary Section
sv: sekundärt avsnitt

note: (itstool) path: sect1/para
en: A <_:quote-1/> is a named appendix or a front-matter section of the <_:link-2/> that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
sv: Ett <_:quote-1/> är en märkt bilaga eller förord till <link linkend="fdl-document">dokumentet</link> som exklusivt behandlar förhållandet mellan dokumentets förläggare eller författare och dokumentets huvudsakliga ämne (eller till relaterade ämnen) och som inte innehåller något som direkt faller under det huvudsakliga ämnet. (Således, om dokumentet delvis är en lärobok i matematik så får ett sekundärt avsnitt inte förklara någon matematik.) Förhållandet kan vara en historisk koppling till ämnet eller något relaterat, eller en juridisk, kommersiell, filosofisk, etisk eller politisk ställning till det.

note: (itstool) path: para/quote (itstool) path: para/link
en: Invariant Sections
sv: oföränderliga avsnitten

note: (itstool) path: para/link
en: Secondary Sections
sv: sekundära avsnitt

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain <_:link-2/> whose titles are designated, as being those of Invariant Sections, in the notice that says that the <_:link-3/> is released under this License.
sv: De <_:quote-1/> är <_:link-2/> vars titlar är angivna som oföränderliga avsnitt i meddelandet som stadgar att <_:link-3/> är utgivet under denna licens [det engelska originalet].

note: (itstool) path: para/quote (itstool) path: para/link
en: Cover Texts
sv: Omslagstexterna

note: (itstool) path: sect1/para
en: The <_:quote-1/> are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the <_:link-2/> is released under this License.
sv: <_:quote-1/> är speciella korta ordföljder som är listade som framsidestexter eller baksidestexter i meddelandet som stadgar att <_:link-2/> är utgivet under denna licens [det engelska originalet].

note: (itstool) path: para/quote (itstool) path: para/link
en: Transparent
sv: transparent

note: (itstool) path: para/quote (itstool) path: para/link
en: Opaque
sv: opak

note: (itstool) path: sect1/para
en: A <_:quote-1/> copy of the <_:link-2/> means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not <_:quote-3/> is called <_:quote-4/>.
sv: En <_:quote-1/> kopia av <_:link-2/> är en maskinläsbar kopia, representerad i ett format vars specifikation finns tillgänglig för allmänheten, som lämpar sig för att revidera dokumentet på ett enkelt sätt med generella textredigeringsprogram eller (för pixelbaserade bilder) generella grafikprogram eller (för ritningar) något väl tillgängligt ritprogram, och som är passande som indata till textformaterare eller för automatisk konvertering till en mängd format som passar som indata till textformaterare. En kopia i ett för övrigt transparent filformat vars markeringar, eller avsaknad av markeringar, har ordnats för att hindra eller motverka att vidare förändring vidtas av läsare är inte transparent. En kopia som inte är <_:quote-3/> kallas <_:quote-4/>.

note: (itstool) path: sect1/para
en: Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only.
sv: Exempel på passande format för transparenta kopior innefattar ren ASCII utan markeringar, Texinfo indataformat, LaTeX indataformat, SGML eller XML som använder en publikt tillgänglig DTD, och standardenlig HTML, PostScript eller PDF utformat för mänsklig förändring. Opaka format innefattar Postscript, PDF, leverantörsspecifika format som bara kan läsas och editeras med leverantörsspecifika ordbehandlare, SGML eller XML för vilket DTD och/eller verktyg för behandling inte finns allmänt tillgängliga, och den maskingenererade HTML som produceras av vissa ordbehandlare enbart avsett som utdata.

note: (itstool) path: para/quote (itstool) path: para/link
en: Title Page
sv: Titelsidan

note: (itstool) path: sect1/para
en: The <_:quote-1/> means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, <_:quote-2/> means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
sv: <_:quote-1/> innebär, för en tryckt bok, titelsidan själv, och sådana därpå följande sidor som krävs för att göra det material som enligt denna licens skall synas på titelsidan läsbart. För verk i sådana format som inte har någon egentlig titelsida, avses med <_:quote-2/> den text som är närmast den mest framstående förekomsten av verkets titel, föregående den huvudsakliga textmassan.

note: (itstool) path: sect1/title
en: 2. VERBATIM COPYING
sv: 2. ORDAGRANN KOPIERING

note: (itstool) path: para/link
en: section 3
sv: paragraf 3

note: (itstool) path: sect1/para
en: You may copy and distribute the <_:link-1/> in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in <_:link-2/>.
sv: Du äger kopiera och sprida <_:link-1/> på valfritt medium, antingen kommersiellt eller ideellt, förutsatt att denna licens [det engelska originalet], upphovsrättsklausul, och meddelandet som stadgar att GNU Free Documentation License gäller för dokumentet finns med på alla kopior, och att du inte lägger till några som helst andra villkor än de som ingår i denna licens. Du äger inte vidta tekniska åtgärder för att begränsa eller kontrollera läsande eller vidare kopiering av de kopior du skapar eller sprider. Dock äger du ta emot kompensation i utbyte mot kopior. Om du sprider tillräckligt många kopior måste du också följa villkoren i <_:link-2/>.

note: (itstool) path: sect1/para
en: You may also lend copies, under the same conditions stated above, and you may publicly display copies.
sv: Du äger också låna ut kopior, under samma villkor som ovan, och du äger visa kopior offentligt.

note: (itstool) path: sect1/title
en: 3. COPYING IN QUANTITY
sv: 3. OMFATTANDE KOPIERING

note: (itstool) path: sect1/para
en: If you publish printed copies of the <_:link-1/> numbering more than 100, and the Document's license notice requires <_:link-2/>, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the <_:link-3/> and satisfy these conditions, can be treated as verbatim copying in other respects.
sv: Om du publicerar tryckta kopior (eller kopior i medier som normalt har tryckta omslag) av <_:link-1/>, i en upplaga överstigande 100 exemplar, och dokumentets licensmeddelande kräver <_:link-2/>, så måste du förse kopiorna med omslag som, klart och tydligt, visar alla omslagstexter: framsidestexter på framsidan och baksidestexter på baksidan. Båda omslagen måste klart och tydligt identifiera dig som utgivare av dessa kopior. Framsidan måste presentera dokumentets hela titel, med alla ord i titeln lika framträdande och synliga. Du äger lägga till ytterligare stoff på omslagen. Kopiering med förändringar gjorda bara på omslaget, så länge som de bevarar titeln för <_:link-3/> och i övrigt uppfyller dessa krav kan anses vara ordagrann kopiering i andra avseenden.

note: (itstool) path: sect1/para
en: If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
sv: Om de obligatoriska texterna för något omslag är för omfattande för att rymmas i läsbart skick skall du placera de första (så många som får plats) på det egentliga omslaget, och fortsätta med resten på de direkt intilliggande sidorna.

note: (itstool) path: sect1/para
en: If you publish or distribute <_:link-1/> copies of the <_:link-2/> numbering more than 100, you must either include a machine-readable <_:link-3/> copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
sv: Om du publicerar <_:link-1/>a kopior av <_:link-2/> i upplagor om mer än 100, måste du antingen bifoga en maskinläsbar <_:link-3/> kopia med varje opak kopia, eller ange i eller med varje opak kopia en nätverksadress som är tillgänglig för den allmänna nätverksanvändande massan där man, med öppet standardiserade protokoll, anonymt och utan kostnad kan ladda ner en komplett transparent kopia av dokumentet, utan extra material. Om du väljer det senare alternativet, måste du vidta skäliga åtgärder, när du börjar sprida opaka kopior i kvantitet, för att denna transparenta kopia skall förbli tillgänglig på angivna platsen till åtminstone ett år efter den sista gången du spred en opak kopia (direkt eller via ombud eller återförsäljare) av den utgåvan till allmänheten.

note: (itstool) path: sect1/para
en: It is requested, but not required, that you contact the authors of the <_:link-1/> well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
sv: Det är önskvärt, men inte ett krav, att du kontaktar författarna till <_:link-1/> i god tid innan du sprider något större antal kopior, för att ge dem en chans att förse dig med en uppdaterad version av dokumentet.

note: (itstool) path: sect1/title
en: 4. MODIFICATIONS
sv: 4. FÖRÄNDRINGAR

note: (itstool) path: sect1/para
en: You may copy and distribute a <_:link-1/> of the <_:link-2/> under the conditions of sections <_:link-3/> and <_:link-4/> above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
sv: Du äger kopiera och sprida en <_:link-1/> av <_:link-2/> under de villkor som beskrivs i paragraf <_:link-3/> och <_:link-4/> av GNU Free Documentation License, förutsatt att du släpper den förändrade versionen under exakt denna licens, och att den förändrade versionen antar dokumentets roll, och således medger spridning och förändring av den förändrade versionen till envar som erhåller en kopia av den. Utöver detta måste du göra följande med den ändrade versionen:

note: (itstool) path: formalpara/para
en: Use in the <_:link-1/> (and on the covers, if any) a title distinct from that of the <_:link-2/>, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
sv: På <_:link-1/> (och omslagen om det finns några) använda en titel skild från den som [original]<_:link-2/> har, och skild från tidigare versioners titel (som skall, om det finns några, finnas listade i historikavsnittet i dokumentet). Du äger använda samma titel som det föregående dokumentet om den ursprungliga utgivaren ger sitt tillstånd.

note: (itstool) path: formalpara/para
en: List on the <_:link-1/>, as authors, one or more persons or entities responsible for authorship of the modifications in the <_:link-2/>, together with at least five of the principal authors of the <_:link-3/> (all of its principal authors, if it has less than five).
sv: Lista på <_:link-1/>, som författare, en eller flera personer eller juridiska personer som ansvarat för förändringarna i <_:link-2/>, tillsammans med minst fem av de huvudsakliga författarna av <_:link-3/> (alla dess huvudsakliga författare, om det har mindre än fem).

note: (itstool) path: formalpara/para
en: State on the <_:link-1/> the name of the publisher of the <_:link-2/>, as the publisher.
sv: Ange namnet på utgivaren av <_:link-1/>, som utgivare, på <_:link-2/>.

note: (itstool) path: formalpara/para
en: Preserve all the copyright notices of the <_:link-1/>.
sv: Bibehålla alla upphovsrättsklausuler för <_:link-1/>.

note: (itstool) path: formalpara/para
en: Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
sv: Lägga till en upphovsrättsklausul för dina förändringar angränsande till de andra upphovsrättsklausulerna.

note: (itstool) path: formalpara/para
en: Include, immediately after the copyright notices, a license notice giving the public permission to use the <_:link-1/> under the terms of this License, in the form shown in the Addendum below.
sv: Direkt efter upphovsrättsklausulerna innefatta ett meddelande som ger allmänheten tillstånd att använda <_:link-1/> under villkoren i denna licens [det engelska originalet] i den form som visas i Tillägg nedan.

note: (itstool) path: para/link
en: Document's
sv: dokumentets

note: (itstool) path: formalpara/para
en: Preserve in that license notice the full lists of <_:link-1/> and required <_:link-2/> given in the <_:link-3/> license notice.
sv: I meddelandet om licensen bevara den fullständiga listan över <_:link-1/> och obligatoriska <_:link-2/> som finns i <_:link-3/> meddelande om licensen.

note: (itstool) path: formalpara/para
en: Include an unaltered copy of this License.
sv: Inkludera en oförändrad kopia av denna licens [Det är den engelska originalversionen som avses].

note: (itstool) path: para/quote
en: History
sv: historik

note: (itstool) path: formalpara/para
en: Preserve the section entitled <_:quote-1/>, and its title, and add to it an item stating at least the title, year, new authors, and publisher of the <_:link-2/> as given on the <_:link-3/>. If there is no section entitled <_:quote-4/> in the <_:link-5/>, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
sv: Bevara avsnittet med titeln <_:quote-1/> (History), bevara dess titel och lägg i avsnittet till en post med åtminstone titeln, året, nya författare och utgivaren av <_:link-2/> så som angivet på <_:link-3/>. Om det inte finns något avsnitt med titeln <_:quote-4/> (History) i <_:link-5/> så skapa en med titeln, året, författare och utgivaren av dokumentet så som det står på [original]dokumentets titelsida. Lägg sedan till en post som beskriver den förändrade versionen så som beskrivits ovan.

note: (itstool) path: formalpara/para
en: Preserve the network location, if any, given in the <_:link-1/> for public access to a <_:link-2/> copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the <_:quote-3/> section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
sv: Bevara den nätverksadress, om det finns någon, angiven i <_:link-1/> till den allmänt tillgängliga <_:link-2/>a kopian av dokumentet, och likaså nätverksadresserna till de föregående versioner som dokumentet baseras på. Dessa får placeras i avsnittet <_:quote-3/> (History). Du äger utelämna en nätverksadress för ett verk som är publicerat mer än fyra år före dokumentet självt, eller om den ursprunglige utgivaren vars verk nätverksadressen hänvisar till ger sitt tillstånd.

note: (itstool) path: para/quote
en: Acknowledgements
sv: tillkännagivanden

note: (itstool) path: para/quote
en: Dedications
sv: dedikationer

note: (itstool) path: formalpara/para
en: In any section entitled <_:quote-1/> or <_:quote-2/>, preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
sv: För alla avsnitt med titlarna <_:quote-1/> (Acknowledgements) eller <_:quote-2/> (Dedications), bevara titeln på avsnittet, och bevara allt innehåll och prägel på alla tillkännagivanden och/eller dedikationer gjorda av varje bidragsgivare.

note: (itstool) path: formalpara/para
en: Preserve all the <_:link-1/> of the <_:link-2/>, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
sv: Bevara alla <_:link-1/> i <_:link-2/> oförändrade till text och titel. Avsnittsnummer eller motsvarande anses inte tillhöra avsnittets titel.

note: (itstool) path: para/quote
en: Endorsements
sv: endossering

note: (itstool) path: formalpara/para
en: Delete any section entitled <_:quote-1/>. Such a section may not be included in the <_:link-2/>.
sv: Radera varje avsnitt med titeln <_:quote-1/> (Endorsements). Ett sådant avsnitt får inte inkluderas i en <_:link-2/>.

note: (itstool) path: para/link
en: Invariant Section
sv: oföränderligt avsnitt

note: (itstool) path: formalpara/para
en: Do not retitle any existing section as <_:quote-1/> or to conflict in title with any <_:link-2/>.
sv: Inte byta titel på något existerande avsnitt så att det blir <_:quote-1/> (Endorsements) eller så att titeln kan förväxlas med något <_:link-2/>.

note: (itstool) path: sect1/para
en: If the <_:link-1/> includes new front-matter sections or appendices that qualify as <_:link-2/> and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of <_:link-3/> in the Modified Version's license notice. These titles must be distinct from any other section titles.
sv: Om <_:link-1/> innehåller nya framsidestexter eller bilagor som är att anses som <_:link-2/> och inte innehåller något material kopierat från dokumentet, så äger du, om du vill, benämna några eller samtliga av dessa som oföränderliga. För att göra detta, lägg deras titlar till listan över <_:link-3/> i den förändrade versionens licensmeddelande. Dessa titlar måste vara skilda från alla andra avsnitts titlar.

note: (itstool) path: sect1/para
en: You may add a section entitled <_:quote-1/>, provided it contains nothing but endorsements of your <_:link-2/> by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
sv: Du äger lägga till ett avsnitt med titeln <_:quote-1/> (Endorsements), förutsatt att det inte innehåller något annat än endosseringar för din <_:link-2/> från olika aktörer -- till exempel, meddelanden om utförd korrekturläsning eller att texten har godkänts av en organisation som en officiell definition av en standard.

note: (itstool) path: para/link
en: Front-Cover Text
sv: framsidestext

note: (itstool) path: para/link
en: Back-Cover Text
sv: baksidestext

note: (itstool) path: sect1/para
en: You may add a passage of up to five words as a <_:link-1/>, and a passage of up to 25 words as a <_:link-2/>, to the end of the list of <_:link-3/> in the <_:link-4/>. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the <_:link-5/> already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
sv: Du äger lägga till ett textavsnitt på upp till fem ord som <_:link-1/>, och ett textavsnitt på upp till 25 ord som <_:link-2/> i listan över <_:link-3/> i <_:link-4/>. Bara ett textavsnitt med framsidestexter och ett med baksidestexter får läggas till av (eller genom försorg av) en enda juridisk person. Om <_:link-5/> redan innehåller en omslagstext för något av omslagen, tidigare tillagd av dig eller genom försorg av samma juridiska person som du företräder, äger du inte lägga till en till, men du äger ändra den gamla med tillstånd från den tidigare utgivaren som lade till den förra.

note: (itstool) path: sect1/para
en: The author(s) and publisher(s) of the <_:link-1/> do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any <_:link-2/>.
sv: Författaren (författarna) och utgivaren (utgivarna) av <_:link-1/> ger inte via denna licens sitt tillstånd att använda sina namn för publicitet eller för att lägga till eller antyda endossering av någon <_:link-2/>.

note: (itstool) path: sect1/title
en: 5. COMBINING DOCUMENTS
sv: 5. KOMBINERA DOKUMENT

note: (itstool) path: para/link
en: section 4
sv: paragraf 4

note: (itstool) path: sect1/para
en: You may combine the <_:link-1/> with other documents released under this License, under the terms defined in <_:link-2/> above for modified versions, provided that you include in the combination all of the <_:link-3/> of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
sv: Du äger kombinera <_:link-1/> med andra dokument som är utgivna under denna licens, under de villkor som definieras i <_:link-2/> av GNU Free Documentation License för förändrade versioner, förutsatt att du, i det kombinerade dokumentet, innefattar alla <_:link-3/> från originaldokumenten, omodifierade, och listar dem som oföränderliga avsnitt i ditt kombinerade verk i dess licensklausul, och att du bevarar alla deras garantiavsägelseklausuler.

note: (itstool) path: sect1/para
en: The combined work need only contain one copy of this License, and multiple identical <_:link-1/> may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
sv: Det kombinerade verket behöver bara innehålla en enstaka kopia av denna licens [engelska originalversionen], och flera identiska <_:link-1/> kan ersättas med en kopia. Om det finns flera oföränderliga stycken med samma namn men olika innehåll, se till att titeln på varje sådant avsnitt är unik genom att i slutet på den, inom parentes, lägga till namnet på den ursprunglige författaren eller utgivaren av det avsnittet om dessa är kända, annars ett unikt nummer. Gör samma justeringar av titlarna i listan över oföränderliga avsnitt i licensklausulen i det kombinerade verket.

note: (itstool) path: para/quote
en: Endorsements.
sv: endossering

note: (itstool) path: sect1/para
en: In the combination, you must combine any sections entitled <_:quote-1/> in the various original documents, forming one section entitled <_:quote-2/>; likewise combine any sections entitled <_:quote-3/>, and any sections entitled <_:quote-4/>. You must delete all sections entitled <_:quote-5/>
sv: I det kombinerade verket måste du kombinera alla avsnitt med titlarna <_:quote-1/> (History) i de ursprungliga dokumenten, till ett avsnitt med titeln <_:quote-2/> (History); på samma sätt skall alla avsnitt med titlarna <_:quote-3/> (Acknowledgements), alla avsnitt med titlarna <_:quote-4/> (Dedications) kombineras. Du måste ta bort alla avsnitt med titlarna <_:quote-5/> (Endorsements).

note: (itstool) path: sect1/title
en: 6. COLLECTIONS OF DOCUMENTS
sv: 6. SAMLINGAR AV DOKUMENT

note: (itstool) path: sect1/para
en: You may make a collection consisting of the <_:link-1/> and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
sv: Du äger skapa en samling bestående av <_:link-1/> och andra dokument som är släppta under GNU Free Documentation License, och ersätta individuella kopior i dokumenten av denna licens med en enda kopia [av den engelska originalversionen] som inkluderas i samlingen, förutsatt att du följer villkoren för ordagrann kopiering i denna licens för varje inkluderat dokument i alla andra avseenden.

note: (itstool) path: sect1/para
en: You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
sv: Du äger lyfta ut ett dokument från en sådan samling, och sprida det enskilt under GNU Free Documentation License, förutsatt att du lägger till en kopia av denna licens [den engelska originalversionen] i det utlyfta dokumentet, och följer villkoren för ordagrann kopiering i denna licens för det utlyfta dokumentet i alla andra avseenden.

note: (itstool) path: sect1/title
en: 7. AGGREGATION WITH INDEPENDENT WORKS
sv: 7. SAMMANSLAGNING MED OBEROENDE VERK

note: (itstool) path: para/quote
en: aggregate
sv: sammanslagning

note: (itstool) path: para/link
en: Cover Text
sv: Omslagstext

note: (itstool) path: sect1/para
en: A compilation of the <_:link-1/> or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a <_:link-2/> of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an <_:quote-3/>, and this License does not apply to the other self-contained works thus compiled with the Document , on account of their being thus compiled, if they are not themselves derivative works of the Document. If the <_:link-4/> requirement of <_:link-5/> is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
sv: En samling av <_:link-1/> eller av dess derivat med andra separata och oberoende dokument eller verk, på eller i en lagringsvolym eller ett spridningsmedium, kallas för en <quote>sammanslagning</quote> om den sammanslagna upphovsrätten inte används för att begränsa samlingens användares rättigheter som de enskilda dokumenten medger. När dokumentet ingår i en sådan sammanslagning, gäller inte denna licens de andra verken i samlingen som inte själva är deriverat av dokumentet. Om kravet på <link linkend="fdl-cover-texts">omslagstexter</link> enligt <link linkend="fdl-section3">paragraf 3</link> är tillämpligt på dessa kopior av dokumentet, så kan dokumentets omslagstexter, om dokumentet utgör mindre än en fjärdedel av hela samlingen, placeras på det omslag som omger dokumentet inuti samlingen, eller den elektroniska motsvarigheten till omslag om dokumentet är i elektronisk form. Annars måste de synas på det omslag som omger hela samlingen.

note: (itstool) path: sect1/title
en: 8. TRANSLATION
sv: 8. ÖVERSÄTTNING

note: (itstool) path: sect1/para
en: Translation is considered a kind of modification, so you may distribute translations of the <_:link-1/> under the terms of <_:link-2/>. Replacing <_:link-3/> with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
sv: Översättning anses vara en sorts förändring, så du äger sprida översättningar av <_:link-1/> enligt de villkor som sätts i <_:link-2/>. <_:link-3/> som ersätts med översättningar kräver tillstånd från deras upphovsrättsinnehavare, men du äger inkludera översättningar av alla eller vissa av dessa oföränderliga avsnitt tillsammans med originalversionerna av dessa oföränderliga avsnitt. Du äger inkludera en översättning av denna licens, och alla licensklausuler i dokumentet, och alla garantiavsägelser, förutsatt att du också innefattar den engelska originalversionen av denna licens och originalversionerna av dessa klausuler. Skulle det finnas skillnader mellan översättningen och originalversionen av denna licens eller någon klausul så gäller originalversionen.

note: (itstool) path: sect1/title
en: 9. TERMINATION
sv: 9. UPPHÖRANDE

note: (itstool) path: sect1/para
en: You may not copy, modify, sublicense, or distribute the <_:link-1/> except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
sv: Du äger inte kopiera, förändra, omlicensiera eller sprida <_:link-1/> annat än enligt villkoren i GNU Free Documentation License. Alla övriga försök att kopiera, modifiera, omlicensiera, eller sprida dokumentet är ogiltiga och kommer automatiskt medföra att du förlorar dina rättigheter enligt denna licens. Tredje man som har mottagit kopior eller rättigheter från dig enligt dessa licensvillkor kommer dock inte att förlora sina rättigheter så länge de följer licensvillkoren.

note: (itstool) path: sect1/title
en: 10. FUTURE REVISIONS OF THIS LICENSE
sv: 10. FRAMTIDA VERSIONER AV DENNA LICENS

note: (itstool) path: sect1/para
en: The <_:ulink-1/> may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See <_:ulink-2/>.
sv: <_:ulink-1/> kan publicera nya, reviderade versioner av GNU Free Documentation License då och då. Sådana nya versioner kommer att vara likadana i andemening som den nuvarande versionen, men kan skilja i detalj för att behandla nya problem eller angelägenheter. Se <_:ulink-2/>.

note: (itstool) path: para/quote
en: or any later version
sv: eller valfri senare version

note: (itstool) path: sect1/para
en: Each version of the License is given a distinguishing version number. If the <_:link-1/> specifies that a particular numbered version of this License <_:quote-2/> applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
sv: Varje version av licensen ges ett unikt versionsnummer. Om <_:link-1/> stadgar att en specifik numrerad version av denna licens <_:quote-2/> gäller för det, så äger du rätten att följa villkoren enligt antingen den angivna versionen eller vilken senare version som helst som publicerats (inte som utkast) av Free Software Foundation. Om dokumentet inte anger en version av denna licens, äger du välja vilken version som helst som publicerats (inte som utkast) av Free Software Foundation.

note: (itstool) path: sect1/title
en: Addendum
sv: TILLÄGG

note: (itstool) path: sect1/para
en: To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
sv: För att använda GNU Free Documentation License för ett dokument du har skrivit, inkludera en kopia av licensen [det engelska originalet] i dokumentet och placera följande copyrightklausul omedelbart efter titelsidan:

note: (itstool) path: blockquote/para
en: Copyright YEAR YOUR NAME.
sv: Copyright © YEAR YOUR NAME.

note: (itstool) path: sect1/para
en: If you have no <_:link-1/>, write <_:quote-2/> instead of saying which ones are invariant. If you have no <_:link-3/>, write <_:quote-4/> instead of <_:quote-5/>; likewise for <_:link-6/>.
sv: Om du inte har några <_:link-1/>, skriv <_:quote-2/> istället för att ange vilka som är oföränderliga. Om du inte har några <_:link-3/>, skriv <_:quote-4/> istället för <_:quote-5/>; såväl som för <_:link-6/>.

note: (itstool) path: sect1/para
en: If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the <_:ulink-1/>, to permit their use in free software.
sv: Om ditt dokument innehåller icke-triviala exempel med programkod, så rekommenderar vi att du släpper dessa exempel parallellt under en, av dig vald, fri programvarulicens, som till exempel <_:ulink-1/>, för att möjliggöra deras användning i fri programvara.
