Merge pull request #20956 from anntzer/lhu

timhoffm · web-flow · commit ceb794cff9b8 · 2021-09-01T04:59:36.000+02:00
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:
