-improving docs

1 files changed, 26 insertions, 13 deletions

diff --git a/src/ats/ats.h b/src/ats/ats.h
index 7280891f4..b6750da10 100644
--- a/src/ats/ats.h
+++ b/src/ats/ats.h
@@ -267,6 +267,32 @@ struct AddressDestroyedMessage
 
 
 /**
+ * Message sent by ATS service to client to confirm that it is done
+ * using the given session ID.
+ */
+struct SessionReleaseMessage
+{
+  /**
+   * Type is #GNUNET_MESSAGE_TYPE_ATS_SESSION_RELEASE.
+   */
+  struct GNUNET_MessageHeader header;
+
+  /**
+   * Number the client used to identify the session.
+   */
+  uint32_t session_id GNUNET_PACKED;
+
+  /**
+   * Which peer is this about? (Technically redundant, as the
+   * @e session_id should be sufficient, but may enable client
+   * to find the session faster).
+   */
+  struct GNUNET_PeerIdentity peer;
+};
+
+
+
+/**
  * ATS Service suggests to the transport service to use the address
  * identified by the given @e session_id for the given @e peer with
  * the given @e bandwidth_in and @e bandwidth_out limits from now on.
@@ -374,19 +400,6 @@ struct ReservationRequestMessage
 };
 
 
-/**
- * Message sent by ATS service to client to confirm that it is done
- * using the given session ID.
- */
-struct SessionReleaseMessage
-{
-  struct GNUNET_MessageHeader header;
-
-  uint32_t session_id GNUNET_PACKED;
-
-  struct GNUNET_PeerIdentity peer;
-};
-
 
 struct ReservationResultMessage
 {