Merge pull request #27847 from meeseeksmachine/auto-backport-of-pr-27846-on-v3.8.x

rcomer · web-flow · commit e8d9bbd14553 · 2024-03-03T17:16:44.000Z
Backport PR #27846 on branch v3.8.x (Make example in legend_elements doc more generalisable)
diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
@@ -1038,12 +1038,12 @@ def legend_elements(self, prop="colors", num="auto",
         Create legend handles and labels for a PathCollection.
 
         Each legend handle is a `.Line2D` representing the Path that was drawn,
-        and each label is a string what each Path represents.
+        and each label is a string that represents the Path.
 
         This is useful for obtaining a legend for a `~.Axes.scatter` plot;
         e.g.::
 
-            scatter = plt.scatter([1, 2, 3],  [4, 5, 6],  c=[7, 2, 3])
+            scatter = plt.scatter([1, 2, 3],  [4, 5, 6],  c=[7, 2, 3], num=None)
             plt.legend(*scatter.legend_elements())
 
         creates three legend elements, one for each color with the numerical
