[gtkmm] Regenerate *_docs.xml files.

[Murray Cumming <murrayc src gnome org>]

commit e130f83d25cdc6f67585dff9a740edb6aa0c0d09
Author: Murray Cumming <murrayc murrayc com>
Date:   Fri Mar 6 10:10:38 2015 +0100

    Regenerate *_docs.xml files.

 gtk/src/gtk_docs.xml |   87 ++++++++++++++++++++++++++++++++++++-------------
 1 files changed, 64 insertions(+), 23 deletions(-)
---
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 409ddbe..4be9ed3 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -49048,7 +49048,8 @@ representing the text in the label; useful to convert mouse events
 into coordinates inside the #PangoLayout, e.g. to take some action
 if some part of the label is clicked. Of course you will need to
 create a #GtkEventBox to receive the events, and pack the label
-inside it, since labels are a #GTK_NO_WINDOW widget. Remember
+inside it, since labels are windowless (they return %FALSE from
+gtk_widget_get_has_window()). Remember
 when using the #PangoLayout functions you need to convert to
 and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
 
@@ -51144,7 +51145,7 @@ Since: 3.14
 </description>
 <parameters>
 <parameter name="row">
-<parameter_description> a #GTkListBoxrow
+<parameter_description> a #GtkListBoxRow
 </parameter_description>
 </parameter>
 <parameter name="activatable">
@@ -54505,7 +54506,7 @@ direction, or %NULL
 <description>
 Sets the alignment of the widget.
 
-Deprecated: 3.14: Use #GtkWidget alignment and margin properties.
+Deprecated: 3.14: Use #GtkWidget's alignment (#GtkWidget:halign and #GtkWidget:valign) and margin properties 
or #GtkLabel's #GtkLabel:xalign and #GtkLabel:yalign properties.
 
 </description>
 <parameters>
@@ -59400,6 +59401,25 @@ Since: 3.12
 </return>
 </function>
 
+<function name="gtk_popover_get_transitions_enabled">
+<description>
+Returns whether show/hide transitions are enabled on this popover.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+</parameters>
+<return> #TRUE if the show and hide transitions of the given
+popover are enabled, #FALSE otherwise.
+
+</return>
+</function>
+
 <function name="gtk_popover_menu_new">
 <description>
 Creates a new popover menu.
@@ -59587,6 +59607,26 @@ Since: 3.12
 <return></return>
 </function>
 
+<function name="gtk_popover_set_transitions_enabled">
+<description>
+Sets whether show/hide transitions are enabled on this popover
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopover
+</parameter_description>
+</parameter>
+<parameter name="transitions_enabled">
+<parameter_description> Whether transitions are enabled
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_print_backend_get_printer_list">
 <description>
 Returns the current list of printers.
@@ -78011,7 +78051,8 @@ Since: 2.14
 This function will generate a @button click (button press and button
 release event) in the middle of the first GdkWindow found that belongs
 to @widget.
-For %GTK_NO_WINDOW widgets like GtkButton, this will often be an
+For windowless widgets like #GtkButton (which returns %FALSE from
+gtk_widget_get_has_window()), this will often be an
 input-only event window. For other widgets, this is usually widget-&gt;window.
 Certain caveats should be considered when using this function, in
 particular because the mouse pointer is warped to the button click
@@ -78043,7 +78084,8 @@ Since: 2.14
 <description>
 This function will generate keyboard press and release events in
 the middle of the first GdkWindow found that belongs to @widget.
-For %GTK_NO_WINDOW widgets like GtkButton, this will often be an
+For windowless widgets like #GtkButton (which returns %FALSE from
+gtk_widget_get_has_window()), this will often be an
 input-only event window. For other widgets, this is usually widget-&gt;window.
 Certain caveats should be considered when using this function, in
 particular because the mouse pointer is warped to the key press
@@ -96163,7 +96205,8 @@ Since: 3.0
 <function name="gtk_widget_add_events">
 <description>
 Adds the events in the bitfield @events to the event mask for
- widget  See gtk_widget_set_events() for details.
+ widget  See gtk_widget_set_events() and the
+[input handling overview][event-masks] for details.
 
 </description>
 <parameters>
@@ -97641,9 +97684,8 @@ Since: 2.18
 
 <function name="gtk_widget_get_events">
 <description>
-Returns the event mask for the widget (a bitfield containing flags
-from the #GdkEventMask enumeration). These are the events that the widget
-will receive.
+Returns the event mask (see #GdkEventMask) for the widget. These are the
+events that the widget will receive.
 
 Note: Internally, the widget event mask will be the logical OR of the event
 mask set through gtk_widget_set_events() or gtk_widget_add_events(), and the
@@ -98133,9 +98175,9 @@ created.
 <description>
 Obtains the location of the mouse pointer in widget coordinates.
 Widget coordinates are a bit odd; for historical reasons, they are
-defined as @widget-&gt;window coordinates for widgets that are not
-#GTK_NO_WINDOW widgets, and are relative to @widget-&gt;allocation.x,
- widget-&gt;allocation.y for widgets that are #GTK_NO_WINDOW widgets.
+defined as @widget-&gt;window coordinates for widgets that return %TRUE for
+gtk_widget_get_has_window(); and are relative to @widget-&gt;allocation.x,
+ widget-&gt;allocation.y otherwise.
 
 Deprecated: 3.4: Use gdk_window_get_device_position() instead.
 
@@ -101058,9 +101100,9 @@ the region created from the given coordinates.
 
 The region here is specified in widget coordinates.
 Widget coordinates are a bit odd; for historical reasons, they are
-defined as @widget-&gt;window coordinates for widgets that are not
-#GTK_NO_WINDOW widgets, and are relative to @widget-&gt;allocation.x,
- widget-&gt;allocation.y for widgets that are #GTK_NO_WINDOW widgets.
+defined as @widget-&gt;window coordinates for widgets that return %TRUE for
+gtk_widget_get_has_window(), and are relative to @widget-&gt;allocation.x,
+ widget-&gt;allocation.y otherwise.
 
 @width or @height may be 0, in this case this function does
 nothing. Negative values for @width and @height are not allowed.
@@ -101209,15 +101251,13 @@ cairo_region_intersect_rectangle() to get the same behavior.
 <parameter name="region">
 <parameter_description> a #cairo_region_t, in the same coordinate system as
 @widget-&gt;allocation. That is, relative to @widget-&gt;window
-for %NO_WINDOW widgets; relative to the parent window
-of @widget-&gt;window for widgets with their own window.
+for widgets which return %FALSE from gtk_widget_get_has_window();
+relative to the parent window of @widget-&gt;window otherwise.
 </parameter_description>
 </parameter>
 </parameters>
 <return> A newly allocated region holding the intersection of @widget
-and @region. The coordinates of the return value are relative to
- widget-&gt;window for %NO_WINDOW widgets, and relative to the parent
-window of @widget-&gt;window for widgets with their own window.
+and @region.
 
 </return>
 </function>
@@ -101470,8 +101510,8 @@ Since: 3.0
 Very rarely-used function. This function is used to emit
 an expose event on a widget. This function is not normally used
 directly. The only time it is used is when propagating an expose
-event to a child %NO_WINDOW widget, and that is normally done
-using gtk_container_propagate_draw().
+event to a windowless child widget (gtk_widget_get_has_window() is %FALSE),
+and that is normally done using gtk_container_propagate_draw().
 
 If you want to force an area of a window to be redrawn,
 use gdk_window_invalidate_rect() or gdk_window_invalidate_region().
@@ -101820,7 +101860,8 @@ changing the event mask you may disrupt a widget’s functionality,
 so be careful. This function must be called while a widget is
 unrealized. Consider gtk_widget_add_device_events() for widgets that are
 already realized, or if you want to preserve the existing event
-mask. This function can’t be used with #GTK_NO_WINDOW widgets;
+mask. This function can’t be used with windowless widgets (which return
+%FALSE from gtk_widget_get_has_window());
 to get events on those widgets, place them inside a #GtkEventBox
 and receive events on the event box.