DOC: lists of valid options added to docstring