Merge pull request #18701 from meeseeksmachine/auto-backport-of-pr-18700-on-v3.3.2-doc

QuLogic · web-flow · commit b03b7a465a13 · 2020-10-10T01:27:47.000-04:00
Backport PR #18700 on branch v3.3.2-doc (clarify example in plot docstring)
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1566,10 +1566,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::
