[gtkmm] Regenerated *.docs.xml

From: Murray Cumming <murrayc src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtkmm] Regenerated *.docs.xml
Date: Fri, 11 Oct 2013 10:20:03 +0000 (UTC)
commit e98158faefd917ce448b4446a67ea2ed617469c6
Author: Murray Cumming <murrayc murrayc com>
Date:   Fri Oct 11 11:23:58 2013 +0200

    Regenerated *.docs.xml

 gdk/src/gdk_docs.xml |  103 +++++++++---
 gtk/src/gtk_docs.xml |  444 ++++++++++++++++++++------------------------------
 2 files changed, 255 insertions(+), 292 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 2d09c30..033076f 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -3297,7 +3297,9 @@ Since: 3.10
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> a new cairo surface, must be freed with cairo_surface_destroy()
+
+</return>
 </function>
 
 <function name="gdk_color_copy">
@@ -5988,6 +5990,7 @@ set of actions changes.
 
 This function is called by the drag source.
 
+
 </description>
 <parameters>
 <parameter name="context">
@@ -6024,7 +6027,8 @@ gdk_drag_find_window()
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return>
+</return>
 </function>
 
 <function name="gdk_drag_status">
@@ -14057,6 +14061,60 @@ Since: 2.22
 </return>
 </function>
 
+<function name="gdk_wayland_device_get_wl_keyboard">
+<description>
+Returns the Wayland wl_keyboard of a #GdkDevice
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #GdkDevice
+</parameter_description>
+</parameter>
+</parameters>
+<return> a Wayland wl_keyboard
+
+</return>
+</function>
+
+<function name="gdk_wayland_device_get_wl_pointer">
+<description>
+Returns the Wayland wl_pointer of a #GdkDevice
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #GdkDevice
+</parameter_description>
+</parameter>
+</parameters>
+<return> a Wayland wl_pointer
+
+</return>
+</function>
+
+<function name="gdk_wayland_device_get_wl_seat">
+<description>
+Returns the Wayland wl_seat of a #GdkDevice
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="device">
+<parameter_description> a #GdkDevice
+</parameter_description>
+</parameter>
+</parameters>
+<return> a Wayland wl_seat
+
+</return>
+</function>
+
 <function name="gdk_wayland_display_broadcast_startup_message">
 <description>
 Sends a startup notification message of type @message_type to
@@ -14188,7 +14246,7 @@ Marks a #GdkWindow as a custom Wayland surface. The application is
 expected to register the surface as some type of surface using
 some Wayland interface.
 
-Agood example would be writing a panel or on-screen-keyboard as an
+A good example would be writing a panel or on-screen-keyboard as an
 out-of-process helper - as opposed to having those in the compositor
 process. In this case the underlying surface isn't a wl_shell
 surface and the panel or OSK client need to identify the wl_surface
@@ -14236,21 +14294,6 @@ Since: 3.10
 <return></return>
 </function>
 
-<function name="gdk_wayland_window_update_size">
-<description>
-Updates the state of the drawable (in particular the drawable's
-cairo surface) when its size has changed.
-
-</description>
-<parameters>
-<parameter name="drawable">
-<parameter_description> a #GdkDrawableImplWayland.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gdk_window_add_filter">
 <description>
 Adds an event filter to @window, allowing you to intercept events
@@ -15098,8 +15141,8 @@ list of child windows inside @window
 
 <function name="gdk_window_get_children_with_user_data">
 <description>
-Gets the list of children of @window known to GDK with a particular
- user_data set on it.
+Gets the list of children of @window known to GDK with a
+particular @user_data set on it.
 
 The returned list must be freed, but the elements in the
 list need not be.
@@ -15116,7 +15159,7 @@ Since: 3.10
 </parameter_description>
 </parameter>
 <parameter name="user_data">
-<parameter_description> 
+<parameter_description> user data to look for
 </parameter_description>
 </parameter>
 </parameters>
@@ -19180,6 +19223,24 @@ will be newly created, if one doesn't exist already.
 </return>
 </function>
 
+<function name="gdk_x11_window_get_desktop">
+<description>
+Gets the number of the workspace @window is on.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current workspace of @window
+
+</return>
+</function>
+
 <function name="gdk_x11_window_get_xid">
 <description>
 Returns the X resource (window) belonging to a #GdkWindow.
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 87af221..e4c21c0 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -1562,6 +1562,10 @@ and store @new_text at the position indicated by @path.
 <description>
 The ::toggled signal is emitted when the cell is toggled. 
 
+It is the responsibility of the application to update the model
+with the correct value to store at @path.  Often this is simply the
+opposite of the value currently stored at @path.
+
 </description>
 <parameters>
 <parameter name="cell_renderer">
@@ -6990,6 +6994,8 @@ change to make in gtk_spin_button_spin().
 These enumeration values describe the possible transitions
 between pages in a #GtkStack widget.
 
+New values may be added to this enumeration over time.
+
 </description>
 <parameters>
 <parameter name="GTK_STACK_TRANSITION_TYPE_NONE">
@@ -9536,6 +9542,9 @@ signal is expected to process the received data and then call
 gtk_drag_finish(), setting the @success parameter depending on
 whether the data was processed successfully.
 
+Applications must create some means to determine why the signal was emitted 
+and therefore whether to call gdk_drag_status() or gtk_drag_finish(). 
+
 The handler may inspect the selected action with
 gdk_drag_context_get_selected_action() before calling
 gtk_drag_finish(), e.g. to implement %GDK_ACTION_ASK as
@@ -9715,7 +9724,12 @@ Since: 2.12
 The ::drag-leave signal is emitted on the drop site when the cursor
 leaves the widget. A typical reason to connect to this signal is to
 undo things done in #GtkWidget::drag-motion, e.g. undo highlighting
-with gtk_drag_unhighlight()
+with gtk_drag_unhighlight().
+
+
+Likewise, the #GtkWidget::drag-leave signal is also emitted before the 
+::drag-drop signal, for instance to allow cleaning up of a preview item  
+created in the #GtkWidget::drag-motion signal handler.
 
 </description>
 <parameters>
@@ -11537,7 +11551,7 @@ Since: 2.6
 </parameter_description>
 </parameter>
 <parameter name="copyright">
-<parameter_description> (allow-none) the copyright string
+<parameter_description> the copyright string
 </parameter_description>
 </parameter>
 </parameters>
@@ -12767,6 +12781,9 @@ gtk_accelerator_parse() but handles keycodes as well. This is only
 useful for system-level components, applications should use
 gtk_accelerator_parse() instead.
 
+If @accelerator_codes is given and the result stored in it is non-%NULL,
+the result must be freed with g_free().
+
 If a keycode is present in the accelerator and no @accelerator_codes
 is given, the parse will fail.
 
@@ -12787,8 +12804,8 @@ keyval, or %NULL
 </parameter_description>
 </parameter>
 <parameter name="accelerator_codes">
-<parameter_description> return location for accelerator
-keycodes, or %NULL
+<parameter_description>
+return location for accelerator keycodes, or %NULL
 </parameter_description>
 </parameter>
 <parameter name="accelerator_mods">
@@ -26962,6 +26979,10 @@ gtk_grid_attach() as an alternative to gtk_container_add() in
 those cases. A widget may be added to only one container at a time;
 you can't place the same widget inside two different containers.
 
+Note that some containers, such as #GtkScrolledWindow or #GtkListBox,
+may add intermediate children between the added widget and the
+container.
+
 </description>
 <parameters>
 <parameter name="container">
@@ -27348,8 +27369,6 @@ of the container, but were added by the container implementation
 itself.  Most applications should use gtk_container_foreach(),
 rather than gtk_container_forall().
 
-Virtual: forall
-
 </description>
 <parameters>
 <parameter name="container">
@@ -27540,8 +27559,6 @@ from the toplevel down to and including @child.
 <description>
 Returns the resize mode for the container. See
 gtk_container_set_resize_mode ().
-
-
 </description>
 <parameters>
 <parameter name="container">
@@ -27550,6 +27567,7 @@ gtk_container_set_resize_mode ().
 </parameter>
 </parameters>
 <return> the current resize mode
+
 </return>
 </function>
 
@@ -27791,7 +27809,6 @@ Sets the resize mode for the container.
 The resize mode of a container determines whether a resize request
 will be passed to the container's parent, queued for later execution
 or executed immediately.
-
 </description>
 <parameters>
 <parameter name="container">
@@ -28744,10 +28761,6 @@ to @sizes.
 
 <function name="gtk_drag_begin">
 <description>
-This is equivalent to gtk_drag_begin_with_coordinates(), passing -1, -1
-as coordinates.
-
-Deprecated: 3.10: Use gtk_drag_begin_with_coordinates() instead.
 
 </description>
 <parameters>
@@ -28773,9 +28786,7 @@ source can provide the data.
 </parameter_description>
 </parameter>
 </parameters>
-<return> the context for this drag.
-
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_begin_with_coordinates">
@@ -28849,10 +28860,6 @@ the current pointer position.
 
 <function name="gtk_drag_check_threshold">
 <description>
-Checks to see if a mouse drag starting at (@start_x, @start_y) and ending
-at (@current_x, @current_y) has passed the GTK+ drag threshold, and thus
-should trigger the beginning of a drag-and-drop operation.
-
 
 </description>
 <parameters>
@@ -28877,19 +28884,11 @@ should trigger the beginning of a drag-and-drop operation.
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE if the drag threshold has been passed.
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_dest_add_image_targets">
 <description>
-Add the image targets supported by #GtkSelection to
-the target list of the drag destination. The targets
-are added with @info = 0. If you need another value, 
-use gtk_target_list_add_image_targets() and
-gtk_drag_dest_set_target_list().
-
-Since: 2.6
 
 </description>
 <parameters>
@@ -28903,13 +28902,6 @@ Since: 2.6
 
 <function name="gtk_drag_dest_add_text_targets">
 <description>
-Add the text targets supported by #GtkSelection to
-the target list of the drag destination. The targets
-are added with @info = 0. If you need another value, 
-use gtk_target_list_add_text_targets() and
-gtk_drag_dest_set_target_list().
-
-Since: 2.6
 
 </description>
 <parameters>
@@ -28923,13 +28915,6 @@ Since: 2.6
 
 <function name="gtk_drag_dest_add_uri_targets">
 <description>
-Add the URI targets supported by #GtkSelection to
-the target list of the drag destination. The targets
-are added with @info = 0. If you need another value, 
-use gtk_target_list_add_uri_targets() and
-gtk_drag_dest_set_target_list().
-
-Since: 2.6
 
 </description>
 <parameters>
@@ -28943,14 +28928,6 @@ Since: 2.6
 
 <function name="gtk_drag_dest_find_target">
 <description>
-Looks for a match between the supported targets of @context and the
- dest_target_list, returning the first matching target, otherwise
-returning %GDK_NONE. @dest_target_list should usually be the return
-value from gtk_drag_dest_get_target_list(), but some widgets may
-have different valid targets for different parts of the widget; in
-that case, they will have to implement a drag_motion handler that
-passes the correct target list to this function.
-
 
 </description>
 <parameters>
@@ -28968,16 +28945,11 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 </parameters>
-<return> first target that the source offers
-and the dest can accept, or %GDK_NONE
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_dest_get_target_list">
 <description>
-Returns the list of targets this widget can accept from
-drag-and-drop.
-
 
 </description>
 <parameters>
@@ -28986,16 +28958,11 @@ drag-and-drop.
 </parameter_description>
 </parameter>
 </parameters>
-<return> the #GtkTargetList, or %NULL if none
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_dest_get_track_motion">
 <description>
-Returns whether the widget has been configured to always
-emit #GtkWidget::drag-motion signals.
-
-Since: 2.10
 
 </description>
 <parameters>
@@ -29004,53 +28971,11 @@ Since: 2.10
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE if the widget always emits
-#GtkWidget::drag-motion events
-
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_dest_set">
 <description>
-Sets a widget as a potential drop destination, and adds default behaviors.
-
-The default behaviors listed in @flags have an effect similar
-to installing default handlers for the widget's drag-and-drop signals
-(#GtkWidget::drag-motion, #GtkWidget::drag-drop, ...). They all exist
-for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is
-sufficient to connect to the widget's #GtkWidget::drag-data-received
-signal to get primitive, but consistent drag-and-drop support.
-
-Things become more complicated when you try to preview the dragged data,
-as described in the documentation for #GtkWidget::drag-motion. The default
-behaviors described by @flags make some assumptions, that can conflict
-with your own signal handlers. For instance #GTK_DEST_DEFAULT_DROP causes
-invokations of gdk_drag_status() in the context of #GtkWidget::drag-motion,
-and invokations of gtk_drag_finish() in #GtkWidget::drag-data-received.
-Especially the later is dramatic, when your own #GtkWidget::drag-motion
-handler calls gtk_drag_get_data() to inspect the dragged data.
-
-There's no way to set a default action here, you can use the
-#GtkWidget::drag-motion callback for that. Here's an example which selects
-the action to use depending on whether the control key is pressed or not:
-|[
-static void
-drag_motion (GtkWidget *widget,
-GdkDragContext *context,
-gint x,
-gint y,
-guint time)
-{
-GdkModifierType mask;
-
-gdk_window_get_pointer (gtk_widget_get_window (widget),
-NULL, NULL, &amp;mask);
-if (mask &amp; GDK_CONTROL_MASK)
-gdk_drag_status (context, GDK_ACTION_COPY, time);
-else
-gdk_drag_status (context, GDK_ACTION_MOVE, time);
-}
-]|
 
 </description>
 <parameters>
@@ -29083,7 +29008,6 @@ and gtk_drag_dest_find_target().
 
 <function name="gtk_drag_dest_set_proxy">
 <description>
-Sets this widget as a proxy for drops to another window.
 
 </description>
 <parameters>
@@ -29112,9 +29036,6 @@ subwindow.
 
 <function name="gtk_drag_dest_set_target_list">
 <description>
-Sets the target types that this widget can accept from drag-and-drop.
-The widget must first be made into a drag destination with
-gtk_drag_dest_set().
 
 </description>
 <parameters>
@@ -29132,14 +29053,6 @@ gtk_drag_dest_set().
 
 <function name="gtk_drag_dest_set_track_motion">
 <description>
-Tells the widget to emit #GtkWidget::drag-motion and
-#GtkWidget::drag-leave events regardless of the targets and the
-%GTK_DEST_DEFAULT_MOTION flag.
-
-This may be used when a widget wants to do generic
-actions regardless of the targets that the source offers.
-
-Since: 2.10
 
 </description>
 <parameters>
@@ -29157,9 +29070,6 @@ Since: 2.10
 
 <function name="gtk_drag_dest_unset">
 <description>
-Clears information about a drop destination set with
-gtk_drag_dest_set(). The widget will no longer receive
-notification of drags.
 
 </description>
 <parameters>
@@ -29173,8 +29083,6 @@ notification of drags.
 
 <function name="gtk_drag_finish">
 <description>
-Informs the drag source that the drop is finished, and
-that the data of the drag will no longer be required.
 
 </description>
 <parameters>
@@ -29201,14 +29109,6 @@ original data. (This should be %TRUE for a move)
 
 <function name="gtk_drag_get_data">
 <description>
-Gets the data associated with a drag. When the data
-is received or the retrieval fails, GTK+ will emit a
-#GtkWidget::drag-data-received signal. Failure of the retrieval
-is indicated by the length field of the @selection_data
-signal parameter being negative. However, when gtk_drag_get_data()
-is called implicitely because the %GTK_DEST_DEFAULT_DROP was set,
-then the widget will not receive notification of failed
-drops.
 
 </description>
 <parameters>
@@ -29237,8 +29137,6 @@ or #GtkWidget::drag-drop&quot; signal.
 
 <function name="gtk_drag_get_source_widget">
 <description>
-Determines the source widget for a drag.
-
 
 </description>
 <parameters>
@@ -29247,18 +29145,11 @@ Determines the source widget for a drag.
 </parameter_description>
 </parameter>
 </parameters>
-<return> if the drag is occurring
-within a single application, a pointer to the source widget.
-Otherwise, %NULL.
-</return>
+<return></return>
 </function>
 
 <function name="gtk_drag_highlight">
 <description>
-Draws a highlight around a widget. This will attach
-handlers to #GtkWidget::draw, so the highlight
-will continue to be displayed until gtk_drag_unhighlight()
-is called.
 
 </description>
 <parameters>
@@ -29381,8 +29272,6 @@ with a  context for the source side of a drag)
 <description>
 Sets the icon for a given drag from a stock ID.
 
-Deprecated: 3.10: Use gtk_drag_set_icon_name() instead.
-
 </description>
 <parameters>
 <parameter name="context">
@@ -29464,13 +29353,6 @@ signal and destroy it yourself.
 
 <function name="gtk_drag_source_add_image_targets">
 <description>
-Add the writable image targets supported by #GtkSelection 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>
@@ -29504,13 +29386,6 @@ Since: 2.6
 
 <function name="gtk_drag_source_add_uri_targets">
 <description>
-Add the URI targets supported by #GtkSelection 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>
@@ -29524,10 +29399,6 @@ 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>
@@ -29536,15 +29407,11 @@ Since: 2.4
 </parameter_description>
 </parameter>
 </parameters>
-<return> the #GtkTargetList, or %NULL if none
-
-</return>
+<return></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>
@@ -29617,9 +29484,6 @@ 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>
@@ -29638,9 +29502,7 @@ release it when it is no longer needed.
 <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.
-
-Deprecated: 3.10: Use gtk_drag_source_set_icon_name() instead.
+to a stock icon. 
 
 </description>
 <parameters>
@@ -29658,11 +29520,6 @@ Deprecated: 3.10: Use gtk_drag_source_set_icon_name() instead.
 
 <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>
@@ -29680,7 +29537,6 @@ Since: 2.4
 
 <function name="gtk_drag_source_unset">
 <description>
-Undoes the effects of gtk_drag_source_set().
 
 </description>
 <parameters>
@@ -29694,8 +29550,6 @@ Undoes the effects of gtk_drag_source_set().
 
 <function name="gtk_drag_unhighlight">
 <description>
-Removes a highlight set by gtk_drag_highlight() from
-a widget.
 
 </description>
 <parameters>
@@ -29844,8 +29698,6 @@ are those from @start_pos to the end of the text.
 
 Note that the positions are specified in characters, not bytes.
 
-Virtual: do_delete_text
-
 </description>
 <parameters>
 <parameter name="editable">
@@ -29967,8 +29819,6 @@ widget, at position @position.
 Note that the position is in characters, not in bytes. 
 The function updates @position to point after the newly inserted text.
 
-Virtual: do_insert_text
-
 </description>
 <parameters>
 <parameter name="editable">
@@ -30016,8 +29866,6 @@ the end of the text.
 
 Note that positions are specified in characters, not bytes.
 
-Virtual: set_selection_bounds
-
 </description>
 <parameters>
 <parameter name="editable">
@@ -35196,6 +35044,7 @@ Adds a widget to a #GtkFixed container at the given position.
 <return></return>
 </function>
 
+
 <function name="gtk_font_button_get_font_name">
 <description>
 Retrieves the name of the currently selected font. This name includes
@@ -37750,7 +37599,9 @@ an additional detail to help him identify the current view.
 
 Note that GtkHeaderBar always reserves room for the subtitle, even
 if none is currently set. If this is not desired, use
-gtk_header_bar_set_custom_title().
+gtk_header_bar_set_custom_title() to place your own label in the
+title position. To achieve the same style, use the &quot;title&quot; style
+class.
 
 Since: 3.10
 
@@ -40447,8 +40298,8 @@ Since: 3.10
 </parameter_description>
 </parameter>
 </parameters>
-<return> a #GtkIconInfo structure containing 
-information about the icon, or %NULL if the icon 
+<return> a #GtkIconInfo structure containing
+information about the icon, or %NULL if the icon
 wasn't found. Unref with g_object_unref()
 
 </return>
@@ -48091,6 +47942,9 @@ The created menu items are connected to actions found in the
 by means of being attached to a widget (see gtk_menu_attach_to_widget())
 that is contained within the #GtkApplicationWindows widget hierarchy.
 
+Actions can also be added using gtk_widget_insert_action_group() on the menu's
+attach widget or on any of its parent widgets.
+
 Since: 3.4
 
 </description>
@@ -53423,6 +53277,24 @@ the file chooser starts them with the keyboard shortcut &quot;Alt-1&quot;.
 </return>
 </function>
 
+<function name="gtk_places_sidebar_get_open_flags">
+<description>
+Gets the open flags.
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a #GtkPlacesSidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GtkPlacesOpenFlags of @sidebar
+
+</return>
+</function>
+
 <function name="gtk_places_sidebar_get_show_connect_to_server">
 <description>
 Returns the value previously set with gtk_places_sidebar_set_show_connect_to_server()
@@ -53461,6 +53333,8 @@ Since: 3.10
 
 <function name="gtk_places_sidebar_list_shortcuts">
 <description>
+Gets the list of shortcuts.
+
 Since: 3.10
 
 </description>
@@ -53470,8 +53344,9 @@ Since: 3.10
 </parameter_description>
 </parameter>
 </parameters>
-<return> A #GSList of #GFile of the locations
-that have been added as application-specific shortcuts with gtk_places_sidebar_add_shortcut().
+<return>
+A #GSList of #GFile of the locations that have been added as
+application-specific shortcuts with gtk_places_sidebar_add_shortcut().
 To free this list, you can use
 |[
 g_slist_free_full (list, (GDestroyNotify) g_object_unref);
@@ -53482,14 +53357,20 @@ g_slist_free_full (list, (GDestroyNotify) g_object_unref);
 
 <function name="gtk_places_sidebar_new">
 <description>
-Creates a new #GtkPlacesSidebar widget.  The application should connect
-to at least the #GtkPlacesSidebar::open-location signal to be notified
+Creates a new #GtkPlacesSidebar widget.
+
+The application should connect to at least the
+#GtkPlacesSidebar::open-location signal to be notified
 when the user makes a selection in the sidebar.
 
+Since: 3.10
+
 </description>
 <parameters>
 </parameters>
-<return></return>
+<return> a newly created #GtkPlacesSidebar
+
+</return>
 </function>
 
 <function name="gtk_places_sidebar_remove_shortcut">
@@ -60722,7 +60603,8 @@ Since: 2.10
 </parameter_description>
 </parameter>
 <parameter name="length">
-<parameter_description> return location for a the length of the URI list, or %NULL
+<parameter_description> return location for a the length of the
+URI list, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
@@ -63181,6 +63063,20 @@ Since: 3.10
 </return>
 </function>
 
+<function name="gtk_revealer_new">
+<description>
+Creates a new #GtkRevealer.
+
+Since: 3.10
+
+</description>
+<parameters>
+</parameters>
+<return> a newly created #GtkRevealer
+
+</return>
+</function>
+
 <function name="gtk_revealer_set_reveal_child">
 <description>
 Tells the #GtkRevealer to reveal or conceal its child.
@@ -68718,14 +68614,10 @@ Since: 3.0
 <function name="gtk_style_context_invalidate">
 <description>
 Invalidates @context style information, so it will be reconstructed
-again.
-
-If you're using a #GtkStyleContext returned from
-gtk_widget_get_style_context(), you do not need to
-call this yourself.
+again. It is useful if you modify the @context and need the new
+information immediately.
 
 Since: 3.0
-
 </description>
 <parameters>
 <parameter name="context">
@@ -71058,8 +70950,8 @@ Looks up a given target in a #GtkTargetList.
 </parameter_description>
 </parameter>
 <parameter name="info">
-<parameter_description> a pointer to the location to store application info for target,
-or %NULL
+<parameter_description> a pointer to the location to store
+application info for target, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
@@ -71839,8 +71731,8 @@ Adds the mark at position @where. The mark must not be added to
 another buffer, and if its name is not %NULL then there must not
 be another mark in the buffer with the same name.
 
-Emits the &quot;mark-set&quot; signal as notification of the mark's initial
-placement.
+Emits the #GtkTextBuffer::mark-set signal as notification of the mark's
+initial placement.
 
 Since: 2.12
 
@@ -72065,8 +71957,8 @@ reference to the returned #GtkTextMark, so you can ignore the
 return value if you like. Marks are owned by the buffer and go 
 away when the buffer does.
 
-Emits the &quot;mark-set&quot; signal as notification of the mark's initial
-placement.
+Emits the #GtkTextBuffer::mark-set signal as notification of the mark's
+initial placement.
 
 
 </description>
@@ -72223,7 +72115,7 @@ if the mark isn't freed, most operations on @mark become
 invalid, until it gets added to a buffer again with 
 gtk_text_buffer_add_mark(). Use gtk_text_mark_get_deleted() to  
 find out if a mark has been removed from its buffer.
-The &quot;mark-deleted&quot; signal will be emitted as notification after 
+The #GtkTextBuffer::mark-deleted signal will be emitted as notification after
 the mark is deleted.
 
 </description>
@@ -72584,7 +72476,8 @@ Obtains the location of @anchor within @buffer.
 
 <function name="gtk_text_buffer_get_iter_at_line">
 <description>
-Initializes @iter to the start of the given line.
+Initializes @iter to the start of the given line. If @line_number is greater
+than the number of lines in the @buffer, the end iterator is returned.
 
 </description>
 <parameters>
@@ -73307,8 +73200,8 @@ to pass in tag names instead of tag objects.
 
 <function name="gtk_text_buffer_move_mark">
 <description>
-Moves @mark to the new location @where. Emits the &quot;mark-set&quot; signal
-as notification of the move.
+Moves @mark to the new location @where. Emits the #GtkTextBuffer::mark-set
+signal as notification of the move.
 
 </description>
 <parameters>
@@ -73369,10 +73262,13 @@ Creates a new text buffer.
 
 <function name="gtk_text_buffer_paste_clipboard">
 <description>
-Pastes the contents of a clipboard at the insertion point, or
-at @override_location. (Note: pasting is asynchronous, that is,
-we'll ask for the paste data and return, and at some point later
-after the main loop runs, the paste data will be inserted.)
+Pastes the contents of a clipboard. If @override_location is %NULL, the
+pasted text will be inserted at the cursor position, or the buffer selection
+will be replaced if the selection is non-empty.
+
+Note: pasting is asynchronous, that is, we'll ask for the paste data and
+return, and at some point later after the main loop runs, the paste data will
+be inserted.
 
 </description>
 <parameters>
@@ -73385,8 +73281,7 @@ after the main loop runs, the paste data will be inserted.)
 </parameter_description>
 </parameter>
 <parameter name="override_location">
-<parameter_description> location to insert pasted text, or %NULL for
-at the cursor
+<parameter_description> location to insert pasted text, or %NULL
 </parameter_description>
 </parameter>
 <parameter name="default_editable">
@@ -76645,7 +76540,7 @@ i.e. using g_object_set().
 
 <function name="gtk_text_tag_set_priority">
 <description>
-Sets the priority of a #GtkTextTag. Valid priorities are
+Sets the priority of a #GtkTextTag. Valid priorities
 start at 0 and go to one less than gtk_text_tag_table_get_size().
 Each tag in a table has a unique priority; setting the priority
 of one tag shifts the priorities of all the other tags in the
@@ -83381,7 +83276,6 @@ The array should not be freed.
 
 Since: 3.0
 
-
 </description>
 <parameters>
 <parameter name="path">
@@ -89919,6 +89813,57 @@ Since: 3.10
 <return></return>
 </function>
 
+<function name="gtk_widget_class_bind_template_child_full">
+<description>
+Automatically assign an object declared in the class template XML to be set to a location
+on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_automated_child().
+
+The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member)
+for @struct_offset,  or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).
+
+An explicit strong reference will be held automatically for the duration of your
+instance's life cycle, it will be released automatically when #GObjectClass.dispose() runs
+on your instance and if a @struct_offset that is != 0 is specified, then the automatic location
+in your instance public or private data will be set to %NULL. You can however access an automated child
+pointer the first time your classes #GObjectClass.dispose() runs, or alternatively in
+#GtkWidgetClass.destroy().
+
+If @internal_child is specified, #GtkBuildableIface.get_internal_child() will be automatically
+implemented by the #GtkWidget class so there is no need to implement it manually.
+
+The wrapper macros gtk_widget_class_bind_template_child(), gtk_widget_class_bind_template_child_internal(),
+gtk_widget_class_bind_template_child_private() and gtk_widget_class_bind_private_template_child_internal()
+might be more convenient to use.
+
+&lt;note&gt;&lt;para&gt;This must be called from a composite widget classes class
+initializer after calling gtk_widget_class_set_template()&lt;/para&gt;&lt;/note&gt;
+
+Since: 3.10
+
+</description>
+<parameters>
+<parameter name="widget_class">
+<parameter_description> A #GtkWidgetClass
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> The &quot;id&quot; of the child defined in the template XML
+</parameter_description>
+</parameter>
+<parameter name="internal_child">
+<parameter_description> Whether the child should be accessible as an &quot;internal-child&quot;
+when this class is used in GtkBuilder XML
+</parameter_description>
+</parameter>
+<parameter name="struct_offset">
+<parameter_description> The structure offset into the composite widget's instance public or private structure
+where the automated child pointer should be set, or 0 to not assign the pointer.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_widget_class_bind_template_child_internal">
 <description>
 Binds a child widget defined in a template to the @widget_class, and
@@ -90014,57 +89959,6 @@ Since: 3.10
 <return></return>
 </function>
 
-<function name="gtk_widget_class_bind_template_child_private_full">
-<description>
-Automatically assign an object declared in the class template XML to be set to a location
-on a freshly built instance's private data, or alternatively accessible via gtk_widget_get_automated_child().
-
-The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member)
-for @struct_offset,  or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).
-
-An explicit strong reference will be held automatically for the duration of your
-instance's life cycle, it will be released automatically when #GObjectClass.dispose() runs
-on your instance and if a @struct_offset that is &gt;= 0 is specified, then the automatic location
-in your instance private data will be set to %NULL. You can however access an automated child
-pointer the first time your classes #GObjectClass.dispose() runs, or alternatively in
-#GtkWidgetClass.destroy().
-
-If @internal_child is specified, #GtkBuildableIface.get_internal_child() will be automatically
-implemented by the #GtkWidget class so there is no need to implement it manually.
-
-The wrapper macros gtk_widget_class_bind_template_child(), gtk_widget_class_bind_template_child_internal(),
-gtk_widget_class_bind_template_child_private() and gtk_widget_class_bind_private_template_child_internal()
-might be more convenient to use.
-
-&lt;note&gt;&lt;para&gt;This must be called from a composite widget classes class
-initializer after calling gtk_widget_class_set_template()&lt;/para&gt;&lt;/note&gt;
-
-Since: 3.10
-
-</description>
-<parameters>
-<parameter name="widget_class">
-<parameter_description> A #GtkWidgetClass
-</parameter_description>
-</parameter>
-<parameter name="name">
-<parameter_description> The &quot;id&quot; of the child defined in the template XML
-</parameter_description>
-</parameter>
-<parameter name="internal_child">
-<parameter_description> Whether the child should be accessible as an &quot;internal-child&quot;
-when this class is used in GtkBuilder XML
-</parameter_description>
-</parameter>
-<parameter name="struct_offset">
-<parameter_description> The structure offset into the composite widget's instance public or private structure
-where the automated child pointer should be set, or -1 to not assign the pointer.
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
 <function name="gtk_widget_class_find_style_property">
 <description>
 Finds a style property of a widget class by name.
@@ -91140,6 +91034,11 @@ Since: 3.8
 <description>
 Gets the value of the #GtkWidget:halign property.
 
+For backwards compatibility reasons this method will never return
+%GTK_ALIGN_BASELINE, but instead it will convert it to
+%GTK_ALIGN_FILL. Baselines are not supported for horizontal
+alignment.
+
 
 </description>
 <parameters>
@@ -92628,6 +92527,9 @@ Inserts @group into @widget. Children of @widget that implement
 setting their 'action-name' to
 @prefix.&lt;replaceable&gt;action-name&lt;/replaceable&gt;.
 
+If @group is %NULL, a previously inserted group for @name is removed
+from @widget.
+
 Since: 3.6
 
 </description>
@@ -92641,7 +92543,7 @@ Since: 3.6
 </parameter_description>
 </parameter>
 <parameter name="group">
-<parameter_description> a #GActionGroup
+<parameter_description> a #GActionGroup, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]