Improving docs

Undocumented option and discrepancies in documentation