doxygen, new define

2 files changed, 11 insertions, 3 deletions

diff --git a/src/include/gnunet_ats_service.h b/src/include/gnunet_ats_service.h
index 88d08fb72..88df7d0da 100644
--- a/src/include/gnunet_ats_service.h
+++ b/src/include/gnunet_ats_service.h
@@ -439,12 +439,14 @@ struct Session;
  * and address preferences as determined by ATS.
  *
  * @param cls closure
- * @param address suggested address (including peer identity of the peer)
+ * @param peer for which we suggest an address, NULL if ATS connection died
+ * @param address suggested address (including peer identity of the peer),
+ *             may be NULL to signal disconnect from peer
  * @param session session to use, NULL to establish a new outgoing session
  * @param bandwidth_out assigned outbound bandwidth for the connection,
- *        0 to disconnect
+ *        0 to signal disconnect
  * @param bandwidth_in assigned inbound bandwidth for the connection,
- *        0 to disconnect
+ *        0 to signal disconnect
  */
 typedef void
 (*GNUNET_ATS_AddressSuggestionCallback) (void *cls,
diff --git a/src/include/gnunet_bandwidth_lib.h b/src/include/gnunet_bandwidth_lib.h
index ad8f3a2b9..bbad562dc 100644
--- a/src/include/gnunet_bandwidth_lib.h
+++ b/src/include/gnunet_bandwidth_lib.h
@@ -135,6 +135,12 @@ struct GNUNET_BANDWIDTH_Tracker
 
 
 /**
+ * Convenience definition to use for 0-bandwidth.
+ */
+#define GNUNET_BANDWIDTH_ZERO GNUNET_BANDWIDTH_value_init (0)
+
+
+/**
  * Create a new bandwidth value.
  *
  * @param bytes_per_second value to create