Update README.

Trying to improve the documentation for the options a bit as I tripped over them, reading them to quickly. 
* Uses defaults in code rather than mentioning defaults in comment as this seems to be the convention.
* Indicate placeholders for directories through UPPERCASE.