DOC: enhance docstring
DOC: fix mistake optional flag