Merge pull request matplotlib#3698 from montefra/axvline_doc

DOC : fixed axvline description of ymin/ymax args. Little edit in axhline doc

Author: tacaswell

lib/matplotlib/axes/_axes.py

@@ -684,12 +684,12 @@ def axhline(self, y=0, xmin=0, xmax=1, **kwargs):
 
         Returns
         -------
-        `~matplotlib.lines.Line2D`
+        :class:`~matplotlib.lines.Line2D`
 
         Notes
         -----
-        kwargs are the same as kwargs to plot, and can be
-        used to control the line properties.  e.g.,
+        kwargs are passed to :class:`~matplotlib.lines.Line2D` and can be used
+        to control the line properties.
 
         Examples
         --------
@@ -702,7 +702,7 @@ def axhline(self, y=0, xmin=0, xmax=1, **kwargs):
 
             >>> axhline(y=1)
 
-        * draw a default hline at 'y' = .5 that spans the the middle half of
+        * draw a default hline at 'y' = .5 that spans the middle half of
           the xrange::
 
             >>> axhline(y=.5, xmin=0.25, xmax=0.75)
@@ -746,16 +746,16 @@ def axvline(self, x=0, ymin=0, ymax=1, **kwargs):
             x position in data coordinates of the vertical line.
 
         ymin : scalar, optional, default: 0
-            Should be between 0 and 1, 0 being the far left of the plot, 1 the
-            far right of the plot.
+            Should be between 0 and 1, 0 being the bottom of the plot, 1 the
+            top of the plot.
 
         ymax : scalar, optional, default: 1
-            Should be between 0 and 1, 0 being the far left of the plot, 1 the
-            far right of the plot.
+            Should be between 0 and 1, 0 being the bottom of the plot, 1 the
+            top of the plot.
 
         Returns
         -------
-        `~matplotlib.lines.Line2D`
+        :class:`~matplotlib.lines.Line2D`
 
 
         Examples

lib/matplotlib/pyplot.py

@@ -3066,7 +3066,7 @@ def phase_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None,
 def pie(x, explode=None, labels=None, colors=None, autopct=None,
         pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=None,
         radius=None, counterclock=True, wedgeprops=None, textprops=None,
-        hold=None,center=(0,0),frame=False):
+        center=(0, 0), frame=False, hold=None):
     ax = gca()
     # allow callers to override the hold state by passing hold=True|False
     washold = ax.ishold()
@@ -3078,8 +3078,8 @@ def pie(x, explode=None, labels=None, colors=None, autopct=None,
                      autopct=autopct, pctdistance=pctdistance, shadow=shadow,
                      labeldistance=labeldistance, startangle=startangle,
                      radius=radius, counterclock=counterclock,
-                     wedgeprops=wedgeprops, textprops=textprops,
-                     center=center,frame=frame)
+                     wedgeprops=wedgeprops, textprops=textprops, center=center,
+                     frame=frame)
         draw_if_interactive()
     finally:
         ax.hold(washold)