[gtkmm] Regenerate docs.xml files.

From: Murray Cumming <murrayc src gnome org>
To: commits-list gnome org
Cc:
Subject: [gtkmm] Regenerate docs.xml files.
Date: Wed, 3 Dec 2014 12:26:11 +0000 (UTC)
commit ab7e6e473d41fa454428ee3d1a62113fe8fb3334
Author: Murray Cumming <murrayc murrayc com>
Date:   Wed Dec 3 12:25:35 2014 +0100

    Regenerate docs.xml files.

 gdk/src/gdk_docs.xml |  710 ++++++++++++++++++++++++++--
 gtk/src/gtk_docs.xml | 1288 ++++++++++++++++++++++++++++++++++++++++++++++---
 2 files changed, 1878 insertions(+), 120 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index f63d9e2..1613fc9 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -1251,6 +1251,27 @@ Since: 3.8
 </parameters>
 </enum>
 
+<enum name="GdkGLProfile">
+<description>
+...
+
+</description>
+<parameters>
+<parameter name="GDK_GL_PROFILE_DEFAULT">
+<parameter_description> ...
+</parameter_description>
+</parameter>
+<parameter name="GDK_GL_PROFILE_LEGACY">
+<parameter_description> ...
+</parameter_description>
+</parameter>
+<parameter name="GDK_GL_PROFILE_3_2_CORE">
+<parameter_description> ...
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
 <enum name="GdkGrabOwnership">
 <description>
 Defines how device grabs interact with other devices.
@@ -1301,6 +1322,10 @@ viewable.
 <parameter_description> the resource is frozen by an active grab of another client.
 </parameter_description>
 </parameter>
+<parameter name="GDK_GRAB_FAILED">
+<parameter_description> the grab failed for some other reason.
+</parameter_description>
+</parameter>
 </parameters>
 </enum>
 
@@ -1795,6 +1820,19 @@ Specifies why a selection ownership was changed.
 </parameters>
 </enum>
 
+<signal name="GdkPixbuf::pixel-bytes">
+<description>
+If set, this pixbuf was created from read-only #GBytes.
+Replaces GdkPixbuf::pixels.
+
+Since: 2.32
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</signal>
+
 <enum name="GdkPixbufAlphaMode">
 <description>
 These values can be passed to
@@ -2862,6 +2900,9 @@ windows in order to trap or filter the events. You can’t draw on
 Appends gdk option entries to the passed in option group. This is
 not public API and must not be used by applications.
 
+Deprecated: 3.16: This symbol was never meant to be used outside
+of GTK+
+
 </description>
 <parameters>
 <parameter name="group">
@@ -3142,6 +3183,69 @@ cairo_destroy() when you are done drawing.
 </return>
 </function>
 
+<function name="gdk_cairo_draw_from_gl">
+<description>
+This is the main way to draw GL content in GTK+. It takes a render buffer ID 
+(@source_type == #GL_RENDERBUFFER) or a texture id (@source_type == #GL_TEXTURE)
+and draws it onto @cr with an OVER operation, respecting the current clip.
+The top left corner of the rectangle specified by @x, @y, @width and @height
+will be drawn at the current (0,0) position of the cairo_t.
+
+This will work for *all* cairo_t, as long as @window is realized, but the
+fallback implementation that reads back the pixels from the buffer may be
+used in the general case. In the case of direct drawing to a window with
+no special effects applied to @cr it will however use a more efficient
+approach.
+
+For #GL_RENDERBUFFER the code will always fall back to software for buffers
+with alpha components, so make sure you use #GL_TEXTURE if using alpha.
+
+Calling this may change the current GL context.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="cr">
+<parameter_description> a cairo context
+</parameter_description>
+</parameter>
+<parameter name="window">
+<parameter_description> The window we're rendering for (not necessarily into)
+</parameter_description>
+</parameter>
+<parameter name="source">
+<parameter_description> The GL ID of the source buffer
+</parameter_description>
+</parameter>
+<parameter name="source_type">
+<parameter_description> The type of the @source
+</parameter_description>
+</parameter>
+<parameter name="buffer_scale">
+<parameter_description> The scale-factor that the @source buffer is allocated for
+</parameter_description>
+</parameter>
+<parameter name="x">
+<parameter_description> The source x position in @source to start copying from in GL coordinates
+</parameter_description>
+</parameter>
+<parameter name="y">
+<parameter_description> The source y position in @source to start copying from in GL coordinates
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> The width of the region to draw
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> The height of the region to draw
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_cairo_get_clip_rectangle">
 <description>
 This is a convenience function around cairo_clip_extents().
@@ -3591,6 +3695,7 @@ See gdk_cursor_new_for_display().
 
 To make the cursor invisible, use %GDK_BLANK_CURSOR.
 
+Deprecated: 3.16: Use gdk_cursor_new_for_display() instead.
 
 </description>
 <parameters>
@@ -3600,6 +3705,7 @@ To make the cursor invisible, use %GDK_BLANK_CURSOR.
 </parameter>
 </parameters>
 <return> a new #GdkCursor
+
 </return>
 </function>
 
@@ -3960,6 +4066,7 @@ by GTK+, and must not be freed or unreffed.
 <function name="gdk_device_get_has_cursor">
 <description>
 Determines whether the pointer follows device motion.
+This is not meaningful for keyboard devices, which don't have a pointer.
 
 Since: 2.20
 
@@ -4057,7 +4164,7 @@ Since: 2.20
 
 <function name="gdk_device_get_last_event_window">
 <description>
-Gets information about which window the given pointer device is in, based on
+Gets information about which window the given pointer device is in, based on events
 that have been received so far from the display server. If another application
 has a pointer grab, or this application has a grab with owner_events = %FALSE,
 %NULL may be returned even if the pointer is physically over one of this
@@ -4337,6 +4444,8 @@ this application until the device is ungrabbed with gdk_device_ungrab(),
 or the window becomes unviewable. This overrides any previous grab on the device
 by this client.
 
+Note that @device and @window need to be on the same display.
+
 Device grabs are used for operations which need complete control over the
 given device events (either pointer or keyboard). For example in GTK+ this
 is used for Drag and Drop operations, popup menus and such.
@@ -4409,6 +4518,8 @@ can be used if the time isn’t known.
 Determines information about the current keyboard grab.
 This is not public API and must not be used by applications.
 
+Deprecated: 3.16: The symbol was never meant to be used outside
+of GTK+
 
 </description>
 <parameters>
@@ -4433,6 +4544,7 @@ gdk_pointer_grab() was %TRUE.
 </parameters>
 <return> %TRUE if this application currently has the
 keyboard grabbed.
+
 </return>
 </function>
 
@@ -5306,12 +5418,15 @@ it. gdk_parse_args() must have been called first. If the default
 display has previously been set, simply returns that. An internal
 function that should not be used by applications.
 
+Deprecated: 3.16: This symbol was never meant to be used outside
+of GTK+
 
 </description>
 <parameters>
 </parameters>
 <return> the default display, if it
 could be opened, otherwise %NULL.
+
 </return>
 </function>
 
@@ -5542,6 +5657,9 @@ XDamage extensions available.
 
 Since: 2.12
 
+Deprecated: 3.16: Compositing is an outdated technology that
+only ever worked on X11.
+
 </description>
 <parameters>
 <parameter name="display">
@@ -7443,6 +7561,153 @@ Gets whether event debugging output is enabled.
 </return>
 </function>
 
+<function name="gdk_gl_context_clear_current">
+<description>
+Clears the current #GdkGLContext.
+
+Any OpenGL call after this function returns will be ignored
+until gdk_gl_context_make_current() is called.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
+<function name="gdk_gl_context_get_current">
+<description>
+Retrieves the current #GdkGLContext.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> the current #GdkGLContext, or %NULL
+
+</return>
+</function>
+
+<function name="gdk_gl_context_get_display">
+<description>
+Retrieves the #GdkDisplay the @context is created for
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GdkGLContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkDisplay or %NULL
+
+</return>
+</function>
+
+<function name="gdk_gl_context_get_profile">
+<description>
+Retrieves the #GdkGLProfile that @context was created for.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GdkGLContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkGLProfile
+
+</return>
+</function>
+
+<function name="gdk_gl_context_get_shared_context">
+<description>
+Retrieves the #GdkGLContext that this @context share data with.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GdkGLContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkGLContext or %NULL
+
+</return>
+</function>
+
+<function name="gdk_gl_context_get_window">
+<description>
+Retrieves the #GdkWindow used by the @context.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GdkGLContext
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkWindow or %NULL
+
+</return>
+</function>
+
+<function name="gdk_gl_context_make_current">
+<description>
+Makes the @context the current one.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="context">
+<parameter_description> a #GdkGLContext
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gdk_gl_get_flags">
+<description>
+Returns the currently active GL flags.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> the GL flags
+
+</return>
+</function>
+
+<function name="gdk_gl_set_flags">
+<description>
+Sets GL flags.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="flags">
+<parameter_description> #GdkGLFlags to set
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_init">
 <description>
 Initializes the GDK library and connects to the windowing system.
@@ -8128,6 +8393,24 @@ a list of visuals; the list must be freed, but not its contents
 </return>
 </function>
 
+<function name="gdk_mir_display_get_mir_connection">
+<description>
+Returns the #MirConnection for a #GdkDisplay
+
+Since: 3.14
+
+</description>
+<parameters>
+<parameter name="display">
+<parameter_description> a #GdkDisplay
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #MirConnection
+
+</return>
+</function>
+
 <function name="gdk_notify_startup_complete">
 <description>
 Indicates to the GUI environment that the application has finished
@@ -8611,6 +8894,10 @@ or -1 if the current pixbuf should be displayed forever. g_timeout_add()
 conveniently takes a timeout in milliseconds, so you can use a timeout
 to schedule the next update.
 
+Note that some formats, like GIF, might clamp the timeout values in the
+image file to avoid updates that are just too quick. The minimum timeout
+for GIF images is currently 20 milliseconds.
+
 
 </description>
 <parameters>
@@ -9187,8 +9474,8 @@ Since: 2.6
 </parameter_description>
 </parameter>
 </parameters>
-<return> the new #GdkPixbuf, or %NULL if not enough memory could be
-allocated for it.
+<return> the new #GdkPixbuf, or %NULL
+if not enough memory could be allocated for it.
 
 </return>
 </function>
@@ -9412,6 +9699,7 @@ Converts a #GdkPixdata to a #GdkPixbuf. If @copy_pixels is %TRUE or
 if the pixel data is run-length-encoded, the pixel data is copied into
 newly-allocated memory; otherwise it is reused.
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -9496,6 +9784,74 @@ Since: 2.4
 </parameter_description>
 </parameter>
 <parameter name="width">
+<parameter_description> Return location for the width of the
+image, or %NULL
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Return location for the height of the
+image, or %NULL
+</parameter_description>
+</parameter>
+</parameters>
+<return> A #GdkPixbufFormat describing
+the image format of the file or %NULL if the image format wasn't
+recognized. The return value is owned by #GdkPixbuf and should
+not be freed.
+
+</return>
+</function>
+
+<function name="gdk_pixbuf_get_file_info_async">
+<description>
+Asynchronously parses an image file far enough to determine its
+format and size.
+
+For more details see gdk_pixbuf_get_file_info(), which is the synchronous
+version of this function.
+
+When the operation is finished, @callback will be called in the
+main thread. You can then call gdk_pixbuf_get_file_info_finish() to
+get the result of the operation.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="filename">
+<parameter_description> The name of the file to identify
+</parameter_description>
+</parameter>
+<parameter name="cancellable">
+<parameter_description> optional #GCancellable object, %NULL to ignore
+</parameter_description>
+</parameter>
+<parameter name="callback">
+<parameter_description> a #GAsyncReadyCallback to call when the the pixbuf is loaded
+</parameter_description>
+</parameter>
+<parameter name="user_data">
+<parameter_description> the data to pass to the callback function
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gdk_pixbuf_get_file_info_finish">
+<description>
+Finishes an asynchronous pixbuf parsing operation started with
+gdk_pixbuf_get_file_info_async().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="async_result">
+<parameter_description> a #GAsyncResult
+</parameter_description>
+</parameter>
+<parameter name="width">
 <parameter_description> Return location for the width of the image, or %NULL
 </parameter_description>
 </parameter>
@@ -9503,6 +9859,10 @@ Since: 2.4
 <parameter_description> Return location for the height of the image, or %NULL
 </parameter_description>
 </parameter>
+<parameter name="error">
+<parameter_description> a #GError, or %NULL
+</parameter_description>
+</parameter>
 </parameters>
 <return> A #GdkPixbufFormat describing the image
 format of the file or %NULL if the image format wasn't
@@ -9685,7 +10045,10 @@ The ICO, XBM, and XPM loaders provide &quot;x_hot&quot; and &quot;y_hot&quot; ho
 options for cursor definitions. The PNG loader provides the tEXt ancillary
 chunk key/value pairs as options. Since 2.12, the TIFF and JPEG loaders
 return an &quot;orientation&quot; option string that corresponds to the embedded 
-TIFF/Exif orientation tag (if present).
+TIFF/Exif orientation tag (if present). Since 2.32, the TIFF loader sets
+the &quot;multipage&quot; option string to &quot;yes&quot; when a multi-page TIFF is loaded.
+Since 2.32 the JPEG and PNG loaders set &quot;x-dpi&quot; and &quot;y-dpi&quot; if the file
+contains image density information in dots per inch.
 
 
 </description>
@@ -9704,6 +10067,28 @@ string that should not be freed or %NULL if @key was not found.
 </return>
 </function>
 
+<function name="gdk_pixbuf_get_options">
+<description>
+Returns a #GHashTable with a list of all the options that may have been
+attached to the @pixbuf when it was loaded, or that may have been
+attached by another function using gdk_pixbuf_set_option().
+
+See gdk_pixbuf_get_option() for more details.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="pixbuf">
+<parameter_description> a #GdkPixbuf
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GHashTable of key/values
+
+</return>
+</function>
+
 <function name="gdk_pixbuf_get_pixels">
 <description>
 Queries a pointer to the pixel data of a pixbuf.
@@ -9719,6 +10104,9 @@ Queries a pointer to the pixel data of a pixbuf.
 <return> A pointer to the pixbuf's pixel data.
 Please see the section on [image data](image-data) for information
 about how the pixel data is stored in memory.
+
+This function will cause an implicit copy of the pixbuf data if the
+pixbuf was created from read-only data.
 </return>
 </function>
 
@@ -9743,6 +10131,9 @@ Since: 2.26
 pixel data.  Please see the section on [image data](image-data)
 for information about how the pixel data is stored in memory.
 
+This function will cause an implicit copy of the pixbuf data if the
+pixbuf was created from read-only data.
+
 </return>
 </function>
 
@@ -9846,8 +10237,9 @@ Since: 2.2
 </parameter_description>
 </parameter>
 </parameters>
-<return> A #GdkPixbufFormat or %NULL. The return
-value is owned by GdkPixbuf and should not be freed.
+<return> A #GdkPixbufFormat or
+%NULL. The return value is owned by GdkPixbuf and should not be
+freed.
 
 </return>
 </function>
@@ -10139,11 +10531,62 @@ you will have to fill it completely yourself.
 </return>
 </function>
 
+<function name="gdk_pixbuf_new_from_bytes">
+<description>
+Creates a new #GdkPixbuf out of in-memory readonly image data.
+Currently only RGB images with 8 bits per sample are supported.
+This is the #GBytes variant of gdk_pixbuf_new_from_data().
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="data">
+<parameter_description> Image data in 8-bit/sample packed format inside a #GBytes
+</parameter_description>
+</parameter>
+<parameter name="colorspace">
+<parameter_description> Colorspace for the image data
+</parameter_description>
+</parameter>
+<parameter name="has_alpha">
+<parameter_description> Whether the data has an opacity channel
+</parameter_description>
+</parameter>
+<parameter name="bits_per_sample">
+<parameter_description> Number of bits per sample
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> Width of the image in pixels, must be &gt; 0
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> Height of the image in pixels, must be &gt; 0
+</parameter_description>
+</parameter>
+<parameter name="rowstride">
+<parameter_description> Distance in bytes between row starts
+</parameter_description>
+</parameter>
+</parameters>
+<return> A newly-created #GdkPixbuf structure with a reference count of 1.
+</return>
+</function>
+
 <function name="gdk_pixbuf_new_from_data">
 <description>
 Creates a new #GdkPixbuf out of in-memory image data.  Currently only RGB
 images with 8 bits per sample are supported.
 
+Since you are providing a pre-allocated pixel buffer, you must also
+specify a way to free that data.  This is done with a function of
+type #GdkPixbufDestroyNotify.  When a pixbuf created with is
+finalized, your destroy notification function will be called, and
+it is its responsibility to free the pixel array.
+
+See also gdk_pixbuf_new_from_bytes().
+
 
 </description>
 <parameters>
@@ -10338,6 +10781,7 @@ For non-const inline data, you could get out of memory. For untrusted
 inline data located at runtime, you could have corrupt inline data in 
 addition.
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -10363,6 +10807,7 @@ serialized #GdkPixdata structure
 </parameters>
 <return> A newly-created #GdkPixbuf structure with a reference,
 count of 1, or %NULL if an error occurred.
+
 </return>
 </function>
 
@@ -10525,11 +10970,16 @@ from another thread. If the operation was cancelled, the error
 the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains. 
 
 The image will be scaled to fit in the requested size, optionally 
-preserving the image's aspect ratio. When preserving the aspect ratio, 
-a @width of -1 will cause the image to be scaled to the exact given 
-height, and a @height of -1 will cause the image to be scaled to the 
-exact given width. When not preserving aspect ratio, a @width or 
- height of -1 means to not scale the image at all in that dimension.
+preserving the image's aspect ratio.
+
+When preserving the aspect ratio, a @width of -1 will cause the image to be
+scaled to the exact given height, and a @height of -1 will cause the image
+to be scaled to the exact given width. If both @width and @height are
+given, this function will behave as if the smaller of the two values
+is passed as -1.
+
+When not preserving aspect ratio, a @width or @height of -1 means to not
+scale the image at all in that dimension.
 
 The stream is not closed.
 
@@ -10659,12 +11109,14 @@ the result of including an XPM file into a program's C source.
 
 <function name="gdk_pixbuf_new_subpixbuf">
 <description>
-Creates a new pixbuf which represents a sub-region of
- src_pixbuf  The new pixbuf shares its pixels with the
-original pixbuf, so writing to one affects both.
-The new pixbuf holds a reference to @src_pixbuf, so
- src_pixbuf will not be finalized until the new pixbuf
-is finalized.
+Creates a new pixbuf which represents a sub-region of @src_pixbuf.
+The new pixbuf shares its pixels with the original pixbuf, so
+writing to one affects both.  The new pixbuf holds a reference to
+ src_pixbuf, so @src_pixbuf will not be finalized until the new
+pixbuf is finalized.
+
+Note that if @src_pixbuf is read-only, this function will force it
+to be mutable.
 
 
 </description>
@@ -10694,6 +11146,44 @@ is finalized.
 </return>
 </function>
 
+<function name="gdk_pixbuf_read_pixel_bytes">
+<description>
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="pixbuf">
+<parameter_description> A pixbuf
+</parameter_description>
+</parameter>
+</parameters>
+<return> A new reference to a read-only copy of
+the pixel data.  Note that for mutable pixbufs, this function will
+incur a one-time copy of the pixel data for conversion into the
+returned #GBytes.
+
+</return>
+</function>
+
+<function name="gdk_pixbuf_read_pixels">
+<description>
+Returns a read-only pointer to the raw pixel data; must not be
+modified.  This function allows skipping the implicit copy that
+must be made if gdk_pixbuf_get_pixels() is called on a read-only
+pixbuf.
+
+Since: 2.32
+
+</description>
+<parameters>
+<parameter name="pixbuf">
+<parameter_description> A pixbuf
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_pixbuf_ref">
 <description>
 Adds a reference to a pixbuf.
@@ -10730,8 +11220,8 @@ Since: 2.6
 </parameter_description>
 </parameter>
 </parameters>
-<return> the new #GdkPixbuf, or %NULL if not enough memory could be
-allocated for it.
+<return> the new #GdkPixbuf, or %NULL
+if not enough memory could be allocated for it.
 
 </return>
 </function>
@@ -10801,7 +11291,9 @@ gdk_pixbuf_save (pixbuf, handle, &quot;jpeg&quot;, &amp;error, &quot;quality&quo
 ]|
 
 Currently only few parameters exist. JPEG images can be saved with a
-&quot;quality&quot; parameter; its value should be in the range [0,100].
+&quot;quality&quot; parameter; its value should be in the range [0,100]. JPEG
+and PNG density can be set by setting the &quot;x-dpi&quot; and &quot;y-dpi&quot; parameters
+to the appropriate values in dots per inch.
 
 Text chunks can be attached to PNG images by specifying parameters of
 the form &quot;tEXt::key&quot;, where key is an ASCII string of length 1-79.
@@ -10822,9 +11314,13 @@ contents_encode = g_base64_encode ((const guchar *) contents, length);
 gdk_pixbuf_save (pixbuf, handle, &quot;png&quot;, &amp;error, &quot;icc-profile&quot;, contents_encode, 
NULL);
 ]|
 
-TIFF images recognize a &quot;compression&quot; 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.
+TIFF images recognize: (1) a &quot;bits-per-sample&quot; option (integer) which
+can be either 1 for saving bi-level CCITTFAX4 images, or 8 for saving
+8-bits per sample; (2) a &quot;compression&quot; option (integer) which can be
+1 for no compression, 2 for Huffman, 5 for LZW, 7 for JPEG and 8 for
+DEFLATE (see the libtiff documentation and tiff.h for all supported
+codec values); (3) an &quot;icc-profile&quot; option (zero-terminated string)
+containing a base64 encoded ICC color profile.
 
 ICO images can be saved in depth 16, 24, or 32, by using the &quot;depth&quot;
 parameter. When the ICO saver is given &quot;x_hot&quot; and &quot;y_hot&quot; parameters,
@@ -11454,6 +11950,7 @@ The @pixdata contents are reconstructed byte by byte and are checked
 for validity. This function may fail with %GDK_PIXBUF_ERROR_CORRUPT_IMAGE
 or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE.
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -11477,6 +11974,7 @@ serialized #GdkPixdata structure.
 </parameters>
 <return> Upon successful deserialization %TRUE is returned,
 %FALSE otherwise.
+
 </return>
 </function>
 
@@ -11486,6 +11984,7 @@ Converts a #GdkPixbuf to a #GdkPixdata. If @use_rle is %TRUE, the
 pixel data is run-length encoded into newly-allocated memory and a 
 pointer to that memory is returned. 
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -11502,8 +12001,10 @@ pointer to that memory is returned.
 </parameter_description>
 </parameter>
 </parameters>
-<return> If @ure_rle is %TRUE, a pointer to the newly-allocated memory 
-for the run-length encoded pixel data, otherwise %NULL.
+<return> If @use_rle is %TRUE, a pointer to the
+newly-allocated memory for the run-length encoded pixel data,
+otherwise %NULL.
+
 </return>
 </function>
 
@@ -11514,6 +12015,7 @@ The byte stream consists of a straightforward writeout of the
 #GdkPixdata fields in network byte order, plus the @pixel_data
 bytes the structure points to.
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -11529,6 +12031,7 @@ bytes the structure points to.
 <return> A
 newly-allocated string containing the serialized #GdkPixdata
 structure.
+
 </return>
 </function>
 
@@ -11541,6 +12044,7 @@ gdk-pixbuf ships with a program called
 [gdk-pixbuf-csource][gdk-pixbuf-csource], which offers a command
 line interface to this function.
 
+Deprecated: 2.32: Use #GResource instead.
 
 </description>
 <parameters>
@@ -11671,6 +12175,20 @@ timestamp is available.
 <return></return>
 </function>
 
+<function name="gdk_pre_parse_libgtk_only">
+<description>
+Prepare for parsing command line arguments for GDK. This is not
+public API and should not be used in application code.
+
+Deprecated: 3.16: This symbol was never meant to be used outside
+of GTK+
+
+</description>
+<parameters>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_property_change">
 <description>
 Changes the contents of a property on a window.
@@ -12377,6 +12895,10 @@ The work area should be considered when positioning menus and
 similar popups, to avoid placing them below panels, docks or other
 desktop components.
 
+Note that not all backends may have a concept of workarea. This
+function will return the monitor geometry if a workarea is not
+available, or does not apply.
+
 Monitor numbers start at 0. To obtain the number of monitors of
 @screen, use gdk_screen_get_n_monitors().
 
@@ -14787,6 +15309,37 @@ in parent’s coordinate system, or %NULL
 <return></return>
 </function>
 
+<function name="gdk_window_create_gl_context">
+<description>
+Creates a new #GdkGLContext matching the
+framebuffer format to the visual of the #GdkWindow. The context
+is disconnected from any particular window or surface.
+
+If the creation of the #GdkGLContext failed, @error will be set.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="profile">
+<parameter_description> the GL profile the context should target
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> return location for an error
+</parameter_description>
+</parameter>
+</parameters>
+<return> the newly created #GdkGLContext, or
+%NULL on error
+
+</return>
+</function>
+
 <function name="gdk_window_create_similar_image_surface">
 <description>
 Create a new image surface that is efficient to draw on the
@@ -14934,14 +15487,14 @@ Deprecated: 3.8: this function is no longer needed
 
 <function name="gdk_window_end_paint">
 <description>
-Indicates that the backing store created by the most recent call to
-gdk_window_begin_paint_region() should be copied onscreen and
+Indicates that the backing store created by the most recent call
+to gdk_window_begin_paint_region() should be copied onscreen and
 deleted, leaving the next-most-recent backing store or no backing
 store at all as the active paint region. See
-gdk_window_begin_paint_region() for full details. It is an error to
-call this function without a matching
-gdk_window_begin_paint_region() first.
+gdk_window_begin_paint_region() for full details.
 
+It is an error to call this function without a matching
+gdk_window_begin_paint_region() first.
 
 </description>
 <parameters>
@@ -15027,6 +15580,8 @@ an equal number of times to begin processing exposes.
 This function is not part of the GDK public API and is only
 for use by GTK+.
 
+Deprecated: 3.16: This symbol was never meant to be used outside of GTK+
+
 </description>
 <parameters>
 <parameter name="window">
@@ -15223,6 +15778,9 @@ See gdk_window_set_composited().
 
 Since: 2.22
 
+Deprecated: 3.16: Compositing is an outdated technology that
+only ever worked on X11.
+
 </description>
 <parameters>
 <parameter name="window">
@@ -16474,6 +17032,33 @@ function before gdk_window_show(). (Try gdk_window_show_unraised().)
 <return></return>
 </function>
 
+<function name="gdk_window_mark_paint_from_clip">
+<description>
+If you call this during a paint (e.g. between gdk_window_begin_paint_region()
+and gdk_window_end_paint() then GDK will mark the current clip region of the
+window as being drawn. This is required when mixing GL rendering via
+gdk_cairo_draw_from_gl() and cairo rendering, as otherwise GDK has no way
+of knowing when something paints over the GL-drawn regions.
+
+This is typically called automatically by GTK+ and you don't need
+to care about this.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GdkWindow
+</parameter_description>
+</parameter>
+<parameter name="cr">
+<parameter_description> a #cairo_t
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gdk_window_maximize">
 <description>
 Maximizes the window. If the window was already maximized, then
@@ -17056,6 +17641,9 @@ attempting to do so.
 
 Since: 2.12
 
+Deprecated: 3.16: Compositing is an outdated technology that
+only ever worked on X11.
+
 </description>
 <parameters>
 <parameter name="window">
@@ -17072,11 +17660,15 @@ Since: 2.12
 
 <function name="gdk_window_set_cursor">
 <description>
-Sets the default mouse pointer for a #GdkWindow. Use gdk_cursor_new_for_display()
-or gdk_cursor_new_from_pixbuf() to create the cursor. To make the cursor
-invisible, use %GDK_BLANK_CURSOR. Passing %NULL for the @cursor argument
-to gdk_window_set_cursor() means that @window will use the cursor of its
-parent window. Most windows should use this default.
+Sets the default mouse pointer for a #GdkWindow.
+
+Note that @cursor must be for the same display as @window.
+
+Use gdk_cursor_new_for_display() or gdk_cursor_new_from_pixbuf() to
+create the cursor. To make the cursor invisible, use %GDK_BLANK_CURSOR.
+Passing %NULL for the @cursor argument to gdk_window_set_cursor() means
+that @window will use the cursor of its parent window. Most windows
+should use this default.
 
 </description>
 <parameters>
@@ -17596,7 +18188,12 @@ of the opacity parameter are clamped to the [0,1] range.)
 
 For toplevel windows this depends on support from the windowing system
 that may not always be there. For instance, On X11, this works only on
-X screens with a compositing manager running.
+X screens with a compositing manager running. On Wayland, there is no
+per-window opacity value that the compositor would apply. Instead, use
+`gdk_window_set_opaque_region (window, NULL)` to tell the compositor
+that the entire window is (potentially) non-opaque, and draw your content
+with alpha, or use gtk_widget_set_opacity() to set an overall opacity
+for your widgets.
 
 For child windows this function only works for non-native windows.
 
@@ -17852,11 +18449,13 @@ Since: 2.12
 
 <function name="gdk_window_set_static_gravities">
 <description>
-Set the bit gravity of the given window to static, and flag it so
-all children get static subwindow gravity. This is used if you are
-implementing scary features that involve deep knowledge of the
-windowing system. Don’t worry about it unless you have to.
+Used to set the bit gravity of the given window to static, and flag
+it so all children get static subwindow gravity. This is used if you
+are implementing scary features that involve deep knowledge of the
+windowing system. Don’t worry about it.
 
+Deprecated: 3.16: static gravities haven't worked on anything but X11
+for a long time.
 
 </description>
 <parameters>
@@ -17869,7 +18468,8 @@ windowing system. Don’t worry about it unless you have to.
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE if the server supports static gravity
+<return> %FALSE
+
 </return>
 </function>
 
@@ -18149,6 +18749,8 @@ gdk_window_freeze_toplevel_updates_libgtk_only().
 This function is not part of the GDK public API and is only
 for use by GTK+.
 
+Deprecated: 3.16: This symbol was never meant to be used outside of GTK+
+
 </description>
 <parameters>
 <parameter name="window">
@@ -18480,6 +19082,32 @@ Since: 3.0
 <return></return>
 </function>
 
+<function name="gdk_x11_display_get_glx_version">
+<description>
+Retrieves the version of the GLX implementation.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="display">
+<parameter_description> a #GdkDisplay
+</parameter_description>
+</parameter>
+<parameter name="major">
+<parameter_description> return location for the GLX major version
+</parameter_description>
+</parameter>
+<parameter name="minor">
+<parameter_description> return location for the GLX minor version
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if GLX is available
+
+</return>
+</function>
+
 <function name="gdk_x11_display_get_startup_notification_id">
 <description>
 Gets the startup notification ID for a display.
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index e3f82c7..9710e53 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -1005,6 +1005,27 @@ contains.
 </parameters>
 </enum>
 
+<enum name="GtkButtonRole">
+<description>
+The role specifies the desired appearance of a #GtkModelButton.
+
+</description>
+<parameters>
+<parameter name="GTK_BUTTON_ROLE_NORMAL">
+<parameter_description> A plain button
+</parameter_description>
+</parameter>
+<parameter name="GTK_BUTTON_ROLE_CHECK">
+<parameter_description> A check button
+</parameter_description>
+</parameter>
+<parameter name="GTK_BUTTON_ROLE_RADIO">
+<parameter_description> A radio button
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
 <enum name="GtkButtonsType">
 <description>
 Prebuilt sets of buttons for the dialog. If
@@ -1930,7 +1951,7 @@ than when a loading function was called.
 
 <enum name="GtkCssProviderError">
 <description>
-Deprecated.
+Error codes for %GTK_CSS_PROVIDER_ERROR.
 
 </description>
 <parameters>
@@ -3692,6 +3713,88 @@ Space, Shift+Space, Return or Enter.
 <return></return>
 </signal>
 
+<signal name="GtkGLArea::create-context">
+<description>
+The ::create-context signal is emitted when the widget is being
+realized, and allows you to override how the GL context is
+created. This is useful when you want to reuse an existing GL
+context, or if you want to try creating different kinds of GL
+profiles.
+
+If context creation fails then the signal handler can use
+gtk_gl_area_set_error() to register a more detailed error
+of how the construction failed.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> the #GtkGLArea that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> location to store error information on failure
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly created #GdkGLContext;
+the #GtkGLArea widget will take ownership of the returned value.
+
+</return>
+</signal>
+
+<signal name="GtkGLArea::render">
+<description>
+The ::render signal is emitted every time the contents
+of the #GtkGLArea should be redrawn.
+
+The @context is bound to the @area prior to emitting this function,
+and the buffers are painted to the window once the emission terminates.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> the #GtkGLArea that emitted the signal
+</parameter_description>
+</parameter>
+<parameter name="context">
+<parameter_description> the #GdkGLContext used by @area
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE to stop other handlers from being invoked for the event.
+%FALSE to propagate the event further.
+
+</return>
+</signal>
+
+<signal name="GtkGLArea::resized">
+<description>
+The ::resized signal is emitted once when the widget is realized, and
+then each time the widget is changed while realized. This is useful
+in order to keep GL state up to date with the widget size, like for
+instance camera properties which may depend on the width/height ratio.
+
+The GL context for the area is guaranteed to be current when this signal
+is emitted.
+
+The default handler sets up the GL viewport.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> the #GtkGLArea that emitted the signal
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkGesture::begin">
 <description>
 This signal is emitted when the gesture is recognized. This means the
@@ -6487,6 +6590,12 @@ For example, when all of a #GtkTreeView can not be seen.
 content determines the size.
 </parameter_description>
 </parameter>
+<parameter name="GTK_POLICY_EXTERNAL">
+<parameter_description> Don't show a scrollbar, but don't force the
+size to follow the content. This can be used e.g. to make multiple
+scrolled windows share a scrollbar. Since: 3.16
+</parameter_description>
+</parameter>
 </parameters>
 </enum>
 
@@ -8166,14 +8275,43 @@ the scrolled window adjustments in a given orientation.
 </parameters>
 </enum>
 
+<signal name="GtkScrolledWindow::edge-overshot">
+<description>
+The ::edge-overshot signal is emitted whenever user initiated scrolling
+makes the scrolledwindow firmly surpass (ie. with some edge resistance)
+the lower or upper limits defined by the adjustment in that orientation.
+
+If a similar behavior without edge resistance is desired, one alternative
+may be to check on #GtkAdjustment::value-changed that the value equals
+either #GtkAdjustment:lower or #GtkAdjustment:upper - #GtkAdjustment:page-size.
+
+Note: The @pos argument is LTR/RTL aware, so callers should be aware too
+if intending to provide behavior on horizontal edges.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="scrolled_window">
+<parameter_description> a #GtkScrolledWindow
+</parameter_description>
+</parameter>
+<parameter name="pos">
+<parameter_description> edge side that was hit
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</signal>
+
 <signal name="GtkScrolledWindow::move-focus-out">
 <description>
 The ::move-focus-out signal is a
 [keybinding signal][GtkBindingSignal] which gets
 emitted when focus is moved away from the scrolled window by a
-keybinding.  The #GtkWidget::move-focus signal is emitted with
+keybinding. The #GtkWidget::move-focus signal is emitted with
 @direction_type on this scrolled windows toplevel parent in the
-container hierarchy.  The default bindings for this signal are
+container hierarchy. The default bindings for this signal are
 `Tab + Ctrl` and `Tab + Ctrl + Shift`.
 
 </description>
@@ -10078,7 +10216,8 @@ The default bindings for this signal is Insert.
 
 <enum name="GtkTextViewLayer">
 <description>
-Used to reference the parts of #GtkTextView.
+Used to reference the layers of #GtkTextView for the purpose of customized
+drawing with the ::draw_layer vfunc.
 
 </description>
 <parameters>
@@ -12945,6 +13084,8 @@ widget under the pointer.
 The default bindings for this signal are Ctrl-Shift-I
 and Ctrl-Shift-D.
 
+Return: %TRUE if the key binding was handled
+
 </description>
 <parameters>
 <parameter name="window">
@@ -20759,15 +20900,15 @@ and merges it with the current contents of @builder.
 
 Most users will probably want to use gtk_builder_new_from_file().
 
-Upon errors 0 will be returned and @error will be assigned a
+If an error occurs, 0 will be returned and @error will be assigned a
 #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR 
 domain.
 
 It’s not really reasonable to attempt to handle failures of this
-call.  You should not use this function with untrusted files (ie:
-files that are not part of your application).  Broken #GtkBuilder
+call. You should not use this function with untrusted files (ie:
+files that are not part of your application). Broken #GtkBuilder
 files can easily crash your program, and it’s possible that memory
-was leaked leading up to the reported failure.  The only reasonable
+was leaked leading up to the reported failure. The only reasonable
 thing to do when an error is detected is to call g_error().
 
 Since: 2.12
@@ -20799,7 +20940,7 @@ and merges it with the current contents of @builder.
 
 Most users will probably want to use gtk_builder_new_from_resource().
 
-Upon errors 0 will be returned and @error will be assigned a
+If an error occurs, 0 will be returned and @error will be assigned a
 #GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_RESOURCE_ERROR
 domain.
 
@@ -20837,7 +20978,8 @@ and merges it with the current contents of @builder.
 Most users will probably want to use gtk_builder_new_from_string().
 
 Upon errors 0 will be returned and @error will be assigned a
-#GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain.
+#GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or
+#G_VARIANT_PARSE_ERROR domain.
 
 It’s not really reasonable to attempt to handle failures of this
 call.  The only reasonable thing to do when an error is detected is
@@ -21091,7 +21233,7 @@ The #GtkApplication is used for creating action proxies as requested
 from XML that the builder is loading.
 
 By default, the builder uses the default application: the one from
-g_application_get_default().  If you want to use another application
+g_application_get_default(). If you want to use another application
 for constructing proxies, use gtk_builder_set_application().
 
 Since: 3.10
@@ -21230,9 +21372,9 @@ Since: 3.10
 <description>
 Creates a new empty builder object.
 
-This function is only useful if you intend to make multiple calls to
-gtk_builder_add_from_file(), gtk_builder_add_from_resource() or
-gtk_builder_add_from_string() in order to merge multiple UI
+This function is only useful if you intend to make multiple calls
+to gtk_builder_add_from_file(), gtk_builder_add_from_resource()
+or gtk_builder_add_from_string() in order to merge multiple UI
 descriptions into a single builder.
 
 Most users will probably want to use gtk_builder_new_from_file(),
@@ -21276,8 +21418,8 @@ Since: 3.10
 Builds the [GtkBuilder UI definition][BUILDER-UI]
 at @resource_path.
 
-If there is an error locating the resurce or parsing the description
-then the program will be aborted.
+If there is an error locating the resource or parsing the
+description, then the program will be aborted.
 
 Since: 3.10
 
@@ -21298,11 +21440,11 @@ Since: 3.10
 Builds the user interface described by @string (in the
 [GtkBuilder UI definition][BUILDER-UI] format).
 
-If @string is %NULL-terminated then @length should be -1.  If @length
-is not -1 then it is the length of @string.
+If @string is %NULL-terminated, then @length should be -1.
+If @length is not -1, then it is the length of @string.
 
 If there is an error parsing @string then the program will be
-aborted.  You should not attempt to parse user interface description
+aborted. You should not attempt to parse user interface description
 from untrusted sources.
 
 Since: 3.10
@@ -21328,7 +21470,7 @@ Since: 3.10
 Sets the application associated with @builder.
 
 You only need this function if there is more than one #GApplication
-in your process.  @application cannot be %NULL.
+in your process. @application cannot be %NULL.
 
 Since: 3.10
 
@@ -30104,7 +30246,7 @@ potentially do a copy.
 <return> %TRUE. The return value is deprecated and %FALSE will only be
 returned for backwards compatibility reasons if an @error is not 
 %NULL and a loading error occured. To track errors while loading
-CSS, connect to the GtkCssProvider::parsing-error signal.
+CSS, connect to the #GtkCssProvider::parsing-error signal.
 </return>
 </function>
 
@@ -30132,7 +30274,7 @@ clear any previously loaded information.
 <return> %TRUE. The return value is deprecated and %FALSE will only be
 returned for backwards compatibility reasons if an @error is not 
 %NULL and a loading error occured. To track errors while loading
-CSS, connect to the GtkCssProvider::parsing-error signal.
+CSS, connect to the #GtkCssProvider::parsing-error signal.
 </return>
 </function>
 
@@ -30160,10 +30302,34 @@ any previously loaded information.
 <return> %TRUE. The return value is deprecated and %FALSE will only be
 returned for backwards compatibility reasons if an @error is not 
 %NULL and a loading error occured. To track errors while loading
-CSS, connect to the GtkCssProvider::parsing-error signal.
+CSS, connect to the #GtkCssProvider::parsing-error signal.
 </return>
 </function>
 
+<function name="gtk_css_provider_load_from_resource">
+<description>
+Loads the data contained in the resource at @resource_path into
+the #GtkCssProvider, clearing any previously loaded information.
+
+To track errors while loading CSS, connect to the
+#GtkCssProvider::parsing-error signal.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="css_provider">
+<parameter_description> a #GtkCssProvider
+</parameter_description>
+</parameter>
+<parameter name="resource_path">
+<parameter_description> a #GResource resource path
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_css_provider_new">
 <description>
 Returns a newly created #GtkCssProvider.
@@ -31015,77 +31181,45 @@ source can provide the data.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return>
+</return>
 </function>
 
 <function name="gtk_drag_begin_with_coordinates">
 <description>
-Initiates a drag on the source side. The function only needs to be used
-when the application is starting drags itself, and is not needed when
-gtk_drag_source_set() is used.
-
-The @event is used to retrieve the timestamp that will be used internally to
-grab the pointer.  If @event is %NULL, then %GDK_CURRENT_TIME will be used.
-However, you should try to pass a real event in all cases, since that can be
-used to get information about the drag.
-
-Generally there are three cases when you want to start a drag by hand by
-calling this function:
-
-1. During a #GtkWidget::button-press-event handler, if you want to start a drag
-immediately when the user presses the mouse button.  Pass the @event
-that you have in your #GtkWidget::button-press-event handler.
-
-2. During a #GtkWidget::motion-notify-event handler, if you want to start a drag
-when the mouse moves past a certain threshold distance after a button-press.
-Pass the @event that you have in your #GtkWidget::motion-notify-event handler.
-
-3. During a timeout handler, if you want to start a drag after the mouse
-button is held down for some time.  Try to save the last event that you got
-from the mouse, using gdk_event_copy(), and pass it to this function
-(remember to free the event with gdk_event_free() when you are done).
-If you can really not pass a real event, pass #NULL instead.
-
-Since: 3.10
 
 </description>
 <parameters>
 <parameter name="widget">
-<parameter_description> the source widget
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="targets">
-<parameter_description> The targets (data formats) in which the
-source can provide the data
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="actions">
-<parameter_description> A bitmask of the allowed drag actions for this drag
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="button">
-<parameter_description> The button the user clicked to start the drag
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="event">
-<parameter_description> The event that triggered the start of the drag
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="x">
-<parameter_description> The initial x coordinate to start dragging from, in the coordinate space
-of @widget. If -1 is passed, the coordinates are retrieved from @event or
-the current pointer position
+<parameter_description>
 </parameter_description>
 </parameter>
 <parameter name="y">
-<parameter_description> The initial y coordinate to start dragging from, in the coordinate space
-of @widget. If -1 is passed, the coordinates are retrieved from @event or
-the current pointer position
+<parameter_description>
 </parameter_description>
 </parameter>
 </parameters>
-<return> the context for this drag
-
+<return>
 </return>
 </function>
 
@@ -31176,7 +31310,8 @@ gtk_drag_dest_get_target_list (@widget).
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return>
+</return>
 </function>
 
 <function name="gtk_drag_dest_get_target_list">
@@ -31376,7 +31511,8 @@ or #GtkWidget::drag-drop&quot; signal.
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return>
+</return>
 </function>
 
 <function name="gtk_drag_highlight">
@@ -31638,7 +31774,8 @@ Since: 2.6
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return>
+</return>
 </function>
 
 <function name="gtk_drag_source_set">
@@ -39943,6 +40080,37 @@ of an event sequence is constrained to the next four:
 * None → Claimed
 * None → Claimed → Denied
 
+Note: Due to event handling ordering, it may be unsafe to
+set the state on another gesture within a #GtkGesture::begin
+signal handler, as the callback might be executed before
+the other gesture knows about the sequence. A safe way to
+perform this could be:
+
+|[
+static void
+first_gesture_begin_cb (GtkGesture       *first_gesture,
+GdkEventSequence *sequence,
+gpointer          user_data)
+{
+gtk_gesture_set_sequence_state (first_gesture, sequence, GTK_EVENT_SEQUENCE_ACCEPTED);
+gtk_gesture_set_sequence_state (second_gesture, sequence, GTK_EVENT_SEQUENCE_DENIED);
+}
+
+static void
+second_gesture_begin_cb (GtkGesture       *second_gesture,
+GdkEventSequence *sequence,
+gpointer          user_data)
+{
+if (gtk_gesture_get_sequence_state (first_gesture, sequence) == GTK_EVENT_SEQUENCE_ACCEPTED)
+gtk_gesture_set_sequence_state (second_gesture, sequence, GTK_EVENT_SEQUENCE_DENIED);
+}
+]|
+
+If both gestures are in the same group, just set the state on
+the gesture emitting the event, the sequence will be already
+be initialized to the group's global state when the second
+gesture processes the event.
+
 Since: 3.14
 
 </description>
@@ -40546,6 +40714,351 @@ arguments recognized by GTK+
 </return>
 </function>
 
+<function name="gtk_gl_area_attach_buffers">
+<description>
+Ensures that the @area framebuffer object is made the current draw
+and read target, and that all the required buffers for the @area
+are created and bound to the frambuffer.
+
+This function is automatically called before emitting the
+#GtkGLArea::render signal, and doesn't normally need to be called
+by application code.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_get_auto_render">
+<description>
+Returns whether the area is in auto render mode or not.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @area is auto rendering, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_context">
+<description>
+Retrieves the #GdkGLContext used by @area.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GdkGLContext
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_error">
+<description>
+Gets the current error set on the @area.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> the #GError or %NULL
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_has_alpha">
+<description>
+Returns whether the area has an alpha component.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @area has an alpha component, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_has_depth_buffer">
+<description>
+Returns whether the area has a depth buffer.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @area has a depth buffer, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_has_stencil_buffer">
+<description>
+Returns whether the area has a stencil buffer.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the @area has a stencil buffer, %FALSE otherwise
+
+</return>
+</function>
+
+<function name="gtk_gl_area_get_profile">
+<description>
+Returns the profile that will be used to create the GL context for the area.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return> a #GdkGLProfile
+
+</return>
+</function>
+
+<function name="gtk_gl_area_make_current">
+<description>
+Ensures that the #GdkGLContext used by @area is associated with
+the #GtkGLArea.
+
+This function is automatically called before emitting the
+#GtkGLArea::render signal, and doesn't normally need to be called
+by application code.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_new">
+<description>
+Creates a new #GtkGLArea widget.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #GtkGLArea
+
+</return>
+</function>
+
+<function name="gtk_gl_area_queue_render">
+<description>
+Marks the currently rendered data (if any) as invalid, and queues
+a redraw of the widget, ensuring that the #GtkGLArea::render signal
+is emitted during the draw.
+
+This is only needed when the gtk_gl_area_set_auto_render() has
+been called with a %FALSE value. The default behaviour is to
+emit #GtkGLArea::render on each draw.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_auto_render">
+<description>
+If @auto_render is %TRUE the #GtkGLArea::render signal will be
+emitted every time the widget draws. This is the default and is
+useful if drawing the widget is faster.
+
+If @auto_render is %FALSE the data from previous rendering is kept
+around and will be used for drawing the widget the next time,
+unless the window is resized. In order to force a rendering
+gtk_gl_area_queue_render() must be called. This mode is useful when
+the scene changes seldomly, but takes a long time to redraw.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="auto_render">
+<parameter_description> a boolean
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_error">
+<description>
+Sets an error on the area which will be shown instead of the
+GL rendering. This is useful in the #GtkGLArea::create-context
+signal if GL context creation fails.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="error">
+<parameter_description> a new #GError, or %NULL to unset the error
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_has_alpha">
+<description>
+If @has_alpha is %TRUE the buffer allocated by the widget will have
+an alpha channel component, and when rendering to the window the
+result will be composited over whatever is below the widget.
+
+If @has_alpha is %FALSE there will be no alpha channel, and the
+buffer will fully replace anything below the widget.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="has_alpha">
+<parameter_description> %TRUE to add an alpha component
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_has_depth_buffer">
+<description>
+If @has_depth_buffer is %TRUE the widget will allocate and
+enable a depth buffer for the target framebuffer. Otherwise
+there will be none.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="has_depth_buffer">
+<parameter_description> %TRUE to add a depth buffer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_has_stencil_buffer">
+<description>
+If @has_stencil_buffer is %TRUE the widget will allocate and
+enable a stencil buffer for the target framebuffer. Otherwise
+there will be none.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="has_stencil_buffer">
+<parameter_description> %TRUE to add a stencil buffer
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_gl_area_set_profile">
+<description>
+Sets the profile type to be used when creating the context for the widget.
+This must be called before the are has been realized.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="area">
+<parameter_description> a #GtkGLArea
+</parameter_description>
+</parameter>
+<parameter name="profile">
+<parameter_description> a #GdkGLProfile
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_grab_add">
 <description>
 Makes @widget the current grabbed widget.
@@ -48613,6 +49126,42 @@ Since: 2.6
 </return>
 </function>
 
+<function name="gtk_label_get_xalign">
+<description>
+Gets the #GtkLabel:xalign property for @label.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+</parameters>
+<return> the xalign property
+
+</return>
+</function>
+
+<function name="gtk_label_get_yalign">
+<description>
+Gets the #GtkLabel:yalign property for @label.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+</parameters>
+<return> the yalign property
+
+</return>
+</function>
+
 <function name="gtk_label_new">
 <description>
 Creates a new label with the given text inside it. You can
@@ -49161,6 +49710,46 @@ Since: 2.6
 <return></return>
 </function>
 
+<function name="gtk_label_set_xalign">
+<description>
+Sets the #GtkLabel:xalign property for @label.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+<parameter name="xalign">
+<parameter_description> the new xalign value, between 0 and 1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_label_set_yalign">
+<description>
+Sets the #GtkLabel:yalign property for @label.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="label">
+<parameter_description> a #GtkLabel
+</parameter_description>
+</parameter>
+<parameter name="xalign">
+<parameter_description> the new yalign value, between 0 and 1
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_layout_get_bin_window">
 <description>
 Retrieve the bin window of the layout used for drawing operations.
@@ -53687,6 +54276,20 @@ in pixels.
 <return></return>
 </function>
 
+<function name="gtk_model_button_new">
+<description>
+Creates a new GtkModelButton.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> the newly created #GtkModelButton widget
+
+</return>
+</function>
+
 <function name="gtk_mount_operation_get_parent">
 <description>
 Gets the transient parent used by the #GtkMountOperation
@@ -57118,6 +57721,24 @@ Obtains the position of the divider between the two panes.
 </return>
 </function>
 
+<function name="gtk_paned_get_wide_handle">
+<description>
+Gets the #GtkPaned:wide-handle property.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="paned">
+<parameter_description> a #GtkPaned
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the paned should have a wide handle
+
+</return>
+</function>
+
 <function name="gtk_paned_new">
 <description>
 Creates a new #GtkPaned widget.
@@ -57207,6 +57828,26 @@ is unset.
 <return></return>
 </function>
 
+<function name="gtk_paned_set_wide_handle">
+<description>
+Sets the #GtkPaned:wide-handle property.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="paned">
+<parameter_description> a #GtkPaned
+</parameter_description>
+</parameter>
+<parameter name="wide">
+<parameter_description> the new value for the #GtkPaned:wide-handle property
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_paper_size_copy">
 <description>
 Copies an existing #GtkPaperSize.
@@ -57505,6 +58146,22 @@ represent the same paper size
 </return>
 </function>
 
+<function name="gtk_paper_size_is_ipp">
+<description>
+Returns %TRUE if @size is an IPP standard paper size.
+
+
+</description>
+<parameters>
+<parameter name="size">
+<parameter_description> a #GtkPaperSize object
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @size is not an IPP custom paper size.
+</return>
+</function>
+
 <function name="gtk_paper_size_new">
 <description>
 Creates a new #GtkPaperSize object by parsing a
@@ -57565,6 +58222,38 @@ to free it
 </return>
 </function>
 
+<function name="gtk_paper_size_new_from_ipp">
+<description>
+Creates a new #GtkPaperSize object by using
+IPP information.
+
+If @ipp_name is not a recognized paper name,
+ width and @height are used to
+construct a custom #GtkPaperSize object.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="ipp_name">
+<parameter_description> an IPP paper name
+</parameter_description>
+</parameter>
+<parameter name="width">
+<parameter_description> the paper width, in points
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> the paper height in points
+</parameter_description>
+</parameter>
+</parameters>
+<return> a new #GtkPaperSize, use gtk_paper_size_free()
+to free it
+
+</return>
+</function>
+
 <function name="gtk_paper_size_new_from_key_file">
 <description>
 Reads a paper size from the group @group_name in the key file
@@ -58405,6 +59094,48 @@ Since: 3.12
 </return>
 </function>
 
+<function name="gtk_popover_menu_new">
+<description>
+Creates a new popover menu.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> a new #GtkPopoverMenu
+
+</return>
+</function>
+
+<function name="gtk_popover_menu_open_submenu">
+<description>
+Opens a submenu of the @popover. The @name
+must be one of the names given to the submenus
+of @popover with #GtkPopoverMenu:submenu, or
+&quot;main&quot; to switch back to the main menu.
+
+#GtkModelButton will open submenus automatically
+when the #GtkModelButton:menu-name property is set,
+so this function is only needed when you are using
+other kinds of widgets to initiate menu changes.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="popover">
+<parameter_description> a #GtkPopoverMenu
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name of the menu to switch to
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_popover_new">
 <description>
 Creates a new popover to point to @relative_to
@@ -62743,11 +63474,17 @@ Since: 2.10
 
 <function name="gtk_printer_option_set_get_groups">
 <description>
+Gets the groups in this set.
+
 
 </description>
 <parameters>
+<parameter name="set">
+<parameter_description> a #GtkPrinterOptionSet
+</parameter_description>
+</parameter>
 </parameters>
-<return>
+<return> a list of group names.
 </return>
 </function>
 
@@ -67071,7 +67808,7 @@ removed by the recently used resources list, and %FALSE otherwise.
 <function name="gtk_render_activity">
 <description>
 Renders an activity indicator (such as in #GtkSpinner).
-The state %GTK_STATE_FLAG_ACTIVE determines whether there is
+The state %GTK_STATE_FLAG_CHECKED determines whether there is
 activity going on.
 
 Since: 3.0
@@ -67191,7 +67928,7 @@ Since: 3.0.
 <description>
 Renders a checkmark (as in a #GtkCheckButton).
 
-The %GTK_STATE_FLAG_ACTIVE state determines whether the check is
+The %GTK_STATE_FLAG_CHECKED state determines whether the check is
 on or off, and %GTK_STATE_FLAG_INCONSISTENT determines whether it
 should be marked as undefined.
 
@@ -67234,7 +67971,7 @@ Since: 3.0
 <function name="gtk_render_expander">
 <description>
 Renders an expander (as used in #GtkTreeView and #GtkExpander) in the area
-defined by @x, @y, @width, @height. The state %GTK_STATE_FLAG_ACTIVE
+defined by @x, @y, @width, @height. The state %GTK_STATE_FLAG_CHECKED
 determines whether the expander is collapsed or expanded.
 
 Typical expander rendering:
@@ -67701,7 +68438,7 @@ Since: 3.0
 
 <function name="gtk_render_option">
 <description>
-Renders an option mark (as in a #GtkRadioButton), the %GTK_STATE_FLAG_ACTIVE
+Renders an option mark (as in a #GtkRadioButton), the %GTK_STATE_FLAG_CHECKED
 state will determine whether the option is on or off, and
 %GTK_STATE_FLAG_INCONSISTENT whether it should be marked as undefined.
 
@@ -68739,7 +69476,7 @@ widgets with native scrolling support should not be used with the
 A widget supports scrolling natively if it implements the
 #GtkScrollable interface.
 
-Deprecated: 3.8: gtk_container_add() will now automatically add
+Deprecated: 3.8: gtk_container_add() will automatically add
 a #GtkViewport if the child doesn’t implement #GtkScrollable.
 
 </description>
@@ -68865,6 +69602,24 @@ Since: 3.0
 </return>
 </function>
 
+<function name="gtk_scrolled_window_get_overlay_scrolling">
+<description>
+Returns whether overlay scrolling is enabled for this scrolled window.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="scrolled_window">
+<parameter_description> a #GtkScrolledWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if overlay scrolling is enabled
+
+</return>
+</function>
+
 <function name="gtk_scrolled_window_get_placement">
 <description>
 Gets the placement of the contents with respect to the scrollbars
@@ -68898,12 +69653,12 @@ scrollbars. See gtk_scrolled_window_set_policy().
 </parameter>
 <parameter name="hscrollbar_policy">
 <parameter_description> location to store the policy 
-for the horizontal scrollbar, or %NULL.
+for the horizontal scrollbar, or %NULL
 </parameter_description>
 </parameter>
 <parameter name="vscrollbar_policy">
 <parameter_description> location to store the policy
-for the vertical scrollbar, or %NULL.
+for the vertical scrollbar, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
@@ -69101,6 +69856,26 @@ Since: 3.0
 <return></return>
 </function>
 
+<function name="gtk_scrolled_window_set_overlay_scrolling">
+<description>
+Enables or disables overlay scrolling for this scrolled window.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="scrolled_window">
+<parameter_description> a #GtkScrolledWindow
+</parameter_description>
+</parameter>
+<parameter name="overlay_scrolling">
+<parameter_description> whether to enable overlay scrolling
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_scrolled_window_set_placement">
 <description>
 Sets the placement of the contents with respect to the scrollbars
@@ -69137,7 +69912,7 @@ from the #GtkPolicyType enumeration. If %GTK_POLICY_ALWAYS, the
 scrollbar is always present; if %GTK_POLICY_NEVER, the scrollbar is
 never present; if %GTK_POLICY_AUTOMATIC, the scrollbar is present only
 if needed (that is, if the slider part of the bar would be smaller
-than the trough - the display is larger than the page size).
+than the trough — the display is larger than the page size).
 
 </description>
 <parameters>
@@ -69162,7 +69937,6 @@ than the trough - the display is larger than the page size).
 Changes the type of shadow drawn around the contents of
 @scrolled_window.
 
-
 </description>
 <parameters>
 <parameter name="scrolled_window">
@@ -69199,7 +69973,7 @@ Sets the #GtkAdjustment for the vertical scrollbar.
 <description>
 Unsets the placement of the contents with respect to the scrollbars
 for the scrolled window. If no window placement is set for a scrolled
-window, it defaults to GTK_CORNER_TOP_LEFT.
+window, it defaults to %GTK_CORNER_TOP_LEFT.
 
 See also gtk_scrolled_window_set_placement() and
 gtk_scrolled_window_get_placement().
@@ -70181,8 +70955,23 @@ Since: 2.2
 </return>
 </function>
 
+<function name="gtk_settings_install_property">
+<description>
+Deprecated: 3.16: This function is not useful outside GTK+.
+
+</description>
+<parameters>
+<parameter name="pspec">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_settings_install_property_parser">
 <description>
+Deprecated: 3.16: This function is not useful outside GTK+.
 
 </description>
 <parameters>
@@ -70198,6 +70987,106 @@ Since: 2.2
 <return></return>
 </function>
 
+<function name="gtk_settings_set_double_property">
+<description>
+Deprecated: 3.16: Use g_object_set() instead.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="v_double">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="origin">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_settings_set_long_property">
+<description>
+Deprecated: 3.16: Use g_object_set() instead.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="v_long">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="origin">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_settings_set_property_value">
+<description>
+Deprecated: 3.16: Use g_object_set() instead.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="svalue">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
+<function name="gtk_settings_set_string_property">
+<description>
+Deprecated: 3.16: Use g_object_set() instead.
+
+</description>
+<parameters>
+<parameter name="settings">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="v_string">
+<parameter_description>
+</parameter_description>
+</parameter>
+<parameter name="origin">
+<parameter_description>
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_show_about_dialog">
 <description>
 This is a convenience function for showing an application’s about box.
@@ -70266,6 +71155,63 @@ or %NULL for the default screen
 </return>
 </function>
 
+<function name="gtk_sidebar_get_stack">
+<description>
+Retrieves the stack.
+See gtk_sidebar_set_stack().
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a #GtkSidebar
+</parameter_description>
+</parameter>
+</parameters>
+<return> the associated #GtkStack or
+%NULL if none has been set explicitly
+
+</return>
+</function>
+
+<function name="gtk_sidebar_new">
+<description>
+Creates a new sidebar.
+
+Since: 3.16
+
+</description>
+<parameters>
+</parameters>
+<return> the new #GtkSidebar
+
+</return>
+</function>
+
+<function name="gtk_sidebar_set_stack">
+<description>
+Set the #GtkStack associated with this #GtkSidebar.
+
+The sidebar widget will automatically update according to the order
+(packing) and items within the given #GtkStack.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="sidebar">
+<parameter_description> a #GtkSidebar
+</parameter_description>
+</parameter>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_size_group_add_widget">
 <description>
 Adds a widget to a #GtkSizeGroup. In the future, the requisition
@@ -71262,6 +72208,25 @@ Since: 3.12
 </return>
 </function>
 
+<function name="gtk_stack_get_hhomogeneous">
+<description>
+Gets whether @stack is horizontally homogeneous.
+See gtk_stack_set_hhomogeneous().
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @stack is horizontally homogeneous.
+
+</return>
+</function>
+
 <function name="gtk_stack_get_homogeneous">
 <description>
 Gets whether @stack is homogeneous.
@@ -71338,6 +72303,25 @@ Since: 3.10
 </return>
 </function>
 
+<function name="gtk_stack_get_vhomogeneous">
+<description>
+Gets whether @stack is vertically homogeneous.
+See gtk_stack_set_vhomogeneous().
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+</parameters>
+<return> whether @stack is vertically homogeneous.
+
+</return>
+</function>
+
 <function name="gtk_stack_get_visible_child">
 <description>
 Gets the currently visible child of @stack, or %NULL if
@@ -71390,6 +72374,29 @@ Since: 3.10
 </return>
 </function>
 
+<function name="gtk_stack_set_hhomogeneous">
+<description>
+Sets the #GtkStack to be horizontally homogeneous or not.
+If it is homogeneous, the #GtkStack will request the same
+width for all its children. If it isn't, the stack
+may change width when a different child becomes visible.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="hhomogeneous">
+<parameter_description> %TRUE to make @stack horizontally homogeneous
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_stack_set_homogeneous">
 <description>
 Sets the #GtkStack to be homogeneous or not. If it
@@ -71397,6 +72404,10 @@ is homogeneous, the #GtkStack will request the same
 size for all its children. If it isn't, the stack
 may change size when a different child becomes visible.
 
+Since 3.16, homogeneity can be controlled separately
+for horizontal and vertical size, with the
+#GtkStack:hhomogeneous and #GtkStack:vhomogeneous.
+
 Since: 3.10
 
 </description>
@@ -71460,6 +72471,29 @@ Since: 3.10
 <return></return>
 </function>
 
+<function name="gtk_stack_set_vhomogeneous">
+<description>
+Sets the #GtkStack to be vertically homogeneous or not.
+If it is homogeneous, the #GtkStack will request the same
+height for all its children. If it isn't, the stack
+may change height when a different child becomes visible.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="stack">
+<parameter_description> a #GtkStack
+</parameter_description>
+</parameter>
+<parameter name="vhomogeneous">
+<parameter_description> %TRUE to make @stack vertically homogeneous
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_stack_set_visible_child">
 <description>
 Makes @child the visible child of @stack.
@@ -73056,6 +74090,8 @@ Gets the background color for a given state.
 
 Since: 3.0
 
+Deprecated: 3.16: Use gtk_render_background() instead.
+
 </description>
 <parameters>
 <parameter name="context">
@@ -73105,6 +74141,8 @@ Gets the border color for a given state.
 
 Since: 3.0
 
+Deprecated: 3.16: Use gtk_render_border() instead.
+
 </description>
 <parameters>
 <parameter name="context">
@@ -74487,6 +75525,8 @@ Deprecated: 3.0: Use #GtkStyleContext
 <description>
 Clears all style information from @props.
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74504,6 +75544,8 @@ given state.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74529,6 +75571,8 @@ g_value_unset() needs to be called to free any allocated memory.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74559,6 +75603,8 @@ Retrieves several style property values from @props for a given state.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74669,6 +75715,8 @@ will prevail.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74691,11 +75739,13 @@ Since: 3.0
 <description>
 Returns a newly created #GtkStyleProperties
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
 
 </description>
 <parameters>
 </parameters>
 <return> a new #GtkStyleProperties
+
 </return>
 </function>
 
@@ -74730,6 +75780,8 @@ Sets several style properties on @props.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74754,6 +75806,8 @@ Sets a styling property in @props.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74782,6 +75836,8 @@ Sets several style properties on @props.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -74806,6 +75862,8 @@ Unsets a style property in @props.
 
 Since: 3.0
 
+Deprecated: 3.16: #GtkStyleProperties are deprecated.
+
 </description>
 <parameters>
 <parameter name="props">
@@ -82338,6 +83396,24 @@ convert to window coordinates with gtk_text_view_buffer_to_window_coords().
 <return></return>
 </function>
 
+<function name="gtk_text_view_get_monospace">
+<description>
+Gets the value of the #GtkTextView:monospace property.
+
+Return: %TRUE if monospace fonts are desired
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_view_get_overwrite">
 <description>
 Returns whether the #GtkTextView is in overwrite mode or not.
@@ -83072,6 +84148,28 @@ Tags in the buffer may override the default.
 <return></return>
 </function>
 
+<function name="gtk_text_view_set_monospace">
+<description>
+Sets the #GtkTextView:monospace property, which
+indicates that the text view should use monospace
+fonts.
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="text_view">
+<parameter_description> a #GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="monospace">
+<parameter_description> %TRUE to request monospace styling
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_text_view_set_overwrite">
 <description>
 Changes the #GtkTextView overwrite mode.
@@ -98350,6 +99448,8 @@ See gtk_widget_override_color().
 
 Since: 3.0
 
+Deprecated:3.16: Use a custom style provider and style classes instead
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -98400,6 +99500,8 @@ priority.
 
 Since: 3.0
 
+Deprecated:3.16: Use a custom style provider and style classes instead
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -98431,6 +99533,8 @@ so the alpha value in @primary and @secondary will be ignored.
 
 Since: 3.0
 
+Deprecated:3.16: Use a custom style provider and style classes instead
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -98460,6 +99564,8 @@ left untouched. See gtk_widget_override_color().
 
 Since: 3.0
 
+Deprecated:3.16: Use a custom style provider and style classes instead
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -98485,6 +99591,8 @@ or background color.
 
 Since: 3.0
 
+Deprecated:3.16: Use a custom style provider and style classes instead
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -99505,6 +100613,9 @@ defined as @widget-&gt;window coordinates for widgets that are not
 #GTK_NO_WINDOW widgets, and are relative to @widget-&gt;allocation.x,
 @widget-&gt;allocation.y for widgets that are #GTK_NO_WINDOW widgets.
 
+ width or @height may be 0, in this case this function does
+nothing. Negative values for @width and @height are not allowed.
+
 </description>
 <parameters>
 <parameter name="widget">
@@ -102687,6 +103798,25 @@ and must not be modified or freed.
 </return>
 </function>
 
+<function name="gtk_window_get_titlebar">
+<description>
+Returns the custom titlebar that has been set with
+gtk_window_set_titlebar().
+
+Since: 3.16
+
+</description>
+<parameters>
+<parameter name="window">
+<parameter_description> a #GtkWindow
+</parameter_description>
+</parameter>
+</parameters>
+<return> the custom titlebar, or %NULL
+
+</return>
+</function>
+
 <function name="gtk_window_get_transient_for">
 <description>
 Fetches the transient parent for this window. See
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]