matplotlib
diff --git a/‎lib/matplotlib/__init__.py
Lines changed: 2 additions & 2 deletions b/‎lib/matplotlib/__init__.py
Lines changed: 2 additions & 2 deletions
diff --git a/‎lib/matplotlib/animation.py
Lines changed: 2 additions & 2 deletions b/‎lib/matplotlib/animation.py
Lines changed: 2 additions & 2 deletions
diff --git a/‎lib/matplotlib/artist.py
Lines changed: 5 additions & 9 deletions b/‎lib/matplotlib/artist.py
Lines changed: 5 additions & 9 deletions
diff --git a/‎lib/matplotlib/axes/_base.py
Lines changed: 94 additions & 88 deletions b/‎lib/matplotlib/axes/_base.py
Lines changed: 94 additions & 88 deletions
diff --git a/‎lib/matplotlib/cbook/__init__.py
Lines changed: 4 additions & 4 deletions b/‎lib/matplotlib/cbook/__init__.py
Lines changed: 4 additions & 4 deletions
diff --git a/‎lib/matplotlib/colorbar.py
Lines changed: 2 additions & 2 deletions b/‎lib/matplotlib/colorbar.py
Lines changed: 2 additions & 2 deletions
diff --git a/‎lib/matplotlib/font_manager.py
Lines changed: 3 additions & 3 deletions b/‎lib/matplotlib/font_manager.py
Lines changed: 3 additions & 3 deletions
diff --git a/‎lib/matplotlib/lines.py
Lines changed: 3 additions & 4 deletions b/‎lib/matplotlib/lines.py
Lines changed: 3 additions & 4 deletions
@@ -522,7 +522,7 @@ def _create_tmp_config_or_cache_dir():
 
 def _get_xdg_config_dir():
     """
-    Returns the XDG configuration directory, according to the `XDG
+    Return the XDG configuration directory, according to the `XDG
     base directory spec
     <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_.
     """
@@ -534,7 +534,7 @@ def _get_xdg_config_dir():
 
 def _get_xdg_cache_dir():
     """
-    Returns the XDG cache directory, according to the `XDG
+    Return the XDG cache directory, according to the `XDG
     base directory spec
     <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_.
     """
 
@@ -384,7 +384,7 @@ def grab_frame(self, **savefig_kwargs):
                          dpi=self.dpi, **savefig_kwargs)
 
     def _frame_sink(self):
-        '''Returns the place to which frames should be written.'''
+        '''Return the place to which frames should be written.'''
         return self._proc.stdin
 
     def _args(self):
@@ -413,7 +413,7 @@ def cleanup(self):
     @classmethod
     def bin_path(cls):
         '''
-        Returns the binary path to the commandline tool used by a specific
+        Return the binary path to the commandline tool used by a specific
         subclass. This is a class method so that the tool can be looked for
         before making a particular MovieWriter subclass available.
         '''
 
@@ -1560,10 +1560,8 @@ def setp(obj, *args, **kwargs):
 
 def kwdoc(artist):
     r"""
-    Inspect an `~matplotlib.artist.Artist` class and return
-    information about its settable properties and their current values.
-
-    It use the class `.ArtistInspector`.
+    Inspect an `~matplotlib.artist.Artist` class (using `.ArtistInspector`) and
+    return information about its settable properties and their current values.
 
     Parameters
     ----------
@@ -1572,11 +1570,9 @@ def kwdoc(artist):
     Returns
     -------
     string
-        Returns a string with a list or rst table with the settable properties
-        of the *artist*. The formatting depends on the value of
-        :rc:`docstring.hardcopy`. False result in a list that is intended for
-        easy reading as a docstring and True result in a rst table intended
-        for rendering the documentation with sphinx.
+        The settable properties of *artist*, as plain text if
+        :rc:`docstring.hardcopy` is False and as a rst table (intended for
+        use in Sphinx) if it is True.
     """
     hardcopy = matplotlib.rcParams['docstring.hardcopy']
     if hardcopy:
 
@@ -683,23 +683,23 @@ def get_xaxis_transform(self, which='grid'):
 
     def get_xaxis_text1_transform(self, pad_points):
         """
-        Get the transformation used for drawing x-axis labels, which
-        will add the given amount of padding (in points) between the
-        axes and the label.  The x-direction is in data coordinates
-        and the y-direction is in axis coordinates.  Returns a
-        3-tuple of the form::
-
-          (transform, valign, halign)
-
-        where *valign* and *halign* are requested alignments for the
-        text.
-
-        .. note::
+        Returns
+        -------
+        transform : Transform
+            The transform used for drawing x-axis labels, which will add
+            *pad_points* of padding (in points) between the axes and the label.
+            The x-direction is in data coordinates and the y-direction is in
+            axis corrdinates
+        valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
+            The text vertical alignment.
+        halign : {'center', 'left', 'right'}
+            The text horizontal alignment.
 
-            This transformation is primarily used by the
-            `~matplotlib.axis.Axis` class, and is meant to be
-            overridden by new kinds of projections that may need to
-            place axis elements in different locations.
+        Notes
+        -----
+        This transformation is primarily used by the `~matplotlib.axis.Axis`
+        class, and is meant to be overridden by new kinds of projections that
+        may need to place axis elements in different locations.
         """
         labels_align = rcParams["xtick.alignment"]
         return (self.get_xaxis_transform(which='tick1') +
@@ -709,23 +709,23 @@ def get_xaxis_text1_transform(self, pad_points):
 
     def get_xaxis_text2_transform(self, pad_points):
         """
-        Get the transformation used for drawing the secondary x-axis
-        labels, which will add the given amount of padding (in points)
-        between the axes and the label.  The x-direction is in data
-        coordinates and the y-direction is in axis coordinates.
-        Returns a 3-tuple of the form::
-
-          (transform, valign, halign)
-
-        where *valign* and *halign* are requested alignments for the
-        text.
-
-        .. note::
+        Returns
+        -------
+        transform : Transform
+            The transform used for drawing secondary x-axis labels, which will
+            add *pad_points* of padding (in points) between the axes and the
+            label.  The x-direction is in data coordinates and the y-direction
+            is in axis corrdinates
+        valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
+            The text vertical alignment.
+        halign : {'center', 'left', 'right'}
+            The text horizontal alignment.
 
-            This transformation is primarily used by the
-            `~matplotlib.axis.Axis` class, and is meant to be
-            overridden by new kinds of projections that may need to
-            place axis elements in different locations.
+        Notes
+        -----
+        This transformation is primarily used by the `~matplotlib.axis.Axis`
+        class, and is meant to be overridden by new kinds of projections that
+        may need to place axis elements in different locations.
         """
         labels_align = rcParams["xtick.alignment"]
         return (self.get_xaxis_transform(which='tick2') +
@@ -759,23 +759,23 @@ def get_yaxis_transform(self, which='grid'):
 
     def get_yaxis_text1_transform(self, pad_points):
         """
-        Get the transformation used for drawing y-axis labels, which
-        will add the given amount of padding (in points) between the
-        axes and the label.  The x-direction is in axis coordinates
-        and the y-direction is in data coordinates.  Returns a 3-tuple
-        of the form::
-
-          (transform, valign, halign)
-
-        where *valign* and *halign* are requested alignments for the
-        text.
-
-        .. note::
+        Returns
+        -------
+        transform : Transform
+            The transform used for drawing y-axis labels, which will add
+            *pad_points* of padding (in points) between the axes and the label.
+            The x-direction is in axis coordinates and the y-direction is in
+            data corrdinates
+        valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
+            The text vertical alignment.
+        halign : {'center', 'left', 'right'}
+            The text horizontal alignment.
 
-            This transformation is primarily used by the
-            `~matplotlib.axis.Axis` class, and is meant to be
-            overridden by new kinds of projections that may need to
-            place axis elements in different locations.
+        Notes
+        -----
+        This transformation is primarily used by the `~matplotlib.axis.Axis`
+        class, and is meant to be overridden by new kinds of projections that
+        may need to place axis elements in different locations.
         """
         labels_align = rcParams["ytick.alignment"]
         return (self.get_yaxis_transform(which='tick1') +
@@ -785,23 +785,23 @@ def get_yaxis_text1_transform(self, pad_points):
 
     def get_yaxis_text2_transform(self, pad_points):
         """
-        Get the transformation used for drawing the secondary y-axis
-        labels, which will add the given amount of padding (in points)
-        between the axes and the label.  The x-direction is in axis
-        coordinates and the y-direction is in data coordinates.
-        Returns a 3-tuple of the form::
-
-          (transform, valign, halign)
-
-        where *valign* and *halign* are requested alignments for the
-        text.
-
-        .. note::
+        Returns
+        -------
+        transform : Transform
+            The transform used for drawing secondart y-axis labels, which will
+            add *pad_points* of padding (in points) between the axes and the
+            label.  The x-direction is in axis coordinates and the y-direction
+            is in data corrdinates
+        valign : {'center', 'top', 'bottom', 'baseline', 'center_baseline'}
+            The text vertical alignment.
+        halign : {'center', 'left', 'right'}
+            The text horizontal alignment.
 
-            This transformation is primarily used by the
-            `~matplotlib.axis.Axis` class, and is meant to be
-            overridden by new kinds of projections that may need to
-            place axis elements in different locations.
+        Notes
+        -----
+        This transformation is primarily used by the `~matplotlib.axis.Axis`
+        class, and is meant to be overridden by new kinds of projections that
+        may need to place axis elements in different locations.
         """
         labels_align = rcParams["ytick.alignment"]
         return (self.get_yaxis_transform(which='tick2') +
@@ -924,33 +924,35 @@ def _set_artist_props(self, a):
 
     def _gen_axes_patch(self):
         """
-        Returns the patch used to draw the background of the axes.  It
-        is also used as the clipping path for any data elements on the
-        axes.
-
-        In the standard axes, this is a rectangle, but in other
-        projections it may not be.
-
-        .. note::
+        Returns
+        -------
+        Patch
+            The patch used to draw the background of the axes.  It is also used
+            as the clipping path for any data elements on the axes.
 
-            Intended to be overridden by new projection types.
+            In the standard axes, this is a rectangle, but in other projections
+            it may not be.
 
+        Notes
+        -----
+        Intended to be overridden by new projection types.
         """
         return mpatches.Rectangle((0.0, 0.0), 1.0, 1.0)
 
     def _gen_axes_spines(self, locations=None, offset=0.0, units='inches'):
         """
-        Returns a dict whose keys are spine names and values are
-        Line2D or Patch instances. Each element is used to draw a
-        spine of the axes.
-
-        In the standard axes, this is a single line segment, but in
-        other projections it may not be.
+        Returns
+        -------
+        dict
+            Mapping of spine names to `Line2D` or `Patch` instances that are
+            used to draw axes spines.
 
-        .. note::
-
-            Intended to be overridden by new projection types.
+            In the standard axes, spines are single line segments, but in other
+            projections they may not be.
 
+        Notes
+        -----
+        Intended to be overridden by new projection types.
         """
         return OrderedDict((side, mspines.Spine.linear_spine(self, side))
                            for side in ['left', 'right', 'bottom', 'top'])
@@ -1411,10 +1413,11 @@ def set_anchor(self, anchor, share=False):
 
     def get_data_ratio(self):
         """
-        Returns the aspect ratio of the raw data.
+        Return the aspect ratio of the raw data.
 
-        This method is intended to be overridden by new projection
-        types.
+        Notes
+        -----
+        This method is intended to be overridden by new projection types.
         """
         xmin, xmax = self.get_xbound()
         ymin, ymax = self.get_ybound()
@@ -1426,8 +1429,11 @@ def get_data_ratio(self):
 
     def get_data_ratio_log(self):
         """
-        Returns the aspect ratio of the raw data in log scale.
-        Will be used when both axis scales are in log.
+        Return the aspect ratio of the raw data in log scale.
+
+        Notes
+        -----
+        Will be used when both axis are in log scale.
         """
         xmin, xmax = self.get_xbound()
         ymin, ymax = self.get_ybound()
@@ -4251,7 +4257,7 @@ def contains(self, mouseevent):
 
     def contains_point(self, point):
         """
-        Returns whether *point* (pair of pixel coordinates) is inside the axes
+        Return whether *point* (pair of pixel coordinates) is inside the axes
         patch.
         """
         return self.patch.contains_point(point, radius=1.0)
 
@@ -368,7 +368,7 @@ def is_writable_file_like(obj):
 
 def file_requires_unicode(x):
     """
-    Returns whether the given writable file-like object requires Unicode to be
+    Return whether the given writable file-like object requires Unicode to be
     written to it.
     """
     try:
@@ -494,7 +494,7 @@ def get_sample_data(fname, asfileobj=True):
 
 def flatten(seq, scalarp=is_scalar_or_string):
     """
-    Returns a generator of flattened nested containers
+    Return a generator of flattened nested containers
 
     For example:
 
@@ -943,7 +943,7 @@ def join(self, a, *args):
         self.clean()
 
     def joined(self, a, b):
-        """Returns True if *a* and *b* are members of the same set."""
+        """Return whether *a* and *b* are members of the same set."""
         self.clean()
         return (self._mapping.get(weakref.ref(a), object())
                 is self._mapping.get(weakref.ref(b)))
@@ -966,7 +966,7 @@ def __iter__(self):
             yield [x() for x in group]
 
     def get_siblings(self, a):
-        """Returns all of the items joined with *a*, including itself."""
+        """Return all of the items joined with *a*, including itself."""
         self.clean()
         siblings = self._mapping.get(weakref.ref(a), [weakref.ref(a)])
         return [x() for x in siblings]
 
@@ -460,11 +460,11 @@ def __init__(self, ax, cmap=None,
         self.draw_all()
 
     def _extend_lower(self):
-        """Returns whether the lower limit is open ended."""
+        """Return whether the lower limit is open ended."""
         return self.extend in ('both', 'min')
 
     def _extend_upper(self):
-        """Returns whether the uper limit is open ended."""
+        """Return whether the uper limit is open ended."""
         return self.extend in ('both', 'max')
 
     def _patch_ax(self):
 
@@ -1310,9 +1310,9 @@ def _findfont_cached(self, prop, fontext, directory, fallback_to_default,
 @lru_cache()
 def is_opentype_cff_font(filename):
     """
-    Returns True if the given font is a Postscript Compact Font Format
-    Font embedded in an OpenType wrapper.  Used by the PostScript and
-    PDF backends that can not subset these fonts.
+    Return whether the given font is a Postscript Compact Font Format Font
+    embedded in an OpenType wrapper.  Used by the PostScript and PDF backends
+    that can not subset these fonts.
     """
     if os.path.splitext(filename)[1].lower() == '.otf':
         with open(filename, 'rb') as fd:
 
@@ -72,12 +72,11 @@ def _scale_dashes(offset, dashes, lw):
 
 def segment_hits(cx, cy, x, y, radius):
     """
-    Determine if any line segments are within radius of a
-    point. Returns the list of line segments that are within that
-    radius.
+    Return the indices of the segments in the polyline with coordinates (*cx*,
+    *cy*) that are within a distance *radius* of the point (*x*, *y*).
     """
     # Process single points specially
-    if len(x) < 2:
+    if len(x) <= 1:
         res, = np.nonzero((cx - x) ** 2 + (cy - y) ** 2 <= radius ** 2)
         return res