summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* AttrLidSwitchReliability quirk default unreliable->reliableAlexander Courtis2022-04-262-6/+7
|
* doc/user: add a page to troubleshoot right-click ClickpadsPeter Hutterer2022-03-283-0/+49
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* meson: replace a meson.source_root() with the explicit directoryPeter Hutterer2022-03-281-1/+1
| | | | | | Removes the warning that source_root() has been deprecated since 0.56.0 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* meson: fix a meson warningPeter Hutterer2022-03-281-1/+2
| | | | | | | | | | | run_command() wants a check kwarg now: WARNING: You should add the boolean check kwarg to the run_command call. It currently defaults to false, but it will default to true in future releases of meson. See also: https://github.com/mesonbuild/meson/issues/9300 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* touchpad: new option dwtp (disable-while-trackpointing)pudiva chip líquida2022-03-082-0/+27
| | | | | | | | | Add option to control whether the touchpad should be disabled while the trackpoint is in use. Fix #731 Signed-off-by: pudiva chip líquida <pudiva@skylittlesystem.org>
* doc/user: clarify fork visibilityJosé Expósito2022-02-141-2/+2
| | | | | | | | | Clarify that when forking libinput the public visibility level should be selected. Otherwise, CI pipelines will fail on merge requests. Also, update the fork URL. Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc: correct the documentation for reporting trackpoint bugsPeter Hutterer2022-02-111-2/+1
| | | | | | | | libinput measure trackpoint-range was removed in 1.12 Fixes #734 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc: document disambiguation between two finger pinch and scrollJosé Expósito2022-01-271-1/+2
| | | | Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc/user: write an article explaining the different contextsPeter Hutterer2021-12-131-0/+24
| | | | | | | This is a common question I need to answer, let's make this a link I can copy/paste instead. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: fix broken link to "Observations on trackpoint input data"José Expósito2021-11-281-1/+1
| | | | Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc/user: add an example udev rule for LIBINPUT_IGNORE_DEVICEPeter Hutterer2021-11-161-0/+9
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: expand the udev rules for better readabilityPeter Hutterer2021-11-161-6/+12
| | | | | | | Split it over multiple lines and use fake cat command to show where that rule could live. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: fix broken link to systemd 60-evdev.hwdbJosé Expósito2021-10-301-1/+1
| | | | Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* fallback: hires scroll heuristics for buggy devicesJosé Expósito2021-09-273-0/+65
| | | | | | | | | | | | | | Some devices might announce support for high-resolution scroll wheel by enabling REL_WHEEL_HI_RES and/or REL_HWHEEL_HI_RES but never send a high-resolution scroll event. When the first low-resolution scroll event is received without any previous high-resolution event, print a kernel bug warning and start emulating high-resolution scroll events. Fix #668 Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc: add missing literal blocks in contributingJosé Expósito2021-09-061-5/+5
| | | | | | | Add missing literal blocks in the section "Failed pipeline errors" introduced in 140b4b78530b62f8dc70645153b75b4adae23ed9. Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* High-resolution scroll wheel supportPeter Hutterer2021-08-314-0/+188
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Starting with kernel v5.0 two new axes are available for high-resolution wheel scrolling: REL_WHEEL_HI_RES and REL_HWHEEL_HI_RES. Both axes send data in fractions of 120 where each multiple of 120 amounts to one logical scroll event. Fractions of 120 indicate a wheel movement less than one detent. This commit adds a new API for scroll events. Three new event types that encode the axis source in the event type name and a new API to get a normalized-to-120 value that also used by Windows and the kernel (each multiple of 120 represents a logical scroll click). This addresses a main shortcoming with the existing API - it was unreliable to calculate the click angle based on the axis value+discrete events and thus any caller using the axis value alone would be left with some ambiguity. With the v120 API it's now possible to (usually) calculate the click angle, but more importantly it provides the simplest hw-independent way of scrolling by a click or a fraction of a click. A new event type is required, the only way to integrate the v120 value otherwise was to start sending events with a discrete value of 0. This would break existing xf86-input-libinput (divide by zero, fixed in 0.28.2) and weston (general confusion). mutter, kwin are unaffected. With the new API, the old POINTER_AXIS event are deprecated - callers should use the new API where available and discard any POINTER_AXIS events. Notable: REL_WHEEL/REL_HWHEEL are emulated by the kernel but there's no guarantee that they'll come every accumulated 120 values, e.g. Logitech mice often send events that don't add up to 120 per detent. We use the kernel's wheel click emulation instead of doing our own. libinput guarantees high-resolution events even on pre-5.0 kernels. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* meson.build: use the / operator instead of join_pathsJosé Expósito2021-08-031-2/+2
| | | | | | | | | Starting with meson v0.49.0, the "/" operator can be used instead of join_paths. Update meson to v0.49.0 and remove all calls to join_paths. Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc: add common failed pipeline errorsJosé Expósito2021-07-301-0/+95
| | | | | | | Add a section in the contributing documentation with common pipeline errors and how to fix them and point to this page when the CI fails. Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* quirks: Add tablet smoothing attribute.Quytelda Kahja2021-07-281-0/+3
| | | | | | | | | | | | https://gitlab.freedesktop.org/libinput/libinput/-/merge_requests/512 disables input smoothing for AES devices. However, some AES devices produce segmented/wobbly curves without smoothing. This change introduces an `AttrTabletSmoothing` boolean property, which overrides the default smoothing behavior. See #632 Signed-off-by: Quytelda Kahja <quytelda@tamalin.org>
* doc/user: move the hold gesture section up to the othersPeter Hutterer2021-07-271-77/+77
| | | | | | Better structuring this way: pinch, swipe, hold, then other comments Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: fix the line alignments for the hold gesture tablesPeter Hutterer2021-07-271-81/+73
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: make "verifying install" command portableAndrea Ippolito2021-07-261-6/+4
| | | | | | | | | | | | According to the linker man page libraries are searched in the following paths: LD_LIBRARY_PATH environment variable Paths in the cache file /etc/ld.so.cache /lib, /usr/lib, /lib64 and /usr/lib64 As we are not using LD_LIBRARY_PATH, we can rely on ldconfig as a fairly portable solution because it "creates the necessary links and cache to the most recent shared libraries found in the directories specified on the command line, in the file /etc/ld.so.conf, and in the trusted directories (/lib and /usr/lib)". Tested on fedora 34, manjaro 2021.07, kubuntu 21.04 Signed-off-by: Andrea Ippolito <andrea.ippo@gmail.com>
* doc: add touchpad gestures state machine diagramJosé Expósito2021-06-091-0/+3
| | | | Signed-off-by: José Expósito <jose.exposito89@gmail.com>
* doc: add docs for hold gesturesPeter Hutterer2021-06-091-0/+229
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc: note that gestures may be cancelledPeter Hutterer2021-06-091-3/+4
| | | | | | This has been in place forever, so let's note it in the docs. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: #wayland is now on oftcPeter Hutterer2021-05-251-1/+1
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* evdev: restart debouncing timers after every eventsatrmb2021-05-191-1/+1
| | | | Signed-off-by: satrmb <10471-satrmb@users.noreply.gitlab.freedesktop.org>
* doc/user: Add instructions for using with CMakeNicolas Fella2021-05-041-0/+5
| | | | | | CMake provides a nice way to use libinput, let the world now. Signed-off-by: Nicolas Fella <nicolas.fella@gmx.de>
* Change various references to the master branch to mainPeter Hutterer2021-04-292-3/+3
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: fix a link to the system hwdb filePeter Hutterer2021-04-291-1/+1
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: explain why we are doing motion normalizationPeter Hutterer2021-03-161-0/+5
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* Fix worng quirk name in docyuri19692021-02-191-1/+1
| | | | | | | The doc mentioned 'AttrTouchPressureRange' quirk but `src/quirks.c` defines 'AttrPressureRange' instead. This led to unknown quirk name errors. Signed-off-by: yuri1969 <1969yuri1969@gmail.com>
* doc: update the docs with a note regarding multifinger draggingPeter Hutterer2021-02-151-0/+5
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* touchpad: permit only one finger on the touchpad at the start of a tap-dragsatrmb2021-02-151-1/+1
| | | | | | | | | | | This only affects the actual dragging part of the tap-and-drag interaction; n-finger tap-and-drag is supposed to be performed with a n-finger tap followed by a 1-finger drag. Allowing a second finger in the middle of a drag is still necessary for a finger swap, which users may need in long-distance drags, especially when drag-lock is disabled. Signed-off-by: satrmb <10471-satrmb@users.noreply.gitlab.freedesktop.org>
* doc/user: generate the required package list for the CI distributionsPeter Hutterer2021-02-153-0/+47
| | | | | | | | | | Use yq to extract the package list from the CI configuration, then dump that into the user docs. This provides the long-requested commands to install all dependencies without the maintenance effort or risk of going stale. Note that we are *not* building this in the CI, it's just not needed. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: expand the explanations on how to submit a merge requestPeter Hutterer2021-02-031-6/+51
| | | | | | | I keep answering this in bug reports, much easier to just have a link to copy/paste. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: some whitespace fixesPeter Hutterer2021-02-031-3/+3
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc: fix IRC channel nameJonas Ådahl2021-01-281-1/+1
| | | | | | It said #wayland-devel, but it's #wayland. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
* doc/user: list the known package repositories for libinput from gitPeter Hutterer2021-01-071-0/+23
| | | | | | | Because dnf install is a lot easier than building from git where one just wants to test the latest libinput. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* treewide: fix typosTorstein Husebø2020-12-168-10/+10
| | | | Signed-off-by: Torstein Husebø <torstein@huseboe.net>
* doc: somewhat document the write_open for lid switchesPeter Hutterer2020-12-161-2/+4
| | | | | | | Not a full documentation but slightly more information than before. This is too niche to document it fully, we're only using it on one device anyway. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: document that we're only using internal devices for DWTPeter Hutterer2020-12-152-2/+8
| | | | Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/user: update the timer offset warning for the new "too slow" messagePeter Hutterer2020-10-281-14/+14
| | | | | | Related #533 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* quirks: add AttrInputPropEnable and DisablePeter Hutterer2020-10-231-0/+6
| | | | | | | The latter requires libevdev 1.10 but since that'll take a while to filter into our various CI systems, let's make it conditional. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* quirks: add AttrEventCodeEnable as counterpoint to the disable onePeter Hutterer2020-10-231-0/+4
| | | | | | | | | | | Currently unused, but let's get this in because we may need this very soon for broken tablets. Enabling EV_ABS axes requires an absinfo struct - we default to a simple 0-1 axis range for those as the most generic option. Anything more custom will need more custom treatment when we need it. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/api: fix the doxygen output handlingPeter Hutterer2020-09-292-2/+3
| | | | | | | | | | | | | Using output: ['.'] broke ninja after ninja clean - it removed the whole directory and thus the meson-generated configure_files (i.e. all the doxygen sources we copied). ninja didn't know how to build those. Fix this by rearranging the doxygen output to build into a different directory now and setting the output to that. This doesn't exactly *fix* things since that directory is no longer removed during ninja clean, but at least the build no longer fails. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc: update touchpad tapping state machine diagramsatrmb2020-09-251-1/+1
| | | | Signed-off-by: satrmb <10471-satrmb@users.noreply.gitlab.freedesktop.org>
* meson.build: bump minimum version to 0.47Peter Hutterer2020-09-092-17/+2
| | | | | | It's been out for 2 years. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* doc/api: drop the doxygen/graphviz version checksPeter Hutterer2020-09-091-20/+0
| | | | | | Both of our minimum versions were released in 2012, no more need to check. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
* touchpad: ignore the ALPS jump to 4095/0Peter Hutterer2020-09-071-0/+14
| | | | | | | | | | | | | | Some ALPS touchpad send the occasional 4095/0 event on slot 1 during two-finger interaction before snapping back to the actual position of the finger. There doesn't seem to be a specific heuristic to predict this so let's hardcode those values. When detected, overwrite the current touch point with the position of the last point. This will likely cause a small pointer jump when the finger later moves to the real position but based on #492 this could be a second later, so all bets are off anyway. Fixes https://gitlab.freedesktop.org/libinput/libinput/-/issues/492 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>