Document how poll_list handles errors

[sunfishcode]

The poll_list function itself doesn't have a return value so it's infallible. We should document how it behaves when passed invalid file descriptors.

[pchickey]

File descriptors being passed to poll_list are a thing of the past. It should be impossible to create an error because all Pollable resources are always valid to poll on, right?

[sunfishcode]

Yes, that's right. So we should document what happens if you're using bindings like C and you're using a handle after it's been dropped.

[pchickey]

Easy enough - it will trap, just like every other case of passing an invalid resource. Agreed we can put it in the docs.