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-Miscellaneous-Macros.html CHANGED

@@ -3,12 +3,12 @@
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Miscellaneous Macros</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-fundamentals.html" title="GLib Fundamentals">
 <link rel="prev" href="glib-Numerical-Definitions.html" title="Numerical Definitions">
 <link rel="next" href="glib-Atomic-Operations.html" title="Atomic Operations">
-<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">
@@ -48,8 +48,6 @@
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-BEGIN-DECLS:CAPS" title="G_BEGIN_DECLS">G_BEGIN_DECLS</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-END-DECLS:CAPS" title="G_END_DECLS">G_END_DECLS</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-N-ELEMENTS:CAPS" title="G_N_ELEMENTS()">G_N_ELEMENTS</a>                        (arr)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-VA-COPY:CAPS" title="G_VA_COPY()">G_VA_COPY</a>                           (ap1,
                                                          ap2)
@@ -57,6 +55,7 @@
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-PASTE:CAPS" title="G_PASTE()">G_PASTE</a>                             (identifier1,
                                                          identifier2)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT:CAPS" title="G_STATIC_ASSERT()">G_STATIC_ASSERT</a>                     (expr)
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT-EXPR:CAPS" title="G_STATIC_ASSERT_EXPR()">G_STATIC_ASSERT_EXPR</a>                (expr)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-EXTENSION:CAPS" title="G_GNUC_EXTENSION">G_GNUC_EXTENSION</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-CONST:CAPS" title="G_GNUC_CONST">G_GNUC_CONST</a>
@@ -67,6 +66,8 @@
                                                          y)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED">G_GNUC_DEPRECATED</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED-FOR:CAPS" title="G_GNUC_DEPRECATED_FOR()">G_GNUC_DEPRECATED_FOR</a>               (f)
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-BEGIN-IGNORE-DEPRECATIONS:CAPS" title="G_GNUC_BEGIN_IGNORE_DEPRECATIONS">G_GNUC_BEGIN_IGNORE_DEPRECATIONS</a>
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-END-IGNORE-DEPRECATIONS:CAPS" title="G_GNUC_END_IGNORE_DEPRECATIONS">G_GNUC_END_IGNORE_DEPRECATIONS</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-NORETURN:CAPS" title="G_GNUC_NORETURN">G_GNUC_NORETURN</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS" title="G_GNUC_UNUSED">G_GNUC_UNUSED</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-PRINTF:CAPS" title="G_GNUC_PRINTF()">G_GNUC_PRINTF</a>                       (format_idx,
@@ -83,36 +84,23 @@
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-INTERNAL:CAPS" title="G_GNUC_INTERNAL">G_GNUC_INTERNAL</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-MAY-ALIAS:CAPS" title="G_GNUC_MAY_ALIAS">G_GNUC_MAY_ALIAS</a>
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-DEPRECATED:CAPS" title="G_DEPRECATED">G_DEPRECATED</a>
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-DEPRECATED-FOR:CAPS" title="G_DEPRECATED_FOR()">G_DEPRECATED_FOR</a>                    (f)
+#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-UNAVAILABLE:CAPS" title="G_UNAVAILABLE()">G_UNAVAILABLE</a>                       (maj,
+                                                         min)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-LIKELY:CAPS" title="G_LIKELY()">G_LIKELY</a>                            (expr)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-UNLIKELY:CAPS" title="G_UNLIKELY()">G_UNLIKELY</a>                          (expr)
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-STRLOC:CAPS" title="G_STRLOC">G_STRLOC</a>
 #define             <a class="link" href="glib-Miscellaneous-Macros.html#G-STRFUNC:CAPS" title="G_STRFUNC">G_STRFUNC</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-MODIFIER:CAPS" title="G_GINT16_MODIFIER">G_GINT16_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT">G_GINT16_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GUINT16-FORMAT:CAPS" title="G_GUINT16_FORMAT">G_GUINT16_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT32-MODIFIER:CAPS" title="G_GINT32_MODIFIER">G_GINT32_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT32-FORMAT:CAPS" title="G_GINT32_FORMAT">G_GINT32_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GUINT32-FORMAT:CAPS" title="G_GUINT32_FORMAT">G_GUINT32_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-MODIFIER:CAPS" title="G_GINT64_MODIFIER">G_GINT64_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-FORMAT:CAPS" title="G_GINT64_FORMAT">G_GINT64_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GUINT64-FORMAT:CAPS" title="G_GUINT64_FORMAT">G_GUINT64_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GSIZE-MODIFIER:CAPS" title="G_GSIZE_MODIFIER">G_GSIZE_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GSIZE-FORMAT:CAPS" title="G_GSIZE_FORMAT">G_GSIZE_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GSSIZE-FORMAT:CAPS" title="G_GSSIZE_FORMAT">G_GSSIZE_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GOFFSET-MODIFIER:CAPS" title="G_GOFFSET_MODIFIER">G_GOFFSET_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GOFFSET-FORMAT:CAPS" title="G_GOFFSET_FORMAT">G_GOFFSET_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINTPTR-MODIFIER:CAPS" title="G_GINTPTR_MODIFIER">G_GINTPTR_MODIFIER</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GINTPTR-FORMAT:CAPS" title="G_GINTPTR_FORMAT">G_GINTPTR_FORMAT</a>
-#define             <a class="link" href="glib-Miscellaneous-Macros.html#G-GUINTPTR-FORMAT:CAPS" title="G_GUINTPTR_FORMAT">G_GUINTPTR_FORMAT</a>
 </pre>
 </div>
 <div class="refsect1">
 <a name="glib-Miscellaneous-Macros.description"></a><h2>Description</h2>
 <p>
-These macros provide more specialized features which are not needed so often
-by application programmers.
+These macros provide more specialized features which are not
+needed so often by application programmers.
 </p>
 </div>
 <div class="refsect1">
@@ -131,7 +119,7 @@ is very difficult. Their use is strongly discouraged.
 </p>
 <p>
 This macro is often mistaken for a replacement for the inline keyword;
-inline is already declared in a portable manner in the glib headers
+inline is already declared in a portable manner in the GLib headers
 and can be used normally.
 </p>
 </div>
@@ -141,8 +129,8 @@ and can be used normally.
 <pre class="programlisting">#  define G_STMT_START  do
 </pre>
 <p>
-Used within multi-statement macros so that they can be used in places where
-only one statement is expected by the compiler.
+Used within multi-statement macros so that they can be used in places
+where only one statement is expected by the compiler.
 </p>
 </div>
 <hr>
@@ -151,8 +139,8 @@ only one statement is expected by the compiler.
 <pre class="programlisting">#  define G_STMT_END    while (0)
 </pre>
 <p>
-Used within multi-statement macros so that they can be used in places where
-only one statement is expected by the compiler.
+Used within multi-statement macros so that they can be used in places
+where only one statement is expected by the compiler.
 </p>
 </div>
 <hr>
@@ -179,45 +167,31 @@ around the header.
 </div>
 <hr>
 <div class="refsect2">
-<a name="G-N-ELEMENTS:CAPS"></a><h3>G_N_ELEMENTS()</h3>
-<pre class="programlisting">#define G_N_ELEMENTS(arr)		(sizeof (arr) / sizeof ((arr)[0]))
-</pre>
-<p>
-Determines the number of elements in an array. The array must be
-declared so the compiler knows its size at compile-time; this
-macro will not work on an array allocated on the heap, only static
-arrays or arrays on the stack.
-</p>
-<div class="variablelist"><table border="0">
-<col align="left" valign="top">
-<tbody><tr>
-<td><p><span class="term"><em class="parameter"><code>arr</code></em> :</span></p></td>
-<td>the array</td>
-</tr></tbody>
-</table></div>
-</div>
-<hr>
-<div class="refsect2">
 <a name="G-VA-COPY:CAPS"></a><h3>G_VA_COPY()</h3>
 <pre class="programlisting">#define             G_VA_COPY(ap1,ap2)</pre>
 <p>
 Portable way to copy <span class="type">va_list</span> variables.
 </p>
 <p>
-In order to use this function, you must include <code class="filename">string.h</code>
-yourself, because this macro may use <code class="function"><code class="function">memmove()</code></code> and GLib
-does not include <code class="function">string.h</code> for you.
+In order to use this function, you must include
+<code class="filename">string.h</code> yourself, because this macro may
+use <code class="function">memmove()</code> and GLib does not include <code class="filename">string.h</code>
+for you.
 </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>ap1</code></em> :</span></p></td>
-<td>the <span class="type">va_list</span> variable to place a copy of <em class="parameter"><code>ap2</code></em> in.</td>
+<td>the <span class="type">va_list</span> variable to place a copy of <em class="parameter"><code>ap2</code></em> in</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>ap2</code></em> :</span></p></td>
-<td>a <span class="type">va_list</span>.</td>
+<td>a <span class="type">va_list</span>
+</td>
 </tr>
 </tbody>
 </table></div>
@@ -231,6 +205,8 @@ does not include <code class="function">string.h</code> for you.
 Accepts a macro or a string and converts it into a string after
 preprocessor argument expansion. For example, the following code:
 </p>
+<p>
+</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -244,9 +220,13 @@ preprocessor argument expansion. For example, the following code:
   </table>
 </div>
+<p>
+</p>
 <p>
 is transformed by the preprocessor into (code equivalent to):
 </p>
+<p>
+</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -258,11 +238,16 @@ is transformed by the preprocessor into (code equivalent to):
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>macro_or_string</code></em> :</span></p></td>
-<td>a macro or a string.</td>
+<td>a macro or a string</td>
 </tr></tbody>
 </table></div>
 </div>
@@ -272,9 +257,10 @@ is transformed by the preprocessor into (code equivalent to):
 <pre class="programlisting">#define G_PASTE(identifier1,identifier2)      G_PASTE_ARGS (identifier1, identifier2)
 </pre>
 <p>
-Yields a new preprocessor pasted identifier <code class="code">identifier1identifier2</code>
-from its expanded arguments <em class="parameter"><code>identifier1</code></em> and <em class="parameter"><code>identifier2</code></em>. For example, the
-following code:
+Yields a new preprocessor pasted identifier
+<code class="code">identifier1identifier2</code> from its expanded
+arguments <em class="parameter"><code>identifier1</code></em> and <em class="parameter"><code>identifier2</code></em>. For example,
+the following code:
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -293,6 +279,8 @@ following code:
   </table>
 </div>
+<p>
+</p>
 <p>
 is transformed by the preprocessor into:
 </p>
@@ -311,8 +299,13 @@ is transformed by the preprocessor into:
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>identifier1</code></em> :</span></p></td>
@@ -329,42 +322,99 @@ is transformed by the preprocessor into:
 <hr>
 <div class="refsect2">
 <a name="G-STATIC-ASSERT:CAPS"></a><h3>G_STATIC_ASSERT()</h3>
-<pre class="programlisting">#define G_STATIC_ASSERT(expr) typedef struct { char Compile_Time_Assertion[(expr) ? 1 : -1]; } G_PASTE (_GStaticAssert_, __LINE__)
+<pre class="programlisting">#define G_STATIC_ASSERT(expr) typedef char G_PASTE (_GStaticAssertCompileTimeAssertion_, __COUNTER__)[(expr) ? 1 : -1]
 </pre>
 <p>
-The G_STATIC_ASSERT macro lets the programmer check a condition at compile time,
-the condition needs to be compile time computable.
-The macro can be used in any place where a <code class="literal">typedef</code> is valid.
+The G_STATIC_ASSERT macro lets the programmer check
+a condition at compile time, the condition needs to
+be compile time computable. The macro can be used in
+any place where a <code class="literal">typedef</code> is valid.
+</p>
+<p>
 </p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>
-A <code class="literal">typedef</code> is generally allowed in exactly the same
-places that a variable declaration is allowed.  For this reason, you should not use <code class="literal">G_STATIC_ASSERT</code> in the middle of blocks of code.
+A <code class="literal">typedef</code> is generally allowed in
+exactly the same places that a variable declaration is
+allowed. For this reason, you should not use
+<code class="literal">G_STATIC_ASSERT</code> in the middle of
+blocks of code.
 </p>
 </div>
 <p>
+</p>
+<p>
 The macro should only be used once per source code line.
 </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>expr</code></em> :</span></p></td>
-<td>a constant expression.</td>
+<td>a constant expression</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.20</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="G-STATIC-ASSERT-EXPR:CAPS"></a><h3>G_STATIC_ASSERT_EXPR()</h3>
+<pre class="programlisting">#define G_STATIC_ASSERT_EXPR(expr) ((void) sizeof (char[(expr) ? 1 : -1]))
+</pre>
+<p>
+The G_STATIC_ASSERT_EXPR macro lets the programmer check
+a condition at compile time. The condition needs to be
+compile time computable.
+</p>
+<p>
+Unlike <code class="literal">G_STATIC_ASSERT</code>, this macro
+evaluates to an expression and, as such, can be used in
+the middle of other expressions. Its value should be
+ignored. This can be accomplished by placing it as
+the first argument of a comma expression.
+</p>
+<p>
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#define</span><span class="normal"> </span><span class="function">ADD_ONE_TO_INT</span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">  </span><span class="symbol">(</span><span class="function"><a href="glib-Miscellaneous-Macros.html#G-STATIC-ASSERT-EXPR:CAPS">G_STATIC_ASSERT_EXPR</a></span><span class="symbol">(</span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">)),</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">x</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">))</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+</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>expr</code></em> :</span></p></td>
+<td>a constant expression</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.30</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="G-GNUC-EXTENSION:CAPS"></a><h3>G_GNUC_EXTENSION</h3>
 <pre class="programlisting">#  define G_GNUC_EXTENSION __extension__
 </pre>
 <p>
-Expands to <code class="literal">__extension__</code> when <span class="command"><strong>gcc</strong></span> is
-used as the compiler.
-This simply tells <span class="command"><strong>gcc</strong></span> not to warn about the following non-standard code
-when compiling with the <code class="option">-pedantic</code> option.
+Expands to <code class="literal">__extension__</code> when <span class="command"><strong>gcc</strong></span>
+is used as the compiler. This simply tells <span class="command"><strong>gcc</strong></span> not
+to warn about the following non-standard code when compiling with the
+<code class="option">-pedantic</code> option.
 </p>
 </div>
 <hr>
@@ -372,31 +422,48 @@ when compiling with the <code class="option">-pedantic</code> option.
 <a name="G-GNUC-CONST:CAPS"></a><h3>G_GNUC_CONST</h3>
 <pre class="programlisting">#define             G_GNUC_CONST</pre>
 <p>
-Expands to the GNU C <code class="literal">const</code> function attribute if the compiler is
-<span class="command"><strong>gcc</strong></span>. Declaring a function as const enables better optimization of calls
-to the function. A const function doesn't examine any values except its parameters, and has no
-effects except its return value. See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">const</code> function attribute if
+the compiler is <span class="command"><strong>gcc</strong></span>. Declaring a function as const
+enables better optimization of calls to the function. A const function
+doesn't examine any values except its parameters, and has no effects
+except its return value.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
+</p>
+<p>
 </p>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
 <p>
 A function that has pointer arguments and examines the data pointed to
-must <span class="emphasis"><em>not</em></span> be declared const. Likewise, a function that
-calls a non-const function usually must not be const. It doesn't make sense
-for a const function to return void.
+must <span class="emphasis"><em>not</em></span> be declared const. Likewise, a function
+that calls a non-const function usually must not be const. It doesn't
+make sense for a const function to return void.
 </p>
 </div>
+<p>
+</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="G-GNUC-PURE:CAPS"></a><h3>G_GNUC_PURE</h3>
 <pre class="programlisting">#define             G_GNUC_PURE</pre>
 <p>
-Expands to the GNU C <code class="literal">pure</code> function attribute if the compiler is
-<span class="command"><strong>gcc</strong></span>. Declaring a function as pure enables better optimization of
-calls to the function. A pure function has no effects except its return value and the
-return value depends only on the parameters and/or global variables.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">pure</code> function attribute if the
+compiler is <span class="command"><strong>gcc</strong></span>. Declaring a function as pure enables
+better optimization of calls to the function. A pure function has no
+effects except its return value and the return value depends only on
+the parameters and/or global variables.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 </div>
 <hr>
@@ -406,10 +473,16 @@ See the GNU C documentation for details.
 <p>
 Expands to the GNU C <code class="literal">malloc</code> function attribute if the
 compiler is <span class="command"><strong>gcc</strong></span>. Declaring a function as malloc enables
-better optimization of the function. A function can have the malloc attribute
-if it returns a pointer which is guaranteed to not alias with any other pointer
-when the function returns (in practice, this means newly allocated memory).
-See the GNU C documentation for details.
+better optimization of the function. A function can have the malloc
+attribute if it returns a pointer which is guaranteed to not alias with
+any other pointer when the function returns (in practice, this means newly
+allocated memory).
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 <p class="since">Since 2.6</p>
 </div>
@@ -419,14 +492,23 @@ See the GNU C documentation for details.
 <pre class="programlisting">#define G_GNUC_ALLOC_SIZE(x) __attribute__((__alloc_size__(x)))
 </pre>
 <p>
-Expands to the GNU C <code class="literal">alloc_size</code> function attribute if the
-compiler is a new enough <span class="command"><strong>gcc</strong></span>. This attribute tells the
-compiler that the function returns a pointer to memory of a size that is
-specified by the <em class="parameter"><code>x</code></em>th function parameter.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">alloc_size</code> function attribute
+if the compiler is a new enough <span class="command"><strong>gcc</strong></span>. This attribute
+tells the compiler that the function returns a pointer to memory of a
+size that is specified by the <em class="parameter"><code>x</code></em>th function parameter.
+</p>
+<p>
+Place the attribute after the function declaration, just before the
+semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </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>x</code></em> :</span></p></td>
 <td>the index of the argument specifying the allocation size</td>
@@ -440,14 +522,23 @@ See the GNU C documentation for details.
 <pre class="programlisting">#define G_GNUC_ALLOC_SIZE2(x,y) __attribute__((__alloc_size__(x,y)))
 </pre>
 <p>
-Expands to the GNU C <code class="literal">alloc_size</code> function attribute if the
-compiler is a new enough <span class="command"><strong>gcc</strong></span>. This attribute tells the
-compiler that the function returns a pointer to memory of a size that is
-specified by the product of two function parameters.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">alloc_size</code> function attribute
+if the compiler is a new enough <span class="command"><strong>gcc</strong></span>. This attribute
+tells the compiler that the function returns a pointer to memory of a
+size that is specified by the product of two function parameters.
+</p>
+<p>
+Place the attribute after the function declaration, just before the
+semicolon.
 </p>
-<div class="variablelist"><table border="0">
+<p>
+See the GNU C documentation for more details.
+</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>x</code></em> :</span></p></td>
@@ -466,12 +557,17 @@ See the GNU C documentation for details.
 <a name="G-GNUC-DEPRECATED:CAPS"></a><h3>G_GNUC_DEPRECATED</h3>
 <pre class="programlisting">#define             G_GNUC_DEPRECATED</pre>
 <p>
-Expands to the GNU C <code class="literal">deprecated</code> attribute if the compiler
-is <span class="command"><strong>gcc</strong></span>.
-It can be used to mark typedefs, variables and functions as deprecated.
-When called with the <code class="option">-Wdeprecated-declarations</code> option, the compiler will
+Expands to the GNU C <code class="literal">deprecated</code> attribute if the
+compiler is <span class="command"><strong>gcc</strong></span>. It can be used to mark typedefs,
+variables and functions as deprecated. When called with the
+<code class="option">-Wdeprecated-declarations</code> option, the compiler will
 generate warnings when deprecated interfaces are used.
-See the GNU C documentation for details.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 <p class="since">Since 2.2</p>
 </div>
@@ -483,27 +579,84 @@ See the GNU C documentation for details.
 Like <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED"><code class="literal">G_GNUC_DEPRECATED</code></a>, but names the intended replacement for the
 deprecated symbol if the version of <span class="command"><strong>gcc</strong></span> in use is
 new enough to support custom deprecation messages.
-See the GNU C documentation for details.
 </p>
-<div class="variablelist"><table border="0">
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
+</p>
+<p>
+Note that if <em class="parameter"><code>f</code></em> is a macro, it will be expanded in the warning message.
+You can enclose it in quotes to prevent this. (The quotes will show up
+in the warning, but it's better than showing the macro expansion.)
+</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>f</code></em> :</span></p></td>
-<td>the intended replacement for the deprecated symbol, such as the name of a
-function</td>
+<td>the intended replacement for the deprecated symbol,
+such as the name of a function</td>
 </tr></tbody>
 </table></div>
-<p class="since">Since 2.25.3</p>
+<p class="since">Since 2.26</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-GNUC-BEGIN-IGNORE-DEPRECATIONS:CAPS"></a><h3>G_GNUC_BEGIN_IGNORE_DEPRECATIONS</h3>
+<pre class="programlisting">#define             G_GNUC_BEGIN_IGNORE_DEPRECATIONS</pre>
+<p>
+Tells <span class="command"><strong>gcc</strong></span> (if it is a new enough version) to
+temporarily stop emitting warnings when functions marked with
+<a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED"><code class="literal">G_GNUC_DEPRECATED</code></a> or <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED-FOR:CAPS" title="G_GNUC_DEPRECATED_FOR()"><code class="literal">G_GNUC_DEPRECATED_FOR</code></a> are called. This is
+useful for when you have one deprecated function calling another
+one, or when you still have regression tests for deprecated
+functions.
+</p>
+<p>
+Use <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-END-IGNORE-DEPRECATIONS:CAPS" title="G_GNUC_END_IGNORE_DEPRECATIONS"><code class="literal">G_GNUC_END_IGNORE_DEPRECATIONS</code></a> to begin warning again. (If you
+are not compiling with <code class="literal">-Wdeprecated-declarations</code>
+then neither macro has any effect.)
+</p>
+<p>
+This macro can be used either inside or outside of a function body,
+but must appear on a line by itself.
+</p>
+<p class="since">Since 2.32</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-GNUC-END-IGNORE-DEPRECATIONS:CAPS"></a><h3>G_GNUC_END_IGNORE_DEPRECATIONS</h3>
+<pre class="programlisting">#define             G_GNUC_END_IGNORE_DEPRECATIONS</pre>
+<p>
+Undoes the effect of <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-BEGIN-IGNORE-DEPRECATIONS:CAPS" title="G_GNUC_BEGIN_IGNORE_DEPRECATIONS"><code class="literal">G_GNUC_BEGIN_IGNORE_DEPRECATIONS</code></a>, telling
+<span class="command"><strong>gcc</strong></span> to begin outputting warnings again
+(assuming those warnings had been enabled to begin with).
+</p>
+<p>
+This macro can be used either inside or outside of a function body,
+but must appear on a line by itself.
+</p>
+<p class="since">Since 2.32</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="G-GNUC-NORETURN:CAPS"></a><h3>G_GNUC_NORETURN</h3>
 <pre class="programlisting">#define             G_GNUC_NORETURN</pre>
 <p>
-Expands to the GNU C <code class="literal">noreturn</code> function attribute if the
-compiler is <span class="command"><strong>gcc</strong></span>. It is used for declaring functions which never return.
-It enables optimization of the function, and avoids possible compiler
-warnings. See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">noreturn</code> function attribute
+if the compiler is <span class="command"><strong>gcc</strong></span>. It is used for declaring
+functions which never return. It enables optimization of the function,
+and avoids possible compiler warnings.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 </div>
 <hr>
@@ -511,9 +664,35 @@ warnings. See the GNU C documentation for details.
 <a name="G-GNUC-UNUSED:CAPS"></a><h3>G_GNUC_UNUSED</h3>
 <pre class="programlisting">#define             G_GNUC_UNUSED</pre>
 <p>
-Expands to the GNU C <code class="literal">unused</code> function attribute if the compiler is
-<span class="command"><strong>gcc</strong></span>. It is used for declaring functions which may never be used.
-It avoids possible compiler warnings. See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">unused</code> function attribute if
+the compiler is <span class="command"><strong>gcc</strong></span>. It is used for declaring
+functions and arguments which may never be used. It avoids possible compiler
+warnings.
+</p>
+<p>
+For functions, place the attribute after the declaration, just before the
+semicolon. For arguments, place the attribute at the beginning of the
+argument declaration.
+</p>
+<p>
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function">my_unused_function</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS">G_GNUC_UNUSED</a> </span><span class="usertype">gint</span><span class="normal"> unused_argument</span><span class="symbol">,</span>
+<span class="normal">                         </span><span class="usertype">gint</span><span class="normal"> other_argument</span><span class="symbol">)</span><span class="normal"> <a href="glib-Miscellaneous-Macros.html#G-GNUC-UNUSED:CAPS">G_GNUC_UNUSED</a></span><span class="symbol">;</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 </div>
 <hr>
@@ -521,11 +700,20 @@ It avoids possible compiler warnings. See the GNU C documentation for details.
 <a name="G-GNUC-PRINTF:CAPS"></a><h3>G_GNUC_PRINTF()</h3>
 <pre class="programlisting">#define             G_GNUC_PRINTF( format_idx, arg_idx )</pre>
 <p>
-Expands to the GNU C <code class="literal">format</code> function attribute if the compiler is
-<span class="command"><strong>gcc</strong></span>. This is used for declaring functions which take a variable number of
-arguments, with the same syntax as <code class="function"><code class="function">printf()</code></code>.
-It allows the compiler to type-check the arguments passed to the function.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">format</code> function attribute
+if the compiler is <span class="command"><strong>gcc</strong></span>. This is used for declaring
+functions which take a variable number of arguments, with the same
+syntax as <code class="function">printf()</code>. It allows the compiler to type-check the arguments
+passed to the function.
+</p>
+<p>
+Place the attribute after the function declaration, just before the
+semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
+</p>
+<p>
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -544,17 +732,22 @@ See the GNU C documentation for details.
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>format_idx</code></em> :</span></p></td>
-<td>the index of the argument corresponding to the format string.
-(The arguments are numbered from 1).</td>
+<td>the index of the argument corresponding to the
+format string (The arguments are numbered from 1)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>arg_idx</code></em> :</span></p></td>
-<td>the index of the first of the format arguments.</td>
+<td>the index of the first of the format arguments</td>
 </tr>
 </tbody>
 </table></div>
@@ -564,23 +757,26 @@ See the GNU C documentation for details.
 <a name="G-GNUC-SCANF:CAPS"></a><h3>G_GNUC_SCANF()</h3>
 <pre class="programlisting">#define             G_GNUC_SCANF( format_idx, arg_idx )</pre>
 <p>
-Expands to the GNU C <code class="literal">format</code> function attribute if the compiler is <span class="command"><strong>gcc</strong></span>.
-This is used for declaring functions which take a variable number of
-arguments, with the same syntax as <code class="function"><code class="function">scanf()</code></code>.
-It allows the compiler to type-check the arguments passed to the function.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">format</code> function attribute
+if the compiler is <span class="command"><strong>gcc</strong></span>. This is used for declaring
+functions which take a variable number of arguments, with the same
+syntax as <code class="function">scanf()</code>. It allows the compiler to type-check the arguments
+passed to the function. See the GNU C documentation for details.
 </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>format_idx</code></em> :</span></p></td>
-<td>the index of the argument corresponding to the format string.
-(The arguments are numbered from 1).</td>
+<td>the index of the argument corresponding to
+the format string (The arguments are numbered from 1)</td>
 </tr>
 <tr>
 <td><p><span class="term"><em class="parameter"><code>arg_idx</code></em> :</span></p></td>
-<td>the index of the first of the format arguments.</td>
+<td>the index of the first of the format arguments</td>
 </tr>
 </tbody>
 </table></div>
@@ -590,16 +786,23 @@ See the GNU C documentation for details.
 <a name="G-GNUC-FORMAT:CAPS"></a><h3>G_GNUC_FORMAT()</h3>
 <pre class="programlisting">#define             G_GNUC_FORMAT( arg_idx )</pre>
 <p>
-Expands to the GNU C <code class="literal">format_arg</code> function attribute if the compiler is <span class="command"><strong>gcc</strong></span>.
-This function attribute specifies that a function takes a format
-string for a <code class="function"><code class="function">printf()</code></code>, <code class="function"><code class="function">scanf()</code></code>,
-<code class="function"><code class="function">strftime()</code></code> or <code class="function"><code class="function">strfmon()</code></code> style
-function and modifies it, so that the result can be passed to a
-<code class="function"><code class="function">printf()</code></code>, <code class="function"><code class="function">scanf()</code></code>,
-<code class="function"><code class="function">strftime()</code></code> or <code class="function"><code class="function">strfmon()</code></code> style
-function (with the remaining arguments to the format function the same as
-they would have been for the unmodified string).
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">format_arg</code> function attribute
+if the compiler is <span class="command"><strong>gcc</strong></span>. This function attribute
+specifies that a function takes a format string for a <code class="function">printf()</code>,
+<code class="function">scanf()</code>, <code class="function">strftime()</code> or <code class="function">strfmon()</code> style function and modifies it,
+so that the result can be passed to a <code class="function">printf()</code>, <code class="function">scanf()</code>, <code class="function">strftime()</code>
+or <code class="function">strfmon()</code> style function (with the remaining arguments to the
+format function the same as they would have been for the unmodified
+string).
+</p>
+<p>
+Place the attribute after the function declaration, just after the
+semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
+</p>
+<p>
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -612,11 +815,16 @@ See the GNU C documentation for details.
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>arg_idx</code></em> :</span></p></td>
-<td>the index of the argument.</td>
+<td>the index of the argument</td>
 </tr></tbody>
 </table></div>
 </div>
@@ -626,22 +834,35 @@ See the GNU C documentation for details.
 <pre class="programlisting">#define G_GNUC_NULL_TERMINATED __attribute__((__sentinel__))
 </pre>
 <p>
-Expands to the GNU C <code class="literal">sentinel</code> function attribute if the
-compiler is <span class="command"><strong>gcc</strong></span>, or "" if it isn't. This function attribute
-only applies to variadic functions and instructs the compiler to check that
-the argument list is terminated with an explicit <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
-See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">sentinel</code> function attribute
+if the compiler is <span class="command"><strong>gcc</strong></span>, or "" if it isn't. This
+function attribute only applies to variadic functions and instructs
+the compiler to check that the argument list is terminated with an
+explicit <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
-Since: 2.8</div>
+<p class="since">Since 2.8</p>
+</div>
 <hr>
 <div class="refsect2">
 <a name="G-GNUC-WARN-UNUSED-RESULT:CAPS"></a><h3>G_GNUC_WARN_UNUSED_RESULT</h3>
 <pre class="programlisting">#define             G_GNUC_WARN_UNUSED_RESULT</pre>
 <p>
-Expands to the GNU C <code class="literal">warn_unused_result</code> function attribute
-if the compiler is <span class="command"><strong>gcc</strong></span>, or "" if it isn't. This function
-attribute makes the compiler emit a warning if the result of a function call
-is ignored. See the GNU C documentation for details.
+Expands to the GNU C <code class="literal">warn_unused_result</code> function
+attribute if the compiler is <span class="command"><strong>gcc</strong></span>, or "" if it isn't.
+This function attribute makes the compiler emit a warning if the result
+of a function call is ignored.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 <p class="since">Since 2.10</p>
 </div>
@@ -652,11 +873,12 @@ is ignored. See the GNU C documentation for details.
 </pre>
 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Warning</h3>
-<p><code class="literal">G_GNUC_FUNCTION</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="glib-Miscellaneous-Macros.html#G-STRFUNC:CAPS" title="G_STRFUNC"><span class="type">G_STRFUNC</span></a> instead.</p>
+<p><code class="literal">G_GNUC_FUNCTION</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="glib-Miscellaneous-Macros.html#G-STRFUNC:CAPS" title="G_STRFUNC"><span class="type">G_STRFUNC</span></a> instead</p>
 </div>
 <p>
-Expands to "" on all modern compilers, and to <code class="literal">__FUNCTION__</code>
-on <span class="command"><strong>gcc</strong></span> version 2.x. Don't use it.
+Expands to "" on all modern compilers, and to
+<code class="literal">__FUNCTION__</code> on <span class="command"><strong>gcc</strong></span> version 2.x.
+Don't use it.
 </p>
 </div>
 <hr>
@@ -666,12 +888,12 @@ on <span class="command"><strong>gcc</strong></span> version 2.x. Don't use it.
 </pre>
 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Warning</h3>
-<p><code class="literal">G_GNUC_PRETTY_FUNCTION</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="glib-Miscellaneous-Macros.html#G-STRFUNC:CAPS" title="G_STRFUNC"><span class="type">G_STRFUNC</span></a> instead.</p>
+<p><code class="literal">G_GNUC_PRETTY_FUNCTION</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="glib-Miscellaneous-Macros.html#G-STRFUNC:CAPS" title="G_STRFUNC"><span class="type">G_STRFUNC</span></a> instead</p>
 </div>
 <p>
 Expands to "" on all modern compilers, and to
-<code class="literal">__PRETTY_FUNCTION__</code> on <span class="command"><strong>gcc</strong></span> version 2.x.
-Don't use it.
+<code class="literal">__PRETTY_FUNCTION__</code> on <span class="command"><strong>gcc</strong></span>
+version 2.x. Don't use it.
 </p>
 </div>
 <hr>
@@ -681,10 +903,14 @@ Don't use it.
 <p>
 Expands to the GNU C <code class="literal">no_instrument_function</code> function
 attribute if the compiler is <span class="command"><strong>gcc</strong></span>. Functions with this
-attribute will not be
-instrumented for profiling, when the compiler is called with the
-<code class="option">-finstrument-functions</code> option.
-See the GNU C documentation for details.
+attribute will not be instrumented for profiling, when the compiler is
+called with the <code class="option">-finstrument-functions</code> option.
+</p>
+<p>
+Place the attribute after the declaration, just before the semicolon.
+</p>
+<p>
+See the GNU C documentation for more details.
 </p>
 </div>
 <hr>
@@ -692,8 +918,6 @@ See the GNU C documentation for details.
 <a name="G-HAVE-GNUC-VISIBILITY:CAPS"></a><h3>G_HAVE_GNUC_VISIBILITY</h3>
 <pre class="programlisting">#define G_HAVE_GNUC_VISIBILITY 1
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -703,9 +927,9 @@ See the GNU C documentation for details.
 <p>
 This attribute can be used for marking library functions as being used
 internally to the library only, which may allow the compiler to handle
-function calls more efficiently.
-Note that static functions do not need to be marked as internal in this way.
-See the GNU C documentation for details.
+function calls more efficiently. Note that static functions do not need
+to be marked as internal in this way. See the GNU C documentation for
+details.
 </p>
 <p>
 When using a compiler that supports the GNU C hidden visibility attribute,
@@ -717,6 +941,8 @@ Note that for portability, the attribute should be placed before the
 function declaration. While GCC allows the macro after the declaration,
 Sun Studio does not.
 </p>
+<p>
+</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -736,7 +962,10 @@ Sun Studio does not.
   </table>
 </div>
-Since: 2.6</div>
+<p>
+</p>
+<p class="since">Since 2.6</p>
+</div>
 <hr>
 <div class="refsect2">
 <a name="G-GNUC-MAY-ALIAS:CAPS"></a><h3>G_GNUC_MAY_ALIAS</h3>
@@ -749,15 +978,82 @@ will not be subjected to type-based alias analysis, but are assumed
 to alias with any other type, just like char.
 See the GNU C documentation for details.
 </p>
-Since: 2.14</div>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-DEPRECATED:CAPS"></a><h3>G_DEPRECATED</h3>
+<pre class="programlisting">#define G_DEPRECATED __attribute__((__deprecated__))
+</pre>
+<p>
+This macro is similar to <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED"><code class="literal">G_GNUC_DEPRECATED</code></a>, and can be used to mark
+functions declarations as deprecated. Unlike <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED:CAPS" title="G_GNUC_DEPRECATED"><code class="literal">G_GNUC_DEPRECATED</code></a>, it is
+meant to be portable across different compilers and must be placed
+before the function declaration.
+</p>
+<p class="since">Since 2.32</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-DEPRECATED-FOR:CAPS"></a><h3>G_DEPRECATED_FOR()</h3>
+<pre class="programlisting">#define G_DEPRECATED_FOR(f) __attribute__((__deprecated__("Use '" #f "' instead")))
+</pre>
+<p>
+This macro is similar to <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED-FOR:CAPS" title="G_GNUC_DEPRECATED_FOR()"><code class="literal">G_GNUC_DEPRECATED_FOR</code></a>, and can be used to mark
+functions declarations as deprecated. Unlike <a class="link" href="glib-Miscellaneous-Macros.html#G-GNUC-DEPRECATED-FOR:CAPS" title="G_GNUC_DEPRECATED_FOR()"><code class="literal">G_GNUC_DEPRECATED_FOR</code></a>, it is
+meant to be portable across different compilers and must be placed
+before the function declaration.
+</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>f</code></em> :</span></p></td>
+<td>the name of the function that this function was deprecated for</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.32</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="G-UNAVAILABLE:CAPS"></a><h3>G_UNAVAILABLE()</h3>
+<pre class="programlisting">#define G_UNAVAILABLE(maj,min) __attribute__((deprecated("Not available before " #maj "." #min)))
+</pre>
+<p>
+This macro can be used to mark a function declaration as unavailable.
+It must be placed before the function declaration. Use of a function
+that has been annotated with this macros will produce a compiler warning.
+</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>maj</code></em> :</span></p></td>
+<td>the major version that introduced the symbol</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
+<td>the minor version that introduced the symbol</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.32</p>
+</div>
 <hr>
 <div class="refsect2">
 <a name="G-LIKELY:CAPS"></a><h3>G_LIKELY()</h3>
 <pre class="programlisting">#define G_LIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 1))
 </pre>
 <p>
-Hints the compiler that the expression is likely to evaluate to a true
-value. The compiler may use this information for optimizations.
+Hints the compiler that the expression is likely to evaluate to
+a true value. The compiler may use this information for optimizations.
+</p>
+<p>
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -772,8 +1068,13 @@ value. The compiler may use this information for optimizations.
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>expr</code></em> :</span></p></td>
@@ -794,8 +1095,10 @@ value. The compiler may use this information for optimizations.
 <pre class="programlisting">#define G_UNLIKELY(expr) (__builtin_expect (_G_BOOLEAN_EXPR(expr), 0))
 </pre>
 <p>
-Hints the compiler that the expression is unlikely to evaluate to a true
-value. The compiler may use this information for optimizations.
+Hints the compiler that the expression is unlikely to evaluate to
+a true value. The compiler may use this information for optimizations.
+</p>
+<p>
 </p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -810,8 +1113,13 @@ value. The compiler may use this information for optimizations.
   </table>
 </div>
-<div class="variablelist"><table border="0">
+<p>
+</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>expr</code></em> :</span></p></td>
@@ -845,267 +1153,10 @@ Expands to a string identifying the current function.
 </p>
 <p class="since">Since 2.4</p>
 </div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT16-MODIFIER:CAPS"></a><h3>G_GINT16_MODIFIER</h3>
-<pre class="programlisting">#define G_GINT16_MODIFIER "h"
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a> or <a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a>. It is a string literal,
-but doesn't include the percent-sign, such that you can add precision and
-length modifiers between percent-sign and conversion specifier and append a
-conversion specifier.
-</p>
-<p>
-The following example prints "0x7b";
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gint16</span><span class="normal"> value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">123</span><span class="symbol">;</span>
-<span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%#"</span><span class="normal"> <a href="glib-Miscellaneous-Macros.html#G-GINT16-MODIFIER:CAPS">G_GINT16_MODIFIER</a> </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> value</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-<p class="since">Since 2.4</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT16-FORMAT:CAPS"></a><h3>G_GINT16_FORMAT</h3>
-<pre class="programlisting">#define G_GINT16_FORMAT "hi"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a>. It is a string literal, but doesn't
-include the percent-sign, such that you can add precision and length
-modifiers between percent-sign and conversion specifier.
-</p>
-<p>
-</p>
-<div class="informalexample">
-  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
-    <tbody>
-      <tr>
-        <td class="listing_lines" align="right"><pre>1
-2
-3
-4
-5</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gint16</span><span class="normal"> in</span><span class="symbol">;</span>
-<span class="usertype">gint32</span><span class="normal"> out</span><span class="symbol">;</span>
-<span class="function">sscanf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"42"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"%"</span><span class="normal"> <a href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS">G_GINT16_FORMAT</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">in</span><span class="symbol">)</span>
-<span class="normal">out </span><span class="symbol">=</span><span class="normal"> in </span><span class="symbol">*</span><span class="normal"> </span><span class="number">1000</span><span class="symbol">;</span>
-<span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"%"</span><span class="normal"> <a href="glib-Miscellaneous-Macros.html#G-GINT32-FORMAT:CAPS">G_GINT32_FORMAT</a></span><span class="symbol">,</span><span class="normal"> out</span><span class="symbol">);</span></pre></td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-<p>
-</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GUINT16-FORMAT:CAPS"></a><h3>G_GUINT16_FORMAT</h3>
-<pre class="programlisting">#define G_GUINT16_FORMAT "hu"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT32-MODIFIER:CAPS"></a><h3>G_GINT32_MODIFIER</h3>
-<pre class="programlisting">#define G_GINT32_MODIFIER ""
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> or <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a>. It is a string literal,
-See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-MODIFIER:CAPS" title="G_GINT16_MODIFIER"><span class="type">G_GINT16_MODIFIER</span></a>.
-</p>
-<p class="since">Since 2.4</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT32-FORMAT:CAPS"></a><h3>G_GINT32_FORMAT</h3>
-<pre class="programlisting">#define G_GINT32_FORMAT "i"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GUINT32-FORMAT:CAPS"></a><h3>G_GUINT32_FORMAT</h3>
-<pre class="programlisting">#define G_GUINT32_FORMAT "u"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT64-MODIFIER:CAPS"></a><h3>G_GINT64_MODIFIER</h3>
-<pre class="programlisting">#define G_GINT64_MODIFIER "l"
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> or <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a>. It is a string literal.
-</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>
-Some platforms do not support printing 64 bit integers,
-even though the types are supported. On such platforms <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-MODIFIER:CAPS" title="G_GINT64_MODIFIER"><span class="type">G_GINT64_MODIFIER</span></a>
-is not defined.
-</p>
-</div>
-<p class="since">Since 2.4</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINT64-FORMAT:CAPS"></a><h3>G_GINT64_FORMAT</h3>
-<pre class="programlisting">#define G_GINT64_FORMAT "li"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>
-Some platforms do not support scanning and printing 64 bit integers,
-even though the types are supported. On such platforms <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-FORMAT:CAPS" title="G_GINT64_FORMAT"><span class="type">G_GINT64_FORMAT</span></a>
-is not defined. Note that <code class="function">scanf()</code> may not support 64 bit integers, even
-if <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-FORMAT:CAPS" title="G_GINT64_FORMAT"><span class="type">G_GINT64_FORMAT</span></a> is defined. Due to its weak error handling, <code class="function">scanf()</code>
-is not recommended for parsing anyway; consider using <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtoull" title="g_ascii_strtoull ()"><code class="function">g_ascii_strtoull()</code></a>
-instead.
-</p>
-</div>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GUINT64-FORMAT:CAPS"></a><h3>G_GUINT64_FORMAT</h3>
-<pre class="programlisting">#define G_GUINT64_FORMAT "lu"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>
-Some platforms do not support scanning and printing 64 bit integers,
-even though the types are supported. On such platforms <a class="link" href="glib-Miscellaneous-Macros.html#G-GUINT64-FORMAT:CAPS" title="G_GUINT64_FORMAT"><span class="type">G_GUINT64_FORMAT</span></a>
-is not defined.  Note that <code class="function">scanf()</code> may not support 64 bit integers, even
-if <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-FORMAT:CAPS" title="G_GINT64_FORMAT"><span class="type">G_GINT64_FORMAT</span></a> is defined. Due to its weak error handling, <code class="function">scanf()</code> is not
-recommended for parsing anyway; consider using <code class="function">g_strtoull()</code> instead.
-</p>
-</div>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GSIZE-MODIFIER:CAPS"></a><h3>G_GSIZE_MODIFIER</h3>
-<pre class="programlisting">#define G_GSIZE_MODIFIER "l"
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> or <a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a>. It is a string literal,
-</p>
-<p class="since">Since 2.6</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GSIZE-FORMAT:CAPS"></a><h3>G_GSIZE_FORMAT</h3>
-<pre class="programlisting">#define G_GSIZE_FORMAT "lu"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-<p class="since">Since 2.6</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GSSIZE-FORMAT:CAPS"></a><h3>G_GSSIZE_FORMAT</h3>
-<pre class="programlisting">#define G_GSSIZE_FORMAT "li"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT16-FORMAT:CAPS" title="G_GINT16_FORMAT"><span class="type">G_GINT16_FORMAT</span></a>.
-</p>
-<p class="since">Since 2.6</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GOFFSET-MODIFIER:CAPS"></a><h3>G_GOFFSET_MODIFIER</h3>
-<pre class="programlisting">#define G_GOFFSET_MODIFIER      G_GINT64_MODIFIER
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#goffset" title="goffset"><span class="type">goffset</span></a>. It is a string literal. See also
-<a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-MODIFIER:CAPS" title="G_GINT64_MODIFIER"><span class="type">G_GINT64_MODIFIER</span></a>.
-</p>
-<p class="since">Since 2.20</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GOFFSET-FORMAT:CAPS"></a><h3>G_GOFFSET_FORMAT</h3>
-<pre class="programlisting">#define G_GOFFSET_FORMAT        G_GINT64_FORMAT
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#goffset" title="goffset"><span class="type">goffset</span></a>. See also <a class="link" href="glib-Miscellaneous-Macros.html#G-GINT64-FORMAT:CAPS" title="G_GINT64_FORMAT"><span class="type">G_GINT64_FORMAT</span></a>.
-</p>
-Since: 2.20</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINTPTR-MODIFIER:CAPS"></a><h3>G_GINTPTR_MODIFIER</h3>
-<pre class="programlisting">#define G_GINTPTR_MODIFIER      "l"
-</pre>
-<p>
-The platform dependent length modifier for conversion specifiers for scanning
-and printing values of type <a class="link" href="glib-Basic-Types.html#gintptr" title="gintptr"><span class="type">gintptr</span></a> or <a class="link" href="glib-Basic-Types.html#guintptr" title="guintptr"><span class="type">guintptr</span></a>. It is a string literal.
-</p>
-<p class="since">Since 2.22</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GINTPTR-FORMAT:CAPS"></a><h3>G_GINTPTR_FORMAT</h3>
-<pre class="programlisting">#define G_GINTPTR_FORMAT        "li"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#gintptr" title="gintptr"><span class="type">gintptr</span></a>.
-</p>
-<p class="since">Since 2.22</p>
-</div>
-<hr>
-<div class="refsect2">
-<a name="G-GUINTPTR-FORMAT:CAPS"></a><h3>G_GUINTPTR_FORMAT</h3>
-<pre class="programlisting">#define G_GUINTPTR_FORMAT       "lu"
-</pre>
-<p>
-This is the platform dependent conversion specifier for scanning and
-printing values of type <a class="link" href="glib-Basic-Types.html#guintptr" title="guintptr"><span class="type">guintptr</span></a>.
-</p>
-<p class="since">Since 2.22</p>
-</div>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.17</div>
+          Generated by GTK-Doc V1.18</div>
 </body>
 </html>