Document API changes. Implement the missing APIs.
enable USE_POLL on OSX (untested)