�
�)�Uc@smdd
lm
Z

def
d��YZdef
d��YZd�Zd�Ze�Zd�Zd	�Z	d
S(i����(
tcbooktSubstitutioncBs8eZ
dZd
�Zd�Zd�Zed��
ZRS(sO
    A decorator to take a function's docstring and perform string
    substitution on it.
    
    This decorator should be robust even if func.__doc__ is None
    (for example, if -OO was passed to the interpreter)
    
    Usage: construct a docstring.Substitution with a sequence or
    dictionary suitable for performing substitution; then
    decorate a suitable function with the constructed object. e.g.
    
    sub_author_name = Substitution(author='Jason')
    
    @sub_author_name
    def some_function(x):
        "%(author)s wrote this function"
    
    # note that some_function.__doc__ is now "Jason wrote this function"
    
    One can also use positional arguments.
    
    sub_first_last_names = Substitution('Edgar Allen', 'Poe')
    
    @sub_first_last_names
    def some_function(x):
        "%s %s wrote the Raven"
    c
Os|
p	||_dS(
N(
tparams(tselftargstkwargs((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt__init__scCs |
jo|
j|j
|
_|
S(
N(t__doc__R(Rtfunc((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt__call__#s

c
Os|jj
|
|�
d
S(s=Assume self.params is a dict and update it with supplied argsN(Rtupdate(RRR((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR
'scCs|�}|
|_|S(
s(

        In the case where the params is a mutable sequence (list or dictionary)
        and it may change before this class is called, one may explicitly use
        a reference to the params rather than using *args or **kwargs which will
        copy the values and not reference them.
        (
R(tclsRtresult((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytfrom_params+s	
	
(t__name__t
__module__RRR	R
tclassmethodR
(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR
s

			tAppendercBs#eZ
dZd
d�
Zd�ZRS(sv
    A function decorator that will append an addendum to the docstring
    of the target function.
    
    This decorator should be robust even if func.__doc__ is None
    (for example, if -OO was passed to the interpreter).
    
    Usage: construct a docstring.Appender with a string to be joined to
    the original docstring. An optional 'join' parameter may be supplied
    which will be used to join the docstring and addendum. e.g.
    
    add_copyright = Appender("Copyright (c) 2009", join='
')
    
    @add_copyright
    def my_dog(has='fleas'):
        "This docstring will have a copyright below"
        pass
    tcCs|
|_||_
dS(
N(taddendumtjoin(RRR((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyRJs
	
cCs1|
j|j
g}|
jo'd
j|�
|
_|
S(NR(RRR(RRtdocitems((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR	Ns


(RRRRR	(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyR7s
c

Cs"|jot
j|j�
|_|S(
sDedent a docstring (if present)(RRtdedent(
R((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyRSs
c
s�f
d
�}
|
S(s:Copy a docstring from another source function (if present)c

s�jr�j|_n|S(
N(
R(
ttarget(
tsource(sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytdo_copyZs
	

((RR((
RsG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytcopyXsc

Cstt
|�
�
S(
sXA special case of the interpd that first performs a dedent on
    the incoming docstring(tinterpdR(
R((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytdedent_interpddsc

s
�f
d
�S(sOA decorator that will copy the docstring from the source and
    then dedent itc

stt
��
|�
�
S(
N(RR(
R(
R(sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt<lambda>ps((
R((
RsG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pytcopy_dedentisN(
t
matplotlibRtobjectR
RRRRRR(((sG/opt/alt/python27/lib64/python2.7/site-packages/matplotlib/docstring.pyt<module>
s4