New upstream version 3.24.5

2019-02-04 16:36:47 -05:00
parent 79399d953a bf60bf15de
commit ac00df30b2
512 changed files with 389739 additions and 466248 deletions
--- a/docs/reference/gtk/html/GtkCellLayout.html
+++ b/docs/reference/gtk/html/GtkCellLayout.html
@ -76,7 +76,7 @@
 </tr>
 <tr>
 <td class="function_type">
-<span class="returnvalue">GList</span> *
+<a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
 </td>
 <td class="function_name">
 <a class="link" href="GtkCellLayout.html#gtk-cell-layout-get-cells" title="gtk_cell_layout_get_cells ()">gtk_cell_layout_get_cells</a> <span class="c_punctuation">()</span>
@ -162,7 +162,7 @@
 <a name="GtkCellLayout.prerequisites"></a><h2>Prerequisites</h2>
 <p>
 GtkCellLayout requires
- GObject.</p>
+ <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>.</p>
 </div>
 <div class="refsect1">
 <a name="GtkCellLayout.implementations"></a><h2>Known Implementations</h2>
@ -274,7 +274,7 @@ widgets. This means that it is possible to e.g. do</p>
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal">combo </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_object_new</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GTK_TYPE_COMBO_BOX</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"cell-area"</span><span class="symbol">,</span><span class="normal"> my_cell_area</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">combo </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GTK_TYPE_COMBO_BOX</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"cell-area"</span><span class="symbol">,</span><span class="normal"> my_cell_area</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
      </tr>
    </tbody>
  </table>
@ -318,7 +318,7 @@ you to the problem).</p>
 <span class="normal">  cell </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkCellRendererPixbuf.html#gtk-cell-renderer-pixbuf-new">gtk_cell_renderer_pixbuf_new</a></span><span class="normal"> </span><span class="symbol">();</span>
 <span class="normal">  </span><span class="comment">// The following call causes the default cell area for combo boxes,</span>
 <span class="normal">  </span><span class="comment">// a GtkCellAreaBox, to be instantiated</span>
-<span class="normal">  </span><span class="function"><a href="GtkCellLayout.html#gtk-cell-layout-pack-start">gtk_cell_layout_pack_start</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CELL_LAYOUT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">b</span><span class="symbol">),</span><span class="normal"> cell</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="GtkCellLayout.html#gtk-cell-layout-pack-start">gtk_cell_layout_pack_start</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CELL_LAYOUT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">b</span><span class="symbol">),</span><span class="normal"> cell</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
 <span class="normal">  </span><span class="symbol">...</span>
 <span class="cbracket">}</span>

@ -326,7 +326,7 @@ you to the problem).</p>
 <span class="function">my_combo_box_new</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkCellArea</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">area</span><span class="symbol">)</span>
 <span class="cbracket">{</span>
 <span class="normal">  </span><span class="comment">// This call is going to cause a warning about area being ignored</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function">g_object_new</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MY_TYPE_COMBO_BOX</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"cell-area"</span><span class="symbol">,</span><span class="normal"> area</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">MY_TYPE_COMBO_BOX</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"cell-area"</span><span class="symbol">,</span><span class="normal"> area</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 <span class="cbracket">}</span></pre></td>
      </tr>
    </tbody>
@ -350,7 +350,7 @@ for your class.</p>
                          <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *tree_model</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
-                          <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
+                          <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 <p>A function which should set the value of <em class="parameter"><code>cell_layout</code></em>
 ’s cell renderer(s)
 as appropriate.</p>
@ -398,15 +398,15 @@ as appropriate.</p>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_cell_layout_pack_start (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>,
                            <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
-                            <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>);</pre>
+                            <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>);</pre>
 <p>Packs the <em class="parameter"><code>cell</code></em>
 into the beginning of <em class="parameter"><code>cell_layout</code></em>
 . If <em class="parameter"><code>expand</code></em>
- is <code class="literal">FALSE</code>,
+ is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>,
 then the <em class="parameter"><code>cell</code></em>
 is allocated no more space than it needs. Any unused space
 is divided evenly between cells for which <em class="parameter"><code>expand</code></em>
- is <code class="literal">TRUE</code>.</p>
+ is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
 <p>Note that reusing the same cell renderer is not supported.</p>
 <div class="refsect3">
 <a name="gtk-cell-layout-pack-start.parameters"></a><h4>Parameters</h4>
@ -429,7 +429,7 @@ is divided evenly between cells for which <em class="parameter"><code>expand</co
 </tr>
 <tr>
 <td class="parameter_name"><p>expand</p></td>
-<td class="parameter_description"><p><code class="literal">TRUE</code> if <em class="parameter"><code>cell</code></em>
+<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>cell</code></em>
 is to be given extra space allocated to <em class="parameter"><code>cell_layout</code></em>
 </p></td>
 <td class="parameter_annotations"> </td>
@ -445,15 +445,15 @@ is to be given extra space allocated to <em class="parameter"><code>cell_layout<
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_cell_layout_pack_end (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
-                          <em class="parameter"><code><span class="type">gboolean</span> expand</code></em>);</pre>
+                          <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> expand</code></em>);</pre>
 <p>Adds the <em class="parameter"><code>cell</code></em>
 to the end of <em class="parameter"><code>cell_layout</code></em>
 . If <em class="parameter"><code>expand</code></em>
- is <code class="literal">FALSE</code>, then the
+ is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then the
 <em class="parameter"><code>cell</code></em>
 is allocated no more space than it needs. Any unused space is
 divided evenly between cells for which <em class="parameter"><code>expand</code></em>
- is <code class="literal">TRUE</code>.</p>
+ is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
 <p>Note that reusing the same cell renderer is not supported.</p>
 <div class="refsect3">
 <a name="gtk-cell-layout-pack-end.parameters"></a><h4>Parameters</h4>
@ -476,7 +476,7 @@ divided evenly between cells for which <em class="parameter"><code>expand</code>
 </tr>
 <tr>
 <td class="parameter_name"><p>expand</p></td>
-<td class="parameter_description"><p><code class="literal">TRUE</code> if <em class="parameter"><code>cell</code></em>
+<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>cell</code></em>
 is to be given extra space allocated to <em class="parameter"><code>cell_layout</code></em>
 </p></td>
 <td class="parameter_annotations"> </td>
@ -493,7 +493,7 @@ is to be given extra space allocated to <em class="parameter"><code>cell_layout<
 gtk_cell_layout_get_area (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>);</pre>
 <p>Returns the underlying <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> which might be <em class="parameter"><code>cell_layout</code></em>

-if called on a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> or might be <code class="literal">NULL</code> if no <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>
+if called on a <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> or might be <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a>
 is used by <em class="parameter"><code>cell_layout</code></em>
 .</p>
 <div class="refsect3">
@ -515,7 +515,7 @@ is used by <em class="parameter"><code>cell_layout</code></em>
 <a name="gtk-cell-layout-get-area.returns"></a><h4>Returns</h4>
 <p>the cell area used by <em class="parameter"><code>cell_layout</code></em>
 ,
-or <code class="literal">NULL</code> in case no cell area is used. </p>
+or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case no cell area is used. </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-3-0.html#api-index-3.0">3.0</a></p>
@ -523,7 +523,7 @@ or <code class="literal">NULL</code> in case no cell area is used. </p>
 <hr>
 <div class="refsect2">
 <a name="gtk-cell-layout-get-cells"></a><h3>gtk_cell_layout_get_cells ()</h3>
-<pre class="programlisting"><span class="returnvalue">GList</span> *
+<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
 gtk_cell_layout_get_cells (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>);</pre>
 <p>Returns the cell renderers which have been added to <em class="parameter"><code>cell_layout</code></em>
 .</p>
@ -545,7 +545,7 @@ gtk_cell_layout_get_cells (<em class="parameter"><code><a class="link" href="Gtk
 <div class="refsect3">
 <a name="gtk-cell-layout-get-cells.returns"></a><h4>Returns</h4>
 <p>a list of cell renderers. The list, but not the renderers has
-been newly allocated and should be freed with <code class="function">g_list_free()</code>
+been newly allocated and should be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>
 when no longer needed. </p>
 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkCellRenderer][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
 </div>
@ -557,7 +557,7 @@ when no longer needed. </p>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_cell_layout_reorder (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>,
                         <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
-                         <em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
+                         <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
 <p>Re-inserts <em class="parameter"><code>cell</code></em>
 at <em class="parameter"><code>position</code></em>
 .</p>
@ -654,7 +654,7 @@ removed, and replaced with the new attributes.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>...</p></td>
-<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated list of attributes</p></td>
+<td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of attributes</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@ -668,8 +668,8 @@ removed, and replaced with the new attributes.</p>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_cell_layout_add_attribute (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
-                               <em class="parameter"><code>const <span class="type">gchar</span> *attribute</code></em>,
-                               <em class="parameter"><code><span class="type">gint</span> column</code></em>);</pre>
+                               <em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
+                               <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
 <p>Adds an attribute mapping to the list in <em class="parameter"><code>cell_layout</code></em>
 .</p>
 <p>The <em class="parameter"><code>column</code></em>
@ -720,8 +720,8 @@ example if column 2 of the model contains strings, you could have the
 gtk_cell_layout_set_cell_data_func (<em class="parameter"><code><a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> *cell_layout</code></em>,
                                    <em class="parameter"><code><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a> *cell</code></em>,
                                    <em class="parameter"><code><a class="link" href="GtkCellLayout.html#GtkCellLayoutDataFunc" title="GtkCellLayoutDataFunc ()"><span class="type">GtkCellLayoutDataFunc</span></a> func</code></em>,
-                                    <em class="parameter"><code><span class="type">gpointer</span> func_data</code></em>,
-                                    <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
+                                    <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>,
+                                    <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
 <p>Sets the <a class="link" href="GtkCellLayout.html#GtkCellLayoutDataFunc" title="GtkCellLayoutDataFunc ()"><span class="type">GtkCellLayoutDataFunc</span></a> to use for <em class="parameter"><code>cell_layout</code></em>
 .</p>
 <p>This function is used instead of the standard attributes mapping
@ -729,7 +729,7 @@ for setting the column value, and should set the value of <em class="parameter">
 ’s
 cell renderer(s) as appropriate.</p>
 <p><em class="parameter"><code>func</code></em>
- may be <code class="literal">NULL</code> to remove a previously set function.</p>
+ may be <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove a previously set function.</p>
 <div class="refsect3">
 <a name="gtk-cell-layout-set-cell-data-func.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -751,7 +751,7 @@ cell renderer(s) as appropriate.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the <a class="link" href="GtkCellLayout.html#GtkCellLayoutDataFunc" title="GtkCellLayoutDataFunc ()"><span class="type">GtkCellLayoutDataFunc</span></a> to use, or <code class="literal">NULL</code>. </p></td>
+<td class="parameter_description"><p>the <a class="link" href="GtkCellLayout.html#GtkCellLayoutDataFunc" title="GtkCellLayoutDataFunc ()"><span class="type">GtkCellLayoutDataFunc</span></a> to use, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 <tr>