Improve rendering of title docs

jenshnielsen · jenshnielsen · commit 602176e128e0 · 2014-09-21T12:08:33.000+01:00
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1311,17 +1311,24 @@ def title(s, *args, **kwargs):
     positioned above the axes in the center, flush with the left edge,
     and flush with the right edge.
 
+    .. seealso::
+        See :func:`~matplotlib.pyplot.text` for adding text
+        to the current axes
+
     Parameters
     ----------
     label : str
         Text to use for the title
+
     fontdict : dict
         A dictionary controlling the appearance of the title text,
         the default `fontdict` is:
-        {'fontsize': rcParams['axes.titlesize'],
-         'fontweight' : rcParams['axes.titleweight'],
-         'verticalalignment': 'baseline',
-         'horizontalalignment': loc}
+
+            {'fontsize': rcParams['axes.titlesize'],
+            'fontweight' : rcParams['axes.titleweight'],
+            'verticalalignment': 'baseline',
+            'horizontalalignment': loc}
+
     loc : {'center', 'left', 'right'}, str, optional
         Which title to set, defaults to 'center'
 
@@ -1337,11 +1344,6 @@ def title(s, *args, **kwargs):
         :class:`~matplotlib.text.Text` for a list of valid text
         properties.
 
-
-    See also
-    --------
-    See :func:`~matplotlib.pyplot.text` for adding text to the current axes
-
     """
     l =  gca().set_title(s, *args, **kwargs)
     draw_if_interactive()
