Fix gi.require_version warning
[indicator-chars.git] / README.rst
index 8d26226..dd26a50 100644 (file)
@@ -7,18 +7,54 @@ indicator-chars
 App indicator to provide a menu with (potentially funny UTF-8) characters for
 simple copying them to clipboard (similar to original characters applet).
 
-Create a file .indicator-chars in your home dir with lines of characters to be
-selectable.
+Create a file .indicator-chars in your home directory with lines of
+characters to be selectable.
+
+**Fork by Cyrille37**
+
+:Author: Cyrille37 <cyrille37@gmail.com>
+
+- Some changes to make indicator-chars works on Ubuntu 12.04LTS with Unity 2D
+
+  - replace the custom icon with a theme icon name
+
+  - add a char copy into Clipboard(selection="CLIPBOARD")
+
+- Other minors changes
+
+  - use env to find the Python engine
+
+  - add a configuration file example: "conf-example.indicator-chars"
+
+**Fork by Adrian I Lam**
+
+:Author: Adrian I Lam <adrianiainlam@gmail.com>
+
+- Changes to Cyrille37's fork:
+
+  - port to Python 3 from Python 2
+
+  - use the svg custom icon
 
 -------
 Install
 -------
 
 - Checkout source code
+
 - Create ~/.indicator-chars
+
   - Each row corresponds to a set of chars
-  - Spaces also count as chars
+
+  - Optional submenu title prefix: "[title]" (trailing spaces stripped)
+
+  - Optional descriptions after chars: "(description)" (leading &
+    trailing spaces stripped)
+
+  - Spaces (apart from above) also count as chars
+
   - Make sure to use UTF-8 encoding
+
 - Put indicator-chars.py into auto start
 
 -----------
@@ -26,5 +62,7 @@ Open issues
 -----------
 
 - If anyone could design a nice, unity style indicator icon?
+
 - Maybe there is a way to use multiple click buttons in menu items?
+
   - No standard Gtk way does not work.