Improve documentation of parameters

Clarify the description and add a more comprehensive example.
Merge pull request #11 from brycied00d/clarify-options

Improve documentation of parameters