DOC: clarify usage of 'argparse' return value.

lzkelley · jaimefrio · commit d032a6f11b2c · 2016-03-15T08:21:40.000+01:00
In response to Ticket numpy#4724, explain that the 'index_array' returned by 'argparse' can only be used to (directly) sort a one-dimensional input array.
diff --git a/numpy/core/fromnumeric.py b/numpy/core/fromnumeric.py
@@ -848,7 +848,7 @@ def argsort(a, axis=-1, kind='quicksort', order=None):
     -------
     index_array : ndarray, int
         Array of indices that sort `a` along the specified axis.
-        In other words, ``a[index_array]`` yields a sorted `a`.
+        If `a` is one-dimensional, ``a[index_array]`` yields a sorted `a`.
 
     See Also
     --------
