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

From: Kjell Ahlstedt <kjellahl src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtkmm] Gtk: Regenerate docs.xml and .defs files
Date: Sun, 3 Nov 2019 18:15:58 +0000 (UTC)
commit 35b03cc2b7ac6586b6f167f41c78794a3311d91f
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Sun Nov 3 19:11:50 2019 +0100

    Gtk: Regenerate docs.xml and .defs files
    
    and update gtk_vfuncs.defs.
    
    * tools/extra_defs_gen/generate_defs_gtk.cc: Add GTK_TYPE_NO_SELECTION.

 gtk/src/gtk_docs.xml                      | 231 ++++++++++++++++++++----------
 gtk/src/gtk_methods.defs                  |  95 ++++++++----
 gtk/src/gtk_signals.defs                  |  19 ++-
 gtk/src/gtk_vfuncs.defs                   |   2 +-
 tools/extra_defs_gen/generate_defs_gtk.cc |   1 +
 5 files changed, 245 insertions(+), 103 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index b4ef9526..6749643a 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -8441,6 +8441,13 @@ Whether the window is currenlty visible.
 </description>
 </property>
 
+<property name="GtkNoSelection:model">
+<description>
+The model being managed
+
+</description>
+</property>
+
 <signal name="GtkNotebook::create-window">
 <description>
 The ::create-window signal is emitted when a detachable
@@ -20557,6 +20564,76 @@ Creates a new #GtkBinLayout instance.
 </return>
 </function>
 
+<function name="gtk_binding_entry_add_action">
+<description>
+Override or install a new key binding for @keyval with @modifiers on
+@binding_set. When the binding is activated, @action_name will be
+activated on the target widget, with arguments read according to
+@format_string.
+
+</description>
+<parameters>
+<parameter name="binding_set">
+<parameter_description> a #GtkBindingSet to install an entry for
+</parameter_description>
+</parameter>
+<parameter name="keyval">
+<parameter_description>      key value of binding to install
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description>   key modifier of binding to install
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> signal to execute upon activation
+</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_binding_entry_add_action_variant">
+<description>
+Override or install a new key binding for @keyval with @modifiers on
+@binding_set. When the binding is activated, @action_name will be
+activated on the target widget, with @args used as arguments.
+
+</description>
+<parameters>
+<parameter name="binding_set">
+<parameter_description> a #GtkBindingSet to install an entry for
+</parameter_description>
+</parameter>
+<parameter name="keyval">
+<parameter_description>      key value of binding to install
+</parameter_description>
+</parameter>
+<parameter name="modifiers">
+<parameter_description>   key modifier of binding to install
+</parameter_description>
+</parameter>
+<parameter name="action_name">
+<parameter_description> signal to execute upon activation
+</parameter_description>
+</parameter>
+<parameter name="args">
+<parameter_description>        #GVariant of the arguments or %NULL if none
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_binding_entry_add_signal">
 <description>
 Override or install a new key binding for @keyval with @modifiers on
@@ -32758,6 +32835,7 @@ You only want to call this on some special entries
 which the user usually doesn't want to replace all text in,
 such as search-as-you-type entries.
 
+
 </description>
 <parameters>
 <parameter name="entry">
@@ -32765,7 +32843,8 @@ such as search-as-you-type entries.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if focus is now inside @self
+</return>
 </function>
 
 <function name="gtk_entry_new">
@@ -41239,26 +41318,6 @@ to the icon.
 </return>
 </function>
 
-<function name="gtk_icon_info_new_for_pixbuf">
-<description>
-Creates a #GtkIconInfo for a #GdkPixbuf.
-
-
-</description>
-<parameters>
-<parameter name="icon_theme">
-<parameter_description> a #GtkIconTheme
-</parameter_description>
-</parameter>
-<parameter name="pixbuf">
-<parameter_description> the pixbuf to wrap in a #GtkIconInfo
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GtkIconInfo
-</return>
-</function>
-
 <function name="gtk_icon_theme_add_resource_path">
 <description>
 Adds a resource path that will be looked at when looking
@@ -41404,25 +41463,6 @@ is open. Do not ref or unref it.
 </return>
 </function>
 
-<function name="gtk_icon_theme_get_example_icon_name">
-<description>
-Gets the name of an icon that is representative of the
-current theme (for instance, to use when presenting
-a list of themes to the user.)
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #GtkIconTheme
-</parameter_description>
-</parameter>
-</parameters>
-<return> the name of an example icon or %NULL.
-Free with g_free().
-</return>
-</function>
-
 <function name="gtk_icon_theme_get_for_display">
 <description>
 Gets the icon theme object associated with @display; if this
@@ -41521,27 +41561,6 @@ icon for @icon_name.
 </return>
 </function>
 
-<function name="gtk_icon_theme_list_contexts">
-<description>
-Gets the list of contexts available within the current
-hierarchy of icon themes.
-See gtk_icon_theme_list_icons() for details about contexts.
-
-
-</description>
-<parameters>
-<parameter name="self">
-<parameter_description> a #GtkIconTheme
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GList list
-holding the names of all the contexts in the theme. You must first
-free each element in the list with g_free(), then free the list
-itself with g_list_free().
-</return>
-</function>
-
 <function name="gtk_icon_theme_list_icons">
 <description>
 Lists the icons in the current icon theme. Only a subset
@@ -41552,7 +41571,6 @@ but will typically include such values as “Applications” and
 [Icon Theme Specification](http://www.freedesktop.org/wiki/Specifications/icon-theme-spec).
 The standard contexts are listed in the
 [Icon Naming Specification](http://www.freedesktop.org/wiki/Specifications/icon-naming-spec).
-Also see gtk_icon_theme_list_contexts().
 
 
 </description>
@@ -51206,6 +51224,38 @@ Returns the surface of this #GtkNative.
 </return>
 </function>
 
+<function name="gtk_no_selection_get_model">
+<description>
+Gets the model that @self is wrapping.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNoSelection
+</parameter_description>
+</parameter>
+</parameters>
+<return> The model being wrapped
+</return>
+</function>
+
+<function name="gtk_no_selection_new">
+<description>
+Creates a new selection to handle @model.
+
+
+</description>
+<parameters>
+<parameter name="model">
+<parameter_description> the #GListModel to manage
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkNoSelection
+</return>
+</function>
+
 <function name="gtk_notebook_append_page">
 <description>
 Appends a page to @notebook.
@@ -59285,7 +59335,7 @@ GtkRadioButton *last_button;
 
 while (some_condition)
 {
-radio_button = gtk_radio_button_new (NULL);
+radio_button = GTK_RADIO_BUTTON (gtk_radio_button_new (NULL));
 
 gtk_radio_button_join_group (radio_button, last_button);
 last_button = radio_button;
@@ -64355,6 +64405,22 @@ unselecting the selected item.
 </return>
 </function>
 
+<function name="gtk_single_selection_get_model">
+<description>
+Gets the model that @self is wrapping.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkSingleSelection
+</parameter_description>
+</parameter>
+</parameters>
+<return> The model being wrapped
+</return>
+</function>
+
 <function name="gtk_single_selection_get_selected">
 <description>
 Gets the position of the selected item. If no item is selected,
@@ -66947,7 +67013,7 @@ See gtk_stack_sidebar_set_stack().
 
 </description>
 <parameters>
-<parameter name="sidebar">
+<parameter name="self">
 <parameter_description> a #GtkStackSidebar
 </parameter_description>
 </parameter>
@@ -66978,7 +67044,7 @@ The sidebar widget will automatically update according to the order
 
 </description>
 <parameters>
-<parameter name="sidebar">
+<parameter name="self">
 <parameter_description> a #GtkStackSidebar
 </parameter_description>
 </parameter>
@@ -70162,6 +70228,7 @@ You only want to call this on some special entries
 which the user usually doesn't want to replace all text in,
 such as search-as-you-type entries.
 
+
 </description>
 <parameters>
 <parameter name="self">
@@ -70169,7 +70236,8 @@ such as search-as-you-type entries.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if focus is now inside @self
+</return>
 </function>
 
 <function name="gtk_text_iter_assign">
@@ -72844,7 +72912,7 @@ widget is usually one of the dialog buttons.
 <function name="gtk_text_set_attributes">
 <description>
 Sets a #PangoAttrList; the attributes in the list are applied to the
-self text.
+text.
 
 </description>
 <parameters>
@@ -72853,7 +72921,7 @@ self text.
 </parameter_description>
 </parameter>
 <parameter name="attrs">
-<parameter_description> a #PangoAttrList
+<parameter_description> a #PangoAttrList or %NULL to unset
 </parameter_description>
 </parameter>
 </parameters>
@@ -74995,8 +75063,9 @@ mnemonic character
 <description>
 Sets the status of the toggle button. Set to %TRUE if you want the
 GtkToggleButton to be “pressed in”, and %FALSE to raise it.
-This action causes the #GtkToggleButton::toggled signal and the
-#GtkButton::clicked signal to be emitted.
+
+If the status of the button changes, this action causes the
+#GtkToggleButton::toggled signal to be emitted.
 
 </description>
 <parameters>
@@ -83625,6 +83694,7 @@ with @widget and its ancestors, and activates it.
 This is a wrapper around gtk_widget_activate_action_variant()
 that constructs the @args variant according to @format_string.
 
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -83645,7 +83715,9 @@ for no arguments
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if the action was activated, %FALSE if the action does
+not exist.
+</return>
 </function>
 
 <function name="gtk_widget_activate_action_variant">
@@ -83661,6 +83733,7 @@ used when the group was inserted.
 The arguments must match the actions expected parameter
 type, as returned by g_action_get_parameter_type().
 
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -83676,7 +83749,9 @@ type, as returned by g_action_get_parameter_type().
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if the action was activated, %FALSE if the action does
+not exist.
+</return>
 </function>
 
 <function name="gtk_widget_activate_default">
@@ -86066,8 +86141,13 @@ events, see gtk_widget_contains().
 Causes @widget (or one of its descendents) to have the keyboard focus
 for the #GtkWindow it's inside.
 
-@widget must be focusable, or have a ::grab_focus implementation that
-transfers the focus to a descendant of @widget that is focusable.
+If @widget is not focusable, or its ::grab_focus implementation cannot
+transfer the focus to a descendant of @widget that is focusable, it will
+not take focus and %FALSE will be returned.
+
+Calling gtk_widget_grab_focus() on an already focused widget is allowed,
+should not have an effect, and return %TRUE.
+
 
 </description>
 <parameters>
@@ -86076,7 +86156,8 @@ transfers the focus to a descendant of @widget that is focusable.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if focus is now inside @widget.
+</return>
 </function>
 
 <function name="gtk_widget_has_default">
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index ab80250c..0bacf53a 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -3943,6 +3943,45 @@
   )
 )
 
+(define-function gtk_binding_entry_add_action_variant
+  (c-name "gtk_binding_entry_add_action_variant")
+  (return-type "none")
+  (parameters
+    '("GtkBindingSet*" "binding_set")
+    '("guint" "keyval")
+    '("GdkModifierType" "modifiers")
+    '("const-char*" "action_name")
+    '("GVariant*" "args")
+  )
+)
+
+(define-function gtk_binding_entry_add_action
+  (c-name "gtk_binding_entry_add_action")
+  (return-type "none")
+  (parameters
+    '("GtkBindingSet*" "binding_set")
+    '("guint" "keyval")
+    '("GdkModifierType" "modifiers")
+    '("const-char*" "action_name")
+    '("const-char*" "format_string")
+  )
+  (varargs #t)
+)
+
+(define-function gtk_binding_entry_add_callback
+  (c-name "gtk_binding_entry_add_callback")
+  (return-type "none")
+  (parameters
+    '("GtkBindingSet*" "binding_set")
+    '("guint" "keyval")
+    '("GdkModifierType" "modifiers")
+    '("GtkBindingCallback" "callback")
+    '("GVariant*" "args")
+    '("gpointer" "user_data")
+    '("GDestroyNotify" "user_destroy")
+  )
+)
+
 (define-function gtk_binding_entry_remove
   (c-name "gtk_binding_entry_remove")
   (return-type "none")
@@ -8937,7 +8976,7 @@
 (define-method grab_focus_without_selecting
   (of-object "GtkEntry")
   (c-name "gtk_entry_grab_focus_without_selecting")
-  (return-type "none")
+  (return-type "gboolean")
 )
 
 (define-method set_extra_menu
@@ -12170,18 +12209,6 @@
   )
 )
 
-(define-method list_contexts
-  (of-object "GtkIconTheme")
-  (c-name "gtk_icon_theme_list_contexts")
-  (return-type "GList*")
-)
-
-(define-method get_example_icon_name
-  (of-object "GtkIconTheme")
-  (c-name "gtk_icon_theme_get_example_icon_name")
-  (return-type "char*")
-)
-
 (define-method rescan_if_needed
   (of-object "GtkIconTheme")
   (c-name "gtk_icon_theme_rescan_if_needed")
@@ -12193,15 +12220,6 @@
   (return-type "GType")
 )
 
-(define-function gtk_icon_info_new_for_pixbuf
-  (c-name "gtk_icon_info_new_for_pixbuf")
-  (return-type "GtkIconInfo*")
-  (parameters
-    '("GtkIconTheme*" "icon_theme")
-    '("GdkPixbuf*" "pixbuf")
-  )
-)
-
 (define-method get_base_size
   (of-object "GtkIconInfo")
   (c-name "gtk_icon_info_get_base_size")
@@ -16281,6 +16299,25 @@
 
 
 
+;; From gtknoselection.h
+
+(define-function gtk_no_selection_new
+  (c-name "gtk_no_selection_new")
+  (is-constructor-of "GtkNoSelection")
+  (return-type "GtkNoSelection*")
+  (parameters
+    '("GListModel*" "model")
+  )
+)
+
+(define-method get_model
+  (of-object "GtkNoSelection")
+  (c-name "gtk_no_selection_get_model")
+  (return-type "GListModel*")
+)
+
+
+
 ;; From gtknotebook.h
 
 (define-function gtk_notebook_get_type
@@ -22106,6 +22143,12 @@
   )
 )
 
+(define-method get_model
+  (of-object "GtkSingleSelection")
+  (c-name "gtk_single_selection_get_model")
+  (return-type "GListModel*")
+)
+
 (define-method get_selected
   (of-object "GtkSingleSelection")
   (c-name "gtk_single_selection_get_selected")
@@ -24585,7 +24628,7 @@
 (define-method grab_focus_without_selecting
   (of-object "GtkText")
   (c-name "gtk_text_grab_focus_without_selecting")
-  (return-type "none")
+  (return-type "gboolean")
 )
 
 (define-method set_extra_menu
@@ -29830,7 +29873,7 @@
 (define-method grab_focus
   (of-object "GtkWidget")
   (c-name "gtk_widget_grab_focus")
-  (return-type "none")
+  (return-type "gboolean")
 )
 
 (define-method set_focus_on_click
@@ -30840,7 +30883,7 @@
 (define-method activate_action
   (of-object "GtkWidget")
   (c-name "gtk_widget_activate_action")
-  (return-type "none")
+  (return-type "gboolean")
   (parameters
     '("const-char*" "name")
     '("const-char*" "format_string")
@@ -30851,7 +30894,7 @@
 (define-method activate_action_variant
   (of-object "GtkWidget")
   (c-name "gtk_widget_activate_action_variant")
-  (return-type "none")
+  (return-type "gboolean")
   (parameters
     '("const-char*" "name")
     '("GVariant*" "args")
diff --git a/gtk/src/gtk_signals.defs b/gtk/src/gtk_signals.defs
index b6111018..37f4286a 100644
--- a/gtk/src/gtk_signals.defs
+++ b/gtk/src/gtk_signals.defs
@@ -6551,6 +6551,12 @@
 
 ;; From GtkModelButton
 
+(define-signal clicked
+  (of-object "GtkModelButton")
+  (return-type "void")
+  (flags "Run First, Action")
+)
+
 (define-property role
   (of-object "GtkModelButton")
   (prop-type "GParamEnum")
@@ -6698,6 +6704,17 @@
   (construct-only #f)
 )
 
+;; From GtkNoSelection
+
+(define-property model
+  (of-object "GtkNoSelection")
+  (prop-type "GParamObject")
+  (docs "The model being managed")
+  (readable #t)
+  (writable #t)
+  (construct-only #t)
+)
+
 ;; From GtkNotebook
 
 (define-signal switch-page
@@ -9413,7 +9430,7 @@
   (docs "The model being managed")
   (readable #t)
   (writable #t)
-  (construct-only #f)
+  (construct-only #t)
 )
 
 ;; From GtkSizeGroup
diff --git a/gtk/src/gtk_vfuncs.defs b/gtk/src/gtk_vfuncs.defs
index c8837a37..d16ed5ee 100644
--- a/gtk/src/gtk_vfuncs.defs
+++ b/gtk/src/gtk_vfuncs.defs
@@ -867,7 +867,7 @@
 
 (define-vfunc grab_focus
   (of-object "GtkWidget")
-  (return-type "void")
+  (return-type "gboolean")
 )
 
 (define-vfunc get_accessible
diff --git a/tools/extra_defs_gen/generate_defs_gtk.cc b/tools/extra_defs_gen/generate_defs_gtk.cc
index 82cf2658..f2a64e01 100644
--- a/tools/extra_defs_gen/generate_defs_gtk.cc
+++ b/tools/extra_defs_gen/generate_defs_gtk.cc
@@ -153,6 +153,7 @@ int main(int /* argc */, char** /* argv */)
             << get_defs( GTK_TYPE_MESSAGE_DIALOG )
             << get_defs( GTK_TYPE_MODEL_BUTTON )
             << get_defs( GTK_TYPE_NATIVE_DIALOG )
+            << get_defs( GTK_TYPE_NO_SELECTION )
             << get_defs( GTK_TYPE_NOTEBOOK )
             << get_defs( GTK_TYPE_NOTEBOOK_PAGE )
             << get_defs( GTK_TYPE_ORIENTABLE )
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]