[gtkmm] Regenerated C documentation XML files.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerated C documentation XML files.
- Date: Fri, 19 Mar 2010 09:46:04 +0000 (UTC)
commit 0ed8da59422f2c4c5e138c2e8ab1407c680acda5
Author: Murray Cumming <murrayc murrayc com>
Date: Fri Mar 19 10:12:33 2010 +0100
Regenerated C documentation XML files.
* gdk/src/gdk_docs.xml:
* gtk/src/gtk_docs.xml: Regenerated.
ChangeLog | 7 +
gdk/src/gdk_docs.xml | 1131 +++++++++++++++++++++++++++-----------
gdk/src/gdk_methods.defs | 2 +-
gtk/src/gtk_docs.xml | 1394 ++++++++++++++++++++++++++++------------------
4 files changed, 1663 insertions(+), 871 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 628b7e2..6f8f4b8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2010-03-19 Murray Cumming <murrayc murrayc com>
+
+ Regenerated C documentation XML files.
+
+ * gdk/src/gdk_docs.xml:
+ * gtk/src/gtk_docs.xml: Regenerated.
+
2010-03-18 Murray Cumming <murrayc murrayc com>
Demo: Fix use of deprecated API.
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index c5813c5..5460878 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -20,7 +20,7 @@ relation to the baseline. See gdk_text_extents().
</parameters>
<return> the height of the character in pixels.
-Deprecated: Use gdk_text_extents() instead.
+Deprecated: 2.2: Use gdk_text_extents() instead.
</return>
</function>
@@ -80,7 +80,7 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> an Xlib <type>Screen*</type>
+<return> (transfer none): an Xlib <type>Screen*</type>
the screen of a #GdkScreen.
Since: 2.2
@@ -242,6 +242,39 @@ function is obsolete. See gdk_colormap_free_colors().
<return></return>
</function>
+<function name="gdk_pixmap_create_from_xpm">
+<description>
+Create a pixmap from a XPM file.
+
+
+</description>
+<parameters>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable, used to determine default values
+for the new pixmap.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> (out) a pointer to a place to store a bitmap representing
+the transparency mask of the XPM file. Can be %NULL,
+in which case transparency will be ignored.
+</parameter_description>
+</parameter>
+<parameter name="transparent_color">
+<parameter_description> the color to be used for the pixels
+that are transparent in the input file. Can be %NULL,
+in which case a default color will be used.
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> the filename of a file containing XPM data.
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the #GdkPixmap
+</return>
+</function>
+
<function name="gdk_x11_cursor_get_xcursor">
<description>
Return value: an Xlib <type>Cursor</type>.
@@ -461,6 +494,8 @@ parent window. Most windows should use this default.
<description>
Deprecated function; use g_object_unref() instead.
+Deprecated: 2.2: Use g_object_unref() instead.
+
</description>
<parameters>
<parameter name="context">
@@ -488,7 +523,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="gc">
-<parameter_description> the new GC to use for drawing, or %NULL
+<parameter_description> (allow-none): the new GC to use for drawing, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -608,7 +643,7 @@ of the #GdkPixbufFormat structs returned by gdk_pixbuf_get_formats().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an allocated #GError, or %NULL to ignore errors
+<parameter_description> (allow-none): return location for an allocated #GError, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -638,7 +673,7 @@ display, @parent must be specified.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> a #GdkWindow, or %NULL to create the window as a child of
+<parameter_description> (allow-none): a #GdkWindow, or %NULL to create the window as a child of
the default root window for the default display.
</parameter_description>
</parameter>
@@ -651,7 +686,7 @@ the default root window for the default display.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GdkWindow
+<return> (transfer none): the new #GdkWindow
</return>
</function>
@@ -689,6 +724,8 @@ Deprecated function; use g_object_ref() instead.
</parameter>
</parameters>
<return> the colormap
+
+Deprecated: 2.0: Use g_object_ref() instead.
</return>
</function>
@@ -722,6 +759,8 @@ add a reference to it.
</parameter>
</parameters>
<return> The offscreen pixmap, or %NULL if not offscreen
+
+Since: 2.18
</return>
</function>
@@ -1015,7 +1054,7 @@ See gdk_pixbuf_save() for more details.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -1156,16 +1195,16 @@ Since: 2.6
<function name="gdk_screen_get_n_monitors">
<description>
-Returns: number of monitors which @screen consists of.
+Returns: number of monitors which @screen consists of
</description>
<parameters>
<parameter name="screen">
-<parameter_description> a #GdkScreen.
+<parameter_description> a #GdkScreen
</parameter_description>
</parameter>
</parameters>
-<return> number of monitors which @screen consists of.
+<return> number of monitors which @screen consists of
Since: 2.2
</return>
@@ -1261,6 +1300,38 @@ is %GDK_TILED.
<return></return>
</function>
+<function name="gdk_gc_set_line_attributes">
+<description>
+Sets various attributes of how lines are drawn. See
+the corresponding members of #GdkGCValues for full
+explanations of the arguments.
+
+</description>
+<parameters>
+<parameter name="gc">
+<parameter_description> a #GdkGC.
+</parameter_description>
+</parameter>
+<parameter name="line_width">
+<parameter_description> the width of lines.
+</parameter_description>
+</parameter>
+<parameter name="line_style">
+<parameter_description> the dash-style for lines.
+</parameter_description>
+</parameter>
+<parameter name="cap_style">
+<parameter_description> the manner in which the ends of lines are drawn.
+</parameter_description>
+</parameter>
+<parameter name="join_style">
+<parameter_description> the in which lines are joined together.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_x11_gc_get_xgc">
<description>
Return value: an Xlib <type>GC</type>.
@@ -1526,7 +1597,7 @@ You should make no assumptions about the initial reference count.
<description>
Removes a reference from an animation.
-Deprecated: Use g_object_unref().
+Deprecated: 2.0: Use g_object_unref().
</description>
<parameters>
@@ -1611,7 +1682,7 @@ is oriented correctly.
<return> A newly-created pixbuf, or a reference to the
input pixbuf (with an increased reference count).
-Since 2.12
+Since: 2.12
</return>
</function>
@@ -1704,6 +1775,39 @@ and locates the value in the array for a given axis use.
</return>
</function>
+<function name="gdk_pixmap_create_from_xpm_d">
+<description>
+Create a pixmap from data in XPM format.
+
+
+</description>
+<parameters>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable, used to determine default values
+for the new pixmap.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> (out): Pointer to a place to store a bitmap representing
+the transparency mask of the XPM file. Can be %NULL,
+in which case transparency will be ignored.
+</parameter_description>
+</parameter>
+<parameter name="transparent_color">
+<parameter_description> This color will be used for the pixels
+that are transparent in the input file. Can be %NULL
+in which case a default color will be used.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Pointer to a string containing the XPM data.
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the #GdkPixmap.
+</return>
+</function>
+
<function name="gdk_color_white">
<description>
Return value: %TRUE if the allocation succeeded.
@@ -1933,11 +2037,11 @@ is gtk_widget_create_pango_layout().
</parameter_description>
</parameter>
<parameter name="foreground">
-<parameter_description> foreground override color, or %NULL for none
+<parameter_description> (allow-none): foreground override color, or %NULL for none
</parameter_description>
</parameter>
<parameter name="background">
-<parameter_description> background override color, or %NULL for none
+<parameter_description> (allow-none): background override color, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -1957,7 +2061,7 @@ Return value: The same pixbuf as @dest if it was non-%NULL, or a newly-created
</description>
<parameters>
<parameter name="dest">
-<parameter_description> Destination pixbuf, or %NULL if a new pixbuf should be created.
+<parameter_description> (allow-none): Destination pixbuf, or %NULL if a new pixbuf should be created.
</parameter_description>
</parameter>
<parameter name="src">
@@ -2191,7 +2295,7 @@ Return value: an Xlib <type>Display*</type>.
<description>
Removes a reference from a pixbuf.
-Deprecated: Use g_object_unref().
+Deprecated: 2.0: Use g_object_unref().
</description>
<parameters>
@@ -2319,6 +2423,8 @@ window coordinates. This is similar to
gdk_window_get_origin() but allows you go pass
in any position in the window, not just the origin.
+Since: 2.18
+
</description>
<parameters>
<parameter name="window">
@@ -2350,6 +2456,8 @@ in any position in the window, not just the origin.
The ::from-embedder signal is emitted to translate coordinates
in the embedder of an offscreen window to the offscreen window.
+See also #GtkWindow::to-embedder.
+
Since: 2.18
</description>
@@ -2411,7 +2519,7 @@ Gets the default colormap for @screen.
</parameter_description>
</parameter>
</parameters>
-<return> the default #GdkColormap.
+<return> (transfer none): the default #GdkColormap.
Since: 2.2
</return>
@@ -2526,11 +2634,11 @@ device coordinates.
</parameter_description>
</parameter>
<parameter name="foreground">
-<parameter_description> foreground override color, or %NULL for none
+<parameter_description> (allow-none): foreground override color, or %NULL for none
</parameter_description>
</parameter>
<parameter name="background">
-<parameter_description> background override color, or %NULL for none
+<parameter_description> (allow-none): background override color, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -2539,12 +2647,16 @@ device coordinates.
<function name="gdk_window_geometry_changed">
<description>
+This function informs GDK that the geometry of an embedded
+offscreen window has changed. This is necessary for GDK to keep
+track of which offscreen window the pointer is in.
+
Since: 2.18
</description>
<parameters>
<parameter name="window">
-<parameter_description> a #GdkWindow
+<parameter_description> an embedded offscreen #GdkWindow
</parameter_description>
</parameter>
</parameters>
@@ -2578,7 +2690,7 @@ range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE.
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the timeout is removed, or %NULL
+<parameter_description> (allow-none): function to call when the timeout is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -2629,7 +2741,7 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="gc">
-<parameter_description> a #GdkGC, used for clipping, or %NULL
+<parameter_description> (allow-none): a #GdkGC, used for clipping, or %NULL
</parameter_description>
</parameter>
<parameter name="pixbuf">
@@ -2720,18 +2832,18 @@ likely to change in future releases of GDK.
</parameter_description>
</parameter>
<parameter name="real_drawable">
-<parameter_description> location to store the drawable to which drawing should be
+<parameter_description> (out): location to store the drawable to which drawing should be
done.
</parameter_description>
</parameter>
<parameter name="x_offset">
-<parameter_description> location to store the X offset between coordinates in @window,
+<parameter_description> (out): location to store the X offset between coordinates in @window,
and the underlying window system primitive coordinates for
* real_drawable
</parameter_description>
</parameter>
<parameter name="y_offset">
-<parameter_description> location to store the Y offset between coordinates in @window,
+<parameter_description> (out): location to store the Y offset between coordinates in @window,
and the underlying window system primitive coordinates for
* real_drawable
</parameter_description>
@@ -2888,10 +3000,10 @@ an event structure.
<function name="gdk_screen_get_monitor_geometry">
<description>
-Retrieves the #GdkRectangle representing the size and position of
+Retrieves the #GdkRectangle representing the size and position of
the individual monitor within the entire screen area.
-Note that the size of the entire screen area can be retrieved via
+Note that the size of the entire screen area can be retrieved via
gdk_screen_get_width() and gdk_screen_get_height().
Since: 2.2
@@ -2899,11 +3011,11 @@ Since: 2.2
</description>
<parameters>
<parameter name="screen">
-<parameter_description> a #GdkScreen.
+<parameter_description> a #GdkScreen
</parameter_description>
</parameter>
<parameter name="monitor_num">
-<parameter_description> the monitor number.
+<parameter_description> the monitor number, between 0 and gdk_screen_get_n_monitors (screen)
</parameter_description>
</parameter>
<parameter name="dest">
@@ -3424,6 +3536,8 @@ This value is owned by the GC and must not be freed.
<description>
Deprecated function; use g_object_ref() instead.
+Deprecated: 2.2: Use g_object_ref() instead.
+
</description>
<parameters>
<parameter name="context">
@@ -3541,7 +3655,7 @@ if the unmap is being done by this client.)
<function name="gdk_screen_get_monitor_height_mm">
<description>
-Gets the height in millimeters of the specified monitor.
+Gets the height in millimeters of the specified monitor.
</description>
@@ -3551,7 +3665,7 @@ Gets the height in millimeters of the specified monitor.
</parameter_description>
</parameter>
<parameter name="monitor_num">
-<parameter_description> number of the monitor
+<parameter_description> number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
</parameter_description>
</parameter>
</parameters>
@@ -3591,11 +3705,11 @@ The array returned by this function should not be freed.
</description>
<parameters>
<parameter name="depths">
-<parameter_description> return location for available depths
+<parameter_description> (out) (array): return location for available depths
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> return location for number of available depths
+<parameter_description> (out): return location for number of available depths
</parameter_description>
</parameter>
</parameters>
@@ -3681,6 +3795,36 @@ Since: 2.4
</return>
</function>
+<function name="gdk_keymap_map_virtual_modifiers">
+<description>
+Maps the virtual modifiers (i.e. Super, Hyper and Meta) which
+are set in @state to their non-virtual counterparts (i.e. Mod2,
+Mod3,...) and set the corresponding bits in @state.
+
+This function is useful when matching key events against
+accelerators.
+
+
+</description>
+<parameters>
+<parameter name="keymap">
+<parameter_description> a #GdkKeymap
+</parameter_description>
+</parameter>
+<parameter name="state">
+<parameter_description> pointer to the modifier state to map
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if no virtual modifiers were mapped to the
+same non-virtual modifier. Note that %FALSE is also returned
+if a virtual modifier is mapped to a non-virtual modifier that
+was already set in @state.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gdk_color_to_string">
<description>
Return value: a newly-allocated text string
@@ -3838,7 +3982,7 @@ API instead.
<function name="gdk_visual_get_system">
<description>
-Get the system'sdefault visual for the default GDK screen.
+Get the system's default visual for the default GDK screen.
This is the visual for the root window of the display.
The return value should not be freed.
@@ -3846,7 +3990,7 @@ The return value should not be freed.
</description>
<parameters>
</parameters>
-<return> system visual
+<return> (transfer none): system visual
</return>
</function>
@@ -3986,7 +4130,7 @@ Since: 2.2
<description>
Draws a number of characters in the given font or fontset.
-Deprecated: Use gdk_draw_layout() instead.
+Deprecated: 2.4: Use gdk_draw_layout() instead.
</description>
<parameters>
@@ -4022,28 +4166,30 @@ Deprecated: Use gdk_draw_layout() instead.
<return></return>
</function>
-<function name="gdk_drawable_get_size">
+<function name="gdk_keymap_add_virtual_modifiers">
<description>
-Fills * width and * height with the size of @drawable.
- width or @height can be %NULL if you only want the other one.
+Adds virtual modifiers (i.e. Super, Hyper and Meta) which correspond
+to the real modifiers (i.e Mod2, Mod3, ...) in @modifiers.
+are set in @state to their non-virtual counterparts (i.e. Mod2,
+Mod3,...) and set the corresponding bits in @modifiers.
-On the X11 platform, if @drawable is a #GdkWindow, the returned
-size is the size reported in the most-recently-processed configure
-event, rather than the current size on the X server.
+GDK already does this before delivering key events, but for
+compatibility reasons, it only sets the first virtual modifier
+it finds, whereas this function sets all matching virtual modifiers.
+This function is useful when matching key events against
+accelerators.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="drawable">
-<parameter_description> a #GdkDrawable
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> location to store drawable's width, or %NULL
+<parameter name="keymap">
+<parameter_description> a #GdkKeymap
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> location to store drawable's height, or %NULL
+<parameter name="modifiers">
+<parameter_description> pointer to the modifier mask to change
</parameter_description>
</parameter>
</parameters>
@@ -4096,6 +4242,43 @@ to another, the colormaps should match.
<return></return>
</function>
+<function name="gdk_pixmap_colormap_create_from_xpm_d">
+<description>
+Create a pixmap from data in XPM format using a particular
+colormap.
+
+</description>
+<parameters>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable, used to determine default values
+for the new pixmap. Can be %NULL if @colormap is given.
+</parameter_description>
+</parameter>
+<parameter name="colormap">
+<parameter_description> the #GdkColormap that the new pixmap will be use.
+If omitted, the colormap for @window will be used.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> a pointer to a place to store a bitmap representing
+the transparency mask of the XPM file. Can be %NULL,
+in which case transparency will be ignored.
+</parameter_description>
+</parameter>
+<parameter name="transparent_color">
+<parameter_description> the color to be used for the pixels
+that are transparent in the input file. Can be %NULL,
+in which case a default color will be used.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> Pointer to a string containing the XPM data.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_window_begin_paint_region">
<description>
Indicates that you are beginning the process of redrawing @region.
@@ -4166,10 +4349,41 @@ Adds a reference to a pixbuf.
</parameters>
<return> The same as the @pixbuf argument.
-Deprecated: Use g_object_ref().
+Deprecated: 2.0: Use g_object_ref().
</return>
</function>
+<function name="gdk_window_clear_area">
+<description>
+Clears an area of @window to the background color or background pixmap.
+
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> x coordinate of rectangle to clear
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> y coordinate of rectangle to clear
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> width of rectangle to clear
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> height of rectangle to clear
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_window_get_parent">
<description>
Obtains the parent of @window, as known to GDK. Does not query the
@@ -4641,7 +4855,7 @@ Since: 2.4
<description>
Decrement the reference count of @gc.
-Deprecated: Use g_object_unref() instead.
+Deprecated: 2.0: Use g_object_unref() instead.
</description>
<parameters>
@@ -4861,7 +5075,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> shape mask, or %NULL
+<parameter_description> (allow-none): shape mask, or %NULL
</parameter_description>
</parameter>
<parameter name="x">
@@ -5089,7 +5303,7 @@ This function is called by the drag source.
</parameter_description>
</parameter>
<parameter name="targets">
-<parameter_description> the list of offered targets.
+<parameter_description> the offered targets, as list of #GdkAtom<!-- -->s
</parameter_description>
</parameter>
</parameters>
@@ -5301,7 +5515,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the color to use, or %NULL to unset a previously
+<parameter_description> (allow-none): the color to use, or %NULL to unset a previously
set override color.
</parameter_description>
</parameter>
@@ -5370,6 +5584,7 @@ Gets the colormap for @drawable, if one is set; returns
<description>
Deprecated function; use g_object_unref() instead.
+Deprecated: 2.0: Use g_object_unref() instead.
</description>
<parameters>
@@ -5414,6 +5629,44 @@ Gets the event mask for @window. See gdk_window_set_events().
</return>
</function>
+<function name="gdk_pixmap_colormap_create_from_xpm">
+<description>
+Create a pixmap from a XPM file using a particular colormap.
+
+
+</description>
+<parameters>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable, used to determine default values
+for the new pixmap. Can be %NULL if @colormap is given.
+</parameter_description>
+</parameter>
+<parameter name="colormap">
+<parameter_description> the #GdkColormap that the new pixmap will be use.
+If omitted, the colormap for @window will be used.
+</parameter_description>
+</parameter>
+<parameter name="mask">
+<parameter_description> a pointer to a place to store a bitmap representing
+the transparency mask of the XPM file. Can be %NULL,
+in which case transparency will be ignored.
+</parameter_description>
+</parameter>
+<parameter name="transparent_color">
+<parameter_description> the color to be used for the pixels
+that are transparent in the input file. Can be %NULL,
+in which case a default color will be used.
+</parameter_description>
+</parameter>
+<parameter name="filename">
+<parameter_description> the filename of a file containing XPM data.
+</parameter_description>
+</parameter>
+</parameters>
+<return> (transfer none): the #GdkPixmap.
+</return>
+</function>
+
<function name="gdk_pixbuf_simple_anim_add_frame">
<description>
Adds a new frame to @animation. The @pixbuf must
@@ -5648,7 +5901,7 @@ For example in the X backend, a native pixmap handle is an Xlib
</parameter_description>
</parameter>
</parameters>
-<return> the #GdkWindow wrapper for the native window,
+<return> the #GdkPixmap wrapper for the native pixmap,
or %NULL if there is none.
</return>
</function>
@@ -5843,7 +6096,7 @@ Therefore, you can not use this function to scroll a pixbuf.
<function name="gdk_display_manager_get_default_display">
<description>
-Gets the default #GdkDisplay.
+Gets the default #GdkDisplay.
</description>
@@ -5853,7 +6106,7 @@ Gets the default #GdkDisplay.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDisplay, or %NULL if there is no default
+<return> (transfer none): a #GdkDisplay, or %NULL if there is no default
display.
Since: 2.2
@@ -5874,7 +6127,7 @@ Adds a reference to an animation.
</parameters>
<return> The same as the @animation argument.
-Deprecated: Use g_object_ref().
+Deprecated: 2.0: Use g_object_ref().
</return>
</function>
@@ -6037,7 +6290,7 @@ The array returned in @rectangles must be freed with g_free().
</parameter_description>
</parameter>
<parameter name="rectangles">
-<parameter_description> return location for an array of rectangles
+<parameter_description> (array length=n_rectangles) (transfer container): return location for an array of rectangles
</parameter_description>
</parameter>
<parameter name="n_rectangles">
@@ -6255,7 +6508,9 @@ Since: 2.14
<function name="gdk_colormap_unref">
<description>
-Deprecated function; use g_object_ref() instead.
+Deprecated function; use g_object_unref() instead.
+
+Deprecated: 2.0: Use g_object_unref() instead.
</description>
<parameters>
@@ -6498,6 +6753,25 @@ The values are UTF-8 encoded strings. The PNG compression level can
be specified using the "compression" parameter; it's value is in an
integer in the range of [0,9].
+ICC color profiles can also be embedded into PNG and TIFF images.
+The "icc-profile" value should be the complete ICC profile encoded
+into base64.
+
+<informalexample><programlisting>
+gchar *contents;
+gchar *contents_encode;
+gsize length;
+g_file_get_contents ("/home/hughsie/.color/icc/L225W.icm", &contents, &length, NULL);
+contents_encode = g_base64_encode ((const guchar *) contents, length);
+gdk_pixbuf_save (pixbuf, handle, "png", &error,
+"icc-profile", contents_encode,
+NULL);
+</programlisting></informalexample>
+
+TIFF images recognize a "compression" option which acceps an integer value.
+Among the codecs are 1 None, 2 Huffman, 5 LZW, 7 JPEG and 8 Deflate, see
+the libtiff documentation and tiff.h for all supported codec values.
+
ICO images can be saved in depth 16, 24, or 32, by using the "depth"
parameter. When the ICO saver is given "x_hot" and "y_hot" parameters,
it produces a CUR instead of an ICO.
@@ -6518,7 +6792,7 @@ it produces a CUR instead of an ICO.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -6577,7 +6851,7 @@ reasonable.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL to ignore errors
+<parameter_description> (allow-none): return location for a #GError, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -6599,7 +6873,7 @@ gdk_window_invalidate_region() for details.
</parameter_description>
</parameter>
<parameter name="rect">
-<parameter_description> rectangle to invalidate or %NULL to invalidate the whole
+<parameter_description> (allow-none): rectangle to invalidate or %NULL to invalidate the whole
window
</parameter_description>
</parameter>
@@ -6611,6 +6885,32 @@ window
<return></return>
</function>
+<function name="gdk_pixbuf_simple_anim_new">
+<description>
+Creates a new, empty animation.
+
+
+</description>
+<parameters>
+<parameter name="width">
+<parameter_description> the width of the animation
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the height of the animation
+</parameter_description>
+</parameter>
+<parameter name="rate">
+<parameter_description> the speed of the animation, in frames per second
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated #GdkPixbufSimpleAnim
+
+Since: 2.8
+</return>
+</function>
+
<function name="gdk_rectangle_intersect">
<description>
Calculates the intersection of two rectangles. It is allowed for
@@ -6632,7 +6932,7 @@ pass %NULL for @dest.
</parameter_description>
</parameter>
<parameter name="dest">
-<parameter_description> return location for the intersection of @src1 and @src2, or %NULL
+<parameter_description> (allow-none): return location for the intersection of @src1 and @src2, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6645,8 +6945,8 @@ pass %NULL for @dest.
The ::monitors-changed signal is emitted when the number, size
or position of the monitors attached to the screen change.
-Only for X for now. Future implementations for Win32 and
-OS X may be a possibility.
+Only for X11 and OS X for now. A future implementation for Win32
+may be a possibility.
Since: 2.14
@@ -6660,31 +6960,27 @@ Since: 2.14
<return></return>
</function>
-<function name="gdk_window_clear_area">
+<function name="gdk_device_get_state">
<description>
-Clears an area of @window to the background color or background pixmap.
-
+Gets the current state of a device.
</description>
<parameters>
-<parameter name="window">
-<parameter_description> a #GdkWindow
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> x coordinate of rectangle to clear
+<parameter name="device">
+<parameter_description> a #GdkDevice.
</parameter_description>
</parameter>
-<parameter name="y">
-<parameter_description> y coordinate of rectangle to clear
+<parameter name="window">
+<parameter_description> a #GdkWindow.
</parameter_description>
</parameter>
-<parameter name="width">
-<parameter_description> width of rectangle to clear
+<parameter name="axes">
+<parameter_description> an array of doubles to store the values of the axes of @device in,
+or %NULL.
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> height of rectangle to clear
+<parameter name="mask">
+<parameter_description> location to store the modifiers, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -6722,6 +7018,8 @@ Deprecated function; use g_object_ref() instead.
</parameter>
</parameters>
<return> the gc.
+
+Deprecated: 2.0: Use g_object_ref() instead.
</return>
</function>
@@ -6825,11 +7123,11 @@ Examples of keyvals are #GDK_a, #GDK_Enter, #GDK_F1, etc.
</parameter_description>
</parameter>
<parameter name="lower">
-<parameter_description> return location for lowercase version of @symbol
+<parameter_description> (out): return location for lowercase version of @symbol
</parameter_description>
</parameter>
<parameter name="upper">
-<parameter_description> return location for uppercase version of @symbol
+<parameter_description> (out): return location for uppercase version of @symbol
</parameter_description>
</parameter>
</parameters>
@@ -6915,6 +7213,26 @@ Return value: an Xlib <type>Display*</type>.
</return>
</function>
+<function name="gdk_pixbuf_simple_anim_set_loop">
+<description>
+Sets whether @animation should loop indefinitely when it reaches the end.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="animation">
+<parameter_description> a #GdkPixbufSimpleAnim
+</parameter_description>
+</parameter>
+<parameter name="loop">
+<parameter_description> whether to loop the animation
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="_gdk_drawable_get_scratch_gc">
<description>
Return value: A #GdkGC suitable for drawing on @drawable
@@ -6985,20 +7303,28 @@ Since: 2.2
</return>
</function>
-<function name="gdk_pixbuf_simple_anim_set_loop">
+<function name="gdk_drawable_get_size">
<description>
-Sets whether @animation should loop indefinitely when it reaches the end.
+Fills * width and * height with the size of @drawable.
+ width or @height can be %NULL if you only want the other one.
+
+On the X11 platform, if @drawable is a #GdkWindow, the returned
+size is the size reported in the most-recently-processed configure
+event, rather than the current size on the X server.
-Since: 2.18
</description>
<parameters>
-<parameter name="animation">
-<parameter_description> a #GdkPixbufSimpleAnim
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable
</parameter_description>
</parameter>
-<parameter name="loop">
-<parameter_description> whether to loop the animation
+<parameter name="width">
+<parameter_description> (allow-none): (out): location to store drawable's width, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> (allow-none): (out): location to store drawable's height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7028,53 +7354,29 @@ Since: 2.2
</return>
</function>
-<function name="gdk_draw_glyphs_transformed">
+<function name="gdk_screen_get_primary_monitor">
<description>
-Renders a #PangoGlyphString onto a drawable, possibly
-transforming the layed-out coordinates through a transformation
-matrix. Note that the transformation matrix for @font is not
-changed, so to produce correct rendering results, the @font
-must have been loaded using a #PangoContext with an identical
-transformation matrix to that passed in to this function.
+Gets the primary monitor for @screen. The primary monitor
+is considered the monitor where the 'main desktop' lives.
+While normal application windows typically allow the window
+manager to place the windows, specialized desktop applications
+such as panels should place themselves on the primary monitor.
-See also gdk_draw_glyphs(), gdk_draw_layout().
+If no primary monitor is configured by the user, the return value
+will be 0, defaulting to the first monitor.
-Since: 2.6
</description>
<parameters>
-<parameter name="drawable">
-<parameter_description> a #GdkDrawable
-</parameter_description>
-</parameter>
-<parameter name="gc">
-<parameter_description> a #GdkGC
-</parameter_description>
-</parameter>
-<parameter name="matrix">
-<parameter_description> a #PangoMatrix, or %NULL to use an identity transformation
-</parameter_description>
-</parameter>
-<parameter name="font">
-<parameter_description> the font in which to draw the string
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> the x position of the start of the string (in Pango
-units in user space coordinates)
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> the y position of the baseline (in Pango units
-in user space coordinates)
-</parameter_description>
-</parameter>
-<parameter name="glyphs">
-<parameter_description> the glyph string to draw
+<parameter name="screen">
+<parameter_description> a #GdkScreen.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> An integer index for the primary monitor, or 0 if none is configured.
+
+Since: 2.20
+</return>
</function>
<function name="gdk_win32_hdc_release">
@@ -7274,7 +7576,7 @@ range btweeen #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the idle is removed, or %NULL
+<parameter_description> (allow-none): function to call when the idle is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7284,6 +7586,55 @@ Since: 2.12
</return>
</function>
+<function name="gdk_draw_glyphs_transformed">
+<description>
+Renders a #PangoGlyphString onto a drawable, possibly
+transforming the layed-out coordinates through a transformation
+matrix. Note that the transformation matrix for @font is not
+changed, so to produce correct rendering results, the @font
+must have been loaded using a #PangoContext with an identical
+transformation matrix to that passed in to this function.
+
+See also gdk_draw_glyphs(), gdk_draw_layout().
+
+Since: 2.6
+
+</description>
+<parameters>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable
+</parameter_description>
+</parameter>
+<parameter name="gc">
+<parameter_description> a #GdkGC
+</parameter_description>
+</parameter>
+<parameter name="matrix">
+<parameter_description> (allow-none): a #PangoMatrix, or %NULL to use an identity transformation
+</parameter_description>
+</parameter>
+<parameter name="font">
+<parameter_description> the font in which to draw the string
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> the x position of the start of the string (in Pango
+units in user space coordinates)
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> the y position of the baseline (in Pango units
+in user space coordinates)
+</parameter_description>
+</parameter>
+<parameter name="glyphs">
+<parameter_description> the glyph string to draw
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_window_get_user_data">
<description>
Retrieves the user data for @window, which is normally the widget
@@ -7371,7 +7722,7 @@ function will return %NULL.
<function name="gdk_x11_screen_get_monitor_output">
<description>
Gets the XID of the specified output/monitor.
-If the X server does not support version 1.2 of the RANDR
+If the X server does not support version 1.2 of the RANDR
extension, 0 is returned.
@@ -7382,7 +7733,7 @@ extension, 0 is returned.
</parameter_description>
</parameter>
<parameter name="monitor_num">
-<parameter_description> number of the monitor
+<parameter_description> number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
</parameter_description>
</parameter>
</parameters>
@@ -7458,11 +7809,11 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> width of redirection
+<parameter_description> width of redirection, or -1 to use the width of @window
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> height of redirection
+<parameter_description> height of redirection or -1 to use the height of @window
</parameter_description>
</parameter>
</parameters>
@@ -7562,7 +7913,7 @@ Gets the system's default colormap for @screen
</parameter_description>
</parameter>
</parameters>
-<return> the default colormap for @screen.
+<return> (transfer none): the default colormap for @screen.
Since: 2.2
</return>
@@ -7653,26 +8004,16 @@ is gtk_widget_create_pango_layout().
<return></return>
</function>
-<function name="gdk_window_process_updates">
+<function name="gdk_cursor_unref">
<description>
-Sends one or more expose events to @window. The areas in each
-expose event will cover the entire update area for the window (see
-gdk_window_invalidate_region() for details). Normally GDK calls
-gdk_window_process_all_updates() on your behalf, so there's no
-need to call this function unless you want to force expose events
-to be delivered immediately and synchronously (vs. the usual
-case, where GDK delivers them in an idle handler). Occasionally
-this is useful to produce nicer scrolling behavior, for example.
+Removes a reference from @cursor, deallocating the cursor
+if no references remain.
</description>
<parameters>
-<parameter name="window">
-<parameter_description> a #GdkWindow
-</parameter_description>
-</parameter>
-<parameter name="update_children">
-<parameter_description> whether to also process updates for child windows
+<parameter name="cursor">
+<parameter_description> a #GdkCursor
</parameter_description>
</parameter>
</parameters>
@@ -7696,7 +8037,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="options">
-<parameter_description> a #cairo_font_options_t, or %NULL to unset any
+<parameter_description> (allow-none): a #cairo_font_options_t, or %NULL to unset any
previously set default font options.
</parameter_description>
</parameter>
@@ -7876,7 +8217,7 @@ a list of UTF-8 strings.
</parameter_description>
</parameter>
<parameter name="list">
-<parameter_description> location to store the list of strings or %NULL. The
+<parameter_description> (allow-none): location to store the list of strings or %NULL. The
list should be freed with g_strfreev().
</parameter_description>
</parameter>
@@ -7981,6 +8322,39 @@ could not be opened.
</return>
</function>
+<function name="gdk_window_restack">
+<description>
+Changes the position of @window in the Z-order (stacking order), so that
+it is above @sibling (if @above is %TRUE) or below @sibling (if @above is
+%FALSE).
+
+If @sibling is %NULL, then this either raises (if @above is %TRUE) or
+lowers the window.
+
+If @window is a toplevel, the window manager may choose to deny the
+request to move the window in the Z-order, gdk_window_restack() only
+requests the restack, does not guarantee it.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="sibling">
+<parameter_description> (allow-none): a #GdkWindow that is a sibling of @window, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="above">
+<parameter_description> a boolean
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_x11_get_xatom_name">
<description>
Return value: name of the X atom; this string is owned by GTK+,
@@ -8038,7 +8412,7 @@ Returns: %TRUE if there were any entries
</description>
<parameters>
<parameter name="keymap">
-<parameter_description> a #GdkKeymap or %NULL to use the default keymap
+<parameter_description> (allow-none): a #GdkKeymap or %NULL to use the default keymap
</parameter_description>
</parameter>
<parameter name="hardware_keycode">
@@ -8046,11 +8420,11 @@ Returns: %TRUE if there were any entries
</parameter_description>
</parameter>
<parameter name="keys">
-<parameter_description> return location for array of #GdkKeymapKey, or %NULL
+<parameter_description> (out): return location for array of #GdkKeymapKey, or %NULL
</parameter_description>
</parameter>
<parameter name="keyvals">
-<parameter_description> return location for array of keyvals, or %NULL
+<parameter_description> (out): return location for array of keyvals, or %NULL
</parameter_description>
</parameter>
<parameter name="n_entries">
@@ -8268,6 +8642,24 @@ gdk_colormap_get_system_for_screen ())
</return>
</function>
+<function name="gdk_window_is_destroyed">
+<description>
+Check to see if a window is destroyed..
+
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the window is destroyed
+
+Since: 2.18
+</return>
+</function>
+
<function name="gdk_visual_get_screen">
<description>
Gets the screen to which this visual belongs
@@ -8280,7 +8672,7 @@ Gets the screen to which this visual belongs
</parameter_description>
</parameter>
</parameters>
-<return> the screen to which this visual belongs.
+<return> (transfer none): the screen to which this visual belongs.
Since: 2.2
</return>
@@ -8345,6 +8737,8 @@ Deprecated equivalent of calling g_object_ref() on @drawable.
</parameter>
</parameters>
<return> the same @drawable passed in
+
+Deprecated: 2.0: Use g_object_ref() instead.
</return>
</function>
@@ -8703,7 +9097,7 @@ the save routine generates.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -8860,7 +9254,7 @@ gdk_window_clear().
</parameter_description>
</parameter>
<parameter name="pixmap">
-<parameter_description> a #GdkPixmap, or %NULL
+<parameter_description> (allow-none): a #GdkPixmap, or %NULL
</parameter_description>
</parameter>
<parameter name="parent_relative">
@@ -8999,6 +9393,7 @@ necessary.
<description>
Deprecated equivalent of calling g_object_unref() on @drawable.
+Deprecated: 2.0: Use g_object_unref() instead.
</description>
<parameters>
@@ -9143,7 +9538,7 @@ be freed. %NULL may be returned if no visual supports @depth.
</parameter_description>
</parameter>
</parameters>
-<return> best visual for the given depth
+<return> (transfer none): best visual for the given depth
</return>
</function>
@@ -9271,7 +9666,7 @@ Determines the width of a given character.
</parameters>
<return> the width of the character in pixels.
-Deprecated: Use gdk_text_extents() instead.
+Deprecated: 2.2: Use gdk_text_extents() instead.
</return>
</function>
@@ -9452,7 +9847,7 @@ Since: 2.2
<function name="gdk_screen_get_root_window">
<description>
-Gets the root window of @screen.
+Gets the root window of @screen.
</description>
@@ -9462,7 +9857,7 @@ Gets the root window of @screen.
</parameter_description>
</parameter>
</parameters>
-<return> the root window
+<return> (transfer none): the root window
Since: 2.2
</return>
@@ -9515,11 +9910,11 @@ Gets the width in millimeters of the specified monitor, if available.
</parameter_description>
</parameter>
<parameter name="monitor_num">
-<parameter_description> number of the monitor
+<parameter_description> number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
</parameter_description>
</parameter>
</parameters>
-<return>the width of the monitor, or -1 if not available
+<return> the width of the monitor, or -1 if not available
Since: 2.14
</return>
@@ -9556,7 +9951,7 @@ should not be freed. %NULL may be returned if no visual has type
</parameter_description>
</parameter>
</parameters>
-<return> best visual of the given type
+<return> (transfer none): best visual of the given type
</return>
</function>
@@ -9614,7 +10009,7 @@ with g_free().
</description>
<parameters>
<parameter name="keymap">
-<parameter_description> a #GdkKeymap, or %NULL to use the default keymap
+<parameter_description> (allow-none): a #GdkKeymap, or %NULL to use the default keymap
</parameter_description>
</parameter>
<parameter name="keyval">
@@ -9622,11 +10017,11 @@ with g_free().
</parameter_description>
</parameter>
<parameter name="keys">
-<parameter_description> return location for an array of #GdkKeymapKey
+<parameter_description> (out): return location for an array of #GdkKeymapKey
</parameter_description>
</parameter>
<parameter name="n_keys">
-<parameter_description> return location for number of elements in returned array
+<parameter_description> (out): return location for number of elements in returned array
</parameter_description>
</parameter>
</parameters>
@@ -9974,7 +10369,7 @@ motion history is supported and no events were found.)
</parameter_description>
</parameter>
<parameter name="events">
-<parameter_description> location to store a newly-allocated array of #GdkTimeCoord, or %NULL
+<parameter_description> (array length=n_events) (out) (transfer none): location to store a newly-allocated array of #GdkTimeCoord, or %NULL
</parameter_description>
</parameter>
<parameter name="n_events">
@@ -10038,7 +10433,7 @@ an image.
</description>
<parameters>
<parameter name="dest">
-<parameter_description> Destination pixbuf, or %NULL if a new pixbuf should be created.
+<parameter_description> (allow-none): Destination pixbuf, or %NULL if a new pixbuf should be created.
</parameter_description>
</parameter>
<parameter name="src">
@@ -10046,7 +10441,7 @@ an image.
</parameter_description>
</parameter>
<parameter name="cmap">
-<parameter_description> A colormap, or %NULL to use the one for @src
+<parameter_description> (allow-none): A colormap, or %NULL to use the one for @src
</parameter_description>
</parameter>
<parameter name="src_x">
@@ -10186,16 +10581,26 @@ window coordinates.
<return></return>
</function>
-<function name="gdk_cursor_unref">
+<function name="gdk_window_process_updates">
<description>
-Removes a reference from @cursor, deallocating the cursor
-if no references remain.
+Sends one or more expose events to @window. The areas in each
+expose event will cover the entire update area for the window (see
+gdk_window_invalidate_region() for details). Normally GDK calls
+gdk_window_process_all_updates() on your behalf, so there's no
+need to call this function unless you want to force expose events
+to be delivered immediately and synchronously (vs. the usual
+case, where GDK delivers them in an idle handler). Occasionally
+this is useful to produce nicer scrolling behavior, for example.
</description>
<parameters>
-<parameter name="cursor">
-<parameter_description> a #GdkCursor
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="update_children">
+<parameter_description> whether to also process updates for child windows
</parameter_description>
</parameter>
</parameters>
@@ -10237,6 +10642,35 @@ This value is owned by the GC and must not be freed.
</return>
</function>
+<function name="gdk_cairo_reset_clip">
+<description>
+Resets the clip region for a Cairo context created by gdk_cairo_create().
+
+This resets the clip region to the "empty" state for the given drawable.
+This is required for non-native windows since a direct call to
+cairo_reset_clip() would unset the clip region inherited from the
+drawable (i.e. the window clip region), and thus let you e.g.
+draw outside your window.
+
+This is rarely needed though, since most code just create a new cairo_t
+using gdk_cairo_create() each time they want to draw something.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="cr">
+<parameter_description> a #cairo_t
+</parameter_description>
+</parameter>
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_draw_polygon">
<description>
Draws an outlined or filled polygon.
@@ -10548,7 +10982,7 @@ Allocates a single color from a colormap.
</parameters>
<return> %TRUE if the allocation succeeded.
-Deprecated: Use gdk_colormap_alloc_color() instead.
+Deprecated: 2.2: Use gdk_colormap_alloc_color() instead.
</return>
</function>
@@ -10620,7 +11054,7 @@ a file descriptor.
<return> a tag that can later be used as an argument to
gdk_input_remove().
-Deprecated: Use g_io_add_watch() on a #GIOChannel
+Deprecated: 2.14: Use g_io_add_watch() on a #GIOChannel
</return>
</function>
@@ -10721,7 +11155,7 @@ GDK screen. The return value should not be freed.
</description>
<parameters>
</parameters>
-<return> best visual
+<return> (transfer none): best visual
</return>
</function>
@@ -10807,20 +11241,20 @@ Since: 2.2
</parameter_description>
</parameter>
<parameter name="screen">
-<parameter_description> location to store the screen that the
+<parameter_description> (allow-none): location to store the screen that the
cursor is on, or %NULL.
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store root window X coordinate of pointer, or %NULL.
+<parameter_description> (allow-none): (out): location to store root window X coordinate of pointer, or %NULL.
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store root window Y coordinate of pointer, or %NULL.
+<parameter_description> (allow-none): (out): location to store root window Y coordinate of pointer, or %NULL.
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> location to store current modifier mask, or %NULL
+<parameter_description> (allow-none): (out): location to store current modifier mask, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -11050,11 +11484,11 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> the return location for the maximal cursor width
+<parameter_description> (out): the return location for the maximal cursor width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> the return location for the maximal cursor height
+<parameter_description> (out): the return location for the maximal cursor height
</parameter_description>
</parameter>
</parameters>
@@ -11244,7 +11678,7 @@ the save routine generates.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -11271,7 +11705,37 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="drawable">
-<parameter_description> the new target drawable, or %NULL
+<parameter_description> (allow-none): the new target drawable, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gdk_window_flush">
+<description>
+Flush all outstanding cached operations on a window, leaving the
+window in a state which reflects all that has been drawn before.
+
+Gdk uses multiple kinds of caching to get better performance and
+nicer drawing. For instance, during exposes all paints to a window
+using double buffered rendering are keep on a pixmap until the last
+window has been exposed. It also delays window moves/scrolls until
+as long as possible until next update to avoid tearing when moving
+windows.
+
+Normally this should be completely invisible to applications, as
+we automatically flush the windows when required, but this might
+be needed if you for instance mix direct native drawing with
+gdk drawing. For Gtk widgets that don't use double buffering this
+will be called automatically before sending the expose event.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
</parameter_description>
</parameter>
</parameters>
@@ -11487,7 +11951,7 @@ The return value should not be freed.
</parameter_description>
</parameter>
</parameters>
-<return> the system visual
+<return> (transfer none): the system visual
Since: 2.2
</return>
@@ -11531,7 +11995,7 @@ Returns: a newly-allocated string containing the name of the monitor,
</parameter_description>
</parameter>
<parameter name="monitor_num">
-<parameter_description> number of the monitor
+<parameter_description> number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)
</parameter_description>
</parameter>
</parameters>
@@ -11563,7 +12027,7 @@ the #GObject variant should be used instead.
</parameter_description>
</parameter>
<parameter name="destroy_func">
-<parameter_description> function to free @data, or %NULL
+<parameter_description> (allow-none): function to free @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -11627,6 +12091,13 @@ or %NULL if the mask is not needed.
<function name="gdk_offscreen_window_set_embedder">
<description>
+Sets @window to be embedded in @embedder.
+
+To fully embed an offscreen window, in addition to calling this
+function, it is also necessary to handle the #GdkWindow::pick-embedded-child
+signal on the @embedder and the #GdkWindow::to-embedder and
+#GdkWindow::from-embedder signals on @window.
+
Since: 2.18
</description>
@@ -11909,7 +12380,7 @@ handler is removed.
<return> a tag that can later be used as an argument to
gdk_input_remove().
-Deprecated: Use g_io_add_watch_full() on a #GIOChannel
+Deprecated: 2.14: Use g_io_add_watch_full() on a #GIOChannel
</return>
</function>
@@ -11923,7 +12394,7 @@ function for
</description>
<parameters>
</parameters>
-<return> a #GdkDisplay, or %NULL if there is no default
+<return> (transfer none): a #GdkDisplay, or %NULL if there is no default
display.
Since: 2.2
@@ -11944,10 +12415,6 @@ using the cursor for its parent window.
<parameter_description> a #GdkWindow
</parameter_description>
</parameter>
-<parameter name="cursor">
-<parameter_description> a cursor
-</parameter_description>
-</parameter>
</parameters>
<return> a #GdkCursor, or %NULL. The returned object is owned
by the #GdkWindow and should not be unreferenced directly. Use
@@ -12067,7 +12534,7 @@ structs returned by gdk_pixbuf_get_formats().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an allocated #GError, or %NULL to ignore errors
+<parameter_description> (allow-none): return location for an allocated #GError, or %NULL to ignore errors
</parameter_description>
</parameter>
</parameters>
@@ -12116,6 +12583,8 @@ GraphicsExpose events are handled before the widget is scrolled.
</parameters>
<return> a #GdkEventExpose if a GraphicsExpose was received, or %NULL if a
NoExpose event was received.
+
+Deprecated: 2.18:
</return>
</function>
@@ -12389,8 +12858,8 @@ cursor1_width, cursor1_height);
mask = gdk_bitmap_create_from_data (NULL, cursor1mask_bits,
cursor1_width, cursor1_height);
cursor = gdk_cursor_new_from_pixmap (source, mask, &fg, &bg, 8, 8);
-gdk_pixmap_unref (source);
-gdk_pixmap_unref (mask);
+g_object_unref (source);
+g_object_unref (mask);
gdk_window_set_cursor (widget->window, cursor);
@@ -12434,12 +12903,13 @@ The color does not have to be allocated first.
<function name="gdk_display_manager_get">
<description>
+Gets the singleton #GdkDisplayManager object.
+
</description>
<parameters>
</parameters>
-<return> the singleton #GdkDisplayManager object.
-the global #GdkDisplayManager singleton; gdk_parse_pargs(),
+<return> (transfer none): The global #GdkDisplayManager singleton; gdk_parse_pargs(),
gdk_init(), or gdk_init_check() must have been called first.
Since: 2.2
@@ -13037,7 +13507,7 @@ The stream is not closed.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -13174,7 +13644,7 @@ but very few honor all possible combinations of bits.
<description>
Draws a string of characters in the given font or fontset.
-Deprecated: Use gdk_draw_layout() instead.
+Deprecated: 2.4: Use gdk_draw_layout() instead.
</description>
<parameters>
@@ -14125,7 +14595,7 @@ Since: 2.2
Translates the contents of a #GdkEventKey into a keyval, effective
group, and level. Modifiers that affected the translation and
are thus unavailable for application use are returned in
- consumed_modifiers See gdk_keyval_get_keys() for an explanation of
+ consumed_modifiers See <xref linkend="key-group-explanation"/> for an explanation of
groups and levels. The @effective_group is the group that was
actually used for the translation; some keys such as Enter are not
affected by the active keyboard group. The @level is derived from
@@ -14141,14 +14611,14 @@ symbol is shifted, so when comparing a key press to a
be masked out.
</para>
<informalexample><programlisting>
-* We want to ignore irrelevant modifiers like ScrollLock *
+/* We want to ignore irrelevant modifiers like ScrollLock */
#define ALL_ACCELS_MASK (GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_MOD1_MASK)
gdk_keymap_translate_keyboard_state (keymap, event->hardware_keycode,
event->state, event->group,
&keyval, NULL, NULL, &consumed);
if (keyval == GDK_PLUS &&
(event->state & ~consumed & ALL_ACCELS_MASK) == GDK_CONTROL_MASK)
-* Control was pressed *
+/* Control was pressed */
</programlisting></informalexample>
<para>
An older interpretation @consumed_modifiers was that it contained
@@ -14156,10 +14626,10 @@ all modifiers that might affect the translation of the key;
this allowed accelerators to be stored with irrelevant consumed
modifiers, by doing:</para>
<informalexample><programlisting>
-* XXX Don't do this XXX *
+/* XXX Don't do this XXX */
if (keyval == accel_keyval &&
(event->state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed))
-* Accelerator was pressed *
+/* Accelerator was pressed */
</programlisting></informalexample>
<para>
However, this did not work if multi-modifier combinations were
@@ -14179,7 +14649,7 @@ not <literal><Control><Shift>plus</literal>,
</description>
<parameters>
<parameter name="keymap">
-<parameter_description> a #GdkKeymap, or %NULL to use the default
+<parameter_description> (allow-none): a #GdkKeymap, or %NULL to use the default
</parameter_description>
</parameter>
<parameter name="hardware_keycode">
@@ -14187,7 +14657,7 @@ not <literal><Control><Shift>plus</literal>,
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> a modifier state
+<parameter_description> a modifier state
</parameter_description>
</parameter>
<parameter name="group">
@@ -14195,19 +14665,19 @@ not <literal><Control><Shift>plus</literal>,
</parameter_description>
</parameter>
<parameter name="keyval">
-<parameter_description> return location for keyval, or %NULL
+<parameter_description> (out) (allow-none): return location for keyval, or %NULL
</parameter_description>
</parameter>
<parameter name="effective_group">
-<parameter_description> return location for effective group, or %NULL
+<parameter_description> (out) (allow-none): return location for effective group, or %NULL
</parameter_description>
</parameter>
<parameter name="level">
-<parameter_description> return location for level, or %NULL
+<parameter_description> (out) (allow-none): return location for level, or %NULL
</parameter_description>
</parameter>
<parameter name="consumed_modifiers">
-<parameter_description> return location for modifiers that were used to
+<parameter_description> (out) (allow-none): return location for modifiers that were used to
determine the group or level, or %NULL
</parameter_description>
</parameter>
@@ -14234,7 +14704,7 @@ Draws a number of wide characters using the given font of fontset.
If the font is a 1-byte font, the string is converted into 1-byte
characters (discarding the high bytes) before output.
-Deprecated: Use gdk_draw_layout() instead.
+Deprecated: 2.4: Use gdk_draw_layout() instead.
</description>
<parameters>
@@ -14290,7 +14760,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name, or %NULL
+<parameter_description> (allow-none): an icon name, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -14452,43 +14922,71 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="icon">
-<parameter_description> a #GIcon, or %NULL
+<parameter_description> (allow-none): a #GIcon, or %NULL
</parameter_description>
</parameter>
</parameters>
<return></return>
</function>
-<function name="gdk_gc_set_line_attributes">
+<function name="gdk_drawable_get_image">
<description>
-Sets various attributes of how lines are drawn. See
-the corresponding members of #GdkGCValues for full
-explanations of the arguments.
+A #GdkImage stores client-side image data (pixels). In contrast,
+#GdkPixmap and #GdkWindow are server-side
+objects. gdk_drawable_get_image() obtains the pixels from a
+server-side drawable as a client-side #GdkImage. The format of a
+#GdkImage depends on the #GdkVisual of the current display, which
+makes manipulating #GdkImage extremely difficult; therefore, in
+most cases you should use gdk_pixbuf_get_from_drawable() instead of
+this lower-level function. A #GdkPixbuf contains image data in a
+canonicalized RGB format, rather than a display-dependent format.
+Of course, there's a convenience vs. speed tradeoff here, so you'll
+want to think about what makes sense for your application.
+
+ x, @y, @width, and @height define the region of @drawable to
+obtain as an image.
+
+You would usually copy image data to the client side if you intend
+to examine the values of individual pixels, for example to darken
+an image or add a red tint. It would be prohibitively slow to
+make a round-trip request to the windowing system for each pixel,
+so instead you get all of them at once, modify them, then copy
+them all back at once.
+
+If the X server or other windowing system backend is on the local
+machine, this function may use shared memory to avoid copying
+the image data.
+
+If the source drawable is a #GdkWindow and partially offscreen
+or obscured, then the obscured portions of the returned image
+will contain undefined data.
+
</description>
<parameters>
-<parameter name="gc">
-<parameter_description> a #GdkGC.
+<parameter name="drawable">
+<parameter_description> a #GdkDrawable
</parameter_description>
</parameter>
-<parameter name="line_width">
-<parameter_description> the width of lines.
+<parameter name="x">
+<parameter_description> x coordinate on @drawable
</parameter_description>
</parameter>
-<parameter name="line_style">
-<parameter_description> the dash-style for lines.
+<parameter name="y">
+<parameter_description> y coordinate on @drawable
</parameter_description>
</parameter>
-<parameter name="cap_style">
-<parameter_description> the manner in which the ends of lines are drawn.
+<parameter name="width">
+<parameter_description> width of region to get
</parameter_description>
</parameter>
-<parameter name="join_style">
-<parameter_description> the in which lines are joined together.
+<parameter name="height">
+<parameter_description> height or region to get
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> a #GdkImage containing the contents of @drawable
+</return>
</function>
<function name="gdk_gc_set_clip_origin">
@@ -14632,7 +15130,7 @@ See gdk_pixbuf_save () for more details.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -14653,6 +15151,8 @@ Deprecated function; use g_object_ref() instead.
</parameter>
</parameters>
<return> the image
+
+Deprecated: 2.0: Use g_object_ref() instead.
</return>
</function>
@@ -14787,22 +15287,22 @@ corner of @window.
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return location for X coordinate of pointer or %NULL to not
+<parameter_description> (out) (allow-none): return location for X coordinate of pointer or %NULL to not
return the X coordinate
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return location for Y coordinate of pointer or %NULL to not
+<parameter_description> (out) (allow-none): return location for Y coordinate of pointer or %NULL to not
return the Y coordinate
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> return location for modifier mask or %NULL to not return the
+<parameter_description> (out) (allow-none): return location for modifier mask or %NULL to not return the
modifier mask
</parameter_description>
</parameter>
</parameters>
-<return> the window containing the pointer (as with
+<return> (transfer none): the window containing the pointer (as with
gdk_window_at_pointer()), or %NULL if the window containing the
pointer isn't known to GDK
</return>
@@ -14985,7 +15485,7 @@ Since: 2.8
<function name="gdk_drag_find_window">
<description>
Finds the destination window and DND protocol to use at the
-given pointer position.
+given pointer position.
This function is called by the drag source to obtain the
@dest_window and @protocol parameters for gdk_drag_motion().
@@ -15010,11 +15510,11 @@ should be ignored, since it is put up by the drag source as an icon.
</parameter_description>
</parameter>
<parameter name="dest_window">
-<parameter_description> location to store the destination window in.
+<parameter_description> (out): location to store the destination window in.
</parameter_description>
</parameter>
<parameter name="protocol">
-<parameter_description> location to store the DND protocol in.
+<parameter_description> (out): location to store the DND protocol in.
</parameter_description>
</parameter>
</parameters>
@@ -15098,36 +15598,27 @@ cairo surface) when its size has changed.
<return></return>
</function>
-<function name="gdk_pixbuf_simple_anim_new">
+<function name="gdk_init">
<description>
-Creates a new, empty animation.
-
</description>
<parameters>
-<parameter name="width">
-<parameter_description> the width of the animation
-</parameter_description>
-</parameter>
-<parameter name="height">
-<parameter_description> the height of the animation
+<parameter name="argc">
+<parameter_description> (inout):
</parameter_description>
</parameter>
-<parameter name="rate">
-<parameter_description> the speed of the animation, in frames per second
+<parameter name="argv">
+<parameter_description> (array length=argc) (inout):
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GdkPixbufSimpleAnim
-
-Since: 2.8
-</return>
+<return></return>
</function>
<function name="gdk_display_get_window_at_pointer">
<description>
Obtains the window underneath the mouse pointer, returning the location
-of the pointer in that window in @win_x, @win_y for @screen. Returns %NULL
+of the pointer in that window in @win_x, @win_y for @screen. Returns %NULL
if the window under the mouse pointer is not known to GDK (for example,
belongs to another application).
@@ -15139,17 +15630,17 @@ belongs to another application).
</parameter_description>
</parameter>
<parameter name="win_x">
-<parameter_description> return location for x coordinate of the pointer location relative
+<parameter_description> (out) (allow-none): return location for x coordinate of the pointer location relative
to the window origin, or %NULL
</parameter_description>
</parameter>
<parameter name="win_y">
-<parameter_description> return location for y coordinate of the pointer location relative
+<parameter_description> (out) (allow-none): return location for y coordinate of the pointer location relative
& to the window origin, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> the window under the mouse pointer, or %NULL
+<return> (transfer none): the window under the mouse pointer, or %NULL
Since: 2.2
</return>
@@ -15661,8 +16152,8 @@ gdk_window_set_opacity().
</parameter_description>
</parameter>
</parameters>
-<return> a colormap to use for windows with an alpha channel
-or %NULL if the capability is not available.
+<return> (transfer none): a colormap to use for windows with
+an alpha channel or %NULL if the capability is not available.
Since: 2.8
</return>
@@ -15952,6 +16443,39 @@ Return value: the selection atom.
</return>
</function>
+<function name="gdk_init_check">
+<description>
+Initialize the library for use.
+
+Arguments:
+"argc" is the number of arguments.
+"argv" is an array of strings.
+
+Results:
+"argc" and "argv" are modified to reflect any arguments
+which were not handled. (Such arguments should either
+be handled by the application or dismissed). If initialization
+fails, returns FALSE, otherwise TRUE.
+
+Side effects:
+The library is initialized.
+
+--------------------------------------------------------------
+
+</description>
+<parameters>
+<parameter name="argc">
+<parameter_description> (inout):
+</parameter_description>
+</parameter>
+<parameter name="argv">
+<parameter_description> (array length=argc) (inout):
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gdk_keymap_lookup_key">
<description>
Looks up the keyval mapped to a keycode/group/level triplet.
@@ -16212,8 +16736,8 @@ for caveats.
</parameter_description>
</parameter>
</parameters>
-<return> a visual to use for windows with an alpha channel
-or %NULL if the capability is not available.
+<return> (transfer none): a visual to use for windows with an
+alpha channel or %NULL if the capability is not available.
Since: 2.8
</return>
@@ -16504,15 +17028,15 @@ gdk_display_get_window_at_pointer() instead.
</description>
<parameters>
<parameter name="win_x">
-<parameter_description> return location for origin of the window under the pointer
+<parameter_description> (out) (allow-none): return location for origin of the window under the pointer
</parameter_description>
</parameter>
<parameter name="win_y">
-<parameter_description> return location for origin of the window under the pointer
+<parameter_description> (out) (allow-none): return location for origin of the window under the pointer
</parameter_description>
</parameter>
</parameters>
-<return> window under the mouse pointer
+<return> (transfer none): window under the mouse pointer
</return>
</function>
@@ -16683,7 +17207,7 @@ and copies into that. See gdk_drawable_get_image() for further details.
</parameter_description>
</parameter>
<parameter name="image">
-<parameter_description> a #GdkDrawable, or %NULL if a new @image should be created.
+<parameter_description> (allow-none): a #GdkDrawable, or %NULL if a new @image should be created.
</parameter_description>
</parameter>
<parameter name="src_x">
@@ -16860,7 +17384,7 @@ range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE.
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> function to call when the timeout is removed, or %NULL
+<parameter_description> (allow-none): function to call when the timeout is removed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -16894,7 +17418,7 @@ in the wide-character encoding of the current locale).
<function name="gdk_drag_find_window_for_screen">
<description>
Finds the destination window and DND protocol to use at the
-given pointer position.
+given pointer position.
This function is called by the drag source to obtain the
@dest_window and @protocol parameters for gdk_drag_motion().
@@ -16925,11 +17449,11 @@ should be ignored, since it is put up by the drag source as an icon.
</parameter_description>
</parameter>
<parameter name="dest_window">
-<parameter_description> location to store the destination window in.
+<parameter_description> (out): location to store the destination window in.
</parameter_description>
</parameter>
<parameter name="protocol">
-<parameter_description> location to store the DND protocol in.
+<parameter_description> (out): location to store the DND protocol in.
</parameter_description>
</parameter>
</parameters>
@@ -16959,7 +17483,7 @@ in the four forms is '#fff' '#ffffff' '#fffffffff' and
</parameter_description>
</parameter>
<parameter name="color">
-<parameter_description> the #GdkColor to fill in
+<parameter_description> (out): the #GdkColor to fill in
</parameter_description>
</parameter>
</parameters>
@@ -16983,7 +17507,8 @@ Combines gdk_visual_get_best_with_depth() and gdk_visual_get_best_with_type().
</parameter_description>
</parameter>
</parameters>
-<return> best visual with both @depth and @visual_type, or %NULL if none
+<return> (transfer none): best visual with both @depth and
+ visual_type, or %NULL if none
</return>
</function>
@@ -17050,64 +17575,22 @@ Since: 2.2
</return>
</function>
-<function name="gdk_drawable_get_image">
+<function name="gdk_device_free_history">
<description>
-A #GdkImage stores client-side image data (pixels). In contrast,
-#GdkPixmap and #GdkWindow are server-side
-objects. gdk_drawable_get_image() obtains the pixels from a
-server-side drawable as a client-side #GdkImage. The format of a
-#GdkImage depends on the #GdkVisual of the current display, which
-makes manipulating #GdkImage extremely difficult; therefore, in
-most cases you should use gdk_pixbuf_get_from_drawable() instead of
-this lower-level function. A #GdkPixbuf contains image data in a
-canonicalized RGB format, rather than a display-dependent format.
-Of course, there's a convenience vs. speed tradeoff here, so you'll
-want to think about what makes sense for your application.
-
- x, @y, @width, and @height define the region of @drawable to
-obtain as an image.
-
-You would usually copy image data to the client side if you intend
-to examine the values of individual pixels, for example to darken
-an image or add a red tint. It would be prohibitively slow to
-make a round-trip request to the windowing system for each pixel,
-so instead you get all of them at once, modify them, then copy
-them all back at once.
-
-If the X server or other windowing system backend is on the local
-machine, this function may use shared memory to avoid copying
-the image data.
-
-If the source drawable is a #GdkWindow and partially offscreen
-or obscured, then the obscured portions of the returned image
-will contain undefined data.
-
+Frees an array of #GdkTimeCoord that was returned by gdk_device_get_history().
</description>
<parameters>
-<parameter name="drawable">
-<parameter_description> a #GdkDrawable
-</parameter_description>
-</parameter>
-<parameter name="x">
-<parameter_description> x coordinate on @drawable
-</parameter_description>
-</parameter>
-<parameter name="y">
-<parameter_description> y coordinate on @drawable
-</parameter_description>
-</parameter>
-<parameter name="width">
-<parameter_description> width of region to get
+<parameter name="events">
+<parameter_description> (inout) (transfer none): an array of #GdkTimeCoord.
</parameter_description>
</parameter>
-<parameter name="height">
-<parameter_description> height or region to get
+<parameter name="n_events">
+<parameter_description> the length of the array.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkImage containing the contents of @drawable
-</return>
+<return></return>
</function>
<function name="gdk_gc_set_values">
@@ -17188,7 +17671,7 @@ for more details.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for error, or %NULL
+<parameter_description> (allow-none): return location for error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -17330,7 +17813,7 @@ gdk_display_get_default ()).
</description>
<parameters>
</parameters>
-<return> a #GdkScreen, or %NULL if there is no default display.
+<return> (transfer none): a #GdkScreen, or %NULL if there is no default display.
Since: 2.2
</return>
diff --git a/gdk/src/gdk_methods.defs b/gdk/src/gdk_methods.defs
index 550e958..9d8493f 100644
--- a/gdk/src/gdk_methods.defs
+++ b/gdk/src/gdk_methods.defs
@@ -6349,7 +6349,7 @@
(return-type "none")
(parameters
'("const-GdkRegion*" "region")
- '("gboolean-(*" "child_func")
+ '("somefunc" "child_func")
)
)
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 0962444..f06aa66 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -318,8 +318,7 @@ you should use this function if you already have a file name to which the
user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
-file and is saving it for the first time, do not call this function.
-</description>
+file and is saving it for the first time, do not call this function.</description>
<parameters>
<parameter name="chooser">
<parameter_description> a #GtkFileChooser
@@ -397,7 +396,7 @@ Return value: a #GtkRecentInfo structure containing information
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> (allow-none): a return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -1122,7 +1121,7 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</parameter_description>
</parameter>
</parameters>
-<return> the menu item for the given path, or %NULL if @path doesn't
+<return> (allow-none): the menu item for the given path, or %NULL if @path doesn't
lead to a menu item
</return>
</function>
@@ -1305,24 +1304,25 @@ Since: 2.10
<return></return>
</function>
-<function name="gtk_cell_renderer_set_sensitive">
+<function name="gtk_tree_model_get_iter_first">
<description>
-Sets the cell renderer's sensitivity.
+Initializes @iter with the first iterator in the tree (the one at the path
+"0") and returns %TRUE. Returns %FALSE if the tree is empty.
-Since: 2.18
</description>
<parameters>
-<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter name="tree_model">
+<parameter_description> A #GtkTreeModel.
</parameter_description>
</parameter>
-<parameter name="sensitive">
-<parameter_description> the sensitivity of the cell
+<parameter name="iter">
+<parameter_description> The uninitialized #GtkTreeIter.
</parameter_description>
</parameter>
</parameters>
-<return></return>
+<return> %TRUE, if @iter was set.
+</return>
</function>
<function name="gtk_tree_store_iter_is_valid">
@@ -1405,7 +1405,7 @@ Creates a new #GtkMountOperation
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent of the window, or %NULL
+<parameter_description> (allow-none): transient parent of the window, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -1425,6 +1425,10 @@ needed.
</description>
<parameters>
+<parameter name="offscreen">
+<parameter_description> the #GtkOffscreenWindow contained widget.
+</parameter_description>
+</parameter>
</parameters>
<return> A #GdkPixbuf pointer, or %NULL.
@@ -1480,7 +1484,7 @@ markup);
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL for none
+<parameter_description> (allow-none): transient parent, or %NULL for none
</parameter_description>
</parameter>
<parameter name="flags">
@@ -1496,7 +1500,7 @@ markup);
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> (allow-none): printf()-style format string, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -1718,11 +1722,11 @@ Creates a new #GtkMenuToolButton using @icon_widget as icon and
</description>
<parameters>
<parameter name="icon_widget">
-<parameter_description> a widget that will be used as icon widget, or %NULL
+<parameter_description> (allow-none): a widget that will be used as icon widget, or %NULL
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> a string that will be used as label, or %NULL
+<parameter_description> (allow-none): a string that will be used as label, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -1804,7 +1808,7 @@ application. For example, you can use this to add a
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -2615,11 +2619,11 @@ the model will sort using this function.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to @sort_func, or %NULL
+<parameter_description> (allow-none): User data to pass to @sort_func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @user_data, or %NULL
+<parameter_description> (allow-none): Destroy notifier of @user_data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -3755,7 +3759,7 @@ Creates a new vertical scrollbar.
</description>
<parameters>
<parameter name="adjustment">
-<parameter_description> the #GtkAdjustment to use, or %NULL to create a new adjustment
+<parameter_description> (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment
</parameter_description>
</parameter>
</parameters>
@@ -4376,7 +4380,7 @@ passes the correct target list to this function.
</parameter_description>
</parameter>
<parameter name="target_list">
-<parameter_description> list of droppable targets, or %NULL to use
+<parameter_description> (allow-none): list of droppable targets, or %NULL to use
gtk_drag_dest_get_target_list (@widget).
</parameter_description>
</parameter>
@@ -4824,11 +4828,11 @@ gtk_dialog_new_with_buttons().
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="action">
@@ -4836,7 +4840,7 @@ gtk_dialog_new_with_buttons().
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in the first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in the first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -5307,7 +5311,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) or %NULL
+<parameter_description> (allow-none): a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -5347,7 +5351,7 @@ Non vararg creation function. Used primarily by language bindings.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> an array of #GType types for the columns, from first to last
+<parameter_description> (array length=n_columns): an array of #GType types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
@@ -5596,11 +5600,11 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set the new row, or %NULL.
+<parameter_description> (allow-none): An unset #GtkTreeIter to set the new row, or %NULL.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="position">
@@ -5658,7 +5662,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row, or %NULL.
+<parameter_description> (allow-none): An unset #GtkTreeIter to set to the new row, or %NULL.
</parameter_description>
</parameter>
<parameter name="position">
@@ -5846,12 +5850,12 @@ Reads the page setup from the group @group_name in the key file
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group in the key_file to read, or %NULL
+<parameter_description> (allow-none): the name of the group in the key_file to read, or %NULL
to use the default name "Page Setup"
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -5914,6 +5918,24 @@ Since: 2.6
<return></return>
</function>
+<function name="gtk_page_setup_unix_dialog_get_print_settings">
+<description>
+Gets the current print settings from the dialog.
+
+
+</description>
+<parameters>
+<parameter name="dialog">
+<parameter_description> a #GtkPageSetupUnixDialog
+</parameter_description>
+</parameter>
+</parameters>
+<return> the current print settings
+
+Since: 2.10
+</return>
+</function>
+
<function name="gtk_tree_view_get_grid_lines">
<description>
Return value: a #GtkTreeViewGridLines value indicating which grid lines
@@ -6012,11 +6034,11 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6265,19 +6287,19 @@ gtk_tree_view_convert_widget_to_bin_window_coords().
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to a #GtkTreePath pointer to be filled in, or %NULL
+<parameter_description> (out) (allow-none): A pointer to a #GtkTreePath pointer to be filled in, or %NULL
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
+<parameter_description> (out) (allow-none): A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL
</parameter_description>
</parameter>
<parameter name="cell_x">
-<parameter_description> A pointer where the X coordinate relative to the cell can be placed, or %NULL
+<parameter_description> (out) (allow-none): A pointer where the X coordinate relative to the cell can be placed, or %NULL
</parameter_description>
</parameter>
<parameter name="cell_y">
-<parameter_description> A pointer where the Y coordinate relative to the cell can be placed, or %NULL
+<parameter_description> (out) (allow-none): A pointer where the Y coordinate relative to the cell can be placed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -6500,8 +6522,7 @@ you should use this function if you already have a file name to which the
user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
-file and is saving it for the first time, do not call this function.
-</description>
+file and is saving it for the first time, do not call this function.</description>
<parameters>
<parameter name="chooser">
<parameter_description> a #GtkFileChooser
@@ -6512,7 +6533,7 @@ file and is saving it for the first time, do not call this function.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error, or %NULL to ignore errors.
+<parameter_description> (allow-none): location to store the error, or %NULL to ignore errors.
</parameter_description>
</parameter>
</parameters>
@@ -6554,12 +6575,12 @@ page setup, or %NULL if an error occurred.
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group in the key_file to read, or %NULL
+<parameter_description> (allow-none): the name of the group in the key_file to read, or %NULL
to use the default name "Page Setup"
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7212,11 +7233,11 @@ Creates a new #GtkPrintUnixDialog.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -7264,7 +7285,7 @@ Since: 2.2
</parameter_description>
</parameter>
</parameters>
-<return> the #GParamSpec of the style property or %NULL if @class has no
+<return> (allow-none): the #GParamSpec of the style property or %NULL if @class has no
style property with that name.
</return>
</function>
@@ -7342,20 +7363,25 @@ Return value: %TRUE if the lines of the label are automatically wrapped.
<function name="SECTION">
<description>
-A #GtkToolItemGroup is used together with #GtkToolPalette to add
-#GtkToolItem<!-- -->s to a palette like container with different
-categories and drag and drop support.
-
-Since: 2.20
+The #GtkVScrollbar widget is a widget arranged vertically creating a
+scrollbar. See #GtkScrollbar for details on
+scrollbars. #GtkAdjustment pointers may be added to handle the
+adjustment of the scrollbar or it may be left %NULL in which case one
+will be created for you. See #GtkScrollbar for a description of what the
+fields in an adjustment represent for a scrollbar.
</description>
<parameters>
<parameter name="Short_description">
-<parameter_description> A sub container used in a tool palette
+<parameter_description> A vertical scrollbar
</parameter_description>
</parameter>
<parameter name="Title">
-<parameter_description> GtkToolItemGroup
+<parameter_description> GtkVScrollbar
+</parameter_description>
+</parameter>
+<parameter name="See_also">
+<parameter_description>#GtkScrollbar, #GtkScrolledWindow
</parameter_description>
</parameter>
</parameters>
@@ -7766,7 +7792,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> the human-readable-name for the filter, or %NULL
+<parameter_description> (allow-none): the human-readable-name for the filter, or %NULL
to remove any existing name.
</parameter_description>
</parameter>
@@ -7879,6 +7905,26 @@ invalidate the cached pixbufs.
<return></return>
</function>
+<function name="gtk_cell_renderer_set_sensitive">
+<description>
+Sets the cell renderer's sensitivity.
+
+Since: 2.18
+
+</description>
+<parameters>
+<parameter name="cell">
+<parameter_description> A #GtkCellRenderer
+</parameter_description>
+</parameter>
+<parameter name="sensitive">
+<parameter_description> the sensitivity of the cell
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_toolbar_get_style">
<description>
Retrieves whether the toolbar has text, icons, or both . See
@@ -8327,7 +8373,7 @@ This function is used by #GtkAction.
</description>
<parameters>
<parameter name="menu">
-<parameter_description> a #GtkMenu or %NULL
+<parameter_description> (allow-none): a #GtkMenu or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -8810,7 +8856,7 @@ with a pixbuf created by loading the image from @filename.
</parameter_description>
</parameter>
<parameter name="err">
-<parameter_description> location to store error, or %NULL.
+<parameter_description> (allow-none): location to store error, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -8859,7 +8905,7 @@ or a method on the #GtkTreeModel interface is called.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> An array of #GType types, one for each column
+<parameter_description> (array length=n_columns): An array of #GType types, one for each column
</parameter_description>
</parameter>
</parameters>
@@ -8966,7 +9012,7 @@ This function saves the information from @setup to @file_name.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -9138,11 +9184,11 @@ Queries an accelerator group for all entries matching @accel_key and
</parameter_description>
</parameter>
<parameter name="n_entries">
-<parameter_description> location to return the number of entries found, or %NULL
+<parameter_description> (allow-none): location to return the number of entries found, or %NULL
</parameter_description>
</parameter>
</parameters>
-<return> an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
+<return> (allow-none): an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
</return>
</function>
@@ -9430,7 +9476,7 @@ contents to reflect changes, if the @directory supports monitoring.
</parameter_description>
</parameter>
<parameter name="attributes">
-<parameter_description> attributes to immediately load or %NULL for all
+<parameter_description> (allow-none): attributes to immediately load or %NULL for all
</parameter_description>
</parameter>
<parameter name="get_func">
@@ -9687,6 +9733,18 @@ Since: 2.10
<return></return>
</function>
+<function name="gtk_vseparator_new">
+<description>
+Creates a new #GtkVSeparator.
+
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkVSeparator.
+</return>
+</function>
+
<function name="gtk_widget_get_parent_window">
<description>
Gets @widget's parent window.
@@ -9868,6 +9926,10 @@ resizes then you should add a reference to it.
</description>
<parameters>
+<parameter name="offscreen">
+<parameter_description> the #GtkOffscreenWindow contained widget.
+</parameter_description>
+</parameter>
</parameters>
<return> A #GdkPixmap pointer to the offscreen pixmap, or %NULL.
@@ -10142,11 +10204,11 @@ call gtk_action_group_add_action_with_accel().
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> The label displayed in menu items and on buttons, or %NULL
+<parameter_description> (allow-none): The label displayed in menu items and on buttons, or %NULL
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> A tooltip for this action, or %NULL
+<parameter_description> (allow-none): A tooltip for this action, or %NULL
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -11253,23 +11315,23 @@ in @x_offset and @y_offset are inclusive of the xpad and ypad properties.
</parameter_description>
</parameter>
<parameter name="cell_area">
-<parameter_description> The area a cell will be allocated, or %NULL
+<parameter_description> (allow-none): The area a cell will be allocated, or %NULL
</parameter_description>
</parameter>
<parameter name="x_offset">
-<parameter_description> location to return x offset of cell relative to @cell_area, or %NULL
+<parameter_description> (allow-none): location to return x offset of cell relative to @cell_area, or %NULL
</parameter_description>
</parameter>
<parameter name="y_offset">
-<parameter_description> location to return y offset of cell relative to @cell_area, or %NULL
+<parameter_description> (allow-none): location to return y offset of cell relative to @cell_area, or %NULL
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to return width needed to render a cell, or %NULL
+<parameter_description> (allow-none): location to return width needed to render a cell, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to return height needed to render a cell, or %NULL
+<parameter_description> (allow-none): location to return height needed to render a cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -11422,7 +11484,7 @@ Sets the row that is highlighted for feedback.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the row to highlight, or %NULL.
+<parameter_description> (allow-none): The path of the row to highlight, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
@@ -11710,7 +11772,7 @@ Creates a new scrollbar with the given orientation.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> the #GtkAdjustment to use, or %NULL to create a new adjustment.
+<parameter_description> (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment.
</parameter_description>
</parameter>
</parameters>
@@ -11798,7 +11860,7 @@ i.e. using g_object_set().
</description>
<parameters>
<parameter name="name">
-<parameter_description> tag name, or %NULL
+<parameter_description> (allow-none): tag name, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -11952,29 +12014,36 @@ Gets the value set by gtk_icon_source_set_direction_wildcarded().
</return>
</function>
-<function name="gtk_entry_buffer_set_text">
+<function name="gtk_stock_set_translate_func">
<description>
-Sets the text in the buffer.
-
-This is roughly equivalent to calling gtk_entry_buffer_delete_text()
-and gtk_entry_buffer_insert_text().
-
-Note that @n_chars is in characters, not in bytes.
+Sets a function to be used for translating the @label of
+a stock item.
-Since: 2.18
+If no function is registered for a translation domain,
+g_dgettext() is used.
-</description>
+The function is used for all stock items whose
+ translation_domain matches @domain. Note that it is possible
+to use strings different from the actual gettext translation domain
+of your application for this, as long as your #GtkTranslateFunc uses
+the correct domain when calling dgettext(). This can be useful, e.g.
+when dealing with message contexts.</description>
<parameters>
-<parameter name="buffer">
-<parameter_description> a #GtkEntryBuffer
+<parameter name="domain">
+<parameter_description> the translation domain for which @func shall be used
</parameter_description>
</parameter>
-<parameter name="chars">
-<parameter_description> the new text
+<parameter name="func">
+<parameter_description> a #GtkTranslateFunc
</parameter_description>
</parameter>
-<parameter name="n_chars">
-<parameter_description> the number of characters in @text, or -1
+<parameter name="data">
+<parameter_description> data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> a #GDestroyNotify that is called when @data is
+no longer needed
</parameter_description>
</parameter>
</parameters>
@@ -12073,7 +12142,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> A #GdkPixbuf, or %NULL
+<parameter_description> (allow-none): A #GdkPixbuf, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -12413,7 +12482,7 @@ Causes the given @text to appear superimposed on the progress bar.
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a UTF-8 string, or %NULL
+<parameter_description> (allow-none): a UTF-8 string, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -12715,11 +12784,11 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set the new row, or %NULL.
+<parameter_description> (allow-none): An unset #GtkTreeIter to set the new row, or %NULL.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="position">
@@ -13303,12 +13372,12 @@ file could not be loaded then error is set to either a #GFileError or
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group to use, or %NULL to use the default
+<parameter_description> (allow-none): the name of the group to use, or %NULL to use the default
"Print Settings"
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -14496,11 +14565,11 @@ Since: 2.20
</parameter_description>
</parameter>
<parameter name="slider_start">
-<parameter_description> return location for the slider's start, or %NULL
+<parameter_description> (allow-none): return location for the slider's start, or %NULL
</parameter_description>
</parameter>
<parameter name="slider_end">
-<parameter_description> return location for the slider's end, or %NULL
+<parameter_description> (allow-none): return location for the slider's end, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -14698,7 +14767,7 @@ See gtk_page_setup_to_file().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -15192,6 +15261,32 @@ the spacing that will be used for newly added columns.
</return>
</function>
+<function name="gtk_widget_style_attach">
+<description>
+This function attaches the widget's #GtkStyle to the widget's
+#GdkWindow. It is a replacement for
+
+<programlisting>
+widget->style = gtk_style_attach (widget->style, widget->window);
+</programlisting>
+
+and should only ever be called in a derived widget's "realize"
+implementation which does not chain up to its parent class'
+"realize" implementation, because one of the parent classes
+(finally #GtkWidget) would attach the style itself.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_paper_size_is_equal">
<description>
Compares two #GtkPaperSize objects.
@@ -15475,7 +15570,7 @@ will be.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget, or %NULL.
+<parameter_description> (allow-none): a #GtkWidget, or %NULL.
</parameter_description>
</parameter>
<parameter name="text">
@@ -15607,15 +15702,15 @@ gtk_dialog_new_with_buttons().
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL,
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL,
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in the first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in the first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -15738,7 +15833,7 @@ activatable, the function returns %FALSE.
Retrieves the current focused widget within the window.
Note that this is the widget that would have the focus
if the toplevel window focused; if the toplevel window
-is not focused then <literal>GTK_WIDGET_HAS_FOCUS (widget)</literal> will
+is not focused then <literal>gtk_widget_has_focus (widget)</literal> will
not be %TRUE for the widget.
@@ -16275,7 +16370,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="icon">
-<parameter_description> The icon to set, or %NULL
+<parameter_description> (allow-none): The icon to set, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -17053,7 +17148,7 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkItemFactory created for the given factory path, or %NULL
+<return> (allow-none): the #GtkItemFactory created for the given factory path, or %NULL
</return>
</function>
@@ -17112,7 +17207,7 @@ Removes a folder from a file chooser's list of shortcut folders.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -17402,6 +17497,39 @@ chooser entry and must not be modified or freed.
</return>
</function>
+<function name="gtk_activatable_do_set_related_action">
+<description>
+This is a utility function for #GtkActivatable implementors.
+
+When implementing #GtkActivatable you must call this when
+handling changes of the #GtkActivatable:related-action, and
+you must also use this to break references in #GObject->dispose().
+
+This function adds a reference to the currently set related
+action for you, it also makes sure the #GtkActivatable->update()
+method is called when the related #GtkAction properties change
+and registers to the action's proxy list.
+
+<note><para>Be careful to call this before setting the local
+copy of the #GtkAction property, since this function uses
+gtk_activatable_get_action() to retrieve the previous action</para></note>
+
+Since: 2.16
+
+</description>
+<parameters>
+<parameter name="activatable">
+<parameter_description> a #GtkActivatable
+</parameter_description>
+</parameter>
+<parameter name="action">
+<parameter_description> the #GtkAction to set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_event_box_get_above_child">
<description>
Return value: %TRUE if the event box window is above the window
@@ -17863,7 +17991,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> (array length=n_elements) (out): location to store a list of icon theme path directories or %NULL
+<parameter_description> (allow-none): (array length=n_elements) (out): location to store a list of icon theme path directories or %NULL
The stored value should be freed with g_strfreev().
</parameter_description>
</parameter>
@@ -17924,7 +18052,7 @@ Sets the #GtkAdjustment for the current vertical aspect.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> The #GtkAdjustment to set, or %NULL
+<parameter_description> (allow-none): The #GtkAdjustment to set, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -18110,13 +18238,13 @@ means render at the size of the source and don't scale.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> widget that will display the icon, or %NULL.
+<parameter_description> (allow-none): widget that will display the icon, or %NULL.
The only use that is typically made of this
is to determine the appropriate #GdkScreen.
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> detail to pass to the theme engine, or %NULL.
+<parameter_description> (allow-none): detail to pass to the theme engine, or %NULL.
Note that passing a detail of anything but %NULL
will disable caching.
</parameter_description>
@@ -18252,7 +18380,7 @@ Finds a child property of a container class by name.
</parameter_description>
</parameter>
</parameters>
-<return> the #GParamSpec of the child property or %NULL if @class has no
+<return> (allow-none): the #GParamSpec of the child property or %NULL if @class has no
child property with that name.
</return>
</function>
@@ -18365,11 +18493,11 @@ gtk_layout_set_size ().
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to store the width set on @layout, or %NULL
+<parameter_description> (allow-none): location to store the width set on @layout, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to store the height set on @layout, or %NULL
+<parameter_description> (allow-none): location to store the height set on @layout, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -19367,15 +19495,15 @@ to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a pointer to receive a #GtkTreeModel or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreeModel or %NULL
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a pointer to receive a #GtkTreePath or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreePath or %NULL
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a pointer to receive a #GtkTreeIter or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreeIter or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -19539,11 +19667,11 @@ you'd like the layout to use for scrolling, pass %NULL for
</description>
<parameters>
<parameter name="hadjustment">
-<parameter_description> horizontal scroll adjustment, or %NULL
+<parameter_description> (allow-none): horizontal scroll adjustment, or %NULL
</parameter_description>
</parameter>
<parameter name="vadjustment">
-<parameter_description> vertical scroll adjustment, or %NULL
+<parameter_description> (allow-none): vertical scroll adjustment, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -19689,7 +19817,7 @@ See gtk_print_settings_to_file().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -19901,6 +20029,24 @@ redrawn if any of their children changed allocation.
<return></return>
</function>
+<function name="gtk_widget_get_realized">
+<description>
+Determines whether @widget is realized.
+
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if @widget is realized, %FALSE otherwise
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_recent_manager_get_default">
<description>
Gets a unique instance of #GtkRecentManager, that you can share
@@ -19960,7 +20106,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="domain">
-<parameter_description> the translation domain or %NULL
+<parameter_description> (allow-none): the translation domain or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -20013,7 +20159,7 @@ or, if @widget is %NULL, release ownership of the selection.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> a #GtkWidget, or %NULL.
+<parameter_description> (allow-none): a #GtkWidget, or %NULL.
</parameter_description>
</parameter>
<parameter name="selection">
@@ -20686,7 +20832,7 @@ for more information.
</parameter_description>
</parameter>
<parameter name="shape_mask">
-<parameter_description> shape to be added, or %NULL to remove an existing shape
+<parameter_description> (allow-none): shape to be added, or %NULL to remove an existing shape
</parameter_description>
</parameter>
<parameter name="offset_x">
@@ -20916,7 +21062,7 @@ Sets the #GtkAdjustment for the current horizontal aspect.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> The #GtkAdjustment to set, or %NULL
+<parameter_description> (allow-none): The #GtkAdjustment to set, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -21170,7 +21316,7 @@ submenu is passed.
</parameter_description>
</parameter>
<parameter name="submenu">
-<parameter_description> the submenu, or %NULL
+<parameter_description> (allow-none): the submenu, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -21525,11 +21671,11 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="xalign">
-<parameter_description> location to fill in with the x alignment of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the x alignment of the cell, or %NULL
</parameter_description>
</parameter>
<parameter name="yalign">
-<parameter_description> location to fill in with the y alignment of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the y alignment of the cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -21569,11 +21715,11 @@ See gtk_misc_set_padding().
</parameter_description>
</parameter>
<parameter name="xpad">
-<parameter_description> location to store padding in the X direction, or %NULL
+<parameter_description> (allow-none): location to store padding in the X direction, or %NULL
</parameter_description>
</parameter>
<parameter name="ypad">
-<parameter_description> location to store padding in the Y direction, or %NULL
+<parameter_description> (allow-none): location to store padding in the Y direction, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -21933,7 +22079,7 @@ widget coordinates to bin_window coordinates.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path, or %NULL
+<parameter_description> (allow-none): Return location for the path, or %NULL
</parameter_description>
</parameter>
<parameter name="cell">
@@ -22505,15 +22651,15 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath or %NULL
+<parameter_description> (allow-none): a #GtkTreePath or %NULL
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn or %NULL
+<parameter_description> (allow-none): a #GtkTreeViewColumn or %NULL
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer or %NULL
+<parameter_description> (allow-none): a #GtkCellRenderer or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -22850,33 +22996,14 @@ so expect those.
<return></return>
</function>
-<function name="gtk_activatable_do_set_related_action">
+<function name="gtk_spin_button_update">
<description>
-This is a utility function for #GtkActivatable implementors.
-
-When implementing #GtkActivatable you must call this when
-handling changes of the #GtkActivatable:related-action, and
-you must also use this to break references in #GObject->dispose().
-
-This function adds a reference to the currently set related
-action for you, it also makes sure the #GtkActivatable->update()
-method is called when the related #GtkAction properties change
-and registers to the action's proxy list.
-
-<note><para>Be careful to call this before setting the local
-copy of the #GtkAction property, since this function uses
-gtk_activatable_get_action() to retrieve the previous action</para></note>
-
-Since: 2.16
+Manually force an update of the spin button.
</description>
<parameters>
-<parameter name="activatable">
-<parameter_description> a #GtkActivatable
-</parameter_description>
-</parameter>
-<parameter name="action">
-<parameter_description> the #GtkAction to set
+<parameter name="spin_button">
+<parameter_description> a #GtkSpinButton
</parameter_description>
</parameter>
</parameters>
@@ -22986,7 +23113,7 @@ Since the returned array is %NULL terminated, @length may be %NULL.
</parameter_description>
</parameter>
<parameter name="length">
-<parameter_description> return location for a the length of the URI list, or %NULL
+<parameter_description> (allow-none): return location for a the length of the URI list, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -23174,7 +23301,7 @@ Creates a new horizontal scrollbar.
</description>
<parameters>
<parameter name="adjustment">
-<parameter_description> the #GtkAdjustment to use, or %NULL to create a new adjustment
+<parameter_description> (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment
</parameter_description>
</parameter>
</parameters>
@@ -23299,7 +23426,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row, or %NULL.
+<parameter_description> (allow-none): An unset #GtkTreeIter to set to the new row, or %NULL.
</parameter_description>
</parameter>
<parameter name="position">
@@ -23497,9 +23624,29 @@ of the editable. Note that @position is in characters, not in bytes.
<return></return>
</function>
+<function name="gtk_window_set_mnemonics_visible">
+<description>
+Sets the #GtkWindow:mnemonics-visible property.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+<parameter name="setting">
+<parameter_description> the new value
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_clipboard_get">
<description>
-Return value: the appropriate clipboard object. If no clipboard
+Return value: (transfer none): the appropriate clipboard object. If no clipboard
</description>
<parameters>
@@ -23508,7 +23655,7 @@ Return value: the appropriate clipboard object. If no clipboard
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object. If no clipboard
+<return> (transfer none): the appropriate clipboard object. If no clipboard
already exists, a new one will be created. Once a clipboard
object has been created, it is persistent and, since it is
owned by GTK+, must not be freed or unreffed.
@@ -23530,6 +23677,26 @@ Return value: The current width of @tree_column.
</return>
</function>
+<function name="gtk_vbox_new">
+<description>
+Creates a new #GtkVBox.
+
+
+</description>
+<parameters>
+<parameter name="homogeneous">
+<parameter_description> %TRUE if all children are to be given equal space allotments.
+</parameter_description>
+</parameter>
+<parameter name="spacing">
+<parameter_description> the number of pixels to place by default between children.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkVBox.
+</return>
+</function>
+
<function name="gtk_notebook_get_tab_label">
<description>
Return value: (transfer none): the tab label
@@ -23696,7 +23863,7 @@ still to come.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -23742,11 +23909,11 @@ that somewhat like strcmp() returning 0 for equality
</parameter_description>
</parameter>
<parameter name="search_user_data">
-<parameter_description> user data to pass to @search_equal_func, or %NULL
+<parameter_description> (allow-none): user data to pass to @search_equal_func, or %NULL
</parameter_description>
</parameter>
<parameter name="search_destroy">
-<parameter_description> Destroy notifier for @search_user_data, or %NULL
+<parameter_description> (allow-none): Destroy notifier for @search_user_data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -23843,7 +24010,7 @@ Internal function, see gtk_file_chooser_set_current_folder_uri().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL.
+<parameter_description> (allow-none): location to store error, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -24036,7 +24203,7 @@ or up/down arrow event occurs (usually 2)
</parameter_description>
</parameter>
<parameter name="icons">
-<parameter_description> a %NULL-terminated array of icon names, or %NULL if
+<parameter_description> (allow-none): a %NULL-terminated array of icon names, or %NULL if
you want to set the list later with gtk_scale_button_set_icons()
</parameter_description>
</parameter>
@@ -24610,11 +24777,7 @@ the model uptodate.
Note that @func is called whenever a row is inserted, when it may still be
empty. The visible function should therefore take special care of empty
-rows.
-
-Since: 2.4
-
-</description>
+rows.</description>
<parameters>
<parameter name="filter">
<parameter_description> A #GtkTreeModelFilter.
@@ -24625,11 +24788,11 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> User data to pass to the visible function, or %NULL.
+<parameter_description> (allow-none): User data to pass to the visible function, or %NULL.
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @data, or %NULL.
+<parameter_description> (allow-none): Destroy notifier of @data, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -25282,11 +25445,11 @@ have a customized instance of a #GtkRecentManager object.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL,
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL,
</parameter_description>
</parameter>
<parameter name="manager">
@@ -25294,7 +25457,7 @@ have a customized instance of a #GtkRecentManager object.
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in the first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in the first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -25461,7 +25624,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the window, or %NULL
+<parameter_description> (allow-none): transient parent of the window, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -25840,7 +26003,7 @@ see gtk_accel_group_connect().
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkAccelGroup to which @closure is connected, or %NULL.
+<return> (allow-none): the #GtkAccelGroup to which @closure is connected, or %NULL.
</return>
</function>
@@ -25998,8 +26161,7 @@ inside a #GtkSocket within the same application.
To reliably find the toplevel #GtkWindow, use
gtk_widget_get_toplevel() and check if the %TOPLEVEL flags
-is set on the result.
-</description>
+is set on the result.</description>
<parameters>
<parameter name="widget">
<parameter_description> a #GtkWidget
@@ -26150,12 +26312,12 @@ a #GFileError or #GKeyFileError.
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group to use, or %NULL to use
+<parameter_description> (allow-none): the name of the group to use, or %NULL to use
the default "Print Settings"
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -26312,6 +26474,38 @@ Since: 2.10
</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>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="start_button_mask">
+<parameter_description> the bitmask of buttons that can start the drag
+</parameter_description>
+</parameter>
+<parameter name="targets">
+<parameter_description> (allow-none) (array length=n_targets): the table of targets that the drag will support,
+may be %NULL
+</parameter_description>
+</parameter>
+<parameter name="n_targets">
+<parameter_description> the number of items in @targets
+</parameter_description>
+</parameter>
+<parameter name="actions">
+<parameter_description> the bitmask of possible actions for a drag from this widget
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_widget_pop_colormap">
<description>
Removes a colormap pushed with gtk_widget_push_colormap().
@@ -26412,11 +26606,11 @@ gtk_spin_button_set_increments().
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> location to store step increment, or %NULL
+<parameter_description> (allow-none): location to store step increment, or %NULL
</parameter_description>
</parameter>
<parameter name="page">
-<parameter_description> location to store page increment, or %NULL
+<parameter_description> (allow-none): location to store page increment, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -26818,7 +27012,7 @@ Since: 2.4
<function name="gtk_clipboard_get_for_display">
<description>
-Return value: the appropriate clipboard object. If no
+Return value: (transfer none): the appropriate clipboard object. If no
</description>
<parameters>
@@ -26832,7 +27026,7 @@ to use.
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object. If no
+<return> (transfer none): the appropriate clipboard object. If no
clipboard already exists, a new one will
be created. Once a clipboard object has
been created, it is persistent and, since
@@ -26875,7 +27069,7 @@ This function is used in the implementation of #GtkUIManager.
</description>
<parameters>
<parameter name="action">
-<parameter_description> a #GtkAction, or %NULL to determine the action from @proxy
+<parameter_description> (allow-none): a #GtkAction, or %NULL to determine the action from @proxy
</parameter_description>
</parameter>
<parameter name="proxy">
@@ -26957,7 +27151,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer or %NULL
+<parameter_description> (allow-none): a #GtkCellRenderer or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -27390,7 +27584,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> child object or %NULL for non-child tags
+<parameter_description> (allow-none): child object or %NULL for non-child tags
</parameter_description>
</parameter>
<parameter name="tagname">
@@ -27520,21 +27714,28 @@ Gets the value set by gtk_range_set_inverted().
</return>
</function>
-<function name="gtk_about_dialog_set_program_name">
+<function name="gtk_widget_set_window">
<description>
-Sets the name to display in the about dialog.
-If this is not set, it defaults to g_get_application_name().
+Sets a widget's window. This function should only be used in a
+widget's GtkWidget::realize() implementation. The %window passed is
+usually either new window created with gdk_window_new(), or the
+window of its parent widget as returned by
+gtk_widget_get_parent_window().
-Since: 2.12
+Widgets must indicate whether they will create their own #GdkWindow
+by calling gtk_widget_set_has_window(). This is usually done in the
+widget's init() function.
+
+Since: 2.18
</description>
<parameters>
-<parameter name="about">
-<parameter_description> a #GtkAboutDialog
+<parameter name="widget">
+<parameter_description> a #GtkWidget
</parameter_description>
</parameter>
-<parameter name="name">
-<parameter_description> the program name
+<parameter name="window">
+<parameter_description> a #GdkWindow
</parameter_description>
</parameter>
</parameters>
@@ -27592,11 +27793,11 @@ Creates a new page setup dialog.
</description>
<parameters>
<parameter name="title">
-<parameter_description> the title of the dialog, or %NULL
+<parameter_description> (allow-none): the title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -27878,7 +28079,7 @@ Selects @uri inside @chooser.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> (allow-none): return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -28361,11 +28562,11 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter_description> (allow-none): user data to pass to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> destroy notifier for @data, or %NULL
+<parameter_description> (allow-none): destroy notifier for @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -28391,7 +28592,7 @@ call gtk_tree_store_set() or gtk_tree_store_set_value().
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -28636,7 +28837,7 @@ on disk. Warns on failure if @err is %NULL.
</parameter_description>
</parameter>
<parameter name="err">
-<parameter_description> location to store error, or %NULL.
+<parameter_description> (allow-none): location to store error, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -28646,28 +28847,21 @@ Since: 2.2
</return>
</function>
-<function name="gtk_widget_set_window">
+<function name="gtk_about_dialog_set_program_name">
<description>
-Sets a widget's window. This function should only be used in a
-widget's GtkWidget::realize() implementation. The %window passed is
-usually either new window created with gdk_window_new(), or the
-window of its parent widget as returned by
-gtk_widget_get_parent_window().
-
-Widgets must indicate whether they will create their own #GdkWindow
-by calling gtk_widget_set_has_window(). This is usually done in the
-widget's init() function.
+Sets the name to display in the about dialog.
+If this is not set, it defaults to g_get_application_name().
-Since: 2.18
+Since: 2.12
</description>
<parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter name="about">
+<parameter_description> a #GtkAboutDialog
</parameter_description>
</parameter>
-<parameter name="window">
-<parameter_description> a #GdkWindow
+<parameter name="name">
+<parameter_description> the program name
</parameter_description>
</parameter>
</parameters>
@@ -29050,8 +29244,7 @@ gtk_accel_label_set_accel_widget().
</parameter_description>
</parameter>
</parameters>
-<return> the object monitored by the accelerator label,
-or %NULL.
+<return> the object monitored by the accelerator label, or %NULL.
</return>
</function>
@@ -29133,11 +29326,11 @@ return %FALSE if @tree_view is not realized or does not have a model.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the highlighted row, or %NULL.
+<parameter_description> (allow-none): Return location for the path of the highlighted row, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> (allow-none): Return location for the drop position, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -29279,7 +29472,7 @@ This is called for each unknown element under <child>.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> child object or %NULL for non-child tags
+<parameter_description> (allow-none): child object or %NULL for non-child tags
</parameter_description>
</parameter>
<parameter name="tagname">
@@ -29467,7 +29660,7 @@ UI definition</link> and merges it with the current contents of @builder.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -29587,11 +29780,11 @@ names.
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the label displayed in menu items and on buttons, or %NULL
+<parameter_description> (allow-none): the label displayed in menu items and on buttons, or %NULL
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a tooltip for the action, or %NULL
+<parameter_description> (allow-none): a tooltip for the action, or %NULL
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -29898,22 +30091,31 @@ display lines vs. paragraphs.
</return>
</function>
-<function name="gtk_window_group_list_windows">
+<function name="gtk_widget_get_requisition">
<description>
-Returns: (element-type GtkWidget) (transfer container): A newly-allocated list of
+Retrieves the widget's requisition.
+
+This function should only be used by widget implementations in
+order to figure whether the widget's requisition has actually
+changed after some internal state change (so that they can call
+gtk_widget_queue_resize() instead of gtk_widget_queue_draw()).
+
+Normally, gtk_widget_size_request() should be used.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="window_group">
-<parameter_description> a #GtkWindowGroup
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="requisition">
+<parameter_description> (out): a pointer to a #GtkRequisition to copy to
</parameter_description>
</parameter>
</parameters>
-<return> (element-type GtkWidget) (transfer container): A newly-allocated list of
-windows inside the group.
-
-Since: 2.14
-</return>
+<return></return>
</function>
<function name="gtk_menu_tool_button_get_menu">
@@ -30313,8 +30515,7 @@ managers to honor the geometry.
Note that for gtk_window_parse_geometry() to work as expected, it has
to be called when the window has its "final" size, i.e. after calling
gtk_widget_show_all() on the contents and gtk_window_set_geometry_hints()
-on the window.
-</description>
+on the window.</description>
<parameters>
<parameter name="window">
<parameter_description> a #GtkWindow
@@ -31064,7 +31265,7 @@ function is set.
</parameter_description>
</parameter>
<parameter name="child_model">
-<parameter_description> A #GtkTreeModel, or %NULL.
+<parameter_description> (allow-none): A #GtkTreeModel, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -31185,7 +31386,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): The #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -31311,7 +31512,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="action">
-<parameter_description> the related #GtkAction or %NULL
+<parameter_description> (allow-none): the related #GtkAction or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -31488,11 +31689,11 @@ used.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to store the default width, or %NULL
+<parameter_description> (allow-none): location to store the default width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to store the default height, or %NULL
+<parameter_description> (allow-none): location to store the default height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -31708,6 +31909,23 @@ Return value: %TRUE if arrows for scrolling are present
</return>
</function>
+<function name="gtk_paned_get_handle_window">
+<description>
+Return value: the paned's handle window.
+
+</description>
+<parameters>
+<parameter name="panede">
+<parameter_description> a #GtkPaned
+</parameter_description>
+</parameter>
+</parameters>
+<return> the paned's handle window.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_print_settings_get_n_copies">
<description>
Gets the value of %GTK_PRINT_SETTINGS_N_COPIES.
@@ -31738,11 +31956,11 @@ gtk_frame_set_label_align().
</parameter_description>
</parameter>
<parameter name="xalign">
-<parameter_description> location to store X alignment of frame's label, or %NULL
+<parameter_description> (allow-none): location to store X alignment of frame's label, or %NULL
</parameter_description>
</parameter>
<parameter name="yalign">
-<parameter_description> location to store X alignment of frame's label, or %NULL
+<parameter_description> (allow-none): location to store X alignment of frame's label, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -32524,7 +32742,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> child object or %NULL for non-child tags
+<parameter_description> (allow-none): child object or %NULL for non-child tags
</parameter_description>
</parameter>
<parameter name="tagname">
@@ -32600,7 +32818,7 @@ If @pred never returns %TRUE, @iter is set to @limit if
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> search limit, or %NULL for none
+<parameter_description> (allow-none): search limit, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -32885,7 +33103,7 @@ the "response" signal with the corresponding response ID.
</description>
<parameters>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -32979,11 +33197,11 @@ this function.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> (out): return location for width, or %NULL
+<parameter_description> (allow-none): (out): return location for width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> (out): return location for height, or %NULL
+<parameter_description> (allow-none): (out): return location for height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -33604,8 +33822,7 @@ you should use this function if you already have a file name to which the
user may save; for example, when the user opens an existing file and then
does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have
a file name already — for example, if the user just created a new
-file and is saving it for the first time, do not call this function.
-</description>
+file and is saving it for the first time, do not call this function.</description>
<parameters>
<parameter name="chooser">
<parameter_description> a #GtkFileChooser
@@ -33753,15 +33970,15 @@ user collapses a row, or a row is deleted.
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> Function to be called when a view row is destroyed, or %NULL
+<parameter_description> (allow-none): Function to be called when a view row is destroyed, or %NULL
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> User data to be passed to @func, or %NULL
+<parameter_description> (allow-none): User data to be passed to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier for @data, or %NULL
+<parameter_description> (allow-none): Destroy notifier for @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -33975,7 +34192,7 @@ returned by this function will be scaled to the exact size.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error information on failure, or %NULL.
+<parameter_description> (allow-none): location to store error information on failure, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -34124,7 +34341,7 @@ Look up a named tag.
</parameter_description>
</parameter>
</parameters>
-<return> The tag, or %NULL if none by that name is in the table.
+<return> (transfer none): The tag, or %NULL if none by that name is in the table.
</return>
</function>
@@ -34142,7 +34359,7 @@ Since 2.20 @closure can be %NULL.
</parameter_description>
</parameter>
<parameter name="closure">
-<parameter_description> the closure to remove from this accelerator group, or %NULL
+<parameter_description> (allow-none): the closure to remove from this accelerator group, or %NULL
to remove all closures
</parameter_description>
</parameter>
@@ -34362,7 +34579,7 @@ list handled by a recent manager.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> (allow-none): return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -34398,11 +34615,11 @@ Gets information about the row that is highlighted for feedback.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the highlighted row, or %NULL.
+<parameter_description> (allow-none): Return location for the path of the highlighted row, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> (allow-none): Return location for the drop position, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -34738,15 +34955,15 @@ See gtk_ruler_set_range().
</parameter_description>
</parameter>
<parameter name="lower">
-<parameter_description> location to store lower limit of the ruler, or %NULL
+<parameter_description> (allow-none): location to store lower limit of the ruler, or %NULL
</parameter_description>
</parameter>
<parameter name="upper">
-<parameter_description> location to store upper limit of the ruler, or %NULL
+<parameter_description> (allow-none): location to store upper limit of the ruler, or %NULL
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> location to store the current position of the mark on the ruler, or %NULL
+<parameter_description> (allow-none): location to store the current position of the mark on the ruler, or %NULL
</parameter_description>
</parameter>
<parameter name="max_size">
@@ -34789,11 +35006,11 @@ See gtk_misc_set_alignment().
</parameter_description>
</parameter>
<parameter name="xalign">
-<parameter_description> location to store X alignment of @misc, or %NULL
+<parameter_description> (allow-none): location to store X alignment of @misc, or %NULL
</parameter_description>
</parameter>
<parameter name="yalign">
-<parameter_description> location to store Y alignment of @misc, or %NULL
+<parameter_description> (allow-none): location to store Y alignment of @misc, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -34948,7 +35165,7 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -35359,6 +35576,24 @@ Since: 2.6
</return>
</function>
+<function name="gtk_window_group_list_windows">
+<description>
+Returns: (element-type GtkWidget) (transfer container): A newly-allocated list of
+
+</description>
+<parameters>
+<parameter name="window_group">
+<parameter_description> a #GtkWindowGroup
+</parameter_description>
+</parameter>
+</parameters>
+<return> (element-type GtkWidget) (transfer container): A newly-allocated list of
+windows inside the group.
+
+Since: 2.14
+</return>
+</function>
+
<function name="gtk_text_view_get_line_yrange">
<description>
Gets the y coordinate of the top of the line containing @iter,
@@ -35538,11 +35773,11 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="sort_data">
-<parameter_description> user data to pass to @sort_func, or %NULL
+<parameter_description> (allow-none): user data to pass to @sort_func, or %NULL
</parameter_description>
</parameter>
<parameter name="data_destroy">
-<parameter_description> destroy notifier for @sort_data, or %NULL
+<parameter_description> (allow-none): destroy notifier for @sort_data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -35590,7 +35825,7 @@ arguments. Use G_CALLBACK() to cast the function to #GCallback.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget, or %NULL
+<parameter_description> (allow-none): a #GtkWidget, or %NULL
</parameter_description>
</parameter>
<parameter name="text">
@@ -35788,8 +36023,8 @@ increment the reference count of the returned object.
</parameter_description>
</parameter>
</parameters>
-<return> the object named @name or %NULL if it could not be
-found in the object tree.
+<return> (transfer none): the object named @name or %NULL if
+it could not be found in the object tree.
Since: 2.12
</return>
@@ -36575,7 +36810,7 @@ changing the stock pixbuf for #GTK_STOCK_DND instead.
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> the transparency mask for an image.
+<parameter_description> (allow-none): the transparency mask for an image, or %NULL
</parameter_description>
</parameter>
<parameter name="hot_x">
@@ -36714,7 +36949,7 @@ arguments. Use G_CALLBACK() to cast the function to #GCallback.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget, or %NULL.
+<parameter_description> (allow-none): a #GtkWidget, or %NULL.
</parameter_description>
</parameter>
<parameter name="text">
@@ -37078,11 +37313,11 @@ call gtk_action_group_add_action_with_accel().
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the label displayed in menu items and on buttons, or %NULL
+<parameter_description> (allow-none): the label displayed in menu items and on buttons, or %NULL
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a tooltip for the action, or %NULL
+<parameter_description> (allow-none): a tooltip for the action, or %NULL
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -37091,7 +37326,7 @@ action, or %NULL
</parameter_description>
</parameter>
<parameter name="manager">
-<parameter_description> a #GtkRecentManager, or %NULL for using the default
+<parameter_description> (allow-none): a #GtkRecentManager, or %NULL for using the default
#GtkRecentManager
</parameter_description>
</parameter>
@@ -37160,7 +37395,7 @@ file could not be loaded then error is set to either a #GFileError or
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37198,7 +37433,7 @@ its child (for instance a #GtkTreeView that depends on its
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37279,7 +37514,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="stock_id">
-<parameter_description> The name of the stock item, or %NULL
+<parameter_description> (allow-none): The name of the stock item, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37308,7 +37543,7 @@ gtk_tree_store_set_value().
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="position">
@@ -37328,7 +37563,7 @@ will be correctly filled in.
</description>
<parameters>
<parameter name="recipient">
-<parameter_description> window to which to send the window, or %NULL
+<parameter_description> (allow-none): window to which to send the window, or %NULL
in which case nothing will be sent
</parameter_description>
</parameter>
@@ -37449,7 +37684,7 @@ Since: 2.6
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL for none
+<parameter_description> (allow-none): transient parent, or %NULL for none
</parameter_description>
</parameter>
<parameter name="first_property_name">
@@ -37557,7 +37792,7 @@ its child (for instance a #GtkTreeView that depends on its
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -37706,11 +37941,11 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38011,15 +38246,15 @@ Obtains the selected date from a #GtkCalendar.
</parameter_description>
</parameter>
<parameter name="year">
-<parameter_description> location to store the year number, or %NULL
+<parameter_description> (allow-none): location to store the year number, or %NULL
</parameter_description>
</parameter>
<parameter name="month">
-<parameter_description> location to store the month number (between 0 and 11), or %NULL
+<parameter_description> (allow-none): location to store the month number (between 0 and 11), or %NULL
</parameter_description>
</parameter>
<parameter name="day">
-<parameter_description> location to store the day number (between 1 and 31), or %NULL
+<parameter_description> (allow-none): location to store the day number (between 1 and 31), or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38069,11 +38304,11 @@ The returned #GtkTreePath must be freed with gtk_tree_path_free().
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the current cursor path, or %NULL
+<parameter_description> (allow-none): Return location for the current cursor path, or %NULL
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> Return location the current focus cell, or %NULL
+<parameter_description> (allow-none): Return location the current focus cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38172,11 +38407,11 @@ Since: 2.8
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the highlighted item, or %NULL.
+<parameter_description> (allow-none): Return location for the path of the highlighted item, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> (allow-none): Return location for the drop position, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -38337,7 +38572,7 @@ references to symbolic colors.
</parameter_description>
</parameter>
<parameter name="style">
-<parameter_description> a #GtkRcStyle, or %NULL
+<parameter_description> (allow-none): a #GtkRcStyle, or %NULL
</parameter_description>
</parameter>
<parameter name="color">
@@ -38937,7 +39172,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> the contents of the tooltip for the icon, or %NULL
+<parameter_description> (allow-none): the contents of the tooltip for the icon, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -39036,7 +39271,7 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="target_list">
-<parameter_description> list of draggable targets, or %NULL for none
+<parameter_description> (allow-none): list of draggable targets, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -39063,11 +39298,11 @@ itself, excluding surrounding borders and the tree expander area.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+<parameter_description> (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
+<parameter_description> (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
</parameter_description>
</parameter>
<parameter name="rect">
@@ -39599,7 +39834,7 @@ the print job should be rendered.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -39665,7 +39900,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="custom_widget">
-<parameter_description> a #GtkWidget, or %NULL to unset the old custom widget.
+<parameter_description> (allow-none): a #GtkWidget, or %NULL to unset the old custom widget.
</parameter_description>
</parameter>
</parameters>
@@ -39696,6 +39931,22 @@ Since: 2.10
</return>
</function>
+<function name="gtk_accel_label_new">
+<description>
+Creates a new #GtkAccelLabel.
+
+
+</description>
+<parameters>
+<parameter name="string">
+<parameter_description> the label string. Must be non-%NULL.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkAccelLabel.
+</return>
+</function>
+
<function name="gtk_target_list_unref">
<description>
Decreases the reference count of a #GtkTargetList by one.
@@ -39922,27 +40173,6 @@ Since: 2.6
<return></return>
</function>
-<function name="gtk_tool_item_group_header_relief">
-<description>
-Set the button relief of the group header.
-See gtk_button_set_relief() for details.
-
-Since: 2.20
-
-</description>
-<parameters>
-<parameter name="group">
-<parameter_description> a #GtkToolItemGroup
-</parameter_description>
-</parameter>
-<parameter name="style">
-<parameter_description> the #GtkReliefStyle
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_range_set_show_fill_level">
<description>
Sets whether a graphical fill level is show on the trough. See
@@ -40096,11 +40326,11 @@ is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to @sort_func, or %NULL
+<parameter_description> (allow-none): User data to pass to @sort_func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @user_data, or %NULL
+<parameter_description> (allow-none): Destroy notifier of @user_data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -40154,11 +40384,7 @@ up additional columns in a #GtkComboBox.
Note that GTK+ doesn't guarantee that cell renderers will
continue to use the same kind of widget for editing in future
releases, therefore you should check the type of @editable
-before doing any specific setup.
-
-Since: 2.6
-
-</description>
+before doing any specific setup.</description>
<parameters>
<parameter name="renderer">
<parameter_description> the object which received the signal
@@ -40408,19 +40634,19 @@ be used instead.
</parameter_description>
</parameter>
<parameter name="parent_menu_shell">
-<parameter_description> the menu shell containing the triggering menu item, or %NULL
+<parameter_description> (allow-none): the menu shell containing the triggering menu item, or %NULL
</parameter_description>
</parameter>
<parameter name="parent_menu_item">
-<parameter_description> the menu item whose activation triggered the popup, or %NULL
+<parameter_description> (allow-none): the menu item whose activation triggered the popup, or %NULL
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> a user supplied function used to position the menu, or %NULL
+<parameter_description> (allow-none): a user supplied function used to position the menu, or %NULL
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user supplied data to be passed to @func.
+<parameter_description> (allow-none): user supplied data to be passed to @func.
</parameter_description>
</parameter>
<parameter name="button">
@@ -40530,7 +40756,7 @@ Creates a new text buffer.
</description>
<parameters>
<parameter name="table">
-<parameter_description> a tag table, or %NULL to create a new one
+<parameter_description> (allow-none): a tag table, or %NULL to create a new one
</parameter_description>
</parameter>
</parameters>
@@ -41204,7 +41430,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> the contents of the tooltip for @widget, or %NULL
+<parameter_description> (allow-none): the contents of the tooltip for @widget, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -41306,7 +41532,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> the contents of the tooltip for @status_icon, or %NULL
+<parameter_description> (allow-none): the contents of the tooltip for @status_icon, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -41398,7 +41624,7 @@ Creates a new #GtkRadioToolButton, adding it to @group.
</description>
<parameters>
<parameter name="group">
-<parameter_description> An existing radio button group, or %NULL if you are creating a new group
+<parameter_description> (allow-none): An existing radio button group, or %NULL if you are creating a new group
</parameter_description>
</parameter>
</parameters>
@@ -41484,7 +41710,7 @@ use style->font_desc instead.
</parameter_description>
</parameter>
<parameter name="font">
-<parameter_description> a #GdkFont, or %NULL to use the #GdkFont corresponding
+<parameter_description> (allow-none): a #GdkFont, or %NULL to use the #GdkFont corresponding
to style->font_desc.
</parameter_description>
</parameter>
@@ -41550,46 +41776,6 @@ Since: 2.6
</return>
</function>
-<function name="gtk_stock_set_translate_func">
-<description>
-Sets a function to be used for translating the @label of
-a stock item.
-
-If no function is registered for a translation domain,
-g_dgettext() is used.
-
-The function is used for all stock items whose
- translation_domain matches @domain. Note that it is possible
-to use strings different from the actual gettext translation domain
-of your application for this, as long as your #GtkTranslateFunc uses
-the correct domain when calling dgettext(). This can be useful, e.g.
-when dealing with message contexts.
-
-Since: 2.8
-
-</description>
-<parameters>
-<parameter name="domain">
-<parameter_description> the translation domain for which @func shall be used
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> a #GtkTranslateFunc
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to @func
-</parameter_description>
-</parameter>
-<parameter name="notify">
-<parameter_description> a #GDestroyNotify that is called when @data is
-no longer needed
-</parameter_description>
-</parameter>
-</parameters>
-<return></return>
-</function>
-
<function name="gtk_combo_box_get_row_separator_func">
<description>
Return value: the current row separator function.
@@ -41785,6 +41971,8 @@ of the parameters.
Deprecated: 2.20: Modify the #GtkNotebook:tab-expand and
#GtkNotebook:tab-fill child properties instead.
+Modifying the packing of the tab label is a deprecated feature and
+shouldn't be done anymore.
</description>
<parameters>
@@ -41797,15 +41985,15 @@ Deprecated: 2.20: Modify the #GtkNotebook:tab-expand and
</parameter_description>
</parameter>
<parameter name="expand">
-<parameter_description> whether to expand the bookmark or not
+<parameter_description> whether to expand the tab label or not
</parameter_description>
</parameter>
<parameter name="fill">
-<parameter_description> whether the bookmark should fill the allocated area or not
+<parameter_description> whether the tab label should fill the allocated area or not
</parameter_description>
</parameter>
<parameter name="pack_type">
-<parameter_description> the position of the bookmark
+<parameter_description> the position of the tab label
</parameter_description>
</parameter>
</parameters>
@@ -41945,7 +42133,7 @@ initiated through programatic means.
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> A #GdkEvent, or %NULL
+<parameter_description> (allow-none): A #GdkEvent, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42178,7 +42366,7 @@ Directories are always visible.
</parameter_description>
</parameter>
<parameter name="filter">
-<parameter_description> %NULL or filter to use
+<parameter_description> (allow-none): %NULL or filter to use
</parameter_description>
</parameter>
</parameters>
@@ -42681,11 +42869,11 @@ Since: 2.18
</parameter_description>
</parameter>
<parameter name="xpad">
-<parameter_description> location to fill in with the x padding of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the x padding of the cell, or %NULL
</parameter_description>
</parameter>
<parameter name="ypad">
-<parameter_description> location to fill in with the y padding of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the y padding of the cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42749,7 +42937,7 @@ The returned pixmap can be %NULL, if the resulting @clip_area was empty.
</parameter_description>
</parameter>
<parameter name="clip_rect">
-<parameter_description> a #GdkRectangle or %NULL
+<parameter_description> (allow-none): a #GdkRectangle or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -42966,7 +43154,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> An icon name, or %NULL
+<parameter_description> (allow-none): An icon name, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -43180,11 +43368,11 @@ handle the details for you.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> (out): return location for width, or %NULL
+<parameter_description> (allow-none): (out): return location for width, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> (out): return location for height, or %NULL
+<parameter_description> (allow-none): (out): return location for height, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -43373,7 +43561,7 @@ gtk_drag_dest_set().
</parameter_description>
</parameter>
<parameter name="target_list">
-<parameter_description> list of droppable targets, or %NULL for none
+<parameter_description> (allow-none): list of droppable targets, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -43443,24 +43631,18 @@ Since: 2.20
</return>
</function>
-<function name="gtk_tree_model_get_iter_first">
+<function name="gtk_tree_path_get_depth">
<description>
-Initializes @iter with the first iterator in the tree (the one at the path
-"0") and returns %TRUE. Returns %FALSE if the tree is empty.
-
+Return value: The depth of @path
</description>
<parameters>
-<parameter name="tree_model">
-<parameter_description> A #GtkTreeModel.
-</parameter_description>
-</parameter>
-<parameter name="iter">
-<parameter_description> The uninitialized #GtkTreeIter.
+<parameter name="path">
+<parameter_description> A #GtkTreePath.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE, if @iter was set.
+<return> The depth of @path
</return>
</function>
@@ -43700,16 +43882,16 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the function to use to position the search dialog, or %NULL
+<parameter_description> (allow-none): the function to use to position the search dialog, or %NULL
to use the default search position function
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter_description> (allow-none): user data to pass to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier for @data, or %NULL
+<parameter_description> (allow-none): Destroy notifier for @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -44493,7 +44675,7 @@ UI definition</link> and merges it with the current contents of @builder.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -44921,7 +45103,7 @@ side of the text you're typing).
</description>
<parameters>
<parameter name="name">
-<parameter_description> mark name or %NULL
+<parameter_description> (allow-none): mark name or %NULL
</parameter_description>
</parameter>
<parameter name="left_gravity">
@@ -45063,7 +45245,7 @@ to free any allocated memory.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> An empty #GValue to set.
+<parameter_description> (inout) (transfer none) An empty #GValue to set.
</parameter_description>
</parameter>
</parameters>
@@ -46147,7 +46329,7 @@ function, see gtk_file_chooser_remove_shortcut_folder().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -46219,11 +46401,11 @@ Fills in @width and @height with the appropriate size of @cell.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to fill in with the fixed width of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the fixed width of the cell, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to fill in with the fixed height of the cell, or %NULL
+<parameter_description> (allow-none): location to fill in with the fixed height of the cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -46477,7 +46659,7 @@ by the application. For example, you can use this to add a
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -47376,8 +47558,7 @@ that menu item's label.
<function name="GtkPlug">
<description>
-Gets emitted when the plug becomes embedded in a socket
-and when the embedding ends.
+Gets emitted when the plug becomes embedded in a socket.
</description>
<parameters>
@@ -47483,16 +47664,16 @@ Since: 2.20
</parameter_description>
</parameter>
<parameter name="area">
-<parameter_description> clip rectangle, or %NULL if the
+<parameter_description> (allow-none): clip rectangle, or %NULL if the
output should not be clipped
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget (may be %NULL)
+<parameter_description> (allow-none): the widget (may be %NULL)
</parameter_description>
</parameter>
<parameter name="detail">
-<parameter_description> a style detail (may be %NULL)
+<parameter_description> (allow-none): a style detail (may be %NULL)
</parameter_description>
</parameter>
<parameter name="step">
@@ -47534,7 +47715,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="settings">
-<parameter_description> a #GtkPrintSettings, or %NULL
+<parameter_description> (allow-none): a #GtkPrintSettings, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -47585,11 +47766,11 @@ you are done with it.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to be filled with the current cursor path, or %NULL
+<parameter_description> (allow-none): A pointer to be filled with the current cursor path, or %NULL
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A pointer to be filled with the current focus column, or %NULL
+<parameter_description> (allow-none): A pointer to be filled with the current focus column, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -48028,7 +48209,7 @@ of #GtkItemFactoryEntry
</parameter_description>
</parameter>
</parameters>
-<return> the menu item which corresponds to the given action, or %NULL
+<return> (allow-none): the menu item which corresponds to the given action, or %NULL
if no menu item was found
</return>
</function>
@@ -48150,7 +48331,7 @@ values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -48495,7 +48676,7 @@ also be used for purposes internal to the input method.
</parameter_description>
</parameter>
<parameter name="window">
-<parameter_description> the client window. This may be %NULL to indicate
+<parameter_description> (allow-none): the client window. This may be %NULL to indicate
that the previous client window no longer exists.
</parameter_description>
</parameter>
@@ -48576,7 +48757,7 @@ in @label indicate the mnemonic for the button.
</description>
<parameters>
<parameter name="radio_group_member">
-<parameter_description> widget to get radio group from or %NULL
+<parameter_description> (allow-none): widget to get radio group from or %NULL
</parameter_description>
</parameter>
<parameter name="label">
@@ -49670,7 +49851,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="type">
-<parameter_description> kind of child or %NULL
+<parameter_description> (allow-none): kind of child or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -49696,11 +49877,11 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store X offset of layout, or %NULL
+<parameter_description> (allow-none): location to store X offset of layout, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store Y offset of layout, or %NULL
+<parameter_description> (allow-none): location to store Y offset of layout, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -49830,11 +50011,11 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter_description> (allow-none): user data to pass to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> destroy notifier for @data, or %NULL
+<parameter_description> (allow-none): destroy notifier for @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -50160,7 +50341,7 @@ or %NULL if an error occurred. See gtk_page_setup_to_file().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -50417,7 +50598,7 @@ Since: 2.20
</parameter_description>
</parameter>
<parameter name="gicon">
-<parameter_description> a #GIcon representing the icon, or %NULL
+<parameter_description> (allow-none): a #GIcon representing the icon, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
@@ -50478,11 +50659,11 @@ gtk_spin_button_set_range().
</parameter_description>
</parameter>
<parameter name="min">
-<parameter_description> location to store minimum allowed value, or %NULL
+<parameter_description> (allow-none): location to store minimum allowed value, or %NULL
</parameter_description>
</parameter>
<parameter name="max">
-<parameter_description> location to store maximum allowed value, or %NULL
+<parameter_description> (allow-none): location to store maximum allowed value, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -50595,6 +50776,27 @@ Since: 2.4
</return>
</function>
+<function name="gtk_tool_item_group_set_header_relief">
+<description>
+Set the button relief of the group header.
+See gtk_button_set_relief() for details.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="group">
+<parameter_description> a #GtkToolItemGroup
+</parameter_description>
+</parameter>
+<parameter name="style">
+<parameter_description> the #GtkReliefStyle
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_tree_store_clear">
<description>
Removes all rows from @tree_store
@@ -50624,11 +50826,11 @@ Both paths should be freed with gtk_tree_path_free() after use.
</parameter_description>
</parameter>
<parameter name="start_path">
-<parameter_description> Return location for start of region, or %NULL
+<parameter_description> (allow-none): Return location for start of region, or %NULL
</parameter_description>
</parameter>
<parameter name="end_path">
-<parameter_description> Return location for end of region, or %NULL
+<parameter_description> (allow-none): Return location for end of region, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -51592,6 +51794,22 @@ Since: 2.14
</return>
</function>
+<function name="gtk_vscale_new">
+<description>
+Creates a new #GtkVScale.
+
+
+</description>
+<parameters>
+<parameter name="adjustment">
+<parameter_description> the #GtkAdjustment which sets the range of the scale.
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkVScale.
+</return>
+</function>
+
<function name="gtk_print_settings_get_resolution_x">
<description>
Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION_X.
@@ -52653,7 +52871,7 @@ Since: 2.14
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name, or %NULL
+<parameter_description> (allow-none): an icon name, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
@@ -52977,12 +53195,12 @@ by the URIs, but only the URI used in the recently used resources list.
</parameter_description>
</parameter>
<parameter name="new_uri">
-<parameter_description> the new URI of the recently used resource, or %NULL to
+<parameter_description> (allow-none): the new URI of the recently used resource, or %NULL to
remove the item pointed by @uri in the list
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> (allow-none): a return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -53256,13 +53474,14 @@ gdk_drag_status (context, GDK_ACTION_MOVE, time);
</parameter_description>
</parameter>
<parameter name="targets">
-<parameter_description> a pointer to an array of #GtkTargetEntry<!-- -->s indicating
-the drop types that this @widget will accept. Later you can access the list
-with gtk_drag_dest_get_target_list() and gtk_drag_dest_find_target().
+<parameter_description> (allow-none) (array length=n_targets): a pointer to an array of #GtkTargetEntry<!-- -->s
+indicating the drop types that this @widget will accept, or %NULL.
+Later you can access the list with gtk_drag_dest_get_target_list()
+and gtk_drag_dest_find_target().
</parameter_description>
</parameter>
<parameter name="n_targets">
-<parameter_description> the number of entries in @targets.
+<parameter_description> the number of entries in @targets
</parameter_description>
</parameter>
<parameter name="actions">
@@ -53297,11 +53516,11 @@ of properties to set on the tag, as with g_object_set().
</parameter_description>
</parameter>
<parameter name="tag_name">
-<parameter_description> name of the new tag, or %NULL
+<parameter_description> (allow-none): name of the new tag, or %NULL
</parameter_description>
</parameter>
<parameter name="first_property_name">
-<parameter_description> name of first property to set, or %NULL
+<parameter_description> (allow-none): name of first property to set, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -53348,12 +53567,12 @@ emblems or overlays to the icon.
</parameter_description>
</parameter>
<parameter name="points">
-<parameter_description> (array length=n_points) (out): location to store pointer to an array of points, or %NULL
+<parameter_description> (allow-none): (array length=n_points) (out): location to store pointer to an array of points, or %NULL
free the array of points with g_free().
</parameter_description>
</parameter>
<parameter name="n_points">
-<parameter_description> location to store the number of points in @points, or %NULL
+<parameter_description> (allow-none): location to store the number of points in @points, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -53697,7 +53916,7 @@ Return value: %TRUE if @reference points to a valid path.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> A #GtkTreeRowReference, or %NULL
+<parameter_description> (allow-none): A #GtkTreeRowReference, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -54434,7 +54653,7 @@ Internal function, see gtk_file_chooser_add_shortcut_folder().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -54756,7 +54975,7 @@ Returns: (transfer none): the #GtkWindowGroup for a window or the default group
</description>
<parameters>
<parameter name="window">
-<parameter_description> a #GtkWindow, or %NULL
+<parameter_description> (allow-none): a #GtkWindow, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -54881,11 +55100,11 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> User data to pass to the modify function, or %NULL.
+<parameter_description> (allow-none): User data to pass to the modify function, or %NULL.
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @data, or %NULL.
+<parameter_description> (allow-none): Destroy notifier of @data, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -55206,7 +55425,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="stock_id">
-<parameter_description> a stock id, or %NULL
+<parameter_description> (allow-none): a stock id, or %NULL
</parameter_description>
</parameter>
<parameter name="size">
@@ -55270,19 +55489,27 @@ match
<return></return>
</function>
-<function name="gtk_tree_path_get_depth">
+<function name="gtk_widget_set_mapped">
<description>
-Return value: The depth of @path
+Marks the widget as being realized.
+
+This function should only ever be called in a derived widget's
+"map" or "unmap" implementation.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="path">
-<parameter_description> A #GtkTreePath.
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="mapped">
+<parameter_description> %TRUE to mark the widget as mapped
</parameter_description>
</parameter>
</parameters>
-<return> The depth of @path
-</return>
+<return></return>
</function>
<function name="gtk_print_unix_dialog_set_embed_page_setup">
@@ -55339,15 +55566,15 @@ to be relative to @icon_view's bin_window if @keyboard_tooltip is %FALSE.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a pointer to receive a #GtkTreeModel or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreeModel or %NULL
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a pointer to receive a #GtkTreePath or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreePath or %NULL
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a pointer to receive a #GtkTreeIter or %NULL
+<parameter_description> (allow-none): a pointer to receive a #GtkTreeIter or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -55510,15 +55737,15 @@ dropped everywhere.
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> A function to determine which columns are reorderable, or %NULL.
+<parameter_description> (allow-none): A function to determine which columns are reorderable, or %NULL.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to be passed to @func, or %NULL
+<parameter_description> (allow-none): User data to be passed to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier for @user_data, or %NULL
+<parameter_description> (allow-none): Destroy notifier for @user_data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -55647,7 +55874,7 @@ or %NULL to read the first group
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -55861,7 +56088,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a text string or %NULL
+<parameter_description> (allow-none): a text string or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -56367,7 +56594,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="group">
-<parameter_description> a pointer to identify the notebook group, or %NULL to unset it
+<parameter_description> (allow-none): a pointer to identify the notebook group, or %NULL to unset it
</parameter_description>
</parameter>
</parameters>
@@ -56460,11 +56687,11 @@ direction of the paragraph are inserted.
</parameter_description>
</parameter>
<parameter name="strong_pos">
-<parameter_description> location to store the strong cursor position (may be %NULL)
+<parameter_description> (allow-none): location to store the strong cursor position (may be %NULL)
</parameter_description>
</parameter>
<parameter name="weak_pos">
-<parameter_description> location to store the weak cursor position (may be %NULL)
+<parameter_description> (allow-none): location to store the weak cursor position (may be %NULL)
</parameter_description>
</parameter>
</parameters>
@@ -57281,11 +57508,11 @@ indices in the layout to byte indices in the entry contents.
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store X offset of layout, or %NULL
+<parameter_description> (allow-none): location to store X offset of layout, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store Y offset of layout, or %NULL
+<parameter_description> (allow-none): location to store Y offset of layout, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -57451,7 +57678,7 @@ Same as gtk_text_iter_forward_find_char(), but goes backward from @iter.
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> search limit, or %NULL for none
+<parameter_description> (allow-none): search limit, or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -57577,6 +57804,9 @@ Sets the last widget in the info bar's action area with
the given response_id as the default widget for the dialog.
Pressing "Enter" normally activates the default widget.
+Note that this function currently requires @info_bar to
+be added to a widget hierarchy.
+
Since: 2.18
</description>
@@ -57867,7 +58097,7 @@ need not be initialised beforehand.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> (allow-none): return location for an error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -58023,7 +58253,7 @@ Purges every item from the recently used resources list.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> (allow-none): a return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -58502,7 +58732,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="page_func">
-<parameter_description> the #GtkAssistantPageFunc, or %NULL to use the default one
+<parameter_description> (allow-none): the #GtkAssistantPageFunc, or %NULL to use the default one
</parameter_description>
</parameter>
<parameter name="data">
@@ -59005,11 +59235,11 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="columns">
-<parameter_description> an array of column numbers
+<parameter_description> (array length=n_values): an array of column numbers
</parameter_description>
</parameter>
<parameter name="values">
-<parameter_description> an array of GValues
+<parameter_description> (array length=n_values): an array of GValues
</parameter_description>
</parameter>
<parameter name="n_values">
@@ -59585,11 +59815,11 @@ call gtk_action_group_add_action_with_accel().
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> The label displayed in menu items and on buttons, or %NULL
+<parameter_description> (allow-none): The label displayed in menu items and on buttons, or %NULL
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> A tooltip for the action, or %NULL
+<parameter_description> (allow-none): A tooltip for the action, or %NULL
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -60453,7 +60683,7 @@ of #GtkItemFactoryEntry
</parameter_description>
</parameter>
</parameters>
-<return> the widget which corresponds to the given action, or %NULL
+<return> (allow-none): the widget which corresponds to the given action, or %NULL
if no widget was found
</return>
</function>
@@ -60780,7 +61010,7 @@ Optionally, specify initial text to set in the buffer.
</description>
<parameters>
<parameter name="initial_chars">
-<parameter_description> initial buffer text, or %NULL
+<parameter_description> (allow-none): initial buffer text, or %NULL
</parameter_description>
</parameter>
<parameter name="n_initial_chars">
@@ -60814,7 +61044,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="custom_window">
-<parameter_description> a #GtkWindow, or %NULL
+<parameter_description> (allow-none): a #GtkWindow, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -61202,7 +61432,7 @@ _gtk_file_chooser_select_uri().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -61691,19 +61921,19 @@ See gtk_window_set_has_frame(), gtk_window_set_frame_dimensions().
</parameter_description>
</parameter>
<parameter name="left">
-<parameter_description> location to store the width of the frame at the left, or %NULL
+<parameter_description> (allow-none): location to store the width of the frame at the left, or %NULL
</parameter_description>
</parameter>
<parameter name="top">
-<parameter_description> location to store the height of the frame at the top, or %NULL
+<parameter_description> (allow-none): location to store the height of the frame at the top, or %NULL
</parameter_description>
</parameter>
<parameter name="right">
-<parameter_description> location to store the width of the frame at the returns, or %NULL
+<parameter_description> (allow-none): location to store the width of the frame at the returns, or %NULL
</parameter_description>
</parameter>
<parameter name="bottom">
-<parameter_description> location to store the height of the frame at the bottom, or %NULL
+<parameter_description> (allow-none): location to store the height of the frame at the bottom, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -61753,7 +61983,7 @@ and gnome_url_show().
</description>
<parameters>
<parameter name="screen">
-<parameter_description> screen to show the uri on or %NULL for the default screen
+<parameter_description> (allow-none): screen to show the uri on or %NULL for the default screen
</parameter_description>
</parameter>
<parameter name="uri">
@@ -62013,7 +62243,7 @@ given #GtkPrintOperation.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for errors, or %NULL
+<parameter_description> (allow-none): Return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -62033,7 +62263,7 @@ Since: 2.10
<function name="gtk_notebook_popup_enable">
<description>
Enables the popup menu: if the user clicks with the right mouse button on
-the bookmarks, a menu with all the pages will be popped up.
+the tab labels, a menu with all the pages will be popped up.
</description>
<parameters>
@@ -62584,11 +62814,11 @@ Creates a new custom paper dialog.
</description>
<parameters>
<parameter name="title">
-<parameter_description> the title of the dialog, or %NULL
+<parameter_description> (allow-none): the title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -62721,6 +62951,24 @@ output should not be clipped
<return></return>
</function>
+<function name="gtk_accel_label_refetch">
+<description>
+Recreates the string representing the accelerator keys.
+This should not be needed since the string is automatically updated whenever
+accelerators are added or removed from the associated widget.
+
+
+</description>
+<parameters>
+<parameter name="accel_label">
+<parameter_description> a #GtkAccelLabel.
+</parameter_description>
+</parameter>
+</parameters>
+<return> always returns %FALSE.
+</return>
+</function>
+
<function name="GtkLayout">
<description>
Set the scroll adjustments for the layout. Usually scrolled containers
@@ -63312,7 +63560,7 @@ Free's @reference. @reference may be %NULL.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> A #GtkTreeRowReference, or %NULL
+<parameter_description> (allow-none): A #GtkTreeRowReference, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -63346,7 +63594,7 @@ stock item indicated by @stock_id.
</description>
<parameters>
<parameter name="group">
-<parameter_description> an existing radio button group, or %NULL if you are creating a new group
+<parameter_description> (allow-none): an existing radio button group, or %NULL if you are creating a new group
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -63408,23 +63656,23 @@ primarily by the #GtkTreeView.
</parameter_description>
</parameter>
<parameter name="cell_area">
-<parameter_description> The area a cell in the column will be allocated, or %NULL
+<parameter_description> (allow-none): The area a cell in the column will be allocated, or %NULL
</parameter_description>
</parameter>
<parameter name="x_offset">
-<parameter_description> location to return x offset of a cell relative to @cell_area, or %NULL
+<parameter_description> (allow-none): location to return x offset of a cell relative to @cell_area, or %NULL
</parameter_description>
</parameter>
<parameter name="y_offset">
-<parameter_description> location to return y offset of a cell relative to @cell_area, or %NULL
+<parameter_description> (allow-none): location to return y offset of a cell relative to @cell_area, or %NULL
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to return width needed to render a cell, or %NULL
+<parameter_description> (allow-none): location to return width needed to render a cell, or %NULL
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to return height needed to render a cell, or %NULL
+<parameter_description> (allow-none): location to return height needed to render a cell, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -63538,7 +63786,7 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</parameter_description>
</parameter>
</parameters>
-<return> the item factory from which @widget was created, or %NULL
+<return> (allow-none): the item factory from which @widget was created, or %NULL
</return>
</function>
@@ -63772,6 +64020,24 @@ Since: 2.4
</return>
</function>
+<function name="gtk_widget_get_mapped">
+<description>
+Whether the widget is mapped.
+
+
+</description>
+<parameters>
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the widget is mapped, %FALSE otherwise.
+
+Since: 2.20
+</return>
+</function>
+
<function name="gtk_style_lookup_color">
<description>
Looks up @color_name in the style's logical color mappings,
@@ -63937,14 +64203,23 @@ Removes a widget from a #GtkSizeGroup.
<return></return>
</function>
-<function name="gtk_spin_button_update">
+<function name="gtk_widget_set_realized">
<description>
-Manually force an update of the spin button.
+Marks the widget as being realized.
+
+This function should only ever be called in a derived widget's
+"realize" or "unrealize" implementation.
+
+Since: 2.20
</description>
<parameters>
-<parameter name="spin_button">
-<parameter_description> a #GtkSpinButton
+<parameter name="widget">
+<parameter_description> a #GtkWidget
+</parameter_description>
+</parameter>
+<parameter name="realized">
+<parameter_description> %TRUE to mark the widget as realized
</parameter_description>
</parameter>
</parameters>
@@ -64231,7 +64506,7 @@ Since: 2.6
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> (allow-none): printf()-style format string, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -64330,19 +64605,19 @@ Since: 2.4
</parameter_description>
</parameter>
<parameter name="padding_top">
-<parameter_description> location to store the padding for the top of the widget, or %NULL
+<parameter_description> (allow-none): location to store the padding for the top of the widget, or %NULL
</parameter_description>
</parameter>
<parameter name="padding_bottom">
-<parameter_description> location to store the padding for the bottom of the widget, or %NULL
+<parameter_description> (allow-none): location to store the padding for the bottom of the widget, or %NULL
</parameter_description>
</parameter>
<parameter name="padding_left">
-<parameter_description> location to store the padding for the left of the widget, or %NULL
+<parameter_description> (allow-none): location to store the padding for the left of the widget, or %NULL
</parameter_description>
</parameter>
<parameter name="padding_right">
-<parameter_description> location to store the padding for the right of the widget, or %NULL
+<parameter_description> (allow-none): location to store the padding for the right of the widget, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -64607,7 +64882,7 @@ have to be direct children)
</parameter_description>
</parameter>
<parameter name="old_focus">
-<parameter_description> widget to use for the starting position, or %NULL
+<parameter_description> (allow-none): widget to use for the starting position, or %NULL
to determine this automatically.
(Note, this argument isn't used for GTK_DIR_TAB_*,
which is the only @direction we use currently,
@@ -65837,7 +66112,7 @@ right.
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> Text to be shown at the mark, using <link linkend="PangoMarkupFormat">Pango markup</link>, or %NULL
+<parameter_description> (allow-none): Text to be shown at the mark, using <link linkend="PangoMarkupFormat">Pango markup</link>, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -66552,11 +66827,11 @@ to load files.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> (allow-none): Title of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> (allow-none): Transient parent of the dialog, or %NULL
</parameter_description>
</parameter>
<parameter name="action">
@@ -66568,7 +66843,7 @@ to load files.
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> stock ID or text to go in the first button, or %NULL
+<parameter_description> (allow-none): stock ID or text to go in the first button, or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -66597,7 +66872,7 @@ Since: 2.12
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> a #GdkPixbuf, or %NULL
+<parameter_description> (allow-none): a #GdkPixbuf, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -66646,7 +66921,7 @@ Sets @uri as the current URI for @chooser.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> (allow-none): return location for a #GError, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -67093,7 +67368,7 @@ Since: 2.10
</description>
<parameters>
<parameter name="func">
-<parameter_description> the #GtkNotebookWindowCreationFunc, or %NULL
+<parameter_description> (allow-none): the #GtkNotebookWindowCreationFunc, or %NULL
</parameter_description>
</parameter>
<parameter name="data">
@@ -67101,7 +67376,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier for @data, or %NULL
+<parameter_description> (allow-none): Destroy notifier for @data, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -67591,22 +67866,33 @@ said text if it's editable.
<return></return>
</function>
-<function name="gtk_page_setup_unix_dialog_get_print_settings">
+<function name="gtk_entry_buffer_set_text">
<description>
-Gets the current print settings from the dialog.
+Sets the text in the buffer.
+
+This is roughly equivalent to calling gtk_entry_buffer_delete_text()
+and gtk_entry_buffer_insert_text().
+
+Note that @n_chars is in characters, not in bytes.
+Since: 2.18
</description>
<parameters>
-<parameter name="dialog">
-<parameter_description> a #GtkPageSetupUnixDialog
+<parameter name="buffer">
+<parameter_description> a #GtkEntryBuffer
+</parameter_description>
+</parameter>
+<parameter name="chars">
+<parameter_description> the new text
+</parameter_description>
+</parameter>
+<parameter name="n_chars">
+<parameter_description> the number of characters in @text, or -1
</parameter_description>
</parameter>
</parameters>
-<return> the current print settings
-
-Since: 2.10
-</return>
+<return></return>
</function>
<function name="gtk_entry_get_icon_storage_type">
@@ -68042,6 +68328,21 @@ Since: 2.4
<return></return>
</function>
+<function name="gtk_accel_label_get_accel_width">
+<description>
+Returns: the width needed to display the accelerator key(s).
+
+</description>
+<parameters>
+<parameter name="accel_label">
+<parameter_description> a #GtkAccelLabel.
+</parameter_description>
+</parameter>
+</parameters>
+<return> the width needed to display the accelerator key(s).
+</return>
+</function>
+
<function name="gtk_widget_get_tooltip_markup">
<description>
Gets the contents of the tooltip for @widget.
@@ -68094,11 +68395,11 @@ The paths should be freed with gtk_tree_path_free() after use.
</parameter_description>
</parameter>
<parameter name="start_path">
-<parameter_description> Return location for start of region, or %NULL.
+<parameter_description> (allow-none): Return location for start of region, or %NULL.
</parameter_description>
</parameter>
<parameter name="end_path">
-<parameter_description> Return location for end of region, or %NULL.
+<parameter_description> (allow-none): Return location for end of region, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -68413,7 +68714,7 @@ Since: 2.10
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the label to use, or %NULL to use the default label
+<parameter_description> (allow-none): the label to use, or %NULL to use the default label
</parameter_description>
</parameter>
</parameters>
@@ -68775,7 +69076,7 @@ and set them up for destruction during the next test teardown phase.
</parameter_description>
</parameter>
<parameter name="first_property_name">
-<parameter_description> Name of first property to set or %NULL
+<parameter_description> (allow-none): Name of first property to set or %NULL
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -68940,11 +69241,11 @@ Since: 2.10
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL
+<parameter_description> (allow-none): transient parent, or %NULL
</parameter_description>
</parameter>
<parameter name="page_setup">
-<parameter_description> an existing #GtkPageSetup, or %NULL
+<parameter_description> (allow-none): an existing #GtkPageSetup, or %NULL
</parameter_description>
</parameter>
<parameter name="settings">
@@ -69088,11 +69389,11 @@ and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store X offset of layout, or %NULL
+<parameter_description> (allow-none): location to store X offset of layout, or %NULL
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store Y offset of layout, or %NULL
+<parameter_description> (allow-none): location to store Y offset of layout, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -69246,7 +69547,7 @@ file could not be loaded then error is set to either a #GFileError or
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> (allow-none): return location for errors, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -69285,9 +69586,10 @@ main window. gtk_dialog_new_with_buttons() and other convenience
functions in GTK+ will sometimes call
gtk_window_set_transient_for() on your behalf.
-On Windows, this function puts the child window on top of the parent,
-much as the window manager would have done on X.
+Passing %NULL for @parent unsets the current transient window.
+On Windows, this function puts the child window on top of the parent,
+much as the window manager would have done on X.
</description>
<parameters>
@@ -69296,7 +69598,7 @@ much as the window manager would have done on X.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> (allow-none): parent window
+<parameter_description> (allow-none): parent window, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -69335,7 +69637,7 @@ Return value: whether @iter is the end of a range tagged with @tag
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a #GtkTextTag, or %NULL
+<parameter_description> (allow-none): a #GtkTextTag, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -69416,7 +69718,7 @@ Sends a generic XEMBED message to a particular window.
</description>
<parameters>
<parameter name="recipient">
-<parameter_description> window to which to send the window, or %NULL
+<parameter_description> (allow-none): window to which to send the window, or %NULL
in which case nothing will be sent
</parameter_description>
</parameter>
@@ -69480,7 +69782,7 @@ in values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> (allow-none): A valid #GtkTreeIter, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -69930,7 +70232,7 @@ Deprecated: 2.4: Use #GtkUIManager instead.
</parameter_description>
</parameter>
</parameters>
-<return> the widget for the given path, or %NULL if @path doesn't lead
+<return> (allow-none): the widget for the given path, or %NULL if @path doesn't lead
to a widget
</return>
</function>
@@ -70204,11 +70506,11 @@ call gtk_action_group_add_action_with_accel().
</parameter_description>
</parameter>
<parameter name="label">
-<parameter_description> the label displayed in menu items and on buttons, or %NULL
+<parameter_description> (allow-none): the label displayed in menu items and on buttons, or %NULL
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a tooltip for the action, or %NULL
+<parameter_description> (allow-none): a tooltip for the action, or %NULL
</parameter_description>
</parameter>
<parameter name="stock_id">
@@ -70235,15 +70537,15 @@ If no uri hook has been set, GTK+ defaults to calling gtk_show_uri().
</description>
<parameters>
<parameter name="func">
-<parameter_description> a function called each time a #GtkLinkButton is clicked, or %NULL
+<parameter_description> (allow-none): a function called each time a #GtkLinkButton is clicked, or %NULL
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to be passed to @func, or %NULL
+<parameter_description> (allow-none): user data to be passed to @func, or %NULL
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> a #GDestroyNotify that gets called when @data is no longer needed, or %NULL
+<parameter_description> (allow-none): a #GDestroyNotify that gets called when @data is no longer needed, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -70289,7 +70591,7 @@ exactly this size; see gtk_icon_info_load_icon().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Location to store error information on failure, or %NULL.
+<parameter_description> (allow-none): Location to store error information on failure, or %NULL.
</parameter_description>
</parameter>
</parameters>
@@ -70385,11 +70687,11 @@ Determines the destination item for a given position.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the item, or %NULL.
+<parameter_description> (allow-none): Return location for the path of the item, or %NULL.
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> (allow-none): Return location for the drop position, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -71223,7 +71525,7 @@ Since: 2.16
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> the contents of the tooltip for the icon, or %NULL
+<parameter_description> (allow-none): the contents of the tooltip for the icon, or %NULL
</parameter_description>
</parameter>
</parameters>
@@ -71734,7 +72036,7 @@ Removes a folder URI from a file chooser's list of shortcut folders.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> (allow-none): location to store error, or %NULL
</parameter_description>
</parameter>
</parameters>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
