[doc] resolve sphinx warnings concerning cython functions

o modify decorator "inherit_docstring" --> append doctring from base class
  instead of overwriting it
o this keeps the call signature cython writes into the docstring
o with the call signature in the docstring, sphinx can consistently build