From 37e1dfd2d1cc44b5cb2116c81b4d4a351494af32 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Fri, 17 Apr 2026 12:00:15 +1000 Subject: [PATCH] doc: update multi-device recording docs, --multiple is deprecated The --multiple flag is deprecated and a no-op in the current code (libinput-record.c). Multiple devices can simply be specified as arguments on the commandline. Update the documentation to reflect the current usage. Co-authored-by: Claude Part-of: --- doc/user/tools.rst | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/doc/user/tools.rst b/doc/user/tools.rst index 1b4b125e..dcb1e7c9 100644 --- a/doc/user/tools.rst +++ b/doc/user/tools.rst @@ -329,16 +329,13 @@ specific bug. For example, a touchpad may not work in response to keyboard events. To accurately reproduce this sequence, the timing between multiple devices must be correct and we need to record the events in one go. -``libinput record`` has a ``--multiple`` argument to record multiple devices at -once. Unlike the normal invocation, this one requires a number of arguments: :: +``libinput record`` can record multiple devices by specifying them on the +commandline. Recording multiple devices requires the ``--output-file`` +argument: :: - $ sudo libinput record --multiple --output-file=touchpad-bug.yml /dev/input/event17 /dev/input/event3 + $ sudo libinput record --output-file=touchpad-bug.yml /dev/input/event17 /dev/input/event3 recording to 'touchpad-bug.yml' -As seen above, a user must specify ``--multiple`` and the ``--output-file``. -Finally, all devices to be recorded must be specified on the commandline as -well. - Replaying events is the same as for a single recording: :: $ sudo libinput replay touchpad-bug.yml