doc/user: document that we're only using internal devices for DWT

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

diff --git a/doc/user/configuration.rst b/doc/user/configuration.rst
index 1b1686e40c23acb4d54343d6764aefabaec64307..17543d40706bc551af56b45c42c9e3363f259c3c 100644 (file)
--- a/doc/user/configuration.rst
+++ b/doc/user/configuration.rst
@@ -135,8 +135,9 @@ Disable while typing
 ------------------------------------------------------------------------------
 
 DWT is the most generic form of palm detection on touchpad. While the user
-is typing the touchpad is disabled, the touchpad is enabled after a timeout.
-See :ref:`disable-while-typing` for more info.
+is typing on an internal keyboard the touchpad is disabled, the touchpad
+is enabled again after a timeout.  See :ref:`disable-while-typing` for more
+info.
 
 Disable-while-typing can be enabled or disabled, it is enabled by default on
 most touchpads.

diff --git a/doc/user/palm-detection.rst b/doc/user/palm-detection.rst
index 9e469b9eef7cedd6b4a5e505e04f093c5d881bdc..3cd263d92e3a3d6fe761f6d0ce200c30fdc53f56 100644 (file)
--- a/doc/user/palm-detection.rst
+++ b/doc/user/palm-detection.rst
@@ -157,6 +157,11 @@ Notable behaviors of libinput's disable-while-typing feature:
   typing.
 - Physical buttons work even while the touchpad is disabled. This includes
   :ref:`software-emulated buttons <t440_support>`.
+- libinput pairs touchpads and keyboards for the disable-while-typing
+  feature. In the most common case, the internal touchpad is paired only
+  with the internal keyboard. Typing on an external keyboard will thus not
+  disable the touchpad. Some devices require a :ref:`quirk <device-quirks>`
+  to be correctly paired.
 
 Disable-while-typing can be enabled and disabled by calling
 **libinput_device_config_dwt_set_enabled()**.