release 1.1.2

ChangeLog.md

@@ -1,5 +1,7 @@
-# 1.1.2rc2
+# 1.1.2
 
+* Update documentation on supported devices and translations
+* Include evdev as a dependency
 * Try to use uinput for fake input if XTest extension not available
 * Add Nano receiver C542 for M190 mice
 * Broaden range of HID++ Bluetooth devices
@@ -10,9 +12,9 @@
 * Add setting for PERSISTENT_REMAPPABLE_ACTION, common keyboard and mouse cases only
 * Split Test rule condition into Test and TestBytes and support in rule editor
 * Fix bug in speed-change setting
-* Support Backlight and Backlight3 features
+* Support Backlight3 feature
 * Ensure that settings are pushed in resume
-* Update German translation
+* Update German, Polish,  and zh_CN translations
 * Determine device number for direct-connected devices from protocol
 * fix bug in add and delete button actions in rule editor
 * dispose of no-op notifications quickly

docs/_config.yml

@@ -4,7 +4,7 @@ tagline: Linux Device Manager for Logitech Unifying Receivers and Devices.
 owner: pwr-Solaar
 owner_url: https://github.com/pwr-Solaar
 repository: pwr-Solaar/Solaar
-version: 1.1.2rc2
+version: 1.1.2
 show_downloads: false
 encoding: utf-8
 theme: jekyll-theme-slate

docs/devices.md

@@ -7,9 +7,8 @@ layout: page
 
 Solaar only supports Logitech receivers and devices that use the Logitech proprietary HID++ protocol.
 
-Solaar supports most Logitech Nano and Unifying receivers.
+Solaar supports most Logitech Nano, Unifying, and Bolt receivers.
 Solaar supports some Lightspeed receivers.
-Solaar does not currently support Bolt receivers.
 See the receiver table below for the list of currently supported receivers.
 
 Solaar supports most recent and many older Logitech devices
@@ -32,22 +31,24 @@ open an enhancement issue requesting that it be supported.
 ## Adding new receivers and devices
 
 Adding a new receiver requires knowing whether the receiver is a regular
-Unifying receiver, a Nano receiver, or a Lightspeed receiver. Add a line to
+Unifying receiver, a Nano receiver, a Bolt receiver, or a Lightspeed receiver. Add a line to
 `../lib/logitech_receiver/base_usb.py` defining the receiver as one of these.
 If the receiver has an unusual number of pairing slots, then this also needs
 to be specified. Then add the receiver to the tuple of receivers (ALL).
 
-Most new devices do not need to be known to Solaar to work. However, an
-entry in `lib/logitech-receiver/descriptors.py` can provide a better name for
-the device and a feature list can speed up Solaar startup a bit. The
-arguments to the _D function are the device's long name, its short name
-(codename), its HID++ protocol version, its wireless product ID (wpid), and
-a tuple of known feature settings (from `lib/logitech/settings_templates.py`).
-If the device can connect via a USB cable its USB product ID should be included.
-If the device can connect via Bluetooth its Bluetooth product ID should be included.
-
-If a USB device connects via a USB interface other than the default, add that information.
-This is the main reason for new devices that use the HID++ protocol to need support information in Solaar.
+Most new devices do not need to be known to Solaar to work.
+The _D function in `../lib/logitech_receiver/descriptors.py` makes a device known to Solaar.
+The usual arguments to the _D function are the device's long name, its short name
+(codename), and its HID++ protocol version.
+Devices that use HID++ 1.0 need a tuple of known registers (registers) and settings (settings).
+Settings can be provided for Devices that use HID++ 2.0 or later,
+but Solaar can determine these from the device.
+If the device can connect to a receiver, provide its wireless product ID (wpid),
+If the device can connect via Bluetooth, provide its Bluetooth product ID (btid).
+If the device can connect via a USB cable, provide its USB product ID (usbid),
+and the interface it uses to send and receiver HID++ messages (interface - default 2).
+The use of a non-default USB interface is the main reason for requiring information about
+modern devices to be added to Solaar.
 
 
 ### Supported Receivers
@@ -73,6 +74,7 @@ This is the main reason for new devices that use the HID++ protocol to need supp
 | 046d:c53d | Lightspeed | 1                  |
 | 046d:c53f | Lightspeed | 1                  |
 | 046d:c541 | Lightspeed | 1                  |
+| 046d:c542 | Nano       | 1                  |
 | 046d:c545 | Lightspeed | 1                  |
 | 046d:c547 | Lightspeed | 1                  |
 | 046d:c548 | Bolt       | 6                  |

docs/i18n.md

@@ -34,7 +34,7 @@ the source root):
 You can edit the translation iteratively, just repeat from step 3.
 If the upstream changes, do a `git pull` and then repeat from step 2.
 
-Before opening a pull request, please run `./tools/po-update.sh` again. It will
+Before opening a pull request, please run `./tools/po-update.sh <language>` again. This will
 format and sort the translation file, and ensure a minimal diff when updating
 a translation.
 

docs/index.md

@@ -47,7 +47,7 @@ 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.0. Problems with earlier versions should
+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).
 Some capabilities of Solaar have been developed by observing the behavior of

lib/solaar/__init__.py

@@ -16,5 +16,5 @@
 ## with this program; if not, write to the Free Software Foundation, Inc.,
 ## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 
-__version__ = '1.1.2rc2'
+__version__ = '1.1.2'
 NAME = 'Solaar'

setup.py

@@ -8,7 +8,7 @@
     from distutils.core import setup
 
 # from solaar import NAME, __version__
-__version__ = '1.1.2rc2'
+__version__ = '1.1.2'
 NAME = 'Solaar'
 
 
@@ -61,6 +61,7 @@ def _data_files():
     # os_requires=['gi.repository.GObject (>= 2.0)', 'gi.repository.Gtk (>= 3.0)'],
     python_requires='>=3.6',
     install_requires=[
+        'evdev (>= 1.3.0)',
         'pyudev (>= 0.13)',
         'PyYAML (>= 3.12)',
         'python-xlib (>= 0.27)',