[docs] Document return value of epoll.poll (issue 29247)

[marco.buttu at gmail.com]

On 2017/01/30 13:13:36, berkerpeksag wrote:
> 
> I agree that the current wording is not ideal. What about
> 
>    If *timeout* is a float then the call waits for at most that many
seconds.
>    If *timeout* is -1 (the default) then it will wait for an unlimited
period.

The patch you attached is fine to me. I was just pointing out that there
is a missing dot after "(float)". If in addition you integrate with your
last sentence (If *timeout* is -1 (the default) then it will wait for an
unlimited period.), maybe it would also be better.

https://bugs.python.org/review/29247/