Update README to state >= GTK+ 3.18 dependency...

[indicator-keyboard-led.git] / README.md

diff --git a/README.md b/README.md
index 581faca..e8f123c 100644 (file)
--- a/README.md
+++ b/README.md
@@ -31,6 +31,13 @@ distributions. To install the rest, run:
 
     sudo apt-get install python3-gi xdotool
 
+**Note**: [`gdk_keymap_get_scroll_lock_state ()`][gtkdoc-scroll] is only
+available since GTK+ 3.18. The earliest Ubuntu release that supports
+GTK+ 3.18 is 16.04 (Xenial). This means that if you use an older version
+you will have to ignore Scroll lock functionality (See [Examples](#examples)).
+
+[gtkdoc-scroll]: https://developer.gnome.org/gdk3/stable/gdk3-Keyboard-Handling.html#gdk-keymap-get-scroll-lock-state
+
 ## Usage
 
  1. Install the dependencies listed above.
@@ -61,19 +68,26 @@ Order changed to Caps Num Scroll.
 ![indicator NC][sc5]  
 Hide Scroll lock. `python3 indicator-keyboard-led.py --order NC`
 
-![indicator C short][sc6]
+![indicator C short][sc6]  
 Show Caps lock only, short appearance.
 `python3 indicator-keyboard-led.py --short --order C`
 
+![indicator default, French locale][sc7]  
+Default appearance in a French locale.
+`LANGUAGE=fr_FR python3 indicator-keyboard-led.py`
+
 [sc1]: screenshots/sc1.png
 [sc2]: screenshots/sc2.png
 [sc3]: screenshots/sc3.png
 [sc4]: screenshots/sc4.png
 [sc5]: screenshots/sc5.png
 [sc6]: screenshots/sc6.png
+[sc7]: screenshots/sc7.png
 
 ## Known bugs
 
+### Pressing Scroll Lock does nothing
+
 It seems to be a common problem that Scroll Lock is not usable in Ubuntu.
 To solve this, do the following (assuming US keyboard):
 
@@ -104,7 +118,23 @@ modified. [Original source][origsrc] by dm+ on PCLinuxOS-Forums.
 
 [origsrc]: http://www.pclinuxos.com/forum/index.php/topic,125690.msg1052201.html?PHPSESSID=2qsv83lve6dgd0ivq14bfcjc30#msg1052201
 [quotesrc]: http://askubuntu.com/a/597757/274080
-    
+
+### X11Keymap has no attribute 'get_scroll_lock_state'
+
+If running the script gives the error message
+
+    AttributeError: 'gtk.gdk.X11Keymap' object has no attribute 'get_scroll_lock_state'
+
+then your installed GTK+ version is probably older than 3.18, which
+does not support `get_scroll_lock_state`. Either hide all Scroll Lock
+functionality (See [Examples](#examples)), or upgrade your system.
+
+## Localization
+
+As motivated by Issue #1, this script has been localized to French (with
+the assistance of Wikipedia and Google Translate). Corrections to the
+translation, as well as translations to other languages, are welcome.
+Feel free to create a pull request or open an issue.
 
 ## License