summaryrefslogtreecommitdiff
path: root/man/setxkbmap.man
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2021-07-12 09:46:25 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2021-07-13 12:28:41 +1000
commit13d1e26d696c5113a20dfc2f56c03ddb837a2eac (patch)
tree35813feb77c99c49552119759c4c6bebb5ff60ba /man/setxkbmap.man
parente03ecc3e00b411108449923cf006251b54f91c26 (diff)
Check for Xwayland and print a warning
Running setxkbmap isn't supported by Xwayland, so let's warn the user that this won't work. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Acked-by: Olivier Fourdan <ofourdan@redhat.com>
Diffstat (limited to 'man/setxkbmap.man')
-rw-r--r--man/setxkbmap.man12
1 files changed, 12 insertions, 0 deletions
diff --git a/man/setxkbmap.man b/man/setxkbmap.man
index 926b6f7..d02f25f 100644
--- a/man/setxkbmap.man
+++ b/man/setxkbmap.man
@@ -138,6 +138,18 @@ directly to the \fBxkbcomp\fP input. For example, the command
makes both steps run on the same (client) machine and loads a keyboard map into
the server.
+
+.SH "XWAYLAND"
+Xwayland is an X server that uses a Wayland Compositor as backend.
+Xwayland acts as translation layer between the X protocol and the Wayland
+protocol but does not manage the keymaps - these are handled by the Wayland
+Compositor.
+.PP
+Changing the keymap with \fBsetxkbmap\fP is not supported by Xwayland.
+In most instances, using \fBsetxkbmap\fP on Xwayland is indicative of a
+bug in a shell script and \fBsetxkbmap\fP will print a warning. Use the Wayland
+Compositor's native XKB configuration methods instead.
+
.SH SEE ALSO
xkbcomp(__appmansuffix__), xkeyboard-config(__miscmansuffix__)
.SH FILES