Clarify Axes.hexbin doctring *extent* option

LindyBalboa · LindyBalboa · commit bed7c7be8065 · 2016-07-28T18:30:39.000+02:00
Without looking at the source, it was unclear that *extent* expects the limites to be given as exponents of powers of 10 if the axis scale is set to 'log'. E.g., using 3 to represent 1000. Removed superfluous style change commits. Will open separate pull request for that. Resolves: #6479
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -4111,7 +4111,7 @@ def hexbin(self, x, y, C=None, gridsize=100, bins=None,
         *xscale*: [ 'linear' | 'log' ]
            Use a linear or log10 scale on the horizontal axis.
 
-        *scale*: [ 'linear' | 'log' ]
+        *yscale*: [ 'linear' | 'log' ]
            Use a linear or log10 scale on the vertical axis.
 
         *mincnt*: [ *None* | a positive integer ]
@@ -4125,7 +4125,12 @@ def hexbin(self, x, y, C=None, gridsize=100, bins=None,
 
         *extent*: [ *None* | scalars (left, right, bottom, top) ]
            The limits of the bins. The default assigns the limits
-           based on gridsize, x, y, xscale and yscale.
+           based on *gridsize*, *x*, *y*, *xscale* and *yscale*.
+
+           If *xscale* or *yscale* is set to 'log', the limits are
+           expected to be the exponent for a power of 10. E.g. for
+           x-limits of 1 and 50 in 'linear' scale and y-limits
+           of 10 and 1000 in 'log' scale, enter (1, 50, 1, 3).
 
         Other keyword arguments controlling color mapping and normalization
         arguments:
