Better documentation.

svn path=/trunk/; revision=438

2 files changed, 10 insertions, 2 deletions

diff --git a/fetchmail.man b/fetchmail.man
index 56f75f9c..cc15fbbf 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -697,8 +697,10 @@ catch equivalences created by MX records).  If it is an alias of the
 server, but the lookup fails due to network congestion or a crashed
 server, forwarding will not get done correctly.
 .PP
-The multi-drop mailbox code was hard to test thoroughly and may have obscure
-failure modes, especially in the presence of DNS flakiness.
+Presently, 
+.I fetchmail
+cannot handle a response longer than your machine's atomic read size
+for sockets.
 .PP
 Under Linux, if fetchmail is run in daemon mode with the network
 inaccessible, each poll leaves a socket allocated but in CLOSE state
diff --git a/socket.c b/socket.c
index 52f88e95..5033ed45 100644
--- a/socket.c
+++ b/socket.c
@@ -4,6 +4,12 @@
  * These were designed and coded by Carl Harris <ceharris@mal.com>
  * and are essentially unchanged from the ancestral popclient.
  *
+ * Actually, this library shouldn't exist.  We ought to be using
+ * stdio to buffer the socket descriptors.  If that worked, we
+ * could have separate buffers for the mailserver and SMTP sockets,
+ * and we'd be able to handle responses longer than the socket
+ * atomic read size.
+ *
  * For license terms, see the file COPYING in this directory.
  */