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.