Add PollEvents type alias
Add PollEvents type alias

This way we have at least a speaking name here, even if it does not
improve type safety.

In addition, this commit adds some documentation for functionality
related to `PollEvents` and corresponding rough edges of the API.

erickt/rust-zmq