summaryrefslogtreecommitdiff
path: root/data
diff options
context:
space:
mode:
authorOlivier Fourdan <ofourdan@redhat.com>2019-05-13 11:07:29 +0200
committerOlivier Fourdan <ofourdan@redhat.com>2019-06-03 09:34:31 +0200
commitc9cc07fd3adce271f5e980b758bc651130d30489 (patch)
treec158676d82d79d1d59504a6da54da4e2e5ad39f9 /data
parentf6eb2a8cf8c85bbd630a8076d6d8fe1a8f8407ab (diff)
downloadmutter-c9cc07fd3adce271f5e980b758bc651130d30489.tar.gz
settings: Slack off “xwayland-allow-grabs” setting
To emulate X11 grabs, mutter as a Wayland compositor would disable its own keyboard shortcuts and when the X11 window is an override redirect window (which never receives focus), it also forces keyboard focus onto that X11 O-R window so that all keyboard events are routed to the window, just like an X11 server would. But that's a bit of a “all-or-nothing” approach which prevents applications that would legitimately grab the keyboard under X11 (like virtual machine viewers) to work by default. Change “xwayland-allow-grabs” to control whether the keyboard focus should be locked onto override redirect windows in case of an X11 grab. For stringent needs, careful users can still use the blacklisting feature (i.e. a list containing “!*”) to prevent grabs from any X11 applications to affect other Wayland native applications. https://gitlab.gnome.org/GNOME/mutter/issues/597
Diffstat (limited to 'data')
-rw-r--r--data/org.gnome.mutter.wayland.gschema.xml.in13
1 files changed, 10 insertions, 3 deletions
diff --git a/data/org.gnome.mutter.wayland.gschema.xml.in b/data/org.gnome.mutter.wayland.gschema.xml.in
index 48241296e..bd41e9f18 100644
--- a/data/org.gnome.mutter.wayland.gschema.xml.in
+++ b/data/org.gnome.mutter.wayland.gschema.xml.in
@@ -61,10 +61,17 @@
<key name="xwayland-allow-grabs" type="b">
<default>false</default>
- <summary>Allow grabs with Xwayland</summary>
+ <summary>Allow X11 grabs to lock keyboard focus with Xwayland</summary>
<description>
- Allow keyboard grabs issued by X11 applications running in Xwayland
- to be taken into account.
+ Allow all keyboard events to be routed to X11 “override redirect”
+ windows with a grab when running in Xwayland.
+
+ This option is to support X11 clients which map an “override redirect”
+ window (which do not receive keyboard focus) and issue a keyboard
+ grab to force all keyboard events to that window.
+
+ This option is seldom used and has no effect on regular X11 windows
+ which can receive keyboard focus under normal circumstances.
For a X11 grab to be taken into account under Wayland, the client must
also either send a specific X11 ClientMessage to the root window or be