DOC: fix api docs
DOC: clean-up docstrings of option functions

so they render nice with sphinx without warnings