Documentation cleanup

- Arguments cleanup
- README improved

DEAR MISTER @d22, PLEASE REVIEW ASAP!!! THANKS VERY MANY.