updated README API descriptions