Add sanity note to changelog re #869

1 files changed, 7 insertions, 0 deletions

diff --git a/sites/www/changelog.rst b/sites/www/changelog.rst
index 3d14989a..2c37fb0b 100644
--- a/sites/www/changelog.rst
+++ b/sites/www/changelog.rst
@@ -14,6 +14,13 @@ Changelog
   <paramiko.client.SSHClient.connect>` (default: 30s) to avoid hangs when the
   remote end becomes unresponsive during the authentication step. Credit to
   ``@timsavage``.
+
+  .. note::
+    This technically changes behavior, insofar as very slow auth steps >30s
+    will now cause timeout exceptions instead of completing. We doubt most
+    users will notice; those affected can simply give a higher value to
+    ``auth_timeout``.
+
 * :support:`921` Tighten up the ``__hash__`` implementation for various key
   classes; less code is good code. Thanks to Francisco Couzo for the patch.
 * :bug:`983` Move ``sha1`` above the now-arguably-broken ``md5`` in the list of