Fix readme example and remove documentation of deprecated APIs

Closes #196
Merge pull request #199 from marmelab/correct_readme

[RFR] Fix readme example and remove documentation of deprecated APIs