refactor docs and ffi/high level event handling to pass all tests again

python/doc/capi.rst

@@ -1,7 +0,0 @@
-
-C deltachat interface
-=====================
-
-See :doc:`lapi` for accessing many of the below functions
-through the ``deltachat.capi.lib`` namespace.
-

python/doc/examples.rst

@@ -4,8 +4,8 @@ examples
 ========
 
 
-Playing around on the commandline
-----------------------------------
+Sending a Chat message from the command line
+---------------------------------------------
 
 Once you have :doc:`installed deltachat bindings <install>`
 you can start playing from the python interpreter commandline.
@@ -14,10 +14,10 @@ For example you can type ``python`` and then::
     # instantiate and configure deltachat account
     import deltachat
     ac = deltachat.Account("/tmp/db")
-    ac.set_config("addr", "test2@hq5.merlinux.eu")
+    ac.set_config("addr", "address@example.org")
     ac.set_config("mail_pwd", "some password")
 
-    # start the IO threads and perform configuration
+    # start IO threads and perform configuration
     ac.start()
 
     # create a contact and send a message
@@ -25,6 +25,23 @@ For example you can type ``python`` and then::
     chat = ac.create_chat_by_contact(contact)
     chat.send_text("hi from the python interpreter command line")
 
+    # shutdown IO threads
+    ac.shutdown()
+
+
+Checkout our :doc:`api` for the various high-level things you can do
+to send/receive messages, create contacts and chats.
+
+
+Receiving a Chat message from the command line
+----------------------------------------------
+
+Instantiate an account and register a plugin to process
+incoming messages:
+
+.. include:: ../examples/echo_and_quit.py
+    :literal:
+
 Checkout our :doc:`api` for the various high-level things you can do
 to send/receive messages, create contacts and chats.
 

python/doc/index.rst

@@ -29,6 +29,7 @@ getting started
    changelog
    api
    lapi
+   plugins
 
 ..
     Indices and tables