[gtkmm] Regenerate gtk_docs.xml



commit 1e2adbc04c370f123dac5081dae6c8b18a19425e
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Tue Dec 29 10:37:35 2015 +0100

    Regenerate gtk_docs.xml

 gtk/src/gtk_docs.xml | 2129 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 2053 insertions(+), 76 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 8acedd5..c6e96a9 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -1369,6 +1369,15 @@ Since: 2.10
 </description>
 </property>
 
+<property name="GtkAssistant:content-padding">
+<description>
+Number of pixels around the content.
+
+Deprecated:3.20: This style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkAssistant:header-image">
 <description>
 This image used to be displayed in the page header.
@@ -1381,6 +1390,15 @@ add your header decoration to the page content instead.
 </description>
 </property>
 
+<property name="GtkAssistant:header-padding">
+<description>
+Number of pixels around the header.
+
+Deprecated:3.20: This style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkAssistant:page-type">
 <description>
 The type of the assistant page.
@@ -1742,6 +1760,8 @@ Spacing in pixels between the image and label.
 
 Since: 2.10
 
+Deprecated: 3.20: Use CSS margins and padding instead.
+
 </description>
 <parameters>
 </parameters>
@@ -1809,13 +1829,34 @@ Since: 3.6
 </description>
 </property>
 
+<property name="GtkButton:child-displacement-x">
+<description>
+How far in the x direction to move the child when the button is depressed.
+
+Deprecated: 3.20: Use CSS margins and padding instead;
+the value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkButton:child-displacement-y">
+<description>
+How far in the y direction to move the child when the button is depressed.
+
+Deprecated: 3.20: Use CSS margins and padding instead;
+the value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkButton:default-border">
 <description>
 The &quot;default-border&quot; style property defines the extra space to add
 around a button that can become the default widget of its window.
 For more information about default widgets, see gtk_widget_grab_default().
 
-Deprecated: 3.14: use CSS margins and padding instead.
+Deprecated: 3.14: Use CSS margins and padding instead;
+the value of this style property is ignored.
 
 </description>
 </property>
@@ -1827,18 +1868,22 @@ space to add around a button that can become the default widget of its
 window. Extra outside space is always drawn outside the button border.
 For more information about default widgets, see gtk_widget_grab_default().
 
-Deprecated: 3.14: use CSS margins and padding instead.
+Deprecated: 3.14: Use CSS margins and padding instead;
+the value of this style property is ignored.
 
 </description>
 </property>
 
 <property name="GtkButton:displace-focus">
 <description>
-Whether the child_displacement_x/child_displacement_y properties 
+Whether the child_displacement_x/child_displacement_y properties
 should also affect the focus rectangle.
 
 Since: 2.6
 
+Deprecated: 3.20: Use CSS margins and padding instead;
+the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -1916,6 +1961,42 @@ its alignment.
 </description>
 </property>
 
+<property name="GtkButtonBox:child-internal-pad-x">
+<description>
+The amount to increase a child's size on either side.
+
+Deprecated: 3.20: Use CSS padding instead.
+
+</description>
+</property>
+
+<property name="GtkButtonBox:child-internal-pad-y">
+<description>
+The amount to increase a child's size on the top and bottom.
+
+Deprecated: 3.20: Use CSS padding instead.
+
+</description>
+</property>
+
+<property name="GtkButtonBox:child-min-height">
+<description>
+The minimum height of buttons inside the box.
+
+Deprecated: 3.20: Use CSS min-height instead.
+
+</description>
+</property>
+
+<property name="GtkButtonBox:child-min-width">
+<description>
+The minimum width of buttons inside the box.
+
+Deprecated: 3.20: Use CSS min-width instead.
+
+</description>
+</property>
+
 <enum name="GtkButtonBoxStyle">
 <description>
 Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
@@ -3312,6 +3393,25 @@ since 2.10
 </description>
 </property>
 
+<property name="GtkCheckButton:indicator-size">
+<description>
+The size of the indicator.
+
+Deprecated: 3.20: Use CSS min-width and min-height on the indicator node.
+
+</description>
+</property>
+
+<property name="GtkCheckButton:indicator-spacing">
+<description>
+The spacing around the indicator.
+
+Deprecated: 3.20: Use CSS margins of the indicator node,
+the value of this style property is ignored.
+
+</description>
+</property>
+
 <signal name="GtkCheckMenuItem::toggled">
 <description>
 This signal is emitted when the state of the check box is changed.
@@ -3329,6 +3429,16 @@ to discover the new state.
 <return></return>
 </signal>
 
+<property name="GtkCheckMenuItem:indicator-size">
+<description>
+The size of the check or radio indicator.
+
+Deprecated: 3.20: Use the standard CSS property min-width on the check or
+radio nodes; the value of this style property is ignored.
+
+</description>
+</property>
+
 <signal name="GtkClipboard::owner-change">
 <description>
 The ::owner-change signal is emitted when GTK+ receives an
@@ -3693,7 +3803,8 @@ Deprecated: 3.10
 Sets the amount of space used up by the combobox arrow,
 proportional to the font size.
 
-Since: 3.2
+Deprecated: 3.20: use the standard min-width/min-height CSS properties on
+the arrow node; the value of this style property is ignored.
 
 </description>
 </property>
@@ -3707,6 +3818,9 @@ by arrow size.
 
 Since: 2.12
 
+Deprecated: 3.20: use the standard min-width/min-height CSS properties on
+the arrow node; the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -3835,6 +3949,9 @@ Which kind of shadow to draw around the combo box.
 
 Since: 2.12
 
+Deprecated: 3.20: use CSS styling to change the appearance of the combobox
+frame; the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -4730,6 +4847,9 @@ icons prelight on mouseover.
 
 Since: 2.16
 
+Deprecated: 3.20: Use CSS to control the appearance of prelighted icons;
+the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -5487,6 +5607,25 @@ Since: 3.14
 </parameters>
 </enum>
 
+<property name="GtkExpander:expander-size">
+<description>
+The size of the expander arrow.
+
+Deprecated: 3.20: Use CSS min-width and min-height instead.
+
+</description>
+</property>
+
+<property name="GtkExpander:expander-spacing">
+<description>
+Spaing around the expander arrow.
+
+Deprecated: 3.20: Use CSS margins instead, the value of this
+style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkExpander:resize-toplevel">
 <description>
 When this property is %TRUE, the expander will resize the toplevel
@@ -5792,16 +5931,6 @@ Since: 2.6
 </description>
 </property>
 
-<property name="GtkFileChooserButton:focus-on-click">
-<description>
-Whether the #GtkFileChooserButton button grabs focus when it is clicked
-with the mouse.
-
-Since: 2.10
-
-</description>
-</property>
-
 <property name="GtkFileChooserButton:title">
 <description>
 Title to put on the #GtkFileChooserDialog associated with the button.
@@ -5877,6 +6006,22 @@ adding a bookmark).
 </parameters>
 </enum>
 
+<property name="GtkFileChooserNative:accept-label">
+<description>
+The text used for the label on the accept button in the dialog, or
+%NULL to use the default text.
+
+</description>
+</property>
+
+<property name="GtkFileChooserNative:cancel-label">
+<description>
+The text used for the label on the cancel button in the dialog, or
+%NULL to use the default text.
+
+</description>
+</property>
+
 <signal name="GtkFileChooserWidget::desktop-folder">
 <description>
 The ::desktop-folder signal is a [keybinding signal][GtkBindingSignal]
@@ -6200,8 +6345,6 @@ activated by the user.
 The ::move-cursor signal is a
 [keybinding signal][GtkBindingSignal]
 which gets emitted when the user initiates a cursor movement.
-If the cursor is not visible in @text_view, this signal causes
-the viewport to be moved instead.
 
 Applications should not connect to it, but may emit it with
 g_signal_emit_by_name() if they need to control the cursor
@@ -6215,6 +6358,7 @@ There are too many key combinations to list them all here.
 - Home/End keys move to the ends of the box
 - PageUp/PageDown keys move vertically by pages
 
+
 </description>
 <parameters>
 <parameter name="box">
@@ -6230,7 +6374,9 @@ There are too many key combinations to list them all here.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> %TRUE to stop other handlers from being invoked for the event.
+%FALSE to propagate the event further.
+</return>
 </signal>
 
 <signal name="GtkFlowBox::select-all">
@@ -7417,7 +7563,8 @@ is %NULL and you need to call gtk_icon_info_get_builtin_pixbuf().
 </parameter>
 <parameter name="GTK_ICON_LOOKUP_GENERIC_FALLBACK">
 <parameter_description> Try to shorten icon name at '-'
-characters before looking at inherited themes. For more general
+characters before looking at inherited themes. This flag is only
+supported in functions that take a single icon name. For more general
 fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
 </parameter_description>
 </parameter>
@@ -7831,6 +7978,26 @@ Since: 2.6
 </description>
 </property>
 
+<property name="GtkIconView:selection-box-alpha">
+<description>
+The opacity of the selection box.
+
+Deprecated: 3.20: The opacity of the selection box is determined by CSS;
+the value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkIconView:selection-box-color">
+<description>
+The color of the selection box.
+
+Deprecated: 3.20: The color of the selection box is determined by CSS;
+the value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkIconView:selection-mode">
 <description>
 The ::selection-mode property specifies the selection mode of
@@ -9041,6 +9208,8 @@ Indicates where scroll arrows should be placed.
 
 Since: 2.16
 
+Deprecated: 3.20: the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -9050,6 +9219,9 @@ Arbitrary constant to scale down the size of the scroll arrow.
 
 Since: 2.16
 
+Deprecated: 3.20: use the standard min-width/min-height CSS properties on
+the arrow node; the value of this style property is ignored.
+
 </description>
 </property>
 
@@ -9064,6 +9236,15 @@ Since: 2.14
 </description>
 </property>
 
+<property name="GtkMenu:double-arrows">
+<description>
+When %TRUE, both arrows are shown when scrolling.
+
+Deprecated: 3.20: the value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkMenu:horizontal-padding">
 <description>
 Extra space at the left and right edges of the menu.
@@ -9162,6 +9343,16 @@ Since: 2.8
 </description>
 </property>
 
+<property name="GtkMenuBar:shadow-type">
+<description>
+The style of the shadow around the menubar.
+
+Deprecated: 3.20: Use CSS to determine the shadow; the value of
+this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkMenuButton:align-widget">
 <description>
 The #GtkWidget to use to align the menu with.
@@ -9289,6 +9480,27 @@ Since: 2.14
 </description>
 </property>
 
+<property name="GtkMenuItem:arrow-scaling">
+<description>
+Amount of space used up by the arrow, relative to the menu item's font
+size.
+
+Deprecated: 3.20: use the standard min-width/min-height CSS properties on
+the arrow node; the value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkMenuItem:arrow-spacing">
+<description>
+Spacing between menu item label and submenu arrow.
+
+Deprecated: 3.20: use the standard margin CSS property on the arrow node;
+the value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkMenuItem:horizontal-padding">
 <description>
 Padding to left and right of the menu item.
@@ -9319,6 +9531,16 @@ Since: 2.14
 </description>
 </property>
 
+<property name="GtkMenuItem:selected-shadow-type">
+<description>
+The shadow type when the item is selected.
+
+Deprecated: 3.20: Use CSS to determine the shadow; the value of this
+style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkMenuItem:submenu">
 <description>
 The submenu attached to the menu item, or %NULL if it has none.
@@ -9328,6 +9550,16 @@ Since: 2.12
 </description>
 </property>
 
+<property name="GtkMenuItem:toggle-spacing">
+<description>
+Spacing between menu icon and label.
+
+Deprecated: 3.20: use the standard margin CSS property on the check or
+radio nodes; the value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkMenuItem:use-underline">
 <description>
 %TRUE if underlines in the text indicate mnemonics.
@@ -9343,6 +9575,9 @@ The minimum desired width of the menu item in characters.
 
 Since: 2.14
 
+Deprecated: 3.20: Use the standard CSS property min-width; the value of
+this style property is ignored.
+
 </description>
 </property>
 
@@ -9802,6 +10037,67 @@ Since: 3.16
 </parameters>
 </enum>
 
+<signal name="GtkNativeDialog::response">
+<description>
+Emitted when the user responds to the dialog.
+
+When this is called the dialog has been hidden.
+
+If you call gtk_native_dialog_hide() before the user responds to
+the dialog this signal will not be emitted.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> the object on which the signal is emitted
+</parameter_description>
+</parameter>
+<parameter name="response_id">
+<parameter_description> the response ID
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
+<property name="GtkNativeDialog:modal">
+<description>
+Whether the window should be modal with respect to its transient parent.
+
+Since: 3.20
+
+</description>
+</property>
+
+<property name="GtkNativeDialog:title">
+<description>
+The title of the dialog window
+
+Since: 3.20
+
+</description>
+</property>
+
+<property name="GtkNativeDialog:transient-for">
+<description>
+The transient parent of the dialog, or %NULL for none.
+
+Since: 3.20
+
+</description>
+</property>
+
+<property name="GtkNativeDialog:visible">
+<description>
+Whether the window is currenlty visible.
+
+Since: 3.20
+
+</description>
+</property>
+
 <signal name="GtkNotebook::create-window">
 <description>
 The ::create-window signal is emitted when a detachable
@@ -10355,6 +10651,18 @@ Since: 2.0
 <return></return>
 </signal>
 
+<signal name="GtkPaned::handle-size">
+<description>
+The width of the handle.
+
+Deprecated: 3.20: Use CSS min-width and min-height instead.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkPaned::move-handle">
 <description>
 The ::move-handle signal is a 
@@ -10944,6 +11252,15 @@ scrolled windows share a scrollbar. Since: 3.16
 </parameters>
 </enum>
 
+<property name="GtkPopover:constrain-to">
+<description>
+Sets a constraint for the popover position.
+
+Since: 3.20
+
+</description>
+</property>
+
 <property name="GtkPopover:modal">
 <description>
 Sets whether the popover is modal (so other elements in the window do not
@@ -10990,6 +11307,28 @@ Since: 3.16
 </description>
 </property>
 
+<enum name="GtkPopoverConstraint">
+<description>
+Describes constraints to positioning of popovers. More values
+may be added to this enumeration in the future.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="GTK_POPOVER_CONSTRAINT_NONE">
+<parameter_description> Don't constrain the popover position
+beyond what is imposed by the implementation
+</parameter_description>
+</parameter>
+<parameter name="GTK_POPOVER_CONSTRAINT_WINDOW">
+<parameter_description> Constrain the popover to the boundaries
+of the window that it is attached to
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
 <property name="GtkPopoverMenu:submenu">
 <description>
 The submenu child property specifies the name of the submenu
@@ -12013,6 +12352,8 @@ Minimum horizontal height of the progress bar.
 
 Since: 2.14
 
+Deprecated: 3.20: Use the standard CSS property min-height.
+
 </description>
 </property>
 
@@ -12022,6 +12363,8 @@ The minimum horizontal width of the progress bar.
 
 Since: 2.14
 
+Deprecated: 3.20: Use the standard CSS property min-width.
+
 </description>
 </property>
 
@@ -12031,6 +12374,8 @@ The minimum vertical height of the progress bar.
 
 Since: 2.14
 
+Deprecated: 3.20: Use the standard CSS property min-height.
+
 </description>
 </property>
 
@@ -12040,6 +12385,8 @@ The minimum vertical width of the progress bar.
 
 Since: 2.14
 
+Deprecated: 3.20: Use the standard CSS proeprty min-width.
+
 </description>
 </property>
 
@@ -12060,6 +12407,26 @@ Since: 3.0
 </description>
 </property>
 
+<property name="GtkProgressBar:xspacing">
+<description>
+Extra spacing applied to the width of a progress bar.
+
+Deprecated: 3.20: Use the standard CSS padding and margins; the
+value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkProgressBar:yspacing">
+<description>
+Extra spacing applied to the height of a progress bar.
+
+Deprecated: 3.20: Use the standard CSS padding and margins; the
+value of this style property is ignored.
+
+</description>
+</property>
+
 <enum name="GtkPropagationPhase">
 <description>
 Describes the stage at which events are fed into a #GtkEventController.
@@ -12297,6 +12664,24 @@ Emitted when the range value changes.
 <return></return>
 </signal>
 
+<property name="GtkRange:arrow-displacement-x">
+<description>
+How far in the x direction to move the arrow when the button is depressed.
+
+Deprecated: 3.20: The value of this style property is ignored.
+
+</description>
+</property>
+
+<property name="GtkRange:arrow-displacement-y">
+<description>
+How far in the y direction to move the arrow when the button is depressed.
+
+Deprecated: 3.20: The value of this style property is ignored.
+
+</description>
+</property>
+
 <property name="GtkRange:arrow-scaling">
 <description>
 The arrow size proportion relative to the scroll button size.
@@ -13961,6 +14346,13 @@ Deprecated: 3.10: This setting is ignored. #GtkFileChooser uses GIO by default.
 </description>
 </property>
 
+<property name="GtkSettings:gtk-font-name">
+<description>
+The default font to use. GTK+ uses the family name and size from this string.
+
+</description>
+</property>
+
 <property name="GtkSettings:gtk-icon-sizes">
 <description>
 A list of icon sizes. The list is separated by colons, and
@@ -14392,6 +14784,299 @@ or there is (any other value).
 </parameters>
 </enum>
 
+<enum name="GtkShortcutType">
+<description>
+GtkShortcutType specifies the kind of shortcut that is being described.
+More values may be added to this enumeration over time.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="GTK_SHORTCUT_ACCELERATOR">
+<parameter_description>
+The shortcut is a keyboard accelerator. The #GtkShortcutsShortcut:accelerator
+property will be used.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_PINCH">
+<parameter_description>
+The shortcut is a pinch gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_STRETCH">
+<parameter_description>
+The shortcut is a stretch gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_ROTATE_CLOCKWISE">
+<parameter_description>
+The shortcut is a clockwise rotation gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_ROTATE_COUNTERCLOCKWISE">
+<parameter_description>
+The shortcut is a counterclockwise rotation gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_TWO_FINGER_SWIPE_LEFT">
+<parameter_description>
+The shortcut is a two-finger swipe gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE_TWO_FINGER_SWIPE_RIGHT">
+<parameter_description>
+The shortcut is a two-finger swipe gesture. GTK+ provides and icon and subtitle.
+</parameter_description>
+</parameter>
+<parameter name="GTK_SHORTCUT_GESTURE">
+<parameter_description>
+The shortcut is a gesture. The #GtkShortcutsShortcut:icon property will be
+used.
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
+<property name="GtkShortcutsGroup:accel-size-group">
+<description>
+The size group for the accelerator portion of shortcuts in this group.
+
+This is used internally by GTK+, and must not be modified by applications.
+
+</description>
+</property>
+
+<property name="GtkShortcutsGroup:height">
+<description>
+A rough measure for the number of lines in this group.
+
+This is used internally by GTK+, and is not useful for applications.
+
+</description>
+</property>
+
+<property name="GtkShortcutsGroup:title">
+<description>
+The title for this group of shortcuts.
+
+</description>
+</property>
+
+<property name="GtkShortcutsGroup:title-size-group">
+<description>
+The size group for the textual portion of shortcuts in this group.
+
+This is used internally by GTK+, and must not be modified by applications.
+
+</description>
+</property>
+
+<property name="GtkShortcutsGroup:view">
+<description>
+An optional view that the shortcuts in this group are relevant for.
+The group will be hidden if the #GtkShortcutsWindow:view-name property
+does not match the view of this group.
+
+Set this to %NULL to make the group always visible.
+
+</description>
+</property>
+
+<property name="GtkShortcutsSection:max-height">
+<description>
+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.
+
+</description>
+</property>
+
+<property name="GtkShortcutsSection:section-name">
+<description>
+A unique name to identify this section among the sections
+added to the GtkShortcutsWindow. Setting the #GtkShortcutsWindow:section-name
+property to this string will make this section shown in the
+GtkShortcutsWindow.
+
+</description>
+</property>
+
+<property name="GtkShortcutsSection:title">
+<description>
+The string to show in the section selector of the GtkShortcutsWindow
+for this section. If there is only one section, you don't need to
+set a title, since the section selector will not be shown in this case.
+
+</description>
+</property>
+
+<property name="GtkShortcutsSection:view-name">
+<description>
+A view name to filter the groups in this section by.
+See #GtkShortcutsGroup:view.
+
+Applications are expected to use the #GtkShortcutsWindow:view-name
+property for this purpose.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:accel-size-group">
+<description>
+The size group for the accelerator portion of this shortcut.
+
+This is used internally by GTK+, and must not be modified by applications.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:accelerator">
+<description>
+The accelerator(s) represented by this object. This property is used
+if #GtkShorcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_ACCELERATOR.
+
+The syntax of this property is (an extension of) the syntax understood by
+gtk_accelerator_parse(). Multiple accelerators can be specified by separating
+them with a space, but keep in mind that the available width is limited.
+It is also possible to specify ranges of shortcuts, using ... between the keys.
+Sequences of keys can be specified using a + or &amp; between the keys.
+
+Examples:
+- A single shortcut: &lt;ctl&gt;&lt;alt&gt;delete
+- Two alternative shortcuts: &lt;shift&gt;a Home
+- A range of shortcuts: &lt;alt&gt;1...&lt;alt&gt;9
+- Several keys pressed together: Control_L&amp;Control_R
+- A sequence of shortcuts or keys: &lt;ctl&gt;c+&lt;ctl&gt;x
+
+Use + instead of &amp; when the keys may (or have to be) pressed sequentially (e.g
+use t+t for 'press the t key twice').
+
+Note that &lt;, &gt; and &amp; need to be escaped as &lt;, &gt; and &amp; when used
+in .ui files.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:direction">
+<description>
+The text direction for which this shortcut is active. If the shortcut
+is used regardless of the text direction, set this property to
+#GTK_TEXT_DIR_NONE.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:icon">
+<description>
+An icon to represent the shortcut or gesture. This property is used if
+#GtkShortcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_GESTURE.
+For the other predefined gesture types, GTK+ provides an icon on its own.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:icon-set">
+<description>
+%TRUE if an icon has been set.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:shortcut-type">
+<description>
+The type of shortcut that is represented.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:subtitle">
+<description>
+The subtitle for the shortcut or gesture.
+
+This is typically used for gestures and should be a short, one-line
+text that describes the gesture itself. For the predefined gesture
+types, GTK+ provides a subtitle on its own.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:subtitle-set">
+<description>
+%TRUE if a subtitle has been set.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:title">
+<description>
+The textual description for the shortcut or gesture represented by
+this object. This should be a short string that can fit in a single line.
+
+</description>
+</property>
+
+<property name="GtkShortcutsShortcut:title-size-group">
+<description>
+The size group for the textual portion of this shortcut.
+
+This is used internally by GTK+, and must not be modified by applications.
+
+</description>
+</property>
+
+<signal name="GtkShortcutsWindow::close">
+<description>
+The ::close signal is a
+[keybinding signal][GtkBindingSignal]
+which gets emitted when the user uses a keybinding to close
+the window.
+
+The default binding for this signal is the Escape key.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
+<signal name="GtkShortcutsWindow::search">
+<description>
+The ::search signal is a
+[keybinding signal][GtkBindingSignal]
+which gets emitted when the user uses a keybinding to start a search.
+
+The default binding for this signal is Control-F.
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
+<property name="GtkShortcutsWindow:section-name">
+<description>
+The name of the section to show.
+
+This should be the section-name of one of the #GtkShortcutsSection
+objects that are in this shortcuts window.
+
+</description>
+</property>
+
+<property name="GtkShortcutsWindow:view-name">
+<description>
+The view name by which to filter the contents.
+
+This should correspond to the #GtkShortcutsGroup:view property of some of
+the #GtkShortcutsGroup objects that are inside this shortcuts window.
+
+Set this to %NULL to show all groups.
+
+</description>
+</property>
+
 <property name="GtkSizeGroup:ignore-hidden">
 <description>
 If %TRUE, unmapped widgets are ignored when determining 
@@ -14619,6 +15304,16 @@ Since: 2.10
 <return></return>
 </signal>
 
+<property name="GtkSpinButton:shadow-type">
+<description>
+Style of bevel around the sping button.
+
+Deprecated: 3.20: Use CSS to determine the style of the border;
+the value of this syyle property is ignored.
+
+</description>
+</property>
+
 <enum name="GtkSpinButtonUpdatePolicy">
 <description>
 The spin button update policy determines whether the spin button displays
@@ -14709,6 +15404,16 @@ Since: 3.16
 </description>
 </property>
 
+<property name="GtkStackSwitcher:icon-size">
+<description>
+Use the &quot;icon-size&quot; property to change the size of the image displayed
+when a #GtkStackSwitcher is displaying icons.
+
+Since: 3.20
+
+</description>
+</property>
+
 <enum name="GtkStackTransitionType">
 <description>
 These enumeration values describe the possible transitions
@@ -14861,6 +15566,10 @@ classes and sometimes uses different names.
 <parameter_description> Widget is checked. Since 3.14
 </parameter_description>
 </parameter>
+<parameter name="GTK_STATE_FLAG_DROP_ACTIVE">
+<parameter_description> Widget is highlighted as a drop target for DND. Since 3.20
+</parameter_description>
+</parameter>
 </parameters>
 </enum>
 
@@ -15275,6 +15984,16 @@ Is emitted whenever a new message gets pushed onto a statusbar's stack.
 <return></return>
 </signal>
 
+<property name="GtkStatusbar:shadow-type">
+<description>
+The style of the bevel around the statusbar text.
+
+Deprecated: 3.20: Use CSS properties to determine the appearance,
+the value of this style property is ignored.
+
+</description>
+</property>
+
 <signal name="GtkStyle::group-changed">
 <description>
 Emitted when the group of radio menu items that a radio menu item belongs
@@ -15408,6 +16127,8 @@ The minimum height of the #GtkSwitch handle, in pixels.
 
 Since: 3.18
 
+Deprecated: 3.20: Use the CSS min-height property instead.
+
 </description>
 </property>
 
@@ -15415,6 +16136,8 @@ Since: 3.18
 <description>
 The minimum width of the #GtkSwitch handle, in pixels.
 
+Deprecated: 3.20: Use the CSS min-width property instead.
+
 </description>
 </property>
 
@@ -16217,7 +16940,7 @@ Since: 3.16
 </parameter_description>
 </parameter>
 <parameter name="size_changed">
-<parameter_description> whether the size has been changed.
+<parameter_description> whether the change affects the #GtkTextView layout.
 </parameter_description>
 </parameter>
 </parameters>
@@ -16729,11 +17452,19 @@ drawing with the ::draw_layer vfunc.
 </description>
 <parameters>
 <parameter name="GTK_TEXT_VIEW_LAYER_BELOW">
-<parameter_description> The layer rendered below the text (but above the background).
+<parameter_description> Old deprecated layer, use %GTK_TEXT_VIEW_LAYER_BELOW_TEXT instead
 </parameter_description>
 </parameter>
 <parameter name="GTK_TEXT_VIEW_LAYER_ABOVE">
-<parameter_description> The layer rendered above the text.
+<parameter_description> Old deprecated layer, use %GTK_TEXT_VIEW_LAYER_ABOVE_TEXT instead
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_VIEW_LAYER_BELOW_TEXT">
+<parameter_description> The layer rendered below the text (but above the background).  Since: 3.20
+</parameter_description>
+</parameter>
+<parameter name="GTK_TEXT_VIEW_LAYER_ABOVE_TEXT">
+<parameter_description> The layer rendered above the text.  Since: 3.20
 </parameter_description>
 </parameter>
 </parameters>
@@ -19886,6 +20617,20 @@ Deprecated: 3.14: use the outline-width and padding CSS properties instead.
 </description>
 </property>
 
+<property name="GtkWidget:focus-on-click">
+<description>
+Whether the widget should grab focus when it is clicked with the mouse.
+
+This property is only relevant for widgets that can take focus.
+
+Before 3.20, several widgets (GtkButton, GtkFileChooserButton,
+GtkComboBox) implemented this property individually.
+
+Since: 3.20
+
+</description>
+</property>
+
 <property name="GtkWidget:focus-padding">
 <description>
 The &quot;focus-padding&quot; style property defines the width, in pixels,
@@ -22464,7 +23209,7 @@ Since: 3.12
 </parameter_description>
 </parameter>
 </parameters>
-<return> the center #GtkWidget.
+<return> the center #GtkWidget or %NULL.
 
 </return>
 </function>
@@ -25774,6 +26519,10 @@ or %NULL if the action does not accept an activation parameter
 <description>
 Adds a window to @application.
 
+This call can only happen after the @application has started;
+typically, you should add new application windows in response
+to the emission of the #GApplication::activate signal.
+
 This call is equivalent to setting the #GtkWindow:application
 property of @window to @application.
 
@@ -25781,7 +26530,7 @@ Normally, the connection between the application and the window
 will remain until the window is destroyed, but you can explicitly
 remove it with gtk_application_remove_window().
 
-GTK+ will keep the application running as long as it has
+GTK+ will keep the @application running as long as it has
 any windows.
 
 Since: 3.0
@@ -26369,6 +27118,25 @@ Since: 3.4
 <return></return>
 </function>
 
+<function name="gtk_application_window_get_help_overlay">
+<description>
+Gets the #GtkShortcutsWindow that has been set up with
+a prior call to gtk_application_window_set_help_overlay().
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkApplicationWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the help overlay associated with @window, or %NULL
+
+</return>
+</function>
+
 <function name="gtk_application_window_get_id">
 <description>
 Returns the unique ID of the window. If the window has not yet been added to
@@ -26426,6 +27194,28 @@ Since: 3.4
 </return>
 </function>
 
+<function name="gtk_application_window_set_help_overlay">
+<description>
+Associates a shortcuts window with the application window, and
+sets up an action with the name win.show-help-overlay to present
+it.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkApplicationWindow
+</parameter_description>
+</parameter>
+<parameter name="help_overlay">
+<parameter_description> a #GtkShortcutsWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_application_window_set_show_menubar">
 <description>
 Sets whether the window will display a menubar for the app menu
@@ -27607,7 +28397,8 @@ Since: 2.14
 </description>
 <parameters>
 </parameters>
-<return> a newly allocated #GtkBorder-struct. Free with gtk_border_free()
+<return> a newly allocated #GtkBorder-struct.
+Free with gtk_border_free()
 
 </return>
 </function>
@@ -27644,6 +28435,7 @@ Since: 3.12
 </parameter>
 </parameters>
 <return> the center widget
+or %NULL in case no center widget is set.
 
 </return>
 </function>
@@ -28653,6 +29445,46 @@ Since: 3.8
 <return></return>
 </function>
 
+<function name="gtk_builder_extend_with_template">
+<description>
+Main private entry point for building composite container
+components from template XML.
+
+This is exported purely to let gtk-builder-tool validate
+templates, applications have no need to call this function.
+
+
+</description>
+<parameters>
+<parameter name="builder">
+<parameter_description> a #GtkBuilder
+</parameter_description>
+</parameter>
+<parameter name="widget">
+<parameter_description> the widget that is being extended
+</parameter_description>
+</parameter>
+<parameter name="template_type">
+<parameter_description> the type that the template is for
+</parameter_description>
+</parameter>
+<parameter name="buffer">
+<parameter_description> the string to parse
+</parameter_description>
+</parameter>
+<parameter name="length">
+<parameter_description> the length of @buffer (may be -1 if @buffer is nul-terminated)
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for an error, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A positive value on success, 0 if an error occurred
+</return>
+</function>
+
 <function name="gtk_builder_get_application">
 <description>
 Gets the #GtkApplication associated with the builder.
@@ -29021,6 +29853,31 @@ Since: 2.12
 </return>
 </function>
 
+<function name="gtk_builtin_icon_set_default_size_property">
+<description>
+Sets the name of a widget style property to use to compute the default size
+of the icon. If it is set to no %NULL, it will be used instead of the value
+set via gtk_builtin_icon_set_default_size() to set the default size of the
+icon.
+
+ property_name must refer to a style property that is of integer type.
+
+This function is intended strictly for backwards compatibility reasons.
+
+</description>
+<parameters>
+<parameter name="icon">
+<parameter_description> icon to set the property for
+</parameter_description>
+</parameter>
+<parameter name="property_name">
+<parameter_description> Name of the style property
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_button_box_get_child_non_homogeneous">
 <description>
 Returns whether the child is exempted from homogenous
@@ -32109,7 +32966,8 @@ Since: 3.0
 </parameter_description>
 </parameter>
 </parameters>
-<return> the cell area used by @cell_layout.
+<return> the cell area used by @cell_layout,
+or %NULL in case no cell area is used.
 
 </return>
 </function>
@@ -37437,7 +38295,7 @@ Removes @widget from @container. @widget must be inside @container.
 Note that @container will own a reference to @widget, and that this
 may be the last reference held; so removing a widget from its
 container can destroy that widget. If you want to use @widget
-again, you need to add a reference to it while it’s not inside
+again, you need to add a reference to it before removing it from
 a container, using g_object_ref(). If you don’t want to use @widget
 again it’s usually more efficient to simply destroy it directly
 using gtk_widget_destroy() since this will remove it from the
@@ -37665,6 +38523,297 @@ Removes a focus chain explicitly set with gtk_container_set_focus_chain().
 <return></return>
 </function>
 
+<function name="gtk_css_custom_gadget_new">
+<description>
+Creates a #GtkCssCustomGadget with a new CSS node which gets
+placed below the @parent's and before the @next_sibling's CSS node.
+
+
+</description>
+<parameters>
+<parameter name="name">
+<parameter_description> the name for the CSS node
+</parameter_description>
+</parameter>
+<parameter name="owner">
+<parameter_description> the widget that the gadget belongs to
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> the gadget that has the parent CSS node
+</parameter_description>
+</parameter>
+<parameter name="next_sibling">
+<parameter_description> the gadget that has the sibling CSS node
+</parameter_description>
+</parameter>
+<parameter name="preferred_size_func">
+<parameter_description> the GtkCssPreferredSizeFunc to use
+</parameter_description>
+</parameter>
+<parameter name="allocate_func">
+<parameter_description> the GtkCssAllocateFunc to use
+</parameter_description>
+</parameter>
+<parameter name="draw_func">
+<parameter_description> the GtkCssDrawFunc to use
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to pass to the callbacks
+</parameter_description>
+</parameter>
+<parameter name="destroy_func">
+<parameter_description> destroy notify for @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new gadget
+</return>
+</function>
+
+<function name="gtk_css_custom_gadget_new_for_node">
+<description>
+Creates a #GtkCssCustomGadget for an existing CSS node.
+This function is typically used in the widgets init function
+to create the main gadget for the widgets main CSS node (which
+is obtained with gtk_widget_get_css_node()), as well as other
+permanent sub-gadgets. Sub-gadgets that only exist sometimes
+(e.g. depending on widget properties) should be created and
+destroyed as needed. All gadgets should be destroyed in the
+finalize (or dispose) vfunc.
+
+
+</description>
+<parameters>
+<parameter name="node">
+<parameter_description> the #GtkCssNode to use for the gadget
+</parameter_description>
+</parameter>
+<parameter name="owner">
+<parameter_description> the widget that the gadget belongs to
+</parameter_description>
+</parameter>
+<parameter name="preferred_size_func">
+<parameter_description> the GtkCssPreferredSizeFunc to use
+</parameter_description>
+</parameter>
+<parameter name="allocate_func">
+<parameter_description> the GtkCssAllocateFunc to use
+</parameter_description>
+</parameter>
+<parameter name="draw_func">
+<parameter_description> the GtkCssDrawFunc to use
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> user data to pass to the callbacks
+</parameter_description>
+</parameter>
+<parameter name="destroy_func">
+<parameter_description> destroy notify for @data
+</parameter_description>
+</parameter>
+</parameters>
+<return> the new gadget
+</return>
+</function>
+
+<function name="gtk_css_gadget_add_class">
+<description>
+Adds a style class to the gadgets CSS node.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> class name to use in CSS matching
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_allocate">
+<description>
+Allocates the gadget.
+
+The @allocation is assumed to include CSS padding, border and margin.
+The gadget content will be allocated a smaller area that excludes these.
+The @out_clip includes the shadow extents of the gadget in addition to
+any content clip.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> the #GtkCssGadget to allocate
+</parameter_description>
+</parameter>
+<parameter name="allocation">
+<parameter_description> the allocation
+</parameter_description>
+</parameter>
+<parameter name="baseline">
+<parameter_description> the baseline for the allocation
+</parameter_description>
+</parameter>
+<parameter name="out_clip">
+<parameter_description> return location for the gadgets clip region
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_draw">
+<description>
+Will draw the gadget at the position allocated via
+gtk_css_gadget_allocate(). It is your responsibility to make
+sure that those 2 coordinate systems match.
+
+The drawing virtual function will be passed an untransformed @cr.
+This is important because functions like
+gtk_container_propagate_draw() depend on that.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> The gadget to draw
+</parameter_description>
+</parameter>
+<parameter name="cr">
+<parameter_description> The cairo context to draw to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_get_node">
+<description>
+Get the CSS node for this gadget.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+</parameters>
+<return>  the CSS node
+</return>
+</function>
+
+<function name="gtk_css_gadget_get_owner">
+<description>
+Get the widget to which this gadget belongs.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+</parameters>
+<return>  the widget to which @gadget belongs
+</return>
+</function>
+
+<function name="gtk_css_gadget_get_preferred_size">
+<description>
+Gets the gadgets minimum and natural size (and, optionally, baseline)
+in the given orientation for the specified size in the opposite direction.
+
+The returned values include CSS padding, border and margin in addition to the
+gadgets content size, and respect the CSS min-with or min-height properties.
+
+The @for_size is assumed to include CSS padding, border and margins as well.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> the #GtkCssGadget whose size is requested
+</parameter_description>
+</parameter>
+<parameter name="orientation">
+<parameter_description> whether a width (ie horizontal) or height (ie vertical) size is requested
+</parameter_description>
+</parameter>
+<parameter name="for_size">
+<parameter_description> the available size in the opposite direction, or -1
+</parameter_description>
+</parameter>
+<parameter name="minimum">
+<parameter_description> return location for the minimum size
+</parameter_description>
+</parameter>
+<parameter name="natural">
+<parameter_description> return location for the natural size
+</parameter_description>
+</parameter>
+<parameter name="minimum_baseline">
+<parameter_description> return location for the baseline at minimum size
+</parameter_description>
+</parameter>
+<parameter name="natural_baseline">
+<parameter_description> return location for the baseline at natural size
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_gadget_get_style">
+<description>
+Get the CSS style for this gadget.
+
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+</parameters>
+<return>  the CSS style
+</return>
+</function>
+
+<function name="gtk_css_gadget_remove_class">
+<description>
+Removes a style class from the gadgets CSS node.
+
+</description>
+<parameters>
+<parameter name="gadget">
+<parameter_description> a #GtkCssGadget
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> class name
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_css_node_new">
+<description>
+Creates a new CSS node.
+
+
+</description>
+<parameters>
+</parameters>
+<return> the new CSS node
+</return>
+</function>
+
 <function name="gtk_css_provider_get_default">
 <description>
 Returns the provider containing the style settings used as a
@@ -39218,6 +40367,13 @@ signal and destroy it yourself.
 
 <function name="gtk_drag_source_add_image_targets">
 <description>
+Add the writable image targets supported by #GtkSelectionData to
+the target list of the drag source. The targets
+are added with @info = 0. If you need another value, 
+use gtk_target_list_add_image_targets() and
+gtk_drag_source_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
@@ -39231,7 +40387,7 @@ signal and destroy it yourself.
 
 <function name="gtk_drag_source_add_text_targets">
 <description>
-Add the text targets supported by #GtkSelection to
+Add the text targets supported by #GtkSelectionData to
 the target list of the drag source.  The targets
 are added with @info = 0. If you need another value, 
 use gtk_target_list_add_text_targets() and
@@ -39251,6 +40407,13 @@ Since: 2.6
 
 <function name="gtk_drag_source_add_uri_targets">
 <description>
+Add the URI targets supported by #GtkSelectionData to
+the target list of the drag source.  The targets
+are added with @info = 0. If you need another value, 
+use gtk_target_list_add_uri_targets() and
+gtk_drag_source_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
@@ -39264,6 +40427,10 @@ Since: 2.6
 
 <function name="gtk_drag_source_get_target_list">
 <description>
+Gets the list of targets this widget can provide for
+drag-and-drop.
+
+Since: 2.4
 
 </description>
 <parameters>
@@ -39272,12 +40439,15 @@ Since: 2.6
 </parameter_description>
 </parameter>
 </parameters>
-<return>
+<return> the #GtkTargetList, or %NULL if none
+
 </return>
 </function>
 
 <function name="gtk_drag_source_set">
 <description>
+Sets up a widget so that GTK+ will start a drag operation when the user
+clicks and drags on the widget. The widget must have a window.
 
 </description>
 <parameters>
@@ -39290,8 +40460,8 @@ Since: 2.6
 </parameter_description>
 </parameter>
 <parameter name="targets">
-<parameter_description> the table of targets that the drag will support,
-may be %NULL
+<parameter_description> the table of targets
+that the drag will support, may be %NULL
 </parameter_description>
 </parameter>
 <parameter name="n_targets">
@@ -39350,6 +40520,9 @@ Since: 2.8
 
 <function name="gtk_drag_source_set_icon_pixbuf">
 <description>
+Sets the icon that will be used for drags from a particular widget
+from a #GdkPixbuf. GTK+ retains a reference for @pixbuf and will 
+release it when it is no longer needed.
 
 </description>
 <parameters>
@@ -39368,7 +40541,9 @@ Since: 2.8
 <function name="gtk_drag_source_set_icon_stock">
 <description>
 Sets the icon that will be used for drags from a particular source
-to a stock icon. 
+to a stock icon.
+
+Deprecated: 3.10: Use gtk_drag_source_set_icon_name() instead.
 
 </description>
 <parameters>
@@ -39386,6 +40561,11 @@ to a stock icon.
 
 <function name="gtk_drag_source_set_target_list">
 <description>
+Changes the target types that this widget offers for drag-and-drop.
+The widget must first be made into a drag source with
+gtk_drag_source_set().
+
+Since: 2.4
 
 </description>
 <parameters>
@@ -39403,6 +40583,7 @@ to a stock icon.
 
 <function name="gtk_drag_source_unset">
 <description>
+Undoes the effects of gtk_drag_source_set().
 
 </description>
 <parameters>
@@ -41713,7 +42894,7 @@ Since: 2.12
 </parameter_description>
 </parameter>
 <parameter name="adjustment">
-<parameter_description> an adjustment which should be adjusted when the cursor 
+<parameter_description> an adjustment which should be adjusted when the cursor
 is moved, or %NULL
 </parameter_description>
 </parameter>
@@ -43949,6 +45130,130 @@ g_free().
 </return>
 </function>
 
+<function name="gtk_file_chooser_native_get_accept_label">
+<description>
+Retrieves the custom label text for the accept button.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtFileChooserNative
+</parameter_description>
+</parameter>
+</parameters>
+<return> The custom label, or %NULL for the default. This string is
+owned by GTK+ and should not be modified or freed
+
+</return>
+</function>
+
+<function name="gtk_file_chooser_native_get_cancel_label">
+<description>
+Retrieves the custom label text for the cancel button.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtFileChooserNative
+</parameter_description>
+</parameter>
+</parameters>
+<return> The custom label, or %NULL for the default. This string is
+owned by GTK+ and should not be modified or freed
+
+</return>
+</function>
+
+<function name="gtk_file_chooser_native_new">
+<description>
+Creates a new #GtkFileChooserNative.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="title">
+<parameter_description> Title of the native, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> Transient parent of the native, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> Open or save mode for the dialog
+</parameter_description>
+</parameter>
+<parameter name="accept_label">
+<parameter_description> text to go in the accept button, or %NULL for the default
+</parameter_description>
+</parameter>
+<parameter name="cancel_label">
+<parameter_description> text to go in the cancel button, or %NULL for the default
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkFileChooserNative
+
+</return>
+</function>
+
+<function name="gtk_file_chooser_native_set_accept_label">
+<description>
+Sets the custom label text for the accept button.
+
+If characters in @label are preceded by an underscore, they are underlined.
+If you need a literal underscore character in a label, use “__” (two
+underscores). The first underlined character represents a keyboard
+accelerator called a mnemonic.
+Pressing Alt and that key activates the button.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtFileChooserNative
+</parameter_description>
+</parameter>
+<parameter name="accept_label">
+<parameter_description> custom label or %NULL for the default
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_file_chooser_native_set_cancel_label">
+<description>
+Sets the custom label text for the cancel button.
+
+If characters in @label are preceded by an underscore, they are underlined.
+If you need a literal underscore character in a label, use “__” (two
+underscores). The first underlined character represents a keyboard
+accelerator called a mnemonic.
+Pressing Alt and that key activates the button.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtFileChooserNative
+</parameter_description>
+</parameter>
+<parameter name="cancel_label">
+<parameter_description> custom label or %NULL for the default
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_file_chooser_remove_filter">
 <description>
 Removes @filter from the list of filters that the user can select between.
@@ -45221,7 +46526,8 @@ Since: 3.12
 </parameter>
 </parameters>
 <return> the child widget, which will
-always be a #GtkFlowBoxChild
+always be a #GtkFlowBoxChild or %NULL in case no child widget
+with the given index exists.
 
 </return>
 </function>
@@ -45739,8 +47045,8 @@ and will continue to be called each time a child changes (via
 gtk_flow_box_child_changed()) and when gtk_flow_box_invalidate_sort()
 is called.
 
-+ * Note that using a sort function is incompatible with using a model
-+ * (see gtk_list_box_bind_model()).
+Note that using a sort function is incompatible with using a model
+(see gtk_flow_box_bind_model()).
 
 Since: 3.12
 
@@ -49336,9 +50642,7 @@ Since: 3.10
 </parameter_description>
 </parameter>
 </parameters>
-<return> the row index defining the global baseline
-
-</return>
+<return></return>
 </function>
 
 <function name="gtk_grid_set_column_homogeneous">
@@ -52631,6 +53935,12 @@ Looks up an icon and returns a #GtkIconInfo containing information
 such as the filename of the icon. The icon can then be rendered
 into a pixbuf using gtk_icon_info_load_icon().
 
+When rendering on displays with high pixel densities you should not
+use a @size multiplied by the scaling factor returned by functions
+like gdk_window_get_scale_factor(). Instead, you should use
+gtk_icon_theme_lookup_by_gicon_for_scale(), as the assets loaded
+for a given scaling factor may be different.
+
 Since: 2.14
 
 </description>
@@ -52705,6 +54015,12 @@ can then be rendered into a pixbuf using
 gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon()
 combines these two steps if all you need is the pixbuf.)
 
+When rendering on displays with high pixel densities you should not
+use a @size multiplied by the scaling factor returned by functions
+like gdk_window_get_scale_factor(). Instead, you should use
+gtk_icon_theme_lookup_icon_for_scale(), as the assets loaded
+for a given scaling factor may be different.
+
 Since: 2.4
 
 </description>
@@ -62140,6 +63456,264 @@ Since: 2.14
 <return></return>
 </function>
 
+<function name="gtk_native_dialog_destroy">
+<description>
+Destroys a dialog.
+
+When a dialog is destroyed, it will break any references it holds
+to other objects. If it is visible it will be hidden and any underlying
+window system resources will be destroyed.
+
+Note that this does not release any reference to the object (as opposed to
+destroying a GtkWindow) because there is no reference from the windowing
+system to the #GtkNativeDialog.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_dialog_get_modal">
+<description>
+Returns whether the dialog is modal. See gtk_native_dialog_set_modal().
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the dialog is set to be modal
+
+</return>
+</function>
+
+<function name="gtk_native_dialog_get_title">
+<description>
+Gets the title of the #GtkNativeDialog.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> the title of the dialog, or %NULL if none has
+been set explicitly. The returned string is owned by the widget
+and must not be modified or freed.
+
+</return>
+</function>
+
+<function name="gtk_native_dialog_get_transient_for">
+<description>
+Fetches the transient parent for this window. See
+gtk_native_dialog_set_transient_for().
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> the transient parent for this window, or %NULL
+if no transient parent has been set.
+
+</return>
+</function>
+
+<function name="gtk_native_dialog_get_visible">
+<description>
+Determines whether the dialog is visible.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the dialog is visible
+
+</return>
+</function>
+
+<function name="gtk_native_dialog_hide">
+<description>
+Hides the dialog if it is visilbe, aborting any interaction. Once this
+is called the  #GtkNativeDialog::response signal will not be emitted
+until after the next call to gtk_native_dialog_show().
+
+If the dialog is not visible this does nothing.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_dialog_run">
+<description>
+Blocks in a recursive main loop until @self emits the
+#GtkNativeDialog::response signal. It then returns the response ID
+from the ::response signal emission.
+
+Before entering the recursive main loop, gtk_native_dialog_run()
+calls gtk_native_dialog_show() on the dialog for you.
+
+After gtk_native_dialog_run() returns, then dialog will be hidden.
+
+Typical usage of this function might be:
+|[&lt;!-- language=&quot;C&quot; --&gt;
+gint result = gtk_native_dialog_run (GTK_NATIVE_DIALOG (dialog));
+switch (result)
+{
+case GTK_RESPONSE_ACCEPT:
+do_application_specific_something ();
+break;
+default:
+do_nothing_since_dialog_was_cancelled ();
+break;
+}
+g_object_unref (dialog);
+]|
+
+Note that even though the recursive main loop gives the effect of a
+modal dialog (it prevents the user from interacting with other
+windows in the same window group while the dialog is run), callbacks
+such as timeouts, IO channel watches, DND drops, etc, will
+be triggered during a gtk_nautilus_dialog_run() call.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> response ID
+
+</return>
+</function>
+
+<function name="gtk_native_dialog_set_modal">
+<description>
+Sets a dialog modal or non-modal. Modal dialogs prevent interaction
+with other windows in the same application. To keep modal dialogs
+on top of main application windows, use
+gtk_native_dialog_set_transient_for() to make the dialog transient for the
+parent; most [window managers][gtk-X11-arch]
+will then disallow lowering the dialog below the parent.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+<parameter name="modal">
+<parameter_description> whether the window is modal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_dialog_set_title">
+<description>
+Sets the title of the #GtkNativeDialog.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+<parameter name="title">
+<parameter_description> title of the dialog
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_dialog_set_transient_for">
+<description>
+Dialog windows should be set transient for the main application
+window they were spawned from. This allows
+[window managers][gtk-X11-arch] to e.g. keep the
+dialog on top of the main window, or center the dialog over the
+main window.
+
+Passing %NULL for @parent unsets the current transient window.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+<parameter name="parent">
+<parameter_description> parent window, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_native_dialog_show">
+<description>
+Shows the dialog on the display, allowing the user to interact with
+it. When the user accepts the state of the dialog the dialog will
+be automatically hidden and the #GtkNativeDialog::response signal
+will be emitted.
+
+Multiple calls while the dialog is visible will be ignored.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="self">
+<parameter_description> a #GtkNativeDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_notebook_append_page">
 <description>
 Appends a page to @notebook.
@@ -66896,9 +68470,7 @@ Since: 3.18
 </parameter_description>
 </parameter>
 </parameters>
-<return>
-
-</return>
+<return></return>
 </function>
 
 <function name="gtk_places_view_set_open_flags">
@@ -66940,7 +68512,6 @@ Since: 3.18
 Sets the search query of @view. The search is immediately performed
 once the query is set.
 
-
 </description>
 <parameters>
 <parameter name="view">
@@ -66952,8 +68523,7 @@ once the query is set.
 </parameter_description>
 </parameter>
 </parameters>
-<return>
-</return>
+<return></return>
 </function>
 
 <function name="gtk_plug_construct">
@@ -67193,6 +68763,25 @@ binding
 <return></return>
 </function>
 
+<function name="gtk_popover_get_constrain_to">
+<description>
+Returns the constraint for placing this popover.
+See gtk_popover_set_constrain_to().
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return> the constraint for placing this popover.
+
+</return>
+</function>
+
 <function name="gtk_popover_get_default_widget">
 <description>
 Gets the widget that should be set as the default while
@@ -67398,6 +68987,29 @@ Since: 3.12
 </return>
 </function>
 
+<function name="gtk_popover_set_constrain_to">
+<description>
+Sets a constraint for positioning this popover.
+
+Note that not all platforms support placing popovers freely,
+and may already impose constraints.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="constraint">
+<parameter_description> the new constraint
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_popover_set_default_widget">
 <description>
 Sets the widget that should be set as default widget while
@@ -76151,7 +77763,7 @@ Since: 3.0
 <description>
 Renders an arrow pointing to @angle.
 
-Typical arrow rendering at 0, 1&#47;2 &#8719;, &#8719; and 3&#47;2 &#8719;:
+Typical arrow rendering at 0, 1⁄2 π;, π; and 3⁄2 π:
 
 ![](arrows.png)
 
@@ -76542,6 +78154,13 @@ Since: 3.0
 <description>
 Renders the icon in @pixbuf at the specified @x and @y coordinates.
 
+This function will render the icon in @pixbuf at exactly its size,
+regardless of scaling factors, which may not be appropriate when
+drawing on displays with high pixel densities.
+
+You probably want to use gtk_render_icon_surface() instead, if you
+already have a Cairo surface.
+
 Since: 3.2
 
 </description>
@@ -77144,7 +78763,7 @@ Since: 2.14
 </parameter_description>
 </parameter>
 </parameters>
-<return> the minus button of the #GtkScaleButton
+<return> the minus button of the #GtkScaleButton as a #GtkButton
 
 </return>
 </function>
@@ -77162,7 +78781,7 @@ Since: 2.14
 </parameter_description>
 </parameter>
 </parameters>
-<return> the plus button of the #GtkScaleButton
+<return> the plus button of the #GtkScaleButton as a #GtkButton
 
 </return>
 </function>
@@ -79351,6 +80970,29 @@ Deprecated: 3.16: This function is not useful outside GTK+.
 <return></return>
 </function>
 
+<function name="gtk_settings_reset_property">
+<description>
+Undoes the effect of calling g_object_set() to install an
+application-specific value for a setting. After this call,
+the setting will again follow the session-wide value for
+this setting.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description> a #GtkSettings object
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the setting to reset
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_settings_set_double_property">
 <description>
 Deprecated: 3.16: Use g_object_set() instead.
@@ -80555,6 +82197,9 @@ Since: 3.10
 
 <function name="gtk_stack_get_interpolate_size">
 <description>
+Returns wether the #GtkStack is set up to interpolate between
+the sizes of childen on page switch.
+
 Since: 3.18
 
 </description>
@@ -80564,8 +82209,7 @@ Since: 3.18
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE If the #GtkStack is set up to interpolate between
-visible-child sizes, %FALSE otherwise.
+<return> %TRUE if child sizes are interpolated
 
 </return>
 </function>
@@ -80751,10 +82395,10 @@ Since: 3.10
 <function name="gtk_stack_set_interpolate_size">
 <description>
 Sets whether or not @stack will interpolate its size when
-changing the visible child. If the interpolate-size property
-is set to %TRUE, @stack will interpolate its size between
-the current one and the one it'll take after changing the visible-child,
-according to the set transition-duration.
+changing the visible child. If the #GtkStack::interpolate-size
+property is set to %TRUE, @stack will interpolate its size between
+the current one and the one it'll take after changing the
+visible child, according to the set transition duration.
 
 Since: 3.18
 
@@ -82575,6 +84219,27 @@ Deprecated: 3.16: Use gtk_render_border() instead.
 <return></return>
 </function>
 
+<function name="gtk_style_context_get_change">
+<description>
+Queries the context for the changes for the currently executing
+GtkStyleContext::invalidate signal. If no signal is currently
+emitted or the signal has not been triggered by a CssNode
+invalidation, this function returns %NULL.
+
+FIXME 4.0: Make this part of the signal.
+
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> the context to query
+</parameter_description>
+</parameter>
+</parameters>
+<return> %NULL or the currently invalidating changes
+</return>
+</function>
+
 <function name="gtk_style_context_get_color">
 <description>
 Gets the foreground color for a given state.
@@ -85700,6 +87365,8 @@ will automatically be destroyed upon test function teardown.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="window_title">
@@ -85725,6 +87392,8 @@ and set them up for destruction during the next test teardown phase.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget_type">
@@ -85761,6 +87430,8 @@ will automatically be destroyed upon test function teardown.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="window_title">
@@ -85950,6 +87621,8 @@ as passed in to gtk_test_slider_set_perc().
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -85972,6 +87645,8 @@ a value between the lower and upper limits, according to the
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -85994,6 +87669,8 @@ spin button’s value.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="spinner">
@@ -86021,6 +87698,8 @@ GtkEditable (entry and text widgets) or GtkTextView.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -86040,6 +87719,8 @@ GtkEditable (entry and text widgets) or GtkTextView.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -86068,6 +87749,8 @@ location, see gdk_test_simulate_button() for details.
 
 Since: 2.14
 
+Deprecated: 3.20: This testing infrastructure is phased out in favor of reftests.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -86999,10 +88682,15 @@ than the number of lines in the @buffer, the end iterator is returned.
 <function name="gtk_text_buffer_get_iter_at_line_index">
 <description>
 Obtains an iterator pointing to @byte_index within the given line.
- byte_index must be the start of a UTF-8 character, and must not be
-beyond the end of the line.  Note bytes, not
+ byte_index must be the start of a UTF-8 character. Note bytes, not
 characters; UTF-8 may encode one character as multiple bytes.
 
+Before the 3.20 version, it was not allowed to pass an invalid location.
+
+Since the 3.20 version, if @line_number is greater than the number of lines
+in the @buffer, the end iterator is returned. And if @byte_index is off the
+end of the line, the iterator at the end of the line is returned.
+
 </description>
 <parameters>
 <parameter name="buffer">
@@ -87027,10 +88715,14 @@ characters; UTF-8 may encode one character as multiple bytes.
 
 <function name="gtk_text_buffer_get_iter_at_line_offset">
 <description>
-Obtains an iterator pointing to @char_offset within the given
-line. The @char_offset must exist, offsets off the end of the line
-are not allowed. Note characters, not bytes;
-UTF-8 may encode one character as multiple bytes.
+Obtains an iterator pointing to @char_offset within the given line. Note
+characters, not bytes; UTF-8 may encode one character as multiple bytes.
+
+Before the 3.20 version, it was not allowed to pass an invalid location.
+
+Since the 3.20 version, if @line_number is greater than the number of lines
+in the @buffer, the end iterator is returned. And if @char_offset is off the
+end of the line, the iterator at the end of the line is returned.
 
 </description>
 <parameters>
@@ -88837,6 +90529,7 @@ words, unlike gtk_text_iter_ends_tag(), if gtk_text_iter_begins_tag() returns
 %TRUE, gtk_text_iter_has_tag() will also return %TRUE for the same
 parameters.
 
+Deprecated: 3.20: Use gtk_text_iter_starts_tag() instead.
 
 </description>
 <parameters>
@@ -89001,7 +90694,7 @@ is %NULL, returns %TRUE if any tag is toggled off at this point.
 Note that if gtk_text_iter_ends_tag() returns %TRUE, it means that @iter is
 at the end of the tagged range, but that the character
 at @iter is outside the tagged range. In other words,
-unlike gtk_text_iter_begins_tag(), if gtk_text_iter_ends_tag() returns %TRUE,
+unlike gtk_text_iter_starts_tag(), if gtk_text_iter_ends_tag() returns %TRUE,
 gtk_text_iter_has_tag() will return %FALSE for the same parameters.
 
 
@@ -90029,7 +91722,7 @@ range
 <function name="gtk_text_iter_has_tag">
 <description>
 Returns %TRUE if @iter points to a character that is part of a range tagged
-with @tag. See also gtk_text_iter_begins_tag() and gtk_text_iter_ends_tag().
+with @tag. See also gtk_text_iter_starts_tag() and gtk_text_iter_ends_tag().
 
 
 </description>
@@ -90356,6 +92049,35 @@ algorithms).
 </return>
 </function>
 
+<function name="gtk_text_iter_starts_tag">
+<description>
+Returns %TRUE if @tag is toggled on at exactly this point. If @tag
+is %NULL, returns %TRUE if any tag is toggled on at this point.
+
+Note that if gtk_text_iter_starts_tag() returns %TRUE, it means that @iter is
+at the beginning of the tagged range, and that the
+character at @iter is inside the tagged range. In other
+words, unlike gtk_text_iter_ends_tag(), if gtk_text_iter_starts_tag() returns
+%TRUE, gtk_text_iter_has_tag() will also return %TRUE for the same
+parameters.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="iter">
+<parameter_description> an iterator
+</parameter_description>
+</parameter>
+<parameter name="tag">
+<parameter_description> a #GtkTextTag, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @iter is the start of a range tagged with @tag
+</return>
+</function>
+
 <function name="gtk_text_iter_starts_word">
 <description>
 Determines whether @iter begins a natural-language word.  Word
@@ -90377,7 +92099,7 @@ algorithms).
 
 <function name="gtk_text_iter_toggles_tag">
 <description>
-This is equivalent to (gtk_text_iter_begins_tag() ||
+This is equivalent to (gtk_text_iter_starts_tag() ||
 gtk_text_iter_ends_tag()), i.e. it tells you whether a range with
 @tag applied to it begins or ends at @iter.
 
@@ -91012,6 +92734,30 @@ Marks are not visible by default.
 <return></return>
 </function>
 
+<function name="gtk_text_tag_changed">
+<description>
+Emits the #GtkTextTagTable::tag-changed signal on the #GtkTextTagTable where
+the tag is included.
+
+The signal is already emitted when setting a #GtkTextTag property. This
+function is useful for a #GtkTextTag subclass.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="tag">
+<parameter_description> a #GtkTextTag.
+</parameter_description>
+</parameter>
+<parameter name="size_changed">
+<parameter_description> whether the change affects the #GtkTextView layout.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_tag_event">
 <description>
 Emits the “event” signal on the #GtkTextTag.
@@ -104725,6 +106471,25 @@ Since: 2.2
 </return>
 </function>
 
+<function name="gtk_widget_class_get_css_name">
+<description>
+Gets the name used by this class for matching in CSS code. See
+gtk_widget_class_set_css_name() for details.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> class to set the name on
+</parameter_description>
+</parameter>
+</parameters>
+<return> the CSS name of the given class
+
+</return>
+</function>
+
 <function name="gtk_widget_class_install_style_property">
 <description>
 Installs a style property on a widget class. The parser for the
@@ -104912,6 +106677,29 @@ class finalization time, when no classes of type @widget_type are in use anymore
 <return></return>
 </function>
 
+<function name="gtk_widget_class_set_css_name">
+<description>
+Sets the name to be used for CSS matching of widgets.
+
+If this function is not called for a given class, the name
+of the parent class is used.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> class to set the name on
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> name to use
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_class_set_template">
 <description>
 This should be called at class initialization time to specify
@@ -105355,6 +107143,38 @@ for the #GtkWidget::draw function.
 </return>
 </function>
 
+<function name="gtk_widget_get_allocated_size">
+<description>
+Retrieves the widget’s allocated size.
+
+This function returns the last values passed to
+gtk_widget_size_allocate_with_baseline(). The value differs from
+the size returned in gtk_widget_get_allocation() in that functions
+like gtk_widget_set_halign() can adjust the allocation, but not
+the value returned by this function.
+
+If a widget is not visible, its allocated size is 0.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="allocation">
+<parameter_description> a pointer to a #GtkAllocation to copy to
+</parameter_description>
+</parameter>
+<parameter name="baseline">
+<parameter_description> a pointer to an integer to copy to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_get_allocated_width">
 <description>
 Returns the width that has currently been allocated to @widget.
@@ -105791,6 +107611,26 @@ widget.
 </return>
 </function>
 
+<function name="gtk_widget_get_focus_on_click">
+<description>
+Returns whether the widget should grab focus when it is clicked with the mouse.
+See gtk_widget_set_focus_on_click().
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the widget should grab focus when it is clicked with
+the mouse.
+
+</return>
+</function>
+
 <function name="gtk_widget_get_font_map">
 <description>
 Gets the font map that has been set with gtk_widget_set_font_map().
@@ -108593,6 +110433,29 @@ the position @pos in the widget hierarchy defined by
 </return>
 </function>
 
+<function name="gtk_widget_path_iter_get_object_name">
+<description>
+Returns the object name that is at position @pos in the widget
+hierarchy defined in @path.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #GtkWidgetPath
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> position to get the object name for, -1 for the path head
+</parameter_description>
+</parameter>
+</parameters>
+<return> the name or %NULL
+
+</return>
+</function>
+
 <function name="gtk_widget_path_iter_get_object_type">
 <description>
 Returns the object #GType that is at position @pos in the widget
@@ -108989,6 +110852,34 @@ Since: 3.0
 <return></return>
 </function>
 
+<function name="gtk_widget_path_iter_set_object_name">
+<description>
+Sets the object name for a given position in the widget hierarchy
+defined by @path.
+
+When set, the object name overrides the object type when matching
+CSS.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="path">
+<parameter_description> a #GtkWidgetPath
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> position to modify, -1 for the path head
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> object name to set or %NULL to unset
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_path_iter_set_object_type">
 <description>
 Sets the object type for a given position in the widget hierarchy
@@ -109198,6 +111089,27 @@ we have a more complete mechanism for composite children, see gtk_widget_class_s
 <return></return>
 </function>
 
+<function name="gtk_widget_queue_allocate">
+<description>
+This function is only for use in widget implementations.
+
+Flags the widget for a rerun of the GtkWidgetClass::size_allocate
+function. Use this function instead of gtk_widget_queue_resize()
+when the @widget's size request didn't change but it wants to
+reposition its contents.
+
+An example user of this function is gtk_widget_set_halign().
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_queue_compute_expand">
 <description>
 Mark @widget as needing to recompute its expand flags. Call
@@ -109323,6 +111235,20 @@ GtkWidgetClass::size_allocate will be silently ignored.
 <return></return>
 </function>
 
+<function name="gtk_widget_queue_resize_internal">
+<description>
+Queue a resize on a widget, and on all other widgets grouped with this widget.
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_queue_resize_no_redraw">
 <description>
 This function works like gtk_widget_queue_resize(),
@@ -109690,7 +111616,7 @@ GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE);
 
 fevent-&gt;focus_change.type = GDK_FOCUS_CHANGE;
 fevent-&gt;focus_change.in = TRUE;
-fevent-&gt;focus_change.window = gtk_widget_get_window (widget);
+fevent-&gt;focus_change.window = _gtk_widget_get_window (widget);
 if (fevent-&gt;focus_change.window != NULL)
 g_object_ref (fevent-&gt;focus_change.window);
 
@@ -110126,6 +112052,29 @@ box.
 <return></return>
 </function>
 
+<function name="gtk_widget_set_focus_on_click">
+<description>
+Sets whether the widget should grab focus when it is clicked with the mouse.
+Making mouse clicks not grab focus is useful in places like toolbars where
+you don’t want the keyboard focus removed from the main area of the
+application.
+
+Since: 3.20
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="focus_on_click">
+<parameter_description> whether the widget should grab focus when clicked with the mouse
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_set_font_map">
 <description>
 Sets the font map to use for Pango rendering. When not set, the widget
@@ -111835,8 +113784,8 @@ Since: 3.4
 </parameter_description>
 </parameter>
 </parameters>
-<return> the widget where the window is attached,
-or %NULL if the window is not attached to any widget.
+<return> the widget where the window
+is attached, or %NULL if the window is not attached to any widget.
 
 </return>
 </function>
@@ -111919,8 +113868,8 @@ used.
 
 <function name="gtk_window_get_default_widget">
 <description>
-Returns the default widget for @window. See gtk_window_set_default()
-for more details.
+Returns the default widget for @window. See
+gtk_window_set_default() for more details.
 
 Since: 2.14
 
@@ -111931,7 +113880,8 @@ Since: 2.14
 </parameter_description>
 </parameter>
 </parameters>
-<return> the default widget, or %NULL if there is none.
+<return> the default widget, or %NULL
+if there is none.
 
 </return>
 </function>
@@ -111988,7 +113938,8 @@ not be %TRUE for the widget.
 </parameter_description>
 </parameter>
 </parameters>
-<return> the currently focused widget, or %NULL if there is none.
+<return> the currently focused widget,
+or %NULL if there is none.
 </return>
 </function>
 
@@ -112156,7 +114107,7 @@ Since: 2.6
 </parameter_description>
 </parameter>
 </parameters>
-<return> the icon name or %NULL if the window has 
+<return> the icon name or %NULL if the window has
 no themed icon
 
 </return>
@@ -112352,8 +114303,7 @@ further explanation.
 </parameter>
 </parameters>
 <return> the role of the window if set, or %NULL. The
-returned is owned by the widget and must not be modified
-or freed.
+returned is owned by the widget and must not be modified or freed.
 </return>
 </function>
 
@@ -112418,6 +114368,13 @@ manager handles it. Also, the window manager can take the size
 of the window decorations/border into account, while your
 application cannot.
 
+Note 4: When using client side decorations, GTK+ will do its best to
+adjust the returned values to match the logical size of the window
+excluding the widgets added for client side decorations, but there
+is no garantee that the result will be totally accurate because
+these widgets depend on the theme and may not be realized or
+visible at the time gtk_window_get_size() is invoked.
+
 In any case, if you insist on application-specified window
 positioning, there’s still a better way than
 doing it yourself - gtk_window_set_position() will frequently
@@ -112528,8 +114485,8 @@ gtk_window_set_transient_for().
 </parameter_description>
 </parameter>
 </parameters>
-<return> the transient parent for this window, or %NULL
-if no transient parent has been set.
+<return> the transient parent for this
+window, or %NULL if no transient parent has been set.
 </return>
 </function>
 
@@ -113209,6 +115166,22 @@ gtk_window_set_default_size().
 
 Windows may not be resized smaller than 1 by 1 pixels.
 
+When using client side decorations, GTK+ will do its best to adjust
+the given size so that the resulting window size matches the
+requested size without the title bar, borders and shadows added for
+the client side decorations, but there is no garantee that the
+result will be totally accurate because these widgets added for
+client side decorations depend on the theme and may not be realized
+or visible at the time gtk_window_resize() is issued.
+
+Typically, gtk_window_resize() will compensate for the GtkHeaderBar
+height only if it's known at the time the resulting GtkWindow
+configuration is issued.
+For example, if new widgets are added after the GtkWindow configuration
+and cause the GtkHeaderBar to grow in height, this will result in a
+window content smaller that specified by gtk_window_resize() and not
+a larger window.
+
 
 </description>
 <parameters>
@@ -113256,6 +115229,9 @@ gtk_window_set_geometry_hints.
 
 Since: 3.0
 
+Deprecated: 3.20: This function does nothing. Use 
+gtk_window_resize() and compute the geometry yourself.
+
 </description>
 <parameters>
 <parameter name="window">
@@ -113705,7 +115681,6 @@ the user.  You can set a minimum and maximum size; allowed resize
 increments (e.g. for xterm, you can only resize by the size of a
 character); aspect ratios; and more. See the #GdkGeometry struct.
 
-
 </description>
 <parameters>
 <parameter name="window">
@@ -113713,7 +115688,9 @@ character); aspect ratios; and more. See the #GdkGeometry struct.
 </parameter_description>
 </parameter>
 <parameter name="geometry_widget">
-<parameter_description> widget the geometry hints will be applied to or %NULL
+<parameter_description> widget the geometry hints used to be applied to
+or %NULL. Since 3.18 this argument is ignored and GTK behaves as if %NULL was
+set.
 </parameter_description>
 </parameter>
 <parameter name="geometry">


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]