Use decorators to manipulate docstrings; patch by Jason Coombs

Tracker 2835685, file DocstringOptimizedTypeErrorRev5.patch

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

Author: efiring

boilerplate.py

@@ -20,6 +20,7 @@
 _fmtplot = """\
 # This function was autogenerated by boilerplate.py.  Do not edit as
 # changes will be lost
+@autogen_docstring(Axes.%(func)s)
 def %(func)s(%(argspec)s):
     %(ax)s = gca()
     # allow callers to override the hold state by passing hold=True|False
@@ -34,19 +35,16 @@ def %(func)s(%(argspec)s):
         %(ax)s.hold(%(washold)s)
     %(mappable)s
     return %(ret)s
-if Axes.%(func)s.__doc__ is not None:
-    %(func)s.__doc__ = dedent(Axes.%(func)s.__doc__) + __docstring_addendum
 """
 
 _fmtmisc = """\
 # This function was autogenerated by boilerplate.py.  Do not edit as
 # changes will be lost
+@docstring.copy_dedent(Axes.%(func)s)
 def %(func)s(%(argspec)s):
     %(ret)s =  gca().%(func)s(%(call)s)
     draw_if_interactive()
     return %(ret)s
-if Axes.%(func)s.__doc__ is not None:
-    %(func)s.__doc__ = dedent(Axes.%(func)s.__doc__)
 """
 
 # these methods are all simple wrappers of Axes methods by the same

lib/matplotlib/artist.py

@@ -2,6 +2,7 @@
 import re, warnings
 import matplotlib
 import matplotlib.cbook as cbook
+from matplotlib import docstring
 from transforms import Bbox, IdentityTransform, TransformedBbox, TransformedPath
 from path import Path
 
@@ -1193,5 +1194,4 @@ def kwdoc(a):
     else:
         return '\n'.join(ArtistInspector(a).pprint_setters(leadingspace=2))
 
-kwdocd = dict()
-kwdocd['Artist'] = kwdoc(Artist)
+docstring.interpd.update(Artist=kwdoc(Artist))