RubyGems - glib2 - Versions diffs - 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32 - Mend

glib2 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32

Files changed (927) hide show

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

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-Arrays.html" title="Arrays">
 <link rel="next" href="glib-Byte-Arrays.html" title="Byte Arrays">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -232,7 +232,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Pointer-Arrays.includes"></a><h2>Includes</h2>
-<pre class="synopsis">#include &lt;glib.h&gt;
+<pre class="synopsis">#include &lt;gmodule.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -271,21 +271,21 @@ elements while iterating over the array.</p>
 13
 14
 15</pre></td>
-        <td class="listing_code"><pre class="programlisting">GPtrArray <span class="gtkdoc opt">*</span>array<span class="gtkdoc opt">;</span>
-gchar <span class="gtkdoc opt">*</span>string1 <span class="gtkdoc opt">=</span> <span class="string">&quot;one&quot;</span><span class="gtkdoc opt">;</span>
-gchar <span class="gtkdoc opt">*</span>string2 <span class="gtkdoc opt">=</span> <span class="string">&quot;two&quot;</span><span class="gtkdoc opt">;</span>
-gchar <span class="gtkdoc opt">*</span>string3 <span class="gtkdoc opt">=</span> <span class="string">&quot;three&quot;</span><span class="gtkdoc opt">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GPtrArray</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">array</span><span class="symbol">;</span>
+<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">string1 </span><span class="symbol">=</span><span class="normal"> </span><span class="string">"one"</span><span class="symbol">;</span>
+<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">string2 </span><span class="symbol">=</span><span class="normal"> </span><span class="string">"two"</span><span class="symbol">;</span>
+<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">string3 </span><span class="symbol">=</span><span class="normal"> </span><span class="string">"three"</span><span class="symbol">;</span>
-array <span class="gtkdoc opt">=</span> <span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-new">g_ptr_array_new</a></span> <span class="gtkdoc opt">();</span>
-<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>gpointer<span class="gtkdoc opt">)</span> string1<span class="gtkdoc opt">);</span>
-<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>gpointer<span class="gtkdoc opt">)</span> string2<span class="gtkdoc opt">);</span>
-<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>gpointer<span class="gtkdoc opt">)</span> string3<span class="gtkdoc opt">);</span>
+<span class="normal">array </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-new">g_ptr_array_new</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span><span class="symbol">)</span><span class="normal"> string1</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span><span class="symbol">)</span><span class="normal"> string2</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span><span class="symbol">)</span><span class="normal"> string3</span><span class="symbol">);</span>
-<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">) != (</span>gpointer<span class="gtkdoc opt">)</span> string1<span class="gtkdoc opt">)</span>
-  <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;ERROR: got %p instead of %p</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">,</span>
-           <span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">),</span> string1<span class="gtkdoc opt">);</span>
+<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">!=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span><span class="symbol">)</span><span class="normal"> string1</span><span class="symbol">)</span>
+<span class="normal">  </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">"ERROR: got %p instead of %p</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span>
+<span class="normal">           </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">),</span><span class="normal"> string1</span><span class="symbol">);</span>
-<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-free">g_ptr_array_free</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">);</span></pre></td>
+<span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-free">g_ptr_array_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -356,7 +356,7 @@ either via <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-unref" tit
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>element_free_func</p></td>
-<td class="parameter_description"><p> A function to free elements with
+<td class="parameter_description"><p>A function to free elements with
 destroy <em class="parameter"><code>array</code></em>
 or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
@@ -401,7 +401,7 @@ for freeing each element when the array is destroyed either via
 </tr>
 <tr>
 <td class="parameter_name"><p>element_free_func</p></td>
-<td class="parameter_description"><p> A function to free elements with
+<td class="parameter_description"><p>A function to free elements with
 destroy <em class="parameter"><code>array</code></em>
 or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
@@ -442,7 +442,7 @@ with <em class="parameter"><code>free_segment</code></em>
 </tr>
 <tr>
 <td class="parameter_name"><p>element_free_func</p></td>
-<td class="parameter_description"><p> A function to free elements with
+<td class="parameter_description"><p>A function to free elements with
 destroy <em class="parameter"><code>array</code></em>
 or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
@@ -992,7 +992,9 @@ The pointer array should be freed using <a class="link" href="glib-Memory-Alloca
 g_ptr_array_foreach (<em class="parameter"><code><a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a> *array</code></em>,
                      <em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="type">GFunc</span></a> func</code></em>,
                      <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
-<p>Calls a function for each element of a <a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a>.</p>
+<p>Calls a function for each element of a <a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a>. <em class="parameter"><code>func</code></em>
+ must not
+add elements to or remove elements from the array.</p>
 <div class="refsect3">
 <a name="g-ptr-array-foreach.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1063,7 +1065,7 @@ checks, such as string comparisons, use <a class="link" href="glib-Pointer-Array
 </tr>
 <tr>
 <td class="parameter_name"><p>index_</p></td>
-<td class="parameter_description"><p> return location for the index of
+<td class="parameter_description"><p>return location for the index of
 the element, if found. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
 </tr>
@@ -1126,14 +1128,14 @@ equality is used.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>equal_func</p></td>
-<td class="parameter_description"><p> the function to call for each element, which should
+<td class="parameter_description"><p>the function to call for each element, which should
 return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> when the desired element is found; or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use pointer
 equality. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>index_</p></td>
-<td class="parameter_description"><p> return location for the index of
+<td class="parameter_description"><p>return location for the index of
 the element, if found. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
 </tr>
@@ -1186,6 +1188,6 @@ array grows</p></td>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-N-ary-Trees.html" title="N-ary Trees">
 <link rel="next" href="glib-Keyed-Data-Lists.html" title="Keyed Data Lists">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -109,7 +109,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Quarks.includes"></a><h2>Includes</h2>
-<pre class="synopsis">#include &lt;glib.h&gt;
+<pre class="synopsis">#include &lt;gmodule.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -186,7 +186,7 @@ using a copy of the string.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>string</p></td>
-<td class="parameter_description"><p> a string. </p></td>
+<td class="parameter_description"><p>a string. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -223,7 +223,7 @@ function in GTK+ theme engines).</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>string</p></td>
-<td class="parameter_description"><p> a string. </p></td>
+<td class="parameter_description"><p>a string. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -279,7 +279,7 @@ use <a class="link" href="glib-Quarks.html#g-quark-from-string" title="g_quark_f
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>string</p></td>
-<td class="parameter_description"><p> a string. </p></td>
+<td class="parameter_description"><p>a string. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -310,7 +310,7 @@ using <code class="function">strcmp()</code>.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>string</p></td>
-<td class="parameter_description"><p> a string. </p></td>
+<td class="parameter_description"><p>a string. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -342,7 +342,7 @@ therefore <em class="parameter"><code>string</code></em>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>string</p></td>
-<td class="parameter_description"><p> a static string. </p></td>
+<td class="parameter_description"><p>a static string. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -366,6 +366,6 @@ particular string. A GQuark value of zero is associated to <a class="link" href=
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-GDateTime.html" title="GDateTime">
 <link rel="next" href="glib-Hook-Functions.html" title="Hook Functions">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -195,7 +195,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Random-Numbers.includes"></a><h2>Includes</h2>
-<pre class="synopsis">#include &lt;glib.h&gt;
+<pre class="synopsis">#include &lt;gmodule.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -755,6 +755,6 @@ accessed through the g_rand_* functions.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="deprecated.html" title="Deprecated APIs">
 <link rel="prev" href="glib-Caches.html" title="Caches">
 <link rel="next" href="glib-Automatic-String-Completion.html" title="Automatic String Completion">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -152,7 +152,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Relations-and-Tuples.includes"></a><h2>Includes</h2>
-<pre class="synopsis">#include &lt;glib.h&gt;
+<pre class="synopsis">#include &lt;gmodule.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -648,6 +648,6 @@ records, you must use <a class="link" href="glib-Relations-and-Tuples.html#g-tup
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

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

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-Double-ended-Queues.html" title="Double-ended Queues">
 <link rel="next" href="glib-Trash-Stacks.html" title="Trash Stacks">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -375,7 +375,7 @@
 </div>
 <div class="refsect1">
 <a name="glib-Sequences.includes"></a><h2>Includes</h2>
-<pre class="synopsis">#include &lt;glib.h&gt;
+<pre class="synopsis">#include &lt;gmodule.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -409,6 +409,11 @@ Even moving an element to another sequence using for example
 <a class="link" href="glib-Sequences.html#g-sequence-move-range" title="g_sequence_move_range ()"><code class="function">g_sequence_move_range()</code></a> will not invalidate the iterators pointing
 to it. The only operation that will invalidate an iterator is when
 the element it points to is removed from any sequence.</p>
+<p>To sort the data, either use <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()"><code class="function">g_sequence_insert_sorted()</code></a> or
+<a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()"><code class="function">g_sequence_insert_sorted_iter()</code></a> to add data to the <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> or, if
+you want to add a large amount of data, it is more efficient to call
+<a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> or <a class="link" href="glib-Sequences.html#g-sequence-sort-iter" title="g_sequence_sort_iter ()"><code class="function">g_sequence_sort_iter()</code></a> after doing unsorted
+insertions.</p>
 </div>
 <div class="refsect1">
 <a name="glib-Sequences.functions_details"></a><h2>Functions</h2>
@@ -480,14 +485,14 @@ are removed from the sequence.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>data_destroy</p></td>
-<td class="parameter_description"><p> a <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> function, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. </p></td>
+<td class="parameter_description"><p>a <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> function, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
 </div>
 <div class="refsect3">
 <a name="g-sequence-new.returns"></a><h4>Returns</h4>
-<p> a new <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>. </p>
+<p>a new <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -591,7 +596,8 @@ g_sequence_foreach (<em class="parameter"><code><a class="link" href="glib-Seque
 <p>Calls <em class="parameter"><code>func</code></em>
  for each item in the sequence passing <em class="parameter"><code>user_data</code></em>
-to the function.</p>
+to the function. <em class="parameter"><code>func</code></em>
+ must not modify the sequence itself.</p>
 <div class="refsect3">
 <a name="g-sequence-foreach.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -636,7 +642,9 @@ g_sequence_foreach_range (<em class="parameter"><code><a class="link" href="glib
 , <em class="parameter"><code>end</code></em>
 ) passing
 <em class="parameter"><code>user_data</code></em>
- to the function.</p>
+ to the function. <em class="parameter"><code>func</code></em>
+ must not modify the sequence
+itself.</p>
 <div class="refsect3">
 <a name="g-sequence-foreach-range.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -787,7 +795,7 @@ g_sequence_get_begin_iter (<em class="parameter"><code><a class="link" href="gli
 </div>
 <div class="refsect3">
 <a name="g-sequence-get-begin-iter.returns"></a><h4>Returns</h4>
-<p> the begin iterator for <em class="parameter"><code>seq</code></em>
+<p>the begin iterator for <em class="parameter"><code>seq</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -817,7 +825,7 @@ g_sequence_get_end_iter (<em class="parameter"><code><a class="link" href="glib-
 </div>
 <div class="refsect3">
 <a name="g-sequence-get-end-iter.returns"></a><h4>Returns</h4>
-<p> the end iterator for <em class="parameter"><code>seq</code></em>
+<p>the end iterator for <em class="parameter"><code>seq</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -859,7 +867,7 @@ than the number of items in <em class="parameter"><code>seq</code></em>
 </div>
 <div class="refsect3">
 <a name="g-sequence-get-iter-at-pos.returns"></a><h4>Returns</h4>
-<p> The <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> at position <em class="parameter"><code>pos</code></em>
+<p>The <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> at position <em class="parameter"><code>pos</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -897,7 +905,7 @@ g_sequence_append (<em class="parameter"><code><a class="link" href="glib-Sequen
 </div>
 <div class="refsect3">
 <a name="g-sequence-append.returns"></a><h4>Returns</h4>
-<p> an iterator pointing to the new item. </p>
+<p>an iterator pointing to the new item. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -934,7 +942,7 @@ g_sequence_prepend (<em class="parameter"><code><a class="link" href="glib-Seque
 </div>
 <div class="refsect3">
 <a name="g-sequence-prepend.returns"></a><h4>Returns</h4>
-<p> an iterator pointing to the new item. </p>
+<p>an iterator pointing to the new item. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -971,7 +979,7 @@ g_sequence_insert_before (<em class="parameter"><code><a class="link" href="glib
 </div>
 <div class="refsect3">
 <a name="g-sequence-insert-before.returns"></a><h4>Returns</h4>
-<p> an iterator pointing to the new item. </p>
+<p>an iterator pointing to the new item. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -1076,6 +1084,9 @@ otherwise the new position of <em class="parameter"><code>data</code></em>
 It should return 0 if the items are equal, a negative value
 if the first item comes before the second, and a positive value
 if the second  item comes before the first.</p>
+<p>Note that when adding a large amount of data to a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>,
+it is more efficient to do unsorted insertions and then call
+<a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> or <a class="link" href="glib-Sequences.html#g-sequence-sort-iter" title="g_sequence_sort_iter ()"><code class="function">g_sequence_sort_iter()</code></a>.</p>
 <div class="refsect3">
 <a name="g-sequence-insert-sorted.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1111,7 +1122,7 @@ if the second  item comes before the first.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-insert-sorted.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the new item. </p>
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the new item. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -1138,6 +1149,9 @@ positive value if the second iterator comes before the first.</p>
 return 0 if the iterators are equal, a negative value if the
 first iterator comes before the second, and a positive value
 if the second iterator comes before the first.</p>
+<p>Note that when adding a large amount of data to a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>,
+it is more efficient to do unsorted insertions and then call
+<a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> or <a class="link" href="glib-Sequences.html#g-sequence-sort-iter" title="g_sequence_sort_iter ()"><code class="function">g_sequence_sort_iter()</code></a>.</p>
 <div class="refsect3">
 <a name="g-sequence-insert-sorted-iter.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1173,7 +1187,7 @@ if the second iterator comes before the first.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-insert-sorted-iter.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the new item. </p>
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the new item. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
@@ -1416,10 +1430,7 @@ the second item comes before the first.</p>
 <p>If you are simply searching for an existing element of the sequence,
 consider using <a class="link" href="glib-Sequences.html#g-sequence-lookup" title="g_sequence_lookup ()"><code class="function">g_sequence_lookup()</code></a>.</p>
 <p>This function will fail if the data contained in the sequence is
-unsorted.  Use <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()"><code class="function">g_sequence_insert_sorted()</code></a> or
-<a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()"><code class="function">g_sequence_insert_sorted_iter()</code></a> to add data to your sequence or, if
-you want to add a large amount of data, call <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> after
-doing unsorted insertions.</p>
+unsorted.</p>
 <div class="refsect3">
 <a name="g-sequence-search.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1455,7 +1466,7 @@ doing unsorted insertions.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-search.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position where <em class="parameter"><code>data</code></em>
+<p>an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position where <em class="parameter"><code>data</code></em>
 would have been inserted according to <em class="parameter"><code>cmp_func</code></em>
 and <em class="parameter"><code>cmp_data</code></em>
 . </p>
@@ -1482,10 +1493,7 @@ value if the second iterator comes before the first.</p>
 <p>If you are simply searching for an existing element of the sequence,
 consider using <a class="link" href="glib-Sequences.html#g-sequence-lookup-iter" title="g_sequence_lookup_iter ()"><code class="function">g_sequence_lookup_iter()</code></a>.</p>
 <p>This function will fail if the data contained in the sequence is
-unsorted.  Use <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()"><code class="function">g_sequence_insert_sorted()</code></a> or
-<a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()"><code class="function">g_sequence_insert_sorted_iter()</code></a> to add data to your sequence or, if
-you want to add a large amount of data, call <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> after
-doing unsorted insertions.</p>
+unsorted.</p>
 <div class="refsect3">
 <a name="g-sequence-search-iter.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1521,7 +1529,7 @@ doing unsorted insertions.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-search-iter.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position in <em class="parameter"><code>seq</code></em>
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position in <em class="parameter"><code>seq</code></em>
 where <em class="parameter"><code>data</code></em>
 would have been inserted according to <em class="parameter"><code>iter_cmp</code></em>
 and <em class="parameter"><code>cmp_data</code></em>
@@ -1554,10 +1562,7 @@ It should return 0 if the items are equal, a negative value if
 the first item comes before the second, and a positive value if
 the second item comes before the first.</p>
 <p>This function will fail if the data contained in the sequence is
-unsorted.  Use <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()"><code class="function">g_sequence_insert_sorted()</code></a> or
-<a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()"><code class="function">g_sequence_insert_sorted_iter()</code></a> to add data to your sequence or, if
-you want to add a large amount of data, call <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> after
-doing unsorted insertions.</p>
+unsorted.</p>
 <div class="refsect3">
 <a name="g-sequence-lookup.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1593,7 +1598,7 @@ doing unsorted insertions.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-lookup.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position of the
+<p>an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position of the
 first item found equal to <em class="parameter"><code>data</code></em>
 according to <em class="parameter"><code>cmp_func</code></em>
 and
@@ -1620,10 +1625,7 @@ It should return 0 if the iterators are equal, a negative value
 if the first iterator comes before the second, and a positive
 value if the second iterator comes before the first.</p>
 <p>This function will fail if the data contained in the sequence is
-unsorted.  Use <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()"><code class="function">g_sequence_insert_sorted()</code></a> or
-<a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()"><code class="function">g_sequence_insert_sorted_iter()</code></a> to add data to your sequence or, if
-you want to add a large amount of data, call <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a> after
-doing unsorted insertions.</p>
+unsorted.</p>
 <div class="refsect3">
 <a name="g-sequence-lookup-iter.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1659,7 +1661,7 @@ doing unsorted insertions.</p>
 </div>
 <div class="refsect3">
 <a name="g-sequence-lookup-iter.returns"></a><h4>Returns</h4>
-<p> an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position of
+<p>an <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position of
 the first item found equal to <em class="parameter"><code>data</code></em>
 according to <em class="parameter"><code>cmp_func</code></em>
 and <em class="parameter"><code>cmp_data</code></em>
@@ -1692,7 +1694,7 @@ g_sequence_get (<em class="parameter"><code><a class="link" href="glib-Sequences
 </div>
 <div class="refsect3">
 <a name="g-sequence-get.returns"></a><h4>Returns</h4>
-<p> the data that <em class="parameter"><code>iter</code></em>
+<p>the data that <em class="parameter"><code>iter</code></em>
 points to. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -1818,7 +1820,7 @@ If <em class="parameter"><code>iter</code></em>
 </div>
 <div class="refsect3">
 <a name="g-sequence-iter-next.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the next position after <em class="parameter"><code>iter</code></em>
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the next position after <em class="parameter"><code>iter</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -1850,7 +1852,7 @@ If <em class="parameter"><code>iter</code></em>
 </div>
 <div class="refsect3">
 <a name="g-sequence-iter-prev.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the previous position
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the previous position
 before <em class="parameter"><code>iter</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@@ -1928,7 +1930,7 @@ the returned <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSe
 </div>
 <div class="refsect3">
 <a name="g-sequence-iter-move.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em>
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em>
 positions away from <em class="parameter"><code>iter</code></em>
 . </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@@ -1959,7 +1961,7 @@ g_sequence_iter_get_sequence (<em class="parameter"><code><a class="link" href="
 </div>
 <div class="refsect3">
 <a name="g-sequence-iter-get-sequence.returns"></a><h4>Returns</h4>
-<p> the <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em>
+<p>the <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em>
 points into. </p>
 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
@@ -2054,7 +2056,7 @@ and <em class="parameter"><code>begin</code></em>
 </div>
 <div class="refsect3">
 <a name="g-sequence-range-get-midpoint.returns"></a><h4>Returns</h4>
-<p> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing somewhere in the
+<p>a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing somewhere in the
 (<em class="parameter"><code>begin</code></em>
 , <em class="parameter"><code>end</code></em>
 ) range. </p>
@@ -2082,6 +2084,6 @@ iterator pointing into a <a class="link" href="glib-Sequences.html#GSequence" ti
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>