touchpad: 90-degree scroll helper

This makes two-finger scrolling in straight lines easier, while still
allowing free/diagonal movement. It works in three stages:

1) Initial movement
   - For the first few millimeters, scroll movements within 30 degrees
     of horizontal or vertical are straightened to 90-degree angles.
   - Scroll movements close to 45 degree diagonals are unchanged.
   - If movement continues very close to straight horizontal or
     vertical, stage 2 begins and the axis lock engages.
   - If movement continues along a diagonal, stage 2 is skipped and
     free scrolling is immediately enabled.
2) Axis lock
   - If the user scrolls fairly closely to straight vertical, no
     horizontal movement will happen at all, and vice versa.
   - It is possible to switch between straight vertical and straight
     horizontal, and the axis lock will automatically change.
   - If deliberate diagonal movement is detected at any point, stage
     3 begins and the axis lock disengages.
3) Free scrolling
   - Scrolling is unconstrained until the fingers are lifted.

test: touchpad: add tests for 90 degree scroll (axis lock)

doc/user: add 90-degree scroll behavior

tools: debug-*: show unaccelerated deltas for pointer events

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

test: add a 10ms delay for scrolling tests

No touchpad gives us these events with a 0 delay, so let's not test for that.

This is required for adding timing-sensitive scroll code, see
https://gitlab.freedesktop.org/libinput/libinput/issues/101.

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

test: touchpad: swap an int for a bool

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

test: rename the x220 clickpad to something more telling

Having this as the generic "synaptics" touchpad in the tests is not helpful,
this touchpad is tiny and quite special these days.

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

tablet: unify the license text with what we have in COPYING

Use the same blurb everywhere, changing from the old style MIT to the Expat
license we're using everywhere else.

Similar to bc9f16b40e23a1d25c105a4207b97d65253f0d98

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

filter: always init a delta smoothener for 10/10ms on trackpoints

If the trackpoint gives us deltas with less than 10ms intervals, something is
wrong. Could be bad hardware, a glitch in the matrix or a discontinuity in
the otherwise appropriately named time-space continuum. Usually it's the
first.

Let's always set up trackpoint delta smoothening for 10ms to improve the
pointer speed calculation and avoid jerky behaviors. i.e. if a trackpoint
delta comes in below 10ms, pretend it came in with a 10ms interval for
calculating the speed.

Fixes https://gitlab.freedesktop.org/libinput/libinput/issues/104

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

doc/user: drop the sphinx -a flag

Let's trust sphinx to know what to rebuild

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

tools: record: don't bother setting last_ms to 0 on the first event

The first event we receive is set to a 0ms offset anyway. Setting last_ms to 0
on the first event means the first two events have +0ms offset printed to the
log. Skip it, so the second event has the right offset.

This is human-readable data only, no effect on the recording file itself.

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

doc/user: add touchpad pressure debugging as separate page

This way we can put it under Troubleshooting

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

doc/user: add the quirks tool to the tool list

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

doc/user: match the quirks list output with the code

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

Remove seemingly extra pasted line from license

touchpad: improve finger counting for synaptics serial touchpads

A three-finger touch may cause slot N to end, in a frame after the
BTN_TOOL_TRIPLETAP. This causes tp->nfinger_down to be decremented to 2 as the
touch switches to MAYBE_END - which happens to be our num_slots. We exit early
and never restore the touch correctly.

Fix this by checking that the number of fake touches is equal to the slots, if
it is higher then we need to check for recovery.

Fixes https://gitlab.freedesktop.org/libinput/libinput/issues/99

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

fallback: add support for ABS_MT_TOOL_TYPE for touch screens

Cancel any touches that trigger MT_TOOL_PALM.

Fixes https://gitlab.freedesktop.org/libinput/libinput/issues/25

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

test: handle ABS_MT_TOOL_TYPE from the litest devices

We want to autoreplace this value where possible but not scale it to min/max,
this is effectively an enum. The same is true for slot/tracking id, so let's
add it here too.

Because it's an enum and 99% of the cases require MT_TOOL_FINGER, we always
fall back to that instead of using the axis_defaults that we use for other
axes.

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

test: add test helpers for touch sequence parts

The necessary helpers to test for a touch event + one touch frame and the
extra case for the TOUCH_CANCEL in is_touch_event

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

fallback: move flushing MT events to a helper function

No functional changes

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

fallback: change a list of if conditions to a switch statement

This used to do a lot more but now it can be handled as simple switch
statement. Bonus: we get to log a bug if we ever get here in NONE state.

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

fallback: move the mt slot state struct/enum here

Not needed by the more generic evdev header

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

doc/user: mark the touchpads page as orphan

Only one link leads to it and it doesnt (right now) fit into the hierarchy.
Let's get rid of the sphinx warning.

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

doc/user: add custom 404 pages for the old links

Switching from doxygen to sphinx broke a bunch of links because doxygen used
whatever the argument to @page was - and that usually had underscores. Sphinx
uses filenames (which use dashes) so now we have a bunch of old links going to
a 404. For the transition period at least, insert a custom 404 page for each
of those to tell users this doesn't exist anymore.

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

Revert "doc/user: add a custom 404 page"

Nope, doesn't work, our server doesn't support htaccess.

This reverts commit 548e0eb98b46e328a64215323962c11df17b49ce.

util: remove now-unused helper functions

Obsolete with the switch to the device quirks

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

doc/user: add a custom 404 page

Things moved around, so let's have a custom 404 page where we can put
information in. This ist the barebones version, not sure if .htaccess is
supported.

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

doc: drop the doxygen conversion script

It's really not that good, so no point to keep it around

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

doc/user: rename filenames with underscores to dashes

Everything else is, let's be consistent here.

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

doc/user: swap some note out with hint

Because why not...

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

doc/user: add a hack to get to the git version

meson doesn't have configuration_data() in vcs_tag so we can only replace one
string. sphinx cannot include things in-line.

Since we want the git version to be replaced in random places, we need to put
it into rst_prolog in conf.py - but that's where we neet to replace other
things too. Work around this by generating a mini python module that returns
the git version, then call that in conf.py.

Side-bonus: we now have access to the full commit and the abbreviated commit.
Not that anything actually uses this...

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

doc/user: drop the old page-hierarchy page

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

doc/user: use extlink for a common commit links

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

doc/user: more fixes including adding a device-types section

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

doc/user: tidy up the development page

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

README: drop a @ref in favor of the full link

No doxygen leftovers in README anymore, exspecially now that we don't use it
for doxygen anymore.

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

fallback: add another debug message for tablet-mode keyboard suspend

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

fallback: change a debug message to be less ambiguous

"activated" sounds like we're disabling things here, but we're just pairing
the two devices

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

doc/user: more documentation cleanups and fixes

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

doc/user: some rewording and improvements

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

meson.build: fix name of the measure touchpad-tap script

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

doc/user: update the 'no package found' link to the meson version post

Now that we dropped autotools anyway, it's better to link to the meson version
of that blog post.

Related #96

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

doc/user: building - promote dependencies to a higher-level section

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

doc/user: the SELinux section doesn't apply to modern meson

Related #96

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

doc/user: re-do the conditional build section

Related #96

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

doc/user: drop the autotools builds

Anyone who's still on <= 1.8 either knows how to build it already or relies on
a distribution to do that for them. Drop the section.

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

doc/user: add a note on meson's dependency() in the building docs

See #96

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

doc/user: mesonconf is meson configure

Listed in #96

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

tablet: clear tablet history on tool contact change

On some ELAN tablets we get a coordinate jump in the same frame that we put
the tip down. The existing axis smoothing causes that jump to be somewhere in
the middle between the previous and the next coordinates, causing a small
stroke from the smoothed position to the next. Prevent this by resetting the
history on tip down/up so we always take that coordinate.

Fixes #94

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

libinput 1.11.901

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

doc/user: add a page detailing what configuration toggles are available

High level view only but at least it's a link we can point people to.

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

dox: switch to sphinx for the user-visible documentation

This is a large commit because it's difficult to split this up and we don't
care about bisecting here anyway.

doxygen is going to produce the API documentation only
sphinx is going to produce the prose user (and a bit of developer) documentation.

The source split is doc/api and doc/user.

Steps performed:
- run the doxygen-to-sphinx.sh script to convert all .dox sources to .rst
- manually fixed the .rst to render correctly
- add a few extra .rst documents to generate the right hierarchy
- hook up sphinx-build in meson
- add a new @mainpage for doxygen more aimed at developers

For the build directory:
- sphinx produces /Documentation
- doxygen now produces /api/

These need to be manually combined in the wayland-web repo, meson doesn't
support subdirectories as output paths within the build dir and the
documentation doesn't need to be installed anywhere.

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

GitLab CI: print out the image age in seconds

Helps with debugging purposes

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

Gitlab CI: set DEBIAN_FRONTEND noninteractive for the Ubuntu images

Because Godot doesn't care about tzdata, so waiting for him is pointless.

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

Add the buildreqs for sphinx-build

Separate commit so we can prep the containers for the real PR and thus test if
something break.

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

doc: split the graphs into a separate array for re-use

We need this in the sphinx documentation.

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

doc: move the @verbatim start to the list item

This is mostly for sphinx' parsing benefit, doxygen doesn't need it and
renders the same either way.

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

doc: device-quirks: redo the model quirks <dl> for sphinx' benefit

sphinx only supports one line of <dt> content, so we have to compress these.

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

doc: a few replacements to make sphinx happy/prettier

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

doc: refer to "the libinput documentation" in a few @see cases

This is in preparation for a change to sphinx as the user-visible
documentation. Ideally we could cross-link between the two but that's tricky
to do automatically. Linking to the html pages/anchors directly works fine but
risks the links going stale, especially while the documentation is still in
flux.

Having a generic "refer to the libinput documentation" is a bit of a cop-out
least this way the links cannot go stale.

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

doc: drop a few unnecessary @ref

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

doc: enable warnings in doxygen

We want to see missed links

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

doc: copy some bits of the tablet docs to doxygen

So it shows up in the doxygen contents. These are the bits that are mostly of
interest to developers, we might remove the user documentation entry later,
but let's leave it there for now.

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

gitlab-ci: use skopeo to check on container images

this allows to replace complex curl queries with simpler commands.

We need a newer minimalist image with skopeo in addition to jq and
curl.

Also, I am currently not relying on skopeo to delete the image as I am
not so sure we will get the same cleanup than with the current sha method
and also:
https://bugzilla.redhat.com/show_bug.cgi?id=1481196

Signed-off-by: Benjamin Tissoires <benjamin.tissoires@gmail.com>

doc: move the Architecture blurb to the 'what is libinput' page

The vast majority of ppl reading the README is unlikely to care about this,
but they do care about the Wayland vs X.Org situation so let's split this up.

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

tools: drop two unused imports

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

doc: we don't need the Namespaces doxygen page

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

util: fix a ubsan complaint about undefined left-shift

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

test: properly release a few leaking litest device

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

test: release a few leaking udev devices

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

doc: fix erroneous </dt>

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

test: supress another bash warning

Failing the leftover-rules check in the valgrind stage because

==1491== Invalid read of size 16
==1491==    at 0x5320AE8: __wcsnlen_sse4_1 (in /usr/lib64/libc-2.27.so)
==1491==    by 0x5310AD1: wcsrtombs (in /usr/lib64/libc-2.27.so)
==1491==    by 0x1AA403: ??? (in /usr/bin/bash)
==1491==    by 0x1AB3E3: glob_filename (in /usr/bin/bash)
==1491==    by 0x179FF1: shell_glob_filename (in /usr/bin/bash)
==1491==    by 0x1752CD: ??? (in /usr/bin/bash)
==1491==    by 0x14C05F: ??? (in /usr/bin/bash)
==1491==    by 0x14E2E3: execute_command_internal (in /usr/bin/bash)
==1491==    by 0x14FBC5: execute_command (in /usr/bin/bash)
==1491==    by 0x137598: reader_loop (in /usr/bin/bash)
==1491==    by 0x135D38: main (in /usr/bin/bash)
==1491==  Address 0x5651fd0 is 32 bytes before a block of size 128 in arena "client"

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

doc: fix the url where to file a new bug

doc: add a warning note that the reporting-bugs instructions do matter

And remove the paragraph below that states the same thing.

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

doc: point to libinput --version

This will fail pre 1.8 but oh well.

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

doc: replace a few <b> with markdown's **

At least where possible, doxygen doesn't parse lists starting with ** as
emphasized.

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

doc: replace html lists with markdown ones

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

doc: reporting-bugs: use evemu-record as link text, not evemu

Because that's the tool we're using

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

doc: single ` is enough for code highlighting

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

doc: indent all @note continuation lines

This isn't required by doxygen but for a potential switch to RTD/sphinx
(see #95) it helps having this set up correctly.

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

README: indent the links that belong to list items

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

doc: document the device quirks

Add some documentation for the most common quirks or at least the ones that
the user may eventually see or have to set. Drop the git commit hash into the
docs to make sure it's spelled out that the quirks are only valid for that
commit. Adding something with @include* requires the EXAMPLE_PATH to be set.

Doxygen doesn't parse markdown in @includedoc so we have to insert the commit
as normal HTML tag.

Related to https://gitlab.freedesktop.org/libinput/libinput/issues/87

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

doc: fix ref to device-quirks

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

doc: replace <a href> links with the doxygen markdown equivalent

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

doc: replace <pre> with @verbatim

Be more consistent here

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

doc: add a section name to seats-overview

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

Gitlab CI: properly define empty dependencies for the wayland-web hook

This needs to be an empty array, see the "artifacts:paths" documentation for
an example
https://docs.gitlab.com/ee/ci/yaml/#when-a-dependent-job-will-fail

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

Update FreeBSD package cache in CI

Should fix #93

test: add --gen-suppressions=all to the valgrind run

Because if we have a heisenbug that can't be reproduced on other machines,
having the suppression output in the log can save a lot of time.

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

Improve HP Chromebook 14 pressure ranges

Merge branch 'master' of gitlab.freedesktop.org:libinput/libinput

Add versionsort test

And make local versionsort testable even when the native one is present.

tools: fix touch frame checks in the YAML verifier script

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

touchpad: don't NONE or HOVERING touches towards the touch

To trigger this, we'd need 1, 2, 3 fingers down, release fingers 1 and 2 but
keep 3 down. Then put finger 1 down again. Touches 1 and 3 are alive now,
touch 2 is in state NONE.

During the thumb detection we took the first touch not in BEGIN and assigned
it to "first" - this would now be the second touch in state NONE.

Real effect is relatively minimal since we only use the coordinates here.

Fixes https://gitlab.freedesktop.org/libinput/libinput/issues/89

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

tools: always set the log handler for debug-events and debug-gui

This way errors are highlighted in red even without --verbose

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

doc: add a section to the FAQs "is libinput required for Wayland"

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

doc: move the "General" section to the "Developer" section

The info here is mostly developer-oriented, let's group this together.

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

doc: fix references to a trackpoint range in the FAQs

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

README: add a user documentation section fairly high up

For those with a tldr attention span

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

doc: break up the "what is libinput" page with two sections

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