docs & changelog updates

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:
 

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
+- KDE/Kubuntu: if some icons appear broken in the application, make sure you've
-  configured the Gtk theme.
+  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
 

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/ ./
-```

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
+* The state of the `FN` key can be toggled on some keyboards ([K360][K360],
-  [K800][K800]). It changes the way the function keys (`F1`..`F12`) work, i.e.
+  [MK700][K700], [K750][K750] and [K800][K800]). It changes the way the function
-  whether holding `FN` while pressing the function keys will generate the
+  keys (`F1`..`F12`) work, i.e. whether holding `FN` while pressing the function
-  standard `Fx` keycodes or the special function (yellow icons) keycodes.
+  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
+For mice, the DPI column specifies if the mouse's sensitivity is fixed (`-`),
-only be read (R), or can be read and changed by Solaar (R/W).
+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

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.