[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: Wed, 9 Oct 2019 13:26:33 +0000 (UTC)
commit 106b7841b94f644720c7c8a324f4a329d59eed95
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Wed Oct 9 15:23:07 2019 +0200

    Gtk: Regenerate docs.xml and .defs files

 gtk/src/gtk_docs.xml     | 235 ++++++++++++++++++++++++++---------------------
 gtk/src/gtk_enums.defs   |   4 +-
 gtk/src/gtk_methods.defs |  79 ++++++++++------
 gtk/src/gtk_signals.defs |   9 ++
 4 files changed, 193 insertions(+), 134 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 0ceedffb..b4ef9526 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -4120,8 +4120,9 @@ pointer buttons. See #GdkModifierType.
 
 <property name="GtkEventControllerKey:contains-focus">
 <description>
-Whether focus is in a descendant of the controllers widget.
-See #GtkEventControllerKey:is-focus.
+Whether focus is contain in the controllers widget. See
+See #GtkEventControllerKey:is-focus for whether the focus is in the widget itself
+or inside a descendent.
 
 When handling focus events, this property is updated
 before #GtkEventControllerKey::focus-in or
@@ -4133,7 +4134,7 @@ before #GtkEventControllerKey::focus-in or
 <property name="GtkEventControllerKey:is-focus">
 <description>
 Whether focus is in the controllers widget itself,
-as opposed to in a descendent widget. See
+opposed to in a descendent widget. See also
 #GtkEventControllerKey:contains-focus.
 
 When handling focus events, this property is updated
@@ -13951,6 +13952,14 @@ Don't confuse this property with #GtkWidget:margin-top.
 </description>
 </property>
 
+<property name="GtkTextViewChild:window-type">
+<description>
+The &quot;window-type&quot; property is the #GtkTextWindowType of the
+#GtkTextView that the child is attached.
+
+</description>
+</property>
+
 <enum name="GtkTextViewLayer">
 <description>
 Used to reference the layers of #GtkTextView for the purpose of customized
@@ -13975,10 +13984,6 @@ Used to reference the parts of #GtkTextView.
 
 </description>
 <parameters>
-<parameter name="GTK_TEXT_WINDOW_PRIVATE">
-<parameter_description> Private value, used internally
-</parameter_description>
-</parameter>
 <parameter name="GTK_TEXT_WINDOW_WIDGET">
 <parameter_description> Window that floats over scrolling areas.
 </parameter_description>
@@ -32296,8 +32301,8 @@ Gets the menu model set with gtk_entry_set_extra_menu().
 
 </description>
 <parameters>
-<parameter name="self">
-<parameter_description> a #GtkText
+<parameter name="entry">
+<parameter_description> a #GtkEntry
 </parameter_description>
 </parameter>
 </parameters>
@@ -33504,6 +33509,22 @@ controller action
 </return>
 </function>
 
+<function name="gtk_event_controller_key_contains_focus">
+<description>
+Returns the value of the GtkEventControllerKey:contains-focus property.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkEventControllerKey
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if focus is within @self or one of its children
+</return>
+</function>
+
 <function name="gtk_event_controller_key_forward">
 <description>
 Forwards the current event of this @controller to a @widget.
@@ -33604,6 +33625,22 @@ Gets the input method context of the key @controller.
 </return>
 </function>
 
+<function name="gtk_event_controller_key_is_focus">
+<description>
+Returns the value of the GtkEventControllerKey:is-focus property.
+
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkEventControllerKey
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if focus is within @self but not one of its children
+</return>
+</function>
+
 <function name="gtk_event_controller_key_new">
 <description>
 Creates a new event controller that will handle key events.
@@ -73306,18 +73343,16 @@ Adds a child widget in the text buffer, at the given @anchor.
 <return></return>
 </function>
 
-<function name="gtk_text_view_add_child_in_window">
+<function name="gtk_text_view_add_overlay">
 <description>
-Adds a child at fixed coordinates in one of the text widget's
-windows.
+Adds @child at a fixed coordinate in the #GtkTextView's text window. The
+@xpos and @ypos must be in buffer coordinates (see
+gtk_text_view_get_iter_location() to conver to buffer coordinates).
+
+@child will scroll with the text view.
 
-The window must have nonzero size (see
-gtk_text_view_set_border_window_size()). Note that the child
-coordinates are given relative to scrolling. When
-placing a child in #GTK_TEXT_WINDOW_WIDGET, scrolling is
-irrelevant, the child floats above all scrollable areas. But when
-placing a child in one of the scrollable windows (border windows or
-text window) it will move with the scrolling as needed.
+If instead you want a widget that will not move with the #GtkTextView
+contents see #GtkOverlay.
 
 </description>
 <parameters>
@@ -73329,10 +73364,6 @@ text window) it will move with the scrolling as needed.
 <parameter_description> a #GtkWidget
 </parameter_description>
 </parameter>
-<parameter name="which_window">
-<parameter_description> which window the child should appear in
-</parameter_description>
-</parameter>
 <parameter name="xpos">
 <parameter_description> X position of child in window coordinates
 </parameter_description>
@@ -73399,7 +73430,7 @@ views, since they depend on the contents of the #GtkTextBuffer.
 </return>
 </function>
 
-<function name="gtk_text_view_buffer_to_surface_coords">
+<function name="gtk_text_view_buffer_to_window_coords">
 <description>
 Converts coordinate (@buffer_x, @buffer_y) to coordinates for the window
 @win, and stores the result in (@window_x, @window_y). 
@@ -73414,7 +73445,7 @@ gtk_text_view_set_border_window_size()).
 </parameter_description>
 </parameter>
 <parameter name="win">
-<parameter_description> a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE
+<parameter_description> a #GtkTextWindowType
 </parameter_description>
 </parameter>
 <parameter name="buffer_x">
@@ -73509,27 +73540,6 @@ gtk_text_view_set_accepts_tab().
 </return>
 </function>
 
-<function name="gtk_text_view_get_border_window_size">
-<description>
-Gets the width of the specified border window. See
-gtk_text_view_set_border_window_size().
-
-
-</description>
-<parameters>
-<parameter name="text_view">
-<parameter_description> a #GtkTextView
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> window to return size from
-</parameter_description>
-</parameter>
-</parameters>
-<return> width of window
-</return>
-</function>
-
 <function name="gtk_text_view_get_bottom_margin">
 <description>
 Gets the bottom margin for text in the @text_view.
@@ -73583,7 +73593,7 @@ returned locations will be adjusted to account for the preedit
 cursor’s offset within the preedit sequence.
 
 The rectangle position is in buffer coordinates; use
-gtk_text_view_buffer_to_surface_coords() to convert these
+gtk_text_view_buffer_to_window_coords() to convert these
 coordinates to coordinates for one of the windows in the text view.
 
 </description>
@@ -73659,6 +73669,30 @@ Gets the menu model set with gtk_text_view_set_extra_menu().
 </return>
 </function>
 
+<function name="gtk_text_view_get_gutter">
+<description>
+Gets a #GtkWidget that has previously been set with
+gtk_text_view_set_gutter().
+
+@win must be one of %GTK_TEXT_WINDOW_LEFT, %GTK_TEXT_WINDOW_RIGHT,
+%GTK_TEXT_WINDOW_TOP, or %GTK_TEXT_WINDOW_BOTTOM.
+
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="win">
+<parameter_description> a #GtkWindowType
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GtkWidget or %NULL
+</return>
+</function>
+
 <function name="gtk_text_view_get_indent">
 <description>
 Gets the default indentation of paragraphs in @text_view.
@@ -73785,7 +73819,7 @@ zero, or the number of characters in the grapheme.
 <description>
 Gets a rectangle which roughly contains the character at @iter.
 The rectangle position is in buffer coordinates; use
-gtk_text_view_buffer_to_surface_coords() to convert these
+gtk_text_view_buffer_to_window_coords() to convert these
 coordinates to coordinates for one of the windows in the text view.
 
 </description>
@@ -73874,7 +73908,7 @@ edge of the line.
 <description>
 Gets the y coordinate of the top of the line containing @iter,
 and the height of the line. The coordinate is a buffer coordinate;
-convert to window coordinates with gtk_text_view_buffer_to_surface_coords().
+convert to window coordinates with gtk_text_view_buffer_to_window_coords().
 
 </description>
 <parameters>
@@ -74040,7 +74074,7 @@ Gets the top margin for text in the @text_view.
 <description>
 Fills @visible_rect with the currently-visible
 region of the buffer, in buffer coordinates. Convert to window coordinates
-with gtk_text_view_buffer_to_surface_coords().
+with gtk_text_view_buffer_to_window_coords().
 
 </description>
 <parameters>
@@ -74121,9 +74155,11 @@ return GTK_WIDGET_CLASS (gtk_foo_bar_parent_class)-&gt;key_press_event (widget,
 </return>
 </function>
 
-<function name="gtk_text_view_move_child">
+<function name="gtk_text_view_move_mark_onscreen">
 <description>
-Updates the position of a child, as for gtk_text_view_add_child_in_window().
+Moves a mark within the buffer so that it's
+located within the currently-visible text area.
+
 
 </description>
 <parameters>
@@ -74131,27 +74167,18 @@ Updates the position of a child, as for gtk_text_view_add_child_in_window().
 <parameter_description> a #GtkTextView
 </parameter_description>
 </parameter>
-<parameter name="child">
-<parameter_description> child widget already added to the text view
-</parameter_description>
-</parameter>
-<parameter name="xpos">
-<parameter_description> new X position in window coordinates
-</parameter_description>
-</parameter>
-<parameter name="ypos">
-<parameter_description> new Y position in window coordinates
+<parameter name="mark">
+<parameter_description> a #GtkTextMark
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE if the mark moved (wasn’t already onscreen)
+</return>
 </function>
 
-<function name="gtk_text_view_move_mark_onscreen">
+<function name="gtk_text_view_move_overlay">
 <description>
-Moves a mark within the buffer so that it's
-located within the currently-visible text area.
-
+Updates the position of a child, as for gtk_text_view_add_overlay().
 
 </description>
 <parameters>
@@ -74159,13 +74186,20 @@ located within the currently-visible text area.
 <parameter_description> a #GtkTextView
 </parameter_description>
 </parameter>
-<parameter name="mark">
-<parameter_description> a #GtkTextMark
+<parameter name="child">
+<parameter_description> a widget already added with gtk_text_view_add_overlay()
+</parameter_description>
+</parameter>
+<parameter name="xpos">
+<parameter_description> new X position in buffer coordinates
+</parameter_description>
+</parameter>
+<parameter name="ypos">
+<parameter_description> new Y position in buffer coordinates
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE if the mark moved (wasn’t already onscreen)
-</return>
+<return></return>
 </function>
 
 <function name="gtk_text_view_move_visually">
@@ -74426,34 +74460,6 @@ keyboard focus.
 <return></return>
 </function>
 
-<function name="gtk_text_view_set_border_window_size">
-<description>
-Sets the width of %GTK_TEXT_WINDOW_LEFT or %GTK_TEXT_WINDOW_RIGHT,
-or the height of %GTK_TEXT_WINDOW_TOP or %GTK_TEXT_WINDOW_BOTTOM.
-Automatically destroys the corresponding window if the size is set
-to 0, and creates the window if the size is set to non-zero.  This
-function can only be used for the “border windows,” it doesn’t work
-with #GTK_TEXT_WINDOW_WIDGET, #GTK_TEXT_WINDOW_TEXT, or
-#GTK_TEXT_WINDOW_PRIVATE.
-
-</description>
-<parameters>
-<parameter name="text_view">
-<parameter_description> a #GtkTextView
-</parameter_description>
-</parameter>
-<parameter name="type">
-<parameter_description> window to affect
-</parameter_description>
-</parameter>
-<parameter name="size">
-<parameter_description> width or height of the window
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_text_view_set_bottom_margin">
 <description>
 Sets the bottom margin for text in @text_view.
@@ -74559,6 +74565,31 @@ the context menu for @text_view.
 <return></return>
 </function>
 
+<function name="gtk_text_view_set_gutter">
+<description>
+Places @widget into the gutter specified by @win.
+
+@win must be one of %GTK_TEXT_WINDOW_LEFT, %GTK_TEXT_WINDOW_RIGHT,
+%GTK_TEXT_WINDOW_TOP, or %GTK_TEXT_WINDOW_BOTTOM.
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="win">
+<parameter_description> a #GtkTextWindowType
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> a #GtkWidget or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_view_set_indent">
 <description>
 Sets the default indentation for paragraphs in @text_view.
@@ -74873,7 +74904,7 @@ gtk_text_view_set_border_window_size()).
 </parameter_description>
 </parameter>
 <parameter name="win">
-<parameter_description> a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE
+<parameter_description> a #GtkTextWindowType
 </parameter_description>
 </parameter>
 <parameter name="window_x">
@@ -80004,10 +80035,6 @@ primarily by the #GtkTreeView.
 <parameter_description> A #GtkTreeViewColumn.
 </parameter_description>
 </parameter>
-<parameter name="cell_area">
-<parameter_description> The area a cell in the column will be allocated, or %NULL
-</parameter_description>
-</parameter>
 <parameter name="x_offset">
 <parameter_description> location to return x offset of a cell relative to @cell_area, or %NULL
 </parameter_description>
diff --git a/gtk/src/gtk_enums.defs b/gtk/src/gtk_enums.defs
index b5cd411c..59a4ae56 100644
--- a/gtk/src/gtk_enums.defs
+++ b/gtk/src/gtk_enums.defs
@@ -2419,8 +2419,7 @@
 ;; Original typedef:
 ;; typedef enum
 ;; {
-;;   GTK_TEXT_WINDOW_PRIVATE,
-;;   GTK_TEXT_WINDOW_WIDGET,
+;;   GTK_TEXT_WINDOW_WIDGET = 1,
 ;;   GTK_TEXT_WINDOW_TEXT,
 ;;   GTK_TEXT_WINDOW_LEFT,
 ;;   GTK_TEXT_WINDOW_RIGHT,
@@ -2432,7 +2431,6 @@
   (in-module "Gsk")
   (c-name "GtkTextWindowType")
   (values
-    '("private" "GTK_TEXT_WINDOW_PRIVATE" "0")
     '("widget" "GTK_TEXT_WINDOW_WIDGET" "1")
     '("text" "GTK_TEXT_WINDOW_TEXT" "2")
     '("left" "GTK_TEXT_WINDOW_LEFT" "3")
diff --git a/gtk/src/gtk_methods.defs b/gtk/src/gtk_methods.defs
index 5dd3e89c..ab80250c 100644
--- a/gtk/src/gtk_methods.defs
+++ b/gtk/src/gtk_methods.defs
@@ -1931,7 +1931,6 @@
   (c-name "GtkTextWindowType")
   (gtype-id "GTK_TYPE_TEXT_WINDOW_TYPE")
   (values
-    '("private" "GTK_TEXT_WINDOW_PRIVATE")
     '("widget" "GTK_TEXT_WINDOW_WIDGET")
     '("text" "GTK_TEXT_WINDOW_TEXT")
     '("left" "GTK_TEXT_WINDOW_LEFT")
@@ -9092,6 +9091,18 @@
   (return-type "GtkWidget*")
 )
 
+(define-method contains_focus
+  (of-object "GtkEventControllerKey")
+  (c-name "gtk_event_controller_key_contains_focus")
+  (return-type "gboolean")
+)
+
+(define-method is_focus
+  (of-object "GtkEventControllerKey")
+  (c-name "gtk_event_controller_key_is_focus")
+  (return-type "gboolean")
+)
+
 
 
 ;; From gtkeventcontrollerlegacy.h
@@ -15982,6 +15993,21 @@
   (return-type "GtkWidget*")
 )
 
+(define-method set_popover
+  (of-object "GtkMenuToolButton")
+  (c-name "gtk_menu_tool_button_set_popover")
+  (return-type "none")
+  (parameters
+    '("GtkWidget*" "popover")
+  )
+)
+
+(define-method get_popover
+  (of-object "GtkMenuToolButton")
+  (c-name "gtk_menu_tool_button_get_popover")
+  (return-type "GtkWidget*")
+)
+
 (define-method set_arrow_tooltip_text
   (of-object "GtkMenuToolButton")
   (c-name "gtk_menu_tool_button_set_arrow_tooltip_text")
@@ -25667,9 +25693,9 @@
   )
 )
 
-(define-method buffer_to_surface_coords
+(define-method buffer_to_window_coords
   (of-object "GtkTextView")
-  (c-name "gtk_text_view_buffer_to_surface_coords")
+  (c-name "gtk_text_view_buffer_to_window_coords")
   (return-type "none")
   (parameters
     '("GtkTextWindowType" "win")
@@ -25693,25 +25719,6 @@
   )
 )
 
-(define-method set_border_window_size
-  (of-object "GtkTextView")
-  (c-name "gtk_text_view_set_border_window_size")
-  (return-type "none")
-  (parameters
-    '("GtkTextWindowType" "type")
-    '("gint" "size")
-  )
-)
-
-(define-method get_border_window_size
-  (of-object "GtkTextView")
-  (c-name "gtk_text_view_get_border_window_size")
-  (return-type "gint")
-  (parameters
-    '("GtkTextWindowType" "type")
-  )
-)
-
 (define-method forward_display_line
   (of-object "GtkTextView")
   (c-name "gtk_text_view_forward_display_line")
@@ -25782,6 +25789,25 @@
   (return-type "none")
 )
 
+(define-method get_gutter
+  (of-object "GtkTextView")
+  (c-name "gtk_text_view_get_gutter")
+  (return-type "GtkWidget*")
+  (parameters
+    '("GtkTextWindowType" "win")
+  )
+)
+
+(define-method set_gutter
+  (of-object "GtkTextView")
+  (c-name "gtk_text_view_set_gutter")
+  (return-type "none")
+  (parameters
+    '("GtkTextWindowType" "win")
+    '("GtkWidget*" "widget")
+  )
+)
+
 (define-method add_child_at_anchor
   (of-object "GtkTextView")
   (c-name "gtk_text_view_add_child_at_anchor")
@@ -25792,21 +25818,20 @@
   )
 )
 
-(define-method add_child_in_window
+(define-method add_overlay
   (of-object "GtkTextView")
-  (c-name "gtk_text_view_add_child_in_window")
+  (c-name "gtk_text_view_add_overlay")
   (return-type "none")
   (parameters
     '("GtkWidget*" "child")
-    '("GtkTextWindowType" "which_window")
     '("gint" "xpos")
     '("gint" "ypos")
   )
 )
 
-(define-method move_child
+(define-method move_overlay
   (of-object "GtkTextView")
-  (c-name "gtk_text_view_move_child")
+  (c-name "gtk_text_view_move_overlay")
   (return-type "none")
   (parameters
     '("GtkWidget*" "child")
diff --git a/gtk/src/gtk_signals.defs b/gtk/src/gtk_signals.defs
index 2338f027..b6111018 100644
--- a/gtk/src/gtk_signals.defs
+++ b/gtk/src/gtk_signals.defs
@@ -6469,6 +6469,15 @@
   (construct-only #f)
 )
 
+(define-property popover
+  (of-object "GtkMenuToolButton")
+  (prop-type "GParamObject")
+  (docs "The dropdown popover")
+  (readable #t)
+  (writable #t)
+  (construct-only #f)
+)
+
 ;; From GtkMessageDialog
 
 (define-property message-type
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]