doc warnings

There are a number of documentation warnings -- at lease some of these
are because doc strings in the api docs are non-compliant. If you've
been working on any of these functions, please take a moment to try
and bring them up to snuff (I suspect one or more of these is mine,
but I'm pasting them all here).

WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/axes.py:docstring
of matplotlib.axes.Axes.acorr:36: (ERROR/3) Unexpected indentation.
WARNING: <autodoc>:0: (ERROR/3) Unexpected indentation.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/backend_bases.py:docstring
of matplotlib.backend_bases.FigureCanvasBase.start_event_loop_default:15:
(WARNING/2) Literal block expected; none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/backend_bases.py:docstring
of matplotlib.backend_bases.FigureCanvasBase.stop_event_loop_default:8:
(WARNING/2) Literal block expected; none found.
WARNING: /home/jdhunter/mpl/doc/api/cbook_api.rst:9: (WARNING/2) error
while formatting signature for matplotlib.cbook.Xlator: arg is not a
Python function
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/cbook.py:docstring
of matplotlib.cbook.distances_along_curve:6: (WARNING/2) Literal block
expected; none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/cbook.py:docstring
of matplotlib.cbook.is_closed_polygon:8: (WARNING/2) Literal block
expected; none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/cbook.py:docstring
of matplotlib.cbook.less_simple_linear_interpolation:14: (WARNING/2)
Literal block expected; none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/cbook.py:docstring
of matplotlib.cbook.path_length:6: (WARNING/2) Literal block expected;
none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/cbook.py:docstring
of matplotlib.cbook.vector_lengths:8: (WARNING/2) Literal block
expected; none found.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/figure.py:docstring
of matplotlib.figure.Figure.text:37: (WARNING/2) Inline strong
start-string without end-string.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/pyplot.py:docstring
of matplotlib.pyplot.acorr:55: (ERROR/3) Unexpected indentation.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/pyplot.py:docstring
of matplotlib.pyplot.annotate:15: (ERROR/3) Unexpected indentation.
WARNING: /home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/pyplot.py:docstring
of matplotlib.pyplot.gca:2: (WARNING/2) Inline strong start-string
without end-string.