MNT: normalize inherit docstring comment + line length wrapping

tacaswell · tacaswell · commit b011e80dee4f · 2022-12-16T16:39:04.000-05:00
diff --git a/lib/matplotlib/legend_handler.py b/lib/matplotlib/legend_handler.py
@@ -161,8 +161,9 @@ def create_artists(self, legend, orig_handle,
             The fontsize in pixels. The legend artists being created should
             be scaled according to the given fontsize.
         trans :  `~matplotlib.transforms.Transform`
-            The transform that is applied to the legend artists being created.  Typically 
-            from unit coordinates in the handler box to screen coordinates.
+            The transform that is applied to the legend artists being created.
+            Typically from unit coordinates in the handler box to screen
+            coordinates.
         """
         raise NotImplementedError('Derived must override')
 
@@ -307,7 +308,7 @@ class HandlerLine2D(HandlerNpoints):
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         xdata, xdata_marker = self.get_xdata(legend, xdescent, ydescent,
                                              width, height, fontsize)
 
@@ -372,7 +373,7 @@ def _create_patch(self, legend, orig_handle,
 
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize, trans):
-        # Doc-string inherited
+        # docstring inherited
         p = self._create_patch(legend, orig_handle,
                                xdescent, ydescent, width, height, fontsize)
         self.update_prop(p, orig_handle, legend)
@@ -406,7 +407,7 @@ def _create_line(orig_handle, width, height):
 
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize, trans):
-        # Doc-string inherited
+        # docstring inherited
         if orig_handle.get_fill() or (orig_handle.get_hatch() is not None):
             p = self._create_patch(orig_handle, xdescent, ydescent, width,
                                    height)
@@ -437,7 +438,7 @@ def _default_update_prop(self, legend_handle, orig_handle):
 
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize, trans):
-        # Doc-string inherited
+        # docstring inherited
         xdata, xdata_marker = self.get_xdata(legend, xdescent, ydescent,
                                              width, height, fontsize)
         ydata = np.full_like(xdata, (height - ydescent) / 2)
@@ -504,7 +505,7 @@ def create_collection(self, orig_handle, sizes, offsets, offset_transform):
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         xdata, xdata_marker = self.get_xdata(legend, xdescent, ydescent,
                                              width, height, fontsize)
 
@@ -568,7 +569,7 @@ def get_err_size(self, legend, xdescent, ydescent,
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         plotlines, caplines, barlinecols = orig_handle
 
         xdata, xdata_marker = self.get_xdata(legend, xdescent, ydescent,
@@ -687,7 +688,7 @@ def get_ydata(self, legend, xdescent, ydescent, width, height, fontsize):
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         markerline, stemlines, baseline = orig_handle
         # Check to see if the stemcontainer is storing lines as a list or a
         # LineCollection. Eventually using a list will be removed, and this
@@ -765,7 +766,7 @@ def __init__(self, ndivide=1, pad=None, **kwargs):
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         handler_map = legend.get_legend_handler_map()
 
         if self._ndivide is None:
@@ -832,7 +833,7 @@ def get_first(prop_array):
 
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize, trans):
-        # Doc-string inherited
+        # docstring inherited
         p = Rectangle(xy=(-xdescent, -ydescent),
                       width=width, height=height)
         self.update_prop(p, orig_handle, legend)
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -3331,7 +3331,7 @@ def _get_bracket(self, x0, y0,
             return vertices_arrow, codes_arrow
 
         def transmute(self, path, mutation_size, linewidth):
-            # Doc-string inherited
+            # docstring inherited
             if self._beginarrow_head or self._endarrow_head:
                 head_length = self.head_length * mutation_size
                 head_width = self.head_width * mutation_size
@@ -3598,7 +3598,7 @@ def __init__(self, head_length=.5, head_width=.5, tail_width=.2):
             super().__init__()
 
         def transmute(self, path, mutation_size, linewidth):
-            # Doc-string inherited
+            # docstring inherited
             x0, y0, x1, y1, x2, y2 = self.ensure_quadratic_bezier(path)
 
             # divide the path into a head and a tail
@@ -3677,7 +3677,7 @@ def __init__(self, head_length=.4, head_width=.4, tail_width=.4):
             super().__init__()
 
         def transmute(self, path, mutation_size, linewidth):
-            # Doc-string inherited
+            # docstring inherited
             x0, y0, x1, y1, x2, y2 = self.ensure_quadratic_bezier(path)
 
             # divide the path into a head and a tail
@@ -3766,7 +3766,7 @@ def __init__(self, tail_width=.3, shrink_factor=0.5):
             super().__init__()
 
         def transmute(self, path, mutation_size, linewidth):
-            # Doc-string inherited
+            # docstring inherited
             x0, y0, x1, y1, x2, y2 = self.ensure_quadratic_bezier(path)
 
             arrow_path = [(x0, y0), (x1, y1), (x2, y2)]
