Merge pull request matplotlib#15375 from EJEP/note_hist_speed

Add note to hist docstring about speed

Author: timhoffm

lib/matplotlib/axes/_axes.py

@@ -6603,6 +6603,11 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
         --------
         hist2d : 2D histograms
 
+        Notes
+        -----
+        For large numbers of bins (>1000), 'step' and 'stepfilled' can be
+        significantly faster than 'bar' and 'barstacked'.
+
         """
         # Avoid shadowing the builtin.
         bin_range = range