Fix documentation formatting

Author: mdboom

doc/faq/howto_faq.rst

@@ -757,8 +757,8 @@ Cite Matplotlib
 
 If you want to refer to matplotlib in a publication, you can use
 "Matplotlib: A 2D Graphics Environment" by J. D. Hunter In Computing
-in Science & Engineering, Vol. 9, No. 3. (2007), pp. 90-95 (see `here
-<http://dx.doi.org/10.1109/MCSE.2007.55>`_)::
+in Science & Engineering, Vol. 9, No. 3. (2007), pp. 90-95 (see `this
+reference page <http://dx.doi.org/10.1109/MCSE.2007.55>`_)::
 
   @article{Hunter:2007,
 	  Address = {10662 LOS VAQUEROS CIRCLE, PO BOX 3014, LOS ALAMITOS, CA 90720-1314 USA},

doc/faq/troubleshooting_faq.rst

@@ -68,13 +68,13 @@ Getting help
 There are a number of good resources for getting help with matplotlib.
 There is a good chance your question has already been asked:
 
-  - The `mailing list
+  - The `mailing list archive
     <http://sourceforge.net/search/?group_id=80706&type_of_search=mlists>`_.
 
   - `Github issues <https://github.com/matplotlib/matplotlib/issues>`_.
 
   - Stackoverflow questions tagged `matplotlib
-<http://stackoverflow.com/questions/tagged/matplotlib>`_.
+    <http://stackoverflow.com/questions/tagged/matplotlib>`_.
 
 If you are unable to find an answer to your question through search,
 please provide the following information in your e-mail to the

doc/users/license.rst

@@ -10,8 +10,8 @@ the `PSF <http://www.python.org/psf/license>`_ license.  See the Open
 Source Initiative `licenses page
 <http://www.opensource.org/licenses>`_ for details on individual
 licenses. Non-BSD compatible licenses (eg LGPL) are acceptable in
-matplotlib :ref:`toolkits-index`.  For a discussion of the motivations
-behind the licencing choice, see :ref:`license-discussion`.
+matplotlib toolkits.  For a discussion of the motivations behind the
+licencing choice, see :ref:`license-discussion`.
 
 
 License agreement for matplotlib |version|
@@ -63,8 +63,3 @@ products or services of Licensee, or any third party.
 8. By copying, installing or otherwise using matplotlib |version|,
 Licensee agrees to be bound by the terms and conditions of this License
 Agreement.
-
-
-
-
-

lib/matplotlib/axes.py

@@ -4519,8 +4519,7 @@ def legend(self, *args, **kwargs):
             instance. If *prop* is a dictionary, a new instance will be
             created with *prop*. If *None*, use rc settings.
 
-          *fontsize*: [ size in points | 'xx-small' | 'x-small' |
-          'small' | 'medium' | 'large' | 'x-large' | 'xx-large' ]
+          *fontsize*: [ size in points | 'xx-small' | 'x-small' | 'small' | 'medium' | 'large' | 'x-large' | 'xx-large' ]
             Set the font size.  May be either a size string, relative to
             the default font size, or an absolute font size in points. This
             argument is only used if prop is not specified.
@@ -7069,7 +7068,7 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
             parameter, i.e. when interpolation is one of: 'sinc',
             'lanczos' or 'blackman'
 
-        Additional kwargs are :class:`~matplotlib.artist.Artist` properties:
+        Additional kwargs are :class:`~matplotlib.artist.Artist` properties.
 
         %(Artist)s
 
@@ -7365,13 +7364,13 @@ def pcolor(self, *args, **kwargs):
 
         x = X.compressed()
         y = Y.compressed()
-        
+
         # Transform from native to data coordinates?
         t = collection._transform
         if (not isinstance(t, mtransforms.Transform)
             and hasattr(t, '_as_mpl_transform')):
             t = t._as_mpl_transform(self.axes)
-        
+
         if t and any(t.contains_branch_seperately(self.transData)):
             trans_to_data = t - self.transData
             pts = np.vstack([x, y]).T.astype(np.float)
@@ -7505,13 +7504,13 @@ def pcolormesh(self, *args, **kwargs):
         collection.autoscale_None()
 
         self.grid(False)
-        
+
         # Transform from native to data coordinates?
         t = collection._transform
         if (not isinstance(t, mtransforms.Transform)
             and hasattr(t, '_as_mpl_transform')):
             t = t._as_mpl_transform(self.axes)
-        
+
         if t and any(t.contains_branch_seperately(self.transData)):
             trans_to_data = t - self.transData
             pts = np.vstack([X, Y]).T.astype(np.float)

lib/matplotlib/legend.py

@@ -205,7 +205,7 @@ def __init__(self, parent, handles, labels,
         title              the legend title
         bbox_to_anchor     the bbox that the legend will be anchored.
         bbox_transform     the transform for the bbox. transAxes if None.
-        ================   =====================================================
+        ================   ====================================================
 
 
         The pad and spacing parameters are measured in font-size units.  E.g.,

lib/matplotlib/patches.py

@@ -2762,9 +2762,12 @@ class Bar(_Base):
         def __init__(self, armA=0., armB=0., fraction=0.3, angle=None):
             """
             *armA* : minimum length of armA
+
             *armB* : minimum length of armB
+
             *fraction* : a fraction of the distance between two points that
                          will be added to armA and armB.
+
             *angle* : angle of the connecting line (if None, parallel to A
                       and B)
             """

lib/matplotlib/streamplot.py

@@ -52,10 +52,13 @@ def streamplot(axes, x, y, u, v, density=1, linewidth=None, color=None,
 
         *stream_container* : StreamplotSet
             Container object with attributes
-                lines: `matplotlib.collections.LineCollection` of streamlines
-                arrows: collection of `matplotlib.patches.FancyArrowPatch`
-                        objects representing arrows half-way along stream
-                        lines.
+
+                - lines: `matplotlib.collections.LineCollection` of streamlines
+
+                - arrows: collection of `matplotlib.patches.FancyArrowPatch`
+                  objects representing arrows half-way along stream
+                  lines.
+
             This container will probably change in the future to allow changes
             to the colormap, alpha, etc. for both lines and arrows, but these
             changes should be backward compatible.