[GNUnet-SVN] r14059 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2010-12-23 16:52:14 +0100 (Thu, 23 Dec 2010)
New Revision: 14059

Modified:
   gnunet/src/include/gnunet_transport_plugin.h
Log:
docu

Modified: gnunet/src/include/gnunet_transport_plugin.h
===================================================================
--- gnunet/src/include/gnunet_transport_plugin.h        2010-12-23 15:36:35 UTC 
(rev 14058)
+++ gnunet/src/include/gnunet_transport_plugin.h        2010-12-23 15:52:14 UTC 
(rev 14059)
@@ -251,7 +251,12 @@
 
 /**
  * Function called by the GNUNET_TRANSPORT_TransmitFunction
- * upon "completion".
+ * upon "completion".  In the case that a peer disconnects,
+ * this function must be called for each pending request
+ * (with a 'failure' indication) AFTER notifying the service
+ * about the disconnect event (so that the service won't try
+ * to transmit more messages, believing the connection still
+ * exists...).
  *
  * @param cls closure
  * @param target who was the recipient of the message?