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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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>