doc: Update README.md to reflect current API#2

jcubic merged 2 commits intoisomorphic-git:mainisomorphic-git/path-browserify:mainfrom

eliot-akira:update-readmeeliot-akira/path-browserify:update-readmeCopy head branch name to clipboard