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

so they render nice with sphinx without warnings
Merge pull request #7236 from jorisvandenbossche/doc-fixes2

DOC: clean-up docstrings of option functions