diff --git a/ChangeLog b/ChangeLog index 2b9ff420..cdb5a652 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,10 @@ 0.8.9: * Improved support for gnome-shell/Unity. + * Fixed reading of MK700 keyboard battery status. + * Use battery icons from the current theme instead of custom ones. + * Debian/Ubuntu packages now depend on an icon theme, to make sure + no missing icons appear in the application window. 0.8.8: diff --git a/README.md b/README.md index ce2ccd49..e911da0f 100644 --- a/README.md +++ b/README.md @@ -20,12 +20,14 @@ and their features, see [docs/devices.md](docs/devices.md). ## Pre-built packages -Pre-built packages are available for a few Linux distros: +Pre-built packages are available for a few Linux distros. + +* Debian 7 (Wheezy) or higher: packages in this [repository][debian] +* Ubuntu/Kubuntu 12.04+: [ppa:daniel.pavel/solaar][ppa] + +The `solaar` package uses a standard system tray implementation; to ensure +integration with *gnome-shell* or *Unity*, install `solaar-gnome3`. -* Debian 7 (Wheezy) or higher: packages in this [repository][debian]; the -`solaar` package uses a systray icon; to make sure you're using gnome-shell's -indicators, install `solaar-gnome3`. -* Ubuntu 12.04+: [ppa:daniel.pavel/solaar][ppa] * a [Gentoo overlay][gentoo], courtesy of Carlos Silva * an [OpenSUSE rpm][opensuse], courtesy of Mathias Homann * an [Arch package][arch], courtesy of Arnaud Taffanel @@ -45,20 +47,20 @@ procedure for manual installation. ## Known Issues -- KDE/Kubuntu: is some icons appear broken in the application, make sure you've - configured the Gtk theme. +- KDE/Kubuntu: if some icons appear broken in the application, make sure you've + properly configured the Gtk theme and icon theme in KDE's control panel. - Some devices using the [Nano Receiver][nano] (which is very similar to the Unifying Receiver) are supported, but not all. For details, see [docs/devices.md](docs/devices.md). -[nano]: http://logitech.com/mice-pointers/articles/5926 - - Running the command-line application (`bin/solaar-cli`) while the GUI application is also running *may* occasionally cause either of them to become confused about the state of the devices. I haven't encountered this often enough to be able to be able to diagnose it properly yet. +[nano]: http://logitech.com/mice-pointers/articles/5926 + ## License diff --git a/docs/debian-repo.md b/docs/debian-repo.md index 03e1aff3..5854e3ad 100644 --- a/docs/debian-repo.md +++ b/docs/debian-repo.md @@ -3,7 +3,5 @@ To use this repository with your Debian machine, create a file `solaar.list` in `/etc/apt/sources.list.d/`, with the following contents: -``` -deb http://pwr.github.io/Solaar/packages/ ./ -deb-src http://pwr.github.io/Solaar/packages/ ./ -``` + deb http://pwr.github.io/Solaar/packages/ ./ + deb-src http://pwr.github.io/Solaar/packages/ ./ diff --git a/docs/devices.md b/docs/devices.md index 358193f5..c4dd3c86 100644 --- a/docs/devices.md +++ b/docs/devices.md @@ -8,9 +8,6 @@ USB ID `046d:c52b` or `046d:c532`), but only some newer [Nano Receiver][nano]s (devices with USB ID `046d:c52f`). You can check your connected Logitech devices by running `lsusb -d 046d:` in a console. -[unifying]: http://logitech.com/en-us/66/6079 -[nano]: http://logitech.com/mice-pointers/articles/5926 - For some devices, extra settings (usually not available through the standard Linux system configuration) are supported: @@ -19,10 +16,11 @@ Linux system configuration) are supported: window and display the current lighting value (Lux) as reported by the keyboard, similar to Logitech's *Solar.app* for Windows. -* The state of the `FN` key can be toggled on some keyboards ([K750][K750] and - [K800][K800]). It changes the way the function keys (`F1`..`F12`) work, i.e. - whether holding `FN` while pressing the function keys will generate the - standard `Fx` keycodes or the special function (yellow icons) keycodes. +* The state of the `FN` key can be toggled on some keyboards ([K360][K360], + [MK700][K700], [K750][K750] and [K800][K800]). It changes the way the function + keys (`F1`..`F12`) work, i.e. whether holding `FN` while pressing the function + keys will generate the standard `Fx` keycodes or the special function (yellow + icons) keycodes. * The DPI can be changed on the [Performance MX Mouse][P_MX]. @@ -47,8 +45,8 @@ The HID++ column specifies the device's HID++ version. The Battery column specifies if Solaar is able to read the device's battery level. -For mice, the DPI column specifies if the mouse's sensitivity is fixed (-), can -only be read (R), or can be read and changed by Solaar (R/W). +For mice, the DPI column specifies if the mouse's sensitivity is fixed (`-`), +can only be read (`R`), or can be read and changed by Solaar (`R/W`). The reprog(rammable) keys feature is currently not fully supported by Solaar. You are able to read this feature using solaar-cli, but it is not possible to @@ -112,13 +110,15 @@ Mouse-Keyboard combos: | MK330 | | | | | MK520 | | | | | MK550 | | | | -| MK700 | 1.0 | yes | FN swap, reprog keys | +| MK710 | 1.0 | yes | FN swap, reprog keys | [unifying]: http://logitech.com/en-us/66/6079 +[nano]: http://logitech.com/mice-pointers/articles/5926 +[K360]: http://logitech.com/product/keyboard-k360 +[K700]: http://logitech.com/product/wireless-desktop-mk710 [K750]: http://logitech.com/product/k750-keyboard [K800]: http://logitech.com/product/wireless-illuminated-keyboard-k800 -[K360]: http://logitech.com/product/keyboard-k360 [M510]: http://logitech.com/product/wireless-mouse-m510 [M705]: http://logitech.com/product/marathon-mouse-m705 [P_MX]: http://logitech.com/product/performance-mouse-mx diff --git a/packaging/README b/packaging/README index 7308c687..b5d45838 100644 --- a/packaging/README +++ b/packaging/README @@ -1,4 +1,7 @@ -These files serve as samples/guidelines for packaging Solaar. +The debian/ and ubuntu/ folders are maintained by me and used for all releases +for those respective distros. + +The rest of the files serve as samples/guidelines for packaging Solaar. They may be out-of-date or simply wrong, and are not necessarily used to build the official packages.