gdk3 3.1.8-x86-mingw32 → 3.1.9-x86-mingw32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8f630c168fa75f9612a67ed9b000dbea148d0b37
-  data.tar.gz: 2d2285256247c8b732d6b2f6ebd737474de29fe6
+  metadata.gz: ce09164d6feb8ccc4d25d00bd3fdb30de97aaa55
+  data.tar.gz: 1e38545368b1f1024092897c927dd2fcfdce85f6
 SHA512:
-  metadata.gz: 3c72a9babebad8d7414d90883edf0fb5e68e0046ecb50b735d7558b7e4ad891778d7f6c723417535f1e7871f5e8ef725711ff65e64baef48375b5220f3af3096
-  data.tar.gz: ee887baebb87da1eba254c8559a95b1432a4c0f98879b63dbc9c780e966e4a8346a602b4c50752fb7cb7bba2290b1b92b2046c9de250ffdc2e33bb9764c603a6
+  metadata.gz: b1d5d7d1b46201e1e35ec041d80682fdd4750609dee2c10be7f87e2896893f0fe2a7b58c029133e718ede9e86d4a65b6c82c47b6339aa96a040acb1ad8a41141
+  data.tar.gz: e83781dd49ef8a190aca23a3c7ab7c5845a4354072a93d3f54179c732da04fd848b9f14142be322e003fc4ab1ffa28d366f8a11996a24bb154c1385441283705

data/Rakefile

@@ -59,7 +59,7 @@ package_task = GNOME2::Rake::PackageTask.new do |package|
       :name => "gtk+",
       :download_site => :gnome,
       :label => "GTK+",
-      :version => "3.22.16",
+      :version => "3.22.24",
       :compression_method => "xz",
       :windows => {
         :configure_args => [
@@ -89,7 +89,7 @@ package_task = GNOME2::Rake::PackageTask.new do |package|
       :name => "adwaita-icon-theme",
       :download_site => :gnome,
       :label => "adwaita-icon-theme",
-      :version => "3.24.0",
+      :version => "3.26.0",
       :compression_method => "xz",
       :windows => {
         :use_gobject_introspection => false,

data/lib/gdk3/window.rb

@@ -22,5 +22,11 @@ module Gdk
     def user_data
       Loader.instantiate_gobject_pointer(user_data_raw)
     end
+
+    alias_method :origin_raw, :origin
+    def origin
+      _, x, y = origin_raw
+      [x, y]
+    end
   end
 end

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

@@ -520,21 +520,38 @@ typedef enum
  * @GDK_WINDOW_STATE_ABOVE: the window is kept above other windows.
  * @GDK_WINDOW_STATE_BELOW: the window is kept below other windows.
  * @GDK_WINDOW_STATE_FOCUSED: the window is presented as focused (with active decorations).
- * @GDK_WINDOW_STATE_TILED: the window is in a tiled state, Since 3.10
+ * @GDK_WINDOW_STATE_TILED: the window is in a tiled state, Since 3.10. Since 3.22.23, this
+ *                          is deprecated in favor of per-edge information.
+ * @GDK_WINDOW_STATE_TOP_TILED: whether the top edge is tiled, Since 3.22.23
+ * @GDK_WINDOW_STATE_TOP_RESIZABLE: whether the top edge is resizable, Since 3.22.23
+ * @GDK_WINDOW_STATE_RIGHT_TILED: whether the right edge is tiled, Since 3.22.23
+ * @GDK_WINDOW_STATE_RIGHT_RESIZABLE: whether the right edge is resizable, Since 3.22.23
+ * @GDK_WINDOW_STATE_BOTTOM_TILED: whether the bottom edge is tiled, Since 3.22.23
+ * @GDK_WINDOW_STATE_BOTTOM_RESIZABLE: whether the bottom edge is resizable, Since 3.22.23
+ * @GDK_WINDOW_STATE_LEFT_TILED: whether the left edge is tiled, Since 3.22.23
+ * @GDK_WINDOW_STATE_LEFT_RESIZABLE: whether the left edge is resizable, Since 3.22.23
  *
  * Specifies the state of a toplevel window.
  */
 typedef enum
 {
-  GDK_WINDOW_STATE_WITHDRAWN  = 1 << 0,
-  GDK_WINDOW_STATE_ICONIFIED  = 1 << 1,
-  GDK_WINDOW_STATE_MAXIMIZED  = 1 << 2,
-  GDK_WINDOW_STATE_STICKY     = 1 << 3,
-  GDK_WINDOW_STATE_FULLSCREEN = 1 << 4,
-  GDK_WINDOW_STATE_ABOVE      = 1 << 5,
-  GDK_WINDOW_STATE_BELOW      = 1 << 6,
-  GDK_WINDOW_STATE_FOCUSED    = 1 << 7,
-  GDK_WINDOW_STATE_TILED      = 1 << 8
+  GDK_WINDOW_STATE_WITHDRAWN        = 1 << 0,
+  GDK_WINDOW_STATE_ICONIFIED        = 1 << 1,
+  GDK_WINDOW_STATE_MAXIMIZED        = 1 << 2,
+  GDK_WINDOW_STATE_STICKY           = 1 << 3,
+  GDK_WINDOW_STATE_FULLSCREEN       = 1 << 4,
+  GDK_WINDOW_STATE_ABOVE            = 1 << 5,
+  GDK_WINDOW_STATE_BELOW            = 1 << 6,
+  GDK_WINDOW_STATE_FOCUSED          = 1 << 7,
+  GDK_WINDOW_STATE_TILED            = 1 << 8,
+  GDK_WINDOW_STATE_TOP_TILED        = 1 << 9,
+  GDK_WINDOW_STATE_TOP_RESIZABLE    = 1 << 10,
+  GDK_WINDOW_STATE_RIGHT_TILED      = 1 << 11,
+  GDK_WINDOW_STATE_RIGHT_RESIZABLE  = 1 << 12,
+  GDK_WINDOW_STATE_BOTTOM_TILED     = 1 << 13,
+  GDK_WINDOW_STATE_BOTTOM_RESIZABLE = 1 << 14,
+  GDK_WINDOW_STATE_LEFT_TILED       = 1 << 15,
+  GDK_WINDOW_STATE_LEFT_RESIZABLE   = 1 << 16
 } GdkWindowState;
 
 /**

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 (16)
+#define GDK_MICRO_VERSION (24)
 
 #ifndef _GDK_EXTERN
 #define _GDK_EXTERN extern

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

@@ -1036,6 +1036,8 @@ typedef enum
  * @GTK_INPUT_HINT_INHIBIT_OSK: Suggest to not show an onscreen keyboard
  *     (e.g for a calculator that already has all the keys).
  * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical. Since 3.18
+ * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support. Since 3.22.20
+ * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support. Since 3.22.20
  *
  * Describes hints that might be taken into account by input methods
  * or applications. Note that input methods may already tailor their
@@ -1060,7 +1062,9 @@ typedef enum
   GTK_INPUT_HINT_UPPERCASE_WORDS     = 1 << 5,
   GTK_INPUT_HINT_UPPERCASE_SENTENCES = 1 << 6,
   GTK_INPUT_HINT_INHIBIT_OSK         = 1 << 7,
-  GTK_INPUT_HINT_VERTICAL_WRITING    = 1 << 8
+  GTK_INPUT_HINT_VERTICAL_WRITING    = 1 << 8,
+  GTK_INPUT_HINT_EMOJI               = 1 << 9,
+  GTK_INPUT_HINT_NO_EMOJI            = 1 << 10
 } GtkInputHints;
 
 /**

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

@@ -101,8 +101,8 @@ struct _GtkFlowBoxChildClass
 
 /**
  * GtkFlowBoxCreateWidgetFunc:
- * @item: the item from the model for which to create a widget for
- * @user_data: user data from gtk_flow_box_bind_model()
+ * @item: (type GObject): the item from the model for which to create a widget for
+ * @user_data: (closure): user data from gtk_flow_box_bind_model()
  *
  * 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.

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 (16)
+#define GTK_MICRO_VERSION (24)
 
 /**
  * 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    (2216)
+#define GTK_BINARY_AGE    (2224)
 
 /**
  * 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 (16)
+#define GTK_INTERFACE_AGE (24)
 
 /**
  * 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.16/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.22.16
+# Created by Z:/home/vagrant/ruby-gnome2.win32/gdk3/tmp/windows/gtk+/gtk+-3.22.24/gtk/.libs/gtk-query-immodules-3.0.exe from gtk+-3.22.24
 #
 # 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=16
+revision=24
 
 # 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=16
+revision=24
 
 # 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.16
+Version: 3.22.24
 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,8 +6,8 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.22.16
+Version: 3.22.24
 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
+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
 Cflags: -I${includedir}/gtk-3.0 

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

@@ -6,8 +6,8 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.22.16
+Version: 3.22.24
 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
+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
 Cflags: -I${includedir}/gtk-3.0 

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.16
+Version: 3.22.24
 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.16
+Version: 3.22.24
 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

@@ -19158,7 +19158,7 @@ The string can be either one of:
 
 Where “r”, “g”, “b” and “a” are respectively the red, green, blue and
 alpha color values. In the last two cases, r g and b are either integers
-in the range 0 to 255 or precentage values in the range 0% to 100%, and
+in the range 0 to 255 or percentage values in the range 0% to 100%, and
 a is a floating point value in the range 0 to 1.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the parsing succeeded</doc>
@@ -26004,7 +26004,56 @@ a child in multiple places.</doc>
               value="256"
               c:identifier="GDK_WINDOW_STATE_TILED"
               glib:nick="tiled">
-        <doc xml:space="preserve">the window is in a tiled state, Since 3.10</doc>
+        <doc xml:space="preserve">the window is in a tiled state, Since 3.10. Since 3.22.23, this
+                         is deprecated in favor of per-edge information.</doc>
+      </member>
+      <member name="top_tiled"
+              value="512"
+              c:identifier="GDK_WINDOW_STATE_TOP_TILED"
+              glib:nick="top-tiled">
+        <doc xml:space="preserve">whether the top edge is tiled, Since 3.22.23</doc>
+      </member>
+      <member name="top_resizable"
+              value="1024"
+              c:identifier="GDK_WINDOW_STATE_TOP_RESIZABLE"
+              glib:nick="top-resizable">
+        <doc xml:space="preserve">whether the top edge is resizable, Since 3.22.23</doc>
+      </member>
+      <member name="right_tiled"
+              value="2048"
+              c:identifier="GDK_WINDOW_STATE_RIGHT_TILED"
+              glib:nick="right-tiled">
+        <doc xml:space="preserve">whether the right edge is tiled, Since 3.22.23</doc>
+      </member>
+      <member name="right_resizable"
+              value="4096"
+              c:identifier="GDK_WINDOW_STATE_RIGHT_RESIZABLE"
+              glib:nick="right-resizable">
+        <doc xml:space="preserve">whether the right edge is resizable, Since 3.22.23</doc>
+      </member>
+      <member name="bottom_tiled"
+              value="8192"
+              c:identifier="GDK_WINDOW_STATE_BOTTOM_TILED"
+              glib:nick="bottom-tiled">
+        <doc xml:space="preserve">whether the bottom edge is tiled, Since 3.22.23</doc>
+      </member>
+      <member name="bottom_resizable"
+              value="16384"
+              c:identifier="GDK_WINDOW_STATE_BOTTOM_RESIZABLE"
+              glib:nick="bottom-resizable">
+        <doc xml:space="preserve">whether the bottom edge is resizable, Since 3.22.23</doc>
+      </member>
+      <member name="left_tiled"
+              value="32768"
+              c:identifier="GDK_WINDOW_STATE_LEFT_TILED"
+              glib:nick="left-tiled">
+        <doc xml:space="preserve">whether the left edge is tiled, Since 3.22.23</doc>
+      </member>
+      <member name="left_resizable"
+              value="65536"
+              c:identifier="GDK_WINDOW_STATE_LEFT_RESIZABLE"
+              glib:nick="left-resizable">
+        <doc xml:space="preserve">whether the left edge is resizable, Since 3.22.23</doc>
       </member>
     </bitfield>
     <enumeration name="WindowType"

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

@@ -1485,7 +1485,7 @@ their visual representation if the @accel_closure is theirs.</doc>
            glib:get-type="gtk_accel_label_get_type"
            glib:type-struct="AccelLabelClass">
       <doc xml:space="preserve">The #GtkAccelLabel widget is a subclass of #GtkLabel that also displays an
-accelerator key on the right of the label text, e.g. “Ctl+S”.
+accelerator key on the right of the label text, e.g. “Ctrl+S”.
 It is commonly used in menus to show the keyboard short-cuts for commands.
 
 The accelerator key to display is typically not set explicitly (although it
@@ -1494,10 +1494,10 @@ the accelerators which have been added to a particular widget. This widget is
 set by calling gtk_accel_label_set_accel_widget().
 
 For example, a #GtkMenuItem widget may have an accelerator added to emit
-the “activate” signal when the “Ctl+S” key combination is pressed.
+the “activate” signal when the “Ctrl+S” key combination is pressed.
 A #GtkAccelLabel is created and added to the #GtkMenuItem, and
 gtk_accel_label_set_accel_widget() is called with the #GtkMenuItem as the
-second argument. The #GtkAccelLabel will now display “Ctl+S” after its label.
+second argument. The #GtkAccelLabel will now display “Ctrl+S” after its label.
 
 Note that creating a #GtkMenuItem with gtk_menu_item_new_with_label() (or
 one of the similar functions for #GtkCheckMenuItem and #GtkRadioMenuItem)
@@ -1663,7 +1663,9 @@ Providing an @accelerator_key of 0 removes the manual setting.</doc>
       <method name="set_accel_closure"
               c:identifier="gtk_accel_label_set_accel_closure">
         <doc xml:space="preserve">Sets the closure to be monitored by this accelerator label. The closure
-must be connected to an accelerator group; see gtk_accel_group_connect().</doc>
+must be connected to an accelerator group; see gtk_accel_group_connect().
+Passing %NULL for @accel_closure will dissociate @accel_label from its
+current closure, if any.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1672,15 +1674,20 @@ must be connected to an accelerator group; see gtk_accel_group_connect().</doc>
             <doc xml:space="preserve">a #GtkAccelLabel</doc>
             <type name="AccelLabel" c:type="GtkAccelLabel*"/>
           </instance-parameter>
-          <parameter name="accel_closure" transfer-ownership="none">
-            <doc xml:space="preserve">the closure to monitor for accelerator changes.</doc>
+          <parameter name="accel_closure"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the closure to monitor for accelerator changes,
+or %NULL</doc>
             <type name="GObject.Closure" c:type="GClosure*"/>
           </parameter>
         </parameters>
       </method>
       <method name="set_accel_widget"
               c:identifier="gtk_accel_label_set_accel_widget">
-        <doc xml:space="preserve">Sets the widget to be monitored by this accelerator label.</doc>
+        <doc xml:space="preserve">Sets the widget to be monitored by this accelerator label. Passing %NULL for
+@accel_widget will dissociate @accel_label from its current widget, if any.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1689,8 +1696,11 @@ must be connected to an accelerator group; see gtk_accel_group_connect().</doc>
             <doc xml:space="preserve">a #GtkAccelLabel</doc>
             <type name="AccelLabel" c:type="GtkAccelLabel*"/>
           </instance-parameter>
-          <parameter name="accel_widget" transfer-ownership="none">
-            <doc xml:space="preserve">the widget to be monitored.</doc>
+          <parameter name="accel_widget"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the widget to be monitored, or %NULL</doc>
             <type name="Widget" c:type="GtkWidget*"/>
           </parameter>
         </parameters>
@@ -8017,8 +8027,9 @@ The active window is the one that was most recently focused (within
 the application).  This window may not have the focus at the moment
 if another application has it — this is just the most
 recently-focused window within this application.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the active window</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the active window, or %NULL if
+  there isn't one.</doc>
           <type name="Window" c:type="GtkWindow*"/>
         </return-value>
         <parameters>
@@ -10169,7 +10180,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="2216" c:type="GTK_BINARY_AGE">
+    <constant name="BINARY_AGE" value="2224" 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>
@@ -10225,8 +10236,9 @@ Many GTK+ widgets are subclasses of #GtkBin, including #GtkWindow,
         <doc xml:space="preserve">Gets the child of the #GtkBin, or %NULL if the bin contains
 no child widget. The returned widget does not have a reference
 added, so you do not need to unref it.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">pointer to child of the #GtkBin</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the child of @bin, or %NULL if it does
+not have a child.</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
         <parameters>
@@ -13920,8 +13932,11 @@ gtk_widget_show() on @image yourself.</doc>
             <doc xml:space="preserve">a #GtkButton</doc>
             <type name="Button" c:type="GtkButton*"/>
           </instance-parameter>
-          <parameter name="image" transfer-ownership="none">
-            <doc xml:space="preserve">a widget to set as the image for the button</doc>
+          <parameter name="image"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a widget to set as the image for the button, or %NULL to unset</doc>
             <type name="Widget" c:type="GtkWidget*"/>
           </parameter>
         </parameters>
@@ -28120,9 +28135,10 @@ is returned.</doc>
       <method name="get_active_iter"
               c:identifier="gtk_combo_box_get_active_iter"
               version="2.4">
-        <doc xml:space="preserve">Sets @iter to point to the current active item, if it exists.</doc>
+        <doc xml:space="preserve">Sets @iter to point to the currently active item, if any item is active.
+Otherwise, @iter is left unchanged.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">%TRUE, if @iter was set</doc>
+          <doc xml:space="preserve">%TRUE if @iter was set, %FALSE otherwise</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -28134,7 +28150,7 @@ is returned.</doc>
                      direction="out"
                      caller-allocates="1"
                      transfer-ownership="none">
-            <doc xml:space="preserve">The uninitialized #GtkTreeIter</doc>
+            <doc xml:space="preserve">A #GtkTreeIter</doc>
             <type name="TreeIter" c:type="GtkTreeIter*"/>
           </parameter>
         </parameters>
@@ -28829,10 +28845,10 @@ a horizontally oriented #GtkCellAreaBox will be used.</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">If this is set to a non-negative value, it must be the index of a column
-of type %G_TYPE_INT in the model.
-
-The values of that column are used to determine how many columns a value
-in the list will span.</doc>
+of type %G_TYPE_INT in the model. The value in that column for each item
+will determine how many columns that item will span in the popup.
+Therefore, values in this column must be greater than zero, and the sum of
+an item’s column position + span should not exceed #GtkComboBox:wrap-width.</doc>
         <type name="gint" c:type="gint"/>
       </property>
       <property name="entry-text-column"
@@ -28894,11 +28910,9 @@ it allows you to connect to notify::popup-shown.</doc>
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">If this is set to a non-negative value, it must be the index of a column
-of type %G_TYPE_INT in the model.
-
-The values of that column are used to determine how many rows a value in
-the list will span. Therefore, the values in the model column pointed to
-by this property must be greater than zero and not larger than wrap-width.</doc>
+of type %G_TYPE_INT in the model. The value in that column for each item
+will determine how many rows that item will span in the popup. Therefore,
+values in this column must be greater than zero.</doc>
         <type name="gint" c:type="gint"/>
       </property>
       <property name="tearoff-title"
@@ -28915,9 +28929,8 @@ when the popup is torn-off.</doc>
                 version="2.4"
                 writable="1"
                 transfer-ownership="none">
-        <doc xml:space="preserve">If wrap-width is set to a positive value, the list will be
-displayed in multiple columns, the number of columns is
-determined by wrap-width.</doc>
+        <doc xml:space="preserve">If wrap-width is set to a positive value, items in the popup will be laid
+out along multiple columns, starting a new row on reaching the wrap width.</doc>
         <type name="gint" c:type="gint"/>
       </property>
       <field name="parent_instance">
@@ -34318,7 +34331,8 @@ This function is useful when drawing something to the
 entry in a draw callback.
 
 If the entry is not realized or has no icon at the given position,
-@icon_area is filled with zeros.
+@icon_area is filled with zeros. Otherwise, @icon_area will be filled
+with the icon’s allocation, relative to @entry’s allocation.
 
 See also gtk_entry_get_text_area()</doc>
         <return-value transfer-ownership="none">
@@ -35397,7 +35411,13 @@ at the specified position.
 Use %NULL for @tooltip to remove an existing tooltip.
 
 See also gtk_widget_set_tooltip_text() and
-gtk_entry_set_icon_tooltip_markup().</doc>
+gtk_entry_set_icon_tooltip_markup().
+
+If you unset the widget tooltip via gtk_widget_set_tooltip_text() or
+gtk_widget_set_tooltip_markup(), this sets GtkWidget:has-tooltip to %FALSE,
+which suppresses icon tooltips too. You can resolve this by then calling
+gtk_widget_set_has_tooltip() to set GtkWidget:has-tooltip back to %TRUE, or
+setting at least one non-empty tooltip on any icon achieves the same result.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -36119,6 +36139,9 @@ Also see gtk_entry_set_icon_tooltip_text().</doc>
     the value of this style property is ignored.</doc-deprecated>
         <type name="ShadowType"/>
       </property>
+      <property name="show-emoji-icon" writable="1" transfer-ownership="none">
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <property name="tabs" writable="1" transfer-ownership="none">
         <type name="Pango.TabArray"/>
       </property>
@@ -38676,8 +38699,8 @@ expander
 ]|
 
 GtkExpander has three CSS nodes, the main node with the name expander,
-a subnode with name title and node below it with name arrow. Neither of
-them is using any style classes.</doc>
+a subnode with name title and node below it with name arrow. The arrow of an
+expander that is showing its child gets the :checked pseudoclass added to it.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <constructor name="new" c:identifier="gtk_expander_new" version="2.4">
@@ -38687,7 +38710,10 @@ them is using any style classes.</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
         <parameters>
-          <parameter name="label" transfer-ownership="none">
+          <parameter name="label"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the text of the label</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -38759,7 +38785,7 @@ Note that this function behaved differently in versions prior to
 underlines indicating mnemonics and Pango markup. This problem can
 be avoided by fetching the label text directly from the label
 widget.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The text of the label widget. This string is owned
     by the widget and must not be modified or freed.</doc>
           <type name="utf8" c:type="const gchar*"/>
@@ -41601,8 +41627,8 @@ gtk_dialog_new_with_buttons().</doc>
       <doc xml:space="preserve">#GtkFileChooserNative is an abstraction of a dialog box suitable
 for use with “File/Open” or “File/Save as” commands. By default, this
 just uses a #GtkFileChooserDialog to implement the actual dialog.
-However, on certain platforms, such as Windows, the native platform
-file chooser is uses instead. When the application is running in a
+However, on certain platforms, such as Windows and macOS, the native platform
+file chooser is used instead. When the application is running in a
 sandboxed environment without direct filesystem access (such as Flatpak),
 #GtkFileChooserNative may call the proper APIs (portals) to let the user
 choose a file and make it available to the application.
@@ -41737,7 +41763,23 @@ supported and will be silently ignored:
 
 * Use of custom previews by connecting to #GtkFileChooser::update-preview.
 
-* Any #GtkFileFilter added with a custom filter.</doc>
+* Any #GtkFileFilter added with a custom filter.
+
+## macOS details ## {#gtkfilechooserdialognative-macos}
+
+On macOS the NSSavePanel and NSOpenPanel classes are used to provide native
+file chooser dialogs. Some features provided by #GtkFileChooserDialog are
+not supported:
+
+* Extra widgets added with gtk_file_chooser_set_extra_widget(), unless the
+  widget is an instance of GtkLabel, in which case the label text will be used
+  to set the NSSavePanel message instance property.
+
+* Use of custom previews by connecting to #GtkFileChooser::update-preview.
+
+* Any #GtkFileFilter added with a custom filter.
+
+* Shortcut folders.</doc>
       <implements name="FileChooser"/>
       <constructor name="new"
                    c:identifier="gtk_file_chooser_native_new"
@@ -42518,18 +42560,19 @@ other display bugs:
 - Fonts other than the one you used to write the app will of course
   change the size of widgets containing text; keep in mind that
   users may use a larger font because of difficulty reading the
-  default, or they may be using Windows or the framebuffer port of
-  GTK+, where different fonts are available.
+  default, or they may be using a different OS that provides different fonts.
 
 - Translation of text into other languages changes its size. Also,
   display of non-English text will use a different font in many
   cases.
 
-In addition, the fixed widget can’t properly be mirrored in
-right-to-left languages such as Hebrew and Arabic. i.e. normally
-GTK+ will flip the interface to put labels to the right of the
-thing they label, but it can’t do that with #GtkFixed. So your
-application will not be usable in right-to-left languages.
+In addition, #GtkFixed does not pay attention to text direction and thus may
+produce unwanted results if your app is run under right-to-left languages
+such as Hebrew or Arabic. That is: normally GTK+ will order containers
+appropriately for the text direction, e.g. to put labels to the right of the
+thing they label when using an RTL language, but it can’t do that with
+#GtkFixed. So if you need to reorder widgets depending on the text direction,
+you would need to manually detect it and adjust child positions accordingly.
 
 Finally, fixed positioning makes it kind of annoying to add/remove
 GUI elements, since you have to reposition all the other
@@ -42538,7 +42581,10 @@ application.
 
 If you know none of these things are an issue for your application,
 and prefer the simplicity of #GtkFixed, by all means use the
-widget. But you should be aware of the tradeoffs.</doc>
+widget. But you should be aware of the tradeoffs.
+
+See also #GtkLayout, which shares the ability to perform fixed positioning
+of child widgets and additionally adds custom drawing and scrollability.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <constructor name="new" c:identifier="gtk_fixed_new">
@@ -42671,6 +42717,10 @@ from top to bottom, starting a new column to the right when necessary.
 Reducing the height will require more columns, so a larger width will
 be requested.
 
+The size request of a GtkFlowBox alone may not be what you expect; if you
+need to be able to shrink it along both axes and dynamically reflow its
+children, you may have to wrap it in a #GtkScrolledWindow to enable that.
+
 The children of a GtkFlowBox can be dynamically sorted and filtered.
 
 Although a GtkFlowBox must have only #GtkFlowBoxChild children,
@@ -43957,12 +44007,9 @@ gtk_flow_box_bind_model() for each item that gets added to the model.</doc>
         <type name="Widget" c:type="GtkWidget*"/>
       </return-value>
       <parameters>
-        <parameter name="item"
-                   transfer-ownership="none"
-                   nullable="1"
-                   allow-none="1">
+        <parameter name="item" transfer-ownership="none">
           <doc xml:space="preserve">the item from the model for which to create a widget for</doc>
-          <type name="gpointer" c:type="gpointer"/>
+          <type name="GObject.Object" c:type="gpointer"/>
         </parameter>
         <parameter name="user_data"
                    transfer-ownership="none"
@@ -45890,17 +45937,18 @@ An example of a UI definition fragment with GtkFrame:
 
 |[&lt;!-- language="plain" --&gt;
 frame
-├── border
+├── border[.flat]
 ├── &lt;label widget&gt;
 ╰── &lt;child&gt;
 ]|
 
-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.
+GtkFrame has a main CSS node named “frame” and a subnode named “border”. The
+“border” node is used to draw the visible border. You can set the appearance
+of the border using CSS properties like “border-style” on the “border” node.
 
-The border node can be given the style class .flat, which is used by themes
+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
+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"/>
@@ -46085,8 +46133,8 @@ will appear embedded in the top edge of the frame as a title.</doc>
       </method>
       <method name="set_shadow_type" c:identifier="gtk_frame_set_shadow_type">
         <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
+(%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"/>
@@ -51694,10 +51742,53 @@ following files that is found: ~/.config/gtk-3.0/Compose, ~/.XCompose,
 Compose file). The syntax of these files is described in the Compose(5)
 manual page.
 
+## Unicode characters
+
 GtkIMContextSimple also supports numeric entry of Unicode characters
 by typing Ctrl-Shift-u, followed by a hexadecimal Unicode codepoint.
 For example, Ctrl-Shift-u 1 2 3 Enter yields U+0123 LATIN SMALL LETTER
-G WITH CEDILLA, i.e. ģ.</doc>
+G WITH CEDILLA, i.e. ģ.
+
+## Emoji
+
+GtkIMContextSimple also supports entry of Emoji by their name.
+This works by first typing Ctrl-Shift-e, followed by an Emoji name.
+
+The following names are supported:
+- :-) 🙂
+- 8-) 😍
+- &lt;3 ❤
+- kiss 💋
+- grin 😁
+- joy 😂
+- :-* 😚
+- xD 😆
+- like 👍
+- dislike 👎
+- up 👆
+- v ✌
+- ok 👌
+- B-) 😎
+- ;-) 😉
+- ;-P 😜
+- :-p 😋
+- 3( 😔
+- :-( 😞
+- :] 😏
+- :'( 😢
+- :_( 😭
+- :(( 😩
+- :o 😨
+- :| 😐
+- 3-) 😌
+- &gt;( 😠
+- &gt;(( 😡
+- O:) 😇
+- ;o 😰
+- 8| 😳
+- 8o 😲
+- :X 😷
+- }:) 😈</doc>
       <constructor name="new" c:identifier="gtk_im_context_simple_new">
         <doc xml:space="preserve">Creates a new #GtkIMContextSimple.</doc>
         <return-value transfer-ownership="full">
@@ -51955,7 +52046,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="16" c:type="GTK_INTERFACE_AGE">
+    <constant name="INTERFACE_AGE" value="24" 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>
@@ -58596,7 +58687,7 @@ GtkWidget *widget;
 GtkInfoBar *bar;
 
 widget = gtk_info_bar_new ();
-bar = GTK_INFO_BAR (bar);
+bar = GTK_INFO_BAR (widget);
 
 gtk_widget_set_no_show_all (widget, TRUE);
 message_label = gtk_label_new ("");
@@ -59142,6 +59233,18 @@ ignore unknown values.</doc>
               glib:nick="vertical-writing">
         <doc xml:space="preserve">The text is vertical. Since 3.18</doc>
       </member>
+      <member name="emoji"
+              value="512"
+              c:identifier="GTK_INPUT_HINT_EMOJI"
+              glib:nick="emoji">
+        <doc xml:space="preserve">Suggest offering Emoji support. Since 3.22.20</doc>
+      </member>
+      <member name="no_emoji"
+              value="1024"
+              c:identifier="GTK_INPUT_HINT_NO_EMOJI"
+              glib:nick="no-emoji">
+        <doc xml:space="preserve">Suggest not offering Emoji support. Since 3.22.20</doc>
+      </member>
     </bitfield>
     <enumeration name="InputPurpose"
                  version="3.6"
@@ -59527,7 +59630,7 @@ An example of a UI definition fragment specifying Pango attributes:
 &lt;object class="GtkLabel"&gt;
   &lt;attributes&gt;
     &lt;attribute name="weight" value="PANGO_WEIGHT_BOLD"/&gt;
-    &lt;attribute name="background" value="red" start="5" end="10"/&gt;"
+    &lt;attribute name="background" value="red" start="5" end="10"/&gt;
   &lt;/attributes&gt;
 &lt;/object&gt;
 ]|
@@ -60492,7 +60595,7 @@ and toggle focus between the colliding widgets otherwise.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the target #GtkWidget</doc>
+            <doc xml:space="preserve">the target #GtkWidget, or %NULL to unset</doc>
             <type name="Widget" c:type="GtkWidget*"/>
           </parameter>
         </parameters>
@@ -61134,17 +61237,18 @@ to this signal and append your menuitems to the @menu.</doc>
            glib:type-name="GtkLayout"
            glib:get-type="gtk_layout_get_type"
            glib:type-struct="LayoutClass">
-      <doc xml:space="preserve">#GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate”
-and doesn’t do anything but paint a blank background by default. It's
-different in that it supports scrolling natively (you can add it to a
-#GtkScrolledWindow), and it can contain child widgets, since it’s a
-#GtkContainer. However if you’re just going to draw, a #GtkDrawingArea
-is a better choice since it has lower overhead.
-
-When handling expose events on a #GtkLayout, you must draw to
-GTK_LAYOUT (layout)-&gt;bin_window, rather than to
-GTK_WIDGET (layout)-&gt;window, as you would for a drawing
-area.</doc>
+      <doc xml:space="preserve">#GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” and
+doesn’t do anything except paint a blank background by default. It’s
+different in that it supports scrolling natively due to implementing
+#GtkScrollable, and can contain child widgets since it’s a #GtkContainer.
+
+If you just want to draw, a #GtkDrawingArea is a better choice since it has
+lower overhead. If you just need to position child widgets at specific
+points, then #GtkFixed provides that functionality on its own.
+
+When handling expose events on a #GtkLayout, you must draw to the #GdkWindow
+returned by gtk_layout_get_bin_window(), rather than to the one returned by
+gtk_widget_get_window() as you would for a #GtkDrawingArea.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <implements name="Scrollable"/>
@@ -64810,7 +64914,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="16" c:type="GTK_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="24" 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>
@@ -70749,7 +70853,7 @@ See gtk_notebook_set_show_tabs().</doc>
         <doc xml:space="preserve">Returns the tab label widget for the page @child.
 %NULL is returned if @child is not in @notebook or
 if no tab label has specifically been set for @child.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the tab label</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
@@ -72561,7 +72665,13 @@ to the #GtkOverlay::get-child-position signal.
 
 The GtkOverlay implementation of the GtkBuildable interface
 supports placing a child as an overlay by specifying “overlay” as
-the “type” attribute of a `&lt;child&gt;` element.</doc>
+the “type” attribute of a `&lt;child&gt;` element.
+
+# CSS nodes
+
+GtkOverlay has a single CSS node with the name “overlay”. Overlay children
+whose alignments cause them to be positioned at an edge get the style classes
+“.left”, “.right”, “.top”, and/or “.bottom” according to their position.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <constructor name="new" c:identifier="gtk_overlay_new" version="3.2">
@@ -96746,7 +96856,8 @@ use gtk_spinner_stop().
 
 # CSS nodes
 
-GtkSpinner has a single CSS node with the name spinner.</doc>
+GtkSpinner has a single CSS node with the name spinner. When the animation is
+active, the :checked pseudoclass is added to this node.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <constructor name="new" c:identifier="gtk_spinner_new" version="2.20">
@@ -111381,7 +111492,7 @@ for a way to add it to a buffer again.</doc>
       </method>
       <method name="get_name" c:identifier="gtk_text_mark_get_name">
         <doc xml:space="preserve">Returns the mark name; returns NULL for anonymous marks.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">mark name</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -118046,7 +118157,7 @@ Custom subclasses of #GtkToolItem should use this function to
 update their menu item when the #GtkToolItem changes. That the
 @menu_item_ids must match ensures that a #GtkToolItem
 will not inadvertently change a menu item that they did not create.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The #GtkMenuItem passed to
     gtk_tool_item_set_proxy_menu_item(), if the @menu_item_ids
     match.</doc>
@@ -118317,7 +118428,9 @@ effect known as “priority text”</doc>
               version="2.4">
         <doc xml:space="preserve">Sets the #GtkMenuItem used in the toolbar overflow menu. The
 @menu_item_id is used to identify the caller of this function and
-should also be used with gtk_tool_item_get_proxy_menu_item().</doc>
+should also be used with gtk_tool_item_get_proxy_menu_item().
+
+See also #GtkToolItem::create-menu-proxy.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -118330,8 +118443,11 @@ should also be used with gtk_tool_item_get_proxy_menu_item().</doc>
             <doc xml:space="preserve">a string used to identify @menu_item</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="menu_item" transfer-ownership="none">
-            <doc xml:space="preserve">a #GtkMenuItem to be used in the overflow menu</doc>
+          <parameter name="menu_item"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GtkMenuItem to use in the overflow menu, or %NULL</doc>
             <type name="Widget" c:type="GtkWidget*"/>
           </parameter>
         </parameters>
@@ -120005,6 +120121,11 @@ Toolbar items can be visually grouped by adding instances of
 “expand” is #TRUE and the property #GtkSeparatorToolItem:draw is set to
 #FALSE, the effect is to force all following items to the end of the toolbar.
 
+By default, a toolbar can be shrunk, upon which it will add an arrow button
+to show an overflow menu offering access to any #GtkToolItem child that has
+a proxy menu item. To disable this and request enough size for all children,
+call gtk_toolbar_set_show_arrow() to set #GtkToolbar:show-arrow to %FALSE.
+
 Creating a context menu for the toolbar can be done by connecting to
 the #GtkToolbar::popup-context-menu signal.
 
@@ -120291,10 +120412,12 @@ size of icons.</doc>
       <method name="set_show_arrow"
               c:identifier="gtk_toolbar_set_show_arrow"
               version="2.4">
-        <doc xml:space="preserve">Sets whether to show an overflow menu when
-@toolbar doesn’t have room for all items on it. If %TRUE,
-items that there are not room are available through an
-overflow menu.</doc>
+        <doc xml:space="preserve">Sets whether to show an overflow menu when @toolbar isn’t allocated enough
+size to show all of its items. If %TRUE, items which can’t fit in @toolbar,
+and which have a proxy menu item set by gtk_tool_item_set_proxy_menu_item()
+or #GtkToolItem::create-menu-proxy, will be available in an overflow menu,
+which can be opened by an added arrow button. If %FALSE, @toolbar will
+request enough size to fit all of its child items without any overflow.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -137770,9 +137893,10 @@ by using the #GtkWidget::screen-changed signal on the widget.</doc>
       </method>
       <method name="get_parent_window"
               c:identifier="gtk_widget_get_parent_window">
-        <doc xml:space="preserve">Gets @widget’s parent window.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the parent window of @widget.</doc>
+        <doc xml:space="preserve">Gets @widget’s parent window, or %NULL if it does not have one.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the parent window of @widget, or %NULL
+if it does not have a parent window.</doc>
           <type name="Gdk.Window" c:type="GdkWindow*"/>
         </return-value>
         <parameters>
@@ -140898,7 +141022,7 @@ for completeness and consistency.</doc>
       <method name="set_mapped"
               c:identifier="gtk_widget_set_mapped"
               version="2.20">
-        <doc xml:space="preserve">Marks the widget as being realized.
+        <doc xml:space="preserve">Marks the widget as being mapped.
 
 This function should only ever be called in a derived widget's
 “map” or “unmap” implementation.</doc>
@@ -141465,14 +141589,11 @@ See also the #GtkWidget:tooltip-text property and gtk_tooltip_set_text().</doc>
       <method name="set_tooltip_window"
               c:identifier="gtk_widget_set_tooltip_window"
               version="2.12">
-        <doc xml:space="preserve">Replaces the default, usually yellow, window used for displaying
+        <doc xml:space="preserve">Replaces the default window used for displaying
 tooltips with @custom_window. GTK+ will take care of showing and
 hiding @custom_window at the right moment, to behave likewise as
 the default tooltip window. If @custom_window is %NULL, the default
-tooltip window will be used.
-
-If the custom window should have the default theming it needs to
-have the name “gtk-tooltip”, see gtk_widget_set_name().</doc>
+tooltip window will be used.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -148259,8 +148380,16 @@ the input focus. This function sets this hint.</doc>
               version="3.0">
         <doc xml:space="preserve">Sets or unsets the #GtkApplication associated with the window.
 
-The application will be kept alive for at least as long as the window
-is open.</doc>
+The application will be kept alive for at least as long as it has any windows
+associated with it (see g_application_hold() 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 to %NULL.
+
+This is equivalent to calling gtk_application_remove_window() and/or
+gtk_application_add_window() on the old/new applications as relevant.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -148273,7 +148402,7 @@ is open.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">a #GtkApplication, or %NULL</doc>
+            <doc xml:space="preserve">a #GtkApplication, or %NULL to unset</doc>
             <type name="Application" c:type="GtkApplication*"/>
           </parameter>
         </parameters>
@@ -151625,15 +151754,17 @@ similar things.</doc>
     </function>
     <function name="init_check" c:identifier="gtk_init_check">
       <doc xml:space="preserve">This function does the same work as gtk_init() with only a single
-change: It does not terminate the program if the windowing system
-can’t be initialized. Instead it returns %FALSE on failure.
+change: It does not terminate the program if the commandline
+arguments couldn’t be parsed or the windowing system can’t be
+initialized. Instead it returns %FALSE on failure.
 
 This way the application can fall back to some other means of
 communication with the user - for example a curses or command line
 interface.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if the windowing system has been successfully
-    initialized, %FALSE otherwise</doc>
+        <doc xml:space="preserve">%TRUE if the commandline arguments (if any) were valid and
+    the windowing system has been successfully initialized, %FALSE
+    otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>
@@ -151694,8 +151825,9 @@ and it automatically generates nicely formatted
 `--help` output. Note that your program will
 be terminated after writing out the help output.</doc>
       <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%TRUE if the windowing system has been successfully
-    initialized, %FALSE otherwise</doc>
+        <doc xml:space="preserve">%TRUE if the commandline arguments (if any) were valid and
+    if the windowing system has been successfully initialized,
+    %FALSE otherwise</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
       <parameters>