add more usage info to readme
add installation instructions to readme
make all options optional
fix some errors in the documentation