Apply patch by Manuel Metz to scatter docstring.

efiring · efiring · commit 43b38765fa35 · 2008-01-26T00:11:36.000Z
svn path=/branches/v0_91_maint/; revision=4896
diff --git a/lib/matplotlib/axes.py b/lib/matplotlib/axes.py
@@ -4047,10 +4047,22 @@ def scatter(self, x, y, s=20, c='b', marker='o', cmap=None, norm=None,
             'p' : pentagram
             'h' : hexagon
             '8' : octagon
-
-        If marker is None and verts is not None, verts is a sequence
-        of (x,y) vertices for a custom scatter symbol.
-
+        
+        The marker can also be a tuple (numsides, style, angle), which will
+        create a custom, regular symbol.
+        
+            numsides is the number of sides
+            
+            style is the style of the regular symbol:
+              0 : a regular polygon
+              1 : a star-like symbol
+              2 : an asterisk
+            
+            angle is the angle of rotation of the symbol
+        
+        Finally, marker can be (verts, 0), verts is a sequence of (x,y)
+        vertices for a custom scatter symbol.
+        
         s is a size argument in points squared.
 
         Any or all of x, y, s, and c may be masked arrays, in which
