i've managed to forget to check in these changes...awesome.
 - added vim *.swp to .gitignore
 - added usage and examples to README.md