gdk3 3.0.9-x64-mingw32 → 3.1.0-x64-mingw32

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

@@ -111,12 +111,57 @@ for the corresponding #GtkSetting).</doc>
            glib:type-name="GdkWin32Keymap"
            glib:get-type="gdk_win32_keymap_get_type"
            glib:type-struct="Win32KeymapClass">
+      <method name="check_compose"
+              c:identifier="gdk_win32_keymap_check_compose">
+        <return-value transfer-ownership="none">
+          <type name="Win32KeymapMatch" c:type="GdkWin32KeymapMatch"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="keymap" transfer-ownership="none">
+            <type name="Win32Keymap" c:type="GdkWin32Keymap*"/>
+          </instance-parameter>
+          <parameter name="compose_buffer" transfer-ownership="none">
+            <type name="guint16" c:type="guint16*"/>
+          </parameter>
+          <parameter name="compose_buffer_len" transfer-ownership="none">
+            <type name="gsize" c:type="gsize"/>
+          </parameter>
+          <parameter name="output" transfer-ownership="none">
+            <type name="guint16" c:type="guint16*"/>
+          </parameter>
+          <parameter name="output_len" transfer-ownership="none">
+            <type name="gsize" c:type="gsize*"/>
+          </parameter>
+        </parameters>
+      </method>
     </class>
     <record name="Win32KeymapClass"
             c:type="GdkWin32KeymapClass"
             disguised="1"
             glib:is-gtype-struct-for="Win32Keymap">
     </record>
+    <enumeration name="Win32KeymapMatch" c:type="GdkWin32KeymapMatch">
+      <doc xml:space="preserve">An enumeration describing the result of a deadkey combination matching.</doc>
+      <member name="none" value="0" c:identifier="GDK_WIN32_KEYMAP_MATCH_NONE">
+        <doc xml:space="preserve">no matches found. Output is not valid.</doc>
+      </member>
+      <member name="incomplete"
+              value="1"
+              c:identifier="GDK_WIN32_KEYMAP_MATCH_INCOMPLETE">
+        <doc xml:space="preserve">the sequence matches so far, but is incomplete. Output is not valid.</doc>
+      </member>
+      <member name="partial"
+              value="2"
+              c:identifier="GDK_WIN32_KEYMAP_MATCH_PARTIAL">
+        <doc xml:space="preserve">the sequence matches up to the last key,
+    which does not match. Output is valid.</doc>
+      </member>
+      <member name="exact"
+              value="3"
+              c:identifier="GDK_WIN32_KEYMAP_MATCH_EXACT">
+        <doc xml:space="preserve">the sequence matches exactly. Output is valid.</doc>
+      </member>
+    </enumeration>
     <class name="Win32Screen"
            c:symbol-prefix="win32_screen"
            c:type="GdkWin32Screen"

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

@@ -4911,7 +4911,7 @@ See gtk_actionable_set_action_name() for more information.</doc>
       <virtual-method name="get_action_target_value"
                       invoker="get_action_target_value"
                       version="3.4">
-        <doc xml:space="preserve">Gets the current target value of @actionabe.
+        <doc xml:space="preserve">Gets the current target value of @actionable.
 
 See gtk_actionable_set_action_target_value() for more information.</doc>
         <return-value transfer-ownership="none">
@@ -4947,7 +4947,10 @@ associated with the window.</doc>
             <doc xml:space="preserve">a #GtkActionable widget</doc>
             <type name="Actionable" c:type="GtkActionable*"/>
           </instance-parameter>
-          <parameter name="action_name" transfer-ownership="none">
+          <parameter name="action_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">an action name, or %NULL</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -5009,7 +5012,7 @@ See gtk_actionable_set_action_name() for more information.</doc>
       <method name="get_action_target_value"
               c:identifier="gtk_actionable_get_action_target_value"
               version="3.4">
-        <doc xml:space="preserve">Gets the current target value of @actionabe.
+        <doc xml:space="preserve">Gets the current target value of @actionable.
 
 See gtk_actionable_set_action_target_value() for more information.</doc>
         <return-value transfer-ownership="none">
@@ -5045,7 +5048,10 @@ associated with the window.</doc>
             <doc xml:space="preserve">a #GtkActionable widget</doc>
             <type name="Actionable" c:type="GtkActionable*"/>
           </instance-parameter>
-          <parameter name="action_name" transfer-ownership="none">
+          <parameter name="action_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">an action name, or %NULL</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
@@ -5184,7 +5190,10 @@ as the target.</doc>
               <doc xml:space="preserve">a #GtkActionable widget</doc>
               <type name="Actionable" c:type="GtkActionable*"/>
             </parameter>
-            <parameter name="action_name" transfer-ownership="none">
+            <parameter name="action_name"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">an action name, or %NULL</doc>
               <type name="utf8" c:type="const gchar*"/>
             </parameter>
@@ -8024,8 +8033,9 @@ recently-focused window within this application.</doc>
               version="3.4">
         <doc xml:space="preserve">Returns the menu model that has been set with
 gtk_application_set_app_menu().</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the application menu of @application</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the application menu of @application
+  or %NULL if no application menu has been set.</doc>
           <type name="Gio.MenuModel" c:type="GMenuModel*"/>
         </return-value>
         <parameters>
@@ -8684,6 +8694,9 @@ The following attributes are used when constructing sections:
 - "label": a user-visible string to use as section heading
 - "display-hint": a string used to determine special formatting for the section.
     Possible values include "horizontal-buttons".
+- "text-direction": a string used to determine the #GtkTextDirection to use
+    when "display-hint" is set to "horizontal-buttons". Possible values
+    include "rtl", "ltr", and "none".
 
 The following attributes are used when constructing submenus:
 - "label": a user-visible string to display
@@ -8761,7 +8774,9 @@ and menubar as needed.</doc>
               version="3.20">
         <doc xml:space="preserve">Associates a shortcuts window with the application window, and
 sets up an action with the name win.show-help-overlay to present
-it.</doc>
+it.
+
+@window takes resposibility for destroying @help_overlay.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10154,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="2008" c:type="GTK_BINARY_AGE">
+    <constant name="BINARY_AGE" value="2203" 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>
@@ -10331,7 +10346,21 @@ represented by a GtkBindingEntry.</doc>
         <doc xml:space="preserve">Override or install a new key binding for @keyval with @modifiers on
 @binding_set. When the binding is activated, @signal_name will be
 emitted on the target widget, with @n_args @Varargs used as
-arguments.</doc>
+arguments.
+
+Each argument to the signal must be passed as a pair of varargs: the
+#GType of the argument, followed by the argument value (which must
+be of the given type). There must be @n_args pairs in total.
+
+## Adding a Key Binding
+
+|[&lt;!-- language="C" --&gt;
+gtk_binding_entry_add_signal (binding_set, keyval, modmask,
+                              "move-cursor", 3,
+                              G_TYPE_ENUM, step,
+                              G_TYPE_INT, count,
+                              G_TYPE_BOOLEAN, FALSE);
+]|</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -12236,17 +12265,18 @@ as %TRUE, strings like “FALSE”, “f”, “no”, “n”, “0” are inte
 as %FALSE), enumerations (can be specified by their name, nick or
 integer value), flags (can be specified by their name, nick, integer
 value, optionally combined with “|”, e.g. “GTK_VISIBLE|GTK_REALIZED”)
-and colors (in a format understood by gdk_rgba_parse()). Pixbufs can
-be specified as a filename of an image file to load. Objects can be
-referred to by their name and by default refer to objects declared
-in the local xml fragment and objects exposed via
-gtk_builder_expose_object().
-
-In general, GtkBuilder allows forward references to objects —
-declared in the local xml; an object doesn’t have to be constructed
-before it can be referred to. The exception to this rule is that an
-object has to be constructed before it can be used as the value of
-a construct-only property.
+and colors (in a format understood by gdk_rgba_parse()).
+
+GVariants can be specified in the format understood by g_variant_parse(),
+and pixbufs can be specified as a filename of an image file to load.
+
+Objects can be referred to by their name and by default refer to
+objects declared in the local xml fragment and objects exposed via
+gtk_builder_expose_object(). In general, GtkBuilder allows forward
+references to objects — declared in the local xml; an object doesn’t
+have to be constructed before it can be referred to. The exception
+to this rule is that an object has to be constructed before it can
+be used as the value of a construct-only property.
 
 It is also possible to bind a property value to another object's
 property value using the attributes
@@ -13632,9 +13662,12 @@ This function should be rarely needed.</doc>
       </method>
       <method name="get_focus_on_click"
               c:identifier="gtk_button_get_focus_on_click"
-              version="2.4">
+              version="2.4"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Returns whether the button grabs focus when it is clicked with the mouse.
 See gtk_button_set_focus_on_click().</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_get_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the button grabs focus when it is clicked with
               the mouse.</doc>
@@ -13847,11 +13880,14 @@ without the image.</doc>
       </method>
       <method name="set_focus_on_click"
               c:identifier="gtk_button_set_focus_on_click"
-              version="2.4">
+              version="2.4"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Sets whether the button will grab focus when it is clicked with the mouse.
 Making mouse clicks not grab focus is useful in places like toolbars where
 you don’t want the keyboard focus removed from the main area of the
 application.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_set_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21236,7 +21272,10 @@ so the @background_area rectangles for all cells tile to cover the entire
             <doc xml:space="preserve">a #GtkCellRenderer</doc>
             <type name="CellRenderer" c:type="GtkCellRenderer*"/>
           </instance-parameter>
-          <parameter name="event" transfer-ownership="none">
+          <parameter name="event"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GdkEvent</doc>
             <type name="Gdk.Event" c:type="GdkEvent*"/>
           </parameter>
@@ -21735,11 +21774,17 @@ the given #GtkCellRendererState.</doc>
           <type name="StateFlags" c:type="GtkStateFlags"/>
         </return-value>
         <parameters>
-          <instance-parameter name="cell" transfer-ownership="none">
+          <instance-parameter name="cell"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #GtkCellRenderer, or %NULL</doc>
             <type name="CellRenderer" c:type="GtkCellRenderer*"/>
           </instance-parameter>
-          <parameter name="widget" transfer-ownership="none">
+          <parameter name="widget"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GtkWidget, or %NULL</doc>
             <type name="Widget" c:type="GtkWidget*"/>
           </parameter>
@@ -21931,7 +21976,10 @@ so the @background_area rectangles for all cells tile to cover the entire
             <doc xml:space="preserve">a #GtkCellRenderer</doc>
             <type name="CellRenderer" c:type="GtkCellRenderer*"/>
           </instance-parameter>
-          <parameter name="event" transfer-ownership="none">
+          <parameter name="event"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #GdkEvent</doc>
             <type name="Gdk.Event" c:type="GdkEvent*"/>
           </parameter>
@@ -22688,7 +22736,10 @@ in the same way as they are in menus.</doc>
               <doc xml:space="preserve">a #GtkCellRenderer</doc>
               <type name="CellRenderer" c:type="GtkCellRenderer*"/>
             </parameter>
-            <parameter name="event" transfer-ownership="none">
+            <parameter name="event"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">a #GdkEvent</doc>
               <type name="Gdk.Event" c:type="GdkEvent*"/>
             </parameter>
@@ -25211,6 +25262,22 @@ by gtk_clipboard_set_with_owner().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_selection"
+              c:identifier="gtk_clipboard_get_selection"
+              version="3.22"
+              introspectable="0">
+        <doc xml:space="preserve">Gets the selection that this clipboard is for.</doc>
+        <return-value>
+          <doc xml:space="preserve">the selection</doc>
+          <type name="Gdk.Atom" c:type="GdkAtom"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="clipboard" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkClipboard</doc>
+            <type name="Clipboard" c:type="GtkClipboard*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="request_contents"
               c:identifier="gtk_clipboard_request_contents">
         <doc xml:space="preserve">Requests the contents of clipboard as the given target.
@@ -28138,9 +28205,12 @@ from to display in the internal entry.</doc>
       </method>
       <method name="get_focus_on_click"
               c:identifier="gtk_combo_box_get_focus_on_click"
-              version="2.6">
+              version="2.6"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Returns whether the combo box grabs focus when it is clicked
 with the mouse. See gtk_combo_box_set_focus_on_click().</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_get_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the combo box grabs focus when it is
     clicked with the mouse.</doc>
@@ -28512,11 +28582,14 @@ This is only relevant if @combo_box has been created with
       </method>
       <method name="set_focus_on_click"
               c:identifier="gtk_combo_box_set_focus_on_click"
-              version="2.6">
+              version="2.6"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Sets whether the combo box will grab focus when it is clicked with
 the mouse. Making mouse clicks not grab focus is useful in places
 like toolbars where you don’t want the keyboard focus removed from
 the main area of the application.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_set_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -30226,7 +30299,7 @@ currently focused widget. That can be obtained by calling
 gtk_window_get_focus().</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The child widget which will receive the
-         focus inside @container when the @conatiner is focussed,
+         focus inside @container when the @container is focused,
          or %NULL if none is set.</doc>
           <type name="Widget" c:type="GtkWidget*"/>
         </return-value>
@@ -31194,20 +31267,20 @@ bars are placed.</doc>
 It is able to parse [CSS-like][css-overview] input in order to style widgets.
 
 An application can make GTK+ parse a specific CSS style sheet by calling
-gtk_css_provider_load_from_file() or gtk_css_provider_load_from_resouce()
+gtk_css_provider_load_from_file() or gtk_css_provider_load_from_resource()
 and adding the provider with gtk_style_context_add_provider() or
 gtk_style_context_add_provider_for_screen().
 
 In addition, certain files will be read when GTK+ is initialized. First, the
-file $XDG_CONFIG_HOME/gtk-3.0/gtk.css` is loaded if it exists. Then, GTK+
+file `$XDG_CONFIG_HOME/gtk-3.0/gtk.css` is loaded if it exists. Then, GTK+
 loads the first existing file among
 `XDG_DATA_HOME/themes/theme-name/gtk-VERSION/gtk.css`,
 `$HOME/.themes/theme-name/gtk-VERSION/gtk.css`,
 `$XDG_DATA_DIRS/themes/theme-name/gtk-VERSION/gtk.css` and
-`DATADIR/share/themes/THEME/gtk-VERSION/gtk.css`, where THEME is the name of
-the current theme (see the #GtkSettings:gtk-theme-name setting), DATADIR
+`DATADIR/share/themes/THEME/gtk-VERSION/gtk.css`, where `THEME` is the name of
+the current theme (see the #GtkSettings:gtk-theme-name setting), `DATADIR`
 is the prefix configured when GTK+ was compiled (unless overridden by the
-`GTK_DATA_PREFIX` environment variable), and VERSION is the GTK+ version number.
+`GTK_DATA_PREFIX` environment variable), and `VERSION` is the GTK+ version number.
 If no file is found for the current version, GTK+ tries older versions all the
 way back to 3.0.
 
@@ -31521,11 +31594,13 @@ than when a loading function was called.</doc>
     </record>
     <record name="CssSection"
             c:type="GtkCssSection"
+            version="3.2"
             glib:type-name="GtkCssSection"
             glib:get-type="gtk_css_section_get_type"
             c:symbol-prefix="css_section">
-      <doc xml:space="preserve">GtkCssSection is an auxiliary object containing information about
-the results of parsing a CSS style sheet.</doc>
+      <doc xml:space="preserve">Defines a part of a CSS document. Because sections are nested into
+one another, you can use gtk_css_section_get_parent() to get the
+containing region.</doc>
       <method name="get_end_line"
               c:identifier="gtk_css_section_get_end_line"
               version="3.2">
@@ -39257,6 +39332,42 @@ If you want to set more than one extra widget in the file
 chooser, you can a container such as a #GtkBox or a #GtkGrid
 and include your widgets in it.  Then, set the container as
 the whole extra widget.</doc>
+      <method name="add_choice"
+              c:identifier="gtk_file_chooser_add_choice"
+              version="3.22">
+        <doc xml:space="preserve">Adds a 'choice' to the file chooser. This is typically implemented
+as a combobox or, for boolean choices, as a checkbutton. You can select
+a value using gtk_file_chooser_set_choice() before the dialog is shown,
+and you can obtain the user-selected value in the ::response signal handler
+using gtk_file_chooser_get_choice().
+
+Compare gtk_file_chooser_set_extra_widget().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="chooser" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkFileChooser</doc>
+            <type name="FileChooser" c:type="GtkFileChooser*"/>
+          </instance-parameter>
+          <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve">id for the added choice</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="label" transfer-ownership="none">
+            <doc xml:space="preserve">user-visible label for the added choice</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="options" transfer-ownership="none">
+            <doc xml:space="preserve">ids for the options of the choice, or %NULL for a boolean choice</doc>
+            <type name="utf8" c:type="const char**"/>
+          </parameter>
+          <parameter name="option_labels" transfer-ownership="none">
+            <doc xml:space="preserve">user-visible labels for the options, must be the same length as @options</doc>
+            <type name="utf8" c:type="const char**"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="add_filter"
               c:identifier="gtk_file_chooser_add_filter"
               version="2.4">
@@ -39344,6 +39455,25 @@ gtk_file_chooser_set_action().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_choice"
+              c:identifier="gtk_file_chooser_get_choice"
+              version="3.22">
+        <doc xml:space="preserve">Gets the currently selected option in the 'choice' with the given ID.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the ID of the currenly selected option</doc>
+          <type name="utf8" c:type="const char*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="chooser" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkFileChooser</doc>
+            <type name="FileChooser" c:type="GtkFileChooser*"/>
+          </instance-parameter>
+          <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve">the ID of the choice to get</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_create_folders"
               c:identifier="gtk_file_chooser_get_create_folders"
               version="2.18">
@@ -39848,6 +39978,24 @@ g_free().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="remove_choice"
+              c:identifier="gtk_file_chooser_remove_choice"
+              version="3.22">
+        <doc xml:space="preserve">Removes a 'choice' that has been added with gtk_file_chooser_add_choice().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="chooser" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkFileChooser</doc>
+            <type name="FileChooser" c:type="GtkFileChooser*"/>
+          </instance-parameter>
+          <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve">the ID of the choice to remove</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="remove_filter"
               c:identifier="gtk_file_chooser_remove_filter"
               version="2.4">
@@ -40013,6 +40161,30 @@ an option to create a new folder might be shown if the action is
           </parameter>
         </parameters>
       </method>
+      <method name="set_choice"
+              c:identifier="gtk_file_chooser_set_choice"
+              version="3.22">
+        <doc xml:space="preserve">Selects an option in a 'choice' that has been added with
+gtk_file_chooser_add_choice(). For a boolean choice, the
+possible options are "true" and "false".</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="chooser" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkFileChooser</doc>
+            <type name="FileChooser" c:type="GtkFileChooser*"/>
+          </instance-parameter>
+          <parameter name="id" transfer-ownership="none">
+            <doc xml:space="preserve">the ID of the choice to set</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="option" transfer-ownership="none">
+            <doc xml:space="preserve">the ID of the option to select</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_create_folders"
               c:identifier="gtk_file_chooser_set_create_folders"
               version="2.18">
@@ -40898,9 +41070,12 @@ order for the button to take over the file selected in the dialog.</doc>
       </virtual-method>
       <method name="get_focus_on_click"
               c:identifier="gtk_file_chooser_button_get_focus_on_click"
-              version="2.10">
+              version="2.10"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Returns whether the button grabs focus when it is clicked with the mouse.
 See gtk_file_chooser_button_set_focus_on_click().</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_get_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the button grabs focus when it is clicked with
               the mouse.</doc>
@@ -40946,11 +41121,14 @@ should not be modified or freed.</doc>
       </method>
       <method name="set_focus_on_click"
               c:identifier="gtk_file_chooser_button_set_focus_on_click"
-              version="2.10">
+              version="2.10"
+              deprecated="1"
+              deprecated-version="3.20">
         <doc xml:space="preserve">Sets whether the button will grab focus when it is clicked with the mouse.
 Making mouse clicks not grab focus is useful in places like toolbars where
 you don’t want the keyboard focus removed from the main area of the
 application.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_widget_set_focus_on_click() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -41416,7 +41594,10 @@ gtk_dialog_new_with_buttons().</doc>
 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.
+file chooser is uses 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.
 
 While the API of #GtkFileChooserNative closely mirrors #GtkFileChooserDialog, the main
 difference is that there is no access to any #GtkWindow or #GtkWidget for the dialog.
@@ -41534,7 +41715,21 @@ does, but there are some things it does not handle:
 * Any #GtkFileFilter added using a mimetype or custom filter.
 
 If any of these features are used the regular #GtkFileChooserDialog
-will be used in place of the native one.</doc>
+will be used in place of the native one.
+
+## Portal details ## {#gtkfilechooserdialognative-portal}
+
+When the org.freedesktop.portal.FileChooser portal is available on the
+session bus, it is used to bring up an out-of-process file chooser. Depending
+on the kind of session the application is running in, this may or may not
+be a GTK+ file chooser. In this situation, the following things are not
+supported and will be silently ignored:
+
+* Extra widgets added with gtk_file_chooser_set_extra_widget().
+
+* Use of custom previews by connecting to #GtkFileChooser::update-preview.
+
+* Any #GtkFileFilter added with a custom filter.</doc>
       <implements name="FileChooser"/>
       <constructor name="new"
                    c:identifier="gtk_file_chooser_native_new"
@@ -41998,6 +42193,22 @@ gtk_file_filter_add_pattern (filter, "*");
           <type name="FileFilter" c:type="GtkFileFilter*"/>
         </return-value>
       </constructor>
+      <constructor name="new_from_gvariant"
+                   c:identifier="gtk_file_filter_new_from_gvariant"
+                   version="3.22">
+        <doc xml:space="preserve">Deserialize a file filter from an a{sv} variant in
+the format produced by gtk_file_filter_to_gvariant().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkFileFilter object</doc>
+          <type name="FileFilter" c:type="GtkFileFilter*"/>
+        </return-value>
+        <parameters>
+          <parameter name="variant" transfer-ownership="none">
+            <doc xml:space="preserve">an a{sv} #GVariant</doc>
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <method name="add_custom"
               c:identifier="gtk_file_filter_add_custom"
               version="2.4">
@@ -42180,6 +42391,21 @@ there is a selectable list of filters.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="to_gvariant"
+              c:identifier="gtk_file_filter_to_gvariant"
+              version="3.22">
+        <doc xml:space="preserve">Serialize a file filter to an a{sv} variant.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new, floating, #GVariant</doc>
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="filter" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkFileFilter</doc>
+            <type name="FileFilter" c:type="GtkFileFilter*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
     </class>
     <bitfield name="FileFilterFlags"
               glib:type-name="GtkFileFilterFlags"
@@ -46234,6 +46460,22 @@ using gtk_gl_area_set_required_version().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_use_es"
+              c:identifier="gtk_gl_area_get_use_es"
+              version="3.22">
+        <doc xml:space="preserve">Retrieves the value set by gtk_gl_area_set_use_es().</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the #GtkGLArea should create an OpenGL ES context
+  and %FALSE otherwise</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="area" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkGLArea</doc>
+            <type name="GLArea" c:type="GtkGLArea*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="make_current"
               c:identifier="gtk_gl_area_make_current"
               version="3.16">
@@ -46410,6 +46652,27 @@ This function must be called before the area has been realized.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="set_use_es"
+              c:identifier="gtk_gl_area_set_use_es"
+              version="3.22">
+        <doc xml:space="preserve">Sets whether the @area should create an OpenGL or an OpenGL ES context.
+
+You should check the capabilities of the #GdkGLContext before drawing
+with either API.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="area" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkGLArea</doc>
+            <type name="GLArea" c:type="GtkGLArea*"/>
+          </instance-parameter>
+          <parameter name="use_es" transfer-ownership="none">
+            <doc xml:space="preserve">whether to use OpenGL or OpenGL ES</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
       <property name="auto-render"
                 version="3.16"
                 writable="1"
@@ -46461,6 +46724,16 @@ target framebuffer.</doc>
 target framebuffer.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="use-es"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">If set to %TRUE the widget will try to create a #GdkGLContext using
+OpenGL ES instead of OpenGL.
+
+See also: gdk_gl_context_set_use_es()</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <field name="parent_instance" readable="0" private="1">
         <type name="Widget" c:type="GtkWidget"/>
       </field>
@@ -51640,7 +51913,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="8" c:type="GTK_INTERFACE_AGE">
+    <constant name="INTERFACE_AGE" value="3" 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>
@@ -52072,7 +52345,7 @@ built in icon images, you must pass the %GTK_ICON_LOOKUP_USE_BUILTIN
 to gtk_icon_theme_lookup_icon().</doc>
         <doc-deprecated xml:space="preserve">This function is deprecated, use
     gtk_icon_theme_add_resource_path() instead of builtin icons.</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the built-in image pixbuf, or %NULL.
     No extra reference is added to the returned pixbuf, so if
     you want to keep it around, you must use g_object_ref().
@@ -58566,8 +58839,8 @@ be added to a widget hierarchy.</doc>
               c:identifier="gtk_info_bar_set_message_type"
               version="2.18">
         <doc xml:space="preserve">Sets the message type of the message area.
-GTK+ uses this type to determine what color to use
-when drawing the message area.</doc>
+
+GTK+ uses this type to determine how the message is displayed.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -61745,6 +62018,12 @@ This enumeration can be expanded at later date.</doc>
               glib:nick="lgpl-3-0-only">
         <doc xml:space="preserve">The GNU Lesser General Public License, version 3.0 only. Since 3.12.</doc>
       </member>
+      <member name="agpl_3_0"
+              value="13"
+              c:identifier="GTK_LICENSE_AGPL_3_0"
+              glib:nick="agpl-3-0">
+        <doc xml:space="preserve">The GNU Affero General Public License, version 3.0 or later. Since: 3.22.</doc>
+      </member>
     </enumeration>
     <class name="LinkButton"
            c:symbol-prefix="link_button"
@@ -62047,8 +62326,13 @@ The GtkListBox widget was added in GTK+ 3.10.
 
 # CSS nodes
 
-GtkListBox uses a single CSS node with name list. GtkListBoxRow uses
-a single CSS node with name row. The row nodes get the .activatable
+|[&lt;!-- language="plain" --&gt;
+list
+╰── row[.activatable]
+]|
+
+GtkListBox uses a single CSS node named list. Each GtkListBoxRow uses
+a single CSS node named row. The row nodes get the .activatable
 style class added when appropriate.</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
@@ -64475,13 +64759,13 @@ 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="8" c:type="GTK_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="3" 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>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MINOR_VERSION" value="20" c:type="GTK_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="22" c:type="GTK_MINOR_VERSION">
       <doc xml:space="preserve">Like gtk_get_minor_version(), but from the headers used at
 application compile time, rather than from the library linked
 against at application run time.</doc>
@@ -64826,6 +65110,19 @@ See gtk_menu_set_tearoff_state().</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="place_on_monitor" c:identifier="gtk_menu_place_on_monitor">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="menu" transfer-ownership="none">
+            <type name="Menu" c:type="GtkMenu*"/>
+          </instance-parameter>
+          <parameter name="monitor" transfer-ownership="none">
+            <type name="Gdk.Monitor" c:type="GdkMonitor*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="popdown" c:identifier="gtk_menu_popdown">
         <doc xml:space="preserve">Removes the menu from the screen.</doc>
         <return-value transfer-ownership="none">
@@ -64838,7 +65135,10 @@ See gtk_menu_set_tearoff_state().</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="popup" c:identifier="gtk_menu_popup">
+      <method name="popup"
+              c:identifier="gtk_menu_popup"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Displays a menu and makes it available for selection.
 
 Applications can use this function to display context-sensitive
@@ -64857,7 +65157,14 @@ of concurrent requests for mouse/keyboard grab requests. To function
 properly, this needs to be the timestamp of the user event (such as
 a mouse click or key press) that caused the initiation of the popup.
 Only if no such event is available, gtk_get_current_event_time() can
-be used instead.</doc>
+be used instead.
+
+Note that this function does not work very well on GDK backends that
+do not have global coordinates, such as Wayland or Mir. You should
+probably use one of the gtk_menu_popup_at_ variants, which do not
+have this problem.</doc>
+        <doc-deprecated xml:space="preserve">Please use gtk_menu_popup_at_widget(),
+    gtk_menu_popup_at_pointer(). or gtk_menu_popup_at_rect() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -64909,9 +65216,155 @@ be used instead.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="popup_at_pointer"
+              c:identifier="gtk_menu_popup_at_pointer"
+              version="3.22"
+              stability="Unstable">
+        <doc xml:space="preserve">Displays @menu and makes it available for selection.
+
+See gtk_menu_popup_at_widget () to pop up a menu at a widget.
+gtk_menu_popup_at_rect () also allows you to position a menu at an arbitrary
+rectangle.
+
+@menu will be positioned at the pointer associated with @trigger_event.
+
+Properties that influence the behaviour of this function are
+#GtkMenu:anchor-hints, #GtkMenu:rect-anchor-dx, #GtkMenu:rect-anchor-dy, and
+#GtkMenu:menu-type-hint. Connect to the #GtkMenu::popped-up signal to find
+out how it was actually positioned.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="menu" transfer-ownership="none">
+            <doc xml:space="preserve">the #GtkMenu to pop up</doc>
+            <type name="Menu" c:type="GtkMenu*"/>
+          </instance-parameter>
+          <parameter name="trigger_event"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the #GdkEvent that initiated this request or
+                %NULL if it's the current event</doc>
+            <type name="Gdk.Event" c:type="const GdkEvent*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="popup_at_rect"
+              c:identifier="gtk_menu_popup_at_rect"
+              version="3.22"
+              stability="Unstable">
+        <doc xml:space="preserve">Displays @menu and makes it available for selection.
+
+See gtk_menu_popup_at_widget () and gtk_menu_popup_at_pointer (), which
+handle more common cases for popping up menus.
+
+@menu will be positioned at @rect, aligning their anchor points. @rect is
+relative to the top-left corner of @rect_window. @rect_anchor and
+@menu_anchor determine anchor points on @rect and @menu to pin together.
+@menu can optionally be offset by #GtkMenu:rect-anchor-dx and
+#GtkMenu:rect-anchor-dy.
+
+Anchors should be specified under the assumption that the text direction is
+left-to-right; they will be flipped horizontally automatically if the text
+direction is right-to-left.
+
+Other properties that influence the behaviour of this function are
+#GtkMenu:anchor-hints and #GtkMenu:menu-type-hint. Connect to the
+#GtkMenu::popped-up signal to find out how it was actually positioned.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="menu" transfer-ownership="none">
+            <doc xml:space="preserve">the #GtkMenu to pop up</doc>
+            <type name="Menu" c:type="GtkMenu*"/>
+          </instance-parameter>
+          <parameter name="rect_window" transfer-ownership="none">
+            <doc xml:space="preserve">the #GdkWindow @rect is relative to</doc>
+            <type name="Gdk.Window" c:type="GdkWindow*"/>
+          </parameter>
+          <parameter name="rect" transfer-ownership="none">
+            <doc xml:space="preserve">the #GdkRectangle to align @menu with</doc>
+            <type name="Gdk.Rectangle" c:type="const GdkRectangle*"/>
+          </parameter>
+          <parameter name="rect_anchor" transfer-ownership="none">
+            <doc xml:space="preserve">the point on @rect to align with @menu's anchor point</doc>
+            <type name="Gdk.Gravity" c:type="GdkGravity"/>
+          </parameter>
+          <parameter name="menu_anchor" transfer-ownership="none">
+            <doc xml:space="preserve">the point on @menu to align with @rect's anchor point</doc>
+            <type name="Gdk.Gravity" c:type="GdkGravity"/>
+          </parameter>
+          <parameter name="trigger_event"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the #GdkEvent that initiated this request or
+                %NULL if it's the current event</doc>
+            <type name="Gdk.Event" c:type="const GdkEvent*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="popup_at_widget"
+              c:identifier="gtk_menu_popup_at_widget"
+              version="3.22"
+              stability="Unstable">
+        <doc xml:space="preserve">Displays @menu and makes it available for selection.
+
+See gtk_menu_popup_at_pointer () to pop up a menu at the master pointer.
+gtk_menu_popup_at_rect () also allows you to position a menu at an arbitrary
+rectangle.
+
+![](popup-anchors.png)
+
+@menu will be positioned at @widget, aligning their anchor points.
+@widget_anchor and @menu_anchor determine anchor points on @widget and @menu
+to pin together. @menu can optionally be offset by #GtkMenu:rect-anchor-dx
+and #GtkMenu:rect-anchor-dy.
+
+Anchors should be specified under the assumption that the text direction is
+left-to-right; they will be flipped horizontally automatically if the text
+direction is right-to-left.
+
+Other properties that influence the behaviour of this function are
+#GtkMenu:anchor-hints and #GtkMenu:menu-type-hint. Connect to the
+#GtkMenu::popped-up signal to find out how it was actually positioned.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="menu" transfer-ownership="none">
+            <doc xml:space="preserve">the #GtkMenu to pop up</doc>
+            <type name="Menu" c:type="GtkMenu*"/>
+          </instance-parameter>
+          <parameter name="widget" transfer-ownership="none">
+            <doc xml:space="preserve">the #GtkWidget to align @menu with</doc>
+            <type name="Widget" c:type="GtkWidget*"/>
+          </parameter>
+          <parameter name="widget_anchor" transfer-ownership="none">
+            <doc xml:space="preserve">the point on @widget to align with @menu's anchor point</doc>
+            <type name="Gdk.Gravity" c:type="GdkGravity"/>
+          </parameter>
+          <parameter name="menu_anchor" transfer-ownership="none">
+            <doc xml:space="preserve">the point on @menu to align with @widget's anchor point</doc>
+            <type name="Gdk.Gravity" c:type="GdkGravity"/>
+          </parameter>
+          <parameter name="trigger_event"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the #GdkEvent that initiated this request or
+                %NULL if it's the current event</doc>
+            <type name="Gdk.Event" c:type="const GdkEvent*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="popup_for_device"
               c:identifier="gtk_menu_popup_for_device"
-              version="3.0">
+              version="3.0"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Displays a menu and makes it available for selection.
 
 Applications can use this function to display context-sensitive menus,
@@ -64930,7 +65383,14 @@ concurrent requests for mouse/keyboard grab requests. To function
 properly, this needs to be the time stamp of the user event (such as
 a mouse click or key press) that caused the initiation of the popup.
 Only if no such event is available, gtk_get_current_event_time() can
-be used instead.</doc>
+be used instead.
+
+Note that this function does not work very well on GDK backends that
+do not have global coordinates, such as Wayland or Mir. You should
+probably use one of the gtk_menu_popup_at_ variants, which do not
+have this problem.</doc>
+        <doc-deprecated xml:space="preserve">Please use gtk_menu_popup_at_widget(),
+    gtk_menu_popup_at_pointer(). or gtk_menu_popup_at_rect() instead</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -65117,7 +65577,7 @@ the #GtkComboBox and should not be used by anyone else.</doc>
               c:identifier="gtk_menu_set_monitor"
               version="2.4">
         <doc xml:space="preserve">Informs GTK+ on which monitor a menu should be popped up.
-See gdk_screen_get_monitor_geometry().
+See gdk_monitor_get_geometry().
 
 This function should be called from a #GtkMenuPositionFunc
 if the menu should not appear on the same monitor as the pointer.
@@ -65249,6 +65709,28 @@ text as that menu item’s label.</doc>
 menu item is selected.</doc>
         <type name="gint" c:type="gint"/>
       </property>
+      <property name="anchor-hints"
+                version="3.22"
+                stability="Unstable"
+                writable="1"
+                construct="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Positioning hints for aligning the menu relative to a rectangle.
+
+These hints determine how the menu should be positioned in the case that
+the menu would fall off-screen if placed in its ideal position.
+
+![](popup-flip.png)
+
+For example, %GDK_ANCHOR_FLIP_Y will replace %GDK_GRAVITY_NORTH_WEST with
+%GDK_GRAVITY_SOUTH_WEST and vice versa if the menu extends beyond the
+bottom edge of the monitor.
+
+See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
+gtk_menu_popup_at_pointer (), #GtkMenu:rect-anchor-dx,
+#GtkMenu:rect-anchor-dy, #GtkMenu:menu-type-hint, and #GtkMenu::popped-up.</doc>
+        <type name="Gdk.AnchorHints"/>
+      </property>
       <property name="attach-widget"
                 version="2.14"
                 writable="1"
@@ -65258,6 +65740,19 @@ the menu without a #GtkMenuDetachFunc. If you need to use a detacher,
 use gtk_menu_attach_to_widget() directly.</doc>
         <type name="Widget"/>
       </property>
+      <property name="menu-type-hint"
+                version="3.22"
+                stability="Unstable"
+                writable="1"
+                construct="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GdkWindowTypeHint to use for the menu's #GdkWindow.
+
+See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
+gtk_menu_popup_at_pointer (), #GtkMenu:anchor-hints,
+#GtkMenu:rect-anchor-dx, #GtkMenu:rect-anchor-dy, and #GtkMenu::popped-up.</doc>
+        <type name="Gdk.WindowTypeHint"/>
+      </property>
       <property name="monitor"
                 version="2.14"
                 writable="1"
@@ -65265,6 +65760,33 @@ use gtk_menu_attach_to_widget() directly.</doc>
         <doc xml:space="preserve">The monitor the menu will be popped up on.</doc>
         <type name="gint" c:type="gint"/>
       </property>
+      <property name="rect-anchor-dx"
+                version="3.22"
+                stability="Unstable"
+                writable="1"
+                construct="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Horizontal offset to apply to the menu, i.e. the rectangle or widget
+anchor.
+
+See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
+gtk_menu_popup_at_pointer (), #GtkMenu:anchor-hints,
+#GtkMenu:rect-anchor-dy, #GtkMenu:menu-type-hint, and #GtkMenu::popped-up.</doc>
+        <type name="gint" c:type="gint"/>
+      </property>
+      <property name="rect-anchor-dy"
+                version="3.22"
+                stability="Unstable"
+                writable="1"
+                construct="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Vertical offset to apply to the menu, i.e. the rectangle or widget anchor.
+
+See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
+gtk_menu_popup_at_pointer (), #GtkMenu:anchor-hints,
+#GtkMenu:rect-anchor-dx, #GtkMenu:menu-type-hint, and #GtkMenu::popped-up.</doc>
+        <type name="gint" c:type="gint"/>
+      </property>
       <property name="reserve-toggle-size"
                 version="2.18"
                 writable="1"
@@ -65313,6 +65835,62 @@ menu is torn-off.</doc>
           </parameter>
         </parameters>
       </glib:signal>
+      <glib:signal name="popped-up"
+                   when="first"
+                   version="3.22"
+                   stability="Unstable">
+        <doc xml:space="preserve">Emitted when the position of @menu is finalized after being popped up
+using gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (), or
+gtk_menu_popup_at_pointer ().
+
+@menu might be flipped over the anchor rectangle in order to keep it
+on-screen, in which case @flipped_x and @flipped_y will be set to %TRUE
+accordingly.
+
+@flipped_rect is the ideal position of @menu after any possible flipping,
+but before any possible sliding. @final_rect is @flipped_rect, but possibly
+translated in the case that flipping is still ineffective in keeping @menu
+on-screen.
+
+![](popup-slide.png)
+
+The blue menu is @menu's ideal position, the green menu is @flipped_rect,
+and the red menu is @final_rect.
+
+See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
+gtk_menu_popup_at_pointer (), #GtkMenu:anchor-hints,
+#GtkMenu:rect-anchor-dx, #GtkMenu:rect-anchor-dy, and
+#GtkMenu:menu-type-hint.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <parameter name="flipped_rect"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the position of @menu after any possible
+               flipping or %NULL if the backend can't obtain it</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+          <parameter name="final_rect"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the final position of @menu or %NULL if the
+             backend can't obtain it</doc>
+            <type name="gpointer" c:type="gpointer"/>
+          </parameter>
+          <parameter name="flipped_x" transfer-ownership="none">
+            <doc xml:space="preserve">%TRUE if the anchors were flipped horizontally</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+          <parameter name="flipped_y" transfer-ownership="none">
+            <doc xml:space="preserve">%TRUE if the anchors were flipped vertically</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </glib:signal>
     </class>
     <class name="MenuAccessible"
            c:symbol-prefix="menu_accessible"
@@ -71442,7 +72020,7 @@ that calls gtk_numerable_icon_set_style_context() internally.</doc>
         <doc xml:space="preserve">Returns the #GIcon that was set as the base background image, or
 %NULL if there’s none. The caller of this function does not own
 a reference to the returned #GIcon.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">a #GIcon, or %NULL</doc>
           <type name="Gio.Icon" c:type="GIcon*"/>
         </return-value>
@@ -71460,7 +72038,7 @@ a reference to the returned #GIcon.</doc>
               deprecated-version="3.14">
         <doc xml:space="preserve">Returns the icon name used as the base background image,
 or %NULL if there’s none.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">an icon name, or %NULL</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -71494,7 +72072,7 @@ or %NULL if there’s none.</doc>
               deprecated="1"
               deprecated-version="3.14">
         <doc xml:space="preserve">Returns the currently displayed label of the icon, or %NULL.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the currently displayed label</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -71512,7 +72090,7 @@ or %NULL if there’s none.</doc>
               deprecated-version="3.14">
         <doc xml:space="preserve">Returns the #GtkStyleContext used by the icon for theming,
 or %NULL if there’s none.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">a #GtkStyleContext, or %NULL.
     This object is internal to GTK+ and should not be unreffed.
     Use g_object_ref() if you want to keep it around</doc>
@@ -71998,7 +72576,8 @@ child property for @widget.</doc>
         </parameters>
       </method>
       <method name="reorder_overlay"
-              c:identifier="gtk_overlay_reorder_overlay">
+              c:identifier="gtk_overlay_reorder_overlay"
+              version="3.18">
         <doc xml:space="preserve">Moves @child to a new @index in the list of @overlay children.
 The list contains overlays in the order that these were
 added to @overlay.
@@ -72437,6 +73016,223 @@ and menuitems contained in menubars.</doc>
         <doc xml:space="preserve">The child is packed into the end of the box</doc>
       </member>
     </enumeration>
+    <record name="PadActionEntry" c:type="GtkPadActionEntry">
+      <doc xml:space="preserve">Struct defining a pad action entry.</doc>
+      <field name="type" writable="1">
+        <doc xml:space="preserve">the type of pad feature that will trigger this action entry.</doc>
+        <type name="PadActionType" c:type="GtkPadActionType"/>
+      </field>
+      <field name="index" writable="1">
+        <doc xml:space="preserve">the 0-indexed button/ring/strip number that will trigger this action
+  entry.</doc>
+        <type name="gint" c:type="gint"/>
+      </field>
+      <field name="mode" writable="1">
+        <doc xml:space="preserve">the mode that will trigger this action entry, or -1 for all modes.</doc>
+        <type name="gint" c:type="gint"/>
+      </field>
+      <field name="label" writable="1">
+        <doc xml:space="preserve">Human readable description of this action entry, this string should
+  be deemed user-visible.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </field>
+      <field name="action_name" writable="1">
+        <doc xml:space="preserve">action name that will be activated in the #GActionGroup.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </field>
+    </record>
+    <enumeration name="PadActionType"
+                 glib:type-name="GtkPadActionType"
+                 glib:get-type="gtk_pad_action_type_get_type"
+                 c:type="GtkPadActionType">
+      <doc xml:space="preserve">The type of a pad action.</doc>
+      <member name="button"
+              value="0"
+              c:identifier="GTK_PAD_ACTION_BUTTON"
+              glib:nick="button">
+        <doc xml:space="preserve">Action is triggered by a pad button</doc>
+      </member>
+      <member name="ring"
+              value="1"
+              c:identifier="GTK_PAD_ACTION_RING"
+              glib:nick="ring">
+        <doc xml:space="preserve">Action is triggered by a pad ring</doc>
+      </member>
+      <member name="strip"
+              value="2"
+              c:identifier="GTK_PAD_ACTION_STRIP"
+              glib:nick="strip">
+        <doc xml:space="preserve">Action is triggered by a pad strip</doc>
+      </member>
+    </enumeration>
+    <class name="PadController"
+           c:symbol-prefix="pad_controller"
+           c:type="GtkPadController"
+           parent="EventController"
+           glib:type-name="GtkPadController"
+           glib:get-type="gtk_pad_controller_get_type"
+           glib:type-struct="PadControllerClass">
+      <doc xml:space="preserve">#GtkPadController is an event controller for the pads found in drawing
+tablets (The collection of buttons and tactile sensors often found around
+the stylus-sensitive area).
+
+These buttons and sensors have no implicit meaning, and by default they
+perform no action, this event controller is provided to map those to
+#GAction objects, thus letting the application give those a more semantic
+meaning.
+
+Buttons and sensors are not constrained to triggering a single action, some
+%GDK_SOURCE_TABLET_PAD devices feature multiple "modes", all these input
+elements have one current mode, which may determine the final action
+being triggered. Pad devices often divide buttons and sensors into groups,
+all elements in a group share the same current mode, but different groups
+may have different modes. See gdk_device_pad_get_n_groups() and
+gdk_device_pad_get_group_n_modes().
+
+Each of the actions that a given button/strip/ring performs for a given
+mode is defined by #GtkPadActionEntry, it contains an action name that
+will be looked up in the given #GActionGroup and activated whenever the
+specified input element and mode are triggered.
+
+A simple example of #GtkPadController usage, assigning button 1 in all
+modes and pad devices to an "invert-selection" action:
+|[
+  GtkPadActionEntry *pad_actions[] = {
+    { GTK_PAD_ACTION_BUTTON, 1, -1, "Invert selection", "pad-actions.invert-selection" },
+    …
+  };
+
+  …
+  action_group = g_simple_action_group_new ();
+  action = g_simple_action_new ("pad-actions.invert-selection", NULL);
+  g_signal_connect (action, "activate", on_invert_selection_activated, NULL);
+  g_action_map_add_action (G_ACTION_MAP (action_group), action);
+  …
+  pad_controller = gtk_pad_controller_new (window, action_group, NULL);
+]|
+
+The actions belonging to rings/strips will be activated with a parameter
+of type %G_VARIANT_TYPE_DOUBLE bearing the value of the given axis, it
+is required that those are made stateful and accepting this #GVariantType.</doc>
+      <constructor name="new"
+                   c:identifier="gtk_pad_controller_new"
+                   version="3.22">
+        <doc xml:space="preserve">Creates a new #GtkPadController that will associate events from @pad to
+actions. A %NULL pad may be provided so the controller manages all pad devices
+generically, it is discouraged to mix #GtkPadController objects with %NULL
+and non-%NULL @pad argument on the same @window, as execution order is not
+guaranteed.
+
+The #GtkPadController is created with no mapped actions. In order to map pad
+events to actions, use gtk_pad_controller_set_action_entries() or
+gtk_pad_controller_set_action().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly created #GtkPadController</doc>
+          <type name="PadController" c:type="GtkPadController*"/>
+        </return-value>
+        <parameters>
+          <parameter name="window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkWindow</doc>
+            <type name="Window" c:type="GtkWindow*"/>
+          </parameter>
+          <parameter name="group" transfer-ownership="none">
+            <doc xml:space="preserve">#GActionGroup to trigger actions from</doc>
+            <type name="Gio.ActionGroup" c:type="GActionGroup*"/>
+          </parameter>
+          <parameter name="pad"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">A %GDK_SOURCE_TABLET_PAD device, or %NULL to handle all pads</doc>
+            <type name="Gdk.Device" c:type="GdkDevice*"/>
+          </parameter>
+        </parameters>
+      </constructor>
+      <method name="set_action"
+              c:identifier="gtk_pad_controller_set_action"
+              version="3.22">
+        <doc xml:space="preserve">Adds an individual action to @controller. This action will only be activated
+if the given button/ring/strip number in @index is interacted while
+the current mode is @mode. -1 may be used for simple cases, so the action
+is triggered on all modes.
+
+The given @label should be considered user-visible, so internationalization
+rules apply. Some windowing systems may be able to use those for user
+feedback.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="controller" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPadController</doc>
+            <type name="PadController" c:type="GtkPadController*"/>
+          </instance-parameter>
+          <parameter name="type" transfer-ownership="none">
+            <doc xml:space="preserve">the type of pad feature that will trigger this action</doc>
+            <type name="PadActionType" c:type="GtkPadActionType"/>
+          </parameter>
+          <parameter name="index" transfer-ownership="none">
+            <doc xml:space="preserve">the 0-indexed button/ring/strip number that will trigger this action</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+          <parameter name="mode" transfer-ownership="none">
+            <doc xml:space="preserve">the mode that will trigger this action, or -1 for all modes.</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+          <parameter name="label" transfer-ownership="none">
+            <doc xml:space="preserve">Human readable description of this action, this string should
+  be deemed user-visible.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="action_name" transfer-ownership="none">
+            <doc xml:space="preserve">action name that will be activated in the #GActionGroup</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_action_entries"
+              c:identifier="gtk_pad_controller_set_action_entries"
+              version="3.22">
+        <doc xml:space="preserve">This is a convenience function to add a group of action entries on
+@controller. See #GtkPadActionEntry and gtk_pad_controller_set_action().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="controller" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPadController</doc>
+            <type name="PadController" c:type="GtkPadController*"/>
+          </instance-parameter>
+          <parameter name="entries" transfer-ownership="none">
+            <doc xml:space="preserve">the action entries to set on @controller</doc>
+            <array length="1" zero-terminated="0" c:type="GtkPadActionEntry*">
+              <type name="PadActionEntry" c:type="GtkPadActionEntry"/>
+            </array>
+          </parameter>
+          <parameter name="n_entries" transfer-ownership="none">
+            <doc xml:space="preserve">the number of elements in @entries</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+        </parameters>
+      </method>
+      <property name="action-group"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <type name="Gio.ActionGroup"/>
+      </property>
+      <property name="pad"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <type name="Gdk.Device"/>
+      </property>
+    </class>
+    <record name="PadControllerClass"
+            c:type="GtkPadControllerClass"
+            disguised="1"
+            glib:is-gtype-struct-for="PadController">
+    </record>
     <enumeration name="PageOrientation"
                  glib:type-name="GtkPageOrientation"
                  glib:get-type="gtk_page_orientation_get_type"
@@ -72576,6 +73372,22 @@ or %NULL if an error occurred. See gtk_page_setup_to_file().</doc>
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_gvariant"
+                   c:identifier="gtk_page_setup_new_from_gvariant"
+                   version="3.22">
+        <doc xml:space="preserve">Desrialize a page setup from an a{sv} variant in
+the format produced by gtk_page_setup_to_gvariant().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkPageSetup object</doc>
+          <type name="PageSetup" c:type="GtkPageSetup*"/>
+        </return-value>
+        <parameters>
+          <parameter name="variant" transfer-ownership="none">
+            <doc xml:space="preserve">an a{sv} #GVariant</doc>
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_key_file"
                    c:identifier="gtk_page_setup_new_from_key_file"
                    version="2.12"
@@ -73028,6 +73840,21 @@ the margins according to the new paper size.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="to_gvariant"
+              c:identifier="gtk_page_setup_to_gvariant"
+              version="3.22">
+        <doc xml:space="preserve">Serialize page setup to an a{sv} variant.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new, floating, #GVariant</doc>
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="setup" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPageSetup</doc>
+            <type name="PageSetup" c:type="GtkPageSetup*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="to_key_file"
               c:identifier="gtk_page_setup_to_key_file"
               version="2.12">
@@ -73802,6 +74629,22 @@ to free it</doc>
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_gvariant"
+                   c:identifier="gtk_paper_size_new_from_gvariant"
+                   version="3.22">
+        <doc xml:space="preserve">Deserialize a paper size from an a{sv} variant in
+the format produced by gtk_paper_size_to_gvariant().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkPaperSize object</doc>
+          <type name="PaperSize" c:type="GtkPaperSize*"/>
+        </return-value>
+        <parameters>
+          <parameter name="variant" transfer-ownership="none">
+            <doc xml:space="preserve">an a{sv} #GVariant</doc>
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_ipp"
                    c:identifier="gtk_paper_size_new_from_ipp"
                    version="3.16">
@@ -74146,6 +74989,21 @@ represent the same paper size</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="to_gvariant"
+              c:identifier="gtk_paper_size_to_gvariant"
+              version="3.22">
+        <doc xml:space="preserve">Serialize a paper size to an a{sv} variant.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new, floating, #GVariant</doc>
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="paper_size" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPaperSize</doc>
+            <type name="PaperSize" c:type="GtkPaperSize*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="to_key_file"
               c:identifier="gtk_paper_size_to_key_file"
               version="2.12">
@@ -75468,8 +76326,13 @@ widget coordinates.</doc>
       </method>
       <method name="get_transitions_enabled"
               c:identifier="gtk_popover_get_transitions_enabled"
-              version="3.16">
+              version="3.16"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Returns whether show/hide transitions are enabled on this popover.</doc>
+        <doc-deprecated xml:space="preserve">You can show or hide the popover without transitions
+  using gtk_widget_show() and gtk_widget_hide() while gtk_popover_popup()
+  and gtk_popover_popdown() will use transitions.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">#TRUE if the show and hide transitions of the given
          popover are enabled, #FALSE otherwise.</doc>
@@ -75482,6 +76345,34 @@ widget coordinates.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="popdown" c:identifier="gtk_popover_popdown" version="3.22">
+        <doc xml:space="preserve">Pops @popover down.This is different than a gtk_widget_hide() call
+in that it shows the popover with a transition. If you want to hide
+the popover without a transition, use gtk_widget_hide().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="popover" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPopover</doc>
+            <type name="Popover" c:type="GtkPopover*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="popup" c:identifier="gtk_popover_popup" version="3.22">
+        <doc xml:space="preserve">Pops @popover up. This is different than a gtk_widget_show() call
+in that it shows the popover with a transition. If you want to show
+the popover without a transition, use gtk_widget_show().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="popover" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPopover</doc>
+            <type name="Popover" c:type="GtkPopover*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="set_constrain_to"
               c:identifier="gtk_popover_set_constrain_to"
               version="3.20">
@@ -75620,8 +76511,13 @@ unless extra references are kept.</doc>
       </method>
       <method name="set_transitions_enabled"
               c:identifier="gtk_popover_set_transitions_enabled"
-              version="3.16">
+              version="3.16"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Sets whether show/hide transitions are enabled on this popover</doc>
+        <doc-deprecated xml:space="preserve">You can show or hide the popover without transitions
+  using gtk_widget_show() and gtk_widget_hide() while gtk_popover_popup()
+  and gtk_popover_popdown() will use transitions.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -78405,6 +79301,22 @@ file could not be loaded then error is set to either a #GFileError or
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_gvariant"
+                   c:identifier="gtk_print_settings_new_from_gvariant"
+                   version="3.22">
+        <doc xml:space="preserve">Deserialize print settings from an a{sv} variant in
+the format produced by gtk_print_settings_to_gvariant().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkPrintSettings object</doc>
+          <type name="PrintSettings" c:type="GtkPrintSettings*"/>
+        </return-value>
+        <parameters>
+          <parameter name="variant" transfer-ownership="none">
+            <doc xml:space="preserve">an a{sv} #GVariant</doc>
+            <type name="GLib.Variant" c:type="GVariant*"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_key_file"
                    c:identifier="gtk_print_settings_new_from_key_file"
                    version="2.12"
@@ -79729,6 +80641,21 @@ file could not be loaded then error is set to either a #GFileError or
           </parameter>
         </parameters>
       </method>
+      <method name="to_gvariant"
+              c:identifier="gtk_print_settings_to_gvariant"
+              version="3.22">
+        <doc xml:space="preserve">Serialize print settings to an a{sv} variant.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new, floating, #GVariant</doc>
+          <type name="GLib.Variant" c:type="GVariant*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="settings" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkPrintSettings</doc>
+            <type name="PrintSettings" c:type="GtkPrintSettings*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="to_key_file"
               c:identifier="gtk_print_settings_to_key_file"
               version="2.12">
@@ -81741,6 +82668,25 @@ of the “steppers”. It also provides properties and methods for setting a
           </parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="get_range_size_request">
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="range" transfer-ownership="none">
+            <type name="Range" c:type="GtkRange*"/>
+          </instance-parameter>
+          <parameter name="orientation" transfer-ownership="none">
+            <type name="Orientation" c:type="GtkOrientation"/>
+          </parameter>
+          <parameter name="minimum" transfer-ownership="none">
+            <type name="gint" c:type="gint*"/>
+          </parameter>
+          <parameter name="natural" transfer-ownership="none">
+            <type name="gint" c:type="gint*"/>
+          </parameter>
+        </parameters>
+      </virtual-method>
       <virtual-method name="move_slider">
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -82553,6 +83499,27 @@ It is not possible to use delayed update policies in an overridden
           </parameters>
         </callback>
       </field>
+      <field name="get_range_size_request">
+        <callback name="get_range_size_request">
+          <return-value transfer-ownership="none">
+            <type name="none" c:type="void"/>
+          </return-value>
+          <parameters>
+            <parameter name="range" transfer-ownership="none">
+              <type name="Range" c:type="GtkRange*"/>
+            </parameter>
+            <parameter name="orientation" transfer-ownership="none">
+              <type name="Orientation" c:type="GtkOrientation"/>
+            </parameter>
+            <parameter name="minimum" transfer-ownership="none">
+              <type name="gint" c:type="gint*"/>
+            </parameter>
+            <parameter name="natural" transfer-ownership="none">
+              <type name="gint" c:type="gint*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
       <field name="_gtk_reserved1" introspectable="0">
         <callback name="_gtk_reserved1">
           <return-value transfer-ownership="none">
@@ -82574,13 +83541,6 @@ It is not possible to use delayed update policies in an overridden
           </return-value>
         </callback>
       </field>
-      <field name="_gtk_reserved4" introspectable="0">
-        <callback name="_gtk_reserved4">
-          <return-value transfer-ownership="none">
-            <type name="none" c:type="void"/>
-          </return-value>
-        </callback>
-      </field>
     </record>
     <record name="RangePrivate" c:type="GtkRangePrivate" disguised="1">
     </record>
@@ -85633,7 +86593,7 @@ associated with an entry in the recently used files list.</doc>
               c:identifier="gtk_recent_info_create_app_info"
               throws="1">
         <doc xml:space="preserve">Creates a #GAppInfo for the specified #GtkRecentInfo</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the newly created #GAppInfo, or %NULL.
   In case of error, @error will be set either with a
   %GTK_RECENT_MANAGER_ERROR or a %G_IO_ERROR</doc>
@@ -85820,7 +86780,7 @@ of the resource is obtained.</doc>
               c:identifier="gtk_recent_info_get_gicon"
               version="2.22">
         <doc xml:space="preserve">Retrieves the icon associated to the resource MIME type.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a #GIcon containing the icon, or %NULL.
   Use g_object_unref() when finished using the icon</doc>
           <type name="Gio.Icon" c:type="GIcon*"/>
@@ -85866,7 +86826,7 @@ length might optionally be %NULL.</doc>
               c:identifier="gtk_recent_info_get_icon"
               version="2.10">
         <doc xml:space="preserve">Retrieves the icon of size @size associated to the resource MIME type.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a #GdkPixbuf containing the icon,
     or %NULL. Use g_object_unref() when finished using the icon.</doc>
           <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
@@ -85973,7 +86933,7 @@ this function on an item that refers to
         <doc xml:space="preserve">Gets a displayable version of the resource’s URI. If the resource
 is local, it returns a local path; if the resource is not local,
 it returns the UTF-8 encoded content of gtk_recent_info_get_uri().</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a newly allocated UTF-8 string containing the
   resource’s URI or %NULL. Use g_free() when done using it.</doc>
           <type name="utf8" c:type="gchar*"/>
@@ -88397,7 +89357,7 @@ Refer to individual widget documentation for used style classes.</doc>
     <constant name="STYLE_CLASS_LIST_ROW"
               value="list-row"
               c:type="GTK_STYLE_CLASS_LIST_ROW">
-      <doc xml:space="preserve">A CSS class to match list rowss.
+      <doc xml:space="preserve">A CSS class to match list rows.
 
 Refer to individual widget documentation for used style classes.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -89343,7 +90303,12 @@ values are undefined.</doc>
       <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>
+number of digits, so the retrieved value matches the value the user saw.
+
+Note that rounding to a small number of digits can interfere with
+the smooth autoscrolling that is built into #GtkScale. As an alternative,
+you can use the #GtkScale::format-value signal to format the displayed
+value yourself.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -90538,6 +91503,17 @@ 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.
 
+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
+|[&lt;!-- language="C" --&gt;
+gtk_container_remove (GTK_CONTAINER (scrolled_window),
+                      child_widget);
+// or
+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
@@ -90741,6 +91717,36 @@ functionality.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_max_content_height"
+              c:identifier="gtk_scrolled_window_get_max_content_height"
+              version="3.22">
+        <doc xml:space="preserve">Returns the maximum content height set.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the maximum content height, or -1</doc>
+          <type name="gint" c:type="gint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_max_content_width"
+              c:identifier="gtk_scrolled_window_get_max_content_width"
+              version="3.22">
+        <doc xml:space="preserve">Returns the maximum content width set.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the maximum content width, or -1</doc>
+          <type name="gint" c:type="gint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_min_content_height"
               c:identifier="gtk_scrolled_window_get_min_content_height"
               version="3.0">
@@ -90837,6 +91843,38 @@ scrollbars. See gtk_scrolled_window_set_policy().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_propagate_natural_height"
+              c:identifier="gtk_scrolled_window_get_propagate_natural_height"
+              version="3.22">
+        <doc xml:space="preserve">Reports whether the natural height of the child will be calculated and propagated
+through the scrolled windows requested natural height.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether natural height propagation is enabled.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_propagate_natural_width"
+              c:identifier="gtk_scrolled_window_get_propagate_natural_width"
+              version="3.22">
+        <doc xml:space="preserve">Reports whether the natural width of the child will be calculated and propagated
+through the scrolled windows requested natural width.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether natural width propagation is enabled.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_shadow_type"
               c:identifier="gtk_scrolled_window_get_shadow_type">
         <doc xml:space="preserve">Gets the shadow type of the scrolled window. See
@@ -90947,12 +91985,61 @@ Kinetic scrolling only applies to devices with source
           </parameter>
         </parameters>
       </method>
+      <method name="set_max_content_height"
+              c:identifier="gtk_scrolled_window_set_max_content_height"
+              version="3.22">
+        <doc xml:space="preserve">Sets the maximum height that @scrolled_window should keep visible. The
+@scrolled_window will grow up to this height before it starts scrolling
+the content.
+
+It is a programming error to set the maximum content height to a value
+smaller than #GtkScrolledWindow:min-content-height.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+          <parameter name="height" transfer-ownership="none">
+            <doc xml:space="preserve">the maximum content height</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_max_content_width"
+              c:identifier="gtk_scrolled_window_set_max_content_width"
+              version="3.22">
+        <doc xml:space="preserve">Sets the maximum width that @scrolled_window should keep visible. The
+@scrolled_window will grow up to this width before it starts scrolling
+the content.
+
+It is a programming error to set the maximum content width to a value
+smaller than #GtkScrolledWindow:min-content-width.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+          <parameter name="width" transfer-ownership="none">
+            <doc xml:space="preserve">the maximum content width</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_min_content_height"
               c:identifier="gtk_scrolled_window_set_min_content_height"
               version="3.0">
         <doc xml:space="preserve">Sets the minimum height that @scrolled_window should keep visible.
 Note that this can and (usually will) be smaller than the minimum
-size of the content.</doc>
+size of the content.
+
+It is a programming error to set the minimum content height to a
+value greater than #GtkScrolledWindow:max-content-height.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -90972,7 +92059,10 @@ size of the content.</doc>
               version="3.0">
         <doc xml:space="preserve">Sets the minimum width that @scrolled_window should keep visible.
 Note that this can and (usually will) be smaller than the minimum
-size of the content.</doc>
+size of the content.
+
+It is a programming error to set the minimum content width to a
+value greater than #GtkScrolledWindow:max-content-width.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -91058,6 +92148,44 @@ than the trough — the display is larger than the page size).</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="set_propagate_natural_height"
+              c:identifier="gtk_scrolled_window_set_propagate_natural_height"
+              version="3.22">
+        <doc xml:space="preserve">Sets whether the natural height of the child should be calculated and propagated
+through the scrolled windows requested natural height.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+          <parameter name="propagate" transfer-ownership="none">
+            <doc xml:space="preserve">whether to propagate natural height</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_propagate_natural_width"
+              c:identifier="gtk_scrolled_window_set_propagate_natural_width"
+              version="3.22">
+        <doc xml:space="preserve">Sets whether the natural width of the child should be calculated and propagated
+through the scrolled windows requested natural width.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="scrolled_window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkScrolledWindow</doc>
+            <type name="ScrolledWindow" c:type="GtkScrolledWindow*"/>
+          </instance-parameter>
+          <parameter name="propagate" transfer-ownership="none">
+            <doc xml:space="preserve">whether to propagate natural width</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_shadow_type"
               c:identifier="gtk_scrolled_window_set_shadow_type">
         <doc xml:space="preserve">Changes the type of shadow drawn around the contents of
@@ -91131,6 +92259,20 @@ gtk_scrolled_window_get_placement().</doc>
 only applies to devices with source %GDK_SOURCE_TOUCHSCREEN.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="max-content-height"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The maximum content height of @scrolled_window, or -1 if not set.</doc>
+        <type name="gint" c:type="gint"/>
+      </property>
+      <property name="max-content-width"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The maximum content width of @scrolled_window, or -1 if not set.</doc>
+        <type name="gint" c:type="gint"/>
+      </property>
       <property name="min-content-height"
                 version="3.0"
                 writable="1"
@@ -91155,6 +92297,28 @@ is present. Otherwise, they are overlayed on top of the content,
 as narrow indicators.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="propagate-natural-height"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether the natural height of the child should be calculated and propagated
+through the scrolled windows requested natural height.
+
+This is useful in cases where an attempt should be made to allocate exactly
+enough space for the natural size of the child.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
+      <property name="propagate-natural-width"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether the natural width of the child should be calculated and propagated
+through the scrolled windows requested natural width.
+
+This is useful in cases where an attempt should be made to allocate exactly
+enough space for the natural size of the child.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <property name="shadow-type" writable="1" transfer-ownership="none">
         <type name="ShadowType"/>
       </property>
@@ -93656,6 +94820,121 @@ or there is (any other value).</doc>
         <doc xml:space="preserve">The outline has a raised 3d appearance.</doc>
       </member>
     </enumeration>
+    <class name="ShortcutLabel"
+           c:symbol-prefix="shortcut_label"
+           c:type="GtkShortcutLabel"
+           parent="Box"
+           glib:type-name="GtkShortcutLabel"
+           glib:get-type="gtk_shortcut_label_get_type"
+           glib:type-struct="ShortcutLabelClass">
+      <doc xml:space="preserve">#GtkShortcutLabel is a widget that represents a single keyboard shortcut or gesture
+in the user interface.</doc>
+      <implements name="Atk.ImplementorIface"/>
+      <implements name="Buildable"/>
+      <implements name="Orientable"/>
+      <constructor name="new"
+                   c:identifier="gtk_shortcut_label_new"
+                   version="3.22">
+        <doc xml:space="preserve">Creates a new #GtkShortcutLabel with @accelerator set.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a newly-allocated #GtkShortcutLabel</doc>
+          <type name="Widget" c:type="GtkWidget*"/>
+        </return-value>
+        <parameters>
+          <parameter name="accelerator" transfer-ownership="none">
+            <doc xml:space="preserve">the initial accelerator</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </constructor>
+      <method name="get_accelerator"
+              c:identifier="gtk_shortcut_label_get_accelerator"
+              version="3.22">
+        <doc xml:space="preserve">Retrieves the current accelerator of @self.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the current accelerator.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkShortcutLabel</doc>
+            <type name="ShortcutLabel" c:type="GtkShortcutLabel*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_disabled_text"
+              c:identifier="gtk_shortcut_label_get_disabled_text"
+              version="3.22">
+        <doc xml:space="preserve">Retrieves the text that is displayed when no accelerator is set.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the current text displayed when no
+accelerator is set.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkShortcutLabel</doc>
+            <type name="ShortcutLabel" c:type="GtkShortcutLabel*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="set_accelerator"
+              c:identifier="gtk_shortcut_label_set_accelerator"
+              version="3.22">
+        <doc xml:space="preserve">Sets the accelerator to be displayed by @self.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkShortcutLabel</doc>
+            <type name="ShortcutLabel" c:type="GtkShortcutLabel*"/>
+          </instance-parameter>
+          <parameter name="accelerator" transfer-ownership="none">
+            <doc xml:space="preserve">the new accelerator</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_disabled_text"
+              c:identifier="gtk_shortcut_label_set_disabled_text"
+              version="3.22">
+        <doc xml:space="preserve">Sets the text to be displayed by @self when no accelerator is set.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="self" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkShortcutLabel</doc>
+            <type name="ShortcutLabel" c:type="GtkShortcutLabel*"/>
+          </instance-parameter>
+          <parameter name="disabled_text" transfer-ownership="none">
+            <doc xml:space="preserve">the text to be displayed when no accelerator is set</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <property name="accelerator"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The accelerator that @self displays. See #GtkShortcutsShortcut:accelerator
+for the accepted syntax.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
+      <property name="disabled-text"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The text that is displayed when no accelerator is set.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
+    </class>
+    <record name="ShortcutLabelClass"
+            c:type="GtkShortcutLabelClass"
+            disguised="1"
+            glib:is-gtype-struct-for="ShortcutLabel">
+    </record>
     <enumeration name="ShortcutType"
                  version="3.20"
                  glib:type-name="GtkShortcutType"
@@ -93674,37 +94953,37 @@ More values may be added to this enumeration over time.</doc>
               value="1"
               c:identifier="GTK_SHORTCUT_GESTURE_PINCH"
               glib:nick="gesture-pinch">
-        <doc xml:space="preserve">The shortcut is a pinch gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a pinch gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture_stretch"
               value="2"
               c:identifier="GTK_SHORTCUT_GESTURE_STRETCH"
               glib:nick="gesture-stretch">
-        <doc xml:space="preserve">The shortcut is a stretch gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a stretch gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture_rotate_clockwise"
               value="3"
               c:identifier="GTK_SHORTCUT_GESTURE_ROTATE_CLOCKWISE"
               glib:nick="gesture-rotate-clockwise">
-        <doc xml:space="preserve">The shortcut is a clockwise rotation gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a clockwise rotation gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture_rotate_counterclockwise"
               value="4"
               c:identifier="GTK_SHORTCUT_GESTURE_ROTATE_COUNTERCLOCKWISE"
               glib:nick="gesture-rotate-counterclockwise">
-        <doc xml:space="preserve">The shortcut is a counterclockwise rotation gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a counterclockwise rotation gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture_two_finger_swipe_left"
               value="5"
               c:identifier="GTK_SHORTCUT_GESTURE_TWO_FINGER_SWIPE_LEFT"
               glib:nick="gesture-two-finger-swipe-left">
-        <doc xml:space="preserve">The shortcut is a two-finger swipe gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a two-finger swipe gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture_two_finger_swipe_right"
               value="6"
               c:identifier="GTK_SHORTCUT_GESTURE_TWO_FINGER_SWIPE_RIGHT"
               glib:nick="gesture-two-finger-swipe-right">
-        <doc xml:space="preserve">The shortcut is a two-finger swipe gesture. GTK+ provides and icon and subtitle.</doc>
+        <doc xml:space="preserve">The shortcut is a two-finger swipe gesture. GTK+ provides an icon and subtitle.</doc>
       </member>
       <member name="gesture"
               value="7"
@@ -93881,6 +95160,17 @@ Note that &lt;, &gt; and &amp; need to be escaped as &amp;lt;, &amp;gt; and &amp
 in .ui files.</doc>
         <type name="utf8" c:type="gchar*"/>
       </property>
+      <property name="action-name"
+                version="3.22"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">A detailed action name. If this is set for a shortcut
+of type %GTK_SHORTCUT_ACCELERATOR, then GTK+ will use
+the accelerators that are associated with the action
+via gtk_application_set_accels_for_action(), and setting
+#GtkShortcutsShortcut::accelerator is not necessary.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
       <property name="direction" writable="1" transfer-ownership="none">
         <doc xml:space="preserve">The text direction for which this shortcut is active. If the shortcut
 is used regardless of the text direction, set this property to
@@ -93979,7 +95269,7 @@ The .ui file for this example can be found [here](https://git.gnome.org/browse/g
 This example shows a #GtkShortcutsWindow with two sections, "Editor Shortcuts"
 and "Terminal Shortcuts".
 
-The .ui file for this example can be found [here](https://git.gnome.org/browse/gtk+/tree/demos/gtk-demo/shortcuts-clocks.ui).</doc>
+The .ui file for this example can be found [here](https://git.gnome.org/browse/gtk+/tree/demos/gtk-demo/shortcuts-builder.ui).</doc>
       <implements name="Atk.ImplementorIface"/>
       <implements name="Buildable"/>
       <virtual-method name="close">
@@ -94185,8 +95475,16 @@ be removed from the size group.</doc>
       </method>
       <method name="get_ignore_hidden"
               c:identifier="gtk_size_group_get_ignore_hidden"
-              version="2.8">
+              version="2.8"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Returns if invisible widgets are ignored when calculating the size.</doc>
+        <doc-deprecated xml:space="preserve">Measuring the size of hidden widgets has not worked
+    reliably for a long time. In most cases, they will report a size
+    of 0 nowadays, and thus, their size will not affect the other
+    size group members. In effect, size groups will always operate
+    as if this property was %TRUE. Use a #GtkStack instead to hide
+    widgets while still having their size taken into account.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if invisible widgets are ignored.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -94247,9 +95545,17 @@ be removed from the size group.</doc>
       </method>
       <method name="set_ignore_hidden"
               c:identifier="gtk_size_group_set_ignore_hidden"
-              version="2.8">
+              version="2.8"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Sets whether unmapped widgets should be ignored when
 calculating the size.</doc>
+        <doc-deprecated xml:space="preserve">Measuring the size of hidden widgets has not worked
+    reliably for a long time. In most cases, they will report a size
+    of 0 nowadays, and thus, their size will not affect the other
+    size group members. In effect, size groups will always operate
+    as if this property was %TRUE. Use a #GtkStack instead to hide
+    widgets while still having their size taken into account.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -94288,10 +95594,18 @@ or should all have the same requisition in both directions
       </method>
       <property name="ignore-hidden"
                 version="2.8"
+                deprecated="1"
+                deprecated-version="3.22"
                 writable="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">If %TRUE, unmapped widgets are ignored when determining
 the size of the group.</doc>
+        <doc-deprecated xml:space="preserve">Measuring the size of hidden widgets has not worked
+    reliably for a long time. In most cases, they will report a size
+    of 0 nowadays, and thus, their size will not affect the other
+    size group members. In effect, size groups will always operate
+    as if this property was %TRUE. Use a #GtkStack instead to hide
+    widgets while still having their size taken into account.</doc-deprecated>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="mode" writable="1" transfer-ownership="none">
@@ -95997,6 +97311,26 @@ child of @stack.</doc>
         <type name="Container" c:type="GtkContainer"/>
       </field>
     </class>
+    <class name="StackAccessible"
+           c:symbol-prefix="stack_accessible"
+           c:type="GtkStackAccessible"
+           parent="ContainerAccessible"
+           glib:type-name="GtkStackAccessible"
+           glib:get-type="gtk_stack_accessible_get_type"
+           glib:type-struct="StackAccessibleClass">
+      <implements name="Atk.Component"/>
+      <field name="parent">
+        <type name="ContainerAccessible" c:type="GtkContainerAccessible"/>
+      </field>
+    </class>
+    <record name="StackAccessibleClass"
+            c:type="GtkStackAccessibleClass"
+            glib:is-gtype-struct-for="StackAccessible">
+      <field name="parent_class">
+        <type name="ContainerAccessibleClass"
+              c:type="GtkContainerAccessibleClass"/>
+      </field>
+    </record>
     <record name="StackClass"
             c:type="GtkStackClass"
             glib:is-gtype-struct-for="Stack">
@@ -96899,7 +98233,7 @@ returned #GIcon.
 
 If this function fails, @icon is left unchanged;</doc>
         <doc-deprecated xml:space="preserve">Use notifications</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the displayed icon, or %NULL if the image is empty</doc>
           <type name="Gio.Icon" c:type="GIcon*"/>
         </return-value>
@@ -96940,7 +98274,7 @@ The storage type of the status icon must be %GTK_IMAGE_EMPTY or
 The returned string is owned by the #GtkStatusIcon and should not
 be freed or modified.</doc>
         <doc-deprecated xml:space="preserve">Use notifications</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">name of the displayed icon, or %NULL if the image is empty.</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -96962,7 +98296,7 @@ The storage type of the status icon must be %GTK_IMAGE_EMPTY or
 The caller of this function does not own a reference to the
 returned pixbuf.</doc>
         <doc-deprecated xml:space="preserve">Use notifications</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the displayed pixbuf,
     or %NULL if the image is empty.</doc>
           <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
@@ -97028,7 +98362,7 @@ The storage type of the status icon must be %GTK_IMAGE_EMPTY or
 The returned string is owned by the #GtkStatusIcon and should not
 be freed or modified.</doc>
         <doc-deprecated xml:space="preserve">Use gtk_status_icon_get_icon_name() instead.</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">stock id of the displayed stock icon,
   or %NULL if the image is empty.</doc>
           <type name="utf8" c:type="const gchar*"/>
@@ -97085,7 +98419,7 @@ the return value will be %GTK_IMAGE_EMPTY.</doc>
               deprecated-version="3.14">
         <doc xml:space="preserve">Gets the contents of the tooltip for @status_icon.</doc>
         <doc-deprecated xml:space="preserve">Use notifications</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the tooltip text, or %NULL. You should free the
   returned string with g_free() when done.</doc>
           <type name="utf8" c:type="gchar*"/>
@@ -97104,7 +98438,7 @@ the return value will be %GTK_IMAGE_EMPTY.</doc>
               deprecated-version="3.14">
         <doc xml:space="preserve">Gets the contents of the tooltip for @status_icon.</doc>
         <doc-deprecated xml:space="preserve">Use notifications</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the tooltip text, or %NULL. You should free the
   returned string with g_free() when done.</doc>
           <type name="utf8" c:type="gchar*"/>
@@ -101643,8 +102977,8 @@ information immediately.</doc>
 the default icon factory, returning an icon set if found, otherwise
 %NULL.</doc>
         <doc-deprecated xml:space="preserve">Use gtk_icon_theme_lookup_icon() instead.</doc-deprecated>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">The looked  up %GtkIconSet, or %NULL</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The looked up %GtkIconSet, or %NULL</doc>
           <type name="IconSet" c:type="GtkIconSet*"/>
         </return-value>
         <parameters>
@@ -102385,7 +103719,10 @@ a theming engine, you want to use that function instead.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <parameter name="parse_func" transfer-ownership="none">
+          <parameter name="parse_func"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">parsing function to use, or %NULL</doc>
             <type name="StylePropertyParser" c:type="GtkStylePropertyParser"/>
           </parameter>
@@ -102759,7 +104096,7 @@ See gtk_style_context_add_provider() and gtk_style_context_add_provider_for_scre
         <doc xml:space="preserve">Returns the #GtkIconFactory defined to be in use for @path, or %NULL if none
 is defined.</doc>
         <doc-deprecated xml:space="preserve">Will always return %NULL for all GTK-provided style providers.</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The icon factory to use for @path, or %NULL</doc>
           <type name="IconFactory" c:type="GtkIconFactory*"/>
         </return-value>
@@ -102783,7 +104120,7 @@ is defined.</doc>
 @provider doesn’t contemplate styling @path.</doc>
         <doc-deprecated xml:space="preserve">Will always return %NULL for all GTK-provided style providers
     as the interface cannot correctly work the way CSS is specified.</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a #GtkStyleProperties containing the
 style settings affecting @path</doc>
           <type name="StyleProperties" c:type="GtkStyleProperties*"/>
@@ -102842,7 +104179,7 @@ the widget represented by @path.</doc>
         <doc xml:space="preserve">Returns the #GtkIconFactory defined to be in use for @path, or %NULL if none
 is defined.</doc>
         <doc-deprecated xml:space="preserve">Will always return %NULL for all GTK-provided style providers.</doc-deprecated>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The icon factory to use for @path, or %NULL</doc>
           <type name="IconFactory" c:type="GtkIconFactory*"/>
         </return-value>
@@ -102866,7 +104203,7 @@ is defined.</doc>
 @provider doesn’t contemplate styling @path.</doc>
         <doc-deprecated xml:space="preserve">Will always return %NULL for all GTK-provided style providers
     as the interface cannot correctly work the way CSS is specified.</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a #GtkStyleProperties containing the
 style settings affecting @path</doc>
           <type name="StyleProperties" c:type="GtkStyleProperties*"/>
@@ -102926,7 +104263,7 @@ the widget represented by @path.</doc>
       </field>
       <field name="get_style">
         <callback name="get_style">
-          <return-value transfer-ownership="full">
+          <return-value transfer-ownership="full" nullable="1">
             <doc xml:space="preserve">a #GtkStyleProperties containing the
 style settings affecting @path</doc>
             <type name="StyleProperties" c:type="GtkStyleProperties*"/>
@@ -102978,7 +104315,7 @@ style settings affecting @path</doc>
       </field>
       <field name="get_icon_factory">
         <callback name="get_icon_factory">
-          <return-value transfer-ownership="none">
+          <return-value transfer-ownership="none" nullable="1">
             <doc xml:space="preserve">The icon factory to use for @path, or %NULL</doc>
             <type name="IconFactory" c:type="GtkIconFactory*"/>
           </return-value>
@@ -113193,7 +114530,7 @@ There are no default bindings for this signal.</doc>
         </return-value>
         <parameters>
           <parameter name="step" transfer-ownership="none">
-            <doc xml:space="preserve">the granularity of the move, as a #GtkMovementStep</doc>
+            <doc xml:space="preserve">the granularity of the movement, as a #GtkScrollStep</doc>
             <type name="ScrollStep"/>
           </parameter>
           <parameter name="count" transfer-ownership="none">
@@ -113685,7 +115022,7 @@ to modify source code.</doc>
                 deprecated-version="3.14">
         <doc xml:space="preserve">Loads and initializes a theming engine module from the
 standard directories.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">A theming engine, or %NULL if
 the engine @name doesn’t exist.</doc>
           <type name="ThemingEngine" c:type="GtkThemingEngine*"/>
@@ -114480,7 +115817,7 @@ to the currently rendered element.</doc>
               deprecated="1"
               deprecated-version="3.14">
         <doc xml:space="preserve">Returns the #GdkScreen to which @engine currently rendering to.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">a #GdkScreen, or %NULL.</doc>
           <type name="Gdk.Screen" c:type="GdkScreen*"/>
         </return-value>
@@ -119541,7 +120878,7 @@ and #GtkActionGroup.</doc>
 straight mapping between the cell and the model.  This is useful for
 customizing the cell renderer.  For example, a function might get an
 integer from the @tree_model, and render it to the “text” attribute of
-“cell” by converting it to its written equivilent.  This is set by
+“cell” by converting it to its written equivalent.  This is set by
 calling gtk_tree_view_column_set_cell_data_func()</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
@@ -132921,7 +134258,7 @@ implementing a #GtkContainer, as you'll be able to use the
 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
+are in place, the @widget will be in an "inert" 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.
@@ -134581,7 +135918,7 @@ implementing a #GtkContainer, as you'll be able to use the
 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
+are in place, the @widget will be in an "inert" 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.
@@ -134986,7 +136323,9 @@ drag_motion (GtkWidget *widget,
         </parameters>
       </method>
       <method name="drag_dest_set_proxy"
-              c:identifier="gtk_drag_dest_set_proxy">
+              c:identifier="gtk_drag_dest_set_proxy"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Sets this widget as a proxy for drops to another window.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -137641,7 +138980,9 @@ intermediate containers.</doc>
       </method>
       <method name="is_composited"
               c:identifier="gtk_widget_is_composited"
-              version="2.10">
+              version="2.10"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Whether @widget can rely on having its alpha channel
 drawn correctly. On X11 this function returns whether a
 compositing manager is running for @widget’s screen.
@@ -137649,6 +138990,7 @@ compositing manager is running for @widget’s screen.
 Please note that the semantics of this call will change
 in the future if used on a widget that has a composited
 window in its hierarchy (as set by gdk_window_set_composited()).</doc>
+        <doc-deprecated xml:space="preserve">Use gdk_screen_is_composited() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the widget can rely on its alpha
 channel being drawn correctly.</doc>
@@ -138730,7 +140072,7 @@ The pixels in the returned #GdkPixbuf are shared with the rest of
 the application and should not be modified. The pixbuf should be
 freed after use with g_object_unref().</doc>
         <doc-deprecated xml:space="preserve">Use gtk_widget_render_icon_pixbuf() instead.</doc-deprecated>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a new pixbuf, or %NULL if the
     stock ID wasn’t known</doc>
           <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
@@ -138854,7 +140196,10 @@ style might apply to it. See also gtk_container_get_path_for_child().</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="send_expose" c:identifier="gtk_widget_send_expose">
+      <method name="send_expose"
+              c:identifier="gtk_widget_send_expose"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Very rarely-used function. This function is used to emit
 an expose event on a widget. This function is not normally used
 directly. The only time it is used is when propagating an expose
@@ -138865,9 +140210,13 @@ If you want to force an area of a window to be redrawn,
 use gdk_window_invalidate_rect() or gdk_window_invalidate_region().
 To cause the redraw to be done immediately, follow that call
 with a call to gdk_window_process_updates().</doc>
+        <doc-deprecated xml:space="preserve">Application and widget code should not handle
+  expose events directly; invalidation should use the #GtkWidget
+  API, and drawing should only happen inside #GtkWidget::draw
+  implementations</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">return from the event signal emission (%TRUE if
-              the event was handled)</doc>
+  the event was handled)</doc>
           <type name="gint" c:type="gint"/>
         </return-value>
         <parameters>
@@ -139235,10 +140584,10 @@ set by gtk_widget_set_default_direction() will be used.</doc>
               deprecated-version="3.14">
         <doc xml:space="preserve">Widgets are double buffered by default; you can use this function
 to turn off the buffering. “Double buffered” simply means that
-gdk_window_begin_paint_region() and gdk_window_end_paint() are called
+gdk_window_begin_draw_frame() and gdk_window_end_draw_frame() are called
 automatically around expose events sent to the
-widget. gdk_window_begin_paint_region() diverts all drawing to a widget's
-window to an offscreen buffer, and gdk_window_end_paint() draws the
+widget. gdk_window_begin_draw_frame() diverts all drawing to a widget's
+window to an offscreen buffer, and gdk_window_end_draw_frame() draws the
 buffer to the screen. The result is that users see the window
 update in one smooth step, and don’t see individual graphics
 primitives being rendered.
@@ -139250,7 +140599,7 @@ if you had special needs and really knew what you were doing.
 Note: if you turn off double-buffering, you have to handle
 expose events, since even the clearing to the background color or
 pixmap will not happen automatically (as it is done in
-gdk_window_begin_paint_region()).
+gdk_window_begin_draw_frame()).
 
 In 3.10 GTK and GDK have been restructured for translucent drawing. Since
 then expose events for double-buffered widgets are culled into a single
@@ -141020,10 +142369,15 @@ changed on an object. The signal's detail holds the property name.</doc>
           </parameter>
         </parameters>
       </glib:signal>
-      <glib:signal name="composited-changed" when="last" action="1">
+      <glib:signal name="composited-changed"
+                   when="last"
+                   action="1"
+                   deprecated="1"
+                   deprecated-version="3.22">
         <doc xml:space="preserve">The ::composited-changed signal is emitted when the composited
 status of @widgets screen changes.
 See gdk_screen_is_composited().</doc>
+        <doc-deprecated xml:space="preserve">Use GdkScreen::composited-changed instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -141503,7 +142857,7 @@ get a finer-grained representation of the dirty region with
 cairo_copy_clip_rectangle_list().</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>
+%FALSE to propagate the event further.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -141955,7 +143309,7 @@ destined function calls.</doc>
             <type name="gint" c:type="gint"/>
           </parameter>
           <parameter name="keyboard_mode" transfer-ownership="none">
-            <doc xml:space="preserve">%TRUE if the tooltip was trigged using the keyboard</doc>
+            <doc xml:space="preserve">%TRUE if the tooltip was triggered using the keyboard</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
           <parameter name="tooltip" transfer-ownership="none">
@@ -144459,7 +145813,7 @@ hierarchy defined in @path.</doc>
         <doc xml:space="preserve">Returns the name corresponding to the widget found at
 the position @pos in the widget hierarchy defined by
 @path</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The widget name, or %NULL if none was set.</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -144479,7 +145833,7 @@ the position @pos in the widget hierarchy defined by
               version="3.20">
         <doc xml:space="preserve">Returns the object name that is at position @pos in the widget
 hierarchy defined in @path.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the name or %NULL</doc>
           <type name="utf8" c:type="const char*"/>
         </return-value>
@@ -146104,58 +147458,78 @@ returned is owned by the widget and must not be modified or freed.</doc>
         </parameters>
       </method>
       <method name="get_size" c:identifier="gtk_window_get_size">
-        <doc xml:space="preserve">Obtains the current size of @window. If @window is not onscreen,
-it returns the size GTK+ will suggest to the
-[window manager][gtk-X11-arch]
-for the initial window
-size (but this is not reliably the same as the size the window
-manager will actually select). The size obtained by
-gtk_window_get_size() is the last size received in a
-#GdkEventConfigure, that is, GTK+ uses its locally-stored size,
-rather than querying the X server for the size. As a result, if you
-call gtk_window_resize() then immediately call
-gtk_window_get_size(), the size won’t have taken effect yet. After
-the window manager processes the resize request, GTK+ receives
-notification that the size has changed via a configure event, and
-the size of the window gets updated.
-
-Note 1: Nearly any use of this function creates a race condition,
-because the size of the window may change between the time that you
-get the size and the time that you perform some action assuming
-that size is the current size. To avoid race conditions, connect to
-“configure-event” on the window and adjust your size-dependent
-state to match the size delivered in the #GdkEventConfigure.
-
-Note 2: The returned size does not include the
-size of the window manager decorations (aka the window frame or
-border). Those are not drawn by GTK+ and GTK+ has no reliable
-method of determining their size.
-
-Note 3: If you are getting a window size in order to position
-the window onscreen, there may be a better way. The preferred
-way is to simply set the window’s semantic type with
-gtk_window_set_type_hint(), which allows the window manager to
-e.g. center dialogs. Also, if you set the transient parent of
-dialogs with gtk_window_set_transient_for() window managers
-will often center the dialog over its parent window. It's
-much preferred to let the window manager handle these
-things rather than doing it yourself, because all apps will
-behave consistently and according to user prefs if the window
-manager handles it. Also, the window manager can take the size
-of the window decorations/border into account, while your
-application cannot.
-
-Note 4: When using client side decorations, GTK+ will do its best to
-adjust the returned values to match the logical size of the window
-excluding the widgets added for client side decorations, but there
-is no garantee that the result will be totally accurate because
-these widgets depend on the theme and may not be realized or
-visible at the time gtk_window_get_size() is invoked.
-
-In any case, if you insist on application-specified window
-positioning, there’s still a better way than
-doing it yourself - gtk_window_set_position() will frequently
-handle the details for you.</doc>
+        <doc xml:space="preserve">Obtains the current size of @window.
+
+If @window is not visible on screen, this function return the size GTK+
+will suggest to the [window manager][gtk-X11-arch] for the initial window
+size (but this is not reliably the same as the size the window manager
+will actually select). See: gtk_window_set_default_size().
+
+Depending on the windowing system and the window manager constraints,
+the size returned by this function may not match the size set using
+gtk_window_resize(); additionally, since gtk_window_resize() may be
+implemented as an asynchronous operation, GTK+ cannot guarantee in any
+way that this code:
+
+|[&lt;!-- language="C" --&gt;
+  // width and height are set elsewhere
+  gtk_window_resize (window, width, height);
+
+  int new_width, new_height;
+  gtk_window_get_size (window, &amp;new_width, &amp;new_height);
+]|
+
+will result in `new_width` and `new_height` matching `width` and
+`height`, respectively.
+
+This function will return the logical size of the #GtkWindow,
+excluding the widgets used in client side decorations; there is,
+however, no guarantee that the result will be completely accurate
+because client side decoration may include widgets that depend on
+the user preferences and that may not be visibile at the time you
+call this function.
+
+The dimensions returned by this function are suitable for being
+stored across sessions; use gtk_window_set_default_size() to
+restore them when before showing the window.
+
+To avoid potential race conditions, you should only call this
+function in response to a size change notification, for instance
+inside a handler for the #GtkWidget::size-allocate signal, or
+inside a handler for the #GtkWidget::configure-event signal:
+
+|[&lt;!-- language="C" --&gt;
+static void
+on_size_allocate (GtkWidget *widget, GtkAllocation *allocation)
+{
+  int new_width, new_height;
+
+  gtk_window_get_size (GTK_WINDOW (widget), &amp;new_width, &amp;new_height);
+
+  ...
+}
+]|
+
+Note that, if you connect to the #GtkWidget::size-allocate signal,
+you should not use the dimensions of the #GtkAllocation passed to
+the signal handler, as the allocation may contain client side
+decorations added by GTK+, depending on the windowing system in
+use.
+
+If you are getting a window size in order to position the window
+on the screen, you should, instead, simply set the window’s semantic
+type with gtk_window_set_type_hint(), which allows the window manager
+to e.g. center dialogs. Also, if you set the transient parent of
+dialogs with gtk_window_set_transient_for() window managers will
+often center the dialog over its parent window. It's much preferred
+to let the window manager handle these cases rather than doing it
+yourself, because all apps will behave consistently and according to
+user or system preferences, if the window manager handles it. Also,
+the window manager can take into account the size of the window
+decorations and border that it may add, and of which GTK+ has no
+knowledge. Additionally, positioning windows in global screen coordinates
+may not be allowed by the windowing system. For more information,
+see: gtk_window_set_position().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -146168,8 +147542,7 @@ handle the details for you.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="full"
-                     optional="1"
-                     allow-none="1">
+                     nullable="1">
             <doc xml:space="preserve">return location for width, or %NULL</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
@@ -146177,8 +147550,7 @@ handle the details for you.</doc>
                      direction="out"
                      caller-allocates="0"
                      transfer-ownership="full"
-                     optional="1"
-                     allow-none="1">
+                     nullable="1">
             <doc xml:space="preserve">return location for height, or %NULL</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
@@ -147272,7 +148644,8 @@ content and visibility anyway.</doc>
         <doc xml:space="preserve">Sets up the icon representing a #GtkWindow. This icon is used when
 the window is minimized (also known as iconified).  Some window
 managers or desktop environments may also place it in the window
-frame, or display it in other contexts.
+frame, or display it in other contexts. On others, the icon is not
+used at all, so your mileage may vary.
 
 The icon should be provided in whatever size it was naturally
 drawn; that is, don’t scale the image before passing it to
@@ -147332,7 +148705,8 @@ with a pixbuf created by loading the image from @filename.</doc>
         <doc xml:space="preserve">Sets up the icon representing a #GtkWindow. The icon is used when
 the window is minimized (also known as iconified).  Some window
 managers or desktop environments may also place it in the window
-frame, or display it in other contexts.
+frame, or display it in other contexts. On others, the icon is not
+used at all, so your mileage may vary.
 
 gtk_window_set_icon_list() allows you to pass in the same icon in
 several hand-drawn sizes. The list should contain the natural sizes
@@ -147372,8 +148746,9 @@ set the icon on transient windows.</doc>
       <method name="set_icon_name"
               c:identifier="gtk_window_set_icon_name"
               version="2.6">
-        <doc xml:space="preserve">Sets the icon for the window from a named themed icon. See
-the docs for #GtkIconTheme for more details.
+        <doc xml:space="preserve">Sets the icon for the window from a named themed icon.
+See the docs for #GtkIconTheme for more details.
+On some platforms, the window icon is not used at all.
 
 Note that this has nothing to do with the WM_ICON_NAME
 property which is mentioned in the ICCCM.</doc>
@@ -147833,7 +149208,10 @@ the users attention to the window. This function sets this hint.</doc>
           </parameter>
         </parameters>
       </method>
-      <method name="set_wmclass" c:identifier="gtk_window_set_wmclass">
+      <method name="set_wmclass"
+              c:identifier="gtk_window_set_wmclass"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Don’t use this function. It sets the X Window System “class” and
 “name” hints for a window.  According to the ICCCM, you should
 always set these to the same value for all windows in an
@@ -153499,6 +154877,35 @@ the gtk_show_uri() call. If timestamp is not known you can take
         </parameter>
       </parameters>
     </function>
+    <function name="show_uri_on_window"
+              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>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE on success, %FALSE on error</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="parent"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
+          <doc xml:space="preserve">parent window</doc>
+          <type name="Window" c:type="GtkWindow*"/>
+        </parameter>
+        <parameter name="uri" transfer-ownership="none">
+          <doc xml:space="preserve">the uri to show</doc>
+          <type name="utf8" c:type="const char*"/>
+        </parameter>
+        <parameter name="timestamp" transfer-ownership="none">
+          <doc xml:space="preserve">a timestamp to prevent focus stealing</doc>
+          <type name="guint32" c:type="guint32"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="stock_add"
               c:identifier="gtk_stock_add"
               deprecated="1"