gdk3 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32

data/vendor/local/lib/libgtk-3.la

@@ -1,5 +1,5 @@
 # libgtk-3.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2
+# Generated by libtool (GNU libtool) 2.4.6
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -13,18 +13,18 @@ library_names='libgtk-3.dll.a'
 # The name of the static archive.
 old_library=''
 
-# Linker flags that can not go in dependency_libs.
+# Linker flags that cannot go in dependency_libs.
 inherited_linker_flags=' -pthread'
 
 # Libraries that this one depends upon.
-dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgdk-3.la -L/home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib -lshell32 /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangocairo-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangoft2-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libharfbuzz.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangowin32-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpango-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo-gobject.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo.la /home/vagrant/rcairo.win64/vendor/local/lib/libpixman-1.la /home/vagrant/rcairo.win64/vendor/local/lib/libfontconfig.la /home/vagrant/rcairo.win64/vendor/local/lib/libxml2.la /home/vagrant/rcairo.win64/vendor/local/lib/libfreetype.la -lmsimg32 /home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib/libgdk_pixbuf-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libpng16.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib/libatk-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lwinmm -lshlwapi -limm32 -lole32 -lgdi32 -lcomdlg32 -lwinspool -lcomctl32 /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la -lpthread'
+dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgdk-3.la -L/home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib -lshell32 -L/home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangocairo-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangoft2-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libharfbuzz.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangowin32-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpango-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo-gobject.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo.la -lpthread /home/vagrant/rcairo.win64/vendor/local/lib/libpixman-1.la /home/vagrant/rcairo.win64/vendor/local/lib/libfontconfig.la /home/vagrant/rcairo.win64/vendor/local/lib/libxml2.la /home/vagrant/rcairo.win64/vendor/local/lib/libfreetype.la -lmsimg32 /home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib/libgdk_pixbuf-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libpng16.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib/libatk-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libepoxy.la -lopengl32 -limm32 -lole32 -lgdi32 -lcomdlg32 -lwinspool -lcomctl32 /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
 
 # Version information for libgtk-3.
-current=1400
-age=1400
+current=1600
+age=1600
 revision=6
 
 # Is this an already installed library?

data/vendor/local/lib/libgtkreftestprivate.la

@@ -1,23 +1,23 @@
 # libgtkreftestprivate.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2
+# Generated by libtool (GNU libtool) 2.4.6
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
 
 # The name that we can dlopen(3).
-dlname=''
+dlname='../bin/libgtkreftestprivate-0.dll'
 
 # Names of this library.
-library_names=''
+library_names='libgtkreftestprivate.dll.a'
 
 # The name of the static archive.
-old_library='libgtkreftestprivate.a'
+old_library=''
 
-# Linker flags that can not go in dependency_libs.
+# Linker flags that cannot go in dependency_libs.
 inherited_linker_flags=' -pthread'
 
 # Libraries that this one depends upon.
-dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgtk-3.la -L/home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgdk-3.la -lcomdlg32 -lwinspool -lcomctl32 -limm32 -lshell32 /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangocairo-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangoft2-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libharfbuzz.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangowin32-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpango-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo-gobject.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo.la /home/vagrant/rcairo.win64/vendor/local/lib/libpixman-1.la /home/vagrant/rcairo.win64/vendor/local/lib/libfontconfig.la /home/vagrant/rcairo.win64/vendor/local/lib/libxml2.la /home/vagrant/rcairo.win64/vendor/local/lib/libfreetype.la -lgdi32 -lmsimg32 /home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib/libgdk_pixbuf-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libpng16.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib/libatk-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la -lpthread'
+dependency_libs=' -R/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib -L/home/vagrant/rcairo.win64/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib -L/home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgtk-3.la -L/home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libgdk-3.la -lcomdlg32 -lwinspool -lcomctl32 -limm32 -lshell32 /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangocairo-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangoft2-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libharfbuzz.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpangowin32-1.0.la /home/vagrant/ruby-gnome2.win64/pango/vendor/local/lib/libpango-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo-gobject.la /home/vagrant/rcairo.win64/vendor/local/lib/libcairo.la -lpthread /home/vagrant/rcairo.win64/vendor/local/lib/libpixman-1.la /home/vagrant/rcairo.win64/vendor/local/lib/libfontconfig.la /home/vagrant/rcairo.win64/vendor/local/lib/libxml2.la /home/vagrant/rcairo.win64/vendor/local/lib/libfreetype.la -lgdi32 -lmsimg32 /home/vagrant/ruby-gnome2.win64/gdk_pixbuf2/vendor/local/lib/libgdk_pixbuf-2.0.la /home/vagrant/rcairo.win64/vendor/local/lib/libpng16.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgio-2.0.la -ldnsapi -liphlpapi -lz /home/vagrant/ruby-gnome2.win64/atk/vendor/local/lib/libatk-1.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libffi.la /home/vagrant/ruby-gnome2.win64/gdk3/vendor/local/lib/libepoxy.la -lopengl32 /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libgmodule-2.0.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win64/glib2/vendor/local/lib/libiconv.la'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''

data/vendor/local/lib/pkgconfig/epoxy.pc

@@ -0,0 +1,11 @@
+prefix=/home/vagrant/ruby-gnome2.win64/gdk3/vendor/local
+exec_prefix=${prefix}
+libdir=${exec_prefix}/lib
+includedir=${prefix}/include
+
+Name: epoxy
+Description: epoxy GL dispatch Library
+Version: 1.3.1
+Cflags: -I${includedir}
+Libs: -L${libdir} -lepoxy
+Libs.private: 

data/vendor/local/lib/pkgconfig/gail-3.0.pc

@@ -5,7 +5,7 @@ includedir=${prefix}/include
 
 Name: Gail
 Description: GNOME Accessibility Implementation Library
-Version: 3.14.6
+Version: 3.16.6
 Requires: atk gtk+-3.0
 Libs: -L${libdir} -lgailutil-3
 Cflags: -I${includedir}/gail-3.0

data/vendor/local/lib/pkgconfig/gdk-3.0.pc

@@ -6,8 +6,8 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.14.6
-Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.12.0 cairo-gobject >= 1.12.0
-Requires.private: gio-2.0 >= 2.41.2    cairo-win32
+Version: 3.16.6
+Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.14.0 cairo-gobject >= 1.14.0
+Requires.private: gio-2.0 >= 2.43.4     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm
 Cflags: -I${includedir}/gtk-3.0 

data/vendor/local/lib/pkgconfig/gdk-win32-3.0.pc

@@ -6,8 +6,8 @@ targets=win32
 
 Name: GDK
 Description: GTK+ Drawing Kit
-Version: 3.14.6
-Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.12.0 cairo-gobject >= 1.12.0
-Requires.private: gio-2.0 >= 2.41.2    cairo-win32
+Version: 3.16.6
+Requires: pangowin32 pangocairo gdk-pixbuf-2.0 >= 2.30.0 cairo >= 1.14.0 cairo-gobject >= 1.14.0
+Requires.private: gio-2.0 >= 2.43.4     cairo-win32 epoxy >= 1.0
 Libs: -L${libdir} -lgdk-3  -lgdi32 -limm32 -lshell32 -lole32 -Wl,-luuid -lwinmm
 Cflags: -I${includedir}/gtk-3.0 

data/vendor/local/lib/pkgconfig/gtk+-3.0.pc

@@ -9,8 +9,8 @@ gtk_host=x86_64-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.14.6
-Requires: gdk-3.0 atk >= 2.12.0 cairo >= 1.12.0 cairo-gobject >= 1.12.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.41.2
-Requires.private: atk
+Version: 3.16.6
+Requires: gdk-3.0 atk >= 2.15.1 cairo >= 1.14.0 cairo-gobject >= 1.14.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.43.4
+Requires.private: atk   epoxy >= 1.0
 Libs: -L${libdir} -lgtk-3 
 Cflags: -I${includedir}/gtk-3.0 -mms-bitfields

data/vendor/local/lib/pkgconfig/gtk+-win32-3.0.pc

@@ -9,8 +9,8 @@ gtk_host=x86_64-w64-mingw32
 
 Name: GTK+
 Description: GTK+ Graphical UI Library
-Version: 3.14.6
-Requires: gdk-3.0 atk >= 2.12.0 cairo >= 1.12.0 cairo-gobject >= 1.12.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.41.2
-Requires.private: atk
+Version: 3.16.6
+Requires: gdk-3.0 atk >= 2.15.1 cairo >= 1.14.0 cairo-gobject >= 1.14.0 gdk-pixbuf-2.0 >= 2.30.0 gio-2.0 >= 2.43.4
+Requires.private: atk   epoxy >= 1.0
 Libs: -L${libdir} -lgtk-3 
 Cflags: -I${includedir}/gtk-3.0 -mms-bitfields

data/vendor/local/share/gir-1.0/Gdk-3.0.gir

@@ -616,11 +616,15 @@ and “\#ffffffffffff”).</doc>
            glib:type-name="GdkCursor"
            glib:get-type="gdk_cursor_get_type">
       <doc xml:space="preserve">A #GdkCursor represents a cursor. Its contents are private.</doc>
-      <constructor name="new" c:identifier="gdk_cursor_new">
+      <constructor name="new"
+                   c:identifier="gdk_cursor_new"
+                   deprecated="1"
+                   deprecated-version="3.16">
         <doc xml:space="preserve">Creates a new cursor from the set of builtin cursors for the default display.
 See gdk_cursor_new_for_display().
 
 To make the cursor invisible, use %GDK_BLANK_CURSOR.</doc>
+        <doc-deprecated xml:space="preserve">Use gdk_cursor_new_for_display() instead.</doc-deprecated>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a new #GdkCursor</doc>
           <type name="Cursor" c:type="GdkCursor*"/>
@@ -1411,9 +1415,13 @@ relationships.</doc>
         </parameters>
       </function>
       <function name="grab_info_libgtk_only"
-                c:identifier="gdk_device_grab_info_libgtk_only">
+                c:identifier="gdk_device_grab_info_libgtk_only"
+                deprecated="1"
+                deprecated-version="3.16">
         <doc xml:space="preserve">Determines information about the current keyboard grab.
 This is not public API and must not be used by applications.</doc>
+        <doc-deprecated xml:space="preserve">The symbol was never meant to be used outside
+  of GTK+</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if this application currently has the
  keyboard grabbed.</doc>
@@ -1591,7 +1599,8 @@ by gdk_device_list_axes()</doc>
       <method name="get_has_cursor"
               c:identifier="gdk_device_get_has_cursor"
               version="2.20">
-        <doc xml:space="preserve">Determines whether the pointer follows device motion.</doc>
+        <doc xml:space="preserve">Determines whether the pointer follows device motion.
+This is not meaningful for keyboard devices, which don't have a pointer.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the pointer follows device motion</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -1698,7 +1707,7 @@ and fill in @keyval and @modifiers with the keyval settings.</doc>
       <method name="get_last_event_window"
               c:identifier="gdk_device_get_last_event_window"
               version="3.12">
-        <doc xml:space="preserve">Gets information about which window the given pointer device is in, based on
+        <doc xml:space="preserve">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
@@ -1864,6 +1873,23 @@ unless there is an ongoing grab on them. See gdk_device_grab().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_product_id"
+              c:identifier="gdk_device_get_product_id"
+              version="3.16">
+        <doc xml:space="preserve">Returns the product ID of this device, or %NULL if this information couldn't
+be obtained. This ID is retrieved from the device, and is thus constant for
+it. See gdk_device_get_vendor_id() for more information.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the product ID, or %NULL</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="device" transfer-ownership="none">
+            <doc xml:space="preserve">a slave #GdkDevice</doc>
+            <type name="Device" c:type="GdkDevice*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_source"
               c:identifier="gdk_device_get_source"
               version="2.20">
@@ -1919,6 +1945,46 @@ the axes of @device in, or %NULL.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_vendor_id"
+              c:identifier="gdk_device_get_vendor_id"
+              version="3.16">
+        <doc xml:space="preserve">Returns the vendor ID of this device, or %NULL if this information couldn't
+be obtained. This ID is retrieved from the device, and is thus constant for
+it.
+
+This function, together with gdk_device_get_product_id(), can be used to eg.
+compose #GSettings paths to store settings for this device.
+
+|[&lt;!-- language="C" --&gt;
+ static GSettings *
+ get_device_settings (GdkDevice *device)
+ {
+   const gchar *vendor, *product;
+   GSettings *settings;
+   GdkDevice *device;
+   gchar *path;
+
+   vendor = gdk_device_get_vendor_id (device);
+   product = gdk_device_get_product_id (device);
+
+   path = g_strdup_printf ("/org/example/app/devices/%s:%s/", vendor, product);
+   settings = g_settings_new_with_path (DEVICE_SCHEMA, path);
+   g_free (path);
+
+   return settings;
+ }
+]|</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the vendor ID, or %NULL</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="device" transfer-ownership="none">
+            <doc xml:space="preserve">a slave #GdkDevice</doc>
+            <type name="Device" c:type="GdkDevice*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_window_at_position"
               c:identifier="gdk_device_get_window_at_position"
               version="3.0">
@@ -2008,6 +2074,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.
@@ -2291,6 +2359,14 @@ always come in keyboard/pointer pairs. Other device types will have a %NULL asso
         <doc xml:space="preserve">The device name.</doc>
         <type name="utf8" c:type="gchar*"/>
       </property>
+      <property name="product-id"
+                version="3.16"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Product ID of this device, see gdk_device_get_product_id().</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
       <property name="type"
                 version="3.0"
                 writable="1"
@@ -2299,6 +2375,14 @@ always come in keyboard/pointer pairs. Other device types will have a %NULL asso
         <doc xml:space="preserve">Device role in the device manager.</doc>
         <type name="DeviceType"/>
       </property>
+      <property name="vendor-id"
+                version="3.16"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Vendor ID of this device, see gdk_device_get_vendor_id().</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
       <glib:signal name="changed" when="last">
         <doc xml:space="preserve">The ::changed signal is emitted either when the #GdkDevice
 has changed the number of either axes or keys. For example
@@ -2626,12 +2710,16 @@ function for:
         </parameters>
       </function>
       <function name="open_default_libgtk_only"
-                c:identifier="gdk_display_open_default_libgtk_only">
+                c:identifier="gdk_display_open_default_libgtk_only"
+                deprecated="1"
+                deprecated-version="3.16">
         <doc xml:space="preserve">Opens the default display specified by command line arguments or
 environment variables, sets it as the default display, and returns
 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.</doc>
+        <doc-deprecated xml:space="preserve">This symbol was never meant to be used outside
+  of GTK+</doc-deprecated>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the default display, if it
   could be opened, otherwise %NULL.</doc>
@@ -3280,12 +3368,16 @@ running.</doc>
       </method>
       <method name="supports_composite"
               c:identifier="gdk_display_supports_composite"
-              version="2.12">
+              version="2.12"
+              deprecated="1"
+              deprecated-version="3.16">
         <doc xml:space="preserve">Returns %TRUE if gdk_window_set_composited() can be used
 to redirect drawing on the window using compositing.
 
 Currently this only works on X11 with XComposite and
 XDamage extensions available.</doc>
+        <doc-deprecated xml:space="preserve">Compositing is an outdated technology that
+  only ever worked on X11.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if windows may be composited.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -5084,6 +5176,9 @@ can also cause #GdkEventGrabBroken events.</doc>
 Most of these masks map onto one or more of the #GdkEventType event types
 above.
 
+See the [input handling overview][chap-input-handling] for details of
+[event masks][event-masks] and [event propagation][event-propagation].
+
 %GDK_POINTER_MOTION_HINT_MASK is deprecated. It is a special mask
 to reduce the number of %GDK_MOTION_NOTIFY events received. When using
 %GDK_POINTER_MOTION_HINT_MASK, fewer %GDK_MOTION_NOTIFY events will
@@ -6559,6 +6654,384 @@ when in fullscreen mode.</doc>
         <doc xml:space="preserve">Span across all monitors when fullscreen.</doc>
       </member>
     </enumeration>
+    <class name="GLContext"
+           c:symbol-prefix="gl_context"
+           c:type="GdkGLContext"
+           parent="GObject.Object"
+           abstract="1"
+           glib:type-name="GdkGLContext"
+           glib:get-type="gdk_gl_context_get_type">
+      <doc xml:space="preserve">#GdkGLContext is an object representing the platform-specific
+OpenGL drawing context.
+
+#GdkGLContexts are created for a #GdkWindow using
+gdk_window_create_gl_context(), and the context will match
+the #GdkVisual of the window.
+
+A #GdkGLContext is not tied to any particular normal framebuffer.
+For instance, it cannot draw to the #GdkWindow back buffer. The GDK
+repaint system is in full control of the painting to that. Instead,
+you can create render buffers or textures and use gdk_cairo_draw_from_gl()
+in the draw function of your widget to draw them. Then GDK will handle
+the integration of your rendering with that of other widgets.
+
+Support for #GdkGLContext is platform-specific, context creation
+can fail, returning %NULL context.
+
+A #GdkGLContext has to be made "current" in order to start using
+it, otherwise any OpenGL call will be ignored.
+
+## Creating a new OpenGL context ##
+
+In order to create a new #GdkGLContext instance you need a
+#GdkWindow, which you typically get during the realize call
+of a widget.
+
+A #GdkGLContext is not realized until either gdk_gl_context_make_current(),
+or until it is realized using gdk_gl_context_realize(). It is possible to
+specify details of the GL context like the OpenGL version to be used, or
+whether the GL context should have extra state validation enabled after
+calling gdk_window_create_gl_context() by calling gdk_gl_context_realize().
+If the realization fails you have the option to change the settings of the
+#GdkGLContext and try again.
+
+## Using a GdkGLContext ##
+
+You will need to make the #GdkGLContext the current context
+before issuing OpenGL calls; the system sends OpenGL commands to
+whichever context is current. It is possible to have multiple
+contexts, so you always need to ensure that the one which you
+want to draw with is the current one before issuing commands:
+
+|[&lt;!-- language="C" --&gt;
+  gdk_gl_context_make_current (context);
+]|
+
+You can now perform your drawing using OpenGL commands.
+
+You can check which #GdkGLContext is the current one by using
+gdk_gl_context_get_current(); you can also unset any #GdkGLContext
+that is currently set by calling gdk_gl_context_clear_current().</doc>
+      <function name="clear_current"
+                c:identifier="gdk_gl_context_clear_current"
+                version="3.16">
+        <doc xml:space="preserve">Clears the current #GdkGLContext.
+
+Any OpenGL call after this function returns will be ignored
+until gdk_gl_context_make_current() is called.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+      </function>
+      <function name="get_current"
+                c:identifier="gdk_gl_context_get_current"
+                version="3.16">
+        <doc xml:space="preserve">Retrieves the current #GdkGLContext.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the current #GdkGLContext, or %NULL</doc>
+          <type name="GLContext" c:type="GdkGLContext*"/>
+        </return-value>
+      </function>
+      <method name="get_debug_enabled"
+              c:identifier="gdk_gl_context_get_debug_enabled"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the value set using gdk_gl_context_set_debug_enabled().</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if debugging is enabled</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_display"
+              c:identifier="gdk_gl_context_get_display"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the #GdkDisplay the @context is created for</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a #GdkDisplay or %NULL</doc>
+          <type name="Display" c:type="GdkDisplay*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_forward_compatible"
+              c:identifier="gdk_gl_context_get_forward_compatible"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the value set using gdk_gl_context_set_forward_compatible().</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the context should be forward compatible</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_required_version"
+              c:identifier="gdk_gl_context_get_required_version"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the major and minor version requested by calling
+gdk_gl_context_set_required_version().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+          <parameter name="major"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     nullable="1">
+            <doc xml:space="preserve">return location for the major version to request</doc>
+            <type name="gint" c:type="int*"/>
+          </parameter>
+          <parameter name="minor"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     nullable="1">
+            <doc xml:space="preserve">return location for the minor version to request</doc>
+            <type name="gint" c:type="int*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_shared_context"
+              c:identifier="gdk_gl_context_get_shared_context"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the #GdkGLContext that this @context share data with.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a #GdkGLContext or %NULL</doc>
+          <type name="GLContext" c:type="GdkGLContext*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_version"
+              c:identifier="gdk_gl_context_get_version"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the OpenGL version of the @context.
+
+The @context must be realized prior to calling this function.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+          <parameter name="major"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full">
+            <doc xml:space="preserve">return location for the major version</doc>
+            <type name="gint" c:type="int*"/>
+          </parameter>
+          <parameter name="minor"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full">
+            <doc xml:space="preserve">return location for the minor version</doc>
+            <type name="gint" c:type="int*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_window"
+              c:identifier="gdk_gl_context_get_window"
+              version="3.16">
+        <doc xml:space="preserve">Retrieves the #GdkWindow used by the @context.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a #GdkWindow or %NULL</doc>
+          <type name="Window" c:type="GdkWindow*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="make_current"
+              c:identifier="gdk_gl_context_make_current"
+              version="3.16">
+        <doc xml:space="preserve">Makes the @context the current one.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="realize"
+              c:identifier="gdk_gl_context_realize"
+              version="3.16"
+              throws="1">
+        <doc xml:space="preserve">Realizes the given #GdkGLContext.
+
+It is safe to call this function on a realized #GdkGLContext.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the context is realized</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="set_debug_enabled"
+              c:identifier="gdk_gl_context_set_debug_enabled"
+              version="3.16">
+        <doc xml:space="preserve">Sets whether the #GdkGLContext should perform extra validations and
+run time checking. This is useful during development, but has
+additional overhead.
+
+The #GdkGLContext must not be realized or made current prior to
+calling this function.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+          <parameter name="enabled" transfer-ownership="none">
+            <doc xml:space="preserve">whether to enable debugging in the context</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_forward_compatible"
+              c:identifier="gdk_gl_context_set_forward_compatible"
+              version="3.16">
+        <doc xml:space="preserve">Sets whether the #GdkGLContext should be forward compatible.
+
+Forward compatibile contexts must not support OpenGL functionality that
+has been marked as deprecated in the requested version; non-forward
+compatible contexts, on the other hand, must support both deprecated and
+non deprecated functionality.
+
+The #GdkGLContext must not be realized or made current prior to calling
+this function.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+          <parameter name="compatible" transfer-ownership="none">
+            <doc xml:space="preserve">whether the context should be forward compatible</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="set_required_version"
+              c:identifier="gdk_gl_context_set_required_version"
+              version="3.16">
+        <doc xml:space="preserve">Sets the major and minor version of OpenGL to request.
+
+Setting @major and @minor to zero will use the default values.
+
+The #GdkGLContext must not be realized or made current prior to calling
+this function.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="context" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkGLContext</doc>
+            <type name="GLContext" c:type="GdkGLContext*"/>
+          </instance-parameter>
+          <parameter name="major" transfer-ownership="none">
+            <doc xml:space="preserve">the major version to request</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+          <parameter name="minor" transfer-ownership="none">
+            <doc xml:space="preserve">the minor version to request</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+        </parameters>
+      </method>
+      <property name="display"
+                version="3.16"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GdkDisplay used to create the #GdkGLContext.</doc>
+        <type name="Display"/>
+      </property>
+      <property name="shared-context"
+                version="3.16"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GdkGLContext that this context is sharing data with, or #NULL</doc>
+        <type name="GLContext"/>
+      </property>
+      <property name="window"
+                version="3.16"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GdkWindow the gl context is bound to.</doc>
+        <type name="Window"/>
+      </property>
+    </class>
+    <enumeration name="GLError"
+                 version="3.16"
+                 glib:type-name="GdkGLError"
+                 glib:get-type="gdk_gl_error_get_type"
+                 c:type="GdkGLError"
+                 glib:error-domain="gdk-gl-error-quark">
+      <doc xml:space="preserve">Error enumeration for #GdkGLContext.</doc>
+      <member name="not_available"
+              value="0"
+              c:identifier="GDK_GL_ERROR_NOT_AVAILABLE"
+              glib:nick="not-available">
+        <doc xml:space="preserve">OpenGL support is not available</doc>
+      </member>
+      <member name="unsupported_format"
+              value="1"
+              c:identifier="GDK_GL_ERROR_UNSUPPORTED_FORMAT"
+              glib:nick="unsupported-format">
+        <doc xml:space="preserve">The requested visual format is not supported</doc>
+      </member>
+      <member name="unsupported_profile"
+              value="2"
+              c:identifier="GDK_GL_ERROR_UNSUPPORTED_PROFILE"
+              glib:nick="unsupported-profile">
+        <doc xml:space="preserve">The requested profile is not supported</doc>
+      </member>
+      <function name="quark" c:identifier="gdk_gl_error_quark">
+        <return-value transfer-ownership="none">
+          <type name="GLib.Quark" c:type="GQuark"/>
+        </return-value>
+      </function>
+    </enumeration>
     <record name="Geometry" c:type="GdkGeometry">
       <doc xml:space="preserve">The #GdkGeometry struct gives the window manager information about
 a window’s geometry constraints. Normally you would set these on
@@ -6728,6 +7201,12 @@ indicate success or the reason for the failure of the grab attempt.</doc>
               glib:nick="frozen">
         <doc xml:space="preserve">the resource is frozen by an active grab of another client.</doc>
       </member>
+      <member name="failed"
+              value="5"
+              c:identifier="GDK_GRAB_FAILED"
+              glib:nick="failed">
+        <doc xml:space="preserve">the grab failed for some other reason.</doc>
+      </member>
     </enumeration>
     <enumeration name="Gravity"
                  glib:type-name="GdkGravity"
@@ -16409,7 +16888,11 @@ to Mod2 - Mod5, and indicates this by setting %GDK_SUPER_MASK,
 Note that GDK may add internal values to events which include
 reserved values such as %GDK_MODIFIER_RESERVED_13_MASK.  Your code
 should preserve and ignore them.  You can use %GDK_MODIFIER_MASK to
-remove all reserved values.</doc>
+remove all reserved values.
+
+Also note that the GDK X backend interprets button press events for button
+4-7 as scroll events, so %GDK_BUTTON4_MASK and %GDK_BUTTON5_MASK will never
+be set.</doc>
       <member name="shift_mask"
               value="1"
               c:identifier="GDK_SHIFT_MASK"
@@ -18853,6 +19336,30 @@ in parent’s coordinate system, or %NULL</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="create_gl_context"
+              c:identifier="gdk_window_create_gl_context"
+              version="3.16"
+              throws="1">
+        <doc xml:space="preserve">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.
+
+Before using the returned #GdkGLContext, you will need to
+call gdk_gl_context_make_current() or gdk_gl_context_realize().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">the newly created #GdkGLContext, or
+%NULL on error</doc>
+          <type name="GLContext" c:type="GdkGLContext*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkWindow</doc>
+            <type name="Window" c:type="GdkWindow*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="create_similar_image_surface"
               c:identifier="gdk_window_create_similar_image_surface"
               version="3.10">
@@ -19000,12 +19507,13 @@ reaches zero. You must call this function yourself before that happens.</doc>
         </parameters>
       </method>
       <method name="end_paint" c:identifier="gdk_window_end_paint">
-        <doc xml:space="preserve">Indicates that the backing store created by the most recent call to
-gdk_window_begin_paint_region() should be copied onscreen and
+        <doc xml:space="preserve">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() for full details.
+
+It is an error to call this function without a matching
 gdk_window_begin_paint_region() first.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -19071,7 +19579,9 @@ should be used on a #GtkWindow, rather than calling this function.</doc>
         </parameters>
       </method>
       <method name="freeze_toplevel_updates_libgtk_only"
-              c:identifier="gdk_window_freeze_toplevel_updates_libgtk_only">
+              c:identifier="gdk_window_freeze_toplevel_updates_libgtk_only"
+              deprecated="1"
+              deprecated-version="3.16">
         <doc xml:space="preserve">Temporarily freezes a window and all its descendants such that it won't
 receive expose events.  The window will begin receiving expose events
 again when gdk_window_thaw_toplevel_updates_libgtk_only() is called. If
@@ -19082,6 +19592,7 @@ 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+.</doc>
+        <doc-deprecated xml:space="preserve">This symbol was never meant to be used outside of GTK+</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -19255,10 +19766,14 @@ primitives.</doc>
       </method>
       <method name="get_composited"
               c:identifier="gdk_window_get_composited"
-              version="2.22">
+              version="2.22"
+              deprecated="1"
+              deprecated-version="3.16">
         <doc xml:space="preserve">Determines whether @window is composited.
 
 See gdk_window_set_composited().</doc>
+        <doc-deprecated xml:space="preserve">Compositing is an outdated technology that
+  only ever worked on X11.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE if the window is composited.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -19905,7 +20420,7 @@ The position coordinates are relative to the window’s parent window.</doc>
               version="2.18">
         <doc xml:space="preserve">Obtains the position of a window position in root
 window coordinates. This is similar to
-gdk_window_get_origin() but allows you go pass
+gdk_window_get_origin() but allows you to pass
 in any position in the window, not just the origin.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -20489,6 +21004,31 @@ function before gdk_window_show(). (Try gdk_window_show_unraised().)</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="mark_paint_from_clip"
+              c:identifier="gdk_window_mark_paint_from_clip"
+              version="3.16">
+        <doc xml:space="preserve">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.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="window" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkWindow</doc>
+            <type name="Window" c:type="GdkWindow*"/>
+          </instance-parameter>
+          <parameter name="cr" transfer-ownership="none">
+            <doc xml:space="preserve">a #cairo_t</doc>
+            <type name="cairo.Context" c:type="cairo_t*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="maximize" c:identifier="gdk_window_maximize">
         <doc xml:space="preserve">Maximizes the window. If the window was already maximized, then
 this function does nothing.
@@ -20872,10 +21412,12 @@ hint. ICCCM-compliant window manager usually respect it.</doc>
               c:identifier="gdk_window_set_background"
               deprecated="1"
               deprecated-version="3.4">
-        <doc xml:space="preserve">Sets the background color of @window. (However, when using GTK+,
-set the background of a widget with gtk_widget_modify_bg() - if
-you’re an application - or gtk_style_set_background() - if you're
-implementing a custom widget.)
+        <doc xml:space="preserve">Sets the background color of @window.
+
+However, when using GTK+, influence the background of a widget
+using a style class or CSS — if you’re an application — or with
+gtk_style_context_set_background() — if you're implementing a
+custom widget.
 
 See also gdk_window_set_background_pattern().</doc>
         <doc-deprecated xml:space="preserve">Use gdk_window_set_background_rgba() instead.</doc-deprecated>
@@ -20973,7 +21515,9 @@ the shape mask of @window in the masks to be merged.</doc>
       </method>
       <method name="set_composited"
               c:identifier="gdk_window_set_composited"
-              version="2.12">
+              version="2.12"
+              deprecated="1"
+              deprecated-version="3.16">
         <doc xml:space="preserve">Sets a #GdkWindow as composited, or unsets it. Composited
 windows do not automatically have their contents drawn to
 the screen. Drawing is redirected to an offscreen buffer
@@ -20996,6 +21540,8 @@ only X11 with new enough Xcomposite and Xdamage extensions).
 You must call gdk_display_supports_composite() to check if
 setting a window as composited is supported before
 attempting to do so.</doc>
+        <doc-deprecated xml:space="preserve">Compositing is an outdated technology that
+  only ever worked on X11.</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21011,11 +21557,15 @@ attempting to do so.</doc>
         </parameters>
       </method>
       <method name="set_cursor" c:identifier="gdk_window_set_cursor">
-        <doc xml:space="preserve">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.</doc>
+        <doc xml:space="preserve">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.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21096,7 +21646,9 @@ use this default.</doc>
 attached to any visible pointer) to @window. For example, an event mask
 including #GDK_BUTTON_PRESS_MASK means the window should report button
 press events. The event mask is the bitwise OR of values from the
-#GdkEventMask enumeration.</doc>
+#GdkEventMask enumeration.
+
+See the [input handling overview][event-masks] for details.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21145,7 +21697,9 @@ By default, event compression is enabled.</doc>
 for that window from all master input devices. For example, an event mask
 including #GDK_BUTTON_PRESS_MASK means the window should report button
 press events. The event mask is the bitwise OR of values from the
-#GdkEventMask enumeration.</doc>
+#GdkEventMask enumeration.
+
+See the [input handling overview][event-masks] for details.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -21480,7 +22034,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.
 
@@ -21505,7 +22064,7 @@ Support for non-toplevel windows was added in 3.8.</doc>
       <method name="set_opaque_region"
               c:identifier="gdk_window_set_opaque_region"
               version="3.10">
-        <doc xml:space="preserve">For optimizization purposes, compositing window managers may
+        <doc xml:space="preserve">For optimisation purposes, compositing window managers may
 like to not draw obscured regions of windows, or turn off blending
 during for these regions. With RGB windows with no transparency,
 this is just the shape of the window, but with ARGB32 windows, the
@@ -21514,7 +22073,7 @@ or not.
 
 This function only works for toplevel windows.
 
-GTK+ will automatically update this property automatically if
+GTK+ will update this property automatically if
 the @window background is opaque, as we know where the opaque regions
 are. If your window background is not opaque, please update this
 property in your #GtkWidget::style-updated handler.</doc>
@@ -21526,8 +22085,11 @@ property in your #GtkWidget::style-updated handler.</doc>
             <doc xml:space="preserve">a top-level or non-native #GdkWindow</doc>
             <type name="Window" c:type="GdkWindow*"/>
           </instance-parameter>
-          <parameter name="region" transfer-ownership="none">
-            <doc xml:space="preserve">a region</doc>
+          <parameter name="region"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a region, or %NULL</doc>
             <type name="cairo.Region" c:type="cairo_region_t*"/>
           </parameter>
         </parameters>
@@ -21714,13 +22276,17 @@ instead of this low-level function.</doc>
         </parameters>
       </method>
       <method name="set_static_gravities"
-              c:identifier="gdk_window_set_static_gravities">
-        <doc xml:space="preserve">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.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">%TRUE if the server supports static gravity</doc>
+              c:identifier="gdk_window_set_static_gravities"
+              deprecated="1"
+              deprecated-version="3.16">
+        <doc xml:space="preserve">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.</doc>
+        <doc-deprecated xml:space="preserve">static gravities haven't worked on anything but X11
+  for a long time.</doc-deprecated>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%FALSE</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
@@ -21986,12 +22552,15 @@ there’s nothing you can do to force it to happen.</doc>
         </parameters>
       </method>
       <method name="thaw_toplevel_updates_libgtk_only"
-              c:identifier="gdk_window_thaw_toplevel_updates_libgtk_only">
+              c:identifier="gdk_window_thaw_toplevel_updates_libgtk_only"
+              deprecated="1"
+              deprecated-version="3.16">
         <doc xml:space="preserve">Thaws a window frozen with
 gdk_window_freeze_toplevel_updates_libgtk_only().
 
 This function is not part of the GDK public API and is only
 for use by GTK+.</doc>
+        <doc-deprecated xml:space="preserve">This symbol was never meant to be used outside of GTK+</doc-deprecated>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -22872,9 +23441,13 @@ windows in order to trap or filter the events. You can’t draw on
       </member>
     </enumeration>
     <function name="add_option_entries_libgtk_only"
-              c:identifier="gdk_add_option_entries_libgtk_only">
+              c:identifier="gdk_add_option_entries_libgtk_only"
+              deprecated="1"
+              deprecated-version="3.16">
       <doc xml:space="preserve">Appends gdk option entries to the passed in option group. This is
 not public API and must not be used by applications.</doc>
+      <doc-deprecated xml:space="preserve">This symbol was never meant to be used outside
+  of GTK+</doc-deprecated>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -22944,7 +23517,7 @@ GTK+ theme engines).</doc>
       <doc xml:space="preserve">Creates a Cairo context for drawing to @window.
 
 Note that calling cairo_reset_clip() on the resulting #cairo_t will
-rproduce undefined results, so avoid it at all costs.</doc>
+produce undefined results, so avoid it at all costs.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">A newly created Cairo context. Free with
  cairo_destroy() when you are done drawing.</doc>
@@ -22957,6 +23530,67 @@ rproduce undefined results, so avoid it at all costs.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="cairo_draw_from_gl"
+              c:identifier="gdk_cairo_draw_from_gl"
+              version="3.16">
+      <doc xml:space="preserve">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.</doc>
+      <return-value transfer-ownership="none">
+        <type name="none" c:type="void"/>
+      </return-value>
+      <parameters>
+        <parameter name="cr" transfer-ownership="none">
+          <doc xml:space="preserve">a cairo context</doc>
+          <type name="cairo.Context" c:type="cairo_t*"/>
+        </parameter>
+        <parameter name="window" transfer-ownership="none">
+          <doc xml:space="preserve">The window we're rendering for (not necessarily into)</doc>
+          <type name="Window" c:type="GdkWindow*"/>
+        </parameter>
+        <parameter name="source" transfer-ownership="none">
+          <doc xml:space="preserve">The GL ID of the source buffer</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="source_type" transfer-ownership="none">
+          <doc xml:space="preserve">The type of the @source</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="buffer_scale" transfer-ownership="none">
+          <doc xml:space="preserve">The scale-factor that the @source buffer is allocated for</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="x" transfer-ownership="none">
+          <doc xml:space="preserve">The source x position in @source to start copying from in GL coordinates</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="y" transfer-ownership="none">
+          <doc xml:space="preserve">The source y position in @source to start copying from in GL coordinates</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="width" transfer-ownership="none">
+          <doc xml:space="preserve">The width of the region to draw</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+        <parameter name="height" transfer-ownership="none">
+          <doc xml:space="preserve">The height of the region to draw</doc>
+          <type name="gint" c:type="int"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="cairo_get_clip_rectangle"
               c:identifier="gdk_cairo_get_clip_rectangle">
       <doc xml:space="preserve">This is a convenience function around cairo_clip_extents().
@@ -23800,6 +24434,13 @@ with g_get_prgname()) with the first character converted to uppercase.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </return-value>
     </function>
+    <function name="gl_error_quark"
+              c:identifier="gdk_gl_error_quark"
+              moved-to="GLError.quark">
+      <return-value transfer-ownership="none">
+        <type name="GLib.Quark" c:type="GQuark"/>
+      </return-value>
+    </function>
     <function name="init" c:identifier="gdk_init">
       <doc xml:space="preserve">Initializes the GDK library and connects to the windowing system.
 If initialization fails, a warning message is output and the application
@@ -24531,7 +25172,13 @@ application.</doc>
       </parameters>
     </function>
     <function name="pre_parse_libgtk_only"
-              c:identifier="gdk_pre_parse_libgtk_only">
+              c:identifier="gdk_pre_parse_libgtk_only"
+              deprecated="1"
+              deprecated-version="3.16">
+      <doc xml:space="preserve">Prepare for parsing command line arguments for GDK. This is not
+public API and should not be used in application code.</doc>
+      <doc-deprecated xml:space="preserve">This symbol was never meant to be used outside
+  of GTK+</doc-deprecated>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -25127,7 +25774,10 @@ global user-configured setting.</doc>
     <function name="set_program_class" c:identifier="gdk_set_program_class">
       <doc xml:space="preserve">Sets the program class. The X11 backend uses the program class to set
 the class name part of the `WM_CLASS` property on
-toplevel windows; see the ICCCM.</doc>
+toplevel windows; see the ICCCM.
+
+The program class can still be overridden with the --class command
+line option.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>