Add support for the libinput plugin system

This is hardcoded to be enabled from the default paths (/usr/share and
/etc) without any extra paths. If there is a need we can add xorg.conf
options later but for now it will do.

Part-of: <https://gitlab.freedesktop.org/xorg/driver/xf86-input-libinput/-/merge_requests/73>

.gitlab-ci.yml

@@ -4,7 +4,7 @@
 # Please see the ci-templates documentation for details:
 # https://freedesktop.pages.freedesktop.org/ci-templates/
 
-.templates_sha: &template_sha 84052757dacc5fd65f5ace92b7fe63c60f6c8558 # see https://docs.gitlab.com/ee/ci/yaml/#includefile
+.templates_sha: &template_sha fb9d50ccb3cbbb4c6dc5f9ef53a0ad3cb0d8a177
 
 include:
   - project: 'freedesktop/ci-templates'
@@ -26,10 +26,10 @@ stages:
 
 .fedora:
   variables:
-    FDO_DISTRIBUTION_VERSION: 39
+    FDO_DISTRIBUTION_VERSION: 43
-    FDO_DISTRIBUTION_PACKAGES: 'git autoconf automake libtool make xorg-x11-server-devel libudev-devel libevdev-devel libinput-devel xorg-x11-util-macros'
+    FDO_DISTRIBUTION_PACKAGES: 'git autoconf automake libtool make xorg-x11-server-devel libudev-devel libevdev-devel libinput-devel xorg-x11-util-macros diffutils'
     FDO_DISTRIBUTION_EXEC: 'env FDO_CI_CONCURRENT=${FDO_CI_CONCURRENT} bash .gitlab-ci/fedora-install.sh'
-    FDO_DISTRIBUTION_TAG: '2024-02-20.0'
+    FDO_DISTRIBUTION_TAG: '2025-10-24.0'
 
 
 fedora@container_build:
@@ -81,18 +81,3 @@ check-commits:
     reports:
       junit: results.xml
   allow_failure: true
-
-#
-# Verify that the merge request has the allow-collaboration checkbox ticked
-#
-check-merge-request:
-  extends:
-    - .fdo.ci-fairy
-  stage: test
-  script:
-    - ci-fairy check-merge-request --require-allow-collaboration --junit-xml=results.xml
-  artifacts:
-    when: on_failure
-    reports:
-      junit: results.xml
-  allow_failure: true

configure.ac

@@ -111,6 +111,17 @@ AC_LINK_IFELSE(
                [AC_MSG_RESULT([no])
                 [libinput_have_clickfinger_button_map=no]])
 
+AC_MSG_CHECKING([if libinput_plugin_system_load is available])
+AC_LINK_IFELSE(
+               [AC_LANG_PROGRAM([[#include <libinput.h>]],
+                                [[libinput_plugin_system_load_plugins(NULL, 0)]])],
+               [AC_MSG_RESULT([yes])
+                AC_DEFINE(HAVE_LIBINPUT_PLUGINS, [1],
+                          [libinput_plugin_system_load_plugins() is available])
+                [libinput_have_plugin_system=yes]],
+               [AC_MSG_RESULT([no])
+                [libinput_have_plugin_system=no]])
+
 LIBS=$OLD_LIBS
 CFLAGS=$OLD_CFLAGS
 

man/libinput.man

@@ -1,6 +1,7 @@
+'\" t
 .\" shorthand for double quote that works everywhere.
 .ds q \N'34'
-.TH LIBINPUT 4 @VERSION@
+.TH LIBINPUT 4 2025-06-01 "@VERSION@"
 .SH NAME
 libinput \- libinput-based X.Org input driver
 .SH SYNOPSIS
@@ -14,42 +15,50 @@ libinput \- libinput-based X.Org input driver
 .fi
 
 .SH NOTE
-This is the man page for the X input driver. If you are looking for the
+This is the man page for the X input driver.
-library documentation, go to
+If you are looking for the library documentation, go to
-.BI http://wayland.freedesktop.org/libinput/doc/
+.B http://wayland.freedesktop.org/libinput/doc/
 
 .SH DESCRIPTION
 .B libinput
-is an Xorg input driver based on libinput.  It
+is an Xorg input driver based on libinput.
-therefore supports all input devices that libinput can handle, including
+It therefore supports all input devices that libinput can handle, including
 most mice, keyboards, tablets and touchscreens.
 .PP
 It is recommended that
 .B libinput
 devices are configured through the
 .B InputClass
-directive (refer to xorg.conf(5)) instead of manual
+directive (refer to
-per-device configuration. Devices configured in the
+.BR xorg.conf (5))
-xorg.conf(5) are not hot-plug capable.
+instead of manual per-device configuration.
+Devices configured using the
+.B InputDevice
+directive in the
+.BR xorg.conf (5)
+file are not hot-plug capable.
 
 .SH CONFIGURATION DETAILS
-Please refer to xorg.conf(5) for general configuration
+Please refer to
-details and for options that can be used with all input drivers.  This
+.BR xorg.conf (5)
-section only covers configuration details specific to this driver.
+for general configuration details
+and for options that can be used with all input drivers.
+This section only covers configuration details specific to this driver.
 .PP
 The following driver
 .B Options
 are supported:
 .TP 7
 .BI "Option \*qAccelProfile\*q \*q" string \*q
-Sets the pointer acceleration profile to the given profile. Permitted values
+Sets the pointer acceleration profile to the given profile.
-are
+Permitted values are
-.BI adaptive,
+.BR adaptive ,
-.BI flat,
+.BR flat ,
-.BI custom.
+.BR custom .
-Not all devices support this option or all profiles. If a profile is
+Not all devices support this option or all profiles.
-unsupported, the default profile for this device is used. For a description
+If a profile is unsupported, the default profile for this device is used.
-on the profiles and their behavior, see the libinput documentation.
+For a description on the profiles and their behavior,
+see the libinput documentation.
 .TP 7
 .BI "Option \*qAccelSpeed\*q \*q" float \*q
 Sets the pointer acceleration speed within the range [-1, 1].
@@ -61,7 +70,8 @@ This only applies to the flat or adaptive profile.
 .TQ
 .BI "Option \*qAccelPointsScroll\*q \*q" string \*q
 Sets the points of the Fallback/Motion/Scroll acceleration functions.
-The string must be a space-separated list of floating point non-negative numbers, e.g.
+The string must be a space-separated list of
+floating point non-negative numbers, e.g.,
 "0.0 1.0 2.4 2.5".
 This only applies to the custom profile.
 See section
@@ -72,22 +82,26 @@ See section
 .BI "Option \*qAccelStepMotion\*q \*q" float \*q
 .TQ
 .BI "Option \*qAccelStepScroll\*q \*q" float \*q
-Sets the step between the points of the Fallback/Motion/Scroll acceleration functions.
+Sets the step between the points of the Fallback/Motion/Scroll
-When a step of 0.0 is provided, libinput's Fallback acceleration function is used.
+acceleration functions.
+When a step of 0.0 is provided,
+libinput's Fallback acceleration function is used.
 This only applies to the custom profile.
 See section
 .B CUSTOM ACCELERATION PROFILE
 .TP 7
 .BI "Option \*qButtonMapping\*q \*q" string \*q
 Sets the logical button mapping for this device, see
-XSetPointerMapping(3). The string must be a
+.BR XSetPointerMapping (3).
-space-separated list of button mappings in the order of the
+The string must be a space-separated list of button mappings in the order of the
 logical buttons on the device, starting with button 1.
-The default mapping is "1 2 3 ... 32". A mapping of 0
+The default mapping is "1 2 3 ... 32".
-deactivates the button. Multiple buttons can have the same mapping.
+A mapping of 0 deactivates the button.
+Multiple buttons can have the same mapping.
 Invalid mapping strings are discarded and the default mapping
-is used for all buttons. Buttons not specified in the user's mapping use the
+is used for all buttons.
-default mapping. See section
+Buttons not specified in the user's mapping use the default mapping.
+See section
 .B BUTTON MAPPING
 for more details.
 .TP 7
@@ -98,44 +112,49 @@ Sets the calibration matrix to the 3x3 matrix where the first row is (abc),
 the second row is (def) and the third row is (ghi).
 .TP 7
 .BI "Option \*qClickMethod\*q \*q" string \*q
-Enables a click method. Permitted values are
+Enables a click method.
-.BI none,
+Permitted values are
-.BI buttonareas,
+.BR none ,
-.BI clickfinger.
+.BR buttonareas ,
-Not all devices support all methods, if an option is unsupported, the
+.BR clickfinger .
-default click method for this device is used.
+Not all devices support all methods.
+If an option is unsupported, the default click method for this device is used.
 .TP 7
 .BI "Option \*qDisableWhileTyping\*q \*q" bool \*q
 Indicates if the touchpad should be disabled while typing on the keyboard
 (this does not apply to modifier keys such as Ctrl or Alt).
 .TP 7
 .BI "Option \*qDevice\*q \*q" string \*q
-Specifies the device through which the device can be accessed.  This will
+Specifies the device through which the device can be accessed.
-generally be of the form \*q/dev/input/eventX\*q, where X is some integer.
+This will generally be of the form \*q/dev/input/eventX\*q,
+where X is some integer.
 When using
 .B InputClass
 directives, this option is set by the server.
-The mapping from device node to hardware is system-dependent. Property:
+The mapping from device node to hardware is system-dependent.
-"Device Node" (read-only).
+Property: "Device Node" (read-only).
 .TP 7
 .BI "Option \*qDragLockButtons\*q \*q" "L1 B1 L2 B2 ..." \*q
 Sets "drag lock buttons" that simulate a button logically down even when it has
-been physically released. To logically release a locked button, a second click
+been physically released.
-of the same button is required.
+To logically release a locked button,
+a second click of the same button is required.
 .IP
 If the option is a single button number, that button acts as the
-"meta" locking button for the next button number. See section
+"meta" locking button for the next button number.
+See section
 .B BUTTON DRAG LOCK
 for details.
 .IP
 If the option is a list of button number pairs, the first number of each
 number pair is the lock button, the second number the logical button number
-to be locked. See section
+to be locked.
+See section
 .B BUTTON DRAG LOCK
 for details.
 .IP
-For both meta and button pair configuration, the button numbers are
+For both meta and button pair configuration,
-device button numbers, i.e. the
+the button numbers are device button numbers, i.e. the
 .B ButtonMapping
 applies after drag lock.
 .TP 7
@@ -145,85 +164,96 @@ the driver forwards only high-resolution wheel scroll events from libinput.
 When disabled, the driver forwards legacy wheel scroll events instead.
 .TP 7
 .BI "Option \*qHorizontalScrolling\*q \*q" bool \*q
-Enables or disables horizontal scrolling. When disabled, this driver will
+Enables or disables horizontal scrolling.
-discard any horizontal scroll events from libinput. This does not disable
+When disabled,
-horizontal scroll events from libinput; it merely discards the horizontal axis
+this driver will discard any horizontal scroll events from libinput.
-from any scroll events. Default is enabled.
+This does not disable horizontal scroll events from libinput;
+it merely discards the horizontal axis from any scroll events.
+Default is enabled.
 .TP 7
 .BI "Option \*qLeftHanded\*q \*q" bool \*q
 Enables left-handed button orientation, i.e. swapping left and right buttons.
 .TP 7
 .BI "Option \*qMiddleEmulation\*q \*q" bool \*q
-Enables middle button emulation. When enabled, pressing the left and right
+Enables middle button emulation.
+When enabled, pressing the left and right
 buttons simultaneously produces a middle mouse button click.
 .TP 7
 .BI "Option \*qNaturalScrolling\*q \*q" bool \*q
 Enables or disables natural scrolling behavior.
 .TP 7
 .BI "Option \*qRotationAngle\*q \*q" float \*q
-Sets the rotation angle of the device to the given angle, in degrees
+Sets the rotation angle of the device to the given angle, in degrees clockwise.
-clockwise. The angle must be between 0.0 (inclusive) and 360.0 (exclusive).
+The angle must be between 0.0 (inclusive) and 360.0 (exclusive).
 .TP 7
 .BI "Option \*qScrollButton\*q \*q" int \*q
-Designates a button as scroll button. If the
+Designates a button as scroll button.
-.BI ScrollMethod
+If the
+.B ScrollMethod
 is
-.BI button
+.B button
 and the button is logically down, x/y axis movement is converted into
 scroll events.
 .TP 7
 .BI "Option \*qScrollButtonLock\*q \*q" bool \*q
-Enables or disables the scroll button lock. If enabled, the
+Enables or disables the scroll button lock.
-.BI ScrollButton
+If enabled, the
+.B ScrollButton
 is considered logically down after the first click and remains down until
-the second click of that button. If disabled (the default), the
+the second click of that button.
-.BI ScrollButton
+If disabled (the default), the
+.B ScrollButton
 button is considered logically down while held down and up once physically
 released.
 .TP 7
 .BI "Option \*qScrollMethod\*q \*q" string \*q
 Enables a scroll method. Permitted values are
-.BI none,
+.BR none ,
-.BI twofinger,
+.BR twofinger ,
-.BI edge,
+.BR edge ,
-.BI button.
+.BR button .
-Not all devices support all options, if an option is unsupported, the
+Not all devices support all options.
-default scroll option for this device is used.
+If an option is unsupported, the default scroll option for this device is used.
 .TP 7
 .BI "Option \*qScrollPixelDistance\*q \*q" int \*q
 Sets the movement distance, in "pixels", required to trigger one logical
-wheel click. This option only applies to the scroll methods
+wheel click.
-.BI twofinger,
+This option only applies to the scroll methods
-.BI edge,
+.BR twofinger ,
-.BI button.
+.BR edge ,
+.BR button .
 See section
 .B SCROLL PIXEL DISTANCE
 for more details.
 .TP 7
 .BI "Option \*qSendEventsMode\*q \*q" (disabled|enabled|disabled-on-external-mouse) \*q
-Sets the send events mode to disabled, enabled, or "disable when an external
+Sets the send events mode to disabled, enabled,
-mouse is connected".
+or "disable when an external mouse is connected".
 .TP 7
 .BI "Option \*qTabletToolPressureCurve\*q \*q" "x0/y0 x1/y1 x2/y2 x3/y3" \*q
 Set the pressure curve for a tablet stylus to the bezier formed by the four
-points. The respective x/y coordinate must be in the [0.0, 1.0] range. For
+points.
-more information see section
+The respective x/y coordinate must be in the [0.0, 1.0] range.
-.B TABLET STYLUS PRESSURE CURVE.
+For more information see section
+.B TABLET TOOL PRESSURE CURVE.
 .TP 7
 .BI "Option \*qTabletToolPressureRange\*q \*q" "min max" \*q
 Set the pressure range for a tablet stylus to the given subset of the physical
-range. The min/max values must be in the [0.0, 1.0] range. For
+range.
-example a min of 0.3 means the tablet will send 0 pressure for anything equal
+The min/max values must be in the [0.0, 1.0] range.
-or below 30% of the physical pressure range and a max of 0.7 means
+For example, a min of 0.3 means the tablet will send 0 pressure for anything
+equal or below 30% of the physical pressure range and a max of 0.7 means
 the tablet sends its maximum pressure value for any pressure equal or higher to
 70% of the physical pressure range.
 .TP 7
 .BI "Option \*qTabletToolAreaRatio\*q \*q" "w:h" \*q
-Sets the area ratio for a tablet tool. The area always starts at the
+Sets the area ratio for a tablet tool.
-origin (0/0) and expands to the largest available area with the specified
+The area always starts at the origin (0/0) and
-aspect ratio. Events outside this area are cropped to the area. The special
+expands to the largest available area with the specified aspect ratio.
-value "default" is used for the default mapping (i.e. the device-native
+Events outside this area are cropped to the area.
-mapping). For more information see section
+The special value "default" is used for the default mapping
+(i.e. the device-native mapping).
+For more information see section
 .B TABLET TOOL AREA RATIO.
 .TP 7
 .BI "Option \*qTapping\*q \*q" bool \*q
@@ -234,49 +264,53 @@ Set the button mapping for 1/2/3-finger taps to left/right/middle or
 left/middle/right, respectively.
 .TP 7
 .BI "Option \*qTappingDrag\*q \*q" bool \*q
-Enables or disables drag during tapping behavior ("tap-and-drag"). When
+Enables or disables drag during tapping behavior ("tap-and-drag").
-enabled, a tap followed by a finger held down causes a single button down
+When enabled, a tap followed by a finger held down causes a single button down
 only, all motions of that finger thus translate into dragging motion.
 Tap-and-drag requires option
 .B Tapping
 to be enabled.
 .TP 7
 .BI "Option \*qTappingDragLock\*q \*q" bool \*q
-Enables or disables drag lock during tapping behavior. When enabled, a
+Enables or disables drag lock during tapping behavior.
-finger up during tap-and-drag will not immediately release the button. If
+When enabled,
-the finger is set down again within the timeout, the dragging process
+a finger up during tap-and-drag will not immediately release the button.
-continues.
+If the finger is set down again within the timeout,
+the dragging process continues.
 .PP
 For all options, the options are only parsed if the device supports that
-configuration option. For all options, the default value is the one used by
+configuration option.
-libinput. On configuration failure, the default value is applied.
+For all options, the default value is the one used by libinput.
+On configuration failure, the default value is applied.
 
 .SH SUPPORTED PROPERTIES
 .B libinput
-exports runtime-configurable options as properties. If a property listed
+exports runtime-configurable options as properties.
-below is not available, the matching configuration option is not available
+If a property listed below is not available,
-on the device. This however does not imply that the feature is not available
+the matching configuration option is not available on the device.
-on the device. The following properties are provided by the
+This however does not imply that the feature is not available on the device.
+The following properties are provided by the
 .B libinput
 driver.
 .TP 7
-.BI "libinput Accel Profiles Available"
+.B "libinput Accel Profiles Available"
 3 boolean values (8 bit, 0 or 1), in order "adaptive", "flat", "custom".
 Indicates which acceleration profiles are available on this device.
 .TP 7
-.BI "libinput Accel Profile Enabled"
+.B "libinput Accel Profile Enabled"
 3 boolean values (8 bit, 0 or 1), in order "adaptive", "flat", "custom".
 Indicates which acceleration profile is currently enabled on this device.
 .TP 7
-.BI "libinput Accel Speed"
+.B "libinput Accel Speed"
-1 32-bit float value, defines the pointer speed. Value range -1, 1.
+1 32-bit float value, defines the pointer speed.
+Value range -1, 1.
 This only applies to the flat or adaptive profile.
 .TP 7
-.BI "libinput Accel Custom Fallback Points"
+.B "libinput Accel Custom Fallback Points"
 .TQ
-.BI "libinput Accel Custom Motion Points"
+.B "libinput Accel Custom Motion Points"
 .TQ
-.BI "libinput Accel Custom Scroll Points"
+.B "libinput Accel Custom Scroll Points"
 A space-separated list of 32-bit floating point non-negative numbers, e.g.
 "0.0 1.0 2.4 2.5".
 Sets the points of the Fallback/Motion/Scroll acceleration functions.
@@ -284,11 +318,11 @@ This only applies to the custom profile.
 See section
 .B CUSTOM ACCELERATION PROFILE
 .TP 7
-.BI "libinput Accel Custom Fallback Step"
+.B "libinput Accel Custom Fallback Step"
 .TQ
-.BI "libinput Accel Custom Motion Step"
+.B "libinput Accel Custom Motion Step"
 .TQ
-.BI "libinput Accel Custom Scroll Step"
+.B "libinput Accel Custom Scroll Step"
 1 32-bit float value, sets the step between the points of the
 Fallback/Motion/Scroll acceleration functions.
 When a step of 0.0 is provided, libinput's Fallback acceleration
@@ -297,113 +331,122 @@ This only applies to the custom profile.
 See section
 .B CUSTOM ACCELERATION PROFILE
 .TP 7
-.BI "libinput Button Scrolling Button"
+.B "libinput Button Scrolling Button"
-1 32-bit value. Sets the button number to use for button scrolling. This
+1 32-bit value. Sets the button number to use for button scrolling.
-setting is independent of the scroll method, to enable button scrolling the
+This setting is independent of the scroll method, to enable button scrolling the
 method must be set to button-scrolling and a valid button must be set.
 .TP 7
-.BI "libinput Button Scrolling Button Lock Enabled"
+.B "libinput Button Scrolling Button Lock Enabled"
-1 boolean value. If true, the scroll button lock is enabled.  This
+1 boolean value. If true, the scroll button lock is enabled.
-setting is independent of the scroll method or the scroll button, to enable
+This setting is independent of the scroll method or the scroll button, to enable
 button scrolling the method must be set to button-scrolling and a valid
 button must be set.
 .TP 7
-.BI "libinput Calibration Matrix"
+.B "libinput Calibration Matrix"
 9 32-bit float values, representing a 3x3 calibration matrix, order is row
 1, row 2, row 3
 .TP 7
-.BI "libinput Click Methods Available"
+.B "libinput Click Methods Available"
 2 boolean values (8 bit, 0 or 1), in order "buttonareas", "clickfinger".
 Indicates which click methods are available on this device.
 .TP 7
-.BI "libinput Click Methods Enabled"
+.B "libinput Click Methods Enabled"
 2 boolean values (8 bit, 0 or 1), in order "buttonareas", "clickfinger".
 Indicates which click methods are enabled on this device.
 .TP 7
-.BI "libinput Drag Lock Buttons"
+.B "libinput Drag Lock Buttons"
 Either one 8-bit value specifying the meta drag lock button, or a list of
-button pairs. See section
+button pairs.
+See section
 .B BUTTON DRAG LOCK
 for details.
 .TP 7
-.BI "libinput High Resolution Wheel Scroll Enabled"
+.B "libinput High Resolution Wheel Scroll Enabled"
-1 boolean value (8 bit, 0 or 1). Indicates whether high-resolution
+1 boolean value (8 bit, 0 or 1).
-wheel scroll events are enabled or not.
+Indicates whether high-resolution wheel scroll events are enabled or not.
 .TP 7
-.BI "libinput Horizontal Scroll Enabled"
+.B "libinput Horizontal Scroll Enabled"
-1 boolean value (8 bit, 0 or 1). Indicates whether horizontal scrolling
+1 boolean value (8 bit, 0 or 1).
-events are enabled or not.
+Indicates whether horizontal scrolling events are enabled or not.
 .TP 7
-.BI "libinput Left Handed Enabled"
+.B "libinput Left Handed Enabled"
-1 boolean value (8 bit, 0 or 1). Indicates if left-handed mode is enabled or
+1 boolean value (8 bit, 0 or 1).
-disabled.
+Indicates if left-handed mode is enabled or disabled.
 .TP 7
-.BI "libinput Middle Emulation Enabled"
+.B "libinput Middle Emulation Enabled"
-1 boolean value (8 bit, 0 or 1). Indicates if middle emulation is enabled or
+1 boolean value (8 bit, 0 or 1).
-disabled.
+Indicates if middle emulation is enabled or disabled.
 .TP 7
-.BI "libinput Natural Scrolling Enabled"
+.B "libinput Natural Scrolling Enabled"
-1 boolean value (8 bit, 0 or 1). 1 enables natural scrolling
+1 boolean value (8 bit, 0 or 1).
+1 enables natural scrolling.
 .TP 7
-.BI "libinput Rotation Angle"
+.B "libinput Rotation Angle"
-1 32-bit float value [0.0 to 360.0). Sets the rotation angle of the device,
+1 32-bit float value [0.0 to 360.0).
+Sets the rotation angle of the device,
 clockwise of its natural neutral position.
 .TP 7
-.BI "libinput Scroll Methods Available"
+.B "libinput Scroll Methods Available"
 3 boolean values (8 bit, 0 or 1), in order "two-finger", "edge", "button".
 Indicates which scroll methods are available on this device.
 .TP 7
-.BI "libinput Scroll Method Enabled"
+.B "libinput Scroll Method Enabled"
 3 boolean values (8 bit, 0 or 1), in order "two-finger", "edge", "button".
 Indicates which scroll method is currently enabled on this device.
 .TP 7
-.BI "libinput Scroll Pixel Distance"
+.B "libinput Scroll Pixel Distance"
 1 32-bit value (nonzero, with additional implementation-defined range checks).
 Changes the movement distance required to trigger one logical wheel click.
 .TP 7
-.BI "libinput Send Events Modes Available"
+.B "libinput Send Events Modes Available"
 2 boolean values (8 bit, 0 or 1), in order "disabled" and
-"disabled-on-external-mouse". Indicates which send-event modes are available
+"disabled-on-external-mouse".
-on this device.
+Indicates which send-event modes are available on this device.
 .TP 7
-.BI "libinput Send Events Mode Enabled"
+.B "libinput Send Events Mode Enabled"
 2 boolean values (8 bit, 0 or 1), in order "disabled" and
-"disabled-on-external-mouse". Indicates which send-event modes is currently
+"disabled-on-external-mouse".
-enabled on this device.
+Indicates which send-event mode is currently enabled on this device.
 .TP 7
-.BI "libinput Tablet Tool Pressurecurve"
+.B "libinput Tablet Tool Pressurecurve"
-4 32-bit float values [0.0 to 1.0]. See section
+4 32-bit float values [0.0 to 1.0].
+See section
 .B TABLET TOOL PRESSURE CURVE
 .TP 7
-.BI "libinput Tablet Tool Area Ratio"
+.B "libinput Tablet Tool Area Ratio"
-2 32-bit values, corresponding to width and height. Special value 0, 0
+2 32-bit values, corresponding to width and height.
-resets to the default ratio. See section
+Special value 0, 0 resets to the default ratio.
+See section
 .B TABLET TOOL AREA RATIO
 for more information.
 .TP 7
-.BI "libinput Tapping Enabled"
+.B "libinput Tapping Enabled"
-1 boolean value (8 bit, 0 or 1). 1 enables tapping
+1 boolean value (8 bit, 0 or 1).
+1 enables tapping.
+.TP 7.
+.B "libinput Tapping Button Mapping Enabled"
+2 boolean value (8 bit, 0 or 1), in order "lrm" and "lmr".
+Indicates which button mapping is currently enabled on this device.
 .TP 7
-.BI "libinput Tapping Button Mapping Enabled"
+.B "libinput Tapping Drag Lock Enabled"
-2 boolean value (8 bit, 0 or 1), in order "lrm" and "lmr". Indicates which
+1 boolean value (8 bit, 0 or 1).
-button mapping is currently enabled on this device.
+1 enables drag lock during tapping.
 .TP 7
-.BI "libinput Tapping Drag Lock Enabled"
+.B "libinput Disable While Typing Enabled"
-1 boolean value (8 bit, 0 or 1). 1 enables drag lock during tapping
+1 boolean value (8 bit, 0 or 1).
-.TP 7
+Indicates if disable while typing is enabled or disabled.
-.BI "libinput Disable While Typing Enabled"
-1 boolean value (8 bit, 0 or 1). Indicates if disable while typing is
-enabled or disabled.
 .PP
 Most properties have a
-.BI "libinput <property name> Default"
+.B "libinput <property name> Default"
 equivalent that indicates the default value for this setting on this device.
 
 .SH BUTTON MAPPING
-X clients receive events with logical button numbers, where 1, 2, 3
+X clients receive events with logical button numbers,
-are usually interpreted as left, middle, right and logical buttons 4, 5, 6,
+where 1, 2, 3 are usually interpreted as left, middle, right;
-7 are usually interpreted as scroll up, down, left, right. The fourth and
+and logical buttons 4, 5, 6, 7 are usually interpreted
-fifth physical buttons on a device will thus send logical buttons 8 and 9.
+as scroll up, down, left, right.
+The fourth and fifth physical buttons on a device
+will thus send logical buttons 8 and 9.
 The
 .B ButtonMapping
 option adjusts the logical button mapping, it does not affect how a physical
@@ -421,79 +464,92 @@ option instead.
 The
 .B libinput
 Xorg input driver does not use the button mapping after setup.
-Use XSetPointerMapping(3) to modify the button mapping at
+Use
-runtime.
+.BR XSetPointerMapping (3)
+to modify the button mapping at runtime.
 
 .SH BUTTON DRAG LOCK
 Button drag lock holds a button logically down even when the button itself
-has been physically released since. Button drag lock comes in two modes.
+has been physically released since.
+Button drag lock comes in two modes.
 .PP
 If in "meta" mode, a meta button click activates drag lock for the next
-button press of any other button. A button click in the future will keep
+button press of any other button.
-that button held logically down until a subsequent click of that same
+A button click in the future will keep that button held logically down
-button. The meta button events themselves are discarded. A separate meta
+until a subsequent click of that same button.
-button click is required each time a drag lock should be activated for a
+The meta button events themselves are discarded.
-button in the future.
+A separate meta button click is required each time a drag lock should be
+activated for a button in the future.
 .PP
 If in "pairs" mode, each button can be assigned a target locking button.
 On button click, the target lock button is held logically down until the
-next click of the same button. The button events themselves are discarded
+next click of the same button.
+The button events themselves are discarded
 and only the target button events are sent.
-.TP
+.PP
 This feature is provided by this driver, not by libinput.
 
-.SH TABLET TOOL PRESSURECURVE
+.SH TABLET TOOL PRESSURE CURVE
-The pressure curve affects how stylus pressure is reported. By default, the
+The pressure curve affects how stylus pressure is reported.
-hardware pressure is reported as-is. By setting a pressure curve, the feel
+By default, the hardware pressure is reported as-is.
-of the stylus can be adjusted to be more like e.g. a pencil or a brush.
+By setting a pressure curve, the feel of the stylus can be adjusted
+to be more like e.g. a pencil or a brush.
 .PP
 The pressure curve is a cubic Bezier curve, drawn within a normalized range
-of 0.0 to 1.0 between the four points provided. This normalized range is
+of 0.0 to 1.0 between the four points provided.
-applied to the tablet's pressure input so that the highest pressure maps to
+This normalized range is applied to the tablet's pressure input
-1.0. The points must have increasing x coordinates, if x0 is larger than 0.0
+so that the highest pressure maps to 1.0.
-all pressure values lower than x0 are equivalent to y0. If x3 is less than
+The points must have increasing x coordinates, if x0 is larger than 0.0
-1.0, all pressure values higher than x3  are equivalent to y3.
+all pressure values lower than x0 are equivalent to y0.
-
+If x3 is less than 1.0,
-The input for a linear  curve  (default) is  "0.0/0.0 0.0/0.0 1.0/1.0 1.0/1.0";
+all pressure values higher than x3 are equivalent to y3.
-a slightly
+.PP
-depressed curve (firmer) might be "0.0/0.0 0.05/0.0 1.0/0.95 1.0/1.0"; a slightly raised
+The input for a linear curve (default) is  "0.0/0.0 0.0/0.0 1.0/1.0 1.0/1.0";
-curve (softer) might  be "0.0/0.0 0.0/0.05 0.95/1.0 1.0/1.0".
+a slightly depressed curve (firmer) might be
-.TP
+"0.0/0.0 0.05/0.0 1.0/0.95 1.0/1.0";
+a slightly raised curve (softer) might be "0.0/0.0 0.0/0.05 0.95/1.0 1.0/1.0".
+.PP
 This feature is provided by this driver, not by libinput.
 
 .SH TABLET TOOL AREA RATIO
 By default, a tablet tool can access the whole sensor area and the tablet
-area is mapped to the available screen area. For external tablets like
+area is mapped to the available screen area.
-the Wacom Intuos series, the height:width ratio of the tablet may be
+For external tablets like the Wacom Intuos series,
-different to that of the monitor, causing the skew of input data.
+the height:width ratio of the tablet may be different to that of the monitor,
+causing the skew of input data.
 .PP
 To avoid this skew of input data, an area ratio may be set to match the
-ratio of the screen device. For example, a ratio of 4:3 will reduce the
+ratio of the screen device.
-available area of the tablet to the largest available area with a ratio of
+For example, a ratio of 4:3 will reduce the available area of the tablet
-4:3. Events within this area will scale to the tablet's announced axis
+to the largest available area with a ratio of 4:3.
-range, the area ratio is thus transparent to the X server. Any events
+Events within this area will scale to the tablet's announced axis range,
-outside this area will send events equal to the maximum value of that axis.
+the area ratio is thus transparent to the X server.
-The area always starts at the device's origin in it's current rotation, i.e.
+Any events outside this area will send events equal to the maximum value of
+that axis.
+The area always starts at the device's origin in it's current rotation, i.e.,
 it takes left-handed-ness into account.
-.TP
+.PP
 This feature is provided by this driver, not by libinput.
 
 .SH SCROLL PIXEL DISTANCE
 The X server does not support per-pixel scrolling but it does support
-smooth scrolling. All scroll events however are based around a logical
+smooth scrolling.
-unit of scrolling (traditionally corresponding to a wheel click).
+All scroll events however are based around a logical unit of scrolling
+(traditionally corresponding to a wheel click).
 It is thus not possible to scroll by 10 pixels, but it is possible for a
 driver to scroll by 1/10th of a logical wheel click.
 .PP
-libinput provides scroll data in pixels. The \fBScrollPixelDistance\fR
+libinput provides scroll data in pixels.
-option defines the amount of movement equivalent to one wheel click. For
+The \fBScrollPixelDistance\fR option defines the amount of movement equivalent
-example, a value of 50 means the user has to move a finger by 50 pixels to
+to one wheel click.
+For example, a value of 50 means the user has to move a finger by 50 pixels to
 generate one logical click event and each pixel is 1/50th of a wheel click.
 
 .SH CUSTOM ACCELERATION PROFILE
 The custom pointer acceleration profile gives users full control over the
-acceleration behavior at different speeds. libinput exposes an acceleration
+acceleration behavior at different speeds.
-function f(x) where the x-axis is the device speed in device units per millisecond
+libinput exposes an acceleration function \fIf(x)\fP
+where the x-axis is the device speed in device units per millisecond
 and the y-axis is the pointer speed.
 .PP
 The custom acceleration function is defined using n points which are spaced
@@ -503,9 +559,11 @@ Thus the points defining the custom function are:
 (0 * step, f[0]), (1 * step, f[1]), ..., ((n-1) * step, f[n-1])
 .EE
 When a velocity value does not lie exactly on those points,
-a linear interpolation/extrapolation of the two closest points will be calculated.
+a linear interpolation/extrapolation of the two closest points
+will be calculated.
 .PP
-There are 3 custom acceleration function, which are used for different movement types:
+There are 3 custom acceleration functions,
+which are used for different movement types:
 .TS
 tab(;) allbox;
 l l l.
@@ -515,16 +573,20 @@ Motion; Used for pointer motion; All devices
 Scroll; Used for scroll movement; Mouse, Touchpad
 .TE
 .PP
-See libinput library documentation of more details:
+See libinput library documentation for more details:
 https://wayland.freedesktop.org/libinput/doc/latest/pointer-acceleration.html#the-custom-acceleration-profile
 
 .SH BUGS
 This driver does not work with \fBOption \*qDevice\*q\fR set to an event
-node in \fI/dev/input/by-id\fR and \fI/dev/input/by-path\fR. This can be
+node in \fI/dev/input/by-id\fR and \fI/dev/input/by-path\fR.
-usually be worked by using \fBSection \*qInputClass\*q\fR with an
+This can be usually be worked by using \fBSection \*qInputClass\*q\fR with an
-appropriate \fBMatch*\fR statement in the xorg.conf(5).
+appropriate \fBMatch*\fR statement in the
+.BR xorg.conf (5).
 
 .SH AUTHORS
 Peter Hutterer
 .SH "SEE ALSO"
-Xorg(1), xorg.conf(5), Xserver(1), X(7)
+.BR Xorg (1),
+.BR xorg.conf (5),
+.BR Xserver (1),
+.BR X (7)

meson.build

@@ -65,9 +65,13 @@ if cc.has_function('libinput_device_config_click_set_clickfinger_button_map',
 		   dependencies: dep_libinput)
 	config_h.set('HAVE_LIBINPUT_CLICKFINGER_BUTTON_MAP', 1)
 endif
-if cc.has_header_symbol('libinput.h', 'LIBINPUT_LED_COMPOSE')
+if cc.has_header_symbol('libinput.h', 'LIBINPUT_LED_COMPOSE',
+			dependencies: dep_libinput)
 	config_h.set('HAVE_LIBINPUT_COMPOSE_AND_KANA', 1)
 endif
+if cc.has_function('libinput_plugin_system_load_plugins', dependencies: dep_libinput)
+	config_h.set('HAVE_LIBINPUT_PLUGINS', 1)
+endif
 
 dir_headers = get_option('sdkdir')
 if dir_headers == ''
@@ -146,6 +150,8 @@ configure_file(
 	install_dir: dir_man4
 )
 
+install_headers('include/libinput-properties.h', install_dir: dir_headers)
+
 install_data('conf/40-libinput.conf', install_dir: dir_xorg_conf)
 
 # Now generate config.h

src/xf86libinput.c

@@ -831,7 +831,9 @@ LibinputApplyConfigClickMethod(DeviceIntPtr dev,
 			       struct libinput_device *device)
 {
 	InputInfoPtr pInfo = dev->public.devicePrivate;
+#if HAVE_LIBINPUT_CLICKFINGER_BUTTON_MAP
 	uint32_t click_methods = libinput_device_config_click_get_methods(device);
+#endif
 
 	if (!subdevice_has_capabilities(dev, CAP_POINTER))
 		return;
@@ -3852,6 +3854,10 @@ xf86libinput_init_driver_context(void)
 		/* we want all msgs, let the server filter */
 		libinput_log_set_priority(driver_context.libinput,
 					  LIBINPUT_LOG_PRIORITY_DEBUG);
+#if HAVE_LIBINPUT_PLUGINS
+		libinput_plugin_system_append_default_paths(driver_context.libinput);
+		libinput_plugin_system_load_plugins(driver_context.libinput, LIBINPUT_PLUGIN_SYSTEM_FLAG_NONE);
+#endif
 	} else {
 		libinput_ref(driver_context.libinput);
 	}