Provide documentation for RemoteControl class

Also fixes a couple of warnings from sphinx.

Fixes #214

Author: ddemidov

README.rst

@@ -45,12 +45,12 @@ Make sure that you look at the `User Resources`_ section as well for links
 to documentation and larger examples.
 
 Usage Examples
-------------
+--------------
 
 To run these minimal examples, run the Python3 interpreter from
 the terminal using the ``python3`` command: 
 
-.. code-block::
+.. code-block:: bash
 
   $ python3
   Python 3.4.2 (default, Oct  8 2014, 14:47:30) 

docs/other.rst

@@ -3,6 +3,45 @@ Other classes
 
 .. currentmodule:: ev3dev.core
 
+Remote Control
+--------------
+
+.. autoclass:: RemoteControl
+    :members:
+    :inherited-members:
+
+    .. rubric:: Event handlers
+
+    These will be called when state of the corresponding button is changed:
+
+    .. py:data:: on_red_up
+    .. py:data:: on_red_down
+    .. py:data:: on_blue_up
+    .. py:data:: on_blue_down
+    .. py:data:: on_beacon
+
+    .. rubric:: Member functions and properties
+
+Button
+------
+
+.. autoclass:: ev3dev.ev3.Button
+    :members:
+    :inherited-members:
+
+    .. rubric:: Event handlers
+
+    These will be called when state of the corresponding button is changed:
+
+    .. py:data:: on_up
+    .. py:data:: on_down
+    .. py:data:: on_left
+    .. py:data:: on_right
+    .. py:data:: on_enter
+    .. py:data:: on_backspace
+
+    .. rubric:: Member functions and properties
+
 Leds
 ----
 
@@ -44,13 +83,6 @@ Power Supply
 .. autoclass:: PowerSupply
     :members:
 
-Button
-------
-
-.. autoclass:: ev3dev.ev3.Button
-    :members:
-    :inherited-members:
-
 Sound
 -----