refactor(docs): update features

README.rst

@@ -14,12 +14,13 @@ Features
 -  Simple and idiomatic API, extending Python `stdlib` with async coroutines gotchas.
 -  Built-in configurable control-flow concurrency support.
 -  Useful iterables, decorators and functors.
--  Provides coroutine-ready compose, throttle, partial, until, race and other functional helpers.
+-  Coroutine-based functional helpers: compose, throttle, partial, until, throttle, race...
 -  Asynchronous coroutine port of Python built-in functions: `filter`, `map`, `dropwhile`, `filterfalse`, `reduce`...
 -  Concurrent iterables and higher-order functions.
 -  Better `asyncio.gather()` and `asyncio.wait()` implementations with optional concurrency control and ordered results.
--  Good interoperability with `asyncio` and Python `stdlib` functions.
 -  Works with both `async/await`_ and `yield from`_ coroutines syntax.
+-  Designed for intensive I/O-bound concurrent non-blocking tasks.
+-  Good interoperability with `asyncio` and Python `stdlib` functions.
 -  Small and dependency free.
 -  Compatible with Python +3.4.
 

paco/wraps.py

@@ -7,7 +7,7 @@ def wraps(fn):
     """
     Wraps a given function as coroutine function.
 
-    This is a convenient helper function.
+    This function can be used as decorator.
 
     Arguments:
         fn (function): function object to wrap.
@@ -17,12 +17,21 @@ def wraps(fn):
 
     Usage::
 
+        # Use as function wrapper
         def mult(num, foo=None):
             return num * 2
 
         coro = paco.wraps(mult)
         await coro(2, foo='bar')
         => 4
+
+        # Use as decorator
+        @paco.wraps
+        def mult(num):
+            return num * 2
+
+        await mult(2)
+        => 4
     """
     @functools.wraps(fn)
     @asyncio.coroutine