DOC: Document verts in scatter

tacaswell · tacaswell · commit 99fb60363efd · 2016-10-09T16:32:14.000-04:00
close #6958
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3811,8 +3811,7 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
                 vmin=None, vmax=None, alpha=None, linewidths=None,
                 verts=None, edgecolors=None,
                 **kwargs):
-        """
-        Make a scatter plot of x vs y, where x and y are sequence like objects
+        """Make a scatter plot of x vs y, where x and y are sequence like objects
         of the same length.
 
         Parameters
@@ -3861,6 +3860,11 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         linewidths : scalar or array_like, optional, default: None
             If None, defaults to (lines.linewidth,).
 
+        verts : sequence of (x, y), optional
+            If `marker` is None, these vertices will be used to
+            construct the marker.  The center of the marker is located
+            at (0,0) and the size is normalized.
+
         edgecolors : color or sequence of color, optional, default: None
             If None, defaults to 'face'
 
