Add usage examples

I had to look far and wide for this information. Might as well put it in context.
Removing unneccessary newlines and cleaning up doc
Merge pull request #789 from gcko/patch-1

[Fogbugz] Add usage examples