From 2526b4d048531911251f2e1ccfb852010254730c Mon Sep 17 00:00:00 2001
From: Emlyn Price <emlyn.je.price@gmail.com>
Date: Fri, 8 Nov 2019 17:49:01 +0000
Subject: [PATCH] Add note about hist speed for large number of bins

---
 lib/matplotlib/axes/_axes.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index b2e93f8846f7..af301e34fd7f 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -6540,6 +6540,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