From a7b3ca4688090086d1bfbcd16c321c83eb6736da Mon Sep 17 00:00:00 2001
From: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Date: Sun, 8 Sep 2013 18:46:42 +0200
Subject: [PATCH] DOC: correction of example in unstack docstring

---
 pandas/core/frame.py | 32 +++++++++++++++++++++-----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/pandas/core/frame.py b/pandas/core/frame.py
index a3eb3ea54c784..9f30c3e7f5255 100644
--- a/pandas/core/frame.py
+++ b/pandas/core/frame.py
@@ -3280,28 +3280,38 @@ def unstack(self, level=-1):
 
         Parameters
         ----------
-        level : int, string, or list of these, default last level
+        level : int, string, or list of these, default -1 (last level)
             Level(s) of index to unstack, can pass level name
 
+        See also
+        --------
+        DataFrame.pivot : Pivot a table based on column values.
+        DataFrame.stack : Pivot a level of the column labels (inverse operation 
+            from `unstack`).
+
         Examples
         --------
+        >>> index = pd.MultiIndex.from_tuples([('one', 'a'), ('one', 'b'),
+        ...                                    ('two', 'a'), ('two', 'b')])
+        >>> s = pd.Series(np.arange(1.0, 5.0), index=index)
         >>> s
-        one  a   1.
-        one  b   2.
-        two  a   3.
-        two  b   4.
+        one  a   1
+             b   2
+        two  a   3
+             b   4
+        dtype: float64
 
         >>> s.unstack(level=-1)
              a   b
-        one  1.  2.
-        two  3.  4.
+        one  1  2
+        two  3  4
 
-        >>> df = s.unstack(level=0)
-        >>> df
+        >>> s.unstack(level=0)
            one  two
-        a  1.   2.
-        b  3.   4.
+        a  1   3
+        b  2   4
 
+        >>> df = s.unstack(level=0)
         >>> df.unstack()
         one  a  1.
              b  3.