Improve the wait.Poll GoDoc and api

Add more tests, and switch to timeouts instead of cycles.
Deflake TestPoller
Merge pull request #1002 from smarterclayton/improve_wait_api

Improve the wait.Poll GoDoc and api