read me and minor api change