update the README

1 files changed, 28 insertions, 19 deletions

diff --git a/README.rst b/README.rst
index 5ce3271..a21dd3a 100644
--- a/README.rst
+++ b/README.rst
@@ -1,44 +1,51 @@
+=========
 py3status
 =========
+**py3status** is an extensible i3status wrapper written in python.
+
+Using py3status, you can take control of your i3bar easily by:
+    - writing your own modules and have their output displayed on your bar
+    - handling click events on your i3bar and play with them in no time
+    - seeing your clock tick every second whatever your i3status interval
 
-py3status is an extensible i3status wrapper written in python
+No extra configuration file needed, just install & enjoy !
 
 Documentation
-=========
-See the wiki for up to date documentation : https://github.com/ultrabug/py3status/wiki
+=============
+See the wiki for up to date documentation:
+    https://github.com/ultrabug/py3status/wiki
+
+Learn how to write your own modules:
+    https://github.com/ultrabug/py3status/wiki/Write-your-own-modules
 
 Requirements
-=========
-You must set the `output_format` to `i3bar` in the general section of your i3status.conf:
+============
+You **must** set the `output_format` to `i3bar` in the general section of your i3status.conf:
 ::
     general {
         output_format = "i3bar"
     }
 
 Installation (all users)
-=========
+========================
 py3status is available on pypi:
 ::
     $ pip install py3status
 
 Installation (Gentoo users)
-=========
-Add the `ultrabug` overlay on layman:
-::
-    $ sudo layman -a ultrabug
-
-Install py3status:
+===========================
+py3status is available on portage:
 ::
     $ sudo emerge -a py3status
 
 Installation (Arch users)
-=========
+=========================
 Thanks to @waaaaargh, py3status is present in the Arch User Repository using this URL:
 ::
     https://aur.archlinux.org/packages/py3status-git/
 
 Usage
-=========
+=====
 In your i3 config file, simply change the `status_command` with:
 ::
     status_command py3status
@@ -48,17 +55,19 @@ Usually you have your own i3status configuration, just point to it:
     status_command py3status -c ~/.i3/i3status.conf
 
 Options
-=========
+=======
 You can see the help of py3status by issuing `py3status -h`:
 ::
     -c I3STATUS_CONF  path to i3status config file
-    -d                disable integrated transformations
-    -i INCLUDE_PATH   include user-written modules from those directories (default .i3/py3status)
+    --debug           be verbose in syslog
+    -i INCLUDE_PATHS  include user-written modules from those directories
+                      (default .i3/py3status)
     -n INTERVAL       update interval in seconds (default 1 sec)
-    -t CACHE_TIMEOUT  default injection cache timeout in seconds (default 60 sec)
+    -t CACHE_TIMEOUT  default injection cache timeout in seconds
+                      (default 60 sec)
 
 Control
-=========
+=======
 Just like i3status, you can force an update by sending a SIGUSR1 signal to py3status.
 Note that this will also send a SIGUSR1 signal to i3status.
 ::