-doxygen

diff --git a/src/ats/ats_api_scheduling.c b/src/ats/ats_api_scheduling.c
index c37032f35903e8cd17cc7b3befa6e3f1862aee7a..a5dd0827c1e62f69ad38378337b18b74ddcadd63 100644 (file)
--- a/src/ats/ats_api_scheduling.c
+++ b/src/ats/ats_api_scheduling.c
@@ -79,7 +79,7 @@ struct GNUNET_ATS_AddressRecord
 
   /**
    * Which slot (index) in the session array does
-   * this record correspond to?  FIXME:
+   * this record correspond to?
    * FIXME: a linear search on this is really crappy!
    * Maybe switch to a 64-bit global counter and be
    * done with it?  Or does that then cause too much

diff --git a/src/include/gnunet_ats_service.h b/src/include/gnunet_ats_service.h
index 616b963272aa82690f4163b718e450661d6fd26f..6a2449a7a2672d155836fc81ba2a340a541978f8 100644 (file)
--- a/src/include/gnunet_ats_service.h
+++ b/src/include/gnunet_ats_service.h
@@ -332,9 +332,12 @@ struct GNUNET_ATS_SchedulingHandle;
  */
 struct Session;
 
+
 /**
  * Signature of a function called by ATS with the current bandwidth
- * and address preferences as determined by ATS.
+ * and address preferences as determined by ATS.  If our connection
+ * to ATS dies and thus all suggestions become invalid, this function
+ * is called ONCE with all arguments (except @a cls) being NULL/0.
  *
  * @param cls closure
  * @param peer for which we suggest an address, NULL if ATS connection died
@@ -415,9 +418,9 @@ GNUNET_ATS_address_add_session (struct GNUNET_ATS_AddressRecord *ar,
 
 
 /**
- * A session was destroyed, disassociate it from the
- * given address record.  If this was an incoming
- * addess, destroy the address as well.
+ * A @a session was destroyed, disassociate it from the given address
+ * record.  If this was an incoming addess, destroys the address as
+ * well.
  *
  * @param ar address record to update information for
  * @param session session handle