Extend the README with many more details

Also removes some copy/paste errors.
Since the `options` are optional, the parameter should colloquially be surrounded by square brackets: `[options]`.