Clarified readme and examples

Just to make it a bit easier if other people are looking for this kind of functionality and stumbling upon this very useful package.