gdk3 3.1.1-x86-mingw32 → 3.1.2-x86-mingw32

data/vendor/local/include/gtk-3.0/gdk/gdkversionmacros.h

@@ -26,7 +26,7 @@
 
 #define GDK_MAJOR_VERSION (3)
 #define GDK_MINOR_VERSION (22)
-#define GDK_MICRO_VERSION (7)
+#define GDK_MICRO_VERSION (12)
 
 #ifndef _GDK_EXTERN
 #define _GDK_EXTERN extern

data/vendor/local/include/gtk-3.0/gtk/gtkcombobox.h

@@ -182,7 +182,7 @@ void          gtk_combo_box_popup_for_device (GtkComboBox     *combo_box,
 GDK_AVAILABLE_IN_ALL
 void          gtk_combo_box_popdown          (GtkComboBox     *combo_box);
 GDK_AVAILABLE_IN_ALL
-AtkObject*    gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box);
+AtkObject *   gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box);
 
 GDK_AVAILABLE_IN_ALL
 gint          gtk_combo_box_get_id_column        (GtkComboBox *combo_box);

data/vendor/local/include/gtk-3.0/gtk/gtkshow.h

@@ -29,7 +29,7 @@
 
 G_BEGIN_DECLS
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22_FOR(gtk_show_uri_on_window)
 gboolean gtk_show_uri  (GdkScreen   *screen,
                         const gchar *uri,
                         guint32      timestamp,

data/vendor/local/include/gtk-3.0/gtk/gtkversion.h

@@ -64,7 +64,7 @@
  * application compile time, rather than from the library linked
  * against at application run time.
  */
-#define GTK_MICRO_VERSION (7)
+#define GTK_MICRO_VERSION (12)
 
 /**
  * GTK_BINARY_AGE:
@@ -73,7 +73,7 @@
  * application compile time, rather than from the library linked
  * against at application run time.
  */
-#define GTK_BINARY_AGE    (2207)
+#define GTK_BINARY_AGE    (2212)
 
 /**
  * GTK_INTERFACE_AGE:
@@ -82,7 +82,7 @@
  * application compile time, rather than from the library linked
  * against at application run time.
  */
-#define GTK_INTERFACE_AGE (7)
+#define GTK_INTERFACE_AGE (12)
 
 /**
  * GTK_CHECK_VERSION:

data/vendor/local/lib/gtk-3.0/3.0.0/immodules.cache

@@ -1,6 +1,6 @@
 # GTK+ Input Method Modules file
 # Automatically generated file, do not edit
-# Created by Z:/home/vagrant/ruby-gnome2.win32/gdk3/tmp/windows/gtk+/gtk+-3.22.7/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.22.7
+# Created by Z:/home/vagrant/ruby-gnome2.win32/gdk3/tmp/windows/gtk+/gtk+-3.22.12/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.22.12
 #
 # ModulesPath = /home/vagrant/ruby-gnome2.win32/gdk3/vendor/local/lib/gtk-3.0/3.0.0/i686-w64-mingw32/immodules;/home/vagrant/ruby-gnome2.win32/gdk3/vendor/local/lib/gtk-3.0/3.0.0/immodules;/home/vagrant/ruby-gnome2.win32/gdk3/vendor/local/lib/gtk-3.0/i686-w64-mingw32/immodules;/home/vagrant/ruby-gnome2.win32/gdk3/vendor/local/lib/gtk-3.0/immodules
 #

data/vendor/local/lib/libgdk-3.la

@@ -25,7 +25,7 @@ weak_library_names=''
 # Version information for libgdk-3.
 current=2200
 age=2200
-revision=7
+revision=12
 
 # Is this an already installed library?
 installed=yes

data/vendor/local/lib/libgtk-3.la

@@ -25,7 +25,7 @@ weak_library_names=''
 # Version information for libgtk-3.
 current=2200
 age=2200
-revision=7
+revision=12
 
 # Is this an already installed library?
 installed=yes

data/vendor/local/lib/pkgconfig/gail-3.0.pc

@@ -5,7 +5,7 @@ includedir=${prefix}/include
 
 Name: Gail
 Description: GNOME Accessibility Implementation Library
-Version: 3.22.7
+Version: 3.22.12
 Requires: atk gtk+-3.0
 Libs: -L${libdir} -lgailutil-3
 Cflags: -I${includedir}/gail-3.0

data/vendor/local/lib/pkgconfig/gdk-3.0.pc

@@ -6,7 +6,7 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.22.7
+Version: 3.22.12
 Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.14.0 cairo-gobject >= 1.14.0
 Requires.private: gio-2.0 >= 2.49.4     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm -ldwmapi -lsetupapi -lcfgmgr32

data/vendor/local/lib/pkgconfig/gdk-win32-3.0.pc

@@ -6,7 +6,7 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.22.7
+Version: 3.22.12
 Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.14.0 cairo-gobject >= 1.14.0
 Requires.private: gio-2.0 >= 2.49.4     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm -ldwmapi -lsetupapi -lcfgmgr32

data/vendor/local/lib/pkgconfig/gtk+-3.0.pc

@@ -9,7 +9,7 @@ gtk_host=i686-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.22.7
+Version: 3.22.12
 Requires: gdk-3.0 atk >= 2.15.1 cairo >= 1.14.0 cairo-gobject >= 1.14.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.49.4
 Requires.private: atk   epoxy >= 1.0
 Libs: -L${libdir} -lgtk-3 

data/vendor/local/lib/pkgconfig/gtk+-win32-3.0.pc

@@ -9,7 +9,7 @@ gtk_host=i686-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.22.7
+Version: 3.22.12
 Requires: gdk-3.0 atk >= 2.15.1 cairo >= 1.14.0 cairo-gobject >= 1.14.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.49.4
 Requires.private: atk   epoxy >= 1.0
 Libs: -L${libdir} -lgtk-3 

data/vendor/local/share/gir-1.0/Gdk-3.0.gir

@@ -20,7 +20,7 @@ and/or use gtk-doc annotations.  -->
     <alias name="XEvent" c:type="GdkXEvent">
       <doc xml:space="preserve">Used to represent native events (XEvents for the X11
 backend, MSGs for Win32).</doc>
-      <type name="gpointer" c:type="gpointer"/>
+      <type name="none" c:type="void"/>
     </alias>
     <bitfield name="AnchorHints"
               version="3.22"

data/vendor/local/share/gir-1.0/Gtk-3.0.gir

@@ -23,7 +23,7 @@ more information.</doc>
       <type name="Gdk.Rectangle" c:type="GdkRectangle"/>
     </alias>
     <alias name="Stock" c:type="GtkStock">
-      <type name="gpointer" c:type="gpointer"/>
+      <type name="utf8" c:type="char*"/>
     </alias>
     <class name="AboutDialog"
            c:symbol-prefix="about_dialog"
@@ -40,7 +40,7 @@ opened when the user selects the `About` option from the `Help` menu.
 All parts of the dialog are optional.
 
 About dialogs often contain links and email addresses. GtkAboutDialog
-displays these as clickable links. By default, it calls gtk_show_uri()
+displays these as clickable links. By default, it calls gtk_show_uri_on_window()
 when a user clicks one. The behaviour can be overridden with the
 #GtkAboutDialog::activate-link signal.
 
@@ -856,7 +856,7 @@ This should be a string starting with "http://.</doc>
       <glib:signal name="activate-link" when="last" version="2.24">
         <doc xml:space="preserve">The signal which gets emitted to activate a URI.
 Applications may connect to it to override the default behaviour,
-which is to call gtk_show_uri().</doc>
+which is to call gtk_show_uri_on_window().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the link has been activated</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -10169,7 +10169,7 @@ container that has been allocated.</doc>
         <doc xml:space="preserve">the widget should fill the space allocated to it.</doc>
       </member>
     </bitfield>
-    <constant name="BINARY_AGE" value="2207" c:type="GTK_BINARY_AGE">
+    <constant name="BINARY_AGE" value="2212" c:type="GTK_BINARY_AGE">
       <doc xml:space="preserve">Like gtk_get_binary_age(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -13415,8 +13415,11 @@ gtk_button_set_image().</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
         <parameters>
-          <parameter name="icon_name" transfer-ownership="none">
-            <doc xml:space="preserve">an icon name</doc>
+          <parameter name="icon_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">an icon name or %NULL</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="size" transfer-ownership="none">
@@ -27962,7 +27965,7 @@ combobox
 ]|
 
 A GtkComboBox with an entry has a single CSS node with name combobox. It
-contains a bx with the .linked class and that box contains an entry and a
+contains a box with the .linked class. That box contains an entry and a
 button, both with the .combo class added.
 The button also contains another node with name arrow.</doc>
       <implements name="Atk.ImplementorIface"/>
@@ -28394,7 +28397,9 @@ applications should have little use for it.</doc>
         <doc xml:space="preserve">Pops up the menu or dropdown list of @combo_box.
 
 This function is mostly intended for use by accessibility technologies;
-applications should have little use for it.</doc>
+applications should have little use for it.
+
+Before calling this, @combo_box must be mapped, or nothing will happen.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -45892,7 +45897,11 @@ frame
 
 GtkFrame has a main CSS node with name frame and a subnode with
 name border. The border node is used to render the visible border.
-The style class .flat can appear with the main node.</doc>
+
+The border node can be given the style class .flat, which is used by themes
+to disable drawing of the border. To do this from code, call
+gtk_frame_set_shadow_type() with GTK_SHADOW_NONE to add the .flat class or
+any other shadow type to remove it.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <constructor name="new" c:identifier="gtk_frame_new">
@@ -46008,8 +46017,8 @@ gtk_frame_set_shadow_type().</doc>
         </parameters>
       </method>
       <method name="set_label" c:identifier="gtk_frame_set_label">
-        <doc xml:space="preserve">Sets the text of the label. If @label is %NULL,
-the current label is removed.</doc>
+        <doc xml:space="preserve">Removes the current #GtkFrame:label-widget. If @label is not %NULL, creates a
+new #GtkLabel with that text and adds it as the #GtkFrame:label-widget.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -46055,9 +46064,8 @@ default values for a newly created frame are 0.0 and 0.5.</doc>
       </method>
       <method name="set_label_widget"
               c:identifier="gtk_frame_set_label_widget">
-        <doc xml:space="preserve">Sets the label widget for the frame. This is the widget that
-will appear embedded in the top edge of the frame as a
-title.</doc>
+        <doc xml:space="preserve">Sets the #GtkFrame:label-widget for the frame. This is the widget that
+will appear embedded in the top edge of the frame as a title.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -46076,7 +46084,10 @@ title.</doc>
         </parameters>
       </method>
       <method name="set_shadow_type" c:identifier="gtk_frame_set_shadow_type">
-        <doc xml:space="preserve">Sets the shadow type for @frame.</doc>
+        <doc xml:space="preserve">Sets the #GtkFrame:shadow-type for @frame, i.e. whether it is drawn without
+(GTK_SHADOW_NONE) or with (other values) a visible border. Values other than
+GTK_SHADOW_NONE are treated identically by #GtkFrame. The chosen type is
+applied by removing or adding the .flat class to the CSS node named border.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -47245,7 +47256,7 @@ state for that sequence to #GTK_EVENT_SEQUENCE_DENIED.</doc>
         <doc xml:space="preserve">Returns %TRUE if @gesture is currently handling events corresponding to
 @sequence.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">%TRUE if @gesture is handling @sequence</doc>
+          <doc xml:space="preserve">%TRUE if @gesture is handling @sequence, %FALSE otherwise</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -47253,8 +47264,11 @@ state for that sequence to #GTK_EVENT_SEQUENCE_DENIED.</doc>
             <doc xml:space="preserve">a #GtkGesture</doc>
             <type name="Gesture" c:type="GtkGesture*"/>
           </instance-parameter>
-          <parameter name="sequence" transfer-ownership="none">
-            <doc xml:space="preserve">a #GdkEventSequence</doc>
+          <parameter name="sequence"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GdkEventSequence or %NULL</doc>
             <type name="Gdk.EventSequence" c:type="GdkEventSequence*"/>
           </parameter>
         </parameters>
@@ -51941,7 +51955,7 @@ replaced by the slave corresponding to the new context id.</doc>
 signal in case of conversion failure.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="INTERFACE_AGE" value="7" c:type="GTK_INTERFACE_AGE">
+    <constant name="INTERFACE_AGE" value="12" c:type="GTK_INTERFACE_AGE">
       <doc xml:space="preserve">Like gtk_get_interface_age(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -57319,8 +57333,11 @@ will be updated appropriately.</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
         <parameters>
-          <parameter name="icon_name" transfer-ownership="none">
-            <doc xml:space="preserve">an icon name</doc>
+          <parameter name="icon_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">an icon name or %NULL</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="size" transfer-ownership="none">
@@ -57766,8 +57783,11 @@ nothing, if you set the animation to %NULL).</doc>
             <doc xml:space="preserve">a #GtkImage</doc>
             <type name="Image" c:type="GtkImage*"/>
           </instance-parameter>
-          <parameter name="icon_name" transfer-ownership="none">
-            <doc xml:space="preserve">an icon name</doc>
+          <parameter name="icon_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">an icon name or %NULL</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="size" transfer-ownership="none">
@@ -57875,8 +57895,11 @@ nothing, if you set the animation to %NULL).</doc>
             <doc xml:space="preserve">a #GtkImage</doc>
             <type name="Image" c:type="GtkImage*"/>
           </instance-parameter>
-          <parameter name="surface" transfer-ownership="none">
-            <doc xml:space="preserve">a cairo_surface_t</doc>
+          <parameter name="surface"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a cairo_surface_t or %NULL</doc>
             <type name="cairo.Surface" c:type="cairo_surface_t*"/>
           </parameter>
         </parameters>
@@ -60867,7 +60890,7 @@ The default bindings for this signal are all forms of the Enter key.</doc>
       <glib:signal name="activate-link" when="last" version="2.18">
         <doc xml:space="preserve">The signal which gets emitted to activate a URI.
 Applications may connect to it to override the default behaviour,
-which is to call gtk_show_uri().</doc>
+which is to call gtk_show_uri_on_window().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the link has been activated</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -62071,7 +62094,7 @@ to the constructor is used as a label for the widget.
 The URI bound to a GtkLinkButton can be set specifically using
 gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().
 
-By default, GtkLinkButton calls gtk_show_uri() when the button is
+By default, GtkLinkButton calls gtk_show_uri_on_window() when the button is
 clicked. This behaviour can be overridden by connecting to the
 #GtkLinkButton::activate-link signal and returning %TRUE from the
 signal handler.
@@ -62229,7 +62252,7 @@ different color.</doc>
         <doc xml:space="preserve">The ::activate-link signal is emitted each time the #GtkLinkButton
 has been clicked.
 
-The default handler will call gtk_show_uri() with the URI stored inside
+The default handler will call gtk_show_uri_on_window() with the URI stored inside
 the #GtkLinkButton:uri property.
 
 To override the default behavior, you can connect to the ::activate-link
@@ -64787,7 +64810,7 @@ against at application run time.</doc>
       <doc xml:space="preserve">The maximum length of sequences in compose tables.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MICRO_VERSION" value="7" c:type="GTK_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="12" c:type="GTK_MICRO_VERSION">
       <doc xml:space="preserve">Like gtk_get_micro_version(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -75237,7 +75260,7 @@ location.
 
 # CSS nodes
 
-GtkPlacesSidebar uses a single CSS node with name placesidebar and style
+GtkPlacesSidebar uses a single CSS node with name placessidebar and style
 class .sidebar.
 
 Among the children of the places sidebar, the following style classes can
@@ -83378,10 +83401,7 @@ reached.
 The value parameter is unrounded.  An application that overrides
 the GtkRange::change-value signal is responsible for clamping the
 value to the desired number of decimal digits; the default GTK+
-handler clamps the value based on #GtkRange:round-digits.
-
-It is not possible to use delayed update policies in an overridden
-#GtkRange::change-value handler.</doc>
+handler clamps the value based on #GtkRange:round-digits.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE to prevent other handlers from being invoked for
     the signal, %FALSE to propagate the signal further</doc>
@@ -90223,9 +90243,10 @@ To remove marks from a scale, use gtk_scale_clear_marks().</doc>
         </parameters>
       </method>
       <method name="get_digits" c:identifier="gtk_scale_get_digits">
-        <doc xml:space="preserve">Gets the number of decimal places that are displayed in the value.</doc>
+        <doc xml:space="preserve">Gets the number of decimal places to which the value is rounded on change.
+This number is also used by the default #GtkScale::format-value handler.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the number of decimal places that are displayed</doc>
+          <doc xml:space="preserve">the number of decimal places</doc>
           <type name="gint" c:type="gint"/>
         </return-value>
         <parameters>
@@ -90334,9 +90355,9 @@ values are undefined.</doc>
         </parameters>
       </method>
       <method name="set_digits" c:identifier="gtk_scale_set_digits">
-        <doc xml:space="preserve">Sets the number of decimal places that are displayed in the value.
-Also causes the value of the adjustment to be rounded off to this
-number of digits, so the retrieved value matches the value the user saw.
+        <doc xml:space="preserve">Sets the number of decimal places to which the value is rounded when it is
+changed. This also sets the number of digits shown in the displayed value
+when using the default handler for the #GtkScale::format-value signal.
 
 Note that rounding to a small number of digits can interfere with
 the smooth autoscrolling that is built into #GtkScale. As an alternative,
@@ -90351,8 +90372,7 @@ value yourself.</doc>
             <type name="Scale" c:type="GtkScale*"/>
           </instance-parameter>
           <parameter name="digits" transfer-ownership="none">
-            <doc xml:space="preserve">the number of decimal places to display,
-    e.g. use 1 to display 1.0, 2 to display 1.00, etc</doc>
+            <doc xml:space="preserve">the number of decimal places to which the value will be rounded</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
         </parameters>
@@ -90412,6 +90432,9 @@ and the current value.</doc>
         </parameters>
       </method>
       <property name="digits" writable="1" transfer-ownership="none">
+        <doc xml:space="preserve">The number of decimal places to which the value is rounded when it is
+changed. This also sets the number of digits shown in the displayed value
+when using the default handler for the #GtkScale::format-value signal.</doc>
         <type name="gint" c:type="gint"/>
       </property>
       <property name="draw-value" writable="1" transfer-ownership="none">
@@ -90434,6 +90457,9 @@ and the current value.</doc>
 Connect a signal handler which returns an allocated string representing
 @value. That string will then be used to display the scale's value.
 
+If no user-provided handlers are installed, the value will be displayed on
+its own, rounded according to the value of the #GtkScale:digits property.
+
 Here's an example signal handler which displays a value 1.0 as
 with "--&gt;1.0&lt;--".
 |[&lt;!-- language="C" --&gt;
@@ -91408,16 +91434,15 @@ the scrolled window adjustments in a given orientation.</doc>
       <doc xml:space="preserve">The #GtkScrollbar widget is a horizontal or vertical scrollbar,
 depending on the value of the #GtkOrientable:orientation property.
 
-The position of the thumb in a scrollbar is controlled by the scroll
-adjustments. See #GtkAdjustment for the fields in an adjustment - for
-#GtkScrollbar, the #GtkAdjustment:value field represents the position
-of the scrollbar, which must be between the #GtkAdjustment:lower field
-and #GtkAdjustment:upper - #GtkAdjustment:page-size. The
-#GtkAdjustment:page-size field represents the size of the visible
-scrollable area. The #GtkAdjustment:step-increment and
-#GtkAdjustment:page-increment fields are properties when the user asks to
-step down (using the small stepper arrows) or page down (using for
-example the `Page Down` key).
+Its position and movement are controlled by the adjustment that is passed to
+or created by gtk_scrollbar_new(). See #GtkAdjustment for more details. The
+#GtkAdjustment:value field sets the position of the thumb and must be between
+#GtkAdjustment:lower and #GtkAdjustment:upper - #GtkAdjustment:page-size. The
+#GtkAdjustment:page-size represents the size of the visible scrollable area.
+The fields #GtkAdjustment:step-increment and #GtkAdjustment:page-increment
+fields are added to or subtracted from the #GtkAdjustment:value when the user
+asks to move by a step (using e.g. the cursor arrow keys or, if present, the
+stepper buttons) or by a page (using e.g. the Page Down/Up keys).
 
 # CSS nodes
 
@@ -91514,31 +91539,21 @@ classes related to overlay scrolling (.overlay-indicator, .dragging, .hovering).
            glib:type-name="GtkScrolledWindow"
            glib:get-type="gtk_scrolled_window_get_type"
            glib:type-struct="ScrolledWindowClass">
-      <doc xml:space="preserve">GtkScrolledWindow is a #GtkBin subclass: it’s a container
-the accepts a single child widget. GtkScrolledWindow adds scrollbars
-to the child widget and optionally draws a beveled frame around the
-child widget.
-
-The scrolled window can work in two ways. Some widgets have native
-scrolling support; these widgets implement the #GtkScrollable interface.
-Widgets with native scroll support include #GtkTreeView, #GtkTextView,
-and #GtkLayout.
-
-For widgets that lack native scrolling support, the #GtkViewport
-widget acts as an adaptor class, implementing scrollability for child
-widgets that lack their own scrolling capabilities. Use #GtkViewport
-to scroll child widgets such as #GtkGrid, #GtkBox, and so on.
-
-If a widget has native scrolling abilities, it can be added to the
-GtkScrolledWindow with gtk_container_add(). If a widget does not, you
-must first add the widget to a #GtkViewport, then add the #GtkViewport
-to the scrolled window. gtk_container_add() will do this for you for
-widgets that don’t implement #GtkScrollable natively, so you can
-ignore the presence of the viewport.
+      <doc xml:space="preserve">GtkScrolledWindow is a container that accepts a single child widget, makes
+that child scrollable using either internally added scrollbars or externally
+associated adjustments, and optionally draws a frame around the child.
+
+Widgets with native scrolling support, i.e. those whose classes implement the
+#GtkScrollable interface, are added directly. For other types of widget, the
+class #GtkViewport acts as an adaptor, giving scrollability to other widgets.
+GtkScrolledWindow’s implementation of gtk_container_add() intelligently
+accounts for whether or not the added child is a #GtkScrollable. If it isn’t,
+#GtkScrolledWindow wraps the child in a #GtkViewport and adds that for you.
+Therefore, you can just add any child widget and not worry about the details.
 
 If gtk_container_add() has added a #GtkViewport for you, you can remove
-both your added child widget from the #GtkViewport and the #GtkViewport
-from the GtkScrolledWindow with either of the calls
+both your added child widget from the #GtkViewport, and the #GtkViewport
+from the GtkScrolledWindow, with either of these calls:
 |[&lt;!-- language="C" --&gt;
 gtk_container_remove (GTK_CONTAINER (scrolled_window),
                       child_widget);
@@ -91547,15 +91562,13 @@ gtk_container_remove (GTK_CONTAINER (scrolled_window),
                       gtk_bin_get_child (GTK_BIN (scrolled_window)));
 ]|
 
-The position of the scrollbars is controlled by the scroll adjustments.
-See #GtkAdjustment for the fields in an adjustment — for
-#GtkScrollbar, used by GtkScrolledWindow, the “value” field
-represents the position of the scrollbar, which must be between the
-“lower” field and “upper - page_size.” The “page_size” field
-represents the size of the visible scrollable area. The
-“step_increment” and “page_increment” fields are used when the user
-asks to step down (using the small stepper arrows) or page down (using
-for example the PageDown key).
+Unless #GtkScrolledWindow:policy is GTK_POLICY_NEVER or GTK_POLICY_EXTERNAL,
+GtkScrolledWindow adds internal #GtkScrollbar widgets around its child. The
+scroll position of the child, and if applicable the scrollbars, is controlled
+by the #GtkScrolledWindow:hadjustment and #GtkScrolledWindow:vadjustment
+that are associated with the GtkScrolledWindow. See the docs on #GtkScrollbar
+for the details, but note that the “step_increment” and “page_increment”
+fields are only effective if the policy causes scrollbars to be present.
 
 If a GtkScrolledWindow doesn’t behave quite as you would like, or
 doesn’t have exactly the right layout, it’s very possible to set up
@@ -92828,7 +92841,7 @@ emits the #GtkSearchEntry::search-changed signal which can
 be used instead of the #GtkEditable::changed signal.
 
 The #GtkSearchEntry::previous-match, #GtkSearchEntry::next-match
-and #GtkSearchEntry::stop-search signals can be uesd to implement
+and #GtkSearchEntry::stop-search signals can be used to implement
 moving between search results and ending the search.
 
 Often, GtkSearchEntry will be fed events by means of being
@@ -135066,11 +135079,7 @@ a widget to be mapped if it isn’t already.</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="mnemonic_activate" invoker="mnemonic_activate">
-        <doc xml:space="preserve">Emits the #GtkWidget::mnemonic-activate signal.
-
-The default handler for this signal activates the @widget if
-@group_cycling is %FALSE, and just grabs the focus if @group_cycling
-is %TRUE.</doc>
+        <doc xml:space="preserve">Emits the #GtkWidget::mnemonic-activate signal.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the signal has been handled</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -138984,10 +138993,13 @@ interested in whether there was an intersection.</doc>
             <type name="Gdk.Rectangle" c:type="const GdkRectangle*"/>
           </parameter>
           <parameter name="intersection"
+                     direction="out"
+                     caller-allocates="1"
                      transfer-ownership="none"
-                     nullable="1"
+                     optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">rectangle to store intersection of @widget and @area</doc>
+            <doc xml:space="preserve">rectangle to store
+  intersection of @widget and @area</doc>
             <type name="Gdk.Rectangle" c:type="GdkRectangle*"/>
           </parameter>
         </parameters>
@@ -139253,11 +139265,7 @@ a widget to be mapped if it isn’t already.</doc>
       </method>
       <method name="mnemonic_activate"
               c:identifier="gtk_widget_mnemonic_activate">
-        <doc xml:space="preserve">Emits the #GtkWidget::mnemonic-activate signal.
-
-The default handler for this signal activates the @widget if
-@group_cycling is %FALSE, and just grabs the focus if @group_cycling
-is %TRUE.</doc>
+        <doc xml:space="preserve">Emits the #GtkWidget::mnemonic-activate signal.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the signal has been handled</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -143186,13 +143194,16 @@ automatically for all new windows.</doc>
         </parameters>
       </glib:signal>
       <glib:signal name="mnemonic-activate" when="last">
+        <doc xml:space="preserve">The default handler for this signal activates @widget if @group_cycling
+is %FALSE, or just makes @widget grab focus if @group_cycling is %TRUE.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE to stop other handlers from being invoked for the event.
 %FALSE to propagate the event further.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
-          <parameter name="arg1" transfer-ownership="none">
+          <parameter name="group_cycling" transfer-ownership="none">
+            <doc xml:space="preserve">%TRUE if there are other widgets with the same mnemonic</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
         </parameters>
@@ -154875,18 +154886,13 @@ reused for future invocations of this function.</doc>
               c:identifier="gtk_show_uri"
               version="2.14"
               throws="1">
-      <doc xml:space="preserve">This is a convenience function for launching the default application
-to show the uri. The uri must be of a form understood by GIO (i.e. you
-need to install gvfs to get support for uri schemes such as http://
-or ftp://, as only local files are handled by GIO itself).
-Typical examples are
-- `file:///home/gnome/pict.jpg`
-- `http://www.gnome.org`
-- `mailto:me@gnome.org`
+      <doc xml:space="preserve">A convenience function for launching the default application
+to show the uri. Like gtk_show_uri_on_window(), but takes a screen
+as transient parent instead of a window.
 
-Ideally the timestamp is taken from the event triggering
-the gtk_show_uri() call. If timestamp is not known you can take
-%GDK_CURRENT_TIME.</doc>
+Note that this function is deprecated as it does not pass the necessary
+information for helpers to parent their dialog properly, when run from
+sandboxed applications for example.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE on success, %FALSE on error</doc>
         <type name="gboolean" c:type="gboolean"/>
@@ -154914,9 +154920,21 @@ the gtk_show_uri() call. If timestamp is not known you can take
               c:identifier="gtk_show_uri_on_window"
               version="3.22"
               throws="1">
-      <doc xml:space="preserve">A convenience function for launching the default application
-to show the uri. Like gtk_show_uri(), but takes a window
-as transient parent instead of a screen.</doc>
+      <doc xml:space="preserve">This is a convenience function for launching the default application
+to show the uri. The uri must be of a form understood by GIO (i.e. you
+need to install gvfs to get support for uri schemes such as http://
+or ftp://, as only local files are handled by GIO itself).
+Typical examples are
+- `file:///home/gnome/pict.jpg`
+- `http://www.gnome.org`
+- `mailto:me@gnome.org`
+
+Ideally the timestamp is taken from the event triggering
+the gtk_show_uri() call. If timestamp is not known you can take
+%GDK_CURRENT_TIME.
+
+This is the recommended call to be used as it passes information
+necessary for sandbox helpers to parent their dialogs properly.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%TRUE on success, %FALSE on error</doc>
         <type name="gboolean" c:type="gboolean"/>