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

From: Andreas Persson <andreasp src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtkmm] Gdk, Gtk: Regenerate docs.xml and .defs files
Date: Wed, 16 Dec 2020 20:03:07 +0000 (UTC)
commit 16ac90e99a1b634a9d08ee6c24bc7f6e4c2c8788
Author: Andreas Persson <andreasp56 outlook com>
Date:   Wed Dec 16 20:59:07 2020 +0100

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

 gdk/src/gdk_docs.xml     |  37 +++-
 gdk/src/gdk_methods.defs |   6 +
 gtk/src/gtk_docs.xml     | 444 +++++++++++++++++++++++++++++++++++++++++------
 gtk/src/gtk_methods.defs |  12 +-
 4 files changed, 428 insertions(+), 71 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index f618e517..a2b895e2 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -14646,6 +14646,21 @@ regions on their own.
 <return></return>
 </function>
 
+<function name="gdk_surface_request_layout">
+<description>
+Request a %GDK_FRAME_CLOCK_PHASE_LAYOUT from the surface's
+frame clock. See gdk_frame_clock_request_phase().
+
+</description>
+<parameters>
+<parameter name="surface">
+<parameter_description> a #GdkSurface
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_surface_set_cursor">
 <description>
 Sets the default mouse pointer for a #GdkSurface.
@@ -15163,8 +15178,9 @@ otherwise %FALSE.
 
 <function name="gdk_toplevel_layout_get_fullscreen">
 <description>
-Returns whether the layout should cause the surface
-to be fullscreen when presented.
+If the layout specifies whether to the toplevel should go fullscreen,
+the value pointed to by @fullscreen is set to %TRUE if it should go
+fullscreen, or %FALSE, if it should go unfullscreen.
 
 
 </description>
@@ -15173,8 +15189,12 @@ to be fullscreen when presented.
 <parameter_description> a #GdkToplevelLayout
 </parameter_description>
 </parameter>
+<parameter name="fullscreen">
+<parameter_description> location to store whether the toplevel should be fullscreen
+</parameter_description>
+</parameter>
 </parameters>
-<return> %TRUE if @layout is fullscreen
+<return> whether the @layout specifies the fullscreen state for the toplevel
 </return>
 </function>
 
@@ -15197,8 +15217,9 @@ the surface on.
 
 <function name="gdk_toplevel_layout_get_maximized">
 <description>
-Returns whether the layout should present the
-surface as maximized.
+If the layout specifies whether to the toplevel should go maximized,
+the value pointed to by @maximized is set to %TRUE if it should go
+fullscreen, or %FALSE, if it should go unmaximized.
 
 
 </description>
@@ -15207,8 +15228,12 @@ surface as maximized.
 <parameter_description> a #GdkToplevelLayout
 </parameter_description>
 </parameter>
+<parameter name="maximized">
+<parameter_description> set to %TRUE if the toplevel should be maximized
+</parameter_description>
+</parameter>
 </parameters>
-<return> %TRUE if the layout is maximized
+<return> whether the @layout specifies the maximized state for the toplevel
 </return>
 </function>
 
diff --git a/gdk/src/gdk_methods.defs b/gdk/src/gdk_methods.defs
index 0efb24a6..f7de7f51 100644
--- a/gdk/src/gdk_methods.defs
+++ b/gdk/src/gdk_methods.defs
@@ -4041,12 +4041,18 @@
   (of-object "GdkToplevelLayout")
   (c-name "gdk_toplevel_layout_get_maximized")
   (return-type "gboolean")
+  (parameters
+    '("gboolean*" "maximize")
+  )
 )
 
 (define-method get_fullscreen
   (of-object "GdkToplevelLayout")
   (c-name "gdk_toplevel_layout_get_fullscreen")
   (return-type "gboolean")
+  (parameters
+    '("gboolean*" "fullscreen")
+  )
 )
 
 (define-method get_fullscreen_monitor
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index e32caac9..9c70aef6 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -4831,6 +4831,22 @@ Emoji.
 <return></return>
 </signal>
 
+<signal name="GtkEntry::activate">
+<description>
+The ::activate signal is forwarded from the
+#GtkText::activated signal, which is a keybinding
+signal for all forms of the Enter key.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> The widget on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkEntry::icon-press">
 <description>
 The ::icon-press signal is emitted when an activatable icon
@@ -4890,15 +4906,6 @@ A list of tabstops to apply to the text of the entry.
 <return></return>
 </signal>
 
-<property name="GtkEntry:activate">
-<description>
-The ::activate signal is forwarded from the
-#GtkText::activated signal, which is a keybinding
-signal for all forms of the Enter key.
-
-</description>
-</property>
-
 <property name="GtkEntry:attributes">
 <description>
 A list of Pango attributes to apply to the text of the entry.
@@ -5414,6 +5421,13 @@ Specifies the side of the entry at which an icon is placed.
 </parameters>
 </enum>
 
+<property name="GtkEventController:name">
+<description>
+The name for this controller, typically used for debugging purposes.
+
+</description>
+</property>
+
 <property name="GtkEventController:propagation-limit">
 <description>
 The limit for which events this controller will handle.
@@ -5847,6 +5861,20 @@ Describes the state of a #GdkEventSequence in a #GtkGesture.
 </parameters>
 </enum>
 
+<signal name="GtkExpander::activate">
+<description>
+Activates the #GtkExpander.
+
+</description>
+<parameters>
+<parameter name="expander">
+<parameter_description> the #GtkExpander that emitted the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <property name="GtkExpander:resize-toplevel">
 <description>
 When this property is %TRUE, the expander will resize the toplevel
@@ -7275,6 +7303,94 @@ Whether the gesture handles only touch events.
 </description>
 </property>
 
+<signal name="GtkGestureStylus::down">
+<description>
+A signal emitted when the stylus touches the device.
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the #GtkGestureStylus that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the X coordinate of the stylus event
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the Y coordinate of the stylus event
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureStylus::motion">
+<description>
+A signal emitted when the stylus moves while touching the device.
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the #GtkGestureStylus that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the X coordinate of the stylus event
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the Y coordinate of the stylus event
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureStylus::proximity">
+<description>
+A signal emitted when the stylus is in proximity of the device.
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the #GtkGestureStylus that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the X coordinate of the stylus event
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the Y coordinate of the stylus event
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkGestureStylus::up">
+<description>
+A signal emitted when the stylus no longer touches the device.
+
+</description>
+<parameters>
+<parameter name="gesture">
+<parameter_description> the #GtkGestureStylus that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the X coordinate of the stylus event
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the Y coordinate of the stylus event
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkGestureSwipe::swipe">
 <description>
 This signal is emitted when the recognized gesture is finished, velocity
@@ -9621,6 +9737,23 @@ Group name for tab drag and drop.
 </description>
 </property>
 
+<enum name="GtkNotebookTab">
+<description>
+The parameter used in the action signals of #GtkNotebook.
+
+</description>
+<parameters>
+<parameter name="GTK_NOTEBOOK_TAB_FIRST">
+<parameter_description> the first tab in the notebook
+</parameter_description>
+</parameter>
+<parameter name="GTK_NOTEBOOK_TAB_LAST">
+<parameter_description> the last tab in the notebook
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
 <enum name="GtkNumberUpLayout">
 <description>
 Used to determine the layout of pages on a sheet when printing
@@ -12015,6 +12148,22 @@ Whether to show the close button in the search bar.
 </description>
 </property>
 
+<signal name="GtkSearchEntry::activate">
+<description>
+The ::activate signal is forwarded from the
+#GtkText::activated signal, which is a keybinding
+signal for all forms of the Enter key.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> The widget on which the signal is emitted
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkSearchEntry::next-match">
 <description>
 The ::next-match signal is a [keybinding signal][GtkSignalAction]
@@ -12107,15 +12256,6 @@ The default bindings for this signal is Escape.
 <return></return>
 </signal>
 
-<property name="GtkSearchEntry:activate">
-<description>
-The ::activate signal is forwarded from the
-#GtkText::activated signal, which is a keybinding
-signal for all forms of the Enter key.
-
-</description>
-</property>
-
 <property name="GtkSelectionFilterModel:model">
 <description>
 The model being filtered
@@ -15964,6 +16104,20 @@ Extra indentation for each level.
 </description>
 </property>
 
+<signal name="GtkTreeViewColumn::clicked">
+<description>
+Emitted when the column's header has been clicked.
+
+</description>
+<parameters>
+<parameter name="column">
+<parameter_description> the #GtkTreeViewColumn that emitted the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <property name="GtkTreeViewColumn:cell-area">
 <description>
 The #GtkCellArea used to layout cell renderers for this column.
@@ -16238,6 +16392,7 @@ is %FALSE, or just makes @widget grab focus if @group_cycling is %TRUE.
 
 <signal name="GtkWidget::move-focus">
 <description>
+Emitted when the focus is moved.
 
 </description>
 <parameters>
@@ -16246,7 +16401,7 @@ is %FALSE, or just makes @widget grab focus if @group_cycling is %TRUE.
 </parameter_description>
 </parameter>
 <parameter name="direction">
-<parameter_description>
+<parameter_description> the direction of the focus move
 </parameter_description>
 </parameter>
 </parameters>
@@ -25996,6 +26151,38 @@ Fills in @width and @height with the appropriate size of @cell.
 <return></return>
 </function>
 
+<function name="gtk_cell_renderer_get_is_expanded">
+<description>
+Checks whether the given #GtkCellRenderer is expanded.
+
+
+</description>
+<parameters>
+<parameter name="cell">
+<parameter_description> a #GtkCellRenderer
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the cell renderer is expanded
+</return>
+</function>
+
+<function name="gtk_cell_renderer_get_is_expander">
+<description>
+Checks whether the given #GtkCellRenderer is an expander.
+
+
+</description>
+<parameters>
+<parameter name="cell">
+<parameter_description> a #GtkCellRenderer
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @cell is an expander, and %FALSE otherwise
+</return>
+</function>
+
 <function name="gtk_cell_renderer_get_padding">
 <description>
 Fills in @xpad and @ypad with the appropriate values of @cell.
@@ -26324,6 +26511,42 @@ Sets the renderer size to be explicit, independent of the properties set.
 <return></return>
 </function>
 
+<function name="gtk_cell_renderer_set_is_expanded">
+<description>
+Sets whether the given #GtkCellRenderer is expanded.
+
+</description>
+<parameters>
+<parameter name="cell">
+<parameter_description> a #GtkCellRenderer
+</parameter_description>
+</parameter>
+<parameter name="is_expanded">
+<parameter_description> whether @cell should be expanded
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_cell_renderer_set_is_expander">
+<description>
+Sets whether the given #GtkCellRenderer is an expander.
+
+</description>
+<parameters>
+<parameter name="cell">
+<parameter_description> a #GtkCellRenderer
+</parameter_description>
+</parameter>
+<parameter name="is_expander">
+<parameter_description> whether @cell is an expander
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_cell_renderer_set_padding">
 <description>
 Sets the renderer’s padding.
@@ -35576,33 +35799,6 @@ Returns the #GtkWidget this controller relates to.
 </return>
 </function>
 
-<function name="gtk_event_controller_handle_crossing">
-<description>
-Feeds a crossing event into @controller, so it can be interpreted
-and the controller actions triggered.
-
-</description>
-<parameters>
-<parameter name="controller">
-<parameter_description> a #GtkEventController
-</parameter_description>
-</parameter>
-<parameter name="crossing">
-<parameter_description> a #GtkCrossingData
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> translated event coordinates
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> translated event coordinates
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_event_controller_key_forward">
 <description>
 Forwards the current event of this @controller to a @widget.
@@ -40214,16 +40410,17 @@ signals.
 </parameter_description>
 </parameter>
 </parameters>
-<return> #TRUE if there is a current value for the axes
+<return> %TRUE if there is a current value for the axes
 </return>
 </function>
 
 <function name="gtk_gesture_stylus_get_axis">
 <description>
-Returns the current value for the requested @axis. This function
-must be called from either the #GtkGestureStylus::down,
-#GtkGestureStylus::motion, #GtkGestureStylus::up or #GtkGestureStylus::proximity
-signals.
+Returns the current value for the requested @axis.
+
+This function must be called from the handler of one of the
+#GtkGestureStylus::down, #GtkGestureStylus::motion,
+#GtkGestureStylus::up or #GtkGestureStylus::proximity signals.
 
 
 </description>
@@ -40241,7 +40438,7 @@ signals.
 </parameter_description>
 </parameter>
 </parameters>
-<return> #TRUE if there is a current value for the axis
+<return> %TRUE if there is a current value for the axis
 </return>
 </function>
 
@@ -40257,7 +40454,7 @@ signal handler, the state given in this signal and obtainable through
 gtk_gesture_stylus_get_axis() call express the latest (most up-to-date)
 state in motion history.
 
-@backlog is provided in chronological order.
+The @backlog is provided in chronological order.
 
 
 </description>
@@ -40275,7 +40472,7 @@ state in motion history.
 </parameter_description>
 </parameter>
 </parameters>
-<return> #TRUE if there is a backlog to unfold in the current state.
+<return> %TRUE if there is a backlog to unfold in the current state.
 </return>
 </function>
 
@@ -51306,6 +51503,34 @@ from @self's surface coordinates into @self's widget coordinates.
 <return></return>
 </function>
 
+<function name="gtk_native_realize">
+<description>
+Realizes a #GtkNative.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNative
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_unrealize">
+<description>
+Unrealizes a #GtkNative.
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNative
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_never_trigger_get">
 <description>
 Gets the never trigger. This is a singleton for a trigger
@@ -55342,6 +55567,20 @@ the popover without a transition, use gtk_widget_show().
 <return></return>
 </function>
 
+<function name="gtk_popover_present">
+<description>
+Presents the popover to the user.
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_popover_set_autohide">
 <description>
 Sets whether @popover is modal.
@@ -68261,6 +68500,22 @@ the new message is being used in
 </return>
 </function>
 
+<function name="gtk_statusbar_get_message">
+<description>
+Retrieves the contents of the label in #GtkStatusbar.
+
+
+</description>
+<parameters>
+<parameter name="statusbar">
+<parameter_description> a #GtkStatusbar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the contents of the statusbar
+</return>
+</function>
+
 <function name="gtk_statusbar_new">
 <description>
 Creates a new #GtkStatusbar ready for messages.
@@ -69490,6 +69745,87 @@ a specific value.
 </return>
 </function>
 
+<function name="gtk_test_accessible_has_property">
+<description>
+Checks whether the #GtkAccessible has @property set.
+
+
+</description>
+<parameters>
+<parameter name="accessible">
+<parameter_description> a #GtkAccessible
+</parameter_description>
+</parameter>
+<parameter name="property">
+<parameter_description> a #GtkAccessibleProperty
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @property is set in the @accessible
+</return>
+</function>
+
+<function name="gtk_test_accessible_has_relation">
+<description>
+Checks whether the #GtkAccessible has @relation set.
+
+
+</description>
+<parameters>
+<parameter name="accessible">
+<parameter_description> a #GtkAccessible
+</parameter_description>
+</parameter>
+<parameter name="relation">
+<parameter_description> a #GtkAccessibleRelation
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @relation is set in the @accessible
+</return>
+</function>
+
+<function name="gtk_test_accessible_has_role">
+<description>
+Checks whether the #GtkAccessible:accessible-role of the accessible
+is @role.
+
+
+</description>
+<parameters>
+<parameter name="accessible">
+<parameter_description> a #GtkAccessible
+</parameter_description>
+</parameter>
+<parameter name="role">
+<parameter_description> a #GtkAccessibleRole
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the role matches
+</return>
+</function>
+
+<function name="gtk_test_accessible_has_state">
+<description>
+Checks whether the #GtkAccessible has @state set.
+
+
+</description>
+<parameters>
+<parameter name="accessible">
+<parameter_description> a #GtkAccessible
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> a #GtkAccessibleState
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @state is set in the @accessible
+</return>
+</function>
+
 <function name="gtk_test_init">
 <description>
 This function is used to initialize a GTK test program.
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index 1af5b7b2..a1388fa1 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -5885,7 +5885,7 @@
   (c-name "gtk_cell_renderer_set_is_expanded")
   (return-type "none")
   (parameters
-    '("gboolean" "is_expander")
+    '("gboolean" "is_expanded")
   )
 )
 
@@ -9507,11 +9507,6 @@
 
 ;; From gtkeventcontroller.h
 
-(define-function gtk_crossing_data_get_type
-  (c-name "gtk_crossing_data_get_type")
-  (return-type "GType")
-)
-
 (define-function gtk_event_controller_get_type
   (c-name "gtk_event_controller_get_type")
   (return-type "GType")
@@ -24297,11 +24292,6 @@
   (return-type "GtkTextAttributes*")
 )
 
-(define-function gtk_text_attributes_get_type
-  (c-name "gtk_text_attributes_get_type")
-  (return-type "GType")
-)
-
 
 
 ;; From gtktextbtree.h
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]