Small fix of readme
General revision of the library, the examples, and the readme.
Merge pull request #2 from lmari/master

Mauro: second trial...