- doxygen, code formatting

1 files changed, 14 insertions, 0 deletions

diff --git a/src/cadet/gnunet-service-cadet_peer.h b/src/cadet/gnunet-service-cadet_peer.h
index 240e70526..b7297d101 100644
--- a/src/cadet/gnunet-service-cadet_peer.h
+++ b/src/cadet/gnunet-service-cadet_peer.h
@@ -169,6 +169,10 @@ GCP_queue_cancel (struct CadetPeer *peer, struct CadetConnection *c);
 /**
  * Get the first message for a connection and unqueue it.
  *
+ * If the message was the last in the connection and the destruction flag
+ * was set, the connection will be freed by the continuation called by this
+ * function, and @c c will be INVALID after the call.
+ *
  * @param peer Neighboring peer.
  * @param c Connection.
  *
@@ -177,6 +181,16 @@ GCP_queue_cancel (struct CadetPeer *peer, struct CadetConnection *c);
 struct GNUNET_MessageHeader *
 GCP_connection_pop (struct CadetPeer *peer, struct CadetConnection *c);
 
+/**
+ * Unlock a possibly locked queue for a connection.
+ *
+ * If there is a message that can be sent on this connection, call core for it.
+ * Otherwise (if core transmit is already called or there is no sendable
+ * message) do nothing.
+ *
+ * @param peer Peer who keeps the queue.
+ * @param c Connection whose messages to unlock.
+ */
 void
 GCP_queue_unlock (struct CadetPeer *peer, struct CadetConnection *c);