update set_levels docstrings

Author: hweecat

pandas/core/indexes/multi.py

@@ -739,18 +739,6 @@ def set_levels(self, levels, level=None, inplace=False, verify_integrity=True):
         """
         Set new levels on MultiIndex. Defaults to returning new index.
 
-        ``set_levels`` passes a new value for each index in the level,
-        where the new values to be passed in each level are defined in
-        a list. It is assumed that a new value is provided for each
-        code describing values in the level.
-
-        If the number of values passed is more than the number of index
-        values in the level, ``set_levels`` will still pass the values
-        to the level. The passed values are stored in the FrozenList
-        representing the levels attribute of the MultiIndex, even
-        though the index values may be truncated in the MultiIndex
-        output from set_levels.
-
         Parameters
         ----------
         levels : sequence or list of sequence
@@ -772,14 +760,6 @@ def set_levels(self, levels, level=None, inplace=False, verify_integrity=True):
                                             (2, 'one'), (2, 'two'),
                                             (3, 'one'), (3, 'two')],
                                             names=['foo', 'bar'])
-        >>> idx
-        MultiIndex([('1', one),
-                    ('1', two),
-                    ('2', one),
-                    ('2', two),
-                    ('3', one),
-                    ('3', two)],
-                   names=['foo', 'bar'])
         >>> idx.set_levels([['a', 'b', 'c'], [1, 2]])
         MultiIndex([('a', 1),
                     ('a', 2),
@@ -805,22 +785,10 @@ def set_levels(self, levels, level=None, inplace=False, verify_integrity=True):
                     (3, 'b')],
                    names=['foo', 'bar'])
 
-        ``set_levels()`` passes values into the levels attribute that
-        is represented by a FrozenList containing list of values for
-        each level in the MultiIndex, even when the number of values
-        passed for a level is more than the number of indexes
-        available in the MultiIndex itself.
+        If any of the levels passed to ``set_levels()`` exceeds the
+        existing length, all of the values from that argument will
+        be stored though truncated in the MultiIndex output.
 
-        >>> idx.set_levels([['a', 'b', 'c'], [1, 2]], level=[0, 1])
-        MultiIndex([('a', 1),
-                    ('a', 2),
-                    ('b', 1),
-                    ('b', 2),
-                    ('c', 1),
-                    ('c', 2)],
-                   names=['foo', 'bar'])
-        >>> idx.set_levels([['a', 'b', 'c'], [1, 2]], level=[0, 1]).levels
-        FrozenList([['a', 'b', 'c'], [1, 2]])
         >>> idx.set_levels([['a', 'b', 'c'], [1, 2, 3, 4]], level=[0, 1])
         MultiIndex([('a', 1),
                     ('a', 2),