RubyGems - glib2 - Versions diffs - 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32 - Mend

glib2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32

Files changed (620) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-URI-Functions.html" title="URI Functions">
 <link rel="next" href="glib-Shell-related-Utilities.html" title="Shell-related Utilities">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#glib-Hostname-Utilities.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="Hostname Utilities">
+<div class="refentry">
 <a name="glib-Hostname-Utilities"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="glib-Hostname-Utilities.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">
 #include &lt;glib.h&gt;
@@ -49,7 +49,7 @@
 <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="glib-Hostname-Utilities.html#g-hostname-is-ip-address" title="g_hostname_is_ip_address ()">g_hostname_is_ip_address</a>            (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="glib-Hostname-Utilities.description"></a><h2>Description</h2>
 <p>
 Functions for manipulating internet hostnames; in particular, for
@@ -66,9 +66,9 @@ used with non-IDN-aware applications and protocols. (For example,
 "Παν語.org" maps to "xn--4wa8awb4637h.org".)
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="glib-Hostname-Utilities.details"></a><h2>Details</h2>
-<div class="refsect2" title="g_hostname_to_ascii ()">
+<div class="refsect2">
 <a name="g-hostname-to-ascii"></a><h3>g_hostname_to_ascii ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_hostname_to_ascii                 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre>
 <p>
@@ -81,22 +81,19 @@ trailing dot.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
-<td>a valid UTF-8 or ASCII hostname
-</td>
+<td>a valid UTF-8 or ASCII hostname</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> an ASCII hostname, which must be freed, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
-<em class="parameter"><code>hostname</code></em> is in some way invalid.
-</td>
+<td>an ASCII hostname, which must be freed, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
+<em class="parameter"><code>hostname</code></em> is in some way invalid.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.22</p>
 </div>
 <hr>
-<div class="refsect2" title="g_hostname_to_unicode ()">
+<div class="refsect2">
 <a name="g-hostname-to-unicode"></a><h3>g_hostname_to_unicode ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *             g_hostname_to_unicode               (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre>
 <p>
@@ -114,22 +111,19 @@ the canonical presentation form will be entirely ASCII.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
-<td>a valid UTF-8 or ASCII hostname
-</td>
+<td>a valid UTF-8 or ASCII hostname</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> a UTF-8 hostname, which must be freed, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
-<em class="parameter"><code>hostname</code></em> is in some way invalid.
-</td>
+<td>a UTF-8 hostname, which must be freed, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if
+<em class="parameter"><code>hostname</code></em> is in some way invalid.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.22</p>
 </div>
 <hr>
-<div class="refsect2" title="g_hostname_is_non_ascii ()">
+<div class="refsect2">
 <a name="g-hostname-is-non-ascii"></a><h3>g_hostname_is_non_ascii ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_hostname_is_non_ascii             (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre>
 <p>
@@ -147,21 +141,19 @@ segments, and so it is possible for <a class="link" href="glib-Hostname-Utilitie
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
-<td>a hostname
-</td>
+<td>a hostname</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> contains any non-ASCII characters
-</td>
+<td>
+<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> contains any non-ASCII characters</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.22</p>
 </div>
 <hr>
-<div class="refsect2" title="g_hostname_is_ascii_encoded ()">
+<div class="refsect2">
 <a name="g-hostname-is-ascii-encoded"></a><h3>g_hostname_is_ascii_encoded ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_hostname_is_ascii_encoded         (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre>
 <p>
@@ -180,22 +172,20 @@ segments, and so it is possible for <a class="link" href="glib-Hostname-Utilitie
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
-<td>a hostname
-</td>
+<td>a hostname</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> contains any ASCII-encoded
-segments.
-</td>
+<td>
+<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> contains any ASCII-encoded
+segments.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.22</p>
 </div>
 <hr>
-<div class="refsect2" title="g_hostname_is_ip_address ()">
+<div class="refsect2">
 <a name="g-hostname-is-ip-address"></a><h3>g_hostname_is_ip_address ()</h3>
 <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>            g_hostname_is_ip_address            (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *hostname</code></em>);</pre>
 <p>
@@ -207,14 +197,12 @@ Tests if <em class="parameter"><code>hostname</code></em> is the string form of
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>hostname</code></em> :</span></p></td>
-<td>a hostname (or IP address in string form)
-</td>
+<td>a hostname (or IP address in string form)</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> is an IP address
-</td>
+<td>
+<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>hostname</code></em> is an IP address</td>
 </tr>
 </tbody>
 </table></div>
@@ -224,6 +212,6 @@ Tests if <em class="parameter"><code>hostname</code></em> is the string form of
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Data-Checksums.html" title="Data Checksums">
 <link rel="next" href="glib-Date-and-Time-Functions.html" title="Date and Time Functions">
-<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,7 +26,7 @@
                   <a href="#glib-I18N.description" class="shortcut">Description</a>
 </td></tr>
 </table>
-<div class="refentry" title="Internationalization">
+<div class="refentry">
 <a name="glib-I18N"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
 <td valign="top">
@@ -35,7 +35,7 @@
 </td>
 <td valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv" title="Synopsis">
+<div class="refsynopsisdiv">
 <a name="glib-I18N.synopsis"></a><h2>Synopsis</h2>
 <pre class="synopsis">
 #include &lt;glib.h&gt;
@@ -66,10 +66,11 @@ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span cla
 const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="glib-I18N.html#g-strip-context" title="g_strip_context ()">g_strip_context</a>                     (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgid</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgval</code></em>);
-const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* const * <a class="link" href="glib-I18N.html#g-get-language-names" title="g_get_language_names ()">g_get_language_names</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
+const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * const * <a class="link" href="glib-I18N.html#g-get-language-names" title="g_get_language_names ()">g_get_language_names</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="glib-I18N.html#g-get-locale-variants" title="g_get_locale_variants ()">g_get_locale_variants</a>               (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>);
 </pre>
 </div>
-<div class="refsect1" title="Description">
+<div class="refsect1">
 <a name="glib-I18N.description"></a><h2>Description</h2>
 <p>
 GLib doesn't force any particular localization method upon its users.
@@ -97,13 +98,16 @@ the GETTEXT_PACKAGE macro suitably for your library:
 </div>
 <p>
+Note that you also have to call <a class="link" href="glib-running.html#setlocale" title="Locale"><code class="function">setlocale()</code></a> and <code class="function">textdomain()</code> (as well as
+<code class="function">bindtextdomain()</code> and <code class="function">bind_textdomain_codeset()</code>) early on in your <code class="function">main()</code>
+to make <code class="function">gettext()</code> work.
 The gettext manual covers details of how to set up message extraction
 with xgettext.
 </p>
 </div>
-<div class="refsect1" title="Details">
+<div class="refsect1">
 <a name="glib-I18N.details"></a><h2>Details</h2>
-<div class="refsect2" title="_()">
+<div class="refsect2">
 <a name="gettext-macro"></a><h3>_()</h3>
 <pre class="programlisting">#define             _(String)</pre>
 <p>
@@ -114,14 +118,13 @@ at runtime.
 <col align="left" valign="top">
 <tbody><tr>
 <td><p><span class="term"><em class="parameter"><code>String</code></em> :</span></p></td>
-<td>the string to be translated
-</td>
+<td>the string to be translated</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.4</p>
 </div>
 <hr>
-<div class="refsect2" title="Q_()">
+<div class="refsect2">
 <a name="Q-:CAPS"></a><h3>Q_()</h3>
 <pre class="programlisting">#define             Q_(String)</pre>
 <p>
@@ -141,7 +144,7 @@ language. This could be solved by using "charset|Russian" and
 See the <a class="link" href="glib-I18N.html#C-:CAPS" title="C_()"><code class="function">C_()</code></a> macro for a different way to mark up translatable strings
 with context.
 </p>
-<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>
 If you are using the <a class="link" href="glib-I18N.html#Q-:CAPS" title="Q_()"><code class="function">Q_()</code></a> macro, you need to make sure that you
@@ -156,21 +159,19 @@ string off into a msgctxt line in the po file.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>String</code></em> :</span></p></td>
-<td>the string to be translated, with a '|'-separated prefix which
-  must not be translated
-</td>
+<td>the string to be translated, with a '|'-separated prefix which
+must not be translated</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the translated message
-</td>
+<td>the translated message</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.4</p>
 </div>
 <hr>
-<div class="refsect2" title="C_()">
+<div class="refsect2">
 <a name="C-:CAPS"></a><h3>C_()</h3>
 <pre class="programlisting">#define             C_(Context,String)</pre>
 <p>
@@ -194,7 +195,7 @@ they are used.
 <p>
 </p>
-<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>
 If you are using the <a class="link" href="glib-I18N.html#C-:CAPS" title="C_()"><code class="function">C_()</code></a> macro, you need to make sure that you
@@ -207,25 +208,22 @@ messages. Note that this only works with GNU gettext &gt;= 0.15.
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>Context</code></em> :</span></p></td>
-<td>a message context, must be a string literal
-</td>
+<td>a message context, must be a string literal</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>String</code></em> :</span></p></td>
-<td>a message id, must be a string literal
-</td>
+<td>a message id, must be a string literal</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the translated message
-</td>
+<td>the translated message</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.16</p>
 </div>
 <hr>
-<div class="refsect2" title="N_()">
+<div class="refsect2">
 <a name="N-:CAPS"></a><h3>N_()</h3>
 <pre class="programlisting">#define             N_(String)</pre>
 <p>
@@ -273,14 +271,13 @@ To get the translated string, call <code class="function">gettext()</code> at ru
 <col align="left" valign="top">
 <tbody><tr>
 <td><p><span class="term"><em class="parameter"><code>String</code></em> :</span></p></td>
-<td>the string to be translated
-</td>
+<td>the string to be translated</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.4</p>
 </div>
 <hr>
-<div class="refsect2" title="NC_()">
+<div class="refsect2">
 <a name="NC-:CAPS"></a><h3>NC_()</h3>
 <pre class="programlisting">#define             NC_(Context, String)</pre>
 <p>
@@ -324,7 +321,7 @@ To get the translated string, you should call <a class="link" href="glib-I18N.ht
   </table>
 </div>
-<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>
 If you are using the <a class="link" href="glib-I18N.html#NC-:CAPS" title="NC_()"><code class="function">NC_()</code></a> macro, you need to make sure that you
@@ -338,20 +335,18 @@ Intltool has support for the <a class="link" href="glib-I18N.html#NC-:CAPS" titl
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>Context</code></em> :</span></p></td>
-<td>a message context, must be a string literal
-</td>
+<td>a message context, must be a string literal</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>String</code></em> :</span></p></td>
-<td>a message id, must be a string literal
-</td>
+<td>a message id, must be a string literal</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.18</p>
 </div>
 <hr>
-<div class="refsect2" title="g_dgettext ()">
+<div class="refsect2">
 <a name="g-dgettext"></a><h3>g_dgettext ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dgettext                          (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgid</code></em>);</pre>
@@ -402,26 +397,23 @@ but use the <a class="link" href="glib-I18N.html#gettext-macro" title="_()"><cod
 <tr>
 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 <td>the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
-  the domain set with <code class="function">textdomain()</code>
+the domain set with <code class="function">textdomain()</code>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgid</code></em> :</span></p></td>
-<td>message to translate
-</td>
+<td>message to translate</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The translated string
-</td>
+<td>The translated string</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.18</p>
 </div>
 <hr>
-<div class="refsect2" title="g_dcgettext ()">
+<div class="refsect2">
 <a name="g-dcgettext"></a><h3>g_dcgettext ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dcgettext                         (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgid</code></em>,
@@ -437,32 +429,28 @@ more information about how this functions differs from calling
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
-<td> the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
-  the domain set with <code class="function">textdomain()</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+<td>the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
+the domain set with <code class="function">textdomain()</code>. <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>msgid</code></em> :</span></p></td>
-<td>message to translate
-</td>
+<td>message to translate</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>category</code></em> :</span></p></td>
-<td>a locale category
-</td>
+<td>a locale category</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> the translated string for the given locale category
-</td>
+<td>the translated string for the given locale category</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.26</p>
 </div>
 <hr>
-<div class="refsect2" title="g_dngettext ()">
+<div class="refsect2">
 <a name="g-dngettext"></a><h3>g_dngettext ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dngettext                         (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgid</code></em>,
@@ -483,36 +471,31 @@ proper.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 <td>the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
-  the domain set with <code class="function">textdomain()</code>
+the domain set with <code class="function">textdomain()</code>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgid</code></em> :</span></p></td>
-<td>message to translate
-</td>
+<td>message to translate</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgid_plural</code></em> :</span></p></td>
-<td>plural form of the message
-</td>
+<td>plural form of the message</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
-<td>the quantity for which translation is needed
-</td>
+<td>the quantity for which translation is needed</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The translated string
-</td>
+<td>The translated string</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.18</p>
 </div>
 <hr>
-<div class="refsect2" title="g_dpgettext ()">
+<div class="refsect2">
 <a name="g-dpgettext"></a><h3>g_dpgettext ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dpgettext                         (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgctxtid</code></em>,
@@ -540,14 +523,13 @@ but use the <a class="link" href="glib-I18N.html#C-:CAPS" title="C_()"><code cla
 <tr>
 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 <td>the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
-  the domain set with <code class="function">textdomain()</code>
+the domain set with <code class="function">textdomain()</code>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgctxtid</code></em> :</span></p></td>
 <td>a combined message context and message id, separated
-  by a \004 character
-</td>
+by a \004 character</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgidoffset</code></em> :</span></p></td>
@@ -556,16 +538,14 @@ but use the <a class="link" href="glib-I18N.html#C-:CAPS" title="C_()"><code cla
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The translated string
-</td>
+<td>The translated string</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.16</p>
 </div>
 <hr>
-<div class="refsect2" title="g_dpgettext2 ()">
+<div class="refsect2">
 <a name="g-dpgettext2"></a><h3>g_dpgettext2 ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_dpgettext2                        (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *domain</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *context</code></em>,
@@ -590,31 +570,27 @@ thus you may use non-string-literals as context and msgid arguments.
 <tr>
 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 <td>the translation domain to use, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use
-  the domain set with <code class="function">textdomain()</code>
+the domain set with <code class="function">textdomain()</code>
 </td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
-<td>the message context
-</td>
+<td>the message context</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgid</code></em> :</span></p></td>
-<td>the message
-</td>
+<td>the message</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> The translated string
-</td>
+<td>The translated string</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.18</p>
 </div>
 <hr>
-<div class="refsect2" title="g_strip_context ()">
+<div class="refsect2">
 <a name="g-strip-context"></a><h3>g_strip_context ()</h3>
 <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *       g_strip_context                     (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgid</code></em>,
                                                          <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *msgval</code></em>);</pre>
@@ -626,30 +602,27 @@ An auxiliary function for <code class="function">gettext()</code> support (see <
 <tbody>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgid</code></em> :</span></p></td>
-<td>a string
-</td>
+<td>a string</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>msgval</code></em> :</span></p></td>
-<td>another string
-</td>
+<td>another string</td>
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td> <em class="parameter"><code>msgval</code></em>, unless <em class="parameter"><code>msgval</code></em> is identical to <em class="parameter"><code>msgid</code></em> and contains
-  a '|' character, in which case a pointer to the substring of msgid after
-  the first '|' character is returned.
-</td>
+<td>
+<em class="parameter"><code>msgval</code></em>, unless <em class="parameter"><code>msgval</code></em> is identical to <em class="parameter"><code>msgid</code></em> and contains
+a '|' character, in which case a pointer to the substring of msgid after
+the first '|' character is returned.</td>
 </tr>
 </tbody>
 </table></div>
 <p class="since">Since 2.4</p>
 </div>
 <hr>
-<div class="refsect2" title="g_get_language_names ()">
+<div class="refsect2">
 <a name="g-get-language-names"></a><h3>g_get_language_names ()</h3>
-<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* const * g_get_language_names               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * const * g_get_language_names              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>
 Computes a list of applicable locale names, which can be used to
 e.g. construct locale-dependent filenames or search paths. The returned
@@ -669,16 +642,50 @@ to find the list of locales specified by the user.
 <col align="left" valign="top">
 <tbody><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 array of strings owned by GLib
-   that must not be modified or freed.
-</td>
+<td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings owned by GLib
+that must not be modified or freed.</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.6</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="g-get-locale-variants"></a><h3>g_get_locale_variants ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **            g_get_locale_variants               (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
+<p>
+Returns a list of derived variants of <em class="parameter"><code>locale</code></em>, which can be used to
+e.g. construct locale-dependent filenames or search paths. The returned
+list is sorted from most desirable to least desirable.
+This function handles territory, charset and extra locale modifiers.
+</p>
+<p>
+For example, if <em class="parameter"><code>locale</code></em> is "fr_BE", then the returned list
+is "fr_BE", "fr".
+</p>
+<p>
+If you need the list of variants for the <span class="emphasis"><em>current locale</em></span>,
+use <a class="link" href="glib-I18N.html#g-get-language-names" title="g_get_language_names ()"><code class="function">g_get_language_names()</code></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
+<td>a locale identifier</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a newly
+allocated array of newly allocated strings with the locale variants. Free 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="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<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> utf8]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.28</p>
+</div>
 </div>
-<div class="refsect1" title="See Also">
+<div class="refsect1">
 <a name="glib-I18N.see-also"></a><h2>See Also</h2>
 <p>
 The gettext manual.
@@ -687,6 +694,6 @@ The gettext manual.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.15</div>
+          Generated by GTK-Doc V1.16.1</div>
 </body>
 </html>