- doxygen

2 files changed, 8 insertions, 2 deletions

diff --git a/src/mesh/gnunet-service-mesh_connection.c b/src/mesh/gnunet-service-mesh_connection.c
index 3f6ebc7e4..2c07baa50 100644
--- a/src/mesh/gnunet-service-mesh_connection.c
+++ b/src/mesh/gnunet-service-mesh_connection.c
@@ -787,8 +787,11 @@ connection_unlock_queue (struct MeshConnection *c, int fwd)
 
 /**
  * Cancel all transmissions that belong to a certain connection.
+ * 
+ * If the connection is scheduled for destruction and no more messages are left,
+ * the connection will be destroyed by the continuation call.
  *
- * @param c Connection which to cancel.
+ * @param c Connection which to cancel. Might be destroyed during this call.
  * @param fwd Cancel fwd traffic?
  */
 static void
diff --git a/src/mesh/gnunet-service-mesh_connection.h b/src/mesh/gnunet-service-mesh_connection.h
index d6b261002..3f75bcdab 100644
--- a/src/mesh/gnunet-service-mesh_connection.h
+++ b/src/mesh/gnunet-service-mesh_connection.h
@@ -231,7 +231,10 @@ GMC_new (const struct GNUNET_HashCode *cid,
          unsigned int own_pos);
 
 /**
- * Connection is no longer needed: destroy it and remove from tunnel.
+ * Connection is no longer needed: destroy it.
+ *
+ * Cancels all pending traffic (including possible DESTROY messages), all
+ * maintenance tasks and removes the connection from neighbor peers and tunnel.
  *
  * @param c Connection to destroy.
  */