gdk3 3.0.8-x64-mingw32 → 3.0.9-x64-mingw32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c6fe173ee08aa1e950fecec1c1d5b59711f5ea7f
-  data.tar.gz: 6bd2109344c2b970c71e67bc563f3f12b92d9b06
+  metadata.gz: 0bc3cdcbfeff8864ddfd7f6441a9021e501f6739
+  data.tar.gz: 27c7effddd63e02ddb965dcba621d89c7cf7f5ba
 SHA512:
-  metadata.gz: abebf29e15059f8194aed5e010e77123efdf8fcce200364610c93e81fd7985a6fb019727e7a6ce268b61431f9b450b5d3f144d98782c9c95bcca9edb6421578d
-  data.tar.gz: 91b97b3a2bde8435f8cce08606314ea8a15b7ce8f649f98c1a54164556ca0504be436ed81b6df8b918b6c2394464db08d0cc4ea42b800027502ce384e7d5f59c
+  metadata.gz: f290d2690d8c951a8ce4e702203f859762257547082006ea57ebcc31f4581d2017493f4cc396c7d5e4f9718dc53287b1589a3577fabc516ee73332853eb49ef1
+  data.tar.gz: 2baa210069cf6b72a04192fd88c7534f3af68e7e5b8e2f14e8fcaadc58e2b203f2258961658b9b6b7b5402329878f40f6fb0b8b5334d6c8ec03540ffd3ccd8a8

data/Rakefile

@@ -59,7 +59,7 @@ package_task = GNOME2::Rake::PackageTask.new do |package|
       :name => "gtk+",
       :download_site => :gnome,
       :label => "GTK+",
-      :version => "3.20.2",
+      :version => "3.20.8",
       :compression_method => "xz",
       :windows => {
         :configure_args => [
@@ -92,6 +92,7 @@ package_task = GNOME2::Rake::PackageTask.new do |package|
       :version => "3.20",
       :compression_method => "xz",
       :windows => {
+        :use_gobject_introspection => false,
         :configure_args => [],
         :build_concurrently => false,
         :built_file => "share/icons/Adwaita/index.theme",

data/lib/gdk3/deprecated.rb

@@ -18,7 +18,7 @@ module Gdk
   extend GLib::Deprecatable
   define_deprecated_enums :GrabStatus, 'GRAB'
   define_deprecated_enums :Status
-  define_deprecated_const :Image, :raise => "Use 'Gdk::Pixbuf' or 'Cairo::Surface' instead."
+  define_deprecated_const :Image, :raise => "Use 'GdkPixbuf::Pixbuf' or 'Cairo::Surface' instead."
   define_deprecated_const :Colormap, :raise => "Use 'Gdk::Visual' instead."
   define_deprecated_const :Input, :raise => "Use 'GLib::IOChannel' instead."
   define_deprecated_const :X11, 'GdkX11'
@@ -143,10 +143,10 @@ module Gdk
     define_deprecated_method :initialize, :raise => "Use 'Gdk::Window#create_similar_surface'."
     define_deprecated_singleton_method :create_from_data, :raise => "Use 'Cairo::ImageSurface.new'."
     define_deprecated_singleton_method :create_from_xbm, :raise => "Use 'Cairo::ImageSurface.new'."
-    define_deprecated_singleton_method :create_from_xpm, :raise => "Use 'Gdk::Pixbuf.new'."
-    define_deprecated_singleton_method :create_from_xpm_d, :raise => "Use 'Gdk::Pixbuf.new'."
-    define_deprecated_singleton_method :colormap_create_from_xpm, :raise => "Use 'Gdk::Pixbuf.new'."
-    define_deprecated_singleton_method :colormap_create_from_xpm_d, :raise => "Use 'Gdk::Pixbuf.new'."
+    define_deprecated_singleton_method :create_from_xpm, :raise => "Use 'GdkPixbuf::Pixbuf.new'."
+    define_deprecated_singleton_method :create_from_xpm_d, :raise => "Use 'GdkPixbuf::Pixbuf.new'."
+    define_deprecated_singleton_method :colormap_create_from_xpm, :raise => "Use 'GdkPixbuf::Pixbuf.new'."
+    define_deprecated_singleton_method :colormap_create_from_xpm_d, :raise => "Use 'GdkPixbuf::Pixbuf.new'."
     define_deprecated_singleton_method :foreign_new, :raise => "Don't use this method."
     define_deprecated_singleton_method :lookup, :raise => "Don't use this method."
   end

data/test/test-gdk-cursor.rb

@@ -24,7 +24,7 @@ class TestGdkCursor < Test::Unit::TestCase
     end
 
     test "pixbuf" do
-      pixbuf = Gdk::Pixbuf.new(:file => fixture_path("ruby-gnome2-logo.png"))
+      pixbuf = GdkPixbuf::Pixbuf.new(:file => fixture_path("ruby-gnome2-logo.png"))
       cursor = Gdk::Cursor.new(pixbuf, 0, 0)
       assert_equal(Gdk::CursorType::CURSOR_IS_PIXMAP, cursor.cursor_type)
     end

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

@@ -26,7 +26,7 @@
 
 #define GDK_MAJOR_VERSION (3)
 #define GDK_MINOR_VERSION (20)
-#define GDK_MICRO_VERSION (2)
+#define GDK_MICRO_VERSION (8)
 
 #ifndef _GDK_EXTERN
 #define _GDK_EXTERN extern

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

@@ -107,7 +107,7 @@ struct _GtkFlowBoxChildClass
  * Called for flow boxes that are bound to a #GListModel with
  * gtk_flow_box_bind_model() for each item that gets added to the model.
  *
- * Returns: a #GtkWidget that represents @item
+ * Returns: (transfer full): a #GtkWidget that represents @item
  *
  * Since: 3.18
  */

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

@@ -164,7 +164,7 @@ struct _GtkTextViewClass
 {
   GtkContainerClass parent_class;
 
-  /*< public */
+  /*< public >*/
 
   void (* populate_popup)        (GtkTextView      *text_view,
                                   GtkWidget        *popup);

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 (2)
+#define GTK_MICRO_VERSION (8)
 
 /**
  * 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    (2002)
+#define GTK_BINARY_AGE    (2008)
 
 /**
  * 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 (2)
+#define GTK_INTERFACE_AGE (8)
 
 /**
  * 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.win64/gdk3/tmp/windows/gtk+/gtk+-3.20.2/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.20.2
+# Created by Z:/home/vagrant/ruby-gnome2.win64/gdk3/tmp/windows/gtk+/gtk+-3.20.8/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.20.8
 #
 # ModulesPath = /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/gtk-3.0/3.0.0/x86_64-w64-mingw32/immodules;/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/gtk-3.0/3.0.0/immodules;/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/gtk-3.0/x86_64-w64-mingw32/immodules;/home/vagrant/ruby-gnome2.win64/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=2000
 age=2000
-revision=2
+revision=8
 
 # 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=2000
 age=2000
-revision=2
+revision=8
 
 # 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.20.2
+Version: 3.20.8
 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.20.2
+Version: 3.20.8
 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.45.8     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm -ldwmapi

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

@@ -6,7 +6,7 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.20.2
+Version: 3.20.8
 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.45.8     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm -ldwmapi

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

@@ -9,7 +9,7 @@ gtk_host=x86_64-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.20.2
+Version: 3.20.8
 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.45.8
 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=x86_64-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.20.2
+Version: 3.20.8
 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.45.8
 Requires.private: atk   epoxy >= 1.0
 Libs: -L${libdir} -lgtk-3 

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

@@ -17183,7 +17183,7 @@ Mod3,...) and set the corresponding bits in @state.
 This function is useful when matching key events against
 accelerators.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">%TRUE if no virtual modifiers were mapped to the
+          <doc xml:space="preserve">%FALSE if two virtual modifiers were mapped to the
     same non-virtual modifier. Note that %FALSE is also returned
     if a virtual modifier is mapped to a non-virtual modifier that
     was already set in @state.</doc>
@@ -20406,7 +20406,26 @@ call gdk_gl_context_make_current() or gdk_gl_context_realize().</doc>
 given @window.
 
 Initially the surface contents are all 0 (transparent if contents
-have transparency, black otherwise.)</doc>
+have transparency, black otherwise.)
+
+The @width and @height of the new surface are not affected by
+the scaling factor of the @window, or by the @scale argument; they
+are the size of the surface in device pixels. If you wish to create
+an image surface capable of holding the contents of @window you can
+use:
+
+|[&lt;!-- language="C" --&gt;
+  int scale = gdk_window_get_scale_factor (window);
+  int width = gdk_window_get_width (window) * scale;
+  int height = gdk_window_get_height (window) * scale;
+
+  // format is set elsewhere
+  cairo_surface_t *surface =
+    gdk_window_create_similar_image_surface (window,
+                                             format,
+                                             width, height,
+                                             scale);
+]|</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a pointer to the newly allocated surface. The caller
 owns the surface and should call cairo_surface_destroy() when done

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

@@ -4888,7 +4888,7 @@ for setting these properties.
 The action will be looked up in action groups that are found among
 the widgets ancestors. Most commonly, these will be the actions with
 the “win.” or “app.” prefix that are associated with the #GtkApplicationWindow
-or "GtkApplication, but other action groups that are added with
+or #GtkApplication, but other action groups that are added with
 gtk_widget_insert_action_group() will be consulted as well.</doc>
       <prerequisite name="Widget"/>
       <virtual-method name="get_action_name"
@@ -7766,8 +7766,8 @@ If there is a resource located at "gtk/help-overlay.ui" which
 defines a #GtkShortcutsWindow with ID "help_overlay" then GtkApplication
 associates an instance of this shortcuts window with each
 #GtkApplicationWindow and sets up keyboard accelerators (Control-F1
-and Control-?) to open it. To create an menu item that displays the
-shortcuts window associate the item with the action win.show-help-overlay.
+and Control-?) to open it. To create a menu item that displays the
+shortcuts window, associate the item with the action win.show-help-overlay.
 
 ## A simple application ## {#gtkapplication}
 
@@ -8076,7 +8076,10 @@ gtk_application_set_menubar().</doc>
       <method name="get_window_by_id"
               c:identifier="gtk_application_get_window_by_id"
               version="3.6">
-        <doc xml:space="preserve">Returns the #GtkApplicationWindow with the given ID.</doc>
+        <doc xml:space="preserve">Returns the #GtkApplicationWindow with the given ID.
+
+The ID of a #GtkApplicationWindow can be retrieved with
+gtk_application_window_get_id().</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the window with ID @id, or
   %NULL if there is no window with this ID</doc>
@@ -8130,7 +8133,7 @@ that should not be interrupted, such as creating a CD or DVD. The
 types of actions that may be blocked are specified by the @flags
 parameter. When the application completes the operation it should
 call gtk_application_uninhibit() to remove the inhibitor. Note that
-an application can have multiple inhibitors, and all of the must
+an application can have multiple inhibitors, and all of them must
 be individually removed. Inhibitors are also cleared when the
 application exits.
 
@@ -8327,7 +8330,10 @@ given action. The first item in @accels will be the primary
 accelerator, which may be displayed in the UI.
 
 To remove all accelerators for an action, use an empty, zero-terminated
-array for @accels.</doc>
+array for @accels.
+
+For the @detailed_action_name, see g_action_parse_detailed_name() and
+g_action_print_detailed_name().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -8582,7 +8588,7 @@ through gtk_application_remove_window().</doc>
            glib:type-name="GtkApplicationWindow"
            glib:get-type="gtk_application_window_get_type"
            glib:type-struct="ApplicationWindowClass">
-      <doc xml:space="preserve">GtkApplicationWindow is a #GtkWindow subclass that offers some
+      <doc xml:space="preserve">#GtkApplicationWindow is a #GtkWindow subclass that offers some
 extra functionality for better integration with #GtkApplication
 features.  Notably, it can handle both the application menu as well
 as the menubar. See gtk_application_set_app_menu() and
@@ -8596,9 +8602,9 @@ prefix and application-wide actions are prefixed with the “app.”
 prefix.  Actions must be addressed with the prefixed name when
 referring to them from a #GMenuModel.
 
-Note that widgets that are placed inside a GtkApplicationWindow
+Note that widgets that are placed inside a #GtkApplicationWindow
 can also activate these actions, if they implement the
-GtkActionable interface.
+#GtkActionable interface.
 
 As with #GtkApplication, the GDK lock will be acquired when
 processing actions arriving from other processes and should therefore
@@ -10148,7 +10154,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="2002" c:type="GTK_BINARY_AGE">
+    <constant name="BINARY_AGE" value="2008" 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>
@@ -42556,8 +42562,7 @@ mode allows it.</doc>
       </virtual-method>
       <method name="bind_model"
               c:identifier="gtk_flow_box_bind_model"
-              version="3.18"
-              introspectable="0">
+              version="3.18">
         <doc xml:space="preserve">Binds @model to @box.
 
 If @box was already bound to a model, that previous binding is
@@ -43685,11 +43690,10 @@ it can be used by applications for their own purposes.</doc>
     </record>
     <callback name="FlowBoxCreateWidgetFunc"
               c:type="GtkFlowBoxCreateWidgetFunc"
-              version="3.18"
-              introspectable="0">
+              version="3.18">
       <doc xml:space="preserve">Called for flow boxes that are bound to a #GListModel with
 gtk_flow_box_bind_model() for each item that gets added to the model.</doc>
-      <return-value>
+      <return-value transfer-ownership="full">
         <doc xml:space="preserve">a #GtkWidget that represents @item</doc>
         <type name="Widget" c:type="GtkWidget*"/>
       </return-value>
@@ -46773,7 +46777,11 @@ on @gesture, or %NULL if the gesture is not being interacted.</doc>
         </parameters>
       </method>
       <method name="get_last_event" c:identifier="gtk_gesture_get_last_event">
-        <doc xml:space="preserve">Returns the last event that was processed for @sequence.</doc>
+        <doc xml:space="preserve">Returns the last event that was processed for @sequence.
+
+Note that the returned pointer is only valid as long as the @sequence
+is still interpreted by the @gesture. If in doubt, you should make
+a copy of the event.</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The last event from @sequence</doc>
           <type name="Gdk.Event" c:type="const GdkEvent*"/>
@@ -51632,7 +51640,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="2" c:type="GTK_INTERFACE_AGE">
+    <constant name="INTERFACE_AGE" value="8" 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>
@@ -58306,7 +58314,7 @@ numeric response, and the content of the element is the id of widget
 # CSS nodes
 
 GtkInfoBar has a single CSS node with name infobar. The node may get
-one of the style classes .info, warning, .error or .question, depending
+one of the style classes .info, .warning, .error or .question, depending
 on the message type.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
@@ -60381,7 +60389,7 @@ used for the mnemonic accelerator key.</doc>
         <doc xml:space="preserve">The angle that the baseline of the label makes with the horizontal,
 in degrees, measured counterclockwise. An angle of 90 reads from
 from bottom to top, an angle of 270, from top to bottom. Ignored
-if the label is selectable, wrapped, or ellipsized.</doc>
+if the label is selectable.</doc>
         <type name="gdouble" c:type="gdouble"/>
       </property>
       <property name="attributes" writable="1" transfer-ownership="none">
@@ -64467,7 +64475,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="2" c:type="GTK_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="8" 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>
@@ -68227,7 +68235,7 @@ own extra content to that box and it will appear below those labels.
 See gtk_dialog_get_content_area() for the corresponding
 function in the parent #GtkDialog.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">A #GtkVBox corresponding to the
+          <doc xml:space="preserve">A #GtkBox corresponding to the
     “message area” in the @message_dialog.</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
@@ -89000,13 +89008,14 @@ the mark. It can be translated with the usual ”translatable” and
 # CSS nodes
 
 |[&lt;!-- language="plain" --&gt;
-scale[.fine-tune]
+scale[.fine-tune][.marks-before][.marks-after]
 ├── marks.top
 │   ├── mark
 │   ┊    ├── [label]
 │   ┊    ╰── indicator
 ┊   ┊
 │   ╰── mark
+├── [value]
 ├── contents
 │   ╰── trough
 │       ├── slider
@@ -89040,7 +89049,13 @@ either the .top or .bottom style class.
 The mark node has a subnode named indicator. If the mark has text, it also
 has a subnode named label. When the mark is either above or left of the
 scale, the label subnode is the first when present. Otherwise, the indicator
-subnode is the first.</doc>
+subnode is the first.
+
+The main CSS node gets the 'marks-before' and/or 'marks-after' style classes
+added depending on what marks are present.
+
+If the scale is displaying the value (see #GtkScale:draw-value), there is
+subnode with name value.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <implements name="Orientable"/>
@@ -90126,7 +90141,10 @@ at the right position.</doc>
             <doc xml:space="preserve">a #GtkScrollable</doc>
             <type name="Scrollable" c:type="GtkScrollable*"/>
           </instance-parameter>
-          <parameter name="border" transfer-ownership="none">
+          <parameter name="border"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none">
             <doc xml:space="preserve">return location for the results</doc>
             <type name="Border" c:type="GtkBorder*"/>
           </parameter>
@@ -90149,7 +90167,10 @@ at the right position.</doc>
             <doc xml:space="preserve">a #GtkScrollable</doc>
             <type name="Scrollable" c:type="GtkScrollable*"/>
           </instance-parameter>
-          <parameter name="border" transfer-ownership="none">
+          <parameter name="border"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none">
             <doc xml:space="preserve">return location for the results</doc>
             <type name="Border" c:type="GtkBorder*"/>
           </parameter>
@@ -90349,7 +90370,10 @@ widget is allocated less than its minimum height or less than its natural height
               <doc xml:space="preserve">a #GtkScrollable</doc>
               <type name="Scrollable" c:type="GtkScrollable*"/>
             </parameter>
-            <parameter name="border" transfer-ownership="none">
+            <parameter name="border"
+                       direction="out"
+                       caller-allocates="1"
+                       transfer-ownership="none">
               <doc xml:space="preserve">return location for the results</doc>
               <type name="Border" c:type="GtkBorder*"/>
             </parameter>
@@ -102185,7 +102209,14 @@ for details.</doc>
       <field name="priv">
         <type name="StyleContextPrivate" c:type="GtkStyleContextPrivate*"/>
       </field>
-      <glib:signal name="changed" when="first">
+      <glib:signal name="changed" when="first" version="3.0">
+        <doc xml:space="preserve">The ::changed signal is emitted when there is a change in the
+#GtkStyleContext.
+
+For a #GtkStyleContext returned by gtk_widget_get_style_context(), the
+#GtkWidget::style-updated signal/vfunc might be more convenient to use.
+
+This signal is useful when using the theming layer standalone.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -111940,7 +111971,9 @@ convert to window coordinates with gtk_text_view_buffer_to_window_coords().</doc
       </method>
       <method name="get_pixels_above_lines"
               c:identifier="gtk_text_view_get_pixels_above_lines">
-        <doc xml:space="preserve">Gets the default number of pixels to put above paragraphs.</doc>
+        <doc xml:space="preserve">Gets the default number of pixels to put above paragraphs.
+Adding this function with gtk_text_view_get_pixels_below_lines()
+is equal to the line space between each paragraph.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">default number of pixels above paragraphs</doc>
           <type name="gint" c:type="gint"/>
@@ -111954,7 +111987,10 @@ convert to window coordinates with gtk_text_view_buffer_to_window_coords().</doc
       </method>
       <method name="get_pixels_below_lines"
               c:identifier="gtk_text_view_get_pixels_below_lines">
-        <doc xml:space="preserve">Gets the value set by gtk_text_view_set_pixels_below_lines().</doc>
+        <doc xml:space="preserve">Gets the value set by gtk_text_view_set_pixels_below_lines().
+
+The line space is the sum of the value returned by this function and the
+value returned by gtk_text_view_get_pixels_above_lines().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">default number of blank pixels below paragraphs</doc>
           <type name="gint" c:type="gint"/>
@@ -120485,7 +120521,10 @@ is set.</doc>
 If @child is at the toplevel, and doesn’t have a parent, then
 @iter is set to an invalid iterator and %FALSE is returned.
 @child will remain a valid node after this function has been
-called.</doc>
+called.
+
+@iter will be initialized before the lookup is performed, so @child
+and @iter cannot point to the same memory location.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE, if @iter is set to the parent of @child</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -121148,7 +121187,10 @@ is set.</doc>
 If @child is at the toplevel, and doesn’t have a parent, then
 @iter is set to an invalid iterator and %FALSE is returned.
 @child will remain a valid node after this function has been
-called.</doc>
+called.
+
+@iter will be initialized before the lookup is performed, so @child
+and @iter cannot point to the same memory location.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE, if @iter is set to the parent of @child</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -132859,19 +132901,35 @@ Also see gtk_container_child_notify().</doc>
       <virtual-method name="destroy" invoker="destroy">
         <doc xml:space="preserve">Destroys a widget.
 
-When a widget is
-destroyed, it will break any references it holds to other objects.
-If the widget is inside a container, the widget will be removed
-from the container. If the widget is a toplevel (derived from
-#GtkWindow), it will be removed from the list of toplevels, and the
-reference GTK+ holds to it will be removed. Removing a
-widget from its container or the list of toplevels results in the
-widget being finalized, unless you’ve added additional references
-to the widget with g_object_ref().
+When a widget is destroyed all references it holds on other objects
+will be released:
+
+ - if the widget is inside a container, it will be removed from its
+ parent
+ - if the widget is a container, all its children will be destroyed,
+ recursively
+ - if the widget is a top level, it will be removed from the list
+ of top level widgets that GTK+ maintains internally
+
+It's expected that all references held on the widget will also
+be released; you should connect to the #GtkWidget::destroy signal
+if you hold a reference to @widget and you wish to remove it when
+this function is called. It is not necessary to do so if you are
+implementing a #GtkContainer, as you'll be able to use the
+#GtkContainerClass.remove() virtual function for that.
+
+It's important to notice that gtk_widget_destroy() will only cause
+the @widget to be finalized if no additional references, acquired
+using g_object_ref(), are held on it. In case additional references
+are in place, the @widget will be in an "inhert" state after calling
+this function; @widget will still point to valid memory, allowing you
+to release the references you hold, but you may not query the widget's
+own state.
+
+You should typically call this function on top level widgets, and
+rarely on child widgets.
 
-In most cases, only toplevel widgets (windows) require explicit
-destruction, because when you destroy a toplevel its children will
-be destroyed as well.</doc>
+See also: gtk_container_remove()</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -134503,19 +134561,35 @@ on the widget.</doc>
       <method name="destroy" c:identifier="gtk_widget_destroy">
         <doc xml:space="preserve">Destroys a widget.
 
-When a widget is
-destroyed, it will break any references it holds to other objects.
-If the widget is inside a container, the widget will be removed
-from the container. If the widget is a toplevel (derived from
-#GtkWindow), it will be removed from the list of toplevels, and the
-reference GTK+ holds to it will be removed. Removing a
-widget from its container or the list of toplevels results in the
-widget being finalized, unless you’ve added additional references
-to the widget with g_object_ref().
+When a widget is destroyed all references it holds on other objects
+will be released:
 
-In most cases, only toplevel widgets (windows) require explicit
-destruction, because when you destroy a toplevel its children will
-be destroyed as well.</doc>
+ - if the widget is inside a container, it will be removed from its
+ parent
+ - if the widget is a container, all its children will be destroyed,
+ recursively
+ - if the widget is a top level, it will be removed from the list
+ of top level widgets that GTK+ maintains internally
+
+It's expected that all references held on the widget will also
+be released; you should connect to the #GtkWidget::destroy signal
+if you hold a reference to @widget and you wish to remove it when
+this function is called. It is not necessary to do so if you are
+implementing a #GtkContainer, as you'll be able to use the
+#GtkContainerClass.remove() virtual function for that.
+
+It's important to notice that gtk_widget_destroy() will only cause
+the @widget to be finalized if no additional references, acquired
+using g_object_ref(), are held on it. In case additional references
+are in place, the @widget will be in an "inhert" state after calling
+this function; @widget will still point to valid memory, allowing you
+to release the references you hold, but you may not query the widget's
+own state.
+
+You should typically call this function on top level widgets, and
+rarely on child widgets.
+
+See also: gtk_container_remove()</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -135496,9 +135570,7 @@ If a widget is not visible, its allocated size is 0.</doc>
           <parameter name="allocation"
                      direction="out"
                      caller-allocates="1"
-                     transfer-ownership="none"
-                     optional="1"
-                     allow-none="1">
+                     transfer-ownership="none">
             <doc xml:space="preserve">a pointer to a #GtkAllocation to copy to</doc>
             <type name="Allocation" c:type="GtkAllocation*"/>
           </parameter>
@@ -136940,7 +137012,8 @@ should look at gtk_style_context_get_state().</doc>
       </method>
       <method name="get_style_context"
               c:identifier="gtk_widget_get_style_context">
-        <doc xml:space="preserve">Returns the style context associated to @widget.</doc>
+        <doc xml:space="preserve">Returns the style context associated to @widget. The returned object is
+guaranteed to be the same for the lifetime of @widget.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a #GtkStyleContext. This memory is owned by @widget and
          must not be freed.</doc>
@@ -138339,7 +138412,9 @@ of @widget’s outermost ancestor.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="queue_allocate" c:identifier="gtk_widget_queue_allocate">
+      <method name="queue_allocate"
+              c:identifier="gtk_widget_queue_allocate"
+              version="3.20">
         <doc xml:space="preserve">This function is only for use in widget implementations.
 
 Flags the widget for a rerun of the GtkWidgetClass::size_allocate
@@ -140784,7 +140859,12 @@ more details about widget scaling.</doc>
       <property name="sensitive" writable="1" transfer-ownership="none">
         <type name="gboolean" c:type="gboolean"/>
       </property>
-      <property name="style" writable="1" transfer-ownership="none">
+      <property name="style"
+                deprecated="1"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The style of the widget, which contains information about how it will look (colors, etc).</doc>
+        <doc-deprecated xml:space="preserve">Use #GtkStyleContext instead</doc-deprecated>
         <type name="Style"/>
       </property>
       <property name="tooltip-markup"
@@ -142092,9 +142172,12 @@ with a widget, use the #GtkWidget::style-updated signal.</doc>
         </parameters>
       </glib:signal>
       <glib:signal name="style-updated" when="first" version="3.0">
-        <doc xml:space="preserve">The ::style-updated signal is emitted when the #GtkStyleContext
-of a widget is changed. Note that style-modifying functions like
-gtk_widget_override_color() also cause this signal to be emitted.</doc>
+        <doc xml:space="preserve">The ::style-updated signal is a convenience signal that is emitted when the
+#GtkStyleContext::changed signal is emitted on the @widget's associated
+#GtkStyleContext as returned by gtk_widget_get_style_context().
+
+Note that style-modifying functions like gtk_widget_override_color() also
+cause this signal to be emitted.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -145889,37 +145972,37 @@ gtk_window_move() to keep @window in its current position.
 This means that the meaning of the returned value varies with
 window gravity. See gtk_window_move() for more details.
 
+The reliability of this function depends on the windowing system
+currently in use. Some windowing systems, such as Wayland, do not
+support a global coordinate system, and thus the position of the
+window will always be (0, 0). Others, like X11, do not have a reliable
+way to obtain the geometry of the decorations of a window if they are
+provided by the window manager. Additionally, on X11, window manager
+have been known to mismanage window gravity, which result in windows
+moving even if you use the coordinates of the current position as
+returned by this function.
+
 If you haven’t changed the window gravity, its gravity will be
 #GDK_GRAVITY_NORTH_WEST. This means that gtk_window_get_position()
 gets the position of the top-left corner of the window manager
 frame for the window. gtk_window_move() sets the position of this
 same top-left corner.
 
-gtk_window_get_position() is not 100% reliable because the X Window System
-does not specify a way to obtain the geometry of the
-decorations placed on a window by the window manager.
-Thus GTK+ is using a “best guess” that works with most
-window managers.
-
-Moreover, nearly all window managers are historically broken with
-respect to their handling of window gravity. So moving a window to
-its current position as returned by gtk_window_get_position() tends
-to result in moving the window slightly. Window managers are
-slowly getting better over time.
-
 If a window has gravity #GDK_GRAVITY_STATIC the window manager
 frame is not relevant, and thus gtk_window_get_position() will
 always produce accurate results. However you can’t use static
 gravity to do things like place a window in a corner of the screen,
 because static gravity ignores the window manager decorations.
 
-If you are saving and restoring your application’s window
-positions, you should know that it’s impossible for applications to
-do this without getting it somewhat wrong because applications do
-not have sufficient knowledge of window manager state. The Correct
-Mechanism is to support the session management protocol (see the
-“GnomeClient” object in the GNOME libraries for example) and allow
-the window manager to save your window sizes and positions.</doc>
+Ideally, this function should return appropriate values if the
+window has client side decorations, assuming that the windowing
+system supports global coordinates.
+
+In practice, saving the window position should not be left to
+applications, as they lack enough knowledge of the windowing
+system and the window manager state to effectively do so. The
+appropriate way to implement saving the window position is to
+use a platform-specific protocol, wherever that is available.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -147882,7 +147965,7 @@ for a way to keep it alive without windows).
 
 Normally, the connection between the application and the window
 will remain until the window is destroyed, but you can explicitly
-remove it by setting the ::application property to %NULL.</doc>
+remove it by setting the :application property to %NULL.</doc>
         <type name="Application"/>
       </property>
       <property name="attached-to"