docs: select: Describe poll.poll() return value in detail.

pfalcon · pfalcon · commit 98b6d35c4ffa · 2015-10-29T22:08:10.000+03:00
diff --git a/docs/library/select.rst b/docs/library/select.rst
@@ -52,6 +52,10 @@ Methods
 .. method:: poll.poll([timeout])
 
    Wait for at least one of the registered objects to become ready. Returns
-   list of ready objects, or empty list on timeout.
+   list of (``obj``, ``event``, ...) tuples, ``event`` element specifying
+   whether ``obj`` is ready for reading, writing, or both (see ``register``
+   method above). There may be other elements in tuple, depending on platform
+   and version, so don't assume that its size is 2. In case of timeout, an
+   empty list is returned.
 
    Timeout is in milliseconds.
