Merge pull request #6842 from LindyBalboa/fix_issue_6479

tacaswell · tacaswell · commit 2811640235f0 · 2016-08-01T23:36:13.000-04:00
DOC: Clarify Axes.hexbin *extent* docstring
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -4109,7 +4109,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 ]
@@ -4123,7 +4123,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:
