summaryrefslogtreecommitdiff
path: root/app/xinput/man
diff options
context:
space:
mode:
authorMatthieu Herrb <matthieu@cvs.openbsd.org>2019-08-15 17:38:25 +0000
committerMatthieu Herrb <matthieu@cvs.openbsd.org>2019-08-15 17:38:25 +0000
commit7e618deef6c0cf7d2d9398f7c10c9885efb8b5c3 (patch)
treeeb11f88027d3bca3ded55e9fcf455f1114a401ab /app/xinput/man
parentdd4a2a41edc7f2346f70b80294bc5942e5097638 (diff)
Update to xinput 1.6.3
Diffstat (limited to 'app/xinput/man')
-rw-r--r--app/xinput/man/xinput.man27
1 files changed, 26 insertions, 1 deletions
diff --git a/app/xinput/man/xinput.man b/app/xinput/man/xinput.man
index 87be8c7a3..a9b2148e9 100644
--- a/app/xinput/man/xinput.man
+++ b/app/xinput/man/xinput.man
@@ -87,7 +87,7 @@ instead.
.B --set\-prop [\-\-type=\fIatom|float|int\fP] [\-\-format=\fI8|16|32\fP] \fIdevice\fP \fIproperty\fP \fIvalue\fP [...]
Set the property to the given value(s). If not specified, the format and type
of the property are left as-is. The arguments are interpreted according to the
-property type.
+property type. See Section \fICHANGING PROPERTIES\fP.
.PP
.TP 8
.B --watch-props \fIdevice\fP
@@ -171,6 +171,31 @@ device.
.PP
\fIproperty\fP can be the property as a string or the Atom value.
.PP
+.SH "CHANGING PROPERTIES"
+When xinput should modify an existing driver property value, it is
+sufficient to provide the device name and property name as string, followed
+by the new value(s) of the property. For example:
+.IP
+\fBxinput set-prop "my device" "my prop" 1 2 3\fB
+
+.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 have direct access to the hardware. The X Input
+Extension devices created by Xwayland ("xwayland-pointer",
+"xwayland-keyboard", etc.) map to the Wayland protocol devices,
+not to physical devices.
+.PP
+These X Input Extension devices are only visible to other X clients
+connected to the same Xwayland process. Changing properties on Xwayland
+devices only affects the behavior of those clients. For example, disabling
+an Xwayland device with xinput does not disable the device in Wayland-native
+applications. Other changes may not have any effect at all.
+.PP
+In most instances, using xinput with an Xwayland device is indicative of a
+bug in a shell script and xinput will print a warning. Use the Wayland
+Compositor's native device configuration methods instead.
+
.SH "SEE ALSO"
X(__miscmansuffix__), xset(__appmansuffix__), xrandr(__appmansuffix__)
.SH COPYRIGHT