[gtkmm] Gdk, Gtk: Regenerate docs.xml and .defs files

[Kjell Ahlstedt <kjellahl src gnome org>]

commit c250d666458c85c44a94f03c352b38b3e6623473
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Sat Jun 29 11:55:47 2019 +0200

    Gdk, Gtk: Regenerate docs.xml and .defs files

 gdk/src/gdk_docs.xml     |  18 ++++-
 gdk/src/gdk_methods.defs |   6 ++
 gdk/src/gdk_signals.defs |  10 +++
 gtk/src/gtk_docs.xml     | 172 +++++++++++++++++++++++++++++++----------------
 gtk/src/gtk_enums.defs   |   4 +-
 gtk/src/gtk_methods.defs | 123 ++++++++++++++++++++++++++++-----
 gtk/src/gtk_signals.defs |  12 +++-
 7 files changed, 267 insertions(+), 78 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 6b30a233..92750c56 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -4593,7 +4593,7 @@ Prints the given @formats into a string for human consumption.
 This is meant for debugging and logging.
 
 The form of the representation may change at any time and is
-not guranteed to stay identical.
+not guaranteed to stay identical.
 
 </description>
 <parameters>
@@ -9975,6 +9975,22 @@ in the given format.
 </return>
 </function>
 
+<function name="gdk_monitor_get_connector">
+<description>
+Gets the name of the monitor's connector, if available.
+
+
+</description>
+<parameters>
+<parameter name="monitor">
+<parameter_description> a #GdkMonitor
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name of the connector
+</return>
+</function>
+
 <function name="gdk_monitor_get_display">
 <description>
 Gets the display that this monitor belongs to.
diff --git a/gdk/src/gdk_methods.defs b/gdk/src/gdk_methods.defs
index 4fc132cf..d51afc59 100644
--- a/gdk/src/gdk_methods.defs
+++ b/gdk/src/gdk_methods.defs
@@ -3414,6 +3414,12 @@
   (return-type "const-char*")
 )
 
+(define-method get_connector
+  (of-object "GdkMonitor")
+  (c-name "gdk_monitor_get_connector")
+  (return-type "const-char*")
+)
+
 (define-method get_scale_factor
   (of-object "GdkMonitor")
   (c-name "gdk_monitor_get_scale_factor")
diff --git a/gdk/src/gdk_signals.defs b/gdk/src/gdk_signals.defs
index a5f1a60e..cd709637 100644
--- a/gdk/src/gdk_signals.defs
+++ b/gdk/src/gdk_signals.defs
@@ -685,6 +685,16 @@
   (default-value "")
 )
 
+(define-property connector
+  (of-object "GdkMonitor")
+  (prop-type "GParamString")
+  (docs "The connector name")
+  (readable #t)
+  (writable #f)
+  (construct-only #f)
+  (default-value "")
+)
+
 (define-property scale-factor
   (of-object "GdkMonitor")
   (prop-type "GParamInt")
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index dca356ad..0de8e956 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -11326,7 +11326,7 @@ Set this to %NULL to make the group always visible.
 The maximum number of lines to allow per column. This property can
 be used to influence how the groups in this section are distributed
 across pages and columns. The default value of 15 should work in
-for most cases.
+most cases.
 
 </description>
 </property>
@@ -20377,38 +20377,6 @@ the expected token otherwise
 </return>
 </function>
 
-<function name="gtk_binding_entry_add_signall">
-<description>
-Override or install a new key binding for @keyval with @modifiers on
-@binding_set.
-
-</description>
-<parameters>
-<parameter name="binding_set">
-<parameter_description>  a #GtkBindingSet to add a signal to
-</parameter_description>
-</parameter>
-<parameter name="keyval">
-<parameter_description>       key value
-</parameter_description>
-</parameter>
-<parameter name="modifiers">
-<parameter_description>    key modifier
-</parameter_description>
-</parameter>
-<parameter name="signal_name">
-<parameter_description>  signal name to be bound
-</parameter_description>
-</parameter>
-<parameter name="binding_args">
-<parameter_description>
-list of #GtkBindingArg signal arguments
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_binding_entry_remove">
 <description>
 Remove a binding previously installed via
@@ -32091,7 +32059,7 @@ Returns the #GtkWidget this controller relates to.
 
 <function name="gtk_event_controller_handle_event">
 <description>
-Feeds an events into @controller, so it can be interpreted
+Feeds an event into @controller, so it can be interpreted
 and the controller actions triggered.
 
 
@@ -52972,18 +52940,6 @@ widget coordinates.
 </return>
 </function>
 
-<function name="gtk_popover_get_popovers">
-<description>
-Returns the list of all existing #GtkPopover widgets.
-
-
-</description>
-<parameters>
-</parameters>
-<return> The list of existing popovers.
-</return>
-</function>
-
 <function name="gtk_popover_get_position">
 <description>
 Returns the preferred position of @popover.
@@ -82040,6 +81996,29 @@ the functions from #GtkScaleButton.
 </return>
 </function>
 
+<function name="gtk_widget_action_set_enabled">
+<description>
+Enable or disable an action installed with
+gtk_widget_class_install_action().
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> action name, such as &quot;clipboard.paste&quot;
+</parameter_description>
+</parameter>
+<parameter name="enabled">
+<parameter_description> whether the action is now enabled
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_activate">
 <description>
 For widgets that can be “activated” (buttons, menu items, etc.)
@@ -82064,11 +82043,43 @@ activatable, the function returns %FALSE.
 Looks up the action in the action groups associated
 with @widget and its ancestors, and activates it.
 
-The action name is expected to be prefixed with the
-prefix that was used when adding the action group
-with gtk_widget_insert_action_group().
+This is a wrapper around gtk_widget_activate_action_variant()
+that constructs the @args variant according to @format_string.
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the action to activate
+</parameter_description>
+</parameter>
+<parameter name="format_string">
+<parameter_description> GVariant format string for arguments or %NULL
+for no arguments
+</parameter_description>
+</parameter>
+<parameter name="Varargs">
+<parameter_description> arguments, as given by format string
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_widget_activate_action_variant">
+<description>
+Looks up the action in the action groups associated
+with @widget and its ancestors, and activates it.
+
+If the action is in an action group added with
+gtk_widget_insert_action_group(), the @name is
+expected to be prefixed with the prefix that was
+used when the group was inserted.
 
-The @parameter must match the actions expected parameter
+The arguments must match the actions expected parameter
 type, as returned by g_action_get_parameter_type().
 
 </description>
@@ -82078,11 +82089,11 @@ type, as returned by g_action_get_parameter_type().
 </parameter_description>
 </parameter>
 <parameter name="name">
-<parameter_description> a prefixed action name
+<parameter_description> the name of the action to activate
 </parameter_description>
 </parameter>
-<parameter name="parameter">
-<parameter_description> parameters that required by the action
+<parameter name="args">
+<parameter_description> parameters to use, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
@@ -82615,6 +82626,49 @@ See also: gtk_widget_class_set_layout_manager_type()
 </return>
 </function>
 
+<function name="gtk_widget_class_query_action">
+<description>
+Queries the actions that have been installed for
+a widget class using gtk_widget_class_install_action()
+during class initialization.
+
+Note that this function will also return actions defined
+by parent classes. You can identify those by looking
+at @owner.
+
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> a #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="index_">
+<parameter_description> position of the action to query
+</parameter_description>
+</parameter>
+<parameter name="owner">
+<parameter_description> the type where the action was defined
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> return location for the action name
+</parameter_description>
+</parameter>
+<parameter name="parameter_type">
+<parameter_description> return location for the parameter type
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> return location for the property name
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the action was found,
+%FALSE if @index_ is out of range
+</return>
+</function>
+
 <function name="gtk_widget_class_set_accessible_role">
 <description>
 Sets the default #AtkRole to be set on accessibles created for
@@ -84580,11 +84634,15 @@ gdk_surface_input_shape_combine_region() for more information.
 <description>
 Inserts @group into @widget. Children of @widget that implement
 #GtkActionable can then be associated with actions in @group by
-setting their “action-name” to
-@prefix.`action-name`.
+setting their “action-name” to @prefix.`action-name`.
+
+Note that inheritance is defined for individual actions. I.e.
+even if you insert a group with prefix @prefix, actions with
+the same prefix will still be inherited from the parent, unless
+the group contains an action with the same name.
 
-If @group is %NULL, a previously inserted group for @name is removed
-from @widget.
+If @group is %NULL, a previously inserted group for @name is
+removed from @widget.
 
 </description>
 <parameters>
diff --git a/gtk/src/gtk_enums.defs b/gtk/src/gtk_enums.defs
index 90541d08..ce9f8b91 100644
--- a/gtk/src/gtk_enums.defs
+++ b/gtk/src/gtk_enums.defs
@@ -2453,7 +2453,8 @@
 ;; typedef enum
 ;; {
 ;;   GTK_CSS_PARSER_WARNING_DEPRECATED,
-;;   GTK_CSS_PARSER_WARNING_SYNTAX
+;;   GTK_CSS_PARSER_WARNING_SYNTAX,
+;;   GTK_CSS_PARSER_WARNING_UNIMPLEMENTED
 ;; } GtkCssParserWarning;
 
 (define-enum-extended CssParserWarning
@@ -2462,6 +2463,7 @@
   (values
     '("deprecated" "GTK_CSS_PARSER_WARNING_DEPRECATED" "0")
     '("syntax" "GTK_CSS_PARSER_WARNING_SYNTAX" "1")
+    '("unimplemented" "GTK_CSS_PARSER_WARNING_UNIMPLEMENTED" "2")
   )
 )
 
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index 7192bf78..afd3fdc8 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -1939,10 +1939,44 @@
   (values
     '("deprecated" "GTK_CSS_PARSER_WARNING_DEPRECATED")
     '("syntax" "GTK_CSS_PARSER_WARNING_SYNTAX")
+    '("unimplemented" "GTK_CSS_PARSER_WARNING_UNIMPLEMENTED")
   )
 )
 
 
+;; From gsettings-mapping.h
+
+(define-function g_settings_set_mapping
+  (c-name "g_settings_set_mapping")
+  (return-type "GVariant*")
+  (parameters
+    '("const-GValue*" "value")
+    '("const-GVariantType*" "expected_type")
+    '("gpointer" "user_data")
+  )
+)
+
+(define-function g_settings_get_mapping
+  (c-name "g_settings_get_mapping")
+  (return-type "gboolean")
+  (parameters
+    '("GValue*" "value")
+    '("GVariant*" "variant")
+    '("gpointer" "user_data")
+  )
+)
+
+(define-function g_settings_mapping_is_compatible
+  (c-name "g_settings_mapping_is_compatible")
+  (return-type "gboolean")
+  (parameters
+    '("GType" "gvalue_type")
+    '("const-GVariantType*" "variant_type")
+  )
+)
+
+
+
 ;; From gskpango.h
 
 (define-function gsk_pango_renderer_get_type
@@ -3790,18 +3824,6 @@
   (varargs #t)
 )
 
-(define-function gtk_binding_entry_add_signall
-  (c-name "gtk_binding_entry_add_signall")
-  (return-type "none")
-  (parameters
-    '("GtkBindingSet*" "binding_set")
-    '("guint" "keyval")
-    '("GdkModifierType" "modifiers")
-    '("const-gchar*" "signal_name")
-    '("GSList*" "binding_args")
-  )
-)
-
 (define-function gtk_binding_entry_add_signal_from_string
   (c-name "gtk_binding_entry_add_signal_from_string")
   (return-type "GTokenType")
@@ -8442,6 +8464,21 @@
   )
 )
 
+(define-method get_name
+  (of-object "GtkEventController")
+  (c-name "gtk_event_controller_get_name")
+  (return-type "const-char*")
+)
+
+(define-method set_name
+  (of-object "GtkEventController")
+  (c-name "gtk_event_controller_set_name")
+  (return-type "none")
+  (parameters
+    '("const-char*" "name")
+  )
+)
+
 
 
 ;; From gtkeventcontrollerkey.h
@@ -17109,11 +17146,6 @@
   )
 )
 
-(define-function gtk_popover_get_popovers
-  (c-name "gtk_popover_get_popovers")
-  (return-type "GListModel*")
-)
-
 
 
 ;; From gtkpopovermenubar.h
@@ -30202,7 +30234,18 @@
   (return-type "none")
   (parameters
     '("const-char*" "name")
-    '("GVariant*" "parameter")
+    '("const-char*" "format_string")
+  )
+  (varargs #t)
+)
+
+(define-method activate_action_variant
+  (of-object "GtkWidget")
+  (c-name "gtk_widget_activate_action_variant")
+  (return-type "none")
+  (parameters
+    '("const-char*" "name")
+    '("GVariant*" "args")
   )
 )
 
@@ -30314,6 +30357,50 @@
   (return-type "gboolean")
 )
 
+(define-method install_action
+  (of-object "GtkWidgetClass")
+  (c-name "gtk_widget_class_install_action")
+  (return-type "none")
+  (parameters
+    '("const-char*" "action_name")
+    '("const-char*" "parameter_type")
+    '("GtkWidgetActionActivateFunc" "activate")
+  )
+)
+
+(define-method install_property_action
+  (of-object "GtkWidgetClass")
+  (c-name "gtk_widget_class_install_property_action")
+  (return-type "none")
+  (parameters
+    '("const-char*" "action_name")
+    '("const-char*" "property_name")
+  )
+)
+
+(define-method query_action
+  (of-object "GtkWidgetClass")
+  (c-name "gtk_widget_class_query_action")
+  (return-type "gboolean")
+  (parameters
+    '("guint" "index_")
+    '("GType*" "owner")
+    '("const-char**" "action_name")
+    '("const-GVariantType**" "parameter_type")
+    '("const-char**" "property_name")
+  )
+)
+
+(define-method action_set_enabled
+  (of-object "GtkWidget")
+  (c-name "gtk_widget_action_set_enabled")
+  (return-type "none")
+  (parameters
+    '("const-char*" "action_name")
+    '("gboolean" "enabled")
+  )
+)
+
 
 
 ;; From gtkwidgetpaintable.h
diff --git a/gtk/src/gtk_signals.defs b/gtk/src/gtk_signals.defs
index cec8099b..35d58a1b 100644
--- a/gtk/src/gtk_signals.defs
+++ b/gtk/src/gtk_signals.defs
@@ -3385,6 +3385,16 @@
   (default-value "GTK_LIMIT_SAME_NATIVE")
 )
 
+(define-property name
+  (of-object "GtkEventController")
+  (prop-type "GParamString")
+  (docs "Name for this controller")
+  (readable #t)
+  (writable #t)
+  (construct-only #f)
+  (default-value "")
+)
+
 ;; From GtkEventControllerKey
 
 (define-signal key-pressed
@@ -12918,7 +12928,7 @@
   (readable #t)
   (writable #t)
   (construct-only #f)
-  (default-value "TRUE")
+  (default-value "FALSE")
 )
 
 (define-property focus-visible