Docstring inheritance

[chkoar]

I think that we can eliminate many lines of docstrings by inherit the docstring from a parent class.
A possible way is to use a decorator like in https://groups.google.com/forum/#!msg/comp.lang.python/HkB1uhDcvdk/lWzWtPy09yYJ

[glemaitre]

There is something to do but we have to be careful to let the docstring such that this is easy to change.

[glemaitre]

Thinking about it, I really think that this is easy to code or
contribute when the docstring is present at the lowest level. If you
need to check the doc or to go and find the base class, it starts to be
complicated even if it removes a lot of lines.

[glemaitre]

I think that we should still have the docstring on the lower level whenever possible since it helps when reading the code itself.

[chkoar]

Ok.