add README, repository URL mistake (thanks @kazuho), update API a little