wayland/doc/publican/sources
Dima Ryazanov fb7e130217 client: require WAYLAND_DISPLAY to be set
Although defaulting to wayland-0 seems convenient, it has an undesirable
side effect: clients may unintentionally connect to the wrong compositor.
Generally, it's safer to fail instead. Here's a real example:

In Fedora 22, Gtk+ prefers Wayland over X11, though the default session is still
a normal X11 Gnome session. When you launch a Gtk+ app, it will try Wayland,
fail, then try X11, and succesfully start up. That works fine.

Now suppose you launch Weston while running the Gnome session. Suddenly, all
of the Gtk+ apps launched from Gnome will show up inside Weston instead.
That's unexpected. There's also no good way to prevent that from happening
(other than perhaps setting WAYLAND_DISPLAY to an invalid value when launching
an app).

Not using wayland-0 as the default will solve that problem: an app launched
from the X11 Gnome session will use the X11 backend regardless of whether
there's a wayland compositor running at the same time.

Everything else should work as before. The compositor already sets
the WAYLAND_DISPLAY when starting the session, so the lack of the default value
should not make a difference to the user.

Signed-off-by: Dima Ryazanov <dima@gmail.com>
Acked-by: Pekka Paalanen <ppaalanen@gmail.com>
Acked-by: Giulio Camuffo <giuliocamuffo@gmail.com>
Acked-by: Daniel Stone <daniel@fooishbar.org>
Acked-by: Jasper St. Pierre <jstpierre@mecheye.net>
Reviewed-by: Ryo Munakata <ryomnktml@gmail.com>

[Pekka: dropped the wayland-server.c hunk, adjusted summary]

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
2015-08-14 10:14:05 +03:00
..
css doc: replace publican with xmlto 2014-09-22 10:30:41 +03:00
images doc: Switch from static image files to generated diagrams. 2015-01-28 17:43:16 -08:00
Architecture.xml doc: Create hot-linked areas in documents. 2015-01-28 17:43:18 -08:00
Author_Group.xml doc: rename "Wayland" to "publican" 2013-04-03 15:44:50 -04:00
Book_Info.xml publican: Update docs license from MIT "X11" to MIT "Expat" style 2015-06-22 14:50:10 +03:00
Client.xml Spelling fixes (cosmetic) 2015-03-19 16:56:17 +02:00
Compositors.xml doc: Improve "Library" and "Compositors" chapter 2013-04-04 16:57:44 -04:00
Foreword.xml publican: Cleanup Preface's grammar. 2013-08-08 21:38:14 -07:00
Introduction.xml publican: Drop unneeded 'of' 2013-08-08 21:38:28 -07:00
Preface.xml doc: rename "Wayland" to "publican" 2013-04-03 15:44:50 -04:00
Protocol.xml client: require WAYLAND_DISPLAY to be set 2015-08-14 10:14:05 +03:00
Revision_History.xml doc: rename "Wayland" to "publican" 2013-04-03 15:44:50 -04:00
Server.xml doc: Intro text for doxygen output in it's own file 2015-01-29 17:13:01 -08:00
Wayland.ent doc: rename "Wayland" to "publican" 2013-04-03 15:44:50 -04:00
Wayland.xml doc: Intro text for doxygen output in it's own file 2015-01-29 17:13:01 -08:00