Some more docstring fixes.

anntzer · anntzer · commit 0cea2e2d4066 · 2017-09-09T00:22:59.000-07:00
Axes.pick can be removed as it just inherits Artist.pick.
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -287,23 +287,18 @@ def remove_callback(self, oid):
 
     def pchanged(self):
         """
-        Fire an event when property changed, calling all of the
-        registered callbacks.
+        Fire an event when property changed, calling all registered callbacks.
         """
         for oid, func in six.iteritems(self._propobservers):
             func(self)
 
     def is_transform_set(self):
-        """
-        Returns *True* if `Artist` has a transform explicitly
-        set.
-        """
+        """Return whether this artist has a transform explicitly set."""
         return self._transformSet
 
     def set_transform(self, t):
         """
-        Set the `~matplotlib.transforms.Transform` instance
-        used by this artist.
+        Set the `~matplotlib.transforms.Transform` used by this artist.
 
         ACCEPTS: `~matplotlib.transforms.Transform` instance
         """
@@ -313,9 +308,7 @@ def set_transform(self, t):
         self.stale = True
 
     def get_transform(self):
-        """
-        Return the `~matplotlib.transforms.Transform`
-        instance used by this artist.
+        """Return the `~matplotlib.transforms.Transform` used by this artist.
         """
         if self._transform is None:
             self._transform = IdentityTransform()
@@ -343,14 +336,11 @@ def hitlist(self, event):
         return L
 
     def get_children(self):
-        """
-        Return a list of the child `Artist`s this
-        `Artist` contains.
-        """
+        """Return a list of the child `Artist`s this artist contains."""
         return []
 
     def contains(self, mouseevent):
-        """Test whether the artist contains the mouse event.
+        """Test whether this artist contains the mouse event.
 
         Returns the truth value and a dictionary of artist specific details of
         selection, such as which points are contained in the pick radius.  See
@@ -384,17 +374,17 @@ def get_contains(self):
         return self._contains
 
     def pickable(self):
-        'Return *True* if `Artist` is pickable.'
+        """Return whether the artist is pickable."""
         return (self.figure is not None and
                 self.figure.canvas is not None and
                 self._picker is not None)
 
     def pick(self, mouseevent):
         """
-        Process pick event
+        Process pick event.
 
-        each child artist will fire a pick event if *mouseevent* is over
-        the artist and the artist has picker set
+        Each child artist will fire a pick event if *mouseevent* is over the
+        artist and the artist has picker set.
         """
         # Pick self
         if self.pickable():
@@ -811,9 +801,7 @@ def set_animated(self, b):
             self.pchanged()
 
     def update(self, props):
-        """
-        Update the properties of this `Artist` from the
-        dictionary *prop*.
+        """Update the properties of this artist from the dictionary *props*.
         """
         def _update_property(self, k, v):
             """sorting out how to update property (setter or setattr)
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -1882,11 +1882,9 @@ def bar(self, *args, **kwargs):
         """
         Make a bar plot.
 
-        Call signatures::
+        Call signature::
 
-           bar(x, height, *, align='center', **kwargs)
-           bar(x, height, width, *, align='center', **kwargs)
-           bar(x, height, width, bottom, *, align='center', **kwargs)
+           bar(x, height, width=0.8, bottom=None, *, align='center', **kwargs)
 
         Make a bar plot with rectangles bounded by
 
@@ -2212,11 +2210,9 @@ def barh(self, *args, **kwargs):
         """
         Make a horizontal bar plot.
 
-        Call signatures::
+        Call signature::
 
-           bar(y, width, *, align='center', **kwargs)
-           bar(y, width, height, *, align='center', **kwargs)
-           bar(y, width, height, left, *, align='center', **kwargs)
+           barh(y, width, height=0.8, left=None, *, align='center', **kwargs)
 
         Make a horizontal bar plot with rectangles by default bounded by
 
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -3882,18 +3882,6 @@ def contains_point(self, point):
         """
         return self.patch.contains_point(point, radius=1.0)
 
-    def pick(self, *args):
-        """Trigger pick event
-
-        Call signature::
-
-            pick(mouseevent)
-
-        each child artist will fire a pick event if mouseevent is over
-        the artist and the artist has picker set
-        """
-        martist.Artist.pick(self, args[0])
-
     def get_default_bbox_extra_artists(self):
         return [artist for artist in self.get_children()
                 if artist.get_visible()]
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -630,18 +630,6 @@ def figimage(self, X,
         """
         Adds a non-resampled image to the figure.
 
-        call signatures::
-
-          figimage(X, **kwargs)
-
-        adds a non-resampled array *X* to the figure.
-
-        ::
-
-          figimage(X, xo, yo)
-
-        with pixel offsets *xo*, *yo*,
-
         *X* must be a float array:
 
         * If *X* is MxN, assume luminance (grayscale)
