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

[gnunet]

Author: grothoff
Date: 2012-01-17 16:37:33 +0100 (Tue, 17 Jan 2012)
New Revision: 19198

Modified:
   gnunet/src/include/gnunet_mesh_service.h
Log:
-documentation related to #2069

Modified: gnunet/src/include/gnunet_mesh_service.h
===================================================================
--- gnunet/src/include/gnunet_mesh_service.h    2012-01-17 15:37:23 UTC (rev 
19197)
+++ gnunet/src/include/gnunet_mesh_service.h    2012-01-17 15:37:33 UTC (rev 
19198)
@@ -186,6 +186,10 @@
 
 /**
  * Method called whenever a peer has disconnected from the tunnel.
+ * Implementations of this callback must NOT call
+ * GNUNET_MESH_tunnel_destroy immediately, but instead schedule those
+ * to run in some other task later.  However, calling 
+ * "GNUNET_MESH_notify_transmit_ready_cancel" is allowed.
  *
  * @param cls closure
  * @param peer peer identity the tunnel stopped working with
@@ -197,11 +201,12 @@
 
 /**
  * Method called whenever a peer has connected to the tunnel.
- * TODO: change to typedef int? to let client allow the new peer or not
  *
  * @param cls closure
  * @param peer peer identity the tunnel was created to, NULL on timeout
  * @param atsi performance data for the connection
+ *
+ * TODO: change to return int to let client allow the new peer or not?
  */
 typedef void (*GNUNET_MESH_PeerConnectHandler) (void *cls,
                                                 const struct 
GNUNET_PeerIdentity