Merge pull request #35 from jnothman/patch-1

Fix README re default use_list=True

1 files changed, 7 insertions, 8 deletions

diff --git a/README.rst b/README.rst
index 61cc56c..58f6cb1 100644
--- a/README.rst
+++ b/README.rst
@@ -29,21 +29,20 @@ msgpack provides ``dumps`` and ``loads`` as alias for compatibility with
 ``pack`` and ``dump`` packs to file-like object.
 ``unpack`` and ``load`` unpacks from file-like object.
 
+::
+
    >>> import msgpack
    >>> msgpack.packb([1, 2, 3])
    '\x93\x01\x02\x03'
    >>> msgpack.unpackb(_)
-   (1, 2, 3)
-
+   [1, 2, 3]
 
-``unpack`` unpacks msgpack's array to Python's tuple.
-To unpack it to list, Use ``use_list`` option.
+``unpack`` unpacks msgpack's array to Python's list, but can unpack to tuple::
 
-   >>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=True)
-   [1, 2, 3]
+   >>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=False)
+   (1, 2, 3)
 
-The default behavior will be changed in the future. (probably 0.4)
-You should always pass the ``use_list`` keyword argument.
+You should always pass the ``use_list`` keyword argument. See performance issues relating to use_list_ below.
 
 Read the docstring for other options.