minor fixes to API, readme