[gtkmm] Regenerate _docs.xml files.

[Murray Cumming <murrayc src gnome org>]

commit 143857fda14b7e5c33b6f7e52f61a40a68934f98
Author: Murray Cumming <murrayc murrayc com>
Date:   Thu Aug 20 12:41:04 2015 +0200

    Regenerate _docs.xml files.

 gdk/src/gdk_docs.xml |   10 ++-
 gtk/src/gtk_docs.xml |  207 +++++++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 206 insertions(+), 11 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 3eeaa8d..7d1c982 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -13188,7 +13188,10 @@ Since: 2.2
 <function name="gdk_screen_get_height_mm">
 <description>
 Returns the height of @screen in millimeters.
-Note that on some X servers this value will not be correct.
+
+Note that this value is somewhat ill-defined when the screen
+has multiple monitors of different resolution. It is recommended
+to use the monitor dimensions instead.
 
 Since: 2.2
 
@@ -13649,7 +13652,10 @@ Since: 2.2
 <function name="gdk_screen_get_width_mm">
 <description>
 Gets the width of @screen in millimeters.
-Note that on some X servers this value will not be correct.
+
+Note that this value is somewhat ill-defined when the screen
+has multiple monitors of different resolution. It is recommended
+to use the monitor dimensions instead.
 
 Since: 2.2
 
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index d0a348c..2c74fd1 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -16622,6 +16622,21 @@ The default bindings for this signal is Insert.
 <return></return>
 </signal>
 
+<property name="GtkTextView:bottom-margin">
+<description>
+The bottom margin for text in the text view.
+
+Note that this property is confusingly named. In CSS terms,
+the value set here is padding, and it is applied in addition
+to the padding from the theme.
+
+Don't confuse this property with #GtkWidget:margin-bottom.
+
+Since: 3.18
+
+</description>
+</property>
+
 <property name="GtkTextView:im-module">
 <description>
 Which IM (input method) module should be used for this text_view. 
@@ -16658,6 +16673,20 @@ Since: 3.6
 </description>
 </property>
 
+<property name="GtkTextView:left-margin">
+<description>
+The default left margin for text in the text view.
+Tags in the buffer may override the default.
+
+Note that this property is confusingly named. In CSS terms,
+the value set here is padding, and it is applied in addition
+to the padding from the theme.
+
+Don't confuse this property with #GtkWidget:margin-left.
+
+</description>
+</property>
+
 <property name="GtkTextView:populate-all">
 <description>
 If :populate-all is %TRUE, the #GtkTextView::populate-popup
@@ -16668,6 +16697,35 @@ Since: 3.8
 </description>
 </property>
 
+<property name="GtkTextView:right-margin">
+<description>
+The default right margin for text in the text view.
+Tags in the buffer may override the default.
+
+Note that this property is confusingly named. In CSS terms,
+the value set here is padding, and it is applied in addition
+to the padding from the theme.
+
+Don't confuse this property with #GtkWidget:margin-right.
+
+</description>
+</property>
+
+<property name="GtkTextView:top-margin">
+<description>
+The top margin for text in the text view.
+
+Note that this property is confusingly named. In CSS terms,
+the value set here is padding, and it is applied in addition
+to the padding from the theme.
+
+Don't confuse this property with #GtkWidget:margin-top.
+
+Since: 3.18
+
+</description>
+</property>
+
 <enum name="GtkTextViewLayer">
 <description>
 Used to reference the layers of #GtkTextView for the purpose of customized
@@ -44942,6 +45000,49 @@ Adds a widget to a #GtkFixed container at the given position.
 <return></return>
 </function>
 
+<function name="gtk_flow_box_bind_model">
+<description>
+Binds @model to @box.
+
+If @box was already bound to a model, that previous binding is
+destroyed.
+
+The contents of @box are cleared and then filled with widgets that
+represent items from @model. @box is updated whenever @model changes.
+If @model is %NULL, @box is left empty.
+
+It is undefined to add or remove widgets directly (for example, with
+gtk_flow_box_insert() or gtk_container_add()) while @box is bound to a
+model.
+
+Since: 3.18
+
+</description>
+<parameters>
+<parameter name="box">
+<parameter_description> a #GtkFlowBox
+</parameter_description>
+</parameter>
+<parameter name="model">
+<parameter_description> the #GListModel to be bound to @box
+</parameter_description>
+</parameter>
+<parameter name="create_widget_func">
+<parameter_description> a function that creates widgets for items
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> user data passed to @create_widget_func
+</parameter_description>
+</parameter>
+<parameter name="user_data_free_func">
+<parameter_description> function for freeing @user_data
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_flow_box_child_changed">
 <description>
 Marks @child as changed, causing any state that depends on this
@@ -91276,6 +91377,24 @@ gtk_text_view_set_border_window_size().
 </return>
 </function>
 
+<function name="gtk_text_view_get_bottom_margin">
+<description>
+Gets the bottom margin for text in the @text_view.
+
+Since: 3.18
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+</parameters>
+<return> bottom margin in pixels
+
+</return>
+</function>
+
 <function name="gtk_text_view_get_buffer">
 <description>
 Returns the #GtkTextBuffer being displayed by this text view.
@@ -91780,6 +91899,24 @@ tabs are used; must be freed with pango_tab_array_free().
 </return>
 </function>
 
+<function name="gtk_text_view_get_top_margin">
+<description>
+Gets the top margin for text in the @text_view.
+
+Since: 3.18
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+</parameters>
+<return> top margin in pixels
+
+</return>
+</function>
+
 <function name="gtk_text_view_get_vadjustment">
 <description>
 Gets the vertical-scrolling #GtkAdjustment.
@@ -92108,17 +92245,17 @@ within the visible area of the widget.
 <description>
 Scrolls @text_view so that @iter is on the screen in the position
 indicated by @xalign and @yalign. An alignment of 0.0 indicates
-left or top, 1.0 indicates right or bottom, 0.5 means center. 
-If @use_align is %FALSE, the text scrolls the minimal distance to 
-get the mark onscreen, possibly not scrolling at all. The effective 
-screen for purposes of this function is reduced by a margin of size 
+left or top, 1.0 indicates right or bottom, 0.5 means center.
+If @use_align is %FALSE, the text scrolls the minimal distance to
+get the mark onscreen, possibly not scrolling at all. The effective
+screen for purposes of this function is reduced by a margin of size
 @within_margin.
 
 Note that this function uses the currently-computed height of the
-lines in the text buffer. Line heights are computed in an idle 
-handler; so this function may not have the desired effect if it’s 
-called before the height computations. To avoid oddness, consider 
-using gtk_text_view_scroll_to_mark() which saves a point to be 
+lines in the text buffer. Line heights are computed in an idle
+handler; so this function may not have the desired effect if it’s
+called before the height computations. To avoid oddness, consider
+using gtk_text_view_scroll_to_mark() which saves a point to be
 scrolled to after line validation.
 
 
@@ -92137,7 +92274,7 @@ scrolled to after line validation.
 </parameter_description>
 </parameter>
 <parameter name="use_align">
-<parameter_description> whether to use alignment arguments (if %FALSE, 
+<parameter_description> whether to use alignment arguments (if %FALSE,
 just get the mark onscreen)
 </parameter_description>
 </parameter>
@@ -92248,6 +92385,29 @@ with #GTK_TEXT_WINDOW_WIDGET, #GTK_TEXT_WINDOW_TEXT, or
 <return></return>
 </function>
 
+<function name="gtk_text_view_set_bottom_margin">
+<description>
+Sets the bottom margin for text in @text_view.
+
+Note that this function is confusingly named.
+In CSS terms, the value set here is padding.
+
+Since: 3.18
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="bottom_margin">
+<parameter_description> bottom margin in pixels
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_view_set_buffer">
 <description>
 Sets @buffer as the buffer being displayed by @text_view. The previous
@@ -92397,6 +92557,9 @@ Tags in the view’s buffer may override the default.
 Sets the default left margin for text in @text_view.
 Tags in the buffer may override the default.
 
+Note that this function is confusingly named.
+In CSS terms, the value set here is padding.
+
 </description>
 <parameters>
 <parameter name="text_view">
@@ -92517,6 +92680,9 @@ tags in @text_view’s buffer.
 Sets the default right margin for text in the text view.
 Tags in the buffer may override the default.
 
+Note that this function is confusingly named.
+In CSS terms, the value set here is padding.
+
 </description>
 <parameters>
 <parameter name="text_view">
@@ -92550,6 +92716,29 @@ Tags in the buffer may override the default.
 <return></return>
 </function>
 
+<function name="gtk_text_view_set_top_margin">
+<description>
+Sets the top margin for text in @text_view.
+
+Note that this function is confusingly named.
+In CSS terms, the value set here is padding.
+
+Since: 3.18
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="top_margin">
+<parameter_description> top margin in pixels
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_view_set_wrap_mode">
 <description>
 Sets the line wrapping for the view.