fine tune some doc comments
adjust API call structure
catch KeyboardInterrupt
add README