RubyGems - gdk3 - Versions diffs - 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32 - Mend

gdk3 3.0.7-x86-mingw32 → 3.0.8-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 (969) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkPlacesSidebar.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="SelectorWidgets.html" title="Selector Widgets and Dialogs">
 <link rel="prev" href="GtkFontChooserDialog.html" title="GtkFontChooserDialog">
 <link rel="next" href="Ornaments.html" title="Ornaments">
-<meta name="generator" content="GTK-Doc V1.24.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -77,7 +77,7 @@
 </tr>
 <tr>
 <td class="function_type">
-<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
 </td>
 <td class="function_name">
 <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-location" title="gtk_places_sidebar_get_location ()">gtk_places_sidebar_get_location</a> <span class="c_punctuation">()</span>
@@ -88,6 +88,22 @@
 <span class="returnvalue">void</span>
 </td>
 <td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-recent" title="gtk_places_sidebar_set_show_recent ()">gtk_places_sidebar_set_show_recent</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-show-recent" title="gtk_places_sidebar_get_show_recent ()">gtk_places_sidebar_get_show_recent</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
 <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-desktop" title="gtk_places_sidebar_set_show_desktop ()">gtk_places_sidebar_set_show_desktop</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -125,7 +141,7 @@
 </tr>
 <tr>
 <td class="function_type">
-<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
 </td>
 <td class="function_name">
 <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-nth-bookmark" title="gtk_places_sidebar_get_nth_bookmark ()">gtk_places_sidebar_get_nth_bookmark</a> <span class="c_punctuation">()</span>
@@ -179,6 +195,46 @@
 <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-enter-location" title="gtk_places_sidebar_set_show_enter_location ()">gtk_places_sidebar_set_show_enter_location</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
+<tr>
+<td class="function_type">
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-show-trash" title="gtk_places_sidebar_get_show_trash ()">gtk_places_sidebar_get_show_trash</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-trash" title="gtk_places_sidebar_set_show_trash ()">gtk_places_sidebar_set_show_trash</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-show-other-locations" title="gtk_places_sidebar_get_show_other_locations ()">gtk_places_sidebar_get_show_other_locations</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-other-locations" title="gtk_places_sidebar_set_show_other_locations ()">gtk_places_sidebar_set_show_other_locations</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-drop-targets-visible" title="gtk_places_sidebar_set_drop_targets_visible ()">gtk_places_sidebar_set_drop_targets_visible</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -198,7 +254,7 @@
 </tr>
 <tr>
 <td class="property_type">
-<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *</td>
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *</td>
 <td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--location" title="The “location” property">location</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -209,6 +265,11 @@
 </tr>
 <tr>
 <td class="property_type"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
+<td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--populate-all" title="The “populate-all” property">populate-all</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
 <td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-connect-to-server" title="The “show-connect-to-server” property">show-connect-to-server</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -222,6 +283,21 @@
 <td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-enter-location" title="The “show-enter-location” property">show-enter-location</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
+<tr>
+<td class="property_type"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
+<td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-other-locations" title="The “show-other-locations” property">show-other-locations</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
+<td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-recent" title="The “show-recent” property">show-recent</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
+<td class="property_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-trash" title="The “show-trash” property">show-trash</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -251,6 +327,11 @@
 </tr>
 <tr>
 <td class="signal_type"><span class="returnvalue">void</span></td>
+<td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-mount" title="The “mount” signal">mount</a></td>
+<td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
+</tr>
+<tr>
+<td class="signal_type"><span class="returnvalue">void</span></td>
 <td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title="The “open-location” signal">open-location</a></td>
 <td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
 </tr>
@@ -274,6 +355,21 @@
 <td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-error-message" title="The “show-error-message” signal">show-error-message</a></td>
 <td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
 </tr>
+<tr>
+<td class="signal_type"><span class="returnvalue">void</span></td>
+<td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-other-locations" title="The “show-other-locations” signal">show-other-locations</a></td>
+<td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
+</tr>
+<tr>
+<td class="signal_type"><span class="returnvalue">void</span></td>
+<td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-other-locations-with-flags" title="The “show-other-locations-with-flags” signal">show-other-locations-with-flags</a></td>
+<td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
+</tr>
+<tr>
+<td class="signal_type"><span class="returnvalue">void</span></td>
+<td class="signal_name"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-unmount" title="The “unmount” signal">unmount</a></td>
+<td class="signal_flags"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -298,7 +394,7 @@
 </div>
 <div class="refsect1">
 <a name="GtkPlacesSidebar.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="screen">    <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+<pre class="screen">    <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
     <span class="lineart">╰──</span> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         <span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
             <span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
@@ -338,6 +434,18 @@ to the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-locatio
 user selects in the sidebar a location to open.  The application should also
 call <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-location" title="gtk_places_sidebar_set_location ()"><code class="function">gtk_places_sidebar_set_location()</code></a> when it changes the currently-viewed
 location.</p>
+<div class="refsect2">
+<a name="id-1.3.14.16.10.7"></a><h3>CSS nodes</h3>
+<p>GtkPlacesSidebar uses a single CSS node with name placesidebar and style
+class .sidebar.</p>
+<p>Among the children of the places sidebar, the following style classes can
+be used:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>.sidebar-new-bookmark-row for the 'Add new bookmark' row</p></li>
+<li class="listitem"><p>.sidebar-placeholder-row for a row that is a placeholder</p></li>
+<li class="listitem"><p>.has-open-popup when a popup is open for a row</p></li>
+</ul></div>
+</div>
 </div>
 <div class="refsect1">
 <a name="GtkPlacesSidebar.functions_details"></a><h2>Functions</h2>
@@ -350,7 +458,7 @@ gtk_places_sidebar_new (<em class="parameter"><code><span class="type">void</spa
 <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title="The “open-location” signal"><span class="type">“open-location”</span></a> signal to be notified
 when the user makes a selection in the sidebar.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.2.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-new.returns"></a><h4>Returns</h4>
 <p> a newly created <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
@@ -377,7 +485,7 @@ argument will be set to one of the <em class="parameter"><code>flags</code></em>
  will cause <a class="link" href="GtkPlacesSidebar.html#GTK-PLACES-OPEN-NORMAL:CAPS"><span class="type">GTK_PLACES_OPEN_NORMAL</span></a> to always be sent
 to callbacks for the “open-location” signal.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.3.8"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-open-flags.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -407,7 +515,7 @@ to callbacks for the “open-location” signal.</p>
 gtk_places_sidebar_get_open_flags (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Gets the open flags.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.4.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-open-flags.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -422,7 +530,7 @@ gtk_places_sidebar_get_open_flags (<em class="parameter"><code><a class="link" h
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.4.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-open-flags.returns"></a><h4>Returns</h4>
 <p> the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> of <em class="parameter"><code>sidebar</code></em>
 </p>
 </div>
@@ -433,7 +541,7 @@ gtk_places_sidebar_get_open_flags (<em class="parameter"><code><a class="link" h
 <a name="gtk-places-sidebar-set-location"></a><h3>gtk_places_sidebar_set_location ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_places_sidebar_set_location (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
-                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *location</code></em>);</pre>
 <p>Sets the location that is being shown in the widgets surrounding the
 <em class="parameter"><code>sidebar</code></em>
 , for example, in a folder view in a file manager.  In turn, the
@@ -443,7 +551,7 @@ places, or it will unhighlight everything if the <em class="parameter"><code>loc
  is not among the
 places in the list.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.5.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -469,7 +577,7 @@ places in the list.</p>
 <hr>
 <div class="refsect2">
 <a name="gtk-places-sidebar-get-location"></a><h3>gtk_places_sidebar_get_location ()</h3>
-<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
 gtk_places_sidebar_get_location (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Gets the currently-selected location in the <em class="parameter"><code>sidebar</code></em>
 .  This can be <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> when
@@ -482,7 +590,7 @@ connect to the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-popu
 function to get the location that is being referred to during the callbacks
 for your menu items.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.6.6"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -497,15 +605,77 @@ for your menu items.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.6.7"></a><h4>Returns</h4>
-<p> a GFile with the selected location, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if nothing is visually
-selected. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<a name="gtk-places-sidebar-get-location.returns"></a><h4>Returns</h4>
+<p> a GFile with the selected location, or
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if nothing is visually selected. </p>
+<p><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>][<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-3-10.html#api-index-3.10">3.10</a></p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="gtk-places-sidebar-set-show-recent"></a><h3>gtk_places_sidebar_set_show_recent ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gtk_places_sidebar_set_show_recent (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                    <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_recent</code></em>);</pre>
+<p>Sets whether the <em class="parameter"><code>sidebar</code></em>
+ should show an item for recent files.
+The default value for this option is determined by the desktop
+environment, but this function can be used to override it on a
+per-application basis.</p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-set-show-recent.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>show_recent</p></td>
+<td class="parameter_description"><p>whether to show an item for recent files</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-show-recent"></a><h3>gtk_places_sidebar_get_show_recent ()</h3>
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+gtk_places_sidebar_get_show_recent (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-recent" title="gtk_places_sidebar_set_show_recent ()"><code class="function">gtk_places_sidebar_set_show_recent()</code></a></p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-recent.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-recent.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display a builtin shortcut for recent files</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="gtk-places-sidebar-set-show-desktop"></a><h3>gtk_places_sidebar_set_show_desktop ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_places_sidebar_set_show_desktop (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
@@ -516,7 +686,7 @@ The default value for this option is determined by the desktop
 environment and the user’s configuration, but this function can be
 used to override it on a per-application basis.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.7.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-show-desktop.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -546,7 +716,7 @@ used to override it on a per-application basis.</p>
 gtk_places_sidebar_get_show_desktop (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-desktop" title="gtk_places_sidebar_set_show_desktop ()"><code class="function">gtk_places_sidebar_set_show_desktop()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.8.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-show-desktop.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -561,7 +731,7 @@ gtk_places_sidebar_get_show_desktop (<em class="parameter"><code><a class="link"
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.8.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-show-desktop.returns"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display a builtin shortcut to the desktop folder.</p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
@@ -571,7 +741,7 @@ gtk_places_sidebar_get_show_desktop (<em class="parameter"><code><a class="link"
 <a name="gtk-places-sidebar-add-shortcut"></a><h3>gtk_places_sidebar_add_shortcut ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_places_sidebar_add_shortcut (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
-                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *location</code></em>);</pre>
 <p>Applications may want to present some folders in the places sidebar if
 they could be immediately useful to users.  For example, a drawing
 program could add a “/usr/share/clipart” location when the sidebar is
@@ -583,7 +753,7 @@ across applications, and they are not persistent.  If this function
 is called multiple times with different locations, then they are added
 to the sidebar’s list in the same order as the function is called.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.9.6"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-add-shortcut.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -611,13 +781,13 @@ to the sidebar’s list in the same order as the function is called.</p>
 <a name="gtk-places-sidebar-remove-shortcut"></a><h3>gtk_places_sidebar_remove_shortcut ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_places_sidebar_remove_shortcut (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
-                                    <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+                                    <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *location</code></em>);</pre>
 <p>Removes an application-specific shortcut that has been previously been
 inserted with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()"><code class="function">gtk_places_sidebar_add_shortcut()</code></a>.  If the <em class="parameter"><code>location</code></em>
  is not a
 shortcut in the sidebar, then nothing is done.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.10.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-remove-shortcut.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -647,7 +817,7 @@ shortcut in the sidebar, then nothing is done.</p>
 gtk_places_sidebar_list_shortcuts (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Gets the list of shortcuts.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.11.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-list-shortcuts.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -662,8 +832,8 @@ gtk_places_sidebar_list_shortcuts (<em class="parameter"><code><a class="link" h
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.11.6"></a><h4>Returns</h4>
-<p>    A <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> of the locations that have been added as
+<a name="gtk-places-sidebar-list-shortcuts.returns"></a><h4>Returns</h4>
+<p>    A <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> of the locations that have been added as
 application-specific shortcuts with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()"><code class="function">gtk_places_sidebar_add_shortcut()</code></a>.
 To free this list, you can use</p>
 <div class="informalexample">
@@ -685,14 +855,14 @@ To free this list, you can use</p>
 <hr>
 <div class="refsect2">
 <a name="gtk-places-sidebar-get-nth-bookmark"></a><h3>gtk_places_sidebar_get_nth_bookmark ()</h3>
-<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
 gtk_places_sidebar_get_nth_bookmark (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
                                      <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);</pre>
 <p>This function queries the bookmarks added by the user to the places sidebar,
 and returns one of them.  This function is used by <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> to implement
 the “Alt-1”, “Alt-2”, etc. shortcuts, which activate the cooresponding bookmark.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.12.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-nth-bookmark.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -714,12 +884,12 @@ the “Alt-1”, “Alt-2”, etc. shortcuts, which activate the cooresponding b
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.12.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-nth-bookmark.returns"></a><h4>Returns</h4>
 <p> The bookmark specified by the index <em class="parameter"><code>n</code></em>
 , or
-<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if no such index exist.  Note that the indices start at 0, even though
-the file chooser starts them with the keyboard shortcut “Alt-1”. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such index exist.  Note that the indices start at 0, even though
+the file chooser starts them with the keyboard shortcut "Alt-1". </p>
+<p><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>][<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-3-10.html#api-index-3.10">3.10</a></p>
 </div>
@@ -729,9 +899,14 @@ the file chooser starts them with the keyboard shortcut “Alt-1”. </p>
 <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 gtk_places_sidebar_get_show_connect_to_server
                                (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<div class="warning">
+<p><code class="literal">gtk_places_sidebar_get_show_connect_to_server</code> has been deprecated since version 3.18 and should not be used in newly-written code.</p>
+<p>It is recommended to group this functionality with the drives
+    and network location under the new 'Other Location' item</p>
+</div>
 <p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-connect-to-server" title="gtk_places_sidebar_set_show_connect_to_server ()"><code class="function">gtk_places_sidebar_set_show_connect_to_server()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.13.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-show-connect-to-server.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -746,10 +921,9 @@ gtk_places_sidebar_get_show_connect_to_server
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.13.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-show-connect-to-server.returns"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display a “Connect to Server” item.</p>
 </div>
-<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -758,12 +932,19 @@ gtk_places_sidebar_get_show_connect_to_server
 gtk_places_sidebar_set_show_connect_to_server
                                (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_connect_to_server</code></em>);</pre>
+<div class="warning">
+<p><code class="literal">gtk_places_sidebar_set_show_connect_to_server</code> has been deprecated since version 3.18 and should not be used in newly-written code.</p>
+<p>It is recommended to group this functionality with the drives
+    and network location under the new 'Other Location' item</p>
+</div>
 <p>Sets whether the <em class="parameter"><code>sidebar</code></em>
- should show an item for connecting to a network server; this is off by default.
-An application may want to turn this on if it implements a way for the user to connect
-to network servers directly.</p>
+ should show an item for connecting to a network server;
+this is off by default. An application may want to turn this on if it implements
+a way for the user to connect to network servers directly.</p>
+<p>If you enable this, you should connect to the
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-connect-to-server" title="The “show-connect-to-server” signal"><span class="type">“show-connect-to-server”</span></a> signal.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.14.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-show-connect-to-server.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -793,7 +974,7 @@ to network servers directly.</p>
 gtk_places_sidebar_get_local_only (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-local-only" title="gtk_places_sidebar_set_local_only ()"><code class="function">gtk_places_sidebar_set_local_only()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.15.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-local-only.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -808,7 +989,7 @@ gtk_places_sidebar_get_local_only (<em class="parameter"><code><a class="link" h
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.15.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-local-only.returns"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will only show local files.</p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
@@ -822,7 +1003,7 @@ gtk_places_sidebar_set_local_only (<em class="parameter"><code><a class="link" h
 <p>Sets whether the <em class="parameter"><code>sidebar</code></em>
  should only show local files.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.16.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-local-only.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -853,7 +1034,7 @@ gtk_places_sidebar_get_show_enter_location
                                (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
 <p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-enter-location" title="gtk_places_sidebar_set_show_enter_location ()"><code class="function">gtk_places_sidebar_set_show_enter_location()</code></a></p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.17.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-get-show-enter-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -868,7 +1049,7 @@ gtk_places_sidebar_get_show_enter_location
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.17.6"></a><h4>Returns</h4>
+<a name="gtk-places-sidebar-get-show-enter-location.returns"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display an “Enter Location” item.</p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
@@ -881,11 +1062,13 @@ gtk_places_sidebar_set_show_enter_location
                                (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
                                 <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_enter_location</code></em>);</pre>
 <p>Sets whether the <em class="parameter"><code>sidebar</code></em>
- should show an item for connecting to a network server; this is off by default.
-An application may want to turn this on if it implements a way for the user to connect
-to network servers directly.</p>
+ should show an item for entering a location;
+this is off by default. An application may want to turn this on if manually
+entering URLs is an expected user action.</p>
+<p>If you enable this, you should connect to the
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-enter-location" title="The “show-enter-location” signal"><span class="type">“show-enter-location”</span></a> signal.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.11.18.5"></a><h4>Parameters</h4>
+<a name="gtk-places-sidebar-set-show-enter-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -900,7 +1083,7 @@ to network servers directly.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>show_enter_location</p></td>
-<td class="parameter_description"><p>whether to show an item for the Connect to Server command</p></td>
+<td class="parameter_description"><p>whether to show an item to enter a location</p></td>
 <td class="parameter_annotations"> </td>
 </tr>
 </tbody>
@@ -908,6 +1091,178 @@ to network servers directly.</p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-3-14.html#api-index-3.14">3.14</a></p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-show-trash"></a><h3>gtk_places_sidebar_get_show_trash ()</h3>
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+gtk_places_sidebar_get_show_trash (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-trash" title="gtk_places_sidebar_set_show_trash ()"><code class="function">gtk_places_sidebar_set_show_trash()</code></a></p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-trash.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-trash.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display a “Trash” item.</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-show-trash"></a><h3>gtk_places_sidebar_set_show_trash ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gtk_places_sidebar_set_show_trash (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                   <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_trash</code></em>);</pre>
+<p>Sets whether the <em class="parameter"><code>sidebar</code></em>
+ should show an item for the Trash location.</p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-set-show-trash.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>show_trash</p></td>
+<td class="parameter_description"><p>whether to show an item for the Trash location</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-show-other-locations"></a><h3>gtk_places_sidebar_get_show_other_locations ()</h3>
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+gtk_places_sidebar_get_show_other_locations
+                               (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-other-locations" title="gtk_places_sidebar_set_show_other_locations ()"><code class="function">gtk_places_sidebar_set_show_other_locations()</code></a></p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-other-locations.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="gtk-places-sidebar-get-show-other-locations.returns"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the sidebar will display an “Other Locations” item.</p>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-show-other-locations"></a><h3>gtk_places_sidebar_set_show_other_locations ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gtk_places_sidebar_set_show_other_locations
+                               (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_other_locations</code></em>);</pre>
+<p>Sets whether the <em class="parameter"><code>sidebar</code></em>
+ should show an item for the application to show
+an Other Locations view; this is off by default. When set to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, persistent
+devices such as hard drives are hidden, otherwise they are shown in the sidebar.
+An application may want to turn this on if it implements a way for the user to
+see and interact with drives and network servers directly.</p>
+<p>If you enable this, you should connect to the
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-other-locations" title="The “show-other-locations” signal"><span class="type">“show-other-locations”</span></a> signal.</p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-set-show-other-locations.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>show_other_locations</p></td>
+<td class="parameter_description"><p>whether to show an item for the Other Locations view</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-drop-targets-visible"></a><h3>gtk_places_sidebar_set_drop_targets_visible ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gtk_places_sidebar_set_drop_targets_visible
+                               (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> visible</code></em>,
+                                <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk2/gdk2-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a> *context</code></em>);</pre>
+<p>Make the GtkPlacesSidebar show drop targets, so it can show the available
+drop targets and a "new bookmark" row. This improves the Drag-and-Drop
+experience of the user and allows applications to show all available
+drop targets at once.</p>
+<p>This needs to be called when the application is aware of an ongoing drag
+that might target the sidebar. The drop-targets-visible state will be unset
+automatically if the drag finishes in the GtkPlacesSidebar. You only need
+to unset the state when the drag ends on some other widget on your application.</p>
+<div class="refsect3">
+<a name="gtk-places-sidebar-set-drop-targets-visible.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>a places sidebar.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>visible</p></td>
+<td class="parameter_description"><p>whether to show the valid targets or not.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>context</p></td>
+<td class="parameter_description"><p>drag context used to ask the source about the action that wants to
+perform, so hints are more accurate.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
 </div>
 <div class="refsect1">
 <a name="GtkPlacesSidebar.other_details"></a><h2>Types and Values</h2>
@@ -931,7 +1286,7 @@ based on the modifier keys that the user is pressing at the time the selection i
 use <a class="link" href="GtkPlacesSidebar.html#GTK-PLACES-OPEN-NORMAL:CAPS"><span class="type">GTK_PLACES_OPEN_NORMAL</span></a> in the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title="The “open-location” signal"><span class="type">“open-location”</span></a> signal.  This is the
 default mode of operation.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.12.3.6"></a><h4>Members</h4>
+<a name="GtkPlacesOpenFlags.members"></a><h4>Members</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="300px" class="enum_members_name">
@@ -984,7 +1339,7 @@ default mode of operation.</p>
 <hr>
 <div class="refsect2">
 <a name="GtkPlacesSidebar--location"></a><h3>The <code class="literal">“location”</code> property</h3>
-<pre class="programlisting">  “location”                 <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *</pre>
+<pre class="programlisting">  “location”                 <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *</pre>
 <p>The location to highlight in the sidebar.</p>
 <p>Flags: Read / Write</p>
 </div>
@@ -998,6 +1353,16 @@ default mode of operation.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="GtkPlacesSidebar--populate-all"></a><h3>The <code class="literal">“populate-all”</code> property</h3>
+<pre class="programlisting">  “populate-all”             <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
+<p>If :populate-all is <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-populate-popup" title="The “populate-popup” signal"><span class="type">“populate-popup”</span></a> signal
+is also emitted for popovers.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: FALSE</p>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="GtkPlacesSidebar--show-connect-to-server"></a><h3>The <code class="literal">“show-connect-to-server”</code> property</h3>
 <pre class="programlisting">  “show-connect-to-server”   <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
 <p>Whether the sidebar includes a builtin shortcut to a 'Connect to server' dialog.</p>
@@ -1020,6 +1385,30 @@ default mode of operation.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: FALSE</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--show-other-locations"></a><h3>The <code class="literal">“show-other-locations”</code> property</h3>
+<pre class="programlisting">  “show-other-locations”     <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
+<p>Whether the sidebar includes an item to show external locations.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--show-recent"></a><h3>The <code class="literal">“show-recent”</code> property</h3>
+<pre class="programlisting">  “show-recent”              <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
+<p>Whether the sidebar includes a builtin shortcut for recent files.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: TRUE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--show-trash"></a><h3>The <code class="literal">“show-trash”</code> property</h3>
+<pre class="programlisting">  “show-trash”               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
+<p>Whether the sidebar includes a builtin shortcut to the Trash location.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: TRUE</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="GtkPlacesSidebar.signal-details"></a><h2>Signal Details</h2>
@@ -1032,7 +1421,7 @@ user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSide
 <p>The places sidebar emits this signal when it needs to ask the application
 to pop up a menu to ask the user for which drag action to perform.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.2.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-drag-action-ask.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1059,7 +1448,7 @@ to pop up a menu to ask the user for which drag action to perform.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.2.6"></a><h4>Returns</h4>
+<a name="GtkPlacesSidebar-drag-action-ask.returns"></a><h4>Returns</h4>
 <p> the final drag action that the sidebar should pass to the drag side
 of the drag-and-drop operation.</p>
 </div>
@@ -1071,8 +1460,8 @@ of the drag-and-drop operation.</p>
 <a name="GtkPlacesSidebar-drag-action-requested"></a><h3>The <code class="literal">“drag-action-requested”</code> signal</h3>
 <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
-               <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a>   *context,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *dest_file,
+               <a href="http://library.gnome.org/devel/gdk2/gdk2-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a>   *context,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>          *dest_file,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          source_file_list,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
 <p>When the user starts a drag-and-drop operation and the sidebar needs
@@ -1086,7 +1475,7 @@ possible actions for the destination <em class="parameter"><code>dest_file</code
 .</p>
 <p>The drag action to use must be the return value of the signal handler.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.3.7"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-drag-action-requested.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1101,17 +1490,17 @@ possible actions for the destination <em class="parameter"><code>dest_file</code
 </tr>
 <tr>
 <td class="parameter_name"><p>context</p></td>
-<td class="parameter_description"><p> <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a> with information about the drag operation. </p></td>
+<td class="parameter_description"><p> <a href="http://library.gnome.org/devel/gdk2/gdk2-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a> with information about the drag operation. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.DragContext]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>dest_file</p></td>
-<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> with the tentative location that is being hovered for a drop. </p></td>
+<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> with the tentative location that is being hovered for a drop. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gio.File]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>source_file_list</p></td>
-<td class="parameter_description"><p>  List of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> that are being dragged. </p></td>
+<td class="parameter_description"><p>  List of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> that are being dragged. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GLib.List][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -1123,9 +1512,9 @@ possible actions for the destination <em class="parameter"><code>dest_file</code
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.3.8"></a><h4>Returns</h4>
-<p> The drag action to use, for example, <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS"><span class="type">GDK_ACTION_COPY</span></a>
-or <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><span class="type">GDK_ACTION_MOVE</span></a>, or 0 if no action is allowed here (i.e. drops
+<a name="GtkPlacesSidebar-drag-action-requested.returns"></a><h4>Returns</h4>
+<p> The drag action to use, for example, <a href="http://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS"><span class="type">GDK_ACTION_COPY</span></a>
+or <a href="http://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><span class="type">GDK_ACTION_MOVE</span></a>, or 0 if no action is allowed here (i.e. drops
 are not allowed in the specified <em class="parameter"><code>dest_file</code></em>
 ).</p>
 </div>
@@ -1137,7 +1526,7 @@ are not allowed in the specified <em class="parameter"><code>dest_file</code></e
 <a name="GtkPlacesSidebar-drag-perform-drop"></a><h3>The <code class="literal">“drag-perform-drop”</code> signal</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *dest_file,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>          *dest_file,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          source_file_list,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>              action,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
@@ -1150,7 +1539,7 @@ destination.  This item is in the <em class="parameter"><code>dest_file</code></
 which should be copied/moved/etc. based on the specified <em class="parameter"><code>action</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.4.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-drag-perform-drop.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1165,12 +1554,12 @@ which should be copied/moved/etc. based on the specified <em class="parameter"><
 </tr>
 <tr>
 <td class="parameter_name"><p>dest_file</p></td>
-<td class="parameter_description"><p> Destination <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>. </p></td>
+<td class="parameter_description"><p> Destination <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gio.File]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>source_file_list</p></td>
-<td class="parameter_description"><p>  <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> that got dropped. </p></td>
+<td class="parameter_description"><p>  <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> that got dropped. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GLib.List][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -1191,10 +1580,51 @@ which should be copied/moved/etc. based on the specified <em class="parameter"><
 </div>
 <hr>
 <div class="refsect2">
+<a name="GtkPlacesSidebar-mount"></a><h3>The <code class="literal">“mount”</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a>  *mount_operation,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
+<p>The places sidebar emits this signal when it starts a new operation
+because the user clicked on some location that needs mounting.
+In this way the application using the <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> can track the
+progress of the operation and, for example, show a notification.</p>
+<div class="refsect3">
+<a name="GtkPlacesSidebar-mount.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>the object which received the signal.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>mount_operation</p></td>
+<td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a> that is going to start.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
+<p class="since">Since: <a class="link" href="api-index-3-20.html#api-index-3.20">3.20</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="GtkPlacesSidebar-open-location"></a><h3>The <code class="literal">“open-location”</code> signal</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a>  *sidebar,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>           *location,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a>           *location,
                <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> open_flags,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)</pre>
 <p>The places sidebar emits this signal when the user selects a location
@@ -1202,7 +1632,7 @@ in it.  The calling application should display the contents of that
 location; for example, a file manager should show a list of files in
 the specified location.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.5.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-open-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1217,7 +1647,7 @@ the specified location.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>location</p></td>
-<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> to which the caller should switch. </p></td>
+<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> to which the caller should switch. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gio.File]</span></td>
 </tr>
 <tr>
@@ -1242,32 +1672,40 @@ should be opened.</p></td>
 <a name="GtkPlacesSidebar-populate-popup"></a><h3>The <code class="literal">“populate-popup”</code> signal</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *menu,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *selected_item,
-               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *selected_volume,
+               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>        *container,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a>            *selected_item,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GVolume.html#GVolume-struct"><span class="type">GVolume</span></a>          *selected_volume,
                <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
 <p>The places sidebar emits this signal when the user invokes a contextual
-menu on one of its items.  In the signal handler, the application may
-add extra items to the menu as appropriate.  For example, a file manager
+popup on one of its items. In the signal handler, the application may
+add extra items to the menu as appropriate. For example, a file manager
 may want to add a "Properties" command to the menu.</p>
 <p>It is not necessary to store the <em class="parameter"><code>selected_item</code></em>
  for each menu item;
-during their GtkMenuItem::activate callbacks, the application can use
-<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-location" title="gtk_places_sidebar_get_location ()"><code class="function">gtk_places_sidebar_get_location()</code></a> to get the file to which the item
-refers.</p>
+during their callbacks, the application can use <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-location" title="gtk_places_sidebar_get_location ()"><code class="function">gtk_places_sidebar_get_location()</code></a>
+to get the file to which the item refers.</p>
 <p>The <em class="parameter"><code>selected_item</code></em>
- argument may be <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> in case the selection refers to
-a volume.  In this case, <em class="parameter"><code>selected_volume</code></em>
- will be non-NULL.  In this case,
+ argument may be <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case the selection refers to
+a volume. In this case, <em class="parameter"><code>selected_volume</code></em>
+ will be non-<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. In this case,
 the calling application will have to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> the <em class="parameter"><code>selected_volume</code></em>
  and
-keep it around for the purposes of its menu item's "activate" callback.</p>
-<p>The <em class="parameter"><code>menu</code></em>
- and all its menu items are destroyed after the user
-dismisses the menu.  The menu is re-created (and thus, this signal is
+keep it around to use it in the callback.</p>
+<p>The <em class="parameter"><code>container</code></em>
+ and all its contents are destroyed after the user
+dismisses the popup. The popup is re-created (and thus, this signal is
 emitted) every time the user activates the contextual menu.</p>
+<p>Before 3.18, the <em class="parameter"><code>container</code></em>
+ always was a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>, and you were expected
+to add your items as <a href="GtkMenuItem.html#GtkMenuItem-struct"><span class="type">GtkMenuItems</span></a>. Since 3.18, the popup may be implemented
+as a <a class="link" href="GtkPopover.html" title="GtkPopover"><span class="type">GtkPopover</span></a>, in which case <em class="parameter"><code>container</code></em>
+ will be something else, e.g. a
+<a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>, to which you may add <a href="GtkModelButton.html#GtkModelButton-struct"><span class="type">GtkModelButtons</span></a> or other widgets, such as
+<span class="type">GtkEntries</span>, <a href="GtkSpinButton.html#GtkSpinButton-struct"><span class="type">GtkSpinButtons</span></a>, etc. If your application can deal with this
+situation, you can set <span class="type">“populate-all”</span> to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to request
+that this signal is emitted for populating popovers as well.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.6.8"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-populate-popup.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1281,19 +1719,19 @@ emitted) every time the user activates the contextual menu.</p>
 <td class="parameter_annotations"> </td>
 </tr>
 <tr>
-<td class="parameter_name"><p>menu</p></td>
-<td class="parameter_description"><p> a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gtk.Menu]</span></td>
+<td class="parameter_name"><p>container</p></td>
+<td class="parameter_description"><p> a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> or another <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gtk.Widget]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>selected_item</p></td>
-<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> with the item to which the menu should refer, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> in the case of a <em class="parameter"><code>selected_volume</code></em>
+<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> with the item to which the popup should refer, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> in the case of a <em class="parameter"><code>selected_volume</code></em>
 . </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gio.File][<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>selected_volume</p></td>
-<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GVolume.html"><span class="type">GVolume</span></a> if the selected item is a volume, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if it is a file. </p></td>
+<td class="parameter_description"><p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GVolume.html#GVolume-struct"><span class="type">GVolume</span></a> if the selected item is a volume, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if it is a file. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gio.Volume][<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>
@@ -1318,8 +1756,13 @@ application to present an way to connect directly to a network server.
 For example, the application may bring up a dialog box asking for
 a URL like "sftp://ftp.example.com".  It is up to the application to create
 the corresponding mount by using, for example, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#g-file-mount-enclosing-volume"><code class="function">g_file_mount_enclosing_volume()</code></a>.</p>
+<div class="warning">
+<p><code class="literal">GtkPlacesSidebar::show-connect-to-server</code> has been deprecated since version 3.18 and should not be used in newly-written code.</p>
+<p>use the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-other-locations" title="The “show-other-locations” signal"><span class="type">“show-other-locations”</span></a> signal
+    to connect to network servers.</p>
+</div>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.7.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-show-connect-to-server.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1341,7 +1784,6 @@ the corresponding mount by using, for example, <a href="/home/vagrant/ruby-gnome
 </table></div>
 </div>
 <p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
-<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1354,7 +1796,7 @@ application to present an way to directly enter a location.
 For example, the application may bring up a dialog box asking for
 a URL like "http://http.example.com".</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.8.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-show-enter-location.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1391,7 +1833,7 @@ application to present an error message.  Most of these messages
 refer to mounting or unmounting media, for example, when a drive
 cannot be started for some reason.</p>
 <div class="refsect3">
-<a name="id-1.3.14.15.14.9.5"></a><h4>Parameters</h4>
+<a name="GtkPlacesSidebar-show-error-message.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1425,6 +1867,131 @@ cannot be started for some reason.</p>
 <p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
 <p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-show-other-locations"></a><h3>The <code class="literal">“show-other-locations”</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
+<p>The places sidebar emits this signal when it needs the calling
+application to present a way to show other locations e.g. drives
+and network access points.
+For example, the application may bring up a page showing persistent
+volumes and discovered network addresses.</p>
+<div class="warning">
+<p><code class="literal">GtkPlacesSidebar::show-other-locations</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
+<p>use the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-other-locations-with-flags" title="The “show-other-locations-with-flags” signal"><span class="type">“show-other-locations-with-flags”</span></a>
+which includes the open flags in order to allow the user to specify to open
+in a new tab or window, in a similar way than <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title="The “open-location” signal"><span class="type">“open-location”</span></a></p>
+</div>
+<div class="refsect3">
+<a name="GtkPlacesSidebar-show-other-locations.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>the object which received the signal.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
+<p class="since">Since: <a class="link" href="api-index-3-18.html#api-index-3.18">3.18</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-show-other-locations-with-flags"></a><h3>The <code class="literal">“show-other-locations-with-flags”</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a>  *sidebar,
+               <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> open_flags,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)</pre>
+<p>The places sidebar emits this signal when it needs the calling
+application to present a way to show other locations e.g. drives
+and network access points.
+For example, the application may bring up a page showing persistent
+volumes and discovered network addresses.</p>
+<div class="refsect3">
+<a name="GtkPlacesSidebar-show-other-locations-with-flags.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>the object which received the signal.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>open_flags</p></td>
+<td class="parameter_description"><p>a single value from <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> specifying how it should be opened.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
+<p class="since">Since: <a class="link" href="api-index-3-20.html#api-index-3.20">3.20</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-unmount"></a><h3>The <code class="literal">“unmount”</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+user_function (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a>  *mount_operation,
+               <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)</pre>
+<p>The places sidebar emits this signal when it starts a new operation
+because the user for example ejected some drive or unmounted a mount.
+In this way the application using the <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> can track the
+progress of the operation and, for example, show a notification.</p>
+<div class="refsect3">
+<a name="GtkPlacesSidebar-unmount.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table 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>sidebar</p></td>
+<td class="parameter_description"><p>the object which received the signal.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>mount_operation</p></td>
+<td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a> that is going to start.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
+<p class="since">Since: <a class="link" href="api-index-3-20.html#api-index-3.20">3.20</a></p>
+</div>
 </div>
 <div class="refsect1">
 <a name="GtkPlacesSidebar.see-also"></a><h2>See Also</h2>
@@ -1432,6 +1999,6 @@ cannot be started for some reason.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.24.1</div>
+<hr>Generated by GTK-Doc V1.25.1</div>
 </body>
 </html>