Small addition/cleanup + resolved merge conflict

Author: tp

pandas/core/indexes/multi.py

@@ -2015,8 +2015,8 @@ def get_loc(self, key, method=None):
  See also
  --------
  Index.get_loc : get_loc method for (single-level) index.
- get_locs : Get location for a label/slice/list/mask or a sequence of
- such.
+ MultiIndex.get_locs : Get location for a label/slice/list/mask or a
+  sequence of such.
  """
  if method is not None:
  raise NotImplementedError('only the default get_loc method is '
@@ -2340,23 +2340,24 @@ def convert_indexer(start, stop, step, indexer=indexer, labels=labels):
  def get_locs(self, seq):
  """
  Get location for a given label/slice/list/mask or a sequence of such as
- a integer, slice or boolean mask.
+ an array of integers.
 
  Parameters
  ----------
- seq : label/slice/list/mask or a sequence of such.
+ seq : label/slice/list/mask or a sequence of such (one for each used
+ level. If a level should not be used, set it to
+ ``slice(None)``).
 
  Returns
  -------
- locs : integer, slice or boolean mask suitable
- for passing to iloc
+ locs : array of integers suitable for passing to iloc
 
  Examples
  ---------
  >>> mi = pd.MultiIndex.from_arrays([list('abb'), list('def')])
 
  >>> mi.get_locs('b')
- slice(1, 3, None)
+ array([1, 2], dtype=int64)
 
  >>> mi.get_locs([slice(None), ['e', 'f']])
  array([1, 2], dtype=int64)
@@ -2366,7 +2367,7 @@ def get_locs(self, seq):
 
  See also
  --------
- get_loc : Get location for a label or a tuple of labels.
+ MultiIndex.get_loc : Get location for a label or a tuple of labels.
  """
 
  # must be lexsorted to at least as many levels