continue conversion of docstrings to restructured text

svn path=/trunk/matplotlib/; revision=5351

Author: ddale

boilerplate.py

@@ -28,6 +28,7 @@ def %(func)s(*args, **kwargs):
     return ret
 if Axes.%(func)s.__doc__ is not None:
     %(func)s.__doc__ = dedent(Axes.%(func)s.__doc__) + \"\"\"
+
 Additional kwargs: hold = [True|False] overrides default hold state\"\"\"
 """
 

lib/matplotlib/__init__.py

@@ -653,38 +653,42 @@ def rc(group, **kwargs):
     for lines.linewidth the group is 'lines', for axes.facecolor, the
     group is 'axes', and so on.  Group may also be a list or tuple
     of group names, eg ('xtick','ytick').  kwargs is a list of
-    attribute name/value pairs, eg
+    attribute name/value pairs, eg::
 
       rc('lines', linewidth=2, color='r')
 
-    sets the current rc params and is equivalent to
+    sets the current rc params and is equivalent to::
 
       rcParams['lines.linewidth'] = 2
       rcParams['lines.color'] = 'r'
 
     The following aliases are available to save typing for interactive
-    users
-        'lw'  : 'linewidth'
-        'ls'  : 'linestyle'
-        'c'   : 'color'
-        'fc'  : 'facecolor'
-        'ec'  : 'edgecolor'
-        'mew' : 'markeredgewidth'
-        'aa'  : 'antialiased'
-
-    Thus you could abbreviate the above rc command as
+    users:
+
+    =====   =================
+    Alias   Property
+    =====   =================
+    'lw'    'linewidth'
+    'ls'    'linestyle'
+    'c'     'color'
+    'fc'    'facecolor'
+    'ec'    'edgecolor'
+    'mew'   'markeredgewidth'
+    'aa'    'antialiased'
+    =====   =================
+
+    Thus you could abbreviate the above rc command as::
 
           rc('lines', lw=2, c='r')
 
 
     Note you can use python's kwargs dictionary facility to store
     dictionaries of default parameters.  Eg, you can customize the
-    font rc as follows
+    font rc as follows::
 
       font = {'family' : 'monospace',
               'weight' : 'bold',
-              'size'   : 'larger',
-             }
+              'size'   : 'larger'}
 
       rc('font', **font)  # pass in the font dict as kwargs
 

lib/matplotlib/artist.py

@@ -724,27 +724,27 @@ def setp(h, *args, **kwargs):
     If you want to see all the properties that can be set, and their
     possible values, you can do
 
-
       >>> setp(line)
-          ... long output listing omitted'
+          ... long output listing omitted
 
     setp operates on a single instance or a list of instances.  If you
     are in query mode introspecting the possible values, only the first
     instance in the sequence is used.  When actually setting values,
     all the instances will be set.  Eg, suppose you have a list of two
     lines, the following will make both lines thicker and red
 
-        >>> x = arange(0,1.0,0.01)
-        >>> y1 = sin(2*pi*x)
-        >>> y2 = sin(4*pi*x)
-        >>> lines = plot(x, y1, x, y2)
-        >>> setp(lines, linewidth=2, color='r')
+      >>> x = arange(0,1.0,0.01)
+      >>> y1 = sin(2*pi*x)
+      >>> y2 = sin(4*pi*x)
+      >>> lines = plot(x, y1, x, y2)
+      >>> setp(lines, linewidth=2, color='r')
 
     setp works with the matlab(TM) style string/value pairs or with
     python kwargs.  For example, the following are equivalent
 
-        >>> setp(lines, 'linewidth', 2, 'color', r')  # matlab style
-        >>> setp(lines, linewidth=2, color='r')       # python style
+      >>> setp(lines, 'linewidth', 2, 'color', r')  # matlab style
+      >>> setp(lines, linewidth=2, color='r')       # python style
+
     """
 
     insp = ArtistInspector(h)