README update

README.rst

@@ -1,24 +1,40 @@
 wmamixer
 ========
 
-Wmamixer is a fork of wmsmixer and is an ALSA mixer dockapp for Window Maker.
+Wmamixer is a fork of `wmsmixer`_ and is an `ALSA`_ mixer dockapp for Window
+Maker.
 
-The code for the ALSA part was taken and adapted from amixer and alsamixer 
+The code for the `ALSA`_ part was taken and adapted from amixer and alsamixer
 programs from alsa-utils package.
 
+.. image:: /images/wmamixer.gif?raw=true
+      :alt: wmamixer overview
+
+Build
+-----
+
+To build the dockapp, just perform following command in the project topmost
+directory:
+
+.. code:: shell-session
+
+   $ make
+
+Next, copy binary ``wmamixer`` in convenient place.
+
 Bugs
 ----
 
-If spotted any bug, please report it using bug tracker on bitbucket.
+If spotted any bug, please report it using bug tracker on bitbucket or github.
 
 Changes
 -------
 
-Changes with comparison with wmsmixer:
+Changes with comparison with `wmsmixer`_:
 
-- ALSA instead of OSS. This is the real thing, using alsa-lib, not just
+* `ALSA`_ instead of OSS. This is the real thing, using alsa-lib, not just
   emulation of OSS.
-- Removed config file support, since it doesn't apply anymore
+* Removed config file support, since it doesn't apply anymore
 
 Limitations
 -----------
@@ -29,7 +45,7 @@ ignored.
 
 2. There are controls with really small limit range, for example here is
 control Beep (pc speaker in other words) which is represented by amixer like
-this:
+this::
 
     Simple mixer control 'Beep',0
     Capabilities: pvolume pvolume-joined pswitch pswitch-joined
@@ -41,10 +57,5 @@ Under "Limits" section, there is a Playback capability with range 0 - 3. Using
 scrollwheel on such low ranges is somehow awkward. For that controls it's
 better to use clicking instead of scrolling.
 
-
-Links
------
-wmsmixer homepage:
-http://web.archive.org/web/20081024034859/http://www.hibernaculum.net/wmsmixer/index.php
-ALSA homepage:
-http://www.alsa-project.org
+.. _wmsmixer: http://web.archive.org/web/20081024034859/http://www.hibernaculum.net/wmsmixer/index.php
+.. _ALSA: http://www.alsa-project.org