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>

Add FreeBSD (cross-compliation based) CI

Fixes #82

Autodetect and use libepoll-shim on FreeBSD

evdev: fix the trackpoint multiplier info message

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

tools: setenv the quirks dir when running from the build directory

Fixes #84

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

tools: change prototype of the builddir lookup function

Only one place really needs the return argument, so we might as well just pass
the memory to be returned in.

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

Add input.h for FreeBSD

test: ptrace compatibility with *BSD

test: use simple portable sendfile

There's no need for high performance in these little tests, so instead of
supporting various platform-specific sendfile() implementations, just use a local read-write function.

test: support disabling tty on FreeBSD

Instead of K_OFF, use K_RAW plus termios raw mode.
(Same approach as in the Weston patches)

Use getprogname() when program_invocation_short_name is not defined

Fix include portablity (xlocale, stdlib)

Import versionsort implementation from musl for systems without versionsort

versionsort is a GNU extension, not available on *BSD systems.

fallback: remove some if 0 code

Looks like a development leftover.

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

evdev: whitespace fix

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

test: remove unsupported events from the invalid-range touchscreen test device

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

test: remove unused values.h include