RubyGems - glib2 - Versions diffs - 1.1.8-x86-mingw32 → 1.1.9-x86-mingw32 - Mend

glib2 1.1.8-x86-mingw32 → 1.1.9-x86-mingw32

Files changed (1810) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html CHANGED

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Key-value file parser</title>
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
 <link rel="home" href="index.html" title="GLib Reference Manual">
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Simple-XML-Subset-Parser.html" title="Simple XML Subset Parser">
 <link rel="next" href="glib-Bookmark-file-parser.html" title="Bookmark file parser">
-<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -31,7 +31,7 @@
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
 <h2><span class="refentrytitle"><a name="glib-Key-value-file-parser.top_of_page"></a>Key-value file parser</span></h2>
-<p>Key-value file parser — parses <code class="filename">.ini</code>-like config files</p>
+<p>Key-value file parser — parses .ini-like config files</p>
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
@@ -47,6 +47,8 @@ enum                <a class="link" href="glib-Key-value-file-parser.html#GKeyFi
 <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          <a class="link" href="glib-Key-value-file-parser.html#g-key-file-new" title="g_key_file_new ()">g_key_file_new</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-free" title="g_key_file_free ()">g_key_file_free</a>                     (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
+<a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          <a class="link" href="glib-Key-value-file-parser.html#g-key-file-ref" title="g_key_file_ref ()">g_key_file_ref</a>                      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-unref" title="g_key_file_unref ()">g_key_file_unref</a>                    (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-list-separator" title="g_key_file_set_list_separator ()">g_key_file_set_list_separator</a>       (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> separator</code></em>);
 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-file" title="g_key_file_load_from_file ()">g_key_file_load_from_file</a>           (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
@@ -269,6 +271,8 @@ The syntax of key files is described in detail in the
 Entry Specification</a>, here is a quick summary: Key files
 consists of groups of key-value pairs, interspersed with comments.
 </p>
+<p>
+</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -285,25 +289,39 @@ consists of groups of key-value pairs, interspersed with comments.
 10
 11
 12
-13</pre></td>
+13
+14
+15
+16
+17
+18
+19</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="preproc"># this</span><span class="normal"> is just an example</span>
 <span class="preproc"># there</span><span class="normal"> can be comments before the first group</span>
 <span class="symbol">[</span><span class="usertype">First</span><span class="normal"> Group</span><span class="symbol">]</span>
 <span class="normal">Name</span><span class="symbol">=</span><span class="normal">Key </span><span class="usertype">File</span><span class="normal"> Example</span><span class="symbol">\</span><span class="normal">tthis </span><span class="usertype">value</span><span class="normal"> shows</span><span class="symbol">\</span><span class="normal">nescaping</span>
 <span class="preproc"># localized</span><span class="normal"> strings are stored in </span><span class="usertype">multiple</span><span class="normal"> key</span><span class="symbol">-</span><span class="normal">value pairs</span>
 <span class="normal">Welcome</span><span class="symbol">=</span><span class="normal">Hello</span>
 <span class="normal">Welcome</span><span class="symbol">[</span><span class="normal">de</span><span class="symbol">]=</span><span class="normal">Hallo</span>
 <span class="normal">Welcome</span><span class="symbol">[</span><span class="normal">fr_FR</span><span class="symbol">]=</span><span class="normal">Bonjour</span>
 <span class="normal">Welcome</span><span class="symbol">[</span><span class="normal">it</span><span class="symbol">]=</span><span class="normal">Ciao</span>
 <span class="normal">Welcome</span><span class="symbol">[</span><span class="normal">be@latin</span><span class="symbol">]=</span><span class="normal">Hello</span>
 <span class="symbol">[</span><span class="usertype">Another</span><span class="normal"> Group</span><span class="symbol">]</span>
 <span class="normal">Numbers</span><span class="symbol">=</span><span class="number">2</span><span class="symbol">;</span><span class="number">20</span><span class="symbol">;-</span><span class="number">200</span><span class="symbol">;</span><span class="number">0</span>
 <span class="normal">Booleans</span><span class="symbol">=</span><span class="normal">true</span><span class="symbol">;</span><span class="normal">false</span><span class="symbol">;</span><span class="normal">true</span><span class="symbol">;</span><span class="normal">true</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
+<p>
+</p>
 <p>
 Lines beginning with a '#' and blank lines are considered comments.
 </p>
@@ -315,12 +333,13 @@ the end of the file. Each key-value pair must be contained in a group.
 <p>
 Key-value pairs generally have the form <code class="literal">key=value</code>,
 with the exception of localized strings, which have the form
-<code class="literal">key[locale]=value</code>, with a locale identifier of the form
-<code class="literal">lang_COUNTRY<em class="parameter"><code>MODIFIER</code></em></code> where <code class="literal">COUNTRY</code> and
-<code class="literal">MODIFIER</code> are optional. Space before and after the
-'=' character are ignored. Newline, tab, carriage return and backslash
-characters in value are escaped as \n, \t, \r, and \\, respectively.
-To preserve leading spaces in values, these can also be escaped as \s.
+<code class="literal">key[locale]=value</code>, with a locale identifier of the
+form <code class="literal">lang_COUNTRY<em class="parameter"><code>MODIFIER</code></em></code> where
+<code class="literal">COUNTRY</code> and <code class="literal">MODIFIER</code> are optional.
+Space before and after the '=' character are ignored. Newline, tab,
+carriage return and backslash characters in value are escaped as \n,
+\t, \r, and \\, respectively. To preserve leading spaces in values,
+these can also be escaped as \s.
 </p>
 <p>
 Key files can store strings (possibly with localized variants), integers,
@@ -329,29 +348,22 @@ typically ';' or ','. To use the list separator character in a value in
 a list, it has to be escaped by prefixing it with a backslash.
 </p>
 <p>
-This syntax is obviously inspired by the <code class="filename">.ini</code>
-files commonly met on Windows, but there are some important differences:
-</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
-<li class="listitem"><p>
-<code class="filename">.ini</code> files use the ';' character to begin comments,
- key files use the '#' character.
-</p></li>
-<li class="listitem"><p>
-Key files do not allow for ungrouped keys meaning only comments can precede the first group.
-</p></li>
-<li class="listitem"><p>
-Key files are always encoded in UTF-8.
-</p></li>
-<li class="listitem"><p>
-Key and Group names are case-sensitive, for example a group called
-<code class="literal">[GROUP]</code> is a different group from <code class="literal">[group]</code>.
-</p></li>
-<li class="listitem"><p>
-<code class="filename">.ini</code> files don't have a strongly typed boolean entry type, they only
-have <code class="literal">GetProfileInt</code>. In <span class="structname">GKeyFile</span> only
-<code class="literal">true</code> and <code class="literal">false</code> (in lower case) are allowed.
-</p></li>
+This syntax is obviously inspired by the .ini files commonly met
+on Windows, but there are some important differences:
+</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem">.ini files use the ';' character to begin comments,
+    key files use the '#' character.</li>
+<li class="listitem">Key files do not allow for ungrouped keys meaning only
+    comments can precede the first group.</li>
+<li class="listitem">Key files are always encoded in UTF-8.</li>
+<li class="listitem">Key and Group names are case-sensitive. For example, a
+    group called <code class="literal">[GROUP]</code> is a different from
+    <code class="literal">[group]</code>.</li>
+<li class="listitem">.ini files don't have a strongly typed boolean entry type,
+    they only have <code class="function">GetProfileInt()</code>. In key files, only
+    <code class="literal">true</code> and <code class="literal">false</code> (in lower case)
+    are allowed.</li>
 </ul></div>
 <p>
 </p>
@@ -371,8 +383,8 @@ restricted to ASCII characters.
 <a name="GKeyFile"></a><h3>GKeyFile</h3>
 <pre class="programlisting">typedef struct _GKeyFile GKeyFile;</pre>
 <p>
-The <span class="structname">GKeyFile</span> struct contains only private fields
-and should not be used directly.
+The GKeyFile struct contains only private data
+and should not be accessed directly.
 </p>
 </div>
 <hr>
@@ -382,15 +394,16 @@ and should not be used directly.
 </pre>
 <p>
 Error domain for key file parsing. Errors in this domain will
-be from the <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a> enumeration. See <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> for information on
-error domains.
+be from the <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a> enumeration.
+</p>
+<p>
+See <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> for information on error domains.
 </p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="GKeyFileError"></a><h3>enum GKeyFileError</h3>
-<pre class="programlisting">typedef enum
-{
+<pre class="programlisting">typedef enum {
   G_KEY_FILE_ERROR_UNKNOWN_ENCODING,
   G_KEY_FILE_ERROR_PARSE,
   G_KEY_FILE_ERROR_NOT_FOUND,
@@ -402,12 +415,16 @@ error domains.
 <p>
 Error codes returned by key file parsing.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><a name="G-KEY-FILE-ERROR-UNKNOWN-ENCODING:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_ERROR_UNKNOWN_ENCODING</code></span></p></td>
-<td>the text being parsed was in an unknown encoding
+<td>the text being parsed was in
+    an unknown encoding
 </td>
 </tr>
 <tr>
@@ -441,8 +458,7 @@ Error codes returned by key file parsing.
 <hr>
 <div class="refsect2">
 <a name="GKeyFileFlags"></a><h3>enum GKeyFileFlags</h3>
-<pre class="programlisting">typedef enum
-{
+<pre class="programlisting">typedef enum {
   G_KEY_FILE_NONE              = 0,
   G_KEY_FILE_KEEP_COMMENTS     = 1 &lt;&lt; 0,
   G_KEY_FILE_KEEP_TRANSLATIONS = 1 &lt;&lt; 1
@@ -451,8 +467,11 @@ Error codes returned by key file parsing.
 <p>
 Flags which influence the parsing.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><a name="G-KEY-FILE-NONE:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_NONE</code></span></p></td>
@@ -461,16 +480,18 @@ Flags which influence the parsing.
 </tr>
 <tr>
 <td><p><a name="G-KEY-FILE-KEEP-COMMENTS:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_KEEP_COMMENTS</code></span></p></td>
-<td>Use this flag if you plan to write the (possibly modified)
-  contents of the key file back to a file; otherwise all comments will be lost when
-  the key file is written back.
+<td>Use this flag if you plan to write the
+    (possibly modified) contents of the key file back to a file;
+    otherwise all comments will be lost when the key file is
+    written back.
 </td>
 </tr>
 <tr>
 <td><p><a name="G-KEY-FILE-KEEP-TRANSLATIONS:CAPS"></a><span class="term"><code class="literal">G_KEY_FILE_KEEP_TRANSLATIONS</code></span></p></td>
-<td>Use this flag if you plan to write the (possibly modified)
-  contents of the key file back to a file; otherwise only the translations for the current
-  language will be written back.
+<td>Use this flag if you plan to write the
+    (possibly modified) contents of the key file back to a file;
+    otherwise only the translations for the current language will be
+    written back.
 </td>
 </tr>
 </tbody>
@@ -486,11 +507,15 @@ Creates a new empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFi
 <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-dirs" title="g_key_file_load_from_dirs ()"><code class="function">g_key_file_load_from_dirs()</code></a> or <a class="link" href="glib-Key-value-file-parser.html#g-key-file-load-from-data-dirs" title="g_key_file_load_from_data_dirs ()"><code class="function">g_key_file_load_from_data_dirs()</code></a> to
 read an existing key file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody><tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>.</td>
+<td>an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.6</p>
@@ -500,10 +525,15 @@ read an existing key file.
 <a name="g-key-file-free"></a><h3>g_key_file_free ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_free                     (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
 <p>
-Frees a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>.
+Clears all keys and groups from <em class="parameter"><code>key_file</code></em>, and decreases the
+reference count by 1. If the reference count reaches zero,
+frees the key file and all its allocated memory.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody><tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 <td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
@@ -514,6 +544,53 @@ Frees a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="G
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-key-file-ref"></a><h3>g_key_file_ref ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="returnvalue">GKeyFile</span></a> *          g_key_file_ref                      (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
+<p>
+Increases the reference count of <em class="parameter"><code>key_file</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the same <em class="parameter"><code>key_file</code></em>.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.32</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-key-file-unref"></a><h3>g_key_file_unref ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_unref                    (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>);</pre>
+<p>
+Decreases the reference count of <em class="parameter"><code>key_file</code></em> by 1. If the reference count
+reaches zero, frees the key file and all its allocated memory.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
+<td>a <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.32</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-key-file-set-list-separator"></a><h3>g_key_file_set_list_separator ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                g_key_file_set_list_separator       (<em class="parameter"><code><a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> *key_file</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> separator</code></em>);</pre>
@@ -522,8 +599,11 @@ Sets the character which is used to separate
 values in lists. Typically ';' or ',' are used
 as separators. The default list separator is ';'.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -547,11 +627,14 @@ as separators. The default list separator is ';'.
                                                          <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>
 Loads a key file into an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> structure.
-If the file could not be loaded then <code class="literal">error</code> is set to
+If the file could not be loaded then <em class="parameter"><code>error</code></em> is set to
 either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -559,7 +642,8 @@ either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
-<td>the path of a filename to load, in the GLib filename encoding</td>
+<td>the path of a filename to load, in the GLib filename encoding. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
@@ -592,8 +676,11 @@ either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum
 Loads a key file from memory into an empty <a class="link" href="glib-Key-value-file-parser.html#GKeyFile" title="GKeyFile"><span class="type">GKeyFile</span></a> structure.
 If the object cannot be created then <code class="literal">error</code> is set to a <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -605,7 +692,7 @@ If the object cannot be created then <code class="literal">error</code> is set t
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>the length of <em class="parameter"><code>data</code></em> in bytes</td>
+<td>the length of <em class="parameter"><code>data</code></em> in bytes (or -1 if data is nul-terminated)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
@@ -641,8 +728,11 @@ loads the file into <em class="parameter"><code>key_file</code></em> and returns
 <em class="parameter"><code>full_path</code></em>.  If the file could not be loaded then an <code class="literal">error</code> is
 set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -650,12 +740,13 @@ set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
-<td>a relative path to a filename to open and parse</td>
+<td>a relative path to a filename to open and parse. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
 <td>return location for a string containing the full path
-of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -693,8 +784,11 @@ returns the file's full path in <em class="parameter"><code>full_path</code></em
 be loaded then an <code class="literal">error</code> is set to either a <a class="link" href="glib-File-Utilities.html#GFileError" title="enum GFileError"><span class="type">GFileError</span></a> or
 <a class="link" href="glib-Key-value-file-parser.html#GKeyFileError" title="enum GKeyFileError"><span class="type">GKeyFileError</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -702,17 +796,19 @@ be loaded then an <code class="literal">error</code> is set to either a <a class
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
-<td>a relative path to a filename to open and parse</td>
+<td>a relative path to a filename to open and parse. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>search_dirs</code></em> :</span></p></td>
 <td>
-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of directories to search</td>
+<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of directories to search. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
 <td>return location for a string containing the full path
-of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+of the file, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -747,8 +843,11 @@ This function outputs <em class="parameter"><code>key_file</code></em> as a stri
 Note that this function never reports an error,
 so it is safe to pass <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> as <em class="parameter"><code>error</code></em>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -758,7 +857,7 @@ so it is safe to pass <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 <td>return location for the length of the
-returned string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+returned string, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -783,8 +882,11 @@ the contents of the <a class="link" href="glib-Key-value-file-parser.html#GKeyFi
 <p>
 Returns the name of the start group of the file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -809,8 +911,11 @@ Returns all groups in the key file loaded with <em class="parameter"><code>key_f
 The array of returned groups will be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated, so
 <em class="parameter"><code>length</code></em> may optionally be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -819,13 +924,14 @@ The array of returned groups will be <a class="link" href="glib-Standard-Macros.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>return location for the number of returned groups, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>return location for the number of returned groups, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 <td>a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
-Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it.</td>
+Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -845,8 +951,11 @@ optionally be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="
 be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em> is set to
 <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -859,7 +968,7 @@ be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>return location for the number of keys returned, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>return location for the number of keys returned, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -870,7 +979,8 @@ be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 <td>a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
-Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it.</td>
+Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -884,8 +994,11 @@ Use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="
 <p>
 Looks whether the key file has the group <em class="parameter"><code>group_name</code></em>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -917,8 +1030,24 @@ otherwise.</td>
 Looks whether the key file has the key <em class="parameter"><code>key</code></em> in the group
 <em class="parameter"><code>group_name</code></em>.
 </p>
-<div class="variablelist"><table border="0">
+<p>
+</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>This function does not follow the rules for <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> strictly;
+the return value both carries meaning and signals an error.  To use
+this function, you must pass a <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a> pointer in <em class="parameter"><code>error</code></em>, and check
+whether it is not <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to see if an error occurred.</div>
+<p>
+</p>
+<p>
+Language bindings should use <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-value" title="g_key_file_get_value ()"><code class="function">g_key_file_get_value()</code></a> to test whether
+or not a key exists.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -965,8 +1094,11 @@ In the event the key cannot be found, <a class="link" href="glib-Standard-Macros
 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1013,8 +1145,11 @@ In the event the key cannot be found, <a class="link" href="glib-Standard-Macros
 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1062,8 +1197,11 @@ to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NO
 with <em class="parameter"><code>key</code></em> cannot be interpreted or no suitable translation can
 be found then the untranslated value is returned.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1080,7 +1218,7 @@ be found then the untranslated value is returned.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
-<td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -1114,8 +1252,11 @@ to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-KEY-NO
 associated with <em class="parameter"><code>key</code></em> cannot be interpreted as a boolean then <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
 is returned and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1161,8 +1302,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then 0 is returne
 with <em class="parameter"><code>key</code></em> cannot be interpreted as an integer then 0 is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1203,8 +1347,11 @@ Returns the value associated with <em class="parameter"><code>key</code></em> un
 64-bit integer. This is similar to <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer" title="g_key_file_get_integer ()"><code class="function">g_key_file_get_integer()</code></a> but can return
 64-bit results without truncation.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1245,8 +1392,11 @@ Returns the value associated with <em class="parameter"><code>key</code></em> un
 64-bit integer. This is similar to <a class="link" href="glib-Key-value-file-parser.html#g-key-file-get-integer" title="g_key_file_get_integer ()"><code class="function">g_key_file_get_integer()</code></a> but can return
 large positive results without truncation.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1292,8 +1442,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then 0.0 is retur
 with <em class="parameter"><code>key</code></em> cannot be interpreted as a double then 0.0 is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1339,8 +1492,11 @@ In the event the key cannot be found, <a class="link" href="glib-Standard-Macros
 event that the <em class="parameter"><code>group_name</code></em> cannot be found, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-GROUP-NOT-FOUND:CAPS"><span class="type">G_KEY_FILE_ERROR_GROUP_NOT_FOUND</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1357,7 +1513,7 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>return location for the number of returned strings, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>return location for the number of returned strings, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -1368,7 +1524,8 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated string array or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the specified
-key cannot be found. The array should be freed with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>.</td>
+key cannot be found. The array should be freed with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -1396,8 +1553,11 @@ can be found then the untranslated values are returned. The
 returned array is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated, so <em class="parameter"><code>length</code></em> may optionally
 be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1414,12 +1574,12 @@ be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
-<td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>a locale identifier or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>return location for the number of returned strings or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>return location for the number of returned strings or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -1431,7 +1591,8 @@ be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 <td>a newly allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated string array
 or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key isn't found. The string array should be freed
-with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>.</td>
+with <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -1455,8 +1616,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then <a class="li
 with <em class="parameter"><code>key</code></em> cannot be interpreted as booleans then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1473,7 +1637,8 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>the number of booleans returned</td>
+<td>the number of booleans returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
@@ -1482,8 +1647,10 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the values associated with the key as a list of
-booleans, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key was not found or could not be parsed.</td>
+<td>the values associated with the key as a list of booleans, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the
+key was not found or could not be parsed. The returned list of booleans
+should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gboolean][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -1507,8 +1674,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then <a class="li
 with <em class="parameter"><code>key</code></em> cannot be interpreted as integers then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1525,7 +1695,8 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>the number of integers returned</td>
+<td>the number of integers returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
@@ -1534,8 +1705,10 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the values associated with the key as a list of
-integers, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key was not found or could not be parsed.</td>
+<td>the values associated with the key as a list of integers, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
+the key was not found or could not be parsed. The returned list of
+integers should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gint][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -1559,8 +1732,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then <a class="li
 with <em class="parameter"><code>key</code></em> cannot be interpreted as doubles then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned
 and <em class="parameter"><code>error</code></em> is set to <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-ERROR-INVALID-VALUE:CAPS"><span class="type">G_KEY_FILE_ERROR_INVALID_VALUE</span></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1577,7 +1753,8 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
-<td>the number of doubles returned</td>
+<td>the number of doubles returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
@@ -1586,8 +1763,10 @@ and <em class="parameter"><code>error</code></em> is set to <a class="link" href
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the values associated with the key as a list of
-doubles, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key was not found or could not be parsed.</td>
+<td>the values associated with the key as a list of doubles, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the
+key was not found or could not be parsed. The returned list of doubles
+should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> gdouble][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -1606,8 +1785,11 @@ If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Sta
 <em class="parameter"><code>group_name</code></em>. If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em> are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then
 <em class="parameter"><code>comment</code></em> will be read from above the first group in the file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1616,7 +1798,7 @@ If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Sta
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
-<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
@@ -1653,8 +1835,11 @@ be found then it is created. To set an UTF-8 string which may contain
 characters that need escaping (such as newlines or spaces), use
 <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-string" title="g_key_file_set_string ()"><code class="function">g_key_file_set_string()</code></a>.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1691,8 +1876,11 @@ If <em class="parameter"><code>group_name</code></em> cannot be found then it is
 Unlike <a class="link" href="glib-Key-value-file-parser.html#g-key-file-set-value" title="g_key_file_set_value ()"><code class="function">g_key_file_set_value()</code></a>, this function handles characters
 that need escaping, such as newlines.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1727,8 +1915,11 @@ that need escaping, such as newlines.
 Associates a string value for <em class="parameter"><code>key</code></em> and <em class="parameter"><code>locale</code></em> under <em class="parameter"><code>group_name</code></em>.
 If the translation for <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1766,8 +1957,11 @@ If the translation for <em class="parameter"><code>key</code></em> cannot be fou
 Associates a new boolean value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1803,8 +1997,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1838,8 +2035,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1873,8 +2073,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 Associates a new integer value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1908,8 +2111,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 Associates a new double value with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1945,8 +2151,11 @@ Associates a list of string values for <em class="parameter"><code>key</code></e
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 If <em class="parameter"><code>group_name</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -1963,7 +2172,8 @@ If <em class="parameter"><code>group_name</code></em> cannot be found then it is
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
-<td>an array of string values</td>
+<td>an array of string values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
@@ -1988,8 +2198,11 @@ Associates a list of string values for <em class="parameter"><code>key</code></e
 <em class="parameter"><code>group_name</code></em>.  If the translation for <em class="parameter"><code>key</code></em> cannot be found then
 it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2010,7 +2223,8 @@ it is created.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
-<td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of locale string values</td>
+<td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of locale string values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1 length=length]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
@@ -2034,8 +2248,11 @@ Associates a list of boolean values with <em class="parameter"><code>key</code><
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 If <em class="parameter"><code>group_name</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the start_group is used.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2052,7 +2269,8 @@ If <em class="parameter"><code>group_name</code></em> is <a class="link" href="g
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
-<td>an array of boolean values</td>
+<td>an array of boolean values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
@@ -2075,8 +2293,11 @@ If <em class="parameter"><code>group_name</code></em> is <a class="link" href="g
 Associates a list of integer values with <em class="parameter"><code>key</code></em> under <em class="parameter"><code>group_name</code></em>.
 If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2093,7 +2314,8 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
-<td>an array of integer values</td>
+<td>an array of integer values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
@@ -2116,8 +2338,11 @@ If <em class="parameter"><code>key</code></em> cannot be found then it is create
 Associates a list of double values with <em class="parameter"><code>key</code></em> under
 <em class="parameter"><code>group_name</code></em>.  If <em class="parameter"><code>key</code></em> cannot be found then it is created.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2134,7 +2359,8 @@ Associates a list of double values with <em class="parameter"><code>key</code></
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
-<td>an array of double values</td>
+<td>an array of double values. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
@@ -2159,8 +2385,11 @@ If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Sta
 If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em>  are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>comment</code></em> will be
 written above the first group in the file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2169,12 +2398,13 @@ written above the first group in the file.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
-<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
-<td>a key</td>
+<td>a key. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>comment</code></em> :</span></p></td>
@@ -2204,8 +2434,11 @@ written above the first group in the file.
 Removes the specified group, <em class="parameter"><code>group_name</code></em>,
 from the key file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2240,8 +2473,11 @@ from the key file.
 <p>
 Removes <em class="parameter"><code>key</code></em> in <em class="parameter"><code>group_name</code></em> from the key file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2283,8 +2519,11 @@ If <em class="parameter"><code>key</code></em> is <a class="link" href="glib-Sta
 If both <em class="parameter"><code>key</code></em> and <em class="parameter"><code>group_name</code></em> are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <em class="parameter"><code>comment</code></em> will
 be removed above the first group in the file.
 </p>
-<div class="variablelist"><table border="0">
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
 <col align="left" valign="top">
+<col>
+</colgroup>
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
@@ -2293,12 +2532,13 @@ be removed above the first group in the file.
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
-<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
+<td>a group name, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
-<td>a key</td>
+<td>a key. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
@@ -2333,11 +2573,11 @@ details about the meanings of the keys below.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TYPE             "Type"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string giving the type of the desktop entry. Usually
-<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_APPLICATION"><code class="literal">G_KEY_FILE_DESKTOP_TYPE_APPLICATION</code></a>,
-<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_LINK"><code class="literal">G_KEY_FILE_DESKTOP_TYPE_LINK</code></a>, or
-<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_DIRECTORY"><code class="literal">G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</code></a>.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+giving the type of the desktop entry. Usually
+<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-APPLICATION:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_APPLICATION"><span class="type">G_KEY_FILE_DESKTOP_TYPE_APPLICATION</span></a>,
+<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-LINK:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_LINK"><span class="type">G_KEY_FILE_DESKTOP_TYPE_LINK</span></a>, or
+<a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-TYPE-DIRECTORY:CAPS" title="G_KEY_FILE_DESKTOP_TYPE_DIRECTORY"><span class="type">G_KEY_FILE_DESKTOP_TYPE_DIRECTORY</span></a>.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2347,9 +2587,9 @@ whose value is a string giving the type of the desktop entry. Usually
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_VERSION          "Version"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string giving the version of the Desktop
-Entry Specification used for the desktop entry file.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+giving the version of the Desktop Entry Specification used for
+the desktop entry file.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2359,9 +2599,8 @@ Entry Specification used for the desktop entry file.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NAME             "Name"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a localized string giving the specific name of the
-desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
+string giving the specific name of the desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2371,9 +2610,8 @@ desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_GENERIC_NAME     "GenericName"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a localized string giving the generic name of the
-desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
+string giving the generic name of the desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2383,9 +2621,8 @@ desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY       "NoDisplay"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a boolean stating whether the desktop entry should be
-shown in menus.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
+stating whether the desktop entry should be shown in menus.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2395,9 +2632,8 @@ shown in menus.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_COMMENT          "Comment"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a localized string giving the tooltip for the desktop
-entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
+string giving the tooltip for the desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2407,9 +2643,9 @@ entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_ICON             "Icon"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a localized string giving the name of the icon to be
-displayed for the desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a localized
+string giving the name of the icon to be displayed for the desktop
+entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2419,9 +2655,8 @@ displayed for the desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_HIDDEN           "Hidden"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a boolean stating whether the desktop entry has been
-deleted by the user.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
+stating whether the desktop entry has been deleted by the user.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2431,9 +2666,9 @@ deleted by the user.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_ONLY_SHOW_IN     "OnlyShowIn"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a list of strings identifying the environments that
-should display the desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list of
+strings identifying the environments that should display the
+desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2443,9 +2678,9 @@ should display the desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_NOT_SHOW_IN      "NotShowIn"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a list of strings identifying the environments that
-should not display the desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list of
+strings identifying the environments that should not display the
+desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2455,11 +2690,10 @@ should not display the desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TRY_EXEC         "TryExec"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string giving the file name of a binary on disk
-used to determine if the program is actually installed. It is only
-valid for desktop entries with the <code class="literal">Application</code>
-type.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+giving the file name of a binary on disk used to determine if the
+program is actually installed. It is only valid for desktop entries
+with the <code class="literal">Application</code> type.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2469,10 +2703,9 @@ type.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_EXEC             "Exec"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string giving the command line to execute. It is only
-valid for desktop entries with the <code class="literal">Application</code>
-type.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+giving the command line to execute. It is only valid for desktop
+entries with the <code class="literal">Application</code> type.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2482,10 +2715,9 @@ type.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_PATH             "Path"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string containing the working directory to run the
-program in. It is only valid for desktop entries with the
-<code class="literal">Application</code> type.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+containing the working directory to run the program in. It is only
+valid for desktop entries with the <code class="literal">Application</code> type.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2495,10 +2727,10 @@ program in. It is only valid for desktop entries with the
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_TERMINAL         "Terminal"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a boolean stating whether the program should be
-run in a terminal window. It is only valid for desktop entries with
-the <code class="literal">Application</code> type.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
+stating whether the program should be run in a terminal window.
+It is only valid for desktop entries with the
+<code class="literal">Application</code> type.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2508,9 +2740,8 @@ the <code class="literal">Application</code> type.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_MIME_TYPE        "MimeType"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a list of strings giving the MIME types supported
-by this desktop entry.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list
+of strings giving the MIME types supported by this desktop entry.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2520,9 +2751,9 @@ by this desktop entry.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_CATEGORIES       "Categories"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a list of strings giving the categories in which the
-desktop entry should be shown in a menu.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a list
+of strings giving the categories in which the desktop entry
+should be shown in a menu.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2532,9 +2763,8 @@ desktop entry should be shown in a menu.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_STARTUP_NOTIFY   "StartupNotify"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a boolean stating whether the application supports
-the <a class="ulink" href="http://www.freedesktop.org/Standards/startup-notification-spec" target="_top">Startup
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a boolean
+stating whether the application supports the <a class="ulink" href="http://www.freedesktop.org/Standards/startup-notification-spec" target="_top">Startup
 Notification Protocol Specification</a>.
 </p>
 <p class="since">Since 2.14</p>
@@ -2545,10 +2775,10 @@ Notification Protocol Specification</a>.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_STARTUP_WM_CLASS "StartupWMClass"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is string identifying the WM class or name hint of a
-window that the application will create, which can be used to emulate
-Startup Notification with older applications.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is string
+identifying the WM class or name hint of a window that the application
+will create, which can be used to emulate Startup Notification with
+older applications.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2558,9 +2788,9 @@ Startup Notification with older applications.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_KEY_URL              "URL"
 </pre>
 <p>
-A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><code class="literal">G_KEY_FILE_DESKTOP_GROUP</code></a>
-whose value is a string giving the URL to access. It is only valid
-for desktop entries with the <code class="literal">Link</code> type.
+A key under <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-GROUP:CAPS" title="G_KEY_FILE_DESKTOP_GROUP"><span class="type">G_KEY_FILE_DESKTOP_GROUP</span></a>, whose value is a string
+giving the URL to access. It is only valid for desktop entries
+with the <code class="literal">Link</code> type.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2570,8 +2800,8 @@ for desktop entries with the <code class="literal">Link</code> type.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_APPLICATION     "Application"
 </pre>
 <p>
-The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><code class="literal">G_KEY_FILE_DESKTOP_KEY_TYPE</code></a>
-key for desktop entries representing applications.
+The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
+entries representing applications.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2581,8 +2811,8 @@ key for desktop entries representing applications.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_LINK            "Link"
 </pre>
 <p>
-The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><code class="literal">G_KEY_FILE_DESKTOP_KEY_TYPE</code></a>
-key for desktop entries representing links to documents.
+The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
+entries representing links to documents.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2592,8 +2822,8 @@ key for desktop entries representing links to documents.
 <pre class="programlisting">#define G_KEY_FILE_DESKTOP_TYPE_DIRECTORY       "Directory"
 </pre>
 <p>
-The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><code class="literal">G_KEY_FILE_DESKTOP_KEY_TYPE</code></a>
-key for desktop entries representing directories.
+The value of the <a class="link" href="glib-Key-value-file-parser.html#G-KEY-FILE-DESKTOP-KEY-TYPE:CAPS" title="G_KEY_FILE_DESKTOP_KEY_TYPE"><span class="type">G_KEY_FILE_DESKTOP_KEY_TYPE</span></a>, key for desktop
+entries representing directories.
 </p>
 <p class="since">Since 2.14</p>
 </div>
@@ -2601,6 +2831,6 @@ key for desktop entries representing directories.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.17</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>