Merge pull request #16526 from timhoffm/auto-backport-of-pr-16480-on-v3.2.x

timhoffm · web-flow · commit 09008198cbc9 · 2020-02-16T17:09:44.000+01:00
Backport PR #16480 on v.3.2.x: Re-phrase doc for bottom kwarg to hist
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -6446,15 +6446,12 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
             ``True``, then the histogram is normalized such that the first bin
             equals 1.
 
-            Default is ``False``
-
-        bottom : array-like, scalar, or None
-            Location of the bottom baseline of each bin.  If a scalar,
-            the base line for each bin is shifted by the same amount.
-            If an array, each bin is shifted independently and the length
-            of bottom must match the number of bins.  If None, defaults to 0.
-
-            Default is ``None``
+        bottom : array-like, scalar, or None, default: None
+            Location of the bottom of each bin, ie. bins are drawn from
+            ``bottom`` to ``bottom + hist(x, bins)`` If a scalar, the bottom
+            of each bin is shifted by the same amount. If an array, each bin
+            is shifted independently and the length of bottom must match the
+            number of bins. If None, defaults to 0.
 
         histtype : {'bar', 'barstacked', 'step',  'stepfilled'}, optional
             The type of histogram to draw.
