From 295cfe284600b1a762b66f6642a905bc32c1f706 Mon Sep 17 00:00:00 2001 From: "Peter F. Patel-Schneider" Date: Tue, 20 Sep 2022 15:28:37 -0400 Subject: [PATCH] docs: augment comments about what Solaar cannot do --- docs/index.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/index.md b/docs/index.md index b6a65c96..9e99e75b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -13,6 +13,16 @@ Some Linux distributions distribute old versions of Solaar. If you are using an old version and something described here does not work you should upgrade using one of the methods described below. +Solaar runs as a regular user process, albeit with direct access to the Linux interface +that lets it directly communicate with the Logitech devices it manages using special +Logitech-proprietary (HID++) commands. +Each Logitech device implements a different subset of these commands. +Solaar is thus only able to make the changes to devices that devices implement. + +Solaar is not a device driver and does not process normal input from devices. +It is thus unable to fix problems that arise from incorrect handling of +mouse movements or keycodes by Linux drivers or other software. + Solaar can be used as a GUI application, the usual case, or via its command-line interface. The Solaar GUI is meant to run continuously in the background, monitoring devices, making changes to them, and responding to some messages they emit. @@ -48,10 +58,6 @@ Solaar's GUI can be started in several ways For more information on Solaar's command-line interface use the help option, as in `solaar --help`. -Solaar does not process normal input from devices. It is thus unable -to fix problems that arise from incorrect handling of mouse movements or keycodes -by Linux drivers or other software. - Solaar has progressed past version 1.1. Problems with earlier versions should not be reported as bugs. Instead, upgrade to a recent version or manually install the current version from [GitHub](https://github.com/pwr-Solaar/Solaar).