diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/switches.dox | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/switches.dox b/doc/switches.dox index 4bb2675..5153dc2 100644 --- a/doc/switches.dox +++ b/doc/switches.dox @@ -13,4 +13,22 @@ specific features based on a switch state. The order of switch events is guaranteed to be correct, i.e., a switch will never send consecutive switch on, or switch off, events. +@section switches_lid Lid switch handling + +Where available, libinput listens to devices providing a lid switch. +The evdev event code `EV_SW` `SW_LID` is provided as @ref +LIBINPUT_SWITCH_LID. If devices with a lid switch have a touchpad device, +the device is disabled while the lid is logically closed. This is to avoid +ghost touches that can be caused by interference with touchpads and the +closed lid. The touchpad is automatically re-enabled whenever the lid is +openend. + +This handling of lid switches is transparent to the user, no notifications +are sent and the device appears as enabled at all times. + +On some devices, the device's lid state does not always reflect the physical +state and the lid state may report as closed even when the lid is physicall +open. libinput employs some heuristics to detect user input (specificially +typing) to re-enable the touchpad on those devices. + */ |