From bbb80ee761838dce989b3584a75fd26b53dcd9ce Mon Sep 17 00:00:00 2001
From: Kaliko Jack <kaliko@azylum.org>
Date: Fri, 19 Feb 2021 15:50:44 +0100
Subject: [PATCH] Document fileno method

Also add comment about probable useless ConnectionError raised
---
 musicpd.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/musicpd.py b/musicpd.py
index 9b1d51b..eeb4b9a 100644
--- 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()
-- 
2.39.2