improved documentation

- added usage example
- added missing options to comments
- removed spaces at end of lines