From 3428edf1ea742dcb76b7f2ec1bdc90b89079c69f Mon Sep 17 00:00:00 2001 From: "Sicelo A. Mhlongo" Date: Tue, 17 Feb 2026 11:57:27 +0200 Subject: [PATCH] doc/user: document keypad slide switch support Part-of: --- doc/user/switches.rst | 23 ++++++++++++++++++++--- doc/user/what-is-libinput.rst | 2 +- 2 files changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/user/switches.rst b/doc/user/switches.rst index 5f7cbced..55ceb829 100644 --- a/doc/user/switches.rst +++ b/doc/user/switches.rst @@ -4,9 +4,9 @@ Switches ============================================================================== -libinput supports the lid and tablet-mode switches. Unlike button events -that come in press and release pairs, switches are usually toggled once and -left at the setting for an extended period of time. +libinput supports the lid, tablet-mode, and keypad slide switches. Unlike +button events that come in press and release pairs, switches are usually +toggled once and left at the setting for an extended period of time. Only some switches are handled by libinput, see **libinput_switch** for a list of supported switches. Switch events are exposed to the caller, but @@ -59,3 +59,20 @@ tablet mode is disengaged. This handling of tablet mode switches is transparent to the user, no notifications are sent and the device appears as enabled at all times. + +.. _switches_keypad_slide: + +------------------------------------------------------------------------------ +Keypad slide switch handling +------------------------------------------------------------------------------ + +Where available, libinput listens to devices providing a keypad slide switch. +This is usually available on devices that have an always-attached physical +keyboard which can slide under the screen. An example of such a device is the +Nokia N900. + +The event sent by the kernel is ``EV_SW`` ``SW_KEYPAD_SLIDE`` and is provided +as **LIBINPUT_SWITCH_KEYPAD_SLIDE**. The keypad slide switch does not cause any +other input devices to be enabled nor disabled in response, since on some +devices the kernel event is sent while the keyboard is partially visible and +thus usable. diff --git a/doc/user/what-is-libinput.rst b/doc/user/what-is-libinput.rst index 123f0967..a3680c5d 100644 --- a/doc/user/what-is-libinput.rst +++ b/doc/user/what-is-libinput.rst @@ -131,7 +131,7 @@ Handled device types - Mice - Keyboards - Virtual absolute pointing devices such as those used by QEMU or VirtualBox -- Switches (Lid Switch and Tablet Mode switch) +- Switches (Lid Switch, Tablet Mode switch, and Keypad Slide switch) - Graphics tablets - :ref:`Trackpoints`