gtkwindow: Change present documentation

The way present is used doesn't line up with the ideal use case, and in most instances a developer won't actually have a timestamp to pass. `present()` is what should be used for cases when you don't have a timestamp, but the current docs have caused a lot of confusion. Instead of saying `present()` shouldn't be used, say when it should be used since there are still valid uses.
Update Croatian language
2021-10-21 16:28:53 -07:00 · 2021-10-21 13:05:28 +02:00 · 2021-10-21 00:00:29 +00:00 · 2021-10-20 22:55:42 +00:00 · 2021-10-21 00:16:20 +02:00 · 2021-10-21 00:16:20 +02:00
554 changed files with 41641 additions and 35721 deletions
@@ -25,7 +25,7 @@ variables:
  BACKEND_FLAGS: "-Dx11-backend=true -Dwayland-backend=true -Dbroadway-backend=true"
  FEATURE_FLAGS: "-Dvulkan=enabled -Dcloudproviders=enabled"
  MESON_TEST_TIMEOUT_MULTIPLIER: 3
-  FEDORA_IMAGE: "registry.gitlab.gnome.org/gnome/gtk/fedora:v33"
+  FEDORA_IMAGE: "registry.gitlab.gnome.org/gnome/gtk/fedora:v35"
  FLATPAK_IMAGE: "registry.gitlab.gnome.org/gnome/gnome-runtime-images/gnome:master"

 .only-default:
@@ -91,6 +91,7 @@ fedora-x86_64:
    - meson compile -C _build_hello
    - .gitlab-ci/run-tests.sh _build x11
    - .gitlab-ci/run-tests.sh _build wayland
+    - .gitlab-ci/run-tests.sh _build waylandgles
    - .gitlab-ci/run-tests.sh _build broadway

 release-build:
@@ -157,6 +158,7 @@ msys2-mingw64:
    CHERE_INVOKING: "yes"

 macos:
+  allow_failure: true
  extends: .only-default
  only:
    - branches@GNOME/gtk
@@ -53,6 +53,7 @@ RUN dnf -y install \
    libpng-devel \
    librsvg2 \
    libselinux-devel \
+    libtiff-devel \
    libubsan \
    libXcomposite-devel \
    libXcursor-devel \
@@ -75,6 +76,7 @@ RUN dnf -y install \
    pcre-devel \
    pcre-static \
    python3 \
+    python3-docutils \
    python3-gobject \
    python3-jinja2 \
    python3-markdown \
@@ -44,6 +44,24 @@ case "${backend}" in
    kill ${compositor}
    ;;

+  waylandgles)
+    export XDG_RUNTIME_DIR="$(mktemp -p $(pwd) -d xdg-runtime-XXXXXX)"
+
+    weston --backend=headless-backend.so --socket=wayland-6 --idle-time=0 &
+    compositor=$!
+    export WAYLAND_DISPLAY=wayland-6
+
+    meson test -C ${builddir} \
+                --timeout-multiplier "${MESON_TEST_TIMEOUT_MULTIPLIER}" \
+                --print-errorlogs \
+                --setup=${backend} \
+                --suite=gtk \
+                --no-suite=gsk-compare-broadway
+
+    exit_code=$?
+    kill ${compositor}
+    ;;
+
  broadway)
    export XDG_RUNTIME_DIR="$(mktemp -p $(pwd) -d xdg-runtime-XXXXXX)"

@@ -62,6 +80,12 @@ case "${backend}" in
    exit_code=0
    kill ${server}
    ;;
+
+  *)
+    echo "Failed to add ${backend} to .gitlab-ci/run-tests.sh"
+    exit 1
+    ;;
+
 esac

 cd ${builddir}
@@ -10,10 +10,12 @@ GTK is a multi-platform toolkit for creating graphical user interfaces.
 Offering a complete set of widgets, GTK is suitable for projects ranging
 from small one-off projects to complete application suites.

-GTK is free software and part of the GNU Project. However, the
-licensing terms for GTK, the GNU LGPL, allow it to be used by all
-developers, including those developing proprietary software, without any
-license fees or royalties.
+GTK is a free and open-source software project. The licensing terms
+for GTK, the GNU LGPL, allow it to be used by all developers, including those
+developing proprietary software, without any license fees or royalties.
+
+GTK is hosted by the GNOME project (thanks!) and used by a wide variety
+of applications and projects.

 The official download location

@@ -151,6 +153,9 @@ Contributing to GTK
 Please, follow the [contribution guide](./CONTRIBUTING.md) to know how to
 start contributing to GTK.

+If you want to support GTK financially, please consider donating to
+the GNOME project, which runs the infrastructure hosting GTK.
+
 Release notes
 -------------

@@ -1,286 +0,0 @@
-/* always defined to indicate that i18n is enabled */
-#define ENABLE_NLS 1
-
-/* Use structured logging */
-#define G_LOG_STRUCTURED 1
-
-/* The prefix for our gettext translation domains. */
-#mesondefine GETTEXT_PACKAGE
-
-/* Disable deprecation warnings from glib */
-#mesondefine GLIB_DISABLE_DEPRECATION_WARNINGS
-
-/* Define the location where the catalogs will be installed */
-#mesondefine GTK_LOCALEDIR
-
-/* Define to 1 if you have the `bind_textdomain_codeset' function. */
-#mesondefine HAVE_BIND_TEXTDOMAIN_CODESET
-
-/* Have the cloudproviders library */
-#mesondefine HAVE_CLOUDPROVIDERS
-
-/* define if we have colord */
-#mesondefine HAVE_COLORD
-
-/* Define to 1 if you have the <crt_externs.h> header file. */
-#mesondefine HAVE_CRT_EXTERNS_H
-
-/* Define to 1 if you have the `dcgettext' function. */
-#mesondefine HAVE_DCGETTEXT
-
-/* Define to 1 if you have the <dlfcn.h> header file. */
-#mesondefine HAVE_DLFCN_H
-
-/* Have the ffmpeg library */
-#mesondefine HAVE_FFMPEG
-
-/* Define to 1 if you have the <ftw.h> header file. */
-#mesondefine HAVE_FTW_H
-
-/* Define to 1 if you have the `getpagesize' function. */
-#mesondefine HAVE_GETPAGESIZE
-
-/* Define to 1 if you have the `getresuid' function. */
-#mesondefine HAVE_GETRESUID
-
-/* Define if gio-unix is available */
-#mesondefine HAVE_GIO_UNIX
-
-/* Define if GStreamer support is available */
-#mesondefine HAVE_GSTREAMER
-
-/* Define to 1 if you have the <inttypes.h> header file. */
-#mesondefine HAVE_INTTYPES_H
-
-/* Define to 1 if the system has the type `IPrintDialogCallback'. */
-#mesondefine HAVE_IPRINTDIALOGCALLBACK
-
-/* Define to 1 if you have the <locale.h> header file. */
-#mesondefine HAVE_LOCALE_H
-
-/* Define to 1 if you have the `lstat' function. */
-#mesondefine HAVE_LSTAT
-
-/* Define to 1 if you have the `mallinfo' function. */
-#mesondefine HAVE_MALLINFO
-
-/* Define to 1 if you have the <memory.h> header file. */
-#mesondefine HAVE_MEMORY_H
-
-/* Define to 1 if you have the `mkstemp' function. */
-#mesondefine HAVE_MKSTEMP
-
-/* Define to 1 if you have the `mlock` function. */
-#mesondefine HAVE_MLOCK
-
-/* Define to 1 if you have a working `mmap' system call. */
-#mesondefine HAVE_MMAP
-
-/* Define to 1 if you have a working `madvise' system call. */
-#mesondefine HAVE_MADVISE
-
-/* Define to 1 if you have the `posix_fallocate' function. */
-#mesondefine HAVE_POSIX_FALLOCATE
-
-/* Have the Xrandr extension library */
-#mesondefine HAVE_RANDR
-
-/* Have the Xrandr 1.5 extension library */
-#mesondefine HAVE_RANDR15
-
-/* Define to 1 if you have the `sincos' function. */
-#mesondefine HAVE_SINCOS
-
-/* Define to 1 if you have the <stdint.h> header file. */
-#mesondefine HAVE_STDINT_H
-
-/* Define to 1 if you have the <stdlib.h> header file. */
-#mesondefine HAVE_STDLIB_H
-
-/* Define to 1 if you have the <strings.h> header file. */
-#mesondefine HAVE_STRINGS_H
-
-/* Define to 1 if you have the <string.h> header file. */
-#mesondefine HAVE_STRING_H
-
-/* Define to 1 if you have the <sys/mman.h> header file. */
-#mesondefine HAVE_SYS_MMAN_H
-
-/* Define to 1 if you have the <sys/param.h> header file. */
-#mesondefine HAVE_SYS_PARAM_H
-
-/* Have the sysprof-capture library */
-#mesondefine HAVE_SYSPROF
-
-/* Define to 1 if you have the <sys/stat.h> header file. */
-#mesondefine HAVE_SYS_STAT_H
-
-/* Define to 1 if you have the <sys/time.h> header file. */
-#mesondefine HAVE_SYS_TIME_H
-
-/* Define to 1 if you have the <sys/types.h> header file. */
-#mesondefine HAVE_SYS_TYPES_H
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#mesondefine HAVE_UNISTD_H
-
-/* Have the Xcursor library */
-#mesondefine HAVE_XCURSOR
-
-/* Have the XDAMAGE X extension */
-#mesondefine HAVE_XDAMAGE
-
-/* Have the XFIXES X extension */
-#mesondefine HAVE_XFIXES
-
-/* Define to 1 if XFree Xinerama is available */
-#mesondefine HAVE_XFREE_XINERAMA
-
-/* Have XGenericEvent */
-#mesondefine HAVE_XGENERICEVENTS
-
-/* Define to use XKB extension */
-#mesondefine HAVE_XKB
-
-/* Have the SYNC extension library */
-#mesondefine HAVE_XSYNC
-
-/* Define to 1 if you have the `_lock_file' function */
-#mesondefine HAVE__LOCK_FILE
-
-/* Define to 1 if you have the `flockfile' function */
-#mesondefine HAVE_FLOCKFILE
-
-/* Define if _NL_MEASUREMENT_MEASUREMENT is available */
-#mesondefine HAVE__NL_MEASUREMENT_MEASUREMENT
-
-/* Define if _NL_PAPER_HEIGHT is available */
-#mesondefine HAVE__NL_PAPER_HEIGHT
-
-/* Define if _NL_PAPER_WIDTH is available */
-#mesondefine HAVE__NL_PAPER_WIDTH
-
-/* Define if _NL_TIME_FIRST_WEEKDAY is available */
-#mesondefine HAVE__NL_TIME_FIRST_WEEKDAY
-
-/* Define to the sub-directory where libtool stores uninstalled libraries. */
-#mesondefine LT_OBJDIR
-
-/* Define to 1 if your C compiler doesn't accept -c and -o together. */
-#mesondefine NO_MINUS_C_MINUS_O
-
-/* Define to the address where bug reports for this package should be sent. */
-#mesondefine PACKAGE_BUGREPORT
-
-/* Define to the full name of this package. */
-#mesondefine PACKAGE_NAME
-
-/* Define to the full name and version of this package. */
-#mesondefine PACKAGE_STRING
-
-/* Define to the one symbol short name of this package. */
-#mesondefine PACKAGE_TARNAME
-
-/* Define to the home page for this package. */
-#mesondefine PACKAGE_URL
-
-/* Define to the version of this package. */
-#mesondefine PACKAGE_VERSION
-
-/* Use NSBundle functions to determine load paths for libraries, translations,
-   etc. */
-#mesondefine QUARTZ_RELOCATION
-
-/* Define to 1 if you have the ANSI C header files. */
-#mesondefine STDC_HEADERS
-
-/* Enable extensions on AIX 3, Interix.  */
-#ifndef _ALL_SOURCE
-# undef _ALL_SOURCE
-#endif
-/* Enable GNU extensions on systems that have them.  */
-#ifndef _GNU_SOURCE
-# undef _GNU_SOURCE
-#endif
-/* Enable threading extensions on Solaris.  */
-#ifndef _POSIX_PTHREAD_SEMANTICS
-# undef _POSIX_PTHREAD_SEMANTICS
-#endif
-/* Enable extensions on HP NonStop.  */
-#ifndef _TANDEM_SOURCE
-# undef _TANDEM_SOURCE
-#endif
-/* Enable general extensions on Solaris.  */
-#ifndef __EXTENSIONS__
-# undef __EXTENSIONS__
-#endif
-
-
-/* Define to 1 if XInput 2.2 is available */
-#mesondefine XINPUT_2_2
-
-/* Define to 1 if the X Window System is missing or not being used. */
-#mesondefine X_DISPLAY_MISSING
-
-/* Enable large inode numbers on Mac OS X 10.5.  */
-#ifndef _DARWIN_USE_64_BIT_INODE
-# define _DARWIN_USE_64_BIT_INODE 1
-#endif
-
-/* Number of bits in a file offset, on hosts where this is settable. */
-#mesondefine _FILE_OFFSET_BITS
-
-/* defines how to decorate public symbols while building */
-#mesondefine _GDK_EXTERN
-
-/* Define for large files, on AIX-style hosts. */
-#mesondefine _LARGE_FILES
-
-/* Define to 1 if on MINIX. */
-#mesondefine _MINIX
-
-/* Define to 2 if the system does not provide POSIX.1 features except with
-   this defined. */
-#mesondefine _POSIX_1_SOURCE
-
-/* Define to 1 if you need to in order for `stat' and other things to work. */
-#mesondefine _POSIX_SOURCE
-
-/* Define to `int' if <sys/types.h> doesn't define. */
-#mesondefine gid_t
-
-/* Define to `int' if <sys/types.h> doesn't define. */
-#mesondefine uid_t
-
-/* Define to 1 if linux/memfd.h exists */
-#mesondefine HAVE_LINUX_MEMFD_H
-
-#mesondefine HAVE_LINUX_INPUT_H
-
-#mesondefine HAVE_DEV_EVDEV_INPUT_H
-
-#mesondefine GTK_SYSCONFDIR
-
-#mesondefine GTK_LOCALEDIR
-
-#mesondefine GTK_DATADIR
-
-#mesondefine GTK_LIBDIR
-
-#mesondefine GTK_PRINT_BACKENDS
-
-#mesondefine HAVE_CAIRO_SCRIPT_INTERPRETER
-
-#mesondefine HAVE_HARFBUZZ
-
-#mesondefine HAVE_PANGOFT
-
-#mesondefine ISO_CODES_PREFIX
-
-/* Define if tracker3 is available */
-#mesondefine HAVE_TRACKER3
-
-#mesondefine HAVE_F16C
-
-/* Does the OS support GDesktopAppInfo? */
-#mesondefine HAVE_DESKTOPAPPINFO
@@ -37,7 +37,7 @@ update_image (void)
  const char *text;
  PangoFontDescription *desc;
  PangoLayout *layout;
-  PangoRectangle ink, pink, logical;
+  PangoRectangle ink, logical;
  int baseline;
  cairo_surface_t *surface;
  cairo_t *cr;
@@ -59,16 +59,18 @@ update_image (void)
  fopt = cairo_font_options_copy (pango_cairo_context_get_font_options (context));

  hint = gtk_combo_box_get_active_id (GTK_COMBO_BOX (hinting));
-  if (strcmp (hint, "none") == 0)
-    hintstyle = CAIRO_HINT_STYLE_NONE;
-  else if (strcmp (hint, "slight") == 0)
-    hintstyle = CAIRO_HINT_STYLE_SLIGHT;
-  else if (strcmp (hint, "medium") == 0)
-    hintstyle = CAIRO_HINT_STYLE_MEDIUM;
-  else if (strcmp (hint, "full") == 0)
-    hintstyle = CAIRO_HINT_STYLE_FULL;
-  else
-    hintstyle = CAIRO_HINT_STYLE_DEFAULT;
+  hintstyle = CAIRO_HINT_STYLE_DEFAULT;
+  if (hint)
+    {
+      if (strcmp (hint, "none") == 0)
+        hintstyle = CAIRO_HINT_STYLE_NONE;
+      else if (strcmp (hint, "slight") == 0)
+        hintstyle = CAIRO_HINT_STYLE_SLIGHT;
+      else if (strcmp (hint, "medium") == 0)
+        hintstyle = CAIRO_HINT_STYLE_MEDIUM;
+      else if (strcmp (hint, "full") == 0)
+        hintstyle = CAIRO_HINT_STYLE_FULL;
+    }
  cairo_font_options_set_hint_style (fopt, hintstyle);

  if (gtk_check_button_get_active (GTK_CHECK_BUTTON (hint_metrics)))
@@ -94,7 +96,6 @@ update_image (void)
      pango_layout_set_font_description (layout, desc);
      pango_layout_set_text (layout, text, -1);
      pango_layout_get_extents (layout, &ink, &logical);
-      pink = ink;
      baseline = pango_layout_get_baseline (layout);

      pango_extents_to_pixels (&ink, NULL);
@@ -165,10 +166,10 @@ update_image (void)
          cairo_stroke (cr);
          cairo_set_source_rgb (cr, 1, 0, 0);
          cairo_rectangle (cr,
-                           scale * (10 + pango_units_to_double (pink.x)) + 0.5,
-                           scale * (10 + pango_units_to_double (pink.y)) + 0.5,
-                           scale * pango_units_to_double (pink.width) - 1,
-                           scale * pango_units_to_double (pink.height) - 1);
+                           scale * (10 + ink.x) - 0.5,
+                           scale * (10 + ink.y) - 0.5,
+                           scale * ink.width + 1,
+                           scale * ink.height + 1);
          cairo_stroke (cr);
        }

@@ -193,7 +194,7 @@ update_image (void)
            }
        }

-      cairo_set_source_rgba (cr, 0, 0, 1, outline_alpha);
+      cairo_set_source_rgba (cr, 0, 0, 0, outline_alpha);
      cairo_move_to (cr, scale * 20 - 0.5, scale * 20 - 0.5);
      cairo_append_path (cr, path);
      cairo_stroke (cr);
@@ -177,6 +177,8 @@
            <child>
              <object class="GtkButton" id="up_button">
                <property name="icon-name">list-add-symbolic</property>
+                <property name="halign">center</property>
+                <property name="valign">center</property>
                <style>
                  <class name="circular"/>
                </style>
@@ -200,6 +202,8 @@
            <child>
              <object class="GtkButton" id="down_button">
                <property name="icon-name">list-remove-symbolic</property>
+                <property name="halign">center</property>
+                <property name="valign">center</property>
                <style>
                  <class name="circular"/>
                </style>
@@ -8,7 +8,7 @@
 #include <stdlib.h>
 #include <string.h>

-static GdkPixbuf *avatar_pixbuf_other;
+static GdkTexture *avatar_texture_other;
 static GtkWidget *window = NULL;

 #define GTK_TYPE_MESSAGE		  (gtk_message_get_type ())
@@ -196,12 +196,9 @@ gtk_message_row_update (GtkMessageRow *row)
    gtk_button_set_label (GTK_BUTTON (priv->resent_by_button), priv->message->resent_by);

  if (strcmp (priv->message->sender_nick, "@GTKtoolkit") == 0)
-    {
-      gtk_image_set_from_icon_name (priv->avatar_image, "org.gtk.Demo4");
-      gtk_image_set_icon_size (priv->avatar_image, GTK_ICON_SIZE_LARGE);
-    }
+    gtk_image_set_from_icon_name (priv->avatar_image, "org.gtk.Demo4");
  else
-    gtk_image_set_from_pixbuf (priv->avatar_image, avatar_pixbuf_other);
+    gtk_image_set_from_paintable (priv->avatar_image, GDK_PAINTABLE (avatar_texture_other));

 }

@@ -344,7 +341,7 @@ do_listbox (GtkWidget *do_widget)

  if (!window)
    {
-      avatar_pixbuf_other = gdk_pixbuf_new_from_resource_at_scale ("/listbox/apple-red.png", 32, 32, FALSE, NULL);
+      avatar_texture_other = gdk_texture_new_from_resource ("/listbox/apple-red.png");

      window = gtk_window_new ();
      gtk_window_set_display (GTK_WINDOW (window),
@@ -25,6 +25,7 @@
            <property name="margin-start">8</property>
            <property name="margin-end">8</property>
            <property name="icon-name">image-missing</property>
+            <property name="icon-size">large</property>
            <layout>
              <property name="column">0</property>
              <property name="row">0</property>
@@ -156,10 +156,74 @@ demos_h = custom_target('gtk4 demo header',
  command: [ find_program('geninclude.py'), '@OUTPUT@', '@INPUT@' ],
 )

-gtkdemo_resources = gnome.compile_resources('gtkdemo_resources',
-  'demo.gresource.xml',
-  source_dir: '.',
-)
+objcopy_supports_add_symbol = false
+objcopy = find_program('objcopy', required : false)
+if objcopy.found()
+  objcopy_supports_add_symbol = run_command(objcopy, '--help').stdout().contains('--add-symbol')
+endif
+
+ld = find_program('ld', required : false)
+
+if build_machine.system() == 'linux' and objcopy.found() and objcopy_supports_add_symbol and ld.found()
+  glib_compile_resources = find_program('glib-compile-resources')
+
+  # Create the resource blob
+  gtkdemo_gresource = custom_target('gtkdemo.gresource',
+      input : 'demo.gresource.xml',
+      output : 'gtkdemo.gresource',
+      depfile : 'gtkdemo.gresource.d',
+      command : [glib_compile_resources,
+                 '--generate',
+                 '--target=@OUTPUT@',
+                 '--dependency-file=@DEPFILE@',
+                 '--sourcedir=' + meson.current_source_dir(),
+                 '--sourcedir=' + meson.current_build_dir(),
+                 '@INPUT@'])
+
+  # Create resource data file
+  gtkdemo_resources_c = custom_target('gtkdemo_resources.c',
+      input : 'demo.gresource.xml',
+      output : 'gtkdemo_resources.c',
+      depfile : 'gtkdemo_resources.c.d',
+      command : [glib_compile_resources,
+                 '--generate-source',
+                 '--target=@OUTPUT@',
+                 '--dependency-file=@DEPFILE@',
+                 '--sourcedir=' + meson.current_source_dir(),
+                 '--sourcedir=' + meson.current_build_dir(),
+                 '--external-data',
+                 '--c-name', '_g_binary_gtkdemo',
+                 '@INPUT@'])
+
+  # Create object file containing resource data
+  gtkdemo_resources_binary = custom_target('gtkdemo_resources.o',
+      input : gtkdemo_gresource,
+      output : 'gtkdemo_resources.o',
+      command : [ld,
+                 '-r',
+                 '-b','binary',
+                 '@INPUT@',
+                 '-o','@OUTPUT@'])
+
+  # Rename symbol to match the one in the C file
+  gtkdemo_resources_o = custom_target('gtkdemo_resources2.o',
+    input : gtkdemo_resources_binary,
+    output : 'gtkdemo_resources2.o',
+    command : [objcopy,
+                 '--add-symbol','_g_binary_gtkdemo_resource_data=.data:0',
+                 '@INPUT@',
+                 '@OUTPUT@'])
+
+  gtkdemo_resources = [
+      gtkdemo_resources_c,
+      gtkdemo_resources_o,
+    ]
+else
+  gtkdemo_resources = gnome.compile_resources('gtkdemo_resources',
+    'demo.gresource.xml',
+    source_dir: '.',
+  )
+endif

 # Use a subset of compiler flags
 demo_cflags = []
@@ -33,7 +33,7 @@
  <developer_name>Matthias Clasen and others</developer_name>
  <content_rating type="oars-1.1"/>
  <releases>
-    <release version="@BUILD_VERSION@" date="@BUILD_DATE@">
+    <release version="@BUILD_VERSION@">
      <description>
        <p>A new build of GTK.</p>
      </description>
@@ -32,7 +32,7 @@
  <developer_name>Matthias Clasen and others</developer_name>
  <content_rating type="oars-1.1"/>
  <releases>
-    <release version="@BUILD_VERSION@" date="@BUILD_DATE@">
+    <release version="@BUILD_VERSION@">
      <description>
        <p>A new build of GTK.</p>
      </description>
@@ -12,19 +12,9 @@ demo_conf_h = declare_dependency(
 )

 # appdata
-today = 'unknown'
-date = find_program('date',
-         required: false)
-if date.found()
-  r = run_command(date, '-I')
-  if r.returncode() == 0
-    today = r.stdout().strip()
-  endif
-endif

 appdata_config = configuration_data()
 appdata_config.set('BUILD_VERSION', meson.project_version())
-appdata_config.set('BUILD_DATE', today)

 subdir('constraint-editor')
 subdir('gtk-demo')
@@ -24,7 +24,7 @@
 #include "gtkrendererpaintableprivate.h"

 #include "gsk/gskrendernodeparserprivate.h"
-#include "gsk/ngl/gsknglrenderer.h"
+#include "gsk/gl/gskglrenderer.h"
 #ifdef GDK_WINDOWING_BROADWAY
 #include "gsk/broadway/gskbroadwayrenderer.h"
 #endif
@@ -646,7 +646,6 @@ create_cairo_texture (NodeEditorWindow *self)
  GskRenderer *renderer;
  GskRenderNode *node;
  GdkTexture *texture;
-  GdkSurface *surface;

  paintable = gtk_picture_get_paintable (GTK_PICTURE (self->picture));
  if (paintable == NULL ||
@@ -659,9 +658,8 @@ create_cairo_texture (NodeEditorWindow *self)
  if (node == NULL)
    return NULL;

-  surface = gtk_native_get_surface (gtk_widget_get_native (GTK_WIDGET (self)));
  renderer = gsk_cairo_renderer_new ();
-  gsk_renderer_realize (renderer, surface, NULL);
+  gsk_renderer_realize (renderer, NULL, NULL);

  texture = gsk_renderer_render_texture (renderer, node, NULL);
  gsk_render_node_unref (node);
@@ -839,16 +837,18 @@ node_editor_window_add_renderer (NodeEditorWindow *self,
                                 GskRenderer      *renderer,
                                 const char       *description)
 {
-  GdkSurface *surface;
  GdkPaintable *paintable;

-  surface = gtk_native_get_surface (GTK_NATIVE (self));
-  g_assert (surface != NULL);
-
-  if (renderer != NULL && !gsk_renderer_realize (renderer, surface, NULL))
+  if (!gsk_renderer_realize (renderer, NULL, NULL))
    {
-      g_object_unref (renderer);
-      return;
+      GdkSurface *surface = gtk_native_get_surface (GTK_NATIVE (self));
+      g_assert (surface != NULL);
+
+      if (!gsk_renderer_realize (renderer, surface, NULL))
+        {
+          g_object_unref (renderer);
+          return;
+        }
    }

  paintable = gtk_renderer_paintable_new (renderer, gtk_picture_get_paintable (GTK_PICTURE (self->picture)));
@@ -872,7 +872,7 @@ node_editor_window_realize (GtkWidget *widget)
                                   "Default");
 #endif
  node_editor_window_add_renderer (self,
-                                   gsk_ngl_renderer_new (),
+                                   gsk_gl_renderer_new (),
                                   "OpenGL");
 #ifdef GDK_RENDERING_VULKAN
  node_editor_window_add_renderer (self,
@@ -198,6 +198,7 @@
                    <child>
                      <object class="GtkPicture" id="picture">
                        <property name="can-shrink">0</property>
+                        <property name="keep-aspect-ratio">1</property>
                        <property name="halign">center</property>
                        <property name="valign">center</property>
                        <child>
@@ -1,9 +1,73 @@
 # demos/widget-factory

-widgetfactory_resources = gnome.compile_resources('widgetfactory_resources',
-  'widget-factory.gresource.xml',
-  source_dir: '.',
-)
+objcopy_supports_add_symbol = false
+objcopy = find_program('objcopy', required : false)
+if objcopy.found()
+  objcopy_supports_add_symbol = run_command(objcopy, '--help').stdout().contains('--add-symbol')
+endif
+
+ld = find_program('ld', required : false)
+
+if build_machine.system() == 'linux' and objcopy.found() and objcopy_supports_add_symbol and ld.found()
+  glib_compile_resources = find_program('glib-compile-resources')
+
+  # Create the resource blob
+  widgetfactory_gresource = custom_target('widgetfactory.gresource',
+      input : 'widget-factory.gresource.xml',
+      output : 'widgetfactory.gresource',
+      depfile: 'widgetfactory.gresource.d',
+      command : [glib_compile_resources,
+                 '--generate',
+                 '--target=@OUTPUT@',
+                 '--dependency-file=@DEPFILE@',
+                 '--sourcedir=' + meson.current_source_dir(),
+                 '--sourcedir=' + meson.current_build_dir(),
+                 '@INPUT@'])
+
+  # Create resource data file
+  widgetfactory_resources_c = custom_target('widgetfactory_resources.c',
+      input : 'widget-factory.gresource.xml',
+      output : 'widgetfactory_resources.c',
+      depfile: 'widgetfactory_resources.c.d',
+      command : [glib_compile_resources,
+                 '--generate-source',
+                 '--target=@OUTPUT@',
+                 '--dependency-file=@DEPFILE@',
+                 '--sourcedir=' + meson.current_source_dir(),
+                 '--sourcedir=' + meson.current_build_dir(),
+                 '--external-data',
+                 '--c-name', '_g_binary_widgetfactory',
+                 '@INPUT@'])
+
+  # Create object file containing resource data
+  widgetfactory_resources_binary = custom_target('widgetfactory_resources.o',
+      input : widgetfactory_gresource,
+      output : 'widgetfactory_resources.o',
+      command : [ld,
+                 '-r',
+                 '-b','binary',
+                 '@INPUT@',
+                 '-o','@OUTPUT@'])
+
+  # Rename symbol to match the one in the C file
+  widgetfactory_resources_o = custom_target('widgetfactory_resources2.o',
+    input : widgetfactory_resources_binary,
+    output : 'widgetfactory_resources2.o',
+    command : [objcopy,
+                 '--add-symbol','_g_binary_widgetfactory_resource_data=.data:0',
+                 '@INPUT@',
+                 '@OUTPUT@'])
+
+  widgetfactory_resources = [
+      widgetfactory_resources_c,
+      widgetfactory_resources_o,
+    ]
+else
+  widgetfactory_resources = gnome.compile_resources('widgetfactory_resources',
+    'widget-factory.gresource.xml',
+    source_dir: '.',
+  )
+endif

 executable('gtk4-widget-factory',
  sources: ['widget-factory.c', widgetfactory_resources],
@@ -34,7 +34,7 @@
  <developer_name>Matthias Clasen and others</developer_name>
  <content_rating type="oars-1.1"/>
  <releases>
-    <release version="@BUILD_VERSION@" date="@BUILD_DATE@">
+    <release version="@BUILD_VERSION@">
      <description>
        <p>A new build of GTK.</p>
      </description>
@@ -13,4 +13,5 @@ baseURLs = [
    [ 'Gtk', 'https://docs.gtk.org/gtk4/' ],
    [ 'Pango', 'https://docs.gtk.org/Pango/' ],
    [ 'PangoCairo', 'https://docs.gtk.org/PangoCairo/' ],
+    [ 'GdkPixbuf', 'https://docs.gtk.org/gdk-pixbuf/' ],
 ]
@@ -13,4 +13,5 @@ baseURLs = [
    [ 'Gtk', 'https://docs.gtk.org/gtk4/' ],
    [ 'Pango', 'https://docs.gtk.org/Pango/' ],
    [ 'PangoCairo', 'https://docs.gtk.org/PangoCairo/' ],
+    [ 'GdkPixbuf', 'https://docs.gtk.org/gdk-pixbuf/' ],
 ]
@@ -3,13 +3,13 @@ Slug: gtk-getting-started

 GTK is a [widget toolkit](http://en.wikipedia.org/wiki/Widget_toolkit).
 Each user interface created by GTK consists of widgets. This is implemented
-in C using [GObject](#gobject), an object-oriented framework for C. Widgets
+in C using [class@GObject.Object], an object-oriented framework for C. Widgets
 are organized in a hierarchy. The window widget is the main container.
 The user interface is then built by adding buttons, drop-down menus, input
 fields, and other widgets to the window. If you are creating complex user
 interfaces it is recommended to use GtkBuilder and its GTK-specific markup
 description language, instead of assembling the interface manually. You can
-also use a visual user interface editor, like [glade](https://glade.gnome.org/).
+also use a visual user interface editor, like [Glade](https://glade.gnome.org/).

 GTK is event-driven. The toolkit listens for events such as a click
 on a button, and passes the event to your application.
@@ -17,7 +17,7 @@ on a button, and passes the event to your application.
 This chapter contains some tutorial information to get you started with
 GTK programming. It assumes that you have GTK, its dependencies and a C
 compiler installed and ready to use. If you need to build GTK itself first,
-refer to the [Compiling the GTK libraries](#gtk-compiling) section in this
+refer to the [Compiling the GTK libraries](building.html) section in this
 reference.

 ## Basics
@@ -68,7 +68,7 @@ gcc $( pkg-config --cflags gtk4 ) -o example-0 example-0.c $( pkg-config --libs
 ```

 For more information on how to compile a GTK application, please
-refer to the [Compiling GTK Applications](#gtk-compiling)
+refer to the [Compiling GTK Applications](compiling.html)
 section in this reference.

 All GTK applications will, of course, include `gtk/gtk.h`, which declares
@@ -106,16 +106,16 @@ The call to [ctor@Gtk.ApplicationWindow.new] will create a new
 window will have a frame, a title bar, and window controls depending on the
 platform.

-A window title is set using [method@Gtk.Window.set_title]. This function
+A window title is set using [`method@Gtk.Window.set_title`]. This function
 takes a `GtkWindow` pointer and a string as input. As our `window` pointer
 is a `GtkWidget` pointer, we need to cast it to `GtkWindow`; instead of
 casting `window` via a typical C cast like `(GtkWindow*)`, `window` can be
 cast using the macro `GTK_WINDOW()`. `GTK_WINDOW()` will check if the
 pointer is an instance of the `GtkWindow` class, before casting, and emit a
 warning if the check fails. More information about this convention can be
-found [here](https://developer.gnome.org/gobject/stable/gtype-conventions.html).
+found [in the GObject documentation](https://docs.gtk.org/gobject/concepts.html#conventions).

-Finally the window size is set using [method@Gtk.Window.set_default_size]
+Finally the window size is set using [`method@Gtk.Window.set_default_size`]
 and the window is then shown by GTK via [method@Gtk.Widget.show].

 When you close the window, by (for example) pressing the X button, the
@@ -161,19 +161,24 @@ activate (GtkApplication *app,
 {
  GtkWidget *window;
  GtkWidget *button;
+  GtkWidget *box;

  window = gtk_application_window_new (app);
  gtk_window_set_title (GTK_WINDOW (window), "Window");
  gtk_window_set_default_size (GTK_WINDOW (window), 200, 200);

+  box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
+  gtk_widget_set_halign (box, GTK_ALIGN_CENTER);
+  gtk_widget_set_valign (box, GTK_ALIGN_CENTER);
+  
+  gtk_window_set_child (GTK_WINDOW (window), box);
+
  button = gtk_button_new_with_label ("Hello World");
-  gtk_widget_set_halign (button, GTK_ALIGN_CENTER);
-  gtk_widget_set_valign (button, GTK_ALIGN_CENTER);

  g_signal_connect (button, "clicked", G_CALLBACK (print_hello), NULL);
  g_signal_connect_swapped (button, "clicked", G_CALLBACK (gtk_window_destroy), window);

-  gtk_window_set_child (GTK_WINDOW (window), button);
+  gtk_box_append (GTK_BOX (box), button);

  gtk_widget_show (window);
 }
@@ -212,10 +217,10 @@ The `GtkBox` widget is created with [ctor@Gtk.Box.new], which takes a
 this box will contain can either be laid out horizontally or vertically.
 This does not matter in this particular case, as we are dealing with only
 one button. After initializing box with the newly created `GtkBox`, the code
-adds the box widget to the window widget using [method@Gtk.Window.set_child].
+adds the box widget to the window widget using [`method@Gtk.Window.set_child`].

 Next the `button` variable is initialized in similar manner.
-[ctor@Gtk.Button.new_with_label] is called which returns a
+[`ctor@Gtk.Button.new_with_label`] is called which returns a
 [class@Gtk.Button] to be stored in `button`. Afterwards `button` is added to
 our `box`.

@@ -241,8 +246,8 @@ More information about creating buttons can be found
 [here](https://wiki.gnome.org/HowDoI/Buttons).

 The rest of the code in `example-1.c` is identical to `example-0.c`. The next
-section will elaborate further on how to add several GtkWidgets to your GTK
-application.
+section will elaborate further on how to add several [class@Gtk.Widget]s to your
+GTK application.

 ## Packing

@@ -251,10 +256,18 @@ a window. When you do so, it becomes important to control how each widget is
 positioned and sized. This is where packing comes in.

 GTK comes with a large variety of _layout containers_ whose purpose it
-is to control the layout of the child widgets that are added to them.
-See [Layout containers](#LayoutContainers) for an overview.
+is to control the layout of the child widgets that are added to them, like:

-The following example shows how the GtkGrid container lets you
+- [class@Gtk.Box]
+- [class@Gtk.Grid]
+- [class@Gtk.Revealer]
+- [class@Gtk.Stack]
+- [class@Gtk.Overlay]
+- [class@Gtk.Paned]
+- [class@Gtk.Expander]
+- [class@Gtk.Fixed]
+
+The following example shows how the [class@Gtk.Grid] container lets you
 arrange several buttons:

 ![Grid packing](grid-packing.png)
@@ -353,11 +366,11 @@ draw function.
 The contents of a widget often need to be partially or fully redrawn, e.g.
 when another window is moved and uncovers part of the widget, or when the
 window containing it is resized. It is also possible to explicitly cause a
-widget to be redrawn, by calling [method@Gtk.Widget.queue_draw]. GTK takes
+widget to be redrawn, by calling [`method@Gtk.Widget.queue_draw`]. GTK takes
 care of most of the details by providing a ready-to-use cairo context to the
 draw function.

-The following example shows how to use a draw function with GtkDrawingArea.
+The following example shows how to use a draw function with [class@Gtk.DrawingArea].
 It is a bit more complicated than the previous examples, since it also
 demonstrates input event handling with event controllers.

@@ -402,9 +415,9 @@ resize_cb (GtkWidget *widget,
  if (gtk_native_get_surface (gtk_widget_get_native (widget)))
    {
      surface = gdk_surface_create_similar_surface (gtk_native_get_surface (gtk_widget_get_native (widget)),
-                                                   CAIRO_CONTENT_COLOR,
-                                                   gtk_widget_get_width (widget),
-                                                   gtk_widget_get_height (widget));
+                                                    CAIRO_CONTENT_COLOR,
+                                                    gtk_widget_get_width (widget),
+                                                    gtk_widget_get_height (widget));

      /* Initialize the surface to white */
      clear_surface ();
@@ -690,16 +703,16 @@ gcc $( pkg-config --cflags gtk4 ) -o example-3 example-3.c $( pkg-config --libs

 Note that `GtkBuilder` can also be used to construct objects that are
 not widgets, such as tree models, adjustments, etc. That is the reason
-the method we use here is called [method@Gtk.Builder.get_object] and returns
-a `GObject` instead of a `GtkWidget`.
+the method we use here is called [`method@Gtk.Builder.get_object`] and
+returns a `GObject` instead of a `GtkWidget`.

-Normally, you would pass a full path to [method@Gtk.Builder.add_from_file] to
+Normally, you would pass a full path to [`method@Gtk.Builder.add_from_file`] to
 make the execution of your program independent of the current directory.
 A common location to install UI descriptions and similar data is
 `/usr/share/appname`.

 It is also possible to embed the UI description in the source code as a
-string and use [method@Gtk.Builder.add_from_string] to load it. But keeping the
+string and use [`method@Gtk.Builder.add_from_string`] to load it. But keeping the
 UI description in a separate file has several advantages: It is then possible
 to make minor adjustments to the UI without recompiling your program, and,
 more importantly, graphical UI editors such as [Glade](http://glade.gnome.org)
@@ -762,17 +775,17 @@ main (int argc, char *argv[])
 ```

 All the application logic is in the application class, which is a subclass of
-GtkApplication. Our example does not yet have any interesting functionality.
+`GtkApplication`. Our example does not yet have any interesting functionality.
 All it does is open a window when it is activated without arguments, and open
 the files it is given, if it is started with arguments.

-To handle these two cases, we override the activate() vfunc, which gets
+To handle these two cases, we override the `activate()` vfunc, which gets
 called when the application is launched without commandline arguments, and
 the `open()` virtual function, which gets called when the application is
 launched with commandline arguments.

 To learn more about `GApplication` entry points, consult the GIO
-[documentation](https://developer.gnome.org/gio/stable/GApplication.html#GApplication.description).
+[documentation](https://docs.gtk.org/gio/class.Application.html).

 ```c
 #include <gtk/gtk.h>
@@ -841,8 +854,8 @@ example_app_new (void)
 ```

 Another important class that is part of the application support in GTK is
-`GtkApplicationWindow`. It is typically subclassed as well. Our subclass does
-not do anything yet, so we will just get an empty window.
+[class@Gtk.ApplicationWindow]. It is typically subclassed as well. Our
+subclass does not do anything yet, so we will just get an empty window.

 ```c
 #include <gtk/gtk.h>
@@ -907,10 +920,10 @@ and it accepts files as commandline arguments.

 ### Populating the window

-In this step, we use a GtkBuilder template to associate a
-GtkBuilder ui file with our application window class.
+In this step, we use a `GtkBuilder` template to associate a
+`GtkBuilder` ui file with our application window class.

-Our simple ui file gives the window a title, and puts a GtkStack
+Our simple ui file gives the window a title, and puts a `GtkStack`
 widget as the main content.

 ```xml
@@ -934,9 +947,9 @@ widget as the main content.

 To make use of this file in our application, we revisit our
 `GtkApplicationWindow` subclass, and call
-`gtk_widget_class_set_template_from_resource()` from the class init
+[`method@Gtk.WidgetClass.set_template_from_resource`] from the class init
 function to set the ui file as template for this class. We also
-add a call to `gtk_widget_init_template()` in the instance init
+add a call to [`method@Gtk.Widget.init_template`] in the instance init
 function to instantiate the template for each instance of our
 class.

@@ -963,7 +976,7 @@ example_app_window_class_init (ExampleAppWindowClass *class)

 You may have noticed that we used the `_from_resource()` variant of the function
 that sets a template. Now we need to use
-[GLib's resource functionality](https://developer.gnome.org/gio/stable/GResource.html)
+[GLib's resource functionality](https://docs.gtk.org/gio/struct.Resource.html)
 to include the ui file in the binary. This is commonly done by listing all resources
 in a `.gresource.xml` file, such as this:

@@ -985,7 +998,7 @@ glib-compile-resources exampleapp.gresource.xml --target=resources.c --generate-
 ```

 The gnome module of the [Meson build system](https://mesonbuild.com)
-provides the [gnome.compile_resources()](https://mesonbuild.com/Gnome-module.html#gnomecompile_resources)
+provides the [`gnome.compile_resources()`](https://mesonbuild.com/Gnome-module.html#gnomecompile_resources)
 method for this task.

 Our application now looks like this:
@@ -1001,7 +1014,7 @@ To this end, we add a member to the struct of our application window subclass
 and keep a reference to the `GtkStack` there. The first member of the struct
 should be the parent type from which the class is derived. Here,
 `ExampleAppWindow` is derived from `GtkApplicationWindow`. The
-`gtk_widget_class_bind_template_child()` function arranges things so that after
+[`func@Gtk.widget_class_bind_template_child`] function arranges things so that after
 instantiating the template, the `stack` member of the struct will point to the
 widget of the same name from the template.

@@ -1081,7 +1094,7 @@ tell it to display information about our stack.

 The stack switcher gets all its information it needs to display tabs from
 the stack that it belongs to. Here, we are passing the label to show for
-each file as the last argument to the [method@Gtk.Stack.add_titled]
+each file as the last argument to the [`method@Gtk.Stack.add_titled`]
 function.

 Our application is beginning to take shape:
@@ -1121,7 +1134,7 @@ resulting menu model with the menu button that we've added to the headerbar.
 Since menus work by activating GActions, we also have to add a suitable set
 of actions to our application.

-Adding the actions is best done in the startup() vfunc, which is guaranteed
+Adding the actions is best done in the `startup()` vfunc, which is guaranteed
 to be called once for each primary application instance:

 ```c
@@ -1179,7 +1192,7 @@ example_app_class_init (ExampleAppClass *class)

 Our preferences menu item does not do anything yet, but the Quit menu item
 is fully functional. Note that it can also be activated by the usual Ctrl-Q
-shortcut. The shortcut was added with `gtk_application_set_accels_for_action()`.
+shortcut. The shortcut was added with [`method@Gtk.Application.set_accels_for_action`].

 The application menu looks like this:

@@ -1191,7 +1204,7 @@ A typical application will have a some preferences that should be remembered
 from one run to the next. Even for our simple example application, we may
 want to change the font that is used for the content.

-We are going to use `GSettings` to store our preferences. `GSettings` requires
+We are going to use [class@Gio.Settings] to store our preferences. `GSettings` requires
 a schema that describes our settings:

 ```xml
@@ -1218,10 +1231,9 @@ a schema that describes our settings:
 ```

 Before we can make use of this schema in our application, we need to compile
-it into the binary form that GSettings expects. GIO provides
-[macros](https://developer.gnome.org/gio/2.36/ch31s06.html) to do this in
-autotools-based projects, and the gnome module of the Meson build system
-provides the [gnome.compile_schemas()](https://mesonbuild.com/Gnome-module.html#gnomecompile_schemas)
+it into the binary form that GSettings expects. GIO provides macros to do
+this in Autotools-based projects, and the gnome module of the Meson build
+system provides the [`gnome.compile_schemas()`](https://mesonbuild.com/Gnome-module.html#gnomecompile_schemas)
 method for this task.

 Next, we need to connect our settings to the widgets that they are supposed
@@ -1681,7 +1693,8 @@ What our application looks like now:
 Widgets and other objects have many useful properties.

 Here we show some ways to use them in new and flexible ways, by wrapping
-them in actions with `GPropertyAction` or by binding them with `GBinding`.
+them in actions with [class@Gio.PropertyAction] or by binding them with
+[class@GObject.Binding].

 To set this up, we add two labels to the header bar in our window template,
 named `lines_label` and `lines`, and bind them to struct members in the
@@ -0,0 +1,57 @@
+.. _gtk4-broadwayd(1):
+
+==============
+gtk4-broadwayd
+==============
+
+---------------------------
+The Broadway display server
+---------------------------
+
+SYNOPSIS
+--------
+|   **gtk4-broadwayd** [OPTIONS...] <DISPLAY>
+|   **gtk4-broadwayd** --port=PORT --address=ADDRESS <DISPLAY>
+|   **gtk4-broadwayd** --unixaddress=ADDRESS <DISPLAY>
+
+
+DESCRIPTION
+-----------
+
+``gtk4-broadwayd`` is a display server for the Broadway GDK backend. It allows
+multiple GTK applications to display their windows in the same web browser, by
+connecting to gtk4-broadwayd.
+
+When using gtk4-broadwayd, specify the display number to use, prefixed with a
+colon, similar to X. The default display number is 0.
+
+::
+
+   gtk4-broadwayd :5
+
+
+Then point your web browser at ``http://127.0.0.1:8085``.
+
+Start your applications like this:
+
+::
+
+   GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 gtk4-demo
+
+
+OPTIONS
+-------
+
+``--port PORT``
+
+  Use the given ``PORT`` for the HTTP connection, instead of the default ``8080 + (DISPLAY - 1)``.
+
+``--address ADDRESS``
+
+  Use the given ``address`` for the HTTP connection, instead of the default ``http://127.0.0.1``.
+
+``--unixsocket ADDRESS``
+
+  Use the given ``address`` as the unix domain socket address. This option
+  overrides ``--address`` and ``--port``, and it is available only on Unix-like
+  systems.
@@ -1,84 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-broadwayd">
-
-<refentryinfo>
-  <title>gtk4-broadwayd</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Alexander</firstname>
-      <surname>Larsson</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-broadwayd</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-broadwayd</refname>
-  <refpurpose>Broadway display server</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-broadwayd</command>
-<arg choice="opt">--port <replaceable>PORT</replaceable></arg>
-<arg choice="opt">--address <replaceable>ADDRESS</replaceable></arg>
-<arg choice="opt">--unixsocket <replaceable>ADDRESS</replaceable></arg>
-<arg choice="opt"><replaceable>:DISPLAY</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-broadwayd</command> is a display server for the Broadway
-GDK backend. It allows multiple GTK applications to display their
-windows in the same web browser, by connecting to gtk4-broadwayd.
-</para>
-<para>
-When using gtk4-broadwayd, specify the display number to use, prefixed
-with a colon, similar to X. The default display number is 0.
-<programlisting>
-gtk4-broadwayd :5
-</programlisting>
-Then point your web browser at <literal>http://127.0.0.1:8085</literal>.
-Start your applications like this:
-<programlisting>
-GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 gtk4-demo
-</programlisting>
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
-  <varlistentry>
-    <term>--port</term>
-    <listitem><para>Use <replaceable>PORT</replaceable> as the HTTP
-      port, instead of the default 8080 + (<replaceable>DISPLAY</replaceable> - 1).
-      </para></listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>--address</term>
-    <listitem><para>Use <replaceable>ADDRESS</replaceable> as the HTTP
-      address, instead of the default <literal>http://127.0.0.1:<replaceable>PORT</replaceable></literal>.
-      </para></listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>--unixsocket</term>
-    <listitem><para>Use <replaceable>ADDRESS</replaceable> as the unix domain socket
-      address. This option overrides <literal>--address</literal> and <literal>--port</literal>.
-      It is available only on Unix-like systems.
-      </para></listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,85 @@
+.. _gtk4-builder-tool(1):
+
+=================
+gtk4-builder-tool
+=================
+
+-----------------------
+GtkBuilder File Utility
+-----------------------
+
+SYNOPSIS
+--------
+|   **gtk4-builder-tool** <COMMAND> [OPTIONS...] <FILE>
+|
+|   **gtk4-builder-tool** validate <FILE>
+|   **gtk4-builder-tool** enumerate <FILE>
+|   **gtk4-builder-tool** simplify [OPTIONS...] <FILE>
+|   **gtk4-builder-tool** preview [OPTIONS...] <FILE>
+
+DESCRIPTION
+-----------
+
+``gtk4-builder-tool`` can perform various operations on GtkBuilder UI definition
+files.
+
+COMMANDS
+--------
+
+Validation
+^^^^^^^^^^
+
+The ``validate`` command validates the given UI definition file and reports
+errors to ``stderr``.
+
+Enumeration
+^^^^^^^^^^^
+
+The ``enumerate`` command lists all the named objects that are present in the UI
+definition file.
+
+Preview
+^^^^^^^
+
+The ``preview`` command displays the UI dfinition file.
+
+This command accepts options to specify the ID of the toplevel object and a CSS
+file to use.
+
+``--id=ID``
+
+  The ID of the object to preview. If not specified, gtk4-builder-tool will
+  choose a suitable object on its own.
+
+``--css=FILE``
+
+  Load style information from the given CSS file.
+
+Simplification
+^^^^^^^^^^^^^^
+
+The ``simplify`` command simplifies the UI definition file by removing
+properties that are set to their default values and writes the resulting XML to
+the standard output, or back to the input file.
+
+When the ``--3to4`` option is specified, the ``simplify`` command interprets the
+input as a GTK 3 UI definuition file and attempts to convert it to GTK 4
+equivalents. It performs various conversions, such as renaming properties,
+translating child properties to layout properties, rewriting the setup for
+GtkNotebook, GtkStack, GtkAssistant  or changing toolbars into boxes.
+
+You should always test the modified UI definition files produced by
+gtk4-builder-tool before using them in production.
+
+Note in particular that the conversion done with ``--3to4`` is meant as a
+starting point for a port from GTK 3 to GTK 4. It is expected that you will have
+to do manual fixups  after the initial conversion.
+
+``--replace``
+
+  Write the content back to the UI definition file instead of using the standard
+  output.
+
+``--3to4``
+
+  Transform a GTK 3 UI definition file to the equivalent GTK 4 definitions.
@@ -1,110 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-builder-tool">
-
-<refentryinfo>
-  <title>gtk4-builder-tool</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-builder-tool</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-builder-tool</refname>
-  <refpurpose>GtkBuilder file utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-builder-tool</command>
-<arg choice="opt"><replaceable>COMMAND</replaceable></arg>
-<arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
-<arg choice="plain"><replaceable>FILE</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk4-builder-tool</command> can perform various operations
-  on GtkBuilder .ui files.
-</para>
-<para>
-  The <option>validate</option> command validates the .ui file and reports
-  errors to stderr.
-</para>
-<para>
-  The <option>enumerate</option> command lists all the named objects that
-  are created in the .ui file.
-</para>
-<para>
-  The <option>preview</option> command displays the .ui file. This command
-  accepts options to specify the ID of the toplevel object and a .css file
-  to use.
-</para>
-<para>
-  The <option>simplify</option> command simplifies the .ui file by removing
-  properties that are set to their default values and writes the resulting XML
-  to stdout, or back to the input file.
-</para>
-<para>
-  When the <option>--3to4</option> is specified, <option>simplify</option>
-  interprets the input as a GTK 3 ui file and attempts to convert it to GTK 4
-  equivalents. It performs various conversions, such as renaming properties,
-  translating child properties to layout properties, rewriting the setup for
-  GtkNotebook, GtkStack, GtkAssistant  or changing toolbars into boxes.
-</para>
-<para>
-  You should always test the modified .ui files produced by gtk4-builder-tool
-  before using them in production.
-</para>
-<para>
-  Note in particular that the conversion
-  done with <option>--3to4</option> is meant as a starting point for a port
-  from GTK 3 to GTK 4. It is expected that you will have to do manual fixups
-  after the initial conversion.
-</para>
-</refsect1>
-
-<refsect1><title>Simplify Options</title>
-  <para>The <option>simplify</option> command accepts the following options:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>--replace</option></term>
-      <listitem><para>Write the content back to the .ui file instead of stdout.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--3to4</option></term>
-      <listitem><para>Transform a GTK 3 ui file to GTK 4</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-<refsect1><title>Preview Options</title>
-  <para>The <option>preview</option> command accepts the following options:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>--id=<arg choice="plain">ID</arg></option></term>
-      <listitem><para>The ID of the object to preview. If not specified,
-                gtk4-builder-tool will choose a suitable object on its own.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--css=<arg choice="plain">FILE</arg></option></term>
-      <listitem><para>Load style information from the given .css file.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,22 @@
+.. _gtk4-demo-application(1):
+
+=====================
+gtk4-demo-application
+=====================
+
+--------------------------
+Demonstrate GtkApplication
+--------------------------
+
+
+SYNOPSIS
+--------
+|   **gtk4-demo-application**
+
+
+DESCRIPTION
+-----------
+
+``gtk4-demo-application`` is an example application used by ``gtk4-demo``.
+
+There is no need to call it manually.
@@ -1,44 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-demo-application">
-
-<refentryinfo>
-  <title>gtk4-demo-application</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-demo-application</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-demo-application</refname>
-  <refpurpose>Demonstrate GtkApplication</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-demo-application</command>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-demo-application</command> is an example application
-used by <command>gtk4-demo</command>. There is no need to call it
-manually.
-</para>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,48 @@
+.. _gtk4-demo(1):
+
+=========
+gtk4-demo
+=========
+
+-----------------------
+Demonstrate GTK widgets
+-----------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-demo** [OPTIONS...]
+
+DESCRIPTION
+-----------
+
+``gtk4-demo`` is a collection of examples.
+
+Its purpose is to demonstrate many GTK widgets in a form that is useful to
+application developers.
+
+The application shows the source code for each example, as well as other used
+resources, such as UI description files and image assets.
+
+OPTIONS
+-------
+
+``-h, --help``
+
+  Show help options.
+
+``--version``
+
+  Show program version.
+
+``--list``
+
+  List available examples.
+
+``--run EXAMPLE``
+
+  Run the named example. Use ``--list`` to see the available examples.
+
+``--autoquit``
+
+  Quit after a short timeout. This is intended for use with ``--run``, e.g. when profiling.
@@ -1,81 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-demo">
-
-<refentryinfo>
-  <title>gtk4-demo</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-demo</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-demo</refname>
-  <refpurpose>Demonstrate GTK widgets</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-demo</command>
-<arg choice="opt">--help</arg>
-<arg choice="opt">--version</arg>
-<arg choice="opt">--list</arg>
-<arg choice="opt">--run <replaceable>EXAMPLE</replaceable></arg>
-<arg choice="opt">--autoquit</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-demo</command> is a collection of examples.
-Its purpose is to demonstrate many GTK widgets in a form
-that is useful to application developers.
-</para>
-<para>
-The application shows the source code for each example, as well as
-other used resources, such as ui files and icons.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-  <para>The following options are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>-h</option>, <option>--help</option></term>
-      <listitem><para>Show help options</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--version</option></term>
-      <listitem><para>Show program version</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--list</option></term>
-      <listitem><para>List available examples.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>-run <replaceable>EXAMPLE</replaceable></option></term>
-      <listitem><para>Run the named example. Use <option>--list</option> to
-        see the available examples.</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--autoquit</option></term>
-      <listitem><para>Quit after a short timeout. This is intended for use
-        with <option>--run</option>, e.g. when profiling.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,40 @@
+.. _gtk4-encode-symbolic-svg(1):
+
+========================
+gtk4-encode-symbolic-svg
+========================
+
+--------------------------------
+Symbolic icon conversion utility
+--------------------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-encode-symbolic-svg** [OPTIONS...] <PATH> <WIDTH>x<HEIGHT>
+
+DESCRIPTION
+-----------
+
+``gtk4-encode-symbolic-svg`` converts symbolic SVG icons into specially prepared
+PNG files. GTK can load and recolor these PNGs, just like original SVGs, but
+loading them is much faster.
+
+``PATH`` is the name of a symbolic SVG file, ``WIDTH`` x ``HEIGHT`` are the
+desired dimensions for the generated PNG file.
+
+To distinguish them from ordinary PNGs, the generated files have the extension
+``.symbolic.png``.
+
+OPTIONS
+-------
+
+``-o, --output DIRECTORY``
+
+  Write png files to ``DIRECTORY`` instead of the current working directory.
+
+``--debug``
+
+  Generate PNG files of the various channels during the conversion. If these
+  files are not monochrome green, they are often helpful in pinpointing the
+  problematic parts of the source SVG.
@@ -1,74 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-encode-symbolic-svg">
-
-<refentryinfo>
-  <title>gtk4-encode-symbolic-svg</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Alexander</firstname>
-      <surname>Larsson</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-encode-symbolic-svg</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-encode-symbolic-svg</refname>
-  <refpurpose>Symbolic icon conversion utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-encode-symbolic-svg</command>
-<arg choice="opt">OPTION...</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-<arg choice="plain"><replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk4-encode-symbolic-svg</command> converts symbolic svg icons into
-  specially prepared png files. GTK can load and recolor these pngs, just like
-  original svgs, but loading them is much faster.
-</para>
-<para>
-  <replaceable>PATH</replaceable> is the name of a symbolic svg file,
-  <replaceable>WIDTH</replaceable>x<replaceable>HEIGHT</replaceable> are the
-  desired dimensions for the generated png file.
-</para>
-<para>
-  To distinguish them from ordinary pngs, the generated files have the extension
-  <filename>.symbolic.png</filename>.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
-  <varlistentry>
-    <term>-o <replaceable>DIRECTORY</replaceable></term>
-    <term>--output <replaceable>DIRECTORY</replaceable></term>
-    <listitem><para>Write png files to <replaceable>DIRECTORY</replaceable>
-         instead of the current working directory.</para></listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>--debug</term>
-    <listitem><para>Generate png files of the various channels during
-         the conversion. If these files are not monochrome green, they
-         are often helpful in pinpointing the problematic parts of
-         the source svg.</para></listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,28 @@
+.. _gtk4-icon-browser(1):
+
+=================
+gtk4-icon-browser
+=================
+
+-----------------
+List themed icons
+-----------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-icon-browser** [OPTIONS...]
+
+DESCRIPTION
+-----------
+
+``gtk4-icon-browser`` is a utility to explore the icons in the current icon
+theme. It shows icons in various sizes, their symbolic variants where available,
+as well as a description of the icon and its context.
+
+OPTIONS
+-------
+
+``-h, --help``
+
+  Show the application help.
@@ -1,55 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-icon-browser">
-
-<refentryinfo>
-  <title>gtk4-icon-browser</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-icon-browser</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-icon-browser</refname>
-  <refpurpose>List themed icons</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-icon-browser</command>
-<arg choice="opt">--help</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-icon-browser</command> is a utility to explore the icons
-in the current icon theme. It shows icons in various sizes, their symbolic
-variants where available, as well as a description of the icon and its context.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-  <para>The following options are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>-h</option>, <option>--help</option></term>
-      <listitem><para>Show help options</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,50 @@
+.. _gtk4-launch(1):
+
+===========
+gtk4-launch
+===========
+
+---------------------
+Launch an application
+---------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-launch** [OPTIONS...] <APPLICATION> [URI...]
+
+DESCRIPTION
+-----------
+
+``gtk4-launch`` launches an application using the given name. The application is
+started with proper startup notification on a default display, unless specified
+otherwise.
+
+``gtk4-launch`` takes at least one argument, the name of the application to
+launch. The name should match application desktop file name, as residing in the
+applications subdirectories of the XDG data directories, with or without the
+``.desktop`` suffix.
+
+If called with more than one argument, the rest of them besides the application
+name are considered URI locations and are passed as arguments to the launched
+application.
+
+OPTIONS
+-------
+
+``-?, -h, --help``
+
+  Print the command's help and exit.
+
+``--version``
+
+  Print the command's version and exit.
+
+ENVIRONMENT
+-----------
+
+Some environment variables affect the behavior of ``gtk4-launch``:
+
+``XDG_DATA_HOME, XDG_DATA_DIRS``
+
+  The environment variables specifying the XDG data directories.
@@ -1,85 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-launch">
-
-<refentryinfo>
-  <title>gtk4-launch</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Tomáš</firstname>
-      <surname>Bžatek</surname>
-      <email>tbzatek@redhat.com</email>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-launch</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-launch</refname>
-  <refpurpose>Launch an application</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-launch</command>
-<arg choice="opt" rep="repeat">OPTION</arg>
-<arg choice="plain">APPLICATION</arg>
-<arg choice="opt" rep="repeat">URI</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-launch</command> launches an application using the given name.
-The application is started with proper startup notification on a default
-display, unless specified otherwise.
-</para>
-<para>
-<command>gtk4-launch</command> takes at least one argument, the name of
-the application to launch. The name should match application desktop file name,
-as residing in the applications subdirectories of the XDG data directories, with
-or without the '.desktop' suffix.
-</para>
-<para>
-If called with more than one argument, the rest of them besides the application
-name are considered URI locations and are passed as arguments to the launched
-application.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-  <para>The following options are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>-?</option>, <option>--help</option></term>
-      <listitem><para>Prints a short help text and exits.</para></listitem>
-    </varlistentry>
-  </variablelist>
-  <variablelist>
-    <varlistentry>
-    <term><option>--version</option></term>
-      <listitem><para>Prints the program version and exits.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-<refsect1><title>Environment</title>
-  <para>Some environment variables affect the behavior of <command>gtk4-launch</command>.</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>XDG_DATA_HOME</option>, <option>XDG_DATA_DIRS</option></term>
-      <listitem><para>The environment variables specifying the XDG dta directories.</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,21 @@
+.. _gtk4-query-settings(1):
+
+===================
+gtk4-query-settings
+===================
+
+------------------------------------
+Print name and value of GTK settings
+------------------------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-query-settings** [PATTERN]
+
+DESCRIPTION
+-----------
+
+``gtk4-query-settings`` prints both name and value of all properties available
+in the ``GtkSettings`` class. Optionally, you can filter which properties to
+list by specifying a ``PATTERN``.
@@ -1,45 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-query-settings">
-
-<refentryinfo>
-  <title>gtk4-query-settings</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Timm</firstname>
-      <surname>Bäder</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-query-settings</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-query-settings</refname>
-  <refpurpose>Utility to print name and value of all GtkSettings properties</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-query-settings</command>
-<arg choice="opt"><replaceable>PATTERN</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk4-query-settings</command> prints both name and value of all properties
-  available in the GtkSettings class. Optionally, you can filter which properties
-  to list by specifying a PATTERN.
-</para>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,65 @@
+.. _gtk4-update-icon-cache(1):
+
+======================
+gtk4-update-icon-cache
+======================
+
+--------------------------
+Icon theme caching utility
+--------------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-update-icon-cache** [OPTIONS...] <PATH>
+
+DESCRIPTION
+-----------
+
+``gtk4-update-icon-cache`` creates ``mmap(2)``-able cache files for icon themes.
+
+It expects to be given the ``PATH`` to an icon theme directory containing an
+``index.theme``, e.g. ``/usr/share/icons/hicolor``, and writes a
+``icon-theme.cache`` containing cached information about the icons in the
+directory tree below the given directory.
+
+GTK can use the cache files created by ``gtk4-update-icon-cache`` to avoid a lot
+of system call and disk seek overhead when the application starts. Since the
+format of the cache files allows them to be shared across multiple processes,
+for instance using the POSIX ``mmap(2)`` system call, the overall memory
+consumption is reduced as well.
+
+OPTIONS
+-------
+
+``-f, --force``
+
+  Overwrite an existing cache file even if it appears to be up-to-date.
+
+``-t, --ignore-theme-index``
+
+  Don't check for the existence of ``index.theme`` in the icon theme directory.
+  Without this option, ``gtk4-update-icon-cache`` refuses to create an icon
+  cache in a directory which does not appear to be the toplevel directory of an
+  icon theme.
+
+``-i, --index-only``
+
+  Don't include image data in the cache.
+
+``--include-image-data``
+
+  Include image data in the cache.
+
+``-c, --source <NAME>``
+
+  Output a C header file declaring a constant ``NAME`` with the contents of the
+  icon cache.
+
+``-q, --quiet``
+
+  Turn off verbose output.
+
+``-v, --validate``
+
+  Validate existing icon cache.
@@ -1,123 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-update-icon-cache">
-
-<refentryinfo>
-  <title>gtk4-update-icon-cache</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-update-icon-cache</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-update-icon-cache</refname>
-  <refpurpose>Icon theme caching utility</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-update-icon-cache</command>
-<arg choice="opt">--force</arg>
-<arg choice="opt">--ignore-theme-index</arg>
-<group>
-  <arg choice="plain">--index-only</arg>
-  <arg choice="plain">--include-image-data</arg>
-</group>
-<arg choice="opt">--source <arg choice="plain"><replaceable>NAME</replaceable></arg></arg>
-<arg choice="opt">--quiet</arg>
-<arg choice="opt">--validate</arg>
-<arg choice="plain"><replaceable>PATH</replaceable></arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-  <command>gtk4-update-icon-cache</command> creates mmapable cache
-  files for icon themes.
-</para>
-<para>
-  It expects to be given the <replaceable>PATH</replaceable> to an icon theme
-  directory containing an <filename>index.theme</filename>, e.g.
-  <filename>/usr/share/icons/hicolor</filename>, and writes a
-  <filename>icon-theme.cache</filename> containing cached information about
-  the icons in the directory tree below the given directory.
-</para>
-<para>
-  GTK can use the cache files created by <command>gtk4-update-icon-cache</command>
-  to avoid a lot of system call and disk seek overhead when the application
-  starts. Since the format of the cache files allows them to be shared across
-  multiple processes, for instance using the POSIX <command>mmap()</command> system
-  call, the overall memory consumption is reduced as well.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-<variablelist>
-  <varlistentry>
-    <term>--force</term>
-    <term>-f</term>
-    <listitem><para>Overwrite an existing cache file even if it appears to be
-         up-to-date.</para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--ignore-theme-index</term>
-    <term>-t</term>
-    <listitem><para>Don't check for the existence of <filename>index.theme</filename>
-     in the icon theme directory. Without this option, <command>gtk4-update-icon-cache</command>
-     refuses to create an icon cache in a directory which does not appear to
-     be the toplevel directory of an icon theme.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--index-only</term>
-    <term>-i</term>
-    <listitem><para>Don't include image data in the cache.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--include-image-data</term>
-    <listitem><para>Include image data in the cache.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--source</term>
-    <term>-c</term>
-    <listitem><para>Output a C header file declaring a constant
-     <replaceable>NAME</replaceable> with the contents of the icon
-     cache.</para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--quiet</term>
-    <term>-q</term>
-    <listitem><para>Turn off verbose output.
-    </para></listitem>
-  </varlistentry>
-
-  <varlistentry>
-    <term>--validate</term>
-    <term>-v</term>
-    <listitem><para>Validate existing icon cache.
-    </para></listitem>
-  </varlistentry>
-</variablelist>
-</refsect1>
-
-</refentry>
@@ -0,0 +1,34 @@
+.. _gtk4-widget-factory(1):
+
+===================
+gtk4-widget-factory
+===================
+
+-------------------------------
+Showcase GTK widgets and styles
+-------------------------------
+
+SYNOPSIS
+--------
+
+|   **gtk4-widget-factory** [OPTIONS...]
+
+DESCRIPTION
+-----------
+
+``gtk4-widget-factory`` is a collection of examples.
+
+Its purpose is to demonstrate many GTK widgets in a form that is useful to GTK theme developers.
+
+The application shows widgets in different, typical combinations and states.
+
+OPTIONS
+-------
+
+``-h, --help``
+
+  Show the application help.
+
+``--version``
+
+  Show the application version.
@@ -1,63 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-]>
-<refentry id="gtk4-widget-factory">
-
-<refentryinfo>
-  <title>gtk4-widget-factory</title>
-  <productname>GTK</productname>
-  <authorgroup>
-    <author>
-      <contrib>Developer</contrib>
-      <firstname>Matthias</firstname>
-      <surname>Clasen</surname>
-    </author>
-  </authorgroup>
-</refentryinfo>
-
-<refmeta>
-  <refentrytitle>gtk4-widget-factory</refentrytitle>
-  <manvolnum>1</manvolnum>
-  <refmiscinfo class="manual">User Commands</refmiscinfo>
-</refmeta>
-
-<refnamediv>
-  <refname>gtk4-widget-factory</refname>
-  <refpurpose>Demonstrate GTK widgets</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<cmdsynopsis>
-<command>gtk4-widget-factory</command>
-<arg choice="opt">--help</arg>
-</cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1><title>Description</title>
-<para>
-<command>gtk4-widget-factory</command> is a collection of examples.
-Its purpose is to demonstrate many GTK widgets in a form
-that is useful to GTK theme developers.
-</para>
-<para>
-The application shows widgets in different, typical combinations
-and states.
-</para>
-</refsect1>
-
-<refsect1><title>Options</title>
-  <para>The following options are understood:</para>
-  <variablelist>
-    <varlistentry>
-    <term><option>-h</option>, <option>--help</option></term>
-      <listitem><para>Show help options</para></listitem>
-    </varlistentry>
-    <varlistentry>
-    <term><option>--version</option></term>
-      <listitem><para>Show program version</para></listitem>
-    </varlistentry>
-  </variablelist>
-</refsect1>
-
-</refentry>
@@ -59,24 +59,15 @@ if get_option('gtk_doc')
  )
 endif

-xsltproc = find_program('xsltproc', required: false)
-if get_option('man-pages') and not xsltproc.found()
-  error('No xsltproc found, but man pages were explicitly enabled')
+rst2man = find_program('rst2man', required: false)
+if get_option('man-pages') and not rst2man.found()
+  error('No rst2man found, but man pages were explicitly enabled')
 endif

-if get_option('man-pages') and xsltproc.found()
-  xlstproc_flags = [
-    '--nonet',
-    '--stringparam', 'man.output.quietly', '1',
-    '--stringparam', 'funcsynopsis.style', 'ansi',
-    '--stringparam', 'man.th.extra1.suppress', '1',
-    '--stringparam', 'man.authors.section.enabled', '0',
-    '--stringparam', 'man.copyright.section.enabled', '0',
-  ]
-
-  man_files = [
-    [ 'gtk4-broadwayd', '1', ],
-    [ 'gtk4-builder-tool', '1', ],
+if get_option('man-pages') and rst2man.found()
+  rst_files = [
+    [ 'gtk4-broadwayd', '1' ],
+    [ 'gtk4-builder-tool', '1' ],
    [ 'gtk4-encode-symbolic-svg', '1', ],
    [ 'gtk4-launch', '1', ],
    [ 'gtk4-query-settings', '1', ],
@@ -84,7 +75,7 @@ if get_option('man-pages') and xsltproc.found()
  ]

  if get_option('demos')
-    man_files += [
+    rst_files += [
      [ 'gtk4-demo', '1', ],
      [ 'gtk4-demo-application', '1', ],
      [ 'gtk4-widget-factory', '1', ],
@@ -92,21 +83,25 @@ if get_option('man-pages') and xsltproc.found()
    ]
  endif

-  foreach man: man_files
-    man_name = man.get(0)
-    man_section = man.get(1, '1')
-    custom_target('@0@.@1@'.format(man_name, man_section),
-      input: '@0@.xml'.format(man_name),
+  rst2man_flags = [
+    '--syntax-highlight=none',
+  ]
+
+  foreach rst: rst_files
+    man_name = rst[0]
+    man_section = rst.get(1, '1')
+
+    custom_target('man-@0@'.format(man_name),
+      input: '@0@.rst'.format(man_name),
      output: '@0@.@1@'.format(man_name, man_section),
      command: [
-        xsltproc,
-        xlstproc_flags,
-        '-o', '@OUTPUT@',
-        'http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl',
+        rst2man,
+        rst2man_flags,
        '@INPUT@',
      ],
+      capture: true,
      install: true,
-      install_dir: join_paths(get_option('mandir'), 'man@0@'.format(man_section)),
+      install_dir: get_option('mandir') / 'man@0@'.format(man_section),
    )
  endforeach
 endif
@@ -668,18 +668,21 @@ box children as necessary.
 ### Adapt to `GtkWindow` API changes

 Following the `GdkSurface` changes, a number of `GtkWindow` APIs that were
-X11-specific have been removed. This includes `gtk_window_set_geometry_hints()`,
-`gtk_window_set_gravity()`, `gtk_window_move()`, `gtk_window_parse_geometry()`,
+X11-specific have been removed. This includes `gtk_window_set_position()`,
+`gtk_window_set_geometry_hints()`, `gtk_window_set_gravity()`,
+`gtk_window_move()`, `gtk_window_parse_geometry()`,
 `gtk_window_set_keep_above()`, `gtk_window_set_keep_below()`,
 `gtk_window_begin_resize_drag()`, `gtk_window_begin_move_drag()`.
 Most likely, you should just stop using them. In some cases, you can
 fall back to using the underlying `GdkToplevel` APIs (for example,
-[method@Gdk.Toplevel.begin_resize]).
+[`method@Gdk.Toplevel.begin_resize`]); alternatively, you will need to get
+the native windowing system surface from the `GtkWindow` and call platform
+specific API.

 The APIs for controlling `GtkWindow` size have changed to be better aligned
 with the way size changes are integrated in the frame cycle. `gtk_window_resize()`
 and `gtk_window_get_size()` have been removed. Instead, use
-[method@Gtk.Window.set_default_size] and [method@Gtk.Window.get_default_size].
+[`method@Gtk.Window.set_default_size`] and [`method@Gtk.Window.get_default_size`].

 ### Adapt to `GtkHeaderBar` and `GtkActionBar` API changes

@@ -1332,6 +1335,18 @@ pointer coordinates as inout arguments any more, but as normal in ones.

 See: [method@Gtk.TreeView.get_tooltip_context], [method@Gtk.IconView.get_tooltip_context]

+### Adapt to GtkPopover changes
+
+In GTK 3, a `GtkPopover` could be attached to any widget, using the `relative-to`
+property. This is no longer possible in GTK 4. The parent widget has to be aware
+of its popover children, and manage their size allocation. Therefore, only widgets
+with dedicated popover support can have them, such as [class@Gtk.MenuButton] or
+[class@Gtk.PopoverMenuBar].
+
+If you want to make a custom widget that has an attached popover, you need to call
+[method@Gtk.Popover.present] in your [vfunc@Gtk.Widget.size_allocate] vfunc, in order
+to update the positioning of the popover.
+
 ### Stop using GtkFileChooserButton

 The `GtkFileChooserButton` widget was removed, due to its shortcomings in
@@ -1,101 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE partintro PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-               ]>
-<partintro>
-<para>
-GTK is a library for creating graphical user interfaces. It
-works on many UNIX-like platforms, Windows, and OS X.
-GTK is released under the GNU Library General Public License
-(GNU LGPL), which allows for flexible licensing of client
-applications. GTK has a C-based object-oriented architecture that
-allows for maximum flexibility.  Bindings for many other languages have
-been written, including C++, Objective-C, Guile/Scheme, Perl, Python,
-TOM, Ada95, Free Pascal, and Eiffel.  The GTK library itself contains
-<firstterm>widgets</firstterm>, that is, GUI components such as GtkButton
-or GtkTextView.
-
-</para>
-<para>
-GTK depends on the following libraries:
-<variablelist>
-
-<varlistentry>
-<term>GLib</term>
-<listitem><para>
-A general-purpose utility library, not specific to graphical user interfaces.
-GLib provides many useful data types, macros, type conversions,
-string utilities, file utilities, a main loop abstraction, and so on.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>GObject</term>
-<listitem><para>A library that provides a type system, a collection of
-fundamental types including an object type, a signal system.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>GIO</term>
-<listitem><para>A modern, easy-to-use VFS API including abstractions for
-files, drives, volumes, stream IO, as well as network programming and
-DBus communication.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>cairo</term>
-<listitem><para>Cairo is a 2D graphics library with support for multiple
-output devices.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>Pango</term>
-<listitem><para>
-Pango is a library for internationalized text handling. It centers
-around the PangoLayout object, representing a paragraph of text.
-Pango provides the engine for GtkTextView, GtkLabel, GtkEntry, and
-other widgets that display text.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>GdkPixbuf</term>
-<listitem><para>
-This is a small library which allows you to create GdkPixbuf
-("pixel buffer") objects from image data or image files.
-Use a GdkPixbuf in combination with GtkImage to display images.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>graphene</term>
-<listitem><para>
-This is a small library which provides vector and matrix datatypes
-and operations. graphene provides optimized implementations using
-various SIMD instruction sets such as SSE.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>GDK</term>
-<listitem><para>
-GDK is the abstraction layer that allows GTK to support multiple
-windowing systems. GDK provides window system facilities on Wayland,
-X11, Windows, and OS X.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>GSK</term>
-<listitem><para>
-GSK is a library for creating a scene graph from render nodes,
-and rendering it using different rendering APIs. GSK provides renderers
-for OpenGL, Vulkan and cairo.
-</para></listitem>
-</varlistentry>
-</variablelist>
-</para>
-</partintro>
@@ -13,4 +13,5 @@ baseURLs = [
    [ 'Gtk', 'https://docs.gtk.org/gtk4/' ],
    [ 'Pango', 'https://docs.gtk.org/Pango/' ],
    [ 'PangoCairo', 'https://docs.gtk.org/PangoCairo/' ],
+    [ 'GdkPixbuf', 'https://docs.gtk.org/gdk-pixbuf/' ],
 ]
@@ -7,6 +7,10 @@
 struct _ExampleAppPrefs
 {
  GtkDialog parent;
+
+  GSettings *settings;
+  GtkWidget *font;
+  GtkWidget *transition;
 };

 G_DEFINE_TYPE (ExampleAppPrefs, example_app_prefs, GTK_TYPE_DIALOG)
@@ -15,20 +19,41 @@ static void
 example_app_prefs_init (ExampleAppPrefs *prefs)
 {
  gtk_widget_init_template (GTK_WIDGET (prefs));
+  prefs->settings = g_settings_new ("org.gtk.exampleapp");
+
+  g_settings_bind (prefs->settings, "font",
+                   prefs->font, "font",
+                   G_SETTINGS_BIND_DEFAULT);
+  g_settings_bind (prefs->settings, "transition",
+                   prefs->transition, "active-id",
+                   G_SETTINGS_BIND_DEFAULT);
+}
+
+static void
+example_app_prefs_dispose (GObject *object)
+{
+  ExampleAppPrefs *prefs;
+
+  prefs = EXAMPLE_APP_PREFS (object);
+
+  g_clear_object (&prefs->settings);
+
+  G_OBJECT_CLASS (example_app_prefs_parent_class)->dispose (object);
 }

 static void
 example_app_prefs_class_init (ExampleAppPrefsClass *class)
 {
+  G_OBJECT_CLASS (class)->dispose = example_app_prefs_dispose;
+
  gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
                                               "/org/gtk/exampleapp/prefs.ui");
+  gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppPrefs, font);
+  gtk_widget_class_bind_template_child (GTK_WIDGET_CLASS (class), ExampleAppPrefs, transition);
 }

 ExampleAppPrefs *
 example_app_prefs_new (ExampleAppWindow *win)
 {
-  return g_object_new (EXAMPLE_APP_PREFS_TYPE,
-                       "transient-for", win,
-                       "use-header-bar", TRUE,
-                       NULL);
+  return g_object_new (EXAMPLE_APP_PREFS_TYPE, "transient-for", win, "use-header-bar", TRUE, NULL);
 }
@@ -28,7 +28,6 @@
            </child>
            <child>
              <object class="GtkFontButton" id="font">
-              <property name="font" bind-settings-schema="org.gtk.exampleapp" bind-settings-key="font"/>
                <layout>
                  <property name="column">1</property>
                  <property name="row">0</property>
@@ -49,7 +48,6 @@
            </child>
            <child>
              <object class="GtkComboBoxText" id="transition">
-                <property name="active-id" bind-settings-schema="org.gtk.exampleapp" bind-settings-key="transition"/>
                <items>
                  <item translatable="yes" id="none">None</item>
                  <item translatable="yes" id="crossfade">Fade</item>
@@ -603,8 +603,8 @@ bloat_pad_startup (GApplication *application)
  g_object_unref (icon);
  g_bytes_unref (bytes);

-  icon = G_ICON (gdk_pixbuf_new_from_resource ("/org/gtk/libgtk/icons/16x16/actions/folder-new.png", NULL));
-  item = g_menu_item_new ("Pixbuf", NULL);
+  icon = G_ICON (gdk_texture_new_from_resource ("/org/gtk/libgtk/icons/16x16/actions/folder-new.png"));
+  item = g_menu_item_new ("Texture", NULL);
  g_menu_item_set_icon (item, icon);
  g_menu_append_item (menu, item);
  g_object_unref (item);
@@ -7,7 +7,7 @@
 #include <glib.h>
 #include <glib/gprintf.h>
 #include "gdktypes.h"
-#include "gdkinternals.h"
+#include "gdkdeviceprivate.h"
 #include <stdlib.h>
 #include <string.h>
 #include <errno.h>
@@ -609,56 +609,39 @@ open_shared_memory (void)
  return ret;
 }

-typedef struct {
-  int fd;
-  gsize size;
-} PngData;
-
-static cairo_status_t
-write_png_cb (void         *closure,
-              const guchar *data,
-              unsigned int  length)
-{
-  PngData *png_data = closure;
-  int fd = png_data->fd;
-
-  while (length)
-    {
-      gssize ret = write (fd, data, length);
-
-      if (ret <= 0)
-        return CAIRO_STATUS_WRITE_ERROR;
-
-      png_data->size += ret;
-      length -= ret;
-      data += ret;
-    }
-
-  return CAIRO_STATUS_SUCCESS;
-}
-
 guint32
 gdk_broadway_server_upload_texture (GdkBroadwayServer *server,
                                    GdkTexture        *texture)
 {
  guint32 id;
-  cairo_surface_t *surface = gdk_texture_download_surface (texture);
  BroadwayRequestUploadTexture msg;
-  PngData data;
+  GBytes *bytes;
+  const guchar *data;
+  gsize size;
+  int fd;

  id = server->next_texture_id++;

-  data.fd = open_shared_memory ();
-  data.size = 0;
-  cairo_surface_write_to_png_stream (surface, write_png_cb, &data);
+  bytes = gdk_texture_save_to_png_bytes (texture);
+  fd = open_shared_memory ();
+  data = g_bytes_get_data (bytes, &size);

-  msg.id = id;
-  msg.offset = 0;
-  msg.size = data.size;
+  while (size)
+    {
+      gssize ret = write (fd, data, size);
+
+      if (ret <= 0)
+        break;
+
+      size -= ret;
+      data += ret;
+    }
+
+  g_bytes_unref (bytes);

  /* This passes ownership of fd */
  gdk_broadway_server_send_fd_message (server, msg,
-                                       BROADWAY_REQUEST_UPLOAD_TEXTURE, data.fd);
+                                       BROADWAY_REQUEST_UPLOAD_TEXTURE, fd);

  return id;
 }
@@ -2,8 +2,10 @@
 #define __GDK_BROADWAY_SERVER__

 #include <gdk/gdktypes.h>
+
+#include "gdkdeviceprivate.h"
+
 #include "broadway-protocol.h"
-#include "gdkinternals.h"

 typedef struct _GdkBroadwayServer GdkBroadwayServer;
 typedef struct _GdkBroadwayServerClass GdkBroadwayServerClass;
@@ -34,6 +34,7 @@ gdk_broadway_cairo_context_dispose (GObject *object)

 static void
 gdk_broadway_cairo_context_begin_frame (GdkDrawContext *draw_context,
+                                        gboolean        prefers_high_depth,
                                        cairo_region_t *region)
 {
  GdkBroadwayCairoContext *self = GDK_BROADWAY_CAIRO_CONTEXT (draw_context);
@@ -30,7 +30,6 @@
 #include "gdkmonitor-broadway.h"
 #include "gdkseatdefaultprivate.h"
 #include "gdkdevice-broadway.h"
-#include "gdkinternals.h"
 #include "gdkdeviceprivate.h"
 #include <gdk/gdktextureprivate.h>
 #include "gdk-private.h"
@@ -214,7 +213,7 @@ _gdk_broadway_display_open (const char *display_name)
  broadway_display->server = _gdk_broadway_server_new (display, display_name, &error);
  if (broadway_display->server == NULL)
    {
-      g_printerr ("Unable to init Broadway server: %s\n", error->message);
+      GDK_NOTE (MISC, g_message ("Unable to init Broadway server: %s\n", error->message));
      g_error_free (error);
      return NULL;
    }
@@ -27,7 +27,6 @@
 #include "gdkdisplayprivate.h"
 #include "gdkkeys.h"
 #include "gdksurface.h"
-#include "gdkinternals.h"
 #include "gdkbroadway-server.h"
 #include "gdkmonitorprivate.h"

@@ -28,7 +28,6 @@

 #include "gdksurfaceprivate.h"
 #include "gdkprivate-broadway.h"
-#include "gdkinternals.h"
 #include "gdkdisplay-broadway.h"

 #include <string.h>
@@ -34,6 +34,7 @@ gdk_broadway_draw_context_dispose (GObject *object)

 static void
 gdk_broadway_draw_context_begin_frame (GdkDrawContext *draw_context,
+                                       gboolean        prefers_high_depth,
                                       cairo_region_t *region)
 {
  GdkBroadwayDrawContext *self = GDK_BROADWAY_DRAW_CONTEXT (draw_context);
@@ -19,8 +19,9 @@

 #include "gdkeventsource.h"

-#include "gdksurfaceprivate.h"
+#include "gdkeventsprivate.h"
 #include "gdkframeclockprivate.h"
+#include "gdksurfaceprivate.h"

 #include <stdlib.h>

@@ -25,7 +25,6 @@
 #include "config.h"

 #include "gdkprivate-broadway.h"
-#include "gdkinternals.h"
 #include "gdkdisplay-broadway.h"
 #include "gdkkeysprivate.h"
 #include "gdkkeysyms.h"
@@ -30,7 +30,6 @@
 #define __GDK_PRIVATE_BROADWAY_H__

 #include <gdk/gdkcursor.h>
-#include <gdk/gdkinternals.h>
 #include "gdksurface-broadway.h"
 #include "gdkdisplay-broadway.h"
 #include "gdkdrawcontext-broadway.h"
@@ -35,13 +35,12 @@
 #include "gdkdragsurfaceprivate.h"
 #include "gdkeventsource.h"
 #include "gdkframeclockidleprivate.h"
-#include "gdkinternals.h"
 #include "gdkpopupprivate.h"
 #include "gdkprivate-broadway.h"
+#include "gdkseatprivate.h"
 #include "gdksurfaceprivate.h"
 #include "gdktextureprivate.h"
 #include "gdktoplevelprivate.h"
-#include "gdk-private.h"

 #include <graphene.h>
 #include <stdlib.h>
@@ -27,7 +27,6 @@

 #include <gdk/gdksurfaceprivate.h>
 #include "gdkbroadwaysurface.h"
-#include "gdkinternals.h"

 G_BEGIN_DECLS

@@ -64,7 +64,7 @@ libgdk_broadway = static_library('gdk-broadway',

 # gtk4-broadwayd

-broadwayd_syslib = os_win32 ? find_library('ws2_32') : shmlib
+broadwayd_syslib = os_win32 ? cc.find_library('ws2_32') : shmlib

 executable('gtk4-broadwayd',
  sources: [
@@ -1,8 +1,7 @@
 #ifndef __GDK__PRIVATE_H__
 #define __GDK__PRIVATE_H__

-#include <gdk/gdk.h>
-#include "gdk/gdkinternals.h"
+#include "gdk/gdktypes.h"

 /* Private API for use in GTK+ */

@@ -29,14 +28,10 @@ gboolean gdk_should_use_portal (void);

 const char *   gdk_get_startup_notification_id (void);

-PangoDirection gdk_unichar_direction (gunichar    ch);
+PangoDirection gdk_unichar_direction (gunichar    ch) G_GNUC_CONST;
 PangoDirection gdk_find_base_dir     (const char *text,
                                      int         len);

-void           gdk_surface_set_widget (GdkSurface *surface,
-                                       gpointer    widget);
-gpointer       gdk_surface_get_widget (GdkSurface *surface);
-
 typedef struct
 {
  const char *key;
@@ -26,18 +26,14 @@

 #include "gdkversionmacros.h"

-#include "gdkinternals.h"
-#include "gdkintl.h"
-
 #include "gdkresources.h"

-#include "gdk-private.h"
-
 #include "gdkconstructor.h"
-
-#ifndef HAVE_XCONVERTCASE
-#include "gdkkeysyms.h"
-#endif
+#include "gdkdebug.h"
+#include "gdkdisplay.h"
+#include "gdkglcontextprivate.h"
+#include "gdkintl.h"
+#include "gdk-private.h"

 #include <string.h>
 #include <stdlib.h>
@@ -125,7 +121,7 @@ static const GdkDebugKey gdk_debug_keys[] = {
  { "gl-software",     GDK_DEBUG_GL_SOFTWARE, "Force OpenGL software rendering" },
  { "gl-texture-rect", GDK_DEBUG_GL_TEXTURE_RECT, "Use OpenGL texture rectangle extension" },
  { "gl-legacy",       GDK_DEBUG_GL_LEGACY, "Use a legacy OpenGL context" },
-  { "gl-gles",         GDK_DEBUG_GL_GLES, "Use a GLES OpenGL context" },
+  { "gl-gles",         GDK_DEBUG_GL_GLES, "Only allow OpenGL GLES API" },
  { "gl-debug",        GDK_DEBUG_GL_DEBUG, "Insert debugging information in OpenGL" },
  { "gl-egl",          GDK_DEBUG_GL_EGL, "Use EGL on X11 or Windows" },
  { "gl-glx",          GDK_DEBUG_GL_GLX, "Use GLX on X11" },
@@ -133,6 +129,7 @@ static const GdkDebugKey gdk_debug_keys[] = {
  { "vulkan-disable",  GDK_DEBUG_VULKAN_DISABLE, "Disable Vulkan support" },
  { "vulkan-validate", GDK_DEBUG_VULKAN_VALIDATE, "Load the Vulkan validation layer" },
  { "default-settings",GDK_DEBUG_DEFAULT_SETTINGS, "Force default values for xsettings", TRUE },
+  { "high-depth",      GDK_DEBUG_HIGH_DEPTH, "Use high bit depth rendering if possible", TRUE },
 };


@@ -299,6 +296,14 @@ gdk_pre_parse (void)
                                          gdk_debug_keys,
                                          G_N_ELEMENTS (gdk_debug_keys));

+  /* These are global */
+  if (GDK_DEBUG_CHECK (GL_EGL))
+    gdk_gl_backend_use (GDK_GL_EGL);
+  else if (GDK_DEBUG_CHECK (GL_GLX))
+    gdk_gl_backend_use (GDK_GL_GLX);
+  else if (GDK_DEBUG_CHECK (GL_WGL))
+    gdk_gl_backend_use (GDK_GL_WGL);
+
 #ifndef G_HAS_CONSTRUCTORS
  stash_desktop_startup_notification_id ();
 #endif
@@ -32,7 +32,7 @@ G_BEGIN_DECLS

 #define GDK_TYPE_APP_LAUNCH_CONTEXT         (gdk_app_launch_context_get_type ())
 #define GDK_APP_LAUNCH_CONTEXT(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), GDK_TYPE_APP_LAUNCH_CONTEXT, GdkAppLaunchContext))
-        #define GDK_IS_APP_LAUNCH_CONTEXT(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_APP_LAUNCH_CONTEXT))
+#define GDK_IS_APP_LAUNCH_CONTEXT(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_APP_LAUNCH_CONTEXT))


 GDK_AVAILABLE_IN_ALL
@@ -17,9 +17,7 @@

 #include "config.h"

-#include "gdkcairo.h"
-
-#include "gdkinternals.h"
+#include "gdkcairoprivate.h"

 #include <math.h>

@@ -93,11 +91,7 @@ void
 gdk_cairo_surface_paint_pixbuf (cairo_surface_t *surface,
                                const GdkPixbuf *pixbuf)
 {
-  int width, height;
-  guchar *gdk_pixels, *cairo_pixels;
-  int gdk_rowstride, cairo_stride;
-  int n_channels;
-  int j;
+  GdkTexture *texture;

  if (cairo_surface_status (surface) != CAIRO_STATUS_SUCCESS)
    return;
@@ -113,71 +107,11 @@ gdk_cairo_surface_paint_pixbuf (cairo_surface_t *surface,

  cairo_surface_flush (surface);

-  width = gdk_pixbuf_get_width (pixbuf);
-  height = gdk_pixbuf_get_height (pixbuf);
-  gdk_pixels = gdk_pixbuf_get_pixels (pixbuf);
-  gdk_rowstride = gdk_pixbuf_get_rowstride (pixbuf);
-  n_channels = gdk_pixbuf_get_n_channels (pixbuf);
-  cairo_stride = cairo_image_surface_get_stride (surface);
-  cairo_pixels = cairo_image_surface_get_data (surface);
-
-  for (j = height; j; j--)
-    {
-      guchar *p = gdk_pixels;
-      guchar *q = cairo_pixels;
-
-      if (n_channels == 3)
-        {
-          guchar *end = p + 3 * width;
-
-          while (p < end)
-            {
-#if G_BYTE_ORDER == G_LITTLE_ENDIAN
-              q[0] = p[2];
-              q[1] = p[1];
-              q[2] = p[0];
-              q[3] = 0xFF;
-#else
-              q[0] = 0xFF;
-              q[1] = p[0];
-              q[2] = p[1];
-              q[3] = p[2];
-#endif
-              p += 3;
-              q += 4;
-            }
-        }
-      else
-        {
-          guchar *end = p + 4 * width;
-          guint t1,t2,t3;
-
-#define MULT(d,c,a,t) G_STMT_START { t = c * a + 0x80; d = ((t >> 8) + t) >> 8; } G_STMT_END
-
-          while (p < end)
-            {
-#if G_BYTE_ORDER == G_LITTLE_ENDIAN
-              MULT(q[0], p[2], p[3], t1);
-              MULT(q[1], p[1], p[3], t2);
-              MULT(q[2], p[0], p[3], t3);
-              q[3] = p[3];
-#else
-              q[0] = p[3];
-              MULT(q[1], p[0], p[3], t1);
-              MULT(q[2], p[1], p[3], t2);
-              MULT(q[3], p[2], p[3], t3);
-#endif
-
-              p += 4;
-              q += 4;
-            }
-
-#undef MULT
-        }
-
-      gdk_pixels += gdk_rowstride;
-      cairo_pixels += cairo_stride;
-    }
+  texture = gdk_texture_new_for_pixbuf (GDK_PIXBUF (pixbuf));
+  gdk_texture_download (texture,
+                        cairo_image_surface_get_data (surface),
+                        cairo_image_surface_get_stride (surface));
+  g_object_unref (texture);

  cairo_surface_mark_dirty (surface);
 }
@@ -50,7 +50,7 @@ cairo_region_t *
           gdk_cairo_region_create_from_surface
                                        (cairo_surface_t      *surface);

-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_4_6_FOR(gdk_gl_texture_new)
 void       gdk_cairo_draw_from_gl (cairo_t              *cr,
                                   GdkSurface            *surface,
                                   int                   source,
@@ -25,7 +25,6 @@
 #include "gdkcairocontextprivate.h"

 #include "gdkcairo.h"
-#include "gdkinternals.h"

 /**
 * GdkCairoContext:
@@ -18,6 +18,8 @@
 #ifndef __GDK_CAIRO_PRIVATE_H__
 #define __GDK_CAIRO_PRIVATE_H__

+#include "gdkcairo.h"
+
 #include <gdk-pixbuf/gdk-pixbuf.h>
 #include <cairo.h>

@@ -25,6 +25,8 @@
 #include "filetransferportalprivate.h"
 #include "gdktexture.h"
 #include "gdkrgbaprivate.h"
+#include "loaders/gdkpngprivate.h"
+#include "loaders/gdktiffprivate.h"

 #include <gdk-pixbuf/gdk-pixbuf.h>

@@ -655,6 +657,56 @@ pixbuf_deserializer (GdkContentDeserializer *deserializer)
                                    deserializer);
 }

+static void
+texture_deserializer_finish (GObject      *source,
+                             GAsyncResult *result,
+                             gpointer      deserializer)
+{
+  GOutputStream *stream = G_OUTPUT_STREAM (source);
+  GBytes *bytes;
+  GError *error = NULL;
+  GdkTexture *texture = NULL;
+  gssize written;
+
+  written = g_output_stream_splice_finish (stream, result, &error);
+  if (written < 0)
+    {
+      gdk_content_deserializer_return_error (deserializer, error);
+      return;
+    }
+
+  bytes = g_memory_output_stream_steal_as_bytes (G_MEMORY_OUTPUT_STREAM (stream));
+
+  texture = gdk_texture_new_from_bytes (bytes, &error);
+  g_bytes_unref (bytes);
+  if (texture == NULL)
+    {
+      gdk_content_deserializer_return_error (deserializer, error);
+      return;
+    }
+
+  g_value_take_object (gdk_content_deserializer_get_value (deserializer), texture);
+  gdk_content_deserializer_return_success (deserializer);
+}
+
+static void
+texture_deserializer (GdkContentDeserializer *deserializer)
+{
+  GOutputStream *output;
+
+  output = g_memory_output_stream_new_resizable ();
+
+  g_output_stream_splice_async (output,
+                                gdk_content_deserializer_get_input_stream (deserializer),
+                                G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE
+                                | G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET,
+                                gdk_content_deserializer_get_priority (deserializer),
+                                gdk_content_deserializer_get_cancellable (deserializer),
+                                texture_deserializer_finish,
+                                deserializer);
+  g_object_unref (output);
+}
+
 static void
 string_deserializer_finish (GObject      *source,
                            GAsyncResult *result,
@@ -863,48 +915,71 @@ init (void)

  initialized = TRUE;

+  gdk_content_register_deserializer ("image/png",
+                                     GDK_TYPE_TEXTURE,
+                                     texture_deserializer,
+                                     NULL,
+                                     NULL);
+  gdk_content_register_deserializer ("image/tiff",
+                                     GDK_TYPE_TEXTURE,
+                                     texture_deserializer,
+                                     NULL,
+                                     NULL);
+  gdk_content_register_deserializer ("image/jpeg",
+                                     GDK_TYPE_TEXTURE,
+                                     texture_deserializer,
+                                     NULL,
+                                     NULL);
+
+
  formats = gdk_pixbuf_get_formats ();

  /* Make sure png comes first */
  for (f = formats; f; f = f->next)
    {
      GdkPixbufFormat *fmt = f->data;
-      char *name; 
- 
+      char *name;
+
      name = gdk_pixbuf_format_get_name (fmt);
      if (g_str_equal (name, "png"))
-	{
-	  formats = g_slist_delete_link (formats, f);
-	  formats = g_slist_prepend (formats, fmt);
+        {
+          formats = g_slist_delete_link (formats, f);
+          formats = g_slist_prepend (formats, fmt);

-	  g_free (name);
-
-	  break;
-	}
+          g_free (name);
+          break;
+        }

      g_free (name);
-    }  
+    }

  for (f = formats; f; f = f->next)
    {
      GdkPixbufFormat *fmt = f->data;
      char **mimes, **m;
+      char *name;

+      name = gdk_pixbuf_format_get_name (fmt);
      mimes = gdk_pixbuf_format_get_mime_types (fmt);
      for (m = mimes; *m; m++)
-	{
-          gdk_content_register_deserializer (*m,
-                                             GDK_TYPE_TEXTURE,
-                                             pixbuf_deserializer,
-                                             NULL,
-                                             NULL);
+        {
+          /* Turning pngs, jpegs and tiffs into textures is handled above */
+          if (!g_str_equal (name, "png") &&
+              !g_str_equal (name, "jpeg") &&
+              !g_str_equal (name, "tiff"))
+            gdk_content_register_deserializer (*m,
+                                               GDK_TYPE_TEXTURE,
+                                               pixbuf_deserializer,
+                                               NULL,
+                                               NULL);
          gdk_content_register_deserializer (*m,
                                             GDK_TYPE_PIXBUF,
                                             pixbuf_deserializer,
                                             NULL,
                                             NULL);
-	}
+        }
      g_strfreev (mimes);
+      g_free (name);
    }

  g_slist_free (formats);
@@ -933,11 +1008,13 @@ init (void)
  if (!g_get_charset (&charset))
    {
      char *mime = g_strdup_printf ("text/plain;charset=%s", charset);
+
      gdk_content_register_deserializer (mime,
                                         G_TYPE_STRING,
                                         string_deserializer,
                                         (gpointer) charset,
                                         g_free);
+      g_free (mime);
    }
  gdk_content_register_deserializer ("text/plain",
                                     G_TYPE_STRING,
@@ -808,8 +808,13 @@ gdk_content_formats_builder_add_mime_type (GdkContentFormatsBuilder *builder,
  builder->n_mime_types++;
 }

-/* G_DEFINE_BOXED wants this */
-typedef gpointer GdkFileList;
+/* {{{ GdkFileList */
+
+/* We're using GdkFileList* and GSList* interchangeably, counting on the
+ * fact that we're just passing around gpointers; the only reason why we
+ * have a GdkFileList opaque type is for language bindings, because they
+ * can have no idea what a GSList of GFiles is.
+ */

 static gpointer
 gdk_file_list_copy (gpointer list)
@@ -824,3 +829,23 @@ gdk_file_list_free (gpointer list)
 }

 G_DEFINE_BOXED_TYPE (GdkFileList, gdk_file_list, gdk_file_list_copy, gdk_file_list_free)
+
+/**
+ * gdk_file_list_get_files:
+ * @file_list: the file list
+ *
+ * Retrieves the list of files inside a `GdkFileList`.
+ *
+ * This function is meant for language bindings.
+ *
+ * Returns: (transfer container) (element-type GFile): the files inside the list
+ *
+ * Since: 4.6
+ */
+GSList *
+gdk_file_list_get_files (GdkFileList *file_list)
+{
+  return g_slist_copy ((GSList *) file_list);
+}
+
+/* }}} */
@@ -109,8 +109,19 @@ void                    gdk_content_formats_builder_add_gtype   (GdkContentForma
 /* dunno where else to put this */
 #define GDK_TYPE_FILE_LIST (gdk_file_list_get_type ())
 GDK_AVAILABLE_IN_ALL
-GType     gdk_file_list_get_type  (void) G_GNUC_CONST;
+GType gdk_file_list_get_type (void) G_GNUC_CONST;

+/**
+ * GdkFileList:
+ *
+ * An opaque type representing a list of files.
+ *
+ * Since: 4.6
+ */
+typedef struct _GdkFileList GdkFileList;
+
+GDK_AVAILABLE_IN_4_6
+GSList *        gdk_file_list_get_files (GdkFileList *file_list);

 G_END_DECLS

@@ -26,6 +26,10 @@
 #include "filetransferportalprivate.h"
 #include "gdktextureprivate.h"
 #include "gdkrgba.h"
+#include "loaders/gdkpngprivate.h"
+#include "loaders/gdktiffprivate.h"
+#include "loaders/gdkjpegprivate.h"
+#include "gdkmemorytextureprivate.h"

 #include <gdk-pixbuf/gdk-pixbuf.h>
 #include <string.h>
@@ -606,6 +610,7 @@ gdk_content_serialize_finish (GAsyncResult  *result,

 /*** SERIALIZERS ***/

+
 static void
 pixbuf_serializer_finish (GObject      *source,
                          GAsyncResult *res,
@@ -636,11 +641,7 @@ pixbuf_serializer (GdkContentSerializer *serializer)
  else if (G_VALUE_HOLDS (value, GDK_TYPE_TEXTURE))
    {
      GdkTexture *texture = g_value_get_object (value);
-      cairo_surface_t *surface = gdk_texture_download_surface (texture);
-      pixbuf = gdk_pixbuf_get_from_surface (surface,
-                                            0, 0,
-                                            gdk_texture_get_width (texture), gdk_texture_get_height (texture));
-      cairo_surface_destroy (surface);
+      pixbuf = gdk_pixbuf_get_from_texture (texture);
    }
  else
    {
@@ -658,6 +659,77 @@ pixbuf_serializer (GdkContentSerializer *serializer)
  g_object_unref (pixbuf);
 }

+static void
+texture_serializer_finish (GObject      *source,
+                           GAsyncResult *res,
+                           gpointer      user_data)
+{
+  GdkContentSerializer *serializer = GDK_CONTENT_SERIALIZER (source);
+  GError *error = NULL;
+
+  if (!g_task_propagate_boolean (G_TASK (res), &error))
+    gdk_content_serializer_return_error (serializer, error);
+  else
+    gdk_content_serializer_return_success (serializer);
+}
+
+static void
+serialize_texture_in_thread (GTask        *task,
+                             gpointer      source_object,
+                             gpointer      task_data,
+                             GCancellable *cancellable)
+{
+  GdkContentSerializer *serializer = source_object;
+  const GValue *value;
+  GdkTexture *texture;
+  GBytes *bytes = NULL;
+  GError *error = NULL;
+  gboolean result = FALSE;
+  GInputStream *input;
+  gssize spliced;
+
+  value = gdk_content_serializer_get_value (serializer);
+  texture = g_value_get_object (value);
+
+  if (strcmp (gdk_content_serializer_get_mime_type (serializer), "image/png") == 0)
+    bytes = gdk_save_png (texture);
+  else if (strcmp (gdk_content_serializer_get_mime_type (serializer), "image/tiff") == 0)
+    bytes = gdk_save_tiff (texture);
+  else if (strcmp (gdk_content_serializer_get_mime_type (serializer), "image/jpeg") == 0)
+    bytes = gdk_save_jpeg (texture);
+  else
+    g_assert_not_reached ();
+
+  input = g_memory_input_stream_new_from_bytes (bytes);
+  spliced = g_output_stream_splice (gdk_content_serializer_get_output_stream (serializer),
+                                    input,
+                                    G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE,
+                                    gdk_content_serializer_get_cancellable (serializer),
+                                    &error);
+  g_object_unref (input);
+  g_bytes_unref (bytes);
+
+  result = spliced != -1;
+
+  if (result)
+    g_task_return_boolean (task, result);
+  else
+    g_task_return_error (task, error);
+}
+
+static void
+texture_serializer (GdkContentSerializer *serializer)
+{
+  GTask *task;
+
+  task = g_task_new (serializer,
+                     gdk_content_serializer_get_cancellable (serializer),
+                     texture_serializer_finish,
+                     NULL);
+  g_task_run_in_thread (task, serialize_texture_in_thread);
+  g_object_unref (task);
+}
+
 static void
 string_serializer_finish (GObject      *source,
                          GAsyncResult *result,
@@ -877,51 +949,72 @@ init (void)

  initialized = TRUE;

+  gdk_content_register_serializer (GDK_TYPE_TEXTURE,
+                                   "image/png",
+                                   texture_serializer,
+                                   NULL, NULL);
+
+  gdk_content_register_serializer (GDK_TYPE_TEXTURE,
+                                   "image/tiff",
+                                   texture_serializer,
+                                   NULL, NULL);
+
+  gdk_content_register_serializer (GDK_TYPE_TEXTURE,
+                                   "image/jpeg",
+                                   texture_serializer,
+                                   NULL, NULL);
+
  formats = gdk_pixbuf_get_formats ();

  /* Make sure png comes first */
  for (f = formats; f; f = f->next)
    {
      GdkPixbufFormat *fmt = f->data;
-      char *name; 
- 
+      char *name;
+
      name = gdk_pixbuf_format_get_name (fmt);
      if (g_str_equal (name, "png"))
-	{
-	  formats = g_slist_delete_link (formats, f);
-	  formats = g_slist_prepend (formats, fmt);
+        {
+          formats = g_slist_delete_link (formats, f);
+          formats = g_slist_prepend (formats, fmt);

-	  g_free (name);
-
-	  break;
-	}
+          g_free (name);
+          break;
+        }

      g_free (name);
-    }  
+    }

  for (f = formats; f; f = f->next)
    {
      GdkPixbufFormat *fmt = f->data;
      char **mimes, **m;
+      char *name;

      if (!gdk_pixbuf_format_is_writable (fmt))
-	continue;
+        continue;

+      name = gdk_pixbuf_format_get_name (fmt);
      mimes = gdk_pixbuf_format_get_mime_types (fmt);
      for (m = mimes; *m; m++)
-	{
-          gdk_content_register_serializer (GDK_TYPE_TEXTURE,
-                                           *m,
-                                           pixbuf_serializer,
-                                           gdk_pixbuf_format_get_name (fmt),
-                                           g_free);
+        {
+          /* Turning textures into pngs, tiffs or jpegs is handled above */
+          if (!g_str_equal (name, "png") &&
+              !g_str_equal (name, "tiff") &&
+              !g_str_equal (name, "jpeg"))
+            gdk_content_register_serializer (GDK_TYPE_TEXTURE,
+                                             *m,
+                                             pixbuf_serializer,
+                                             gdk_pixbuf_format_get_name (fmt),
+                                             g_free);
          gdk_content_register_serializer (GDK_TYPE_PIXBUF,
                                           *m,
                                           pixbuf_serializer,
                                           gdk_pixbuf_format_get_name (fmt),
                                           g_free);
-	}
+        }
      g_strfreev (mimes);
+      g_free (name);
    }

  g_slist_free (formats);
@@ -31,7 +31,6 @@
 #include "gdkcursorprivate.h"
 #include "gdktexture.h"
 #include "gdkintl.h"
-#include "gdkinternals.h"

 #include <math.h>
 #include <errno.h>
@@ -18,8 +18,11 @@
 #ifndef __GDK_DEBUG_H__
 #define __GDK_DEBUG_H__

-G_BEGIN_DECLS
+#include <glib.h>

+#include "gdktypes.h"
+
+G_BEGIN_DECLS

 typedef enum {
  GDK_DEBUG_MISC            = 1 <<  0,
@@ -47,6 +50,7 @@ typedef enum {
  GDK_DEBUG_VULKAN_DISABLE  = 1 << 21,
  GDK_DEBUG_VULKAN_VALIDATE = 1 << 22,
  GDK_DEBUG_DEFAULT_SETTINGS= 1 << 23,
+  GDK_DEBUG_HIGH_DEPTH      = 1 << 24,
 } GdkDebugFlags;

 extern guint _gdk_debug_flags;
@@ -22,7 +22,6 @@
 #include "gdkdeviceprivate.h"
 #include "gdkdevicetool.h"
 #include "gdkdisplayprivate.h"
-#include "gdkinternals.h"
 #include "gdkintl.h"
 #include "gdkkeysprivate.h"

@@ -331,7 +330,7 @@ gdk_device_class_init (GdkDeviceClass *klass)
   * GdkDevice::changed:
   * @device: the `GdkDevice`
   *
-   * Emitted either when the the number of either axes or keys changes.
+   * Emitted either when the number of either axes or keys changes.
   *
   * On X11 this will normally happen when the physical device
   * routing events through the logical device changes (for
@@ -20,7 +20,7 @@
 #include <math.h>

 #include "gdkdevicetoolprivate.h"
-#include "gdkinternals.h"
+#include "gdkenumtypes.h"
 #include "gdkintl.h"

 /**
@@ -27,16 +27,20 @@
 #include "gdkintl.h"
 #include "gdk-private.h"

+#include "gdkapplaunchcontext.h"
 #include "gdkclipboardprivate.h"
 #include "gdkdeviceprivate.h"
 #include "gdkdisplaymanagerprivate.h"
-#include "gdkevents.h"
-#include "gdkinternals.h"
-#include "gdkmonitorprivate.h"
 #include "gdkframeclockidleprivate.h"
+#include "gdkeventsprivate.h"
+#include "gdkglcontextprivate.h"
+#include "gdkmonitorprivate.h"

+#ifdef HAVE_EGL
+#include <epoxy/egl.h>
+#endif
 #include <math.h>
-#include <glib.h>
+#include <stdlib.h>

 /**
 * GdkDisplay:
@@ -87,6 +91,12 @@ struct _GdkDisplayPrivate {
  GdkGLContext *gl_context;
  GError *gl_error;

+#ifdef HAVE_EGL
+  EGLDisplay egl_display;
+  EGLConfig egl_config;
+  EGLConfig egl_config_high_depth;
+#endif
+
  guint rgba : 1;
  guint composited : 1;
  guint input_shapes : 1;
@@ -146,6 +156,26 @@ gdk_display_default_init_gl (GdkDisplay  *display,
  return NULL;
 }

+static guint
+gdk_display_default_rate_egl_config (GdkDisplay *display,
+                                     gpointer    egl_display,
+                                     gpointer    config)
+{
+  guint distance = 0;
+#ifdef HAVE_EGL
+  int tmp;
+
+  if (!eglGetConfigAttrib (egl_display, config, EGL_SAMPLE_BUFFERS, &tmp) || tmp != 0)
+    distance += 0x20000;
+
+  if (!eglGetConfigAttrib (egl_display, config, EGL_DEPTH_SIZE, &tmp) || tmp != 0 ||
+      !eglGetConfigAttrib (egl_display, config, EGL_STENCIL_SIZE, &tmp) || tmp != 0)
+    distance += 0x10000;
+#endif
+
+  return distance;
+}
+    
 static GdkSeat *
 gdk_display_real_get_default_seat (GdkDisplay *display)
 {
@@ -173,6 +203,7 @@ gdk_display_class_init (GdkDisplayClass *class)
  class->make_default = gdk_display_real_make_default;
  class->get_app_launch_context = gdk_display_real_get_app_launch_context;
  class->init_gl = gdk_display_default_init_gl;
+  class->rate_egl_config = gdk_display_default_rate_egl_config;
  class->get_default_seat = gdk_display_real_get_default_seat;
  class->opened = gdk_display_real_opened;

@@ -352,6 +383,9 @@ gdk_display_dispose (GObject *object)
  g_queue_clear (&display->queued_events);

  g_clear_object (&priv->gl_context);
+#ifdef HAVE_EGL
+  g_clear_pointer (&priv->egl_display, eglTerminate);
+#endif
  g_clear_error (&priv->gl_error);

  G_OBJECT_CLASS (gdk_display_parent_class)->dispose (object);
@@ -1233,6 +1267,8 @@ gdk_display_init_gl (GdkDisplay *self)
   */
  priv->gl_context = context;

+  gdk_gl_backend_use (GDK_GL_CONTEXT_GET_CLASS (context)->backend_type);
+
  gdk_profiler_end_mark (before, "initialize OpenGL", NULL);
 }

@@ -1289,6 +1325,38 @@ gdk_display_prepare_gl (GdkDisplay  *self,
    }
 }

+/**
+ * gdk_display_create_gl_context:
+ * @self: a `GdkDisplay`
+ * @error: return location for an error
+ *
+ * Creates a new `GdkGLContext` for the `GdkDisplay`.
+ *
+ * The context is disconnected from any particular surface or surface
+ * and cannot be used to draw to any surface. It can only be used to
+ * draw to non-surface framebuffers like textures.
+ *
+ * If the creation of the `GdkGLContext` failed, @error will be set.
+ * Before using the returned `GdkGLContext`, you will need to
+ * call [method@Gdk.GLContext.make_current] or [method@Gdk.GLContext.realize].
+ *
+ * Returns: (transfer full) (nullable): the newly created `GdkGLContext`
+ *
+ * Since: 4.6
+ */
+GdkGLContext *
+gdk_display_create_gl_context (GdkDisplay  *self,
+                               GError     **error)
+{
+  g_return_val_if_fail (GDK_IS_DISPLAY (self), NULL);
+  g_return_val_if_fail (error == NULL || *error == NULL, NULL);
+
+  if (!gdk_display_prepare_gl (self, error))
+    return NULL;
+
+  return gdk_gl_context_new (self, NULL);
+}
+
 /*< private >
 * gdk_display_get_gl_context:
 * @self: the `GdkDisplay`
@@ -1310,6 +1378,417 @@ gdk_display_get_gl_context (GdkDisplay *self)
  return priv->gl_context;
 }

+#ifdef HAVE_EGL
+#ifdef G_ENABLE_DEBUG
+static int
+strvcmp (gconstpointer p1,
+         gconstpointer p2)
+{
+  const char * const *s1 = p1;
+  const char * const *s2 = p2;
+
+  return strcmp (*s1, *s2);
+}
+
+static char *
+describe_extensions (EGLDisplay egl_display)
+{
+  const char *extensions;
+  char **exts;
+  char *ext;
+
+  extensions = eglQueryString (egl_display, EGL_EXTENSIONS);
+
+  exts = g_strsplit (extensions, " ", -1);
+  qsort (exts, g_strv_length (exts), sizeof (char *), strvcmp);
+
+  ext = g_strjoinv ("\n\t", exts);
+  if (ext[0] == '\n')
+    ext[0] = ' ';
+
+  g_strfreev (exts);
+
+  return g_strstrip (ext);
+}
+
+static char *
+describe_egl_config (EGLDisplay egl_display,
+                     EGLConfig  egl_config)
+{
+  EGLint red, green, blue, alpha, type;
+
+  if (egl_config == NULL)
+    return g_strdup ("-");
+
+  if (!eglGetConfigAttrib (egl_display, egl_config, EGL_RED_SIZE, &red) ||
+      !eglGetConfigAttrib (egl_display, egl_config, EGL_GREEN_SIZE, &green) ||
+      !eglGetConfigAttrib (egl_display, egl_config, EGL_BLUE_SIZE, &blue) ||
+      !eglGetConfigAttrib (egl_display, egl_config, EGL_ALPHA_SIZE, &alpha))
+    return g_strdup ("Unknown");
+
+  if (epoxy_has_egl_extension (egl_display, "EGL_EXT_pixel_format_float"))
+    {
+      if (!eglGetConfigAttrib (egl_display, egl_config, EGL_COLOR_COMPONENT_TYPE_EXT, &type))
+        type = EGL_COLOR_COMPONENT_TYPE_FIXED_EXT;
+    }
+  else
+    type = EGL_COLOR_COMPONENT_TYPE_FIXED_EXT;
+
+  return g_strdup_printf ("R%dG%dB%dA%d%s", red, green, blue, alpha, type == EGL_COLOR_COMPONENT_TYPE_FIXED_EXT ? "" : " float");
+}
+#endif
+
+/*<private>
+ * gdk_display_get_egl_display:
+ * @self: a display
+ *
+ * Retrieves the EGL display connection object for the given GDK display.
+ *
+ * This function returns `NULL` if GL is not supported or GDK is using
+ * a different OpenGL framework than EGL.
+ *
+ * Returns: (nullable): the EGL display object
+ */
+gpointer
+gdk_display_get_egl_display (GdkDisplay *self)
+{
+  GdkDisplayPrivate *priv = gdk_display_get_instance_private (self);
+
+  g_return_val_if_fail (GDK_IS_DISPLAY (self), NULL);
+
+  if (!priv->egl_display &&
+      !gdk_display_prepare_gl (self, NULL))
+    return NULL;
+
+  return priv->egl_display;
+}
+
+gpointer
+gdk_display_get_egl_config (GdkDisplay *self)
+{
+  GdkDisplayPrivate *priv = gdk_display_get_instance_private (self);
+
+  return priv->egl_config;
+}
+
+gpointer
+gdk_display_get_egl_config_high_depth (GdkDisplay *self)
+{
+  GdkDisplayPrivate *priv = gdk_display_get_instance_private (self);
+
+  return priv->egl_config_high_depth;
+}
+
+static EGLDisplay
+gdk_display_create_egl_display (EGLenum  platform,
+                                gpointer native_display)
+{
+  G_GNUC_UNUSED gint64 start_time = GDK_PROFILER_CURRENT_TIME;
+  EGLDisplay egl_display = NULL;
+
+  if (epoxy_has_egl_extension (NULL, "EGL_KHR_platform_base"))
+    {
+      PFNEGLGETPLATFORMDISPLAYPROC getPlatformDisplay =
+        (void *) eglGetProcAddress ("eglGetPlatformDisplay");
+
+      if (getPlatformDisplay != NULL)
+        egl_display = getPlatformDisplay (platform, native_display, NULL);
+      if (egl_display != NULL)
+        goto out;
+    }
+
+  if (epoxy_has_egl_extension (NULL, "EGL_EXT_platform_base"))
+    {
+      PFNEGLGETPLATFORMDISPLAYEXTPROC getPlatformDisplay =
+        (void *) eglGetProcAddress ("eglGetPlatformDisplayEXT");
+
+      if (getPlatformDisplay != NULL)
+        egl_display = getPlatformDisplay (platform, native_display, NULL);
+      if (egl_display != NULL)
+        goto out;
+    }
+
+  egl_display = eglGetDisplay ((EGLNativeDisplayType) native_display);
+
+out:
+  gdk_profiler_end_mark (start_time, "Create EGL display", NULL);
+
+  return egl_display;
+}
+
+#define MAX_EGL_ATTRS 30
+
+typedef enum {
+  GDK_EGL_CONFIG_PERFECT = (1 << 0),
+  GDK_EGL_CONFIG_HDR     = (1 << 1),
+} GdkEGLConfigCreateFlags;
+
+static EGLConfig
+gdk_display_create_egl_config (GdkDisplay               *self,
+                               GdkEGLConfigCreateFlags   flags,
+                               GError                  **error)
+{
+  GdkDisplayPrivate *priv = gdk_display_get_instance_private (self);
+  G_GNUC_UNUSED gint64 start_time = GDK_PROFILER_CURRENT_TIME;
+  EGLint attrs[MAX_EGL_ATTRS];
+  EGLConfig *configs;
+  EGLint count, alloced;
+  EGLConfig best_config;
+  guint best_score;
+
+  int i = 0;
+
+  attrs[i++] = EGL_SURFACE_TYPE;
+  attrs[i++] = EGL_WINDOW_BIT;
+
+  attrs[i++] = EGL_COLOR_BUFFER_TYPE;
+  attrs[i++] = EGL_RGB_BUFFER;
+
+  attrs[i++] = EGL_RED_SIZE;
+  attrs[i++] = (flags & GDK_EGL_CONFIG_HDR) ? 9 : 8;
+  attrs[i++] = EGL_GREEN_SIZE;
+  attrs[i++] = (flags & GDK_EGL_CONFIG_HDR) ? 9 : 8;
+  attrs[i++] = EGL_BLUE_SIZE;
+  attrs[i++] = (flags & GDK_EGL_CONFIG_HDR) ? 9 : 8;
+  attrs[i++] = EGL_ALPHA_SIZE;
+  attrs[i++] = 8;
+
+  if (flags & GDK_EGL_CONFIG_HDR &&
+      self->have_egl_pixel_format_float)
+    {
+      attrs[i++] = EGL_COLOR_COMPONENT_TYPE_EXT;
+      attrs[i++] = EGL_DONT_CARE;
+    }
+
+  attrs[i++] = EGL_NONE;
+  g_assert (i < MAX_EGL_ATTRS);
+
+  if (!eglChooseConfig (priv->egl_display, attrs, NULL, -1, &alloced) || alloced == 0)
+    {
+      g_set_error_literal (error, GDK_GL_ERROR, GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("No EGL configuration available"));
+      return NULL;
+    }
+
+  configs = g_new (EGLConfig, alloced);
+  if (!eglChooseConfig (priv->egl_display, attrs, configs, alloced, &count))
+    {
+      g_set_error_literal (error, GDK_GL_ERROR, GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("Failed to get EGL configurations"));
+      return NULL;
+    }
+  g_warn_if_fail (alloced == count);
+
+  best_score = G_MAXUINT;
+  best_config = NULL;
+
+  for (i = 0; i < count; i++)
+    {
+      guint score = GDK_DISPLAY_GET_CLASS (self)->rate_egl_config (self, priv->egl_display, configs[i]);
+
+      if (score < best_score)
+        {
+          best_score = score;
+          best_config = configs[i];
+        }
+
+      if (score == 0)
+        break;
+    }
+
+  g_free (configs);
+
+  gdk_profiler_end_mark (start_time, "Create EGL config", NULL);
+
+  if (best_score == G_MAXUINT)
+    {
+      g_set_error_literal (error, GDK_GL_ERROR,
+                           GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("No EGL configuration with required features found"));
+      return NULL;
+    }
+  else if ((flags & GDK_EGL_CONFIG_PERFECT) && best_score != 0)
+    {
+      g_set_error_literal (error, GDK_GL_ERROR,
+                           GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("No perfect EGL configuration found"));
+      return NULL;
+    }
+
+  return best_config;
+}
+
+#undef MAX_EGL_ATTRS
+
+static gboolean
+gdk_display_check_egl_extensions (EGLDisplay   egl_display,
+                                  const char **extensions,
+                                  GError     **error)
+{
+  GString *missing = NULL;
+  gsize i, n_missing;
+
+  n_missing = 0;
+
+  for (i = 0; extensions[i] != NULL; i++)
+    {
+      if (!epoxy_has_egl_extension (egl_display, extensions[i]))
+        {
+          if (missing == NULL)
+            {
+              missing = g_string_new (extensions[i]);
+            }
+          else
+            {
+              g_string_append (missing, ", ");
+              g_string_append (missing, extensions[i]);
+            }
+          n_missing++;
+        }
+    }
+
+  if (n_missing)
+    {
+      g_set_error (error, GDK_GL_ERROR, GDK_GL_ERROR_UNSUPPORTED_PROFILE,
+                   /* translators: Arguments are the number of missing extensions
+                    * followed by a comma-separated list of their names */
+                   g_dngettext (GETTEXT_PACKAGE,
+                                "EGL implementation is missing extension %2$s",
+                                "EGL implementation is missing %d extensions: %s",
+                                n_missing),
+                   (int) n_missing, missing->str);
+
+      g_string_free (missing, TRUE);
+      return FALSE;
+    }
+
+  return TRUE;
+}
+
+gboolean
+gdk_display_init_egl (GdkDisplay  *self,
+                      int          platform,
+                      gpointer     native_display,
+                      gboolean     allow_any,
+                      GError     **error)
+{
+  GdkDisplayPrivate *priv = gdk_display_get_instance_private (self);
+  G_GNUC_UNUSED gint64 start_time = GDK_PROFILER_CURRENT_TIME;
+  G_GNUC_UNUSED gint64 start_time2;
+  int major, minor;
+
+  if (!gdk_gl_backend_can_be_used (GDK_GL_EGL, error))
+    return FALSE;
+
+  if (!epoxy_has_egl ())
+    {
+      gboolean sandboxed = gdk_running_in_sandbox ();
+
+      g_set_error_literal (error, GDK_GL_ERROR,
+                           GDK_GL_ERROR_NOT_AVAILABLE,
+                           sandboxed ? _("libEGL not available in this sandbox")
+                                     : _("libEGL not available"));
+      return FALSE;
+    }
+
+  priv->egl_display = gdk_display_create_egl_display (platform, native_display);
+
+  if (priv->egl_display == NULL)
+    {
+      g_set_error_literal (error, GDK_GL_ERROR,
+                           GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("Failed to create EGL display"));
+      return FALSE;
+    }
+
+  start_time2 = GDK_PROFILER_CURRENT_TIME;
+  if (!eglInitialize (priv->egl_display, &major, &minor))
+    {
+      priv->egl_display = NULL;
+      g_set_error_literal (error, GDK_GL_ERROR,
+                           GDK_GL_ERROR_NOT_AVAILABLE,
+                           _("Could not initialize EGL display"));
+      return FALSE;
+    }
+  gdk_profiler_end_mark (start_time2, "eglInitialize", NULL);
+
+  if (major < GDK_EGL_MIN_VERSION_MAJOR ||
+      (major == GDK_EGL_MIN_VERSION_MAJOR && minor < GDK_EGL_MIN_VERSION_MINOR))
+    {
+      g_clear_pointer (&priv->egl_display, eglTerminate);
+      g_set_error (error, GDK_GL_ERROR,
+                   GDK_GL_ERROR_NOT_AVAILABLE,
+                   _("EGL version %d.%d is too old. GTK requires %d.%d"),
+                   major, minor, GDK_EGL_MIN_VERSION_MAJOR, GDK_EGL_MIN_VERSION_MINOR);
+      return FALSE;
+    }
+
+  if (!gdk_display_check_egl_extensions (priv->egl_display,
+                                         (const char *[]) {
+                                           "EGL_KHR_create_context",
+                                           "EGL_KHR_surfaceless_context",
+                                           NULL
+                                         },
+                                         error))
+    {
+      g_clear_pointer (&priv->egl_display, eglTerminate);
+      return FALSE;
+    }
+
+  priv->egl_config = gdk_display_create_egl_config (self,
+                                                    allow_any ? 0 : GDK_EGL_CONFIG_PERFECT,
+                                                    error);
+  if (priv->egl_config == NULL)
+    {
+      g_clear_pointer (&priv->egl_display, eglTerminate);
+      return FALSE;
+    }
+
+  self->have_egl_buffer_age =
+    epoxy_has_egl_extension (priv->egl_display, "EGL_EXT_buffer_age");
+  self->have_egl_swap_buffers_with_damage =
+    epoxy_has_egl_extension (priv->egl_display, "EGL_EXT_swap_buffers_with_damage");
+  self->have_egl_no_config_context =
+    epoxy_has_egl_extension (priv->egl_display, "EGL_KHR_no_config_context");
+  self->have_egl_pixel_format_float =
+    epoxy_has_egl_extension (priv->egl_display, "EGL_EXT_pixel_format_float");
+
+  if (self->have_egl_no_config_context)
+    priv->egl_config_high_depth = gdk_display_create_egl_config (self,
+                                                          GDK_EGL_CONFIG_HDR,
+                                                          error);
+  if (priv->egl_config_high_depth == NULL)
+    priv->egl_config_high_depth = priv->egl_config;
+
+  GDK_DISPLAY_NOTE (self, OPENGL, {
+      char *ext = describe_extensions (priv->egl_display);
+      char *std_cfg = describe_egl_config (priv->egl_display, priv->egl_config);
+      char *hd_cfg = describe_egl_config (priv->egl_display, priv->egl_config_high_depth);
+      g_message ("EGL API version %d.%d found\n"
+                 " - Vendor: %s\n"
+                 " - Version: %s\n"
+                 " - Client APIs: %s\n"
+                 " - Extensions:\n"
+                 "\t%s\n"
+                 " - Selected fbconfig: %s\n"
+                 "          high depth: %s",
+                 major, minor,
+                 eglQueryString (priv->egl_display, EGL_VENDOR),
+                 eglQueryString (priv->egl_display, EGL_VERSION),
+                 eglQueryString (priv->egl_display, EGL_CLIENT_APIS),
+                 ext, std_cfg,
+                 priv->egl_config_high_depth == priv->egl_config ? "none" : hd_cfg);
+      g_free (hd_cfg);
+      g_free (std_cfg);
+      g_free (ext);
+  });
+
+  gdk_profiler_end_mark (start_time, "init EGL", NULL);
+
+  return TRUE;
+}
+#endif
+
 GdkDebugFlags
 gdk_display_get_debug_flags (GdkDisplay *display)
 {
@@ -71,6 +71,9 @@ gboolean    gdk_display_supports_input_shapes (GdkDisplay    *display);
 GDK_AVAILABLE_IN_4_4
 gboolean    gdk_display_prepare_gl         (GdkDisplay  *self,
                                            GError     **error);
+GDK_AVAILABLE_IN_4_6
+GdkGLContext *gdk_display_create_gl_context(GdkDisplay  *self,
+                                            GError     **error);

 GDK_AVAILABLE_IN_ALL
 GdkDisplay *gdk_display_get_default (void);
@@ -27,7 +27,6 @@
 #include "gdkconfig.h"
 #include "gdkdisplaymanagerprivate.h"
 #include "gdkdisplayprivate.h"
-#include "gdkinternals.h"
 #include "gdkkeysprivate.h"
 #include "gdkintl.h"

@@ -92,6 +92,8 @@ struct _GdkDisplay
  guint double_click_time;  /* Maximum time between clicks in msecs */
  guint double_click_distance;   /* Maximum distance between clicks in pixels */

+  GList *seats;
+
 #ifdef GDK_RENDERING_VULKAN
  VkInstance vk_instance;
  VkDebugReportCallbackEXT vk_debug_callback;
@@ -103,7 +105,11 @@ struct _GdkDisplay
  guint vulkan_refcount;
 #endif /* GDK_RENDERING_VULKAN */

-  GList *seats;
+  /* egl info */
+  guint have_egl_buffer_age : 1;
+  guint have_egl_swap_buffers_with_damage : 1;
+  guint have_egl_no_config_context : 1;
+  guint have_egl_pixel_format_float : 1;
 };

 struct _GdkDisplayClass
@@ -140,10 +146,15 @@ struct _GdkDisplayClass

  GdkKeymap *                (*get_keymap)         (GdkDisplay    *display);

-  GdkGLContext *         (*init_gl)                    (GdkDisplay        *display,
+  GdkGLContext *         (* init_gl)                   (GdkDisplay        *display,
                                                        GError           **error);
+  /* Returns the distance from a perfect score EGL config.
+   * GDK chooses the one with the *LOWEST* score */
+  guint                  (* rate_egl_config)           (GdkDisplay        *display,
+                                                        gpointer           egl_display,
+                                                        gpointer           egl_config);

-  GdkSeat *              (*get_default_seat)           (GdkDisplay     *display);
+  GdkSeat *              (*get_default_seat)           (GdkDisplay        *display);

  GListModel *           (*get_monitors)               (GdkDisplay     *self);
  GdkMonitor *           (*get_monitor_at_surface)     (GdkDisplay     *display,
@@ -208,6 +219,16 @@ GdkSurface *        gdk_display_create_surface        (GdkDisplay       *display

 GdkGLContext *      gdk_display_get_gl_context        (GdkDisplay       *display);

+gboolean            gdk_display_init_egl              (GdkDisplay       *display,
+                                                       int /*EGLenum*/   platform,
+                                                       gpointer          native_display,
+                                                       gboolean          allow_any,
+                                                       GError          **error);
+gpointer            gdk_display_get_egl_display       (GdkDisplay       *display);
+gpointer            gdk_display_get_egl_config        (GdkDisplay       *display);
+gpointer            gdk_display_get_egl_config_high_depth
+                                                      (GdkDisplay       *display);
+
 void                gdk_display_set_rgba              (GdkDisplay       *display,
                                                       gboolean          rgba);
 void                gdk_display_set_composited        (GdkDisplay       *display,
@@ -69,7 +69,7 @@ GDK_AVAILABLE_IN_ALL
 GdkDragAction    gdk_drag_get_selected_action  (GdkDrag *drag);

 GDK_AVAILABLE_IN_ALL
-gboolean         gdk_drag_action_is_unique     (GdkDragAction   action);
+gboolean         gdk_drag_action_is_unique     (GdkDragAction   action) G_GNUC_CONST;

 GDK_AVAILABLE_IN_ALL
 GdkDrag *        gdk_drag_begin                (GdkSurface         *surface,
@@ -22,9 +22,10 @@

 #include "gdkdrawcontextprivate.h"

-#include "gdkinternals.h"
+#include "gdkdebug.h"
 #include "gdkintl.h"
 #include "gdkprofilerprivate.h"
+#include "gdksurfaceprivate.h"

 /**
 * GdkDrawContext:
@@ -275,7 +276,8 @@ gdk_draw_context_get_surface (GdkDrawContext *context)

 /**
 * gdk_draw_context_begin_frame:
- * @context: the `GdkDrawContext` used to draw the frame
+ * @context: the `GdkDrawContext` used to draw the frame. The context must
+ *   have a surface.
 * @region: minimum region that should be drawn
 *
 * Indicates that you are beginning the process of redrawing @region
@@ -310,8 +312,41 @@ gdk_draw_context_begin_frame (GdkDrawContext       *context,
  GdkDrawContextPrivate *priv = gdk_draw_context_get_instance_private (context);

  g_return_if_fail (GDK_IS_DRAW_CONTEXT (context));
+  g_return_if_fail (priv->surface != NULL);
  g_return_if_fail (region != NULL);

+  gdk_draw_context_begin_frame_full (context, FALSE, region);
+}
+
+/*
+ * @prefers_high_depth: %TRUE to request a higher bit depth
+ *
+ * If high depth is preferred, GDK will see about providing a rendering target
+ * that supports higher bit depth than 8 bits per channel. Typically this means
+ * a target supporting 16bit floating point pixels, but that is not guaranteed.
+ *
+ * This is only a request and if the GDK backend does not support HDR rendering
+ * or does not consider it worthwhile, it may choose to not honor the request.
+ * It may also choose to provide high depth even if it was not requested.
+ * Typically the steps undertaken by a backend are:
+ * 1. Check if high depth is supported by this drawing backend.
+ * 2. Check if the compositor supports high depth.
+ * 3. Check if the compositor prefers regular bit depth. This is usually the case
+ *    when the attached monitors do not support high depth content or when the
+ *    system is resource constrained.
+ * In either of those cases, the context will usually choose to not honor the request.
+ *
+ * The rendering code must be able to deal with content in any bit depth, no matter
+ * the preference. The prefers_high_depth argument is only a hint and GDK is free
+ * to choose.
+ */
+void
+gdk_draw_context_begin_frame_full (GdkDrawContext       *context,
+                                   gboolean              prefers_high_depth,
+                                   const cairo_region_t *region)
+{
+  GdkDrawContextPrivate *priv = gdk_draw_context_get_instance_private (context);
+
  if (GDK_SURFACE_DESTROYED (priv->surface))
    return;

@@ -333,10 +368,13 @@ gdk_draw_context_begin_frame (GdkDrawContext       *context,
      return;
    }

+  if (GDK_DISPLAY_DEBUG_CHECK (priv->display, HIGH_DEPTH))
+    prefers_high_depth = TRUE;
+
  priv->frame_region = cairo_region_copy (region);
  priv->surface->paint_context = g_object_ref (context);

-  GDK_DRAW_CONTEXT_GET_CLASS (context)->begin_frame (context, priv->frame_region);
+  GDK_DRAW_CONTEXT_GET_CLASS (context)->begin_frame (context, prefers_high_depth, priv->frame_region);
 }

 #ifdef HAVE_SYSPROF
@@ -377,6 +415,7 @@ gdk_draw_context_end_frame (GdkDrawContext *context)
  GdkDrawContextPrivate *priv = gdk_draw_context_get_instance_private (context);

  g_return_if_fail (GDK_IS_DRAW_CONTEXT (context));
+  g_return_if_fail (priv->surface != NULL);

  if (GDK_SURFACE_DESTROYED (priv->surface))
    return;
@@ -41,6 +41,7 @@ struct _GdkDrawContextClass
  GObjectClass parent_class;

  void                  (* begin_frame)                         (GdkDrawContext         *context,
+                                                                 gboolean                prefers_high_depth,
                                                                 cairo_region_t         *update_area);
  void                  (* end_frame)                           (GdkDrawContext         *context,
                                                                 cairo_region_t         *painted);
@@ -49,6 +50,9 @@ struct _GdkDrawContextClass

 void                    gdk_draw_context_surface_resized        (GdkDrawContext         *context);

+void                    gdk_draw_context_begin_frame_full       (GdkDrawContext         *context,
+                                                                 gboolean                prefers_high_depth,
+                                                                 const cairo_region_t   *region);
 G_END_DECLS

 #endif /* __GDK__DRAW_CONTEXT_PRIVATE__ */
@@ -46,9 +46,9 @@
 #include "gdkcontentserializer.h"
 #include "gdkcursor.h"
 #include "gdkdisplay.h"
+#include "gdkdragprivate.h"
 #include "gdkenumtypes.h"
 #include "gdkeventsprivate.h"
-#include "gdkinternals.h"
 #include "gdkintl.h"
 #include "gdkpipeiostreamprivate.h"
 #include "gdksurface.h"
@@ -24,13 +24,13 @@

 #include "config.h"

-#include "gdkintl.h"
-#include "gdkeventsprivate.h"
-#include "gdkinternals.h"
 #include "gdkdisplayprivate.h"
 #include "gdkdragprivate.h"
 #include "gdkdropprivate.h"
+#include "gdkeventsprivate.h"
+#include "gdkintl.h"
 #include "gdkkeysprivate.h"
+#include "gdkkeysyms.h"
 #include "gdk-private.h"

 #include <gobject/gvaluecollector.h>
@@ -25,7 +25,6 @@
 #include "config.h"

 #include "gdkframeclockprivate.h"
-#include "gdkinternals.h"

 /**
 * GdkFrameClock:
@@ -26,9 +26,8 @@

 #include "gdkframeclockidleprivate.h"

-#include "gdkinternals.h"
+#include "gdkdebug.h"
 #include "gdkframeclockprivate.h"
-#include "gdk.h"
 #include "gdk-private.h"
 #include "gdkprofilerprivate.h"

@@ -18,273 +18,14 @@
 #include "config.h"

 #include "gdkcairo.h"
-#include "gdkglcontextprivate.h"

-#include "gdkinternals.h"
+#include "gdkglcontextprivate.h"
+#include "gdksurfaceprivate.h"

 #include <epoxy/gl.h>
 #include <math.h>
 #include <string.h>

-static const char *
-get_shader_type_name (int type)
-{
-  switch (type)
-    {
-    case GL_VERTEX_SHADER:
-      return "vertex";
-    case GL_GEOMETRY_SHADER:
-      return "geometry";
-    case GL_FRAGMENT_SHADER:
-      return "fragment";
-    default:
-      return "unknown";
-    }
-}
-
-static guint
-create_shader (int         type,
-               const char *code)
-{
-  guint shader;
-  int status;
-
-  shader = glCreateShader (type);
-  glShaderSource (shader, 1, &code, NULL);
-  glCompileShader (shader);
-
-  glGetShaderiv (shader, GL_COMPILE_STATUS, &status);
-  if (status == GL_FALSE)
-    {
-      int log_len;
-      char *buffer;
-
-      glGetShaderiv (shader, GL_INFO_LOG_LENGTH, &log_len);
-
-      buffer = g_malloc (log_len + 1);
-      glGetShaderInfoLog (shader, log_len, NULL, buffer);
-
-      g_warning ("Compile failure in %s shader:\n%s", get_shader_type_name (type), buffer);
-      g_free (buffer);
-
-      glDeleteShader (shader);
-
-      return 0;
-    }
-
-  return shader;
-}
-
-static void
-make_program (GdkGLContextProgram *program,
-              const char          *vertex_shader_path,
-              const char          *fragment_shader_path)
-{
-  guint vertex_shader, fragment_shader;
-  GBytes *source;
-  int status;
-
-  source = g_resources_lookup_data (vertex_shader_path, 0, NULL);
-  g_assert (source != NULL);
-  vertex_shader = create_shader (GL_VERTEX_SHADER, g_bytes_get_data (source, NULL));
-  g_bytes_unref (source);
-  if (vertex_shader == 0)
-    return;
-
-  source = g_resources_lookup_data (fragment_shader_path, 0, NULL);
-  g_assert (source != NULL);
-  fragment_shader = create_shader (GL_FRAGMENT_SHADER, g_bytes_get_data (source, NULL));
-  g_bytes_unref (source);
-  if (fragment_shader == 0)
-    {
-      glDeleteShader (vertex_shader);
-      return;
-    }
-
-  program->program = glCreateProgram ();
-  glAttachShader (program->program, vertex_shader);
-  glAttachShader (program->program, fragment_shader);
-
-  glLinkProgram (program->program);
-
-  glDetachShader (program->program, vertex_shader);
-  glDetachShader (program->program, fragment_shader);
-
-  glDeleteShader (vertex_shader);
-  glDeleteShader (fragment_shader);
-
-  glGetProgramiv (program->program, GL_LINK_STATUS, &status);
-  if (status == GL_FALSE)
-    {
-      int log_len;
-      char *buffer;
-
-      glGetProgramiv (program->program, GL_INFO_LOG_LENGTH, &log_len);
-
-      buffer = g_malloc (log_len + 1);
-      glGetProgramInfoLog (program->program, log_len, NULL, buffer);
-      g_warning ("Linker failure: %s\n", buffer);
-      g_free (buffer);
-
-      glDeleteProgram (program->program);
-    }
-
-  program->position_location = glGetAttribLocation (program->program, "position");
-  program->uv_location = glGetAttribLocation (program->program, "uv");
-  program->map_location = glGetUniformLocation (program->program, "map");
-  program->flip_location = glGetUniformLocation (program->program, "flipColors");
-}
-
-static void
-bind_vao (GdkGLContextPaintData *paint_data)
-{
-  if (paint_data->vertex_array_object == 0)
-    {
-      glGenVertexArrays (1, &paint_data->vertex_array_object);
-      /* ATM we only use one VAO, so always bind it */
-      glBindVertexArray (paint_data->vertex_array_object);
-    }
-}
-
-static void
-use_texture_gles_program (GdkGLContextPaintData *paint_data)
-{
-  if (paint_data->texture_2d_quad_program.program == 0)
-    make_program (&paint_data->texture_2d_quad_program,
-                  "/org/gtk/libgdk/glsl/gles2-texture.vs.glsl",
-                  "/org/gtk/libgdk/glsl/gles2-texture.fs.glsl");
-
-  if (paint_data->current_program != &paint_data->texture_2d_quad_program)
-    {
-      paint_data->current_program = &paint_data->texture_2d_quad_program;
-      glUseProgram (paint_data->current_program->program);
-    }
-}
-
-static void
-use_texture_2d_program (GdkGLContextPaintData *paint_data)
-{
-  const char *vertex_shader_path = paint_data->is_legacy
-    ? "/org/gtk/libgdk/glsl/gl2-texture-2d.vs.glsl"
-    : "/org/gtk/libgdk/glsl/gl3-texture-2d.vs.glsl";
-
-  const char *fragment_shader_path = paint_data->is_legacy
-    ? "/org/gtk/libgdk/glsl/gl2-texture-2d.fs.glsl"
-    : "/org/gtk/libgdk/glsl/gl3-texture-2d.fs.glsl";
-
-  if (paint_data->texture_2d_quad_program.program == 0)
-    make_program (&paint_data->texture_2d_quad_program, vertex_shader_path, fragment_shader_path);
-
-  if (paint_data->current_program != &paint_data->texture_2d_quad_program)
-    {
-      paint_data->current_program = &paint_data->texture_2d_quad_program;
-      glUseProgram (paint_data->current_program->program);
-    }
-}
-
-static void
-use_texture_rect_program (GdkGLContextPaintData *paint_data)
-{
-  const char *vertex_shader_path = paint_data->is_legacy
-    ? "/org/gtk/libgdk/glsl/gl2-texture-rect.vs.glsl"
-    : "/org/gtk/libgdk/glsl/gl3-texture-rect.vs.glsl";
-
-  const char *fragment_shader_path = paint_data->is_legacy
-    ? "/org/gtk/libgdk/glsl/gl2-texture-rect.fs.glsl"
-    : "/org/gtk/libgdk/glsl/gl3-texture-rect.vs.glsl";
-
-  if (paint_data->texture_rect_quad_program.program == 0)
-    make_program (&paint_data->texture_rect_quad_program, vertex_shader_path, fragment_shader_path);
-
-  if (paint_data->current_program != &paint_data->texture_rect_quad_program)
-    {
-      paint_data->current_program = &paint_data->texture_rect_quad_program;
-      glUseProgram (paint_data->current_program->program);
-    }
-}
-
-void
-gdk_gl_texture_quads (GdkGLContext *paint_context,
-                      guint texture_target,
-                      int n_quads,
-                      GdkTexturedQuad *quads,
-                      gboolean flip_colors)
-{
-  GdkGLContextPaintData *paint_data  = gdk_gl_context_get_paint_data (paint_context);
-  GdkGLContextProgram *program;
-  GdkSurface *surface = gdk_gl_context_get_surface (paint_context);
-  int surface_scale = gdk_surface_get_scale_factor (surface);
-  float w = gdk_surface_get_width (surface) * surface_scale;
-  float h = gdk_surface_get_height (surface) * surface_scale;
-  int i;
-  float *vertex_buffer_data;
-
-  bind_vao (paint_data);
-
-  if (paint_data->tmp_vertex_buffer == 0)
-    glGenBuffers(1, &paint_data->tmp_vertex_buffer);
-
-  if (paint_data->use_es)
-    use_texture_gles_program (paint_data);
-  else
-    {
-      if (texture_target == GL_TEXTURE_RECTANGLE_ARB)
-        use_texture_rect_program (paint_data);
-      else
-        use_texture_2d_program (paint_data);
-    }
-
-  program = paint_data->current_program;
-
-  /* Use texture unit 0 */
-  glActiveTexture (GL_TEXTURE0);
-  glUniform1i(program->map_location, 0);
-
-  /* Flip 'R' and 'B' colors on GLES, if necessary */
-  if (gdk_gl_context_get_use_es (paint_context))
-    glUniform1i (program->flip_location, flip_colors ? 1 : 0);
-
-  glEnableVertexAttribArray (program->position_location);
-  glEnableVertexAttribArray (program->uv_location);
-  glBindBuffer (GL_ARRAY_BUFFER, paint_data->tmp_vertex_buffer);
-
-  glVertexAttribPointer (program->position_location, 2, GL_FLOAT, GL_FALSE, sizeof(float) * 4, NULL);
-  glVertexAttribPointer (program->uv_location, 2, GL_FLOAT, GL_FALSE, sizeof(float) * 4, (void *) (sizeof(float) * 2));
-
-#define VERTEX_SIZE 4
-
-#define QUAD_N_VERTICES 6
-
-#define QUAD_SIZE (VERTEX_SIZE * QUAD_N_VERTICES)
-
-  vertex_buffer_data = g_new (float, n_quads * QUAD_SIZE);
-
-  for (i = 0; i < n_quads; i++)
-    {
-      GdkTexturedQuad *quad = &quads[i];
-      float vertex_data[] = {
-        (quad->x1 * 2) / w - 1, (quad->y1 * 2) / h - 1, quad->u1, quad->v1,
-        (quad->x1 * 2) / w - 1, (quad->y2 * 2) / h - 1, quad->u1, quad->v2,
-        (quad->x2 * 2) / w - 1, (quad->y1 * 2) / h - 1, quad->u2, quad->v1,
-
-        (quad->x2 * 2) / w - 1, (quad->y2 * 2) / h - 1, quad->u2, quad->v2,
-        (quad->x1 * 2) / w - 1, (quad->y2 * 2) / h - 1, quad->u1, quad->v2,
-        (quad->x2 * 2) / w - 1, (quad->y1 * 2) / h - 1, quad->u2, quad->v1,
-      };
-
-      float *vertex = &vertex_buffer_data[i * QUAD_SIZE];
-      memcpy (vertex, vertex_data, sizeof(vertex_data));
-    }
-
-  glBufferData (GL_ARRAY_BUFFER, sizeof(float) * n_quads * QUAD_SIZE, vertex_buffer_data, GL_STREAM_DRAW);
-  glDrawArrays (GL_TRIANGLES, 0, n_quads * QUAD_N_VERTICES);
-
-  g_free (vertex_buffer_data);
-
-  glDisableVertexAttribArray (program->position_location);
-  glDisableVertexAttribArray (program->uv_location);
-}
-
 /* x,y,width,height describes a rectangle in the gl render buffer
   coordinate space, and its top left corner is drawn at the current
   position according to the cairo translation. */
@@ -301,7 +42,7 @@ gdk_gl_texture_quads (GdkGLContext *paint_context,
 * @width: The width of the region to draw
 * @height: The height of the region to draw
 *
- * The main way to draw GL content in GTK.
+ * The main way to not 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,
@@ -319,6 +60,12 @@ gdk_gl_texture_quads (GdkGLContext *paint_context,
 * with alpha components, so make sure you use GL_TEXTURE if using alpha.
 *
 * Calling this may change the current GL context.
+ *
+ * Deprecated: 4.6: The function is overly complex and produces broken output
+ *   in various combinations of arguments. If you want to draw with GL textures
+ *   in GTK, use [ctor@Gdk.GLTexture.new]; if you want to use that texture in
+ *   Cairo, use [method@Gdk.Texture.download] to download the data into a Cairo
+ *   image surface.
 */
 void
 gdk_cairo_draw_from_gl (cairo_t              *cr,
@@ -335,7 +82,6 @@ gdk_cairo_draw_from_gl (cairo_t              *cr,
  cairo_surface_t *image;
  guint framebuffer;
  int alpha_size = 0;
-  GdkGLContextPaintData *paint_data;
  int major, minor, version;
  gboolean es_use_bgra = FALSE;

@@ -349,10 +95,8 @@ gdk_cairo_draw_from_gl (cairo_t              *cr,
  es_use_bgra = gdk_gl_context_use_es_bgra (paint_context);

  gdk_gl_context_make_current (paint_context);
-  paint_data = gdk_gl_context_get_paint_data (paint_context);

-  if (paint_data->tmp_framebuffer == 0)
-    glGenFramebuffers (1, &paint_data->tmp_framebuffer);
+  glGenFramebuffers (1, &framebuffer);

  if (source_type == GL_RENDERBUFFER)
    {
@@ -391,7 +135,6 @@ gdk_cairo_draw_from_gl (cairo_t              *cr,

  cairo_surface_set_device_scale (image, buffer_scale, buffer_scale);

-  framebuffer = paint_data->tmp_framebuffer;
  glBindFramebuffer (GL_FRAMEBUFFER, framebuffer);

  if (source_type == GL_RENDERBUFFER)
@@ -422,6 +165,8 @@ gdk_cairo_draw_from_gl (cairo_t              *cr,

  glBindFramebuffer (GL_FRAMEBUFFER, 0);

+  glDeleteFramebuffers (1, &framebuffer);
+
  cairo_surface_mark_dirty (image);

  cairo_set_source_surface (cr, image, 0, 0);
@@ -30,6 +30,20 @@

 G_BEGIN_DECLS

+/**
+ * GdkGLAPI:
+ * @GDK_GL_API_GL: The OpenGL API
+ * @GDK_GL_API_GLES: The OpenGL ES API
+ *
+ * The list of the different APIs that GdkGLContext can potentially support.
+ *
+ * Since: 4.6
+ */
+typedef enum { /*< underscore_name=GDK_GL_API >*/
+  GDK_GL_API_GL   = 1 << 0,
+  GDK_GL_API_GLES = 1 << 1
+} GdkGLAPI;
+
 #define GDK_TYPE_GL_CONTEXT             (gdk_gl_context_get_type ())
 #define GDK_GL_CONTEXT(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_GL_CONTEXT, GdkGLContext))
 #define GDK_IS_GL_CONTEXT(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_GL_CONTEXT))
@@ -76,7 +90,14 @@ void                    gdk_gl_context_set_forward_compatible   (GdkGLContext  *
                                                                 gboolean       compatible);
 GDK_AVAILABLE_IN_ALL
 gboolean                gdk_gl_context_get_forward_compatible   (GdkGLContext  *context);
-GDK_AVAILABLE_IN_ALL
+GDK_AVAILABLE_IN_4_6
+void                    gdk_gl_context_set_allowed_apis         (GdkGLContext  *self,
+                                                                 GdkGLAPI       apis);
+GDK_AVAILABLE_IN_4_6
+GdkGLAPI                gdk_gl_context_get_allowed_apis         (GdkGLContext  *self);
+GDK_AVAILABLE_IN_4_6
+GdkGLAPI                gdk_gl_context_get_api                  (GdkGLContext  *self);
+GDK_DEPRECATED_IN_4_6_FOR(gdk_gl_context_set_allowed_apis)
 void                    gdk_gl_context_set_use_es               (GdkGLContext  *context,
                                                                 int            use_es);
 GDK_AVAILABLE_IN_ALL
@@ -23,7 +23,6 @@

 #include "gdkglcontext.h"
 #include "gdkdrawcontextprivate.h"
-#include "gdkmemorytexture.h"

 G_BEGIN_DECLS

@@ -34,6 +33,14 @@ G_BEGIN_DECLS
 #define GDK_EGL_MIN_VERSION_MAJOR (1)
 #define GDK_EGL_MIN_VERSION_MINOR (4)

+typedef enum {
+  GDK_GL_NONE = 0,
+  GDK_GL_EGL,
+  GDK_GL_GLX,
+  GDK_GL_WGL,
+  GDK_GL_CGL
+} GdkGLBackend;
+
 #define GDK_GL_CONTEXT_CLASS(klass)	(G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_GL_CONTEXT, GdkGLContextClass))
 #define GDK_IS_GL_CONTEXT_CLASS(klass)	(G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_GL_CONTEXT))
 #define GDK_GL_CONTEXT_GET_CLASS(obj)	(G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_GL_CONTEXT, GdkGLContextClass))
@@ -52,7 +59,9 @@ struct _GdkGLContextClass
 {
  GdkDrawContextClass parent_class;

-  gboolean              (* realize)                             (GdkGLContext          *context,
+  GdkGLBackend        backend_type;
+
+  GdkGLAPI              (* realize)                             (GdkGLContext          *context,
                                                                 GError               **error);

  gboolean              (* make_current)                        (GdkGLContext          *context,
@@ -86,20 +95,23 @@ typedef struct {
  guint use_es : 1;
 } GdkGLContextPaintData;

-GdkGLContext *          gdk_gl_context_new_for_surface          (GdkSurface      *surface);
+gboolean                gdk_gl_backend_can_be_used              (GdkGLBackend     backend_type,
+                                                                 GError         **error);
+void                    gdk_gl_backend_use                      (GdkGLBackend     backend_type);

+GdkGLContext *          gdk_gl_context_new                      (GdkDisplay      *display,
+                                                                 GdkSurface      *surface);
+
+gboolean                gdk_gl_context_is_api_allowed           (GdkGLContext    *self,
+                                                                 GdkGLAPI         api,
+                                                                 GError         **error);
 void                    gdk_gl_context_set_is_legacy            (GdkGLContext    *context,
                                                                 gboolean         is_legacy);

-void                    gdk_gl_context_upload_texture           (GdkGLContext    *context,
-                                                                 const guchar    *data,
-                                                                 int              width,
-                                                                 int              height,
-                                                                 int              stride,
-                                                                 GdkMemoryFormat  data_format,
-                                                                 guint            texture_target);
-GdkGLContextPaintData * gdk_gl_context_get_paint_data           (GdkGLContext    *context);
-gboolean                gdk_gl_context_use_texture_rectangle    (GdkGLContext    *context);
+gboolean                gdk_gl_context_check_version            (GdkGLContext    *context,
+                                                                 int              required_major,
+                                                                 int              required_minor);
+
 gboolean                gdk_gl_context_has_unpack_subimage      (GdkGLContext    *context);
 void                    gdk_gl_context_push_debug_group         (GdkGLContext    *context,
                                                                 const char      *message);
@@ -121,18 +133,6 @@ gboolean                gdk_gl_context_has_debug                (GdkGLContext

 gboolean                gdk_gl_context_use_es_bgra              (GdkGLContext    *context);

-typedef struct {
-  float x1, y1, x2, y2;
-  float u1, v1, u2, v2;
-} GdkTexturedQuad;
-
-void                    gdk_gl_texture_quads                    (GdkGLContext    *context,
-                                                                 guint            texture_target,
-                                                                 int              n_quads,
-                                                                 GdkTexturedQuad *quads,
-                                                                 gboolean         flip_colors);
-
-
 G_END_DECLS

 #endif /* __GDK_GL_CONTEXT_PRIVATE_H__ */
@@ -25,7 +25,6 @@
 #include "config.h"

 #include "gdktypes.h"
-#include "gdkinternals.h"

 #include <stdio.h>

@@ -20,7 +20,9 @@

 #include "gdkgltextureprivate.h"

-#include "gdkcairo.h"
+#include "gdkdisplayprivate.h"
+#include "gdkmemoryformatprivate.h"
+#include "gdkmemorytextureprivate.h"
 #include "gdktextureprivate.h"

 #include <epoxy/gl.h>
@@ -37,7 +39,7 @@ struct _GdkGLTexture {
  GdkGLContext *context;
  guint id;

-  cairo_surface_t *saved;
+  GdkTexture *saved;

  GDestroyNotify destroy;
  gpointer data;
@@ -64,50 +66,175 @@ gdk_gl_texture_dispose (GObject *object)
  g_clear_object (&self->context);
  self->id = 0;

-  if (self->saved)
-    {
-      cairo_surface_destroy (self->saved);
-      self->saved = NULL;
-    }
+  g_clear_object (&self->saved);

  G_OBJECT_CLASS (gdk_gl_texture_parent_class)->dispose (object);
 }

-static void
-gdk_gl_texture_download (GdkTexture         *texture,
-                         const GdkRectangle *area,
-                         guchar             *data,
-                         gsize               stride)
+typedef struct _InvokeData
 {
-  GdkGLTexture *self = GDK_GL_TEXTURE (texture);
-  cairo_surface_t *surface;
-  cairo_t *cr;
+  GdkGLTexture *self;
+  volatile int spinlock;
+  GFunc func;
+  gpointer data;
+} InvokeData;

-  surface = cairo_image_surface_create_for_data (data,
-                                                 CAIRO_FORMAT_ARGB32,
-                                                 area->width, area->height,
-                                                 stride);
+static gboolean
+gdk_gl_texture_invoke_callback (gpointer data)
+{
+  InvokeData *invoke = data;
+  GdkGLContext *context;

-  cr = cairo_create (surface);
+  context = gdk_display_get_gl_context (gdk_gl_context_get_display (invoke->self->context));

-  if (self->saved)
+  gdk_gl_context_make_current (context);
+  glBindTexture (GL_TEXTURE_2D, invoke->self->id);
+
+  invoke->func (invoke->self, invoke->data);
+
+  g_atomic_int_set (&invoke->spinlock, 1);
+
+  return FALSE;
+}
+
+static void
+gdk_gl_texture_run (GdkGLTexture *self,
+                    GFunc         func,
+                    gpointer      data)
+{
+  InvokeData invoke = { self, 0, func, data };
+
+  g_main_context_invoke (NULL, gdk_gl_texture_invoke_callback, &invoke);
+
+  while (g_atomic_int_get (&invoke.spinlock) == 0);
+}
+
+typedef struct _Download Download;
+
+struct _Download
+{
+  GdkMemoryFormat format;
+  guchar *data;
+  gsize stride;
+};
+
+static gboolean
+gdk_gl_texture_find_format (gboolean         use_es,
+                            GLint            gl_format,
+                            GLint            gl_type,
+                            GdkMemoryFormat *out_format)
+{
+  GdkMemoryFormat format;
+
+  for (format = 0; format < GDK_MEMORY_N_FORMATS; format++)
    {
-      cairo_set_source_surface (cr, self->saved, 0, 0);
-      cairo_paint (cr);
+      GLenum q_internal_format, q_format, q_type;
+
+      if (!gdk_memory_format_gl_format (format, use_es, &q_internal_format, &q_format, &q_type))
+        continue;
+
+      if (q_format != gl_format || q_type != gl_type)
+        continue;
+
+      *out_format = format;
+      return TRUE;
+    }
+
+  return FALSE;
+}
+
+static inline void
+gdk_gl_texture_do_download (gpointer texture_,
+                            gpointer download_)
+{
+  gsize expected_stride;
+  GdkGLTexture *self = texture_;
+  GdkTexture *texture = texture_;
+  Download *download = download_;
+  GLenum gl_internal_format, gl_format, gl_type;
+
+  expected_stride = texture->width * gdk_memory_format_bytes_per_pixel (download->format);
+
+  if (download->stride == expected_stride &&
+      !gdk_gl_context_get_use_es (self->context) && 
+      gdk_memory_format_gl_format (download->format, TRUE, &gl_internal_format, &gl_format, &gl_type))
+    {
+      glGetTexImage (GL_TEXTURE_2D,
+                     0,
+                     gl_format,
+                     gl_type,
+                     download->data);
    }
  else
    {
-      GdkSurface *gl_surface;
+      GdkMemoryFormat actual_format;
+      GLint gl_read_format, gl_read_type;
+      GLuint fbo;

-      gl_surface = gdk_gl_context_get_surface (self->context);
-      gdk_cairo_draw_from_gl (cr, gl_surface, self->id, GL_TEXTURE, 1, 
-                              area->x, area->y,
-                              area->width, area->height);
+      glGenFramebuffers (1, &fbo);
+      glBindFramebuffer (GL_FRAMEBUFFER, fbo);
+      glFramebufferTexture2D (GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, self->id, 0);
+      glGetFramebufferParameteriv (GL_FRAMEBUFFER, GL_IMPLEMENTATION_COLOR_READ_FORMAT, &gl_read_format);
+      glGetFramebufferParameteriv (GL_FRAMEBUFFER, GL_IMPLEMENTATION_COLOR_READ_TYPE, &gl_read_type);
+      if (!gdk_gl_texture_find_format (gdk_gl_context_get_use_es (self->context), gl_read_format, gl_read_type, &actual_format))
+        actual_format = GDK_MEMORY_R8G8B8A8_PREMULTIPLIED; /* pray */
+
+      if (download->format == actual_format &&
+          (download->stride == expected_stride))
+        {
+          glReadPixels (0, 0,
+                        texture->width, texture->height, 
+                        gl_read_format,
+                        gl_read_type,
+                        download->data);
+        }
+      else
+        {
+          gsize actual_bpp = gdk_memory_format_bytes_per_pixel (actual_format);
+          guchar *pixels = g_malloc_n (texture->width * actual_bpp, texture->height);
+
+          glReadPixels (0, 0,
+                        texture->width, texture->height, 
+                        gl_read_format,
+                        gl_read_type,
+                        pixels);
+
+          gdk_memory_convert (download->data,
+                              download->stride,
+                              download->format,
+                              pixels,
+                              texture->width * actual_bpp,
+                              actual_format,
+                              texture->width,
+                              texture->height);
+
+          g_free (pixels);
+        }
+      glBindFramebuffer (GL_FRAMEBUFFER, 0);
+      glDeleteFramebuffers (1, &fbo);
+    }
+}
+
+static void
+gdk_gl_texture_download (GdkTexture      *texture,
+                         GdkMemoryFormat  format,
+                         guchar          *data,
+                         gsize            stride)
+{
+  GdkGLTexture *self = GDK_GL_TEXTURE (texture);
+  Download download;
+
+  if (self->saved)
+    {
+      gdk_texture_do_download (self->saved, format, data, stride);
+      return;
    }

-  cairo_destroy (cr);
-  cairo_surface_finish (surface);
-  cairo_surface_destroy (surface);
+  download.format = format;
+  download.data = data;
+  download.stride = stride;
+
+  gdk_gl_texture_run (self, gdk_gl_texture_do_download, &download);
 }

 static void
@@ -117,6 +244,7 @@ gdk_gl_texture_class_init (GdkGLTextureClass *klass)
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);

  texture_class->download = gdk_gl_texture_download;
+
  gobject_class->dispose = gdk_gl_texture_dispose;
 }

@@ -150,24 +278,14 @@ gdk_gl_texture_get_id (GdkGLTexture *self)
 void
 gdk_gl_texture_release (GdkGLTexture *self)
 {
-  GdkSurface *surface;
  GdkTexture *texture;
-  cairo_t *cr;

  g_return_if_fail (GDK_IS_GL_TEXTURE (self));
  g_return_if_fail (self->saved == NULL);

  texture = GDK_TEXTURE (self);
-  self->saved = cairo_image_surface_create (CAIRO_FORMAT_ARGB32,
-                                            texture->width, texture->height);
-
-  cr = cairo_create (self->saved);
-
-  surface = gdk_gl_context_get_surface (self->context);
-  gdk_cairo_draw_from_gl (cr, surface, self->id, GL_TEXTURE, 1, 0, 0,
-                          texture->width, texture->height);
-
-  cairo_destroy (cr);
+  self->saved = GDK_TEXTURE (gdk_memory_texture_from_texture (texture,
+                                                              gdk_texture_get_format (texture)));

  if (self->destroy)
    {
@@ -180,6 +298,72 @@ gdk_gl_texture_release (GdkGLTexture *self)
  self->id = 0;
 }

+static void
+gdk_gl_texture_determine_format (GdkGLTexture *self)
+{
+  GdkTexture *texture = GDK_TEXTURE (self);
+  GLint active_texture;
+  GLint internal_format;
+
+  if (self->context != gdk_gl_context_get_current ())
+    {
+      /* Somebody else is GL-ing here, abort! */
+      texture->format = GDK_MEMORY_DEFAULT;
+      return;
+    }
+
+  /* We need to be careful about modifying the GL context, as this is not
+   * expected during construction */
+  glGetIntegerv (GL_TEXTURE_BINDING_2D, &active_texture);
+  glBindTexture (GL_TEXTURE_2D, self->id);
+
+  glGetTexLevelParameteriv (GL_TEXTURE_2D, 0, GL_TEXTURE_INTERNAL_FORMAT, &internal_format);
+
+  switch (internal_format)
+  {
+    case GL_RGB8:
+      texture->format = GDK_MEMORY_R8G8B8;
+      break;
+
+    case GL_RGBA8:
+      texture->format = GDK_MEMORY_R8G8B8A8_PREMULTIPLIED;
+      break;
+
+    case GL_RGB16:
+      texture->format = GDK_MEMORY_R16G16B16;
+      break;
+
+    case GL_RGBA16:
+      texture->format = GDK_MEMORY_R16G16B16A16_PREMULTIPLIED;
+      break;
+
+    case GL_RGB16F:
+      texture->format = GDK_MEMORY_R16G16B16_FLOAT;
+      break;
+
+    case GL_RGBA16F:
+      texture->format = GDK_MEMORY_R16G16B16A16_FLOAT_PREMULTIPLIED;
+      break;
+
+    case GL_RGB32F:
+      texture->format = GDK_MEMORY_R32G32B32_FLOAT;
+      break;
+
+    case GL_RGBA32F:
+      texture->format = GDK_MEMORY_R32G32B32A32_FLOAT_PREMULTIPLIED;
+      break;
+
+    default:
+      g_warning ("Texture in unexpected format 0x%X (%d). File a bug about adding it to GTK", internal_format, internal_format);
+      /* fallback to the dumbest possible format
+       * so that even age old GLES can do it */
+      texture->format = GDK_MEMORY_R8G8B8A8_PREMULTIPLIED;
+      break;
+  }
+
+  glBindTexture (GL_TEXTURE_2D, active_texture);
+}
+
 /**
 * gdk_gl_texture_new:
 * @context: a `GdkGLContext`
@@ -223,6 +407,8 @@ gdk_gl_texture_new (GdkGLContext   *context,
  self->destroy = destroy;
  self->data = data;

+  gdk_gl_texture_determine_format (self);
+
  return GDK_TEXTURE (self);
 }

@@ -17,12 +17,12 @@

 #include "config.h"

-#include "gtkhslaprivate.h"
+#include "gdkhslaprivate.h"

 #include <math.h>

 void
-_gtk_hsla_init_from_rgba (GtkHSLA       *hsla,
+_gdk_hsla_init_from_rgba (GdkHSLA       *hsla,
                          const GdkRGBA *rgba)
 {
  float min;
@@ -31,21 +31,21 @@ _gtk_hsla_init_from_rgba (GtkHSLA       *hsla,
  float green;
  float blue;
  float delta;
-  
+
  g_return_if_fail (hsla != NULL);
  g_return_if_fail (rgba != NULL);

  red = rgba->red;
  green = rgba->green;
  blue = rgba->blue;
-  
+
  if (red > green)
    {
      if (red > blue)
        max = red;
      else
        max = blue;
-      
+
      if (green < blue)
        min = green;
      else
@@ -57,25 +57,25 @@ _gtk_hsla_init_from_rgba (GtkHSLA       *hsla,
        max = green;
      else
        max = blue;
-      
+
      if (red < blue)
        min = red;
      else
        min = blue;
    }
-  
+
  hsla->lightness = (max + min) / 2;
  hsla->saturation = 0;
  hsla->hue = 0;
  hsla->alpha = rgba->alpha;
-  
+
  if (max != min)
    {
      if (hsla->lightness <= 0.5)
        hsla->saturation = (max - min) / (max + min);
      else
        hsla->saturation = (max - min) / (2 - max - min);
-      
+
      delta = max -min;
      if (red == max)
        hsla->hue = (green - blue) / delta;
@@ -83,7 +83,7 @@ _gtk_hsla_init_from_rgba (GtkHSLA       *hsla,
        hsla->hue = 2 + (blue - red) / delta;
      else if (blue == max)
        hsla->hue = 4 + (red - green) / delta;
-      
+
      hsla->hue *= 60;
      if (hsla->hue < 0.0)
        hsla->hue += 360;
@@ -92,22 +92,22 @@ _gtk_hsla_init_from_rgba (GtkHSLA       *hsla,

 void
 _gdk_rgba_init_from_hsla (GdkRGBA       *rgba,
-                          const GtkHSLA *hsla)
+                          const GdkHSLA *hsla)
 {
  float hue;
  float lightness;
  float saturation;
  float m1, m2;
-  
+
  lightness = hsla->lightness;
  saturation = hsla->saturation;
-  
+
  if (lightness <= 0.5)
    m2 = lightness * (1 + saturation);
  else
    m2 = lightness + saturation - lightness * saturation;
  m1 = 2 * lightness - m2;
-  
+
  rgba->alpha = hsla->alpha;

  if (saturation == 0)
@@ -123,7 +123,7 @@ _gdk_rgba_init_from_hsla (GdkRGBA       *rgba,
        hue -= 360;
      while (hue < 0)
        hue += 360;
-      
+
      if (hue < 60)
        rgba->red = m1 + (m2 - m1) * hue / 60;
      else if (hue < 180)
@@ -132,13 +132,13 @@ _gdk_rgba_init_from_hsla (GdkRGBA       *rgba,
        rgba->red = m1 + (m2 - m1) * (240 - hue) / 60;
      else
        rgba->red = m1;
-      
+
      hue = hsla->hue;
      while (hue > 360)
        hue -= 360;
      while (hue < 0)
        hue += 360;
-      
+
      if (hue < 60)
        rgba->green = m1 + (m2 - m1) * hue / 60;
      else if (hue < 180)
@@ -147,13 +147,13 @@ _gdk_rgba_init_from_hsla (GdkRGBA       *rgba,
        rgba->green = m1 + (m2 - m1) * (240 - hue) / 60;
      else
        rgba->green = m1;
-      
+
      hue = hsla->hue - 120;
      while (hue > 360)
        hue -= 360;
      while (hue < 0)
        hue += 360;
-      
+
      if (hue < 60)
        rgba->blue = m1 + (m2 - m1) * hue / 60;
      else if (hue < 180)
@@ -166,8 +166,8 @@ _gdk_rgba_init_from_hsla (GdkRGBA       *rgba,
 }

 void
-_gtk_hsla_shade (GtkHSLA       *dest,
-                 const GtkHSLA *src,
+_gdk_hsla_shade (GdkHSLA       *dest,
+                 const GdkHSLA *src,
                 float          factor)
 {
  g_return_if_fail (dest != NULL);
@@ -18,27 +18,27 @@
 #ifndef __GTK_HSLA_PRIVATE_H__
 #define __GTK_HSLA_PRIVATE_H__

-#include <gdk/gdk.h>
+#include <gdk/gdkrgba.h>

 G_BEGIN_DECLS

-typedef struct _GtkHSLA GtkHSLA;
+typedef struct _GdkHSLA GdkHSLA;

-struct _GtkHSLA {
+struct _GdkHSLA {
  float hue;
  float saturation;
  float lightness;
  float alpha;
 };

-void            _gtk_hsla_init_from_rgba    (GtkHSLA          *hsla,
+void            _gdk_hsla_init_from_rgba    (GdkHSLA          *hsla,
                                             const GdkRGBA    *rgba);
 /* Yes, I can name that function like this! */
 void            _gdk_rgba_init_from_hsla    (GdkRGBA          *rgba,
-                                             const GtkHSLA    *hsla);
+                                             const GdkHSLA    *hsla);

-void            _gtk_hsla_shade             (GtkHSLA          *dest,
-                                             const GtkHSLA    *src,
+void            _gdk_hsla_shade             (GdkHSLA          *dest,
+                                             const GdkHSLA    *src,
                                             float             factor);

 G_END_DECLS
--- a/Show More
+++ b/Show More