working on the doc
small changes
docstrings now closer to numpydoc, but somehow an error occurs during
sphinx compilation, stating:
ValueError: `apply_along_axis`: is called by this method is not a item name
working on the doc, still 174 warnings !