Adapt README to new API

Parts of the README were still based on the API of version 1.  This
updates the README to reflect the API of the current version 3.
Merge pull request #36 from KlausTrainer/master

Adapt README to new API