glib2 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32

data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html

@@ -503,9 +503,11 @@ or when displaying an application's name in the task list.</p>
 g_get_prgname (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>Gets the name of the program. This name should not be localized,
 in contrast to <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-application-name" title="g_get_application_name ()"><code class="function">g_get_application_name()</code></a>.</p>
-<p>If you are using GDK or GTK+ the program name is set in <code class="function">gdk_init()</code>, 
-which is called by <a href="../gtk4/gtk4-General.html#gtk-init"><code class="function">gtk_init()</code></a>. The program name is found by taking 
-the last component of <em class="parameter"><code>argv</code></em>
+<p>If you are using <a href="../gio/GApplication.html#GApplication-struct"><span class="type">GApplication</span></a> the program name is set in
+<a href="../gio/GApplication.html#g-application-run"><code class="function">g_application_run()</code></a>. In case of GDK or GTK+ it is set in
+<code class="function">gdk_init()</code>, which is called by <a href="../gtk4/gtk4-General.html#gtk-init"><code class="function">gtk_init()</code></a> and the
+<span class="type">“startup”</span> handler. The program name is found by
+taking the last component of <em class="parameter"><code>argv</code></em>
 [0].</p>
 <div class="refsect3">
 <a name="g-get-prgname.returns"></a><h4>Returns</h4>
@@ -520,6 +522,12 @@ to GLib and must not be modified or freed.</p>
 g_set_prgname (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *prgname</code></em>);</pre>
 <p>Sets the name of the program. This name should not be localized,
 in contrast to <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-set-application-name" title="g_set_application_name ()"><code class="function">g_set_application_name()</code></a>.</p>
+<p>If you are using <a href="../gio/GApplication.html#GApplication-struct"><span class="type">GApplication</span></a> the program name is set in
+<a href="../gio/GApplication.html#g-application-run"><code class="function">g_application_run()</code></a>. In case of GDK or GTK+ it is set in
+<code class="function">gdk_init()</code>, which is called by <a href="../gtk4/gtk4-General.html#gtk-init"><code class="function">gtk_init()</code></a> and the
+<span class="type">“startup”</span> handler. The program name is found by
+taking the last component of <em class="parameter"><code>argv</code></em>
+[0].</p>
 <p>Note that for thread-safety reasons this function can only be called once.</p>
 <div class="refsect3">
 <a name="g-set-prgname.parameters"></a><h4>Parameters</h4>
@@ -888,11 +896,12 @@ data specific to particular user.</p>
 <p>On UNIX platforms this is determined using the mechanisms described
 in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
-In this case the directory retrieved will be XDG_CACHE_HOME.</p>
-<p>On Windows is the directory that serves as a common repository for
-temporary Internet files. A typical path is
-C:\Documents and Settings\username\Local Settings\Temporary Internet Files.
-See documentation for CSIDL_INTERNET_CACHE.</p>
+In this case the directory retrieved will be <code class="literal">XDG_CACHE_HOME</code>.</p>
+<p>On Windows it follows XDG Base Directory Specification if <code class="literal">XDG_CACHE_HOME</code> is defined.
+If <code class="literal">XDG_CACHE_HOME</code> is undefined, the directory that serves as a common
+repository for temporary Internet files is used instead. A typical path is
+<code class="literal">C:\Documents and Settings\username\Local Settings\Temporary Internet Files</code>.
+See the <a class="ulink" href="https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_internet_cache" target="_top">documentation for <code class="literal">CSIDL_INTERNET_CACHE</code></a>.</p>
 <div class="refsect3">
 <a name="g-get-user-cache-dir.returns"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
@@ -912,10 +921,12 @@ as icons that is customized for a particular user.  </p>
 in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
 In this case the directory retrieved will be <code class="literal">XDG_DATA_HOME</code>.</p>
-<p>On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
-what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-config-dir" title="g_get_user_config_dir ()"><code class="function">g_get_user_config_dir()</code></a> returns.</p>
+<p>On Windows it follows XDG Base Directory Specification if <code class="literal">XDG_DATA_HOME</code>
+is defined. If <code class="literal">XDG_DATA_HOME</code> is undefined, the folder to use for local (as
+opposed to roaming) application data is used instead. See the
+<a class="ulink" href="https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata" target="_top">documentation for <code class="literal">CSIDL_LOCAL_APPDATA</code></a>.
+Note that in this case on Windows it will be the same
+as what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-config-dir" title="g_get_user_config_dir ()"><code class="function">g_get_user_config_dir()</code></a> returns.</p>
 <div class="refsect3">
 <a name="g-get-user-data-dir.returns"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
@@ -935,10 +946,12 @@ configuration information such as user preferences and settings. </p>
 in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
 In this case the directory retrieved will be <code class="literal">XDG_CONFIG_HOME</code>.</p>
-<p>On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA. Note that on Windows it thus is the same as
-what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-data-dir" title="g_get_user_data_dir ()"><code class="function">g_get_user_data_dir()</code></a> returns.</p>
+<p>On Windows it follows XDG Base Directory Specification if <code class="literal">XDG_CONFIG_HOME</code> is defined.
+If <code class="literal">XDG_CONFIG_HOME</code> is undefined, the folder to use for local (as opposed
+to roaming) application data is used instead. See the
+<a class="ulink" href="https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata" target="_top">documentation for <code class="literal">CSIDL_LOCAL_APPDATA</code></a>.
+Note that in this case on Windows it will be  the same
+as what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-data-dir" title="g_get_user_data_dir ()"><code class="function">g_get_user_data_dir()</code></a> returns.</p>
 <div class="refsect3">
 <a name="g-get-user-config-dir.returns"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be modified
@@ -954,17 +967,13 @@ or freed. </p>
 g_get_user_runtime_dir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>Returns a directory that is unique to the current user on the local
 system.</p>
-<p>On UNIX platforms this is determined using the mechanisms described
+<p>This is determined using the mechanisms described
 in the 
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
 This is the directory
 specified in the <code class="literal">XDG_RUNTIME_DIR</code> environment variable.
 In the case that this variable is not set, we return the value of
 <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-cache-dir" title="g_get_user_cache_dir ()"><code class="function">g_get_user_cache_dir()</code></a>, after verifying that it exists.</p>
-<p>On Windows this is the folder to use for local (as opposed to
-roaming) application data. See documentation for
-CSIDL_LOCAL_APPDATA.  Note that on Windows it thus is the same as
-what <a class="link" href="glib-Miscellaneous-Utility-Functions.html#g-get-user-config-dir" title="g_get_user_config_dir ()"><code class="function">g_get_user_config_dir()</code></a> returns.</p>
 <div class="refsect3">
 <a name="g-get-user-runtime-dir.returns"></a><h4>Returns</h4>
 <p> a string owned by GLib that must not be
@@ -1020,8 +1029,10 @@ system-wide application data.</p>
 <p>On UNIX platforms this is determined using the mechanisms described
 in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>
-In this case the list of directories retrieved will be XDG_DATA_DIRS.</p>
-<p>On Windows the first elements in the list are the Application Data
+In this case the list of directories retrieved will be <code class="literal">XDG_DATA_DIRS</code>.</p>
+<p>On Windows it follows XDG Base Directory Specification if <code class="literal">XDG_DATA_DIRS</code> is defined.
+If <code class="literal">XDG_DATA_DIRS</code> is undefined,
+the first elements in the list are the Application Data
 and Documents folders for All Users. (These can be determined only
 on Windows 2000 or later and are not present in the list on other
 Windows versions.) See documentation for CSIDL_COMMON_APPDATA and
@@ -1057,12 +1068,15 @@ system-wide configuration information.</p>
 in the
 <a class="ulink" href="http://www.freedesktop.org/Standards/basedir-spec" target="_top">XDG Base Directory Specification</a>.
 In this case the list of directories retrieved will be <code class="literal">XDG_CONFIG_DIRS</code>.</p>
-<p>On Windows is the directory that contains application data for all users.
-A typical path is C:\Documents and Settings\All Users\Application Data.
-This folder is used for application data that is not user specific.
-For example, an application can store a spell-check dictionary, a database
-of clip art, or a log file in the CSIDL_COMMON_APPDATA folder.
-This information will not roam and is available to anyone using the computer.</p>
+<p>On Windows it follows XDG Base Directory Specification if <code class="literal">XDG_CONFIG_DIRS</code> is defined.
+If <code class="literal">XDG_CONFIG_DIRS</code> is undefined, the directory that contains application
+data for all users is used instead. A typical path is
+<code class="literal">C:\Documents and Settings\All Users\Application Data</code>.
+This folder is used for application data
+that is not user specific. For example, an application can store
+a spell-check dictionary, a database of clip art, or a log file in the
+CSIDL_COMMON_APPDATA folder. This information will not roam and is available
+to anyone using the computer.</p>
 <div class="refsect3">
 <a name="g-get-system-config-dirs.returns"></a><h4>Returns</h4>
 <p>    a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings owned by GLib that must not be

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

@@ -198,6 +198,22 @@
 <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-foreach" title="g_ptr_array_foreach ()">g_ptr_array_foreach</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
+<tr>
+<td class="function_type">
+<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-find" title="g_ptr_array_find ()">g_ptr_array_find</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-find-with-equal-func" title="g_ptr_array_find_with_equal_func ()">g_ptr_array_find_with_equal_func</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -475,7 +491,7 @@ g_ptr_array_unref (<em class="parameter"><code><a class="link" href="glib-Pointe
 reference count drops to 0, the effect is the same as calling
 <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-free" title="g_ptr_array_free ()"><code class="function">g_ptr_array_free()</code></a> with <em class="parameter"><code>free_segment</code></em>
  set to <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. This function
-is MT-safe and may be called from any thread.</p>
+is thread-safe and may be called from any thread.</p>
 <div class="refsect3">
 <a name="g-ptr-array-unref.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -937,6 +953,9 @@ be freed separately if <em class="parameter"><code>free_seg</code></em>
  is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> and no <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a>
 function has been set for <em class="parameter"><code>array</code></em>
 .</p>
+<p>This function is not thread-safe. If using a <a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a> from multiple
+threads, use only the atomic <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-ref" title="g_ptr_array_ref ()"><code class="function">g_ptr_array_ref()</code></a> and <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-unref" title="g_ptr_array_unref ()"><code class="function">g_ptr_array_unref()</code></a>
+functions.</p>
 <div class="refsect3">
 <a name="g-ptr-array-free.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1003,6 +1022,132 @@ g_ptr_array_foreach (<em class="parameter"><code><a class="link" href="glib-Poin
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="g-ptr-array-find"></a><h3>g_ptr_array_find ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+g_ptr_array_find (<em class="parameter"><code><a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a> *haystack</code></em>,
+                  <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> needle</code></em>,
+                  <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> *index_</code></em>);</pre>
+<p>Checks whether <em class="parameter"><code>needle</code></em>
+ exists in <em class="parameter"><code>haystack</code></em>
+. If the element is found, <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> is
+returned and the element’s index is returned in <em class="parameter"><code>index_</code></em>
+ (if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>).
+Otherwise, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>index_</code></em>
+ is undefined. If <em class="parameter"><code>needle</code></em>
+ exists
+multiple times in <em class="parameter"><code>haystack</code></em>
+, the index of the first instance is returned.</p>
+<p>This does pointer comparisons only. If you want to use more complex equality
+checks, such as string comparisons, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-find-with-equal-func" title="g_ptr_array_find_with_equal_func ()"><code class="function">g_ptr_array_find_with_equal_func()</code></a>.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
+<div class="refsect3">
+<a name="g-ptr-array-find.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>haystack</p></td>
+<td class="parameter_description"><p>pointer array to be searched</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>needle</p></td>
+<td class="parameter_description"><p>pointer to look for</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>index_</p></td>
+<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>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="g-ptr-array-find.returns"></a><h4>Returns</h4>
+<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>needle</code></em>
+is one of the elements of <em class="parameter"><code>haystack</code></em>
+</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-ptr-array-find-with-equal-func"></a><h3>g_ptr_array_find_with_equal_func ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a>
+g_ptr_array_find_with_equal_func (<em class="parameter"><code><a class="link" href="glib-Pointer-Arrays.html#GPtrArray" title="struct GPtrArray"><span class="type">GPtrArray</span></a> *haystack</code></em>,
+                                  <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> needle</code></em>,
+                                  <em class="parameter"><code><a class="link" href="glib-Hash-Tables.html#GEqualFunc" title="GEqualFunc ()"><span class="type">GEqualFunc</span></a> equal_func</code></em>,
+                                  <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> *index_</code></em>);</pre>
+<p>Checks whether <em class="parameter"><code>needle</code></em>
+ exists in <em class="parameter"><code>haystack</code></em>
+, using the given <em class="parameter"><code>equal_func</code></em>
+.
+If the element is found, <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> is returned and the element’s index is
+returned in <em class="parameter"><code>index_</code></em>
+ (if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>). Otherwise, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>index_</code></em>
+
+is undefined. If <em class="parameter"><code>needle</code></em>
+ exists multiple times in <em class="parameter"><code>haystack</code></em>
+, the index of
+the first instance is returned.</p>
+<p><em class="parameter"><code>equal_func</code></em>
+ is called with the element from the array as its first parameter,
+and <em class="parameter"><code>needle</code></em>
+ as its second parameter. If <em class="parameter"><code>equal_func</code></em>
+ is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, pointer
+equality is used.</p>
+<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
+<div class="refsect3">
+<a name="g-ptr-array-find-with-equal-func.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>haystack</p></td>
+<td class="parameter_description"><p>pointer array to be searched</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>needle</p></td>
+<td class="parameter_description"><p>pointer to look for</p></td>
+<td class="parameter_annotations"> </td>
+</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
+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
+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>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="g-ptr-array-find-with-equal-func.returns"></a><h4>Returns</h4>
+<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>needle</code></em>
+is one of the elements of <em class="parameter"><code>haystack</code></em>
+</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-54.html#api-index-2.54">2.54</a></p>
+</div>
 </div>
 <div class="refsect1">
 <a name="glib-Pointer-Arrays.other_details"></a><h2>Types and Values</h2>

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

@@ -487,7 +487,8 @@ are removed from the sequence.</p>
 </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>
 </div>
@@ -787,7 +788,8 @@ g_sequence_get_begin_iter (<em class="parameter"><code><a class="link" href="gli
 <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>
+. </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>
 </div>
@@ -816,7 +818,8 @@ g_sequence_get_end_iter (<em class="parameter"><code><a class="link" href="glib-
 <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>
+. </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>
 </div>
@@ -857,7 +860,8 @@ than the number of items in <em class="parameter"><code>seq</code></em>
 <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>
+. </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>
 </div>
@@ -893,7 +897,8 @@ 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>
 </div>
@@ -929,7 +934,8 @@ 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>
 </div>
@@ -965,7 +971,8 @@ 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>
 </div>
@@ -1104,7 +1111,8 @@ 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>
 </div>
@@ -1165,7 +1173,8 @@ 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>
 </div>
@@ -1449,7 +1458,8 @@ doing unsorted insertions.</p>
 <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>
+. </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>
 </div>
@@ -1515,7 +1525,8 @@ doing unsorted insertions.</p>
 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>
-</p>
+. </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>
 </div>
@@ -1587,7 +1598,8 @@ 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>
-, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if no such item exists</p>
+, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if no such item exists. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<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></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
 </div>
@@ -1651,7 +1663,8 @@ doing unsorted insertions.</p>
 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>
-, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if no such item exists</p>
+, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if no such item exists. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<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></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
 </div>
@@ -1680,7 +1693,8 @@ g_sequence_get (<em class="parameter"><code><a class="link" href="glib-Sequences
 <div class="refsect3">
 <a name="g-sequence-get.returns"></a><h4>Returns</h4>
 <p> the data that <em class="parameter"><code>iter</code></em>
-points to</p>
+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>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
 </div>
@@ -1805,7 +1819,8 @@ If <em class="parameter"><code>iter</code></em>
 <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>
+. </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>
 </div>
@@ -1837,7 +1852,8 @@ If <em class="parameter"><code>iter</code></em>
 <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
 before <em class="parameter"><code>iter</code></em>
-</p>
+. </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>
 </div>
@@ -1914,7 +1930,8 @@ the returned <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSe
 <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>
 positions away from <em class="parameter"><code>iter</code></em>
-</p>
+. </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>
 </div>
@@ -1943,7 +1960,8 @@ g_sequence_iter_get_sequence (<em class="parameter"><code><a class="link" href="
 <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>
-points into</p>
+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>
 <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
 </div>
@@ -2039,7 +2057,8 @@ and <em class="parameter"><code>begin</code></em>
 <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>
+) range. </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>
 </div>