Merge pull request #20958 from meeseeksmachine/auto-backport-of-pr-20956-on-v3.5.x

QuLogic · web-flow · commit 0de9c18a44c0 · 2021-09-01T01:53:05.000-04:00
Backport PR #20956 on branch v3.5.x (Make warning for no-handles legend more explicit.)
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
@@ -1224,7 +1224,10 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
     elif len(args) == 0:
         handles, labels = _get_legend_handles_labels(axs, handlers)
         if not handles:
-            log.warning('No handles with labels found to put in legend.')
+            log.warning(
+                "No artists with labels found to put in legend.  Note that "
+                "artists whose label start with an underscore are ignored "
+                "when legend() is called with no argument.")
 
     # One argument. User defined labels - automatic handle detection.
     elif len(args) == 1:
