Class and example revamp

Made vast improvements to this class and also added example and better
.md file.
Merge pull request #1 from lcherone/master

merged !