Improve the wait.Poll GoDoc and api

Add more tests, and allow maxAttempts to be zero to wait forever

@brendandburns addressing your comments from yesterday
Was a bug in the test case, fixed.