Improve documentation

I want this to be as easy to understand as possible without having to
read the source code. To that end, I am improving the documentation in
the readme.

Main improvements include:

  - syntax section with table of arguments
  - additional example with some options
  - table for all possible options and their default values