DOC: clean-up docstrings of option functions

so they render nice with sphinx without warnings