Add some docs for the wayland backend

This commit also includes some tweaks to the other backend-specific
docs.

diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 836ed4e23290e2ec7c75547ed0ce8cde612094fc..47bc96dcd87a41dd0b83a50d0918a55453853320 100644 (file)
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -130,6 +130,7 @@ content_files =                                     \
        objects_grouped.sgml                    \
        osx.sgml                                \
        broadway.xml                            \
+       wayland.xml                             \
        question_index.sgml                     \
        resources.sgml                          \
        text_widget.sgml                        \

diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 70a34d78209df9a696e27e7d808fe8f7c6293cec..76881b170a790fa760688c4d2ce0da26cac7a97f 100644 (file)
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -29,6 +29,7 @@
     <xi:include href="windows.sgml" />
     <xi:include href="osx.sgml" />
     <xi:include href="broadway.xml" />
+    <xi:include href="wayland.xml" />
     <xi:include href="resources.sgml" />
     <xi:include href="xml/question_index.sgml" />
     <xi:include href="drawing-model.xml" />

diff --git a/docs/reference/gtk/osx.sgml b/docs/reference/gtk/osx.sgml
index 0f09097dcc9bc5a8a1309b511898d7cb2181ccb3..41c6d87b4124e152b280c5a7e9a476ce8153a3db 100644 (file)
--- a/docs/reference/gtk/osx.sgml
+++ b/docs/reference/gtk/osx.sgml
@@ -20,13 +20,13 @@ OS X-specific aspects of using GTK+
 <title>Using GTK+ on Mac OS X</title>
 
 <para>
-The Mac OS X port of GTK+ is an implementation of GDK (and therefore GTK+) 
+The Mac OS X port of GTK+ is an implementation of GDK (and therefore GTK+)
 on top of the Quarz API.
 </para>
 
 <para>
 Currently, the Mac OS X port does not use any additional commandline options
-or environment variables. 
+or environment variables.
 </para>
 
 <para>

diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml
index 190234ea2a7347dd3a42a9b5262c3a2d4966beeb..147637e42ddff65f5a9be65205bb4edad7d4294a 100644 (file)
--- a/docs/reference/gtk/running.sgml
+++ b/docs/reference/gtk/running.sgml
@@ -422,8 +422,9 @@ nevertheless.
   <title><envar>GDK_BACKEND</envar></title>
 
   <para>
-    If set, selects the GDK backend to use. Selecting a backend requires that GTK is compiled
-    with support for that backend. The following backends can be selected:
+    If set, selects the GDK backend to use. Selecting a backend requires that
+    GTK+ is compiled with support for that backend. The following backends can
+    be selected:
     <variablelist>
 
       <varlistentry>
@@ -441,6 +442,16 @@ nevertheless.
         <listitem><para>Selects the native backend for connecting to X11 servers.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term>broadway</term>
+        <listitem><para>Selects the HTML5 backend.</para></listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>wayland</term>
+        <listitem><para>Selects the Wayland backend for connecting to Wayland display servers.</para></listitem>
+      </varlistentry>
+
     </variablelist>
     For more information about selecting backends, see the gdk_display_manager_get() function.
   </para>

diff --git a/docs/reference/gtk/wayland.xml b/docs/reference/gtk/wayland.xml
new file mode 100644 (file)
index 0000000..19fbcb5
--- /dev/null
+++ b/docs/reference/gtk/wayland.xml
@@ -0,0 +1,40 @@
+<?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="gtk-osx">
+<refmeta>
+<refentrytitle>Using GTK+ with Wayland</refentrytitle>
+<manvolnum>3</manvolnum>
+<refmiscinfo>GTK Library</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+<refname>Using GTK+ with Wayland</refname>
+<refpurpose>
+Wayland-specific aspects of using GTK+
+</refpurpose>
+</refnamediv>
+
+<refsect1>
+<title>Using GTK+ with Wayland</title>
+
+<para>
+The GDK Wayland backend provides support for running GTK+ applications
+under the Wayland display server. To run your application in this way,
+select the Wayland backend by setting <literal>GDK_BACKEND=wayland</literal>.
+</para>
+
+<para>
+Currently, the Wayland backend does not use any additional commandline
+options or environment variables.
+</para>
+
+<para>
+For up-to-date information about the current status of this backend, see
+the <ulink url="http://wayland.freedesktop.org/gtk.html">project page</ulink>.
+</para>
+
+</refsect1>
+
+</refentry>

diff --git a/docs/reference/gtk/windows.sgml b/docs/reference/gtk/windows.sgml
index 3de34adf45030b4a959d36bc20d8d645c8af75f7..bea2fbe0849f14a7e5ca128071eac92fc0c52bb7 100644 (file)
--- a/docs/reference/gtk/windows.sgml
+++ b/docs/reference/gtk/windows.sgml
@@ -20,8 +20,9 @@ Windows-specific aspects of using GTK+
 <title>Using GTK+ on Windows</title>
 
 <para>
-The Windows port of GTK+ is an implementation of GDK (and therefore GTK+) 
-on top of the Win32 API. 
+The Windows port of GTK+ is an implementation of GDK (and therefore GTK+)
+on top of the Win32 API. When compiling GTK+ on Windows, this backend is
+the default.
 </para>
 
 <refsect2 id="win32-cmdline">