clarify example in plot docstring

ianhi · ianhi · commit 9967a3e85f20 · 2020-10-09T22:41:21.000-04:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1418,10 +1418,14 @@ def plot(self, *args, scalex=True, scaley=True, data=None, **kwargs):
           directly to *x*, *y*. A separate data set will be drawn for every
           column.
 
-          Example: an array ``a`` where the first column represents the *x*
-          values and the other columns are the *y* columns::
+          Example: For an array ``a`` with shape (N, m) calling::
 
-          >>> plot(a[0], a[1:])
+          >>> plot(a)
+
+          is equivalent to:
+
+          >>> for i in range(m):
+          ...     plot(a[:, i])
 
         - The third way is to specify multiple sets of *[x]*, *y*, *[fmt]*
           groups::
