README: updated docs to final interface