From 276db2c9c227043358ec83cf37116a907f975fcb Mon Sep 17 00:00:00 2001
From: "B. Watson"
It's recommended to let unsaver find the joysticks itself. However, -you can pass one or more device names (or just numbers) if the default -doesn't do the right thing for you.
-If you do use them, the joydev arguments can be one of 3 things:
----
-- The first argument can optionally be a directory, which must exist. -The default is "/dev/input". unsaver will look for joystick devices here. -If there are no more joydev arguments, unsaver will monitor devices -and detect hotplug events on devices js0 through js15 in this directory.
-- One or more numbers. unsaver will prepend the directory and "js" to each number, -and monitor that device. Hotplug events will be detected only for -the specified devices. You could use this e.g. to not monitor your -2nd joystick, because it sometimes drifts and reports false events.
-- One or more device nodes (e.g. js0). Use relative paths here (relative -to the directory argument or "/dev/input"). This option only exists -for future-proofing (in case the js name changes someday). Hotplug -events will be detected only for the specified devices.
-
None of the joystick devices (whether autodetected, named, or numbered) -has to actually exist when unsaver starts up, although their directory -does have to exist. This means unsaver can detect hotplug events, but -you have to be careful not to typo the device names.
+It's recommended to let unsaver find the joysticks itself. However, you +can pass one or more joystick numbers if the default doesn't do the right +thing for you. Remember that the first joystick is numbered 0, not 1.
+When you manually set the list of devices, unsaver will only detect +hotplug events on the devices you gave it. If you plug in more joysticks, +they won't be monitored.
+None of the joystick devices (whether autodetected or not) has to +actually exist when unsaver starts up, although their directory does +have to exist. This means unsaver can detect hotplug events, but you +have to be careful not to typo the device names.
+If your system doesn't keep its joystick device nodes in /dev/input, and/or +if they're not named "js<num>", see ENVIRONMENT for a way to override +the default names.
+