doc, cosmetics, match README example with actual api

Signed-off-by: Sebastian Freundt <hroptatyr@fresse.org>
Merge branch 'doc/README'

* doc/README:
  doc, cosmetics, match README example with actual api