Revision: 6547
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=6547&view=rev
Author:   jdh2358
Date:     2008-12-10 14:55:05 +0000 (Wed, 10 Dec 2008)

Log Message:
-----------
updated linestyle and markerstyle doc strings

Modified Paths:
--------------
    trunk/matplotlib/lib/matplotlib/lines.py

Modified: trunk/matplotlib/lib/matplotlib/lines.py
===================================================================
--- trunk/matplotlib/lib/matplotlib/lines.py    2008-12-10 14:39:44 UTC (rev 
6546)
+++ trunk/matplotlib/lib/matplotlib/lines.py    2008-12-10 14:55:05 UTC (rev 
6547)
@@ -74,6 +74,14 @@
     return np.concatenate((points,lines))
 
 class Line2D(Artist):
+    """
+    A line - the line can have both a solid linestyle connecting all
+    the vertices, and a marker at each vertex.  Additionally, the
+    drawing of the solid line is influenced by the drawstyle, eg one
+    can create "stepped" lines in various styles.
+
+
+    """
     lineStyles = _lineStyles =  { # hidden names deprecated
         '-'          : '_draw_solid',
         '--'         : '_draw_dashed',
@@ -178,6 +186,11 @@
         The kwargs are :class:`~matplotlib.lines.Line2D` properties:
 
         %(Line2D)s
+
+        See :meth:`set_linestyle` for a decription of the line styles,
+        :meth:`set_marker` for a description of the markers, and
+        :meth:`set_drawstyle` for a description of the draw styles.
+
         """
         Artist.__init__(self)
 
@@ -589,11 +602,27 @@
 
     def set_linestyle(self, linestyle):
         """
-        Set the linestyle of the line
+        Set the linestyle of the line (also accepts drawstyles)
 
+
+        ================    =================
+        linestyle           description
+        ================    =================
+        '-'                 solid
+        '--'                dashed
+        '-.'                dash_dot
+        ':'                 dotted
+        'None'              draw nothing
+        ' '                 draw nothing
+        ''                  draw nothing
+        ================    =================
+
         'steps' is equivalent to 'steps-pre' and is maintained for
         backward-compatibility.
 
+        .. seealso::
+            :meth:`set_drawstyle`
+
         ACCEPTS: [ '-' | '--' | '-.' | ':' | 'None' | ' ' | '' ] and
         any drawstyle in combination with a linestyle, e.g. 'steps--'.
         """
@@ -622,6 +651,44 @@
         """
         Set the line marker
 
+        =========  ==========================
+        marker     description
+        =========  ==========================
+        '.'        point
+        ','        pixel
+        'o'        circle
+        'v'        triangle_down
+        '^'        triangle_up
+        '<'        triangle_left
+        '>'        triangle_right
+        '1'        tri_down
+        '2'        tri_up
+        '3'        tri_left
+        '4'        tri_right
+        's'        square
+        'p'        pentagon
+        '*'        star
+        'h'        hexagon1
+        'H'        hexagon2
+        '+'        plus
+        'x'        x
+        'D'        diamond
+        'd'        thin_diamond
+        '|'        vline
+        '_'        hline
+        TICKLEFT   tickleft
+        TICKRIGHT  tickright
+        TICKUP     tickup
+        TICKDOWN   tickdown
+        CARETLEFT  caretleft
+        CARETRIGHT caretright
+        CARETUP    caretup
+        CARETDOWN  caretdown
+        'None'     nothing
+        ' '        nothing
+        ''         nothing
+        =========  ==========================
+
         ACCEPTS: [ '+' | '*' | ',' | '.' | '1' | '2' | '3' | '4'
                  | '<' | '>' | 'D' | 'H' | '^' | '_' | 'd'
                  | 'h' | 'o' | 'p' | 's' | 'v' | 'x' | '|'


This was sent by the SourceForge.net collaborative development platform, the 
world's largest Open Source development site.

------------------------------------------------------------------------------
SF.Net email is Sponsored by MIX09, March 18-20, 2009 in Las Vegas, Nevada.
The future of the web can't happen without you.  Join us at MIX09 to help
pave the way to the Next Web now. Learn more and register at
http://ad.doubleclick.net/clk;208669438;13503038;i?http://2009.visitmix.com/
_______________________________________________
Matplotlib-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/matplotlib-checkins

Reply via email to