Document fileno method

Also add comment about probable useless ConnectionError raised

diff --git a/musicpd.py b/musicpd.py
index 9b1d51b7477b565a0d72a0aa84199e31f741f063..eeb4b9a81c4a04d7b856fa5e679356ddfee78af6 100644 (file)
--- a/musicpd.py
+++ b/musicpd.py
@@ -569,7 +569,7 @@ class MPDClient:
             obj['data'] = self._read_binary(amount)
         except IOError as err:
             raise ConnectionError('Error reading binary content: %s' % err)
-        if len(obj['data']) != amount:
+        if len(obj['data']) != amount:  # can we ever get there?
             raise ConnectionError('Error reading binary content: '
                       'Expects %sB, got %s' % (amount, len(obj['data'])))
         # Fetches trailing new line
@@ -709,6 +709,9 @@ class MPDClient:
         self._reset()
 
     def fileno(self):
+        """Return the socket’s file descriptor (a small integer).
+        This is useful with :py:obj:`select.select`.
+        """
         if self._sock is None:
             raise ConnectionError("Not connected")
         return self._sock.fileno()