GNOME.org
 

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


commit 29aa36267b3f80a03482c64f361868198bae5339
Author: Andreas Persson <andreasp56 outlook com>
Date:   Sat Aug 15 07:37:08 2020 +0200

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

 gdk/src/gdk_docs.xml     | 291 +++++------------------------------------------
 gdk/src/gdk_enums.defs   |  56 +++++++++
 gdk/src/gdk_methods.defs | 132 ++++++++++++++-------
 gdk/src/gdk_signals.defs |  32 +++++-
 gtk/src/gtk_docs.xml     |  49 +++++++-
 gtk/src/gtk_methods.defs |  22 +++-
 gtk/src/gtk_signals.defs |   2 +-
 7 files changed, 272 insertions(+), 312 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 6ef59875..585859a8 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -744,7 +744,7 @@ The #GdkDisplay used to create the #GdkDrawContext.
 
 <property name="GdkDrawContext:surface">
 <description>
-The #GdkSurface the gl context is bound to.
+The #GdkSurface the context is bound to.
 
 </description>
 </property>
@@ -1140,42 +1140,6 @@ Error enumeration for #GdkGLContext.
 </parameters>
 </enum>
 
-<enum name="GdkGrabStatus">
-<description>
-Returned by gdk_device_grab() to indicate success or the reason for the
-failure of the grab attempt.
-
-</description>
-<parameters>
-<parameter name="GDK_GRAB_SUCCESS">
-<parameter_description> the resource was successfully grabbed.
-</parameter_description>
-</parameter>
-<parameter name="GDK_GRAB_ALREADY_GRABBED">
-<parameter_description> the resource is actively grabbed by another client.
-</parameter_description>
-</parameter>
-<parameter name="GDK_GRAB_INVALID_TIME">
-<parameter_description> the resource was grabbed more recently than the
-specified time.
-</parameter_description>
-</parameter>
-<parameter name="GDK_GRAB_NOT_VIEWABLE">
-<parameter_description> the grab surface or the @confine_to surface are not
-viewable.
-</parameter_description>
-</parameter>
-<parameter name="GDK_GRAB_FROZEN">
-<parameter_description> the resource is frozen by an active grab of another client.
-</parameter_description>
-</parameter>
-<parameter name="GDK_GRAB_FAILED">
-<parameter_description> the grab failed for some other reason
-</parameter_description>
-</parameter>
-</parameters>
-</enum>
-
 <enum name="GdkGravity">
 <description>
 Defines the reference point of a surface and is used in #GdkPopupLayout.
@@ -1992,6 +1956,22 @@ which must be repeated.
 </parameters>
 </enum>
 
+<signal name="GdkPopup::popup-layout-changed">
+<description>
+Emitted when the layout of a popup surface has changed, e.g. if the popup
+layout was reactive and after the parent moved causing the popover to end
+up partially off-screen.
+
+</description>
+<parameters>
+<parameter name="popup">
+<parameter_description> the #GdkSurface that was laid out
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <enum name="GdkScrollDirection">
 <description>
 Specifies the direction for scroll events.
@@ -2240,23 +2220,6 @@ Emitted when @surface stops being present on the monitor.
 <return></return>
 </signal>
 
-<signal name="GdkSurface::popup-layout-changed">
-<description>
-Emitted when the layout of a popup @surface has changed, e.g. if the popup
-layout was reactive and after the parent moved causing the popover to end
-up partially off-screen.
-
-
-</description>
-<parameters>
-<parameter name="surface">
-<parameter_description> the #GdkSurface that was laid out
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</signal>
-
 <signal name="GdkSurface::render">
 <description>
 Emitted when part of the surface needs to be redrawn.
@@ -2466,12 +2429,7 @@ also be emitted at any other point in time, in response to the windowing
 system spontaneously changing the configuration.
 
 It is the responsibility of the GdkToplevel user to handle this signal;
-failing to do so will result in an arbitrary fixed size being used as a
-result. The signal may be emitted with the pointer to the @size being
-%NULL, in which case only the minimum and maximum size needs to be
-computed. This could happen for example if the toplevel configuration is in
-a state where the size is decided by the windowing system, such as
-maximized or fullscreen.
+failing to do so will result in an arbitrary size being used as a result.
 
 </description>
 <parameters>
@@ -4990,35 +4948,6 @@ this one cannot be supported
 </return>
 </function>
 
-<function name="gdk_device_get_axis">
-<description>
-Interprets an array of double as axis values for a given device,
-and locates the value in the array for a given axis use.
-
-
-</description>
-<parameters>
-<parameter name="device">
-<parameter_description> a #GdkDevice
-</parameter_description>
-</parameter>
-<parameter name="axes">
-<parameter_description> pointer to an array of axes
-</parameter_description>
-</parameter>
-<parameter name="use">
-<parameter_description> the use to look for
-</parameter_description>
-</parameter>
-<parameter name="value">
-<parameter_description> location to store the found value.
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if the given axis use was found, otherwise %FALSE
-</return>
-</function>
-
 <function name="gdk_device_get_axis_use">
 <description>
 Returns the axis use for @index_.
@@ -5114,7 +5043,8 @@ by GTK+, and must not be freed or unreffed.
 <function name="gdk_device_get_has_cursor">
 <description>
 Determines whether the pointer follows device motion.
-This is not meaningful for keyboard devices, which don't have a pointer.
+This is not meaningful for keyboard devices, which
+don't have a pointer.
 
 
 </description>
@@ -5145,25 +5075,10 @@ if @device is a keyboard device.
 </return>
 </function>
 
-<function name="gdk_device_get_n_axes">
-<description>
-Returns the number of axes the device currently has.
-
-
-</description>
-<parameters>
-<parameter name="device">
-<parameter_description> a pointer #GdkDevice
-</parameter_description>
-</parameter>
-</parameters>
-<return> the number of axes.
-</return>
-</function>
-
 <function name="gdk_device_get_name">
 <description>
-Determines the name of the device.
+Determines the name of the device, suitable
+for showing in a user interface.
 
 
 </description>
@@ -5257,8 +5172,7 @@ Returns the #GdkSeat the device belongs to.
 </parameter_description>
 </parameter>
 </parameters>
-<return> A #GdkSeat. This memory is owned by GTK+ and
-must not be freed.
+<return> a #GdkSeat
 </return>
 </function>
 
@@ -5367,24 +5281,6 @@ left-to-right languages are in use on the keyboard, if
 </return>
 </function>
 
-<function name="gdk_device_list_physical_devices">
-<description>
-Returns the list of physical devices attached to the given logical
-#GdkDevice.
-
-
-</description>
-<parameters>
-<parameter name="device">
-<parameter_description> a logical #GdkDevice
-</parameter_description>
-</parameter>
-</parameters>
-<return>
-the list of physical devices attached to a logical #GdkDevice
-</return>
-</function>
-
 <function name="gdk_device_pad_get_feature_group">
 <description>
 Returns the group the given @feature and @idx belong to,
@@ -14302,7 +14198,7 @@ Returns the devices that match the given capabilities.
 </parameters>
 <return> A list of #GdkDevices.
 The list must be freed with g_list_free(), the elements are owned
-by GDK and must not be freed.
+by GTK and must not be freed.
 </return>
 </function>
 
@@ -14325,7 +14221,7 @@ and must not be freed.
 
 <function name="gdk_seat_get_keyboard">
 <description>
-Returns the logical device that routes keyboard events.
+Returns the device that routes keyboard events.
 
 
 </description>
@@ -14335,14 +14231,14 @@ Returns the logical device that routes keyboard events.
 </parameter_description>
 </parameter>
 </parameters>
-<return> a logical #GdkDevice with keyboard
+<return> a #GdkDevice with keyboard
 capabilities. This object is owned by GTK and must not be freed.
 </return>
 </function>
 
 <function name="gdk_seat_get_pointer">
 <description>
-Returns the logical device that routes pointer events.
+Returns the device that routes pointer events.
 
 
 </description>
@@ -14352,7 +14248,7 @@ Returns the logical device that routes pointer events.
 </parameter_description>
 </parameter>
 </parameters>
-<return> a logical #GdkDevice with pointer
+<return> a #GdkDevice with pointer
 capabilities. This object is owned by GTK and must not be freed.
 </return>
 </function>
@@ -14370,103 +14266,11 @@ application.
 </parameter_description>
 </parameter>
 </parameters>
-<return> A list of tools. Free with
-g_list_free().
-</return>
-</function>
-
-<function name="gdk_seat_grab">
-<description>
-Grabs the seat so that all events corresponding to the given @capabilities
-are passed to this application until the seat is ungrabbed with gdk_seat_ungrab(),
-or the surface becomes hidden. This overrides any previous grab on the
-seat by this client.
-
-As a rule of thumb, if a grab is desired over %GDK_SEAT_CAPABILITY_POINTER,
-all other &quot;pointing&quot; capabilities (eg. %GDK_SEAT_CAPABILITY_TOUCH) should
-be grabbed too, so the user is able to interact with all of those while
-the grab holds, you should thus use %GDK_SEAT_CAPABILITY_ALL_POINTING most
-commonly.
-
-Grabs are used for operations which need complete control over the
-events corresponding to the given capabilities. For example in GTK this
-is used for Drag and Drop operations, popup menus and such.
-
-Note that if the event mask of a #GdkSurface has selected both button press
-and button release events, or touch begin and touch end, then a press event
-will cause an automatic grab until the button is released, equivalent to a
-grab on the surface with @owner_events set to %TRUE. This is done because most
-applications expect to receive paired press and release events.
-
-If you set up anything at the time you take the grab that needs to be
-cleaned up when the grab ends, you should handle the #GdkEventGrabBroken
-events that are emitted when the grab ends unvoluntarily.
-
-
-</description>
-<parameters>
-<parameter name="seat">
-<parameter_description> a #GdkSeat
-</parameter_description>
-</parameter>
-<parameter name="surface">
-<parameter_description> the #GdkSurface which will own the grab
-</parameter_description>
-</parameter>
-<parameter name="capabilities">
-<parameter_description> capabilities that will be grabbed
-</parameter_description>
-</parameter>
-<parameter name="owner_events">
-<parameter_description> if %FALSE then all device events are reported with respect to
-@surface and are only reported if selected by @event_mask. If
-%TRUE then pointer events for this application are reported
-as normal, but pointer events outside this application are
-reported with respect to @surface and only if selected by
-@event_mask. In either mode, unreported events are discarded.
-</parameter_description>
-</parameter>
-<parameter name="cursor">
-<parameter_description> the cursor to display while the grab is active. If
-this is %NULL then the normal cursors are used for
-@surface and its descendants, and the cursor for @surface is used
-elsewhere.
-</parameter_description>
-</parameter>
-<parameter name="event">
-<parameter_description> the event that is triggering the grab, or %NULL if none
-is available.
-</parameter_description>
-</parameter>
-<parameter name="prepare_func">
-<parameter_description> function to
-prepare the surface to be grabbed, it can be %NULL if @surface is
-visible before this call.
-</parameter_description>
-</parameter>
-<parameter name="prepare_func_data">
-<parameter_description> user data to pass to @prepare_func
-</parameter_description>
-</parameter>
-</parameters>
-<return> %GDK_GRAB_SUCCESS if the grab was successful.
+<return>
+A list of tools. Free with g_list_free().
 </return>
 </function>
 
-<function name="gdk_seat_ungrab">
-<description>
-Releases a grab added through gdk_seat_grab().
-
-</description>
-<parameters>
-<parameter name="seat">
-<parameter_description> a #GdkSeat
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gdk_set_allowed_backends">
 <description>
 Sets a list of backends that GDK should try to use.
@@ -14523,41 +14327,6 @@ the display just as gdk_display_beep().
 <return></return>
 </function>
 
-<function name="gdk_surface_constrain_size">
-<description>
-Constrains a desired width and height according to a
-set of geometry hints (such as minimum and maximum size).
-
-</description>
-<parameters>
-<parameter name="geometry">
-<parameter_description> a #GdkGeometry structure
-</parameter_description>
-</parameter>
-<parameter name="flags">
-<parameter_description> a mask indicating what portions of @geometry are set
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> desired width of surface
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> desired height of the surface
-</parameter_description>
-</parameter>
-<parameter name="new_width">
-<parameter_description> location to store resulting width
-</parameter_description>
-</parameter>
-<parameter name="new_height">
-<parameter_description> location to store resulting height
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gdk_surface_create_cairo_context">
 <description>
 Creates a new #GdkCairoContext for rendering on @surface.
diff --git a/gdk/src/gdk_enums.defs b/gdk/src/gdk_enums.defs
index b78415c2..30798d90 100644
--- a/gdk/src/gdk_enums.defs
+++ b/gdk/src/gdk_enums.defs
@@ -1,3 +1,59 @@
+;; From gdkdebug.h
+
+;; Original typedef:
+;; typedef enum {
+;;   GDK_DEBUG_MISC            = 1 <<  0,
+;;   GDK_DEBUG_EVENTS          = 1 <<  1,
+;;   GDK_DEBUG_DND             = 1 <<  2,
+;;   GDK_DEBUG_INPUT           = 1 <<  3,
+;;   GDK_DEBUG_EVENTLOOP       = 1 <<  4,
+;;   GDK_DEBUG_FRAMES          = 1 <<  5,
+;;   GDK_DEBUG_SETTINGS        = 1 <<  6,
+;;   GDK_DEBUG_OPENGL          = 1 <<  7,
+;;   GDK_DEBUG_VULKAN          = 1 <<  8,
+;;   GDK_DEBUG_SELECTION       = 1 <<  9,
+;;   GDK_DEBUG_CLIPBOARD       = 1 << 10,
+;;   /* flags below are influencing behavior */
+;;   GDK_DEBUG_NOGRABS         = 1 << 11,
+;;   GDK_DEBUG_GL_DISABLE      = 1 << 12,
+;;   GDK_DEBUG_GL_SOFTWARE     = 1 << 13,
+;;   GDK_DEBUG_GL_TEXTURE_RECT = 1 << 14,
+;;   GDK_DEBUG_GL_LEGACY       = 1 << 15,
+;;   GDK_DEBUG_GL_GLES         = 1 << 16,
+;;   GDK_DEBUG_GL_DEBUG        = 1 << 17,
+;;   GDK_DEBUG_VULKAN_DISABLE  = 1 << 18,
+;;   GDK_DEBUG_VULKAN_VALIDATE = 1 << 19,
+;;   GDK_DEBUG_DEFAULT_SETTINGS= 1 << 20
+;; } GdkDebugFlags;
+
+(define-flags-extended DebugFlags
+  (in-module "Gdk")
+  (c-name "GdkDebugFlags")
+  (values
+    '("misc" "GDK_DEBUG_MISC" "1 << 0")
+    '("events" "GDK_DEBUG_EVENTS" "1 << 1")
+    '("dnd" "GDK_DEBUG_DND" "1 << 2")
+    '("input" "GDK_DEBUG_INPUT" "1 << 3")
+    '("eventloop" "GDK_DEBUG_EVENTLOOP" "1 << 4")
+    '("frames" "GDK_DEBUG_FRAMES" "1 << 5")
+    '("settings" "GDK_DEBUG_SETTINGS" "1 << 6")
+    '("opengl" "GDK_DEBUG_OPENGL" "1 << 7")
+    '("vulkan" "GDK_DEBUG_VULKAN" "1 << 8")
+    '("selection" "GDK_DEBUG_SELECTION" "1 << 9")
+    '("clipboard" "GDK_DEBUG_CLIPBOARD" "1 << 10")
+    '("nograbs" "GDK_DEBUG_NOGRABS" "1 << 11")
+    '("gl-disable" "GDK_DEBUG_GL_DISABLE" "1 << 12")
+    '("gl-software" "GDK_DEBUG_GL_SOFTWARE" "1 << 13")
+    '("gl-texture-rect" "GDK_DEBUG_GL_TEXTURE_RECT" "1 << 14")
+    '("gl-legacy" "GDK_DEBUG_GL_LEGACY" "1 << 15")
+    '("gl-gles" "GDK_DEBUG_GL_GLES" "1 << 16")
+    '("gl-debug" "GDK_DEBUG_GL_DEBUG" "1 << 17")
+    '("vulkan-disable" "GDK_DEBUG_VULKAN_DISABLE" "1 << 18")
+    '("vulkan-validate" "GDK_DEBUG_VULKAN_VALIDATE" "1 << 19")
+    '("default-settings=" "GDK_DEBUG_DEFAULT_SETTINGS=" "1 << 20")
+  )
+)
+
 ;; From gdkdevice.h
 
 ;; Original typedef:
diff --git a/gdk/src/gdk_methods.defs b/gdk/src/gdk_methods.defs
index 5ec9bc68..edbd0f26 100644
--- a/gdk/src/gdk_methods.defs
+++ b/gdk/src/gdk_methods.defs
@@ -9,6 +9,35 @@
 
 ;; Enumerations and flags ...
 
+(define-flags DebugFlags
+  (in-module "Gdk")
+  (c-name "GdkDebugFlags")
+  (gtype-id "GDK_TYPE_DEBUG_FLAGS")
+  (values
+    '("misc" "GDK_DEBUG_MISC")
+    '("events" "GDK_DEBUG_EVENTS")
+    '("dnd" "GDK_DEBUG_DND")
+    '("input" "GDK_DEBUG_INPUT")
+    '("eventloop" "GDK_DEBUG_EVENTLOOP")
+    '("frames" "GDK_DEBUG_FRAMES")
+    '("settings" "GDK_DEBUG_SETTINGS")
+    '("opengl" "GDK_DEBUG_OPENGL")
+    '("vulkan" "GDK_DEBUG_VULKAN")
+    '("selection" "GDK_DEBUG_SELECTION")
+    '("clipboard" "GDK_DEBUG_CLIPBOARD")
+    '("nograbs" "GDK_DEBUG_NOGRABS")
+    '("gl-disable" "GDK_DEBUG_GL_DISABLE")
+    '("gl-software" "GDK_DEBUG_GL_SOFTWARE")
+    '("gl-texture-rect" "GDK_DEBUG_GL_TEXTURE_RECT")
+    '("gl-legacy" "GDK_DEBUG_GL_LEGACY")
+    '("gl-gles" "GDK_DEBUG_GL_GLES")
+    '("gl-debug" "GDK_DEBUG_GL_DEBUG")
+    '("vulkan-disable" "GDK_DEBUG_VULKAN_DISABLE")
+    '("vulkan-validate" "GDK_DEBUG_VULKAN_VALIDATE")
+    '("default-settings=" "GDK_DEBUG_DEFAULT_SETTINGS=")
+  )
+)
+
 (define-enum InputSource
   (in-module "Gdk")
   (c-name "GdkInputSource")
@@ -1388,6 +1417,25 @@
 
 
 
+;; From gdkdebug.h
+
+(define-method get_debug_flags
+  (of-object "GdkDisplay")
+  (c-name "gdk_display_get_debug_flags")
+  (return-type "GdkDebugFlags")
+)
+
+(define-method set_debug_flags
+  (of-object "GdkDisplay")
+  (c-name "gdk_display_set_debug_flags")
+  (return-type "none")
+  (parameters
+    '("GdkDebugFlags" "flags")
+  )
+)
+
+
+
 ;; From gdkdevice.h
 
 (define-function gdk_device_get_type
@@ -1401,34 +1449,6 @@
   (return-type "const-char*")
 )
 
-(define-method get_has_cursor
-  (of-object "GdkDevice")
-  (c-name "gdk_device_get_has_cursor")
-  (return-type "gboolean")
-)
-
-(define-method get_source
-  (of-object "GdkDevice")
-  (c-name "gdk_device_get_source")
-  (return-type "GdkInputSource")
-)
-
-(define-method get_surface_at_position
-  (of-object "GdkDevice")
-  (c-name "gdk_device_get_surface_at_position")
-  (return-type "GdkSurface*")
-  (parameters
-    '("double*" "win_x")
-    '("double*" "win_y")
-  )
-)
-
-(define-method get_display
-  (of-object "GdkDevice")
-  (c-name "gdk_device_get_display")
-  (return-type "GdkDisplay*")
-)
-
 (define-method get_vendor_id
   (of-object "GdkDevice")
   (c-name "gdk_device_get_vendor_id")
@@ -1441,16 +1461,16 @@
   (return-type "const-char*")
 )
 
-(define-method get_seat
+(define-method get_display
   (of-object "GdkDevice")
-  (c-name "gdk_device_get_seat")
-  (return-type "GdkSeat*")
+  (c-name "gdk_device_get_display")
+  (return-type "GdkDisplay*")
 )
 
-(define-method get_num_touches
+(define-method get_seat
   (of-object "GdkDevice")
-  (c-name "gdk_device_get_num_touches")
-  (return-type "guint")
+  (c-name "gdk_device_get_seat")
+  (return-type "GdkSeat*")
 )
 
 (define-method get_device_tool
@@ -1459,22 +1479,22 @@
   (return-type "GdkDeviceTool*")
 )
 
-(define-method get_caps_lock_state
+(define-method get_source
   (of-object "GdkDevice")
-  (c-name "gdk_device_get_caps_lock_state")
-  (return-type "gboolean")
+  (c-name "gdk_device_get_source")
+  (return-type "GdkInputSource")
 )
 
-(define-method get_num_lock_state
+(define-method get_has_cursor
   (of-object "GdkDevice")
-  (c-name "gdk_device_get_num_lock_state")
+  (c-name "gdk_device_get_has_cursor")
   (return-type "gboolean")
 )
 
-(define-method get_scroll_lock_state
+(define-method get_num_touches
   (of-object "GdkDevice")
-  (c-name "gdk_device_get_scroll_lock_state")
-  (return-type "gboolean")
+  (c-name "gdk_device_get_num_touches")
+  (return-type "guint")
 )
 
 (define-method get_modifier_state
@@ -1495,6 +1515,34 @@
   (return-type "gboolean")
 )
 
+(define-method get_caps_lock_state
+  (of-object "GdkDevice")
+  (c-name "gdk_device_get_caps_lock_state")
+  (return-type "gboolean")
+)
+
+(define-method get_num_lock_state
+  (of-object "GdkDevice")
+  (c-name "gdk_device_get_num_lock_state")
+  (return-type "gboolean")
+)
+
+(define-method get_scroll_lock_state
+  (of-object "GdkDevice")
+  (c-name "gdk_device_get_scroll_lock_state")
+  (return-type "gboolean")
+)
+
+(define-method get_surface_at_position
+  (of-object "GdkDevice")
+  (c-name "gdk_device_get_surface_at_position")
+  (return-type "GdkSurface*")
+  (parameters
+    '("double*" "win_x")
+    '("double*" "win_y")
+  )
+)
+
 
 
 ;; From gdkdevicepad.h
diff --git a/gdk/src/gdk_signals.defs b/gdk/src/gdk_signals.defs
index 992f4d2e..34f08d76 100644
--- a/gdk/src/gdk_signals.defs
+++ b/gdk/src/gdk_signals.defs
@@ -909,6 +909,12 @@
 
 ;; From GdkPopup
 
+(define-signal popup-layout-changed
+  (of-object "GdkPopup")
+  (return-type "void")
+  (flags "Run First")
+)
+
 (define-property autohide
   (of-object "GdkPopup")
   (prop-type "GParamBoolean")
@@ -977,12 +983,6 @@
 
 ;; From GdkSurface
 
-(define-signal popup-layout-changed
-  (of-object "GdkSurface")
-  (return-type "void")
-  (flags "Run First")
-)
-
 (define-signal size-changed
   (of-object "GdkSurface")
   (return-type "void")
@@ -1066,6 +1066,26 @@
   (default-value "FALSE")
 )
 
+(define-property width
+  (of-object "GdkSurface")
+  (prop-type "GParamInt")
+  (docs "Width")
+  (readable #t)
+  (writable #f)
+  (construct-only #f)
+  (default-value "0")
+)
+
+(define-property height
+  (of-object "GdkSurface")
+  (prop-type "GParamInt")
+  (docs "Height")
+  (readable #t)
+  (writable #f)
+  (construct-only #f)
+  (default-value "0")
+)
+
 ;; From GdkTexture
 
 (define-property width
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 7fbcec7f..d6faa7c1 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -15395,7 +15395,7 @@ to the padding from the theme.
 
 <property name="GtkTextView:monospace">
 <description>
-If %TRUE, set the %GTK_STYLE_CLASS_MONOSPACE style class on the
+If %TRUE, set the .monospace style class on the
 text view to indicate that a monospace font is desired.
 
 </description>
@@ -55221,6 +55221,28 @@ Gets the value of the #GtkPopover:mnemonics-visible property.
 </return>
 </function>
 
+<function name="gtk_popover_get_offset">
+<description>
+Gets the offset previous set with gtk_popover_set_offset().
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="x_offset">
+<parameter_description> a location for the x_offset
+</parameter_description>
+</parameter>
+<parameter name="y_offset">
+<parameter_description> a location for the y_offset
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_popover_get_pointing_to">
 <description>
 If a rectangle to point to has been set, this function will
@@ -55566,6 +55588,31 @@ Sets the #GtkPopover:mnemonics-visible property.
 <return></return>
 </function>
 
+<function name="gtk_popover_set_offset">
+<description>
+Sets the offset to use when calculating the position of the popover.
+
+These values are used when preparing the #GtkPopupLayout for positioning
+the popover.
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="x_offset">
+<parameter_description> the x offset to adjust the position by
+</parameter_description>
+</parameter>
+<parameter name="y_offset">
+<parameter_description> the y offset to adjust the position by
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_popover_set_pointing_to">
 <description>
 Sets the rectangle that @popover will point to, in the
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index e3aab53b..96829ed1 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -16334,7 +16334,7 @@
 
 (define-function gtk_native_get_for_surface
   (c-name "gtk_native_get_for_surface")
-  (return-type "GtkWidget*")
+  (return-type "GtkNative*")
   (parameters
     '("GdkSurface*" "surface")
   )
@@ -18039,6 +18039,26 @@
   (return-type "none")
 )
 
+(define-method set_offset
+  (of-object "GtkPopover")
+  (c-name "gtk_popover_set_offset")
+  (return-type "none")
+  (parameters
+    '("int" "x_offset")
+    '("int" "y_offset")
+  )
+)
+
+(define-method get_offset
+  (of-object "GtkPopover")
+  (c-name "gtk_popover_get_offset")
+  (return-type "none")
+  (parameters
+    '("int*" "x_offset")
+    '("int*" "y_offset")
+  )
+)
+
 (define-method set_default_widget
   (of-object "GtkPopover")
   (c-name "gtk_popover_set_default_widget")
diff --git a/gtk/src/gtk_signals.defs b/gtk/src/gtk_signals.defs
index 531950c7..bc559057 100644
--- a/gtk/src/gtk_signals.defs
+++ b/gtk/src/gtk_signals.defs
@@ -5332,7 +5332,7 @@
 (define-property column
   (of-object "GtkGridLayoutChild")
   (prop-type "GParamInt")
-  (docs "The column place the child in")
+  (docs "The column to place the child in")
   (readable #t)
   (writable #t)
   (construct-only #f)
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]