To provide the most recent news and documentation www.pymvpa.org reflects the development 2.0 series (renamed 0.6 series) of PyMVPA. If you are interested in the documentation of the previous stable 0.4 series of PyMVPA, please visit v04.pymvpa.org.

mvpa2.misc.neighborhood.borrowdoc

mvpa2.misc.neighborhood.borrowdoc(cls, methodname=None)

Return a decorator to borrow docstring from another cls.`methodname`

It should not be used for __init__ methods of classes derived from ClassWithCollections since __doc__’s of those are handled by the AttributeCollector anyways.

Common use is to borrow a docstring from the class’s method for an adapter function (e.g. sphere_searchlight borrows from Searchlight)

Parameters :

cls :

Usually a parent class

methodname : None or str

Name of the method from which to borrow. If None, would use the same name as of the decorated method

Examples

To borrow __repr__ docstring from parent class Mapper, do:

@borrowdoc(Mapper)
def __repr__(self):
    ...