[GNUnet-SVN] r36527 - in gnunet/src: ats include

[gnunet]

Author: grothoff
Date: 2015-10-18 14:27:54 +0200 (Sun, 18 Oct 2015)
New Revision: 36527

Modified:
   gnunet/src/ats/ats_api_scheduling.c
   gnunet/src/include/gnunet_ats_service.h
Log:
-doxygen

Modified: gnunet/src/ats/ats_api_scheduling.c
===================================================================
--- gnunet/src/ats/ats_api_scheduling.c 2015-10-18 12:27:38 UTC (rev 36526)
+++ gnunet/src/ats/ats_api_scheduling.c 2015-10-18 12:27:54 UTC (rev 36527)
@@ -79,7 +79,7 @@
 
   /**
    * 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

Modified: gnunet/src/include/gnunet_ats_service.h
===================================================================
--- gnunet/src/include/gnunet_ats_service.h     2015-10-18 12:27:38 UTC (rev 
36526)
+++ gnunet/src/include/gnunet_ats_service.h     2015-10-18 12:27:54 UTC (rev 
36527)
@@ -332,9 +332,12 @@
  */
 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 @@
 
 
 /**
- * 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