From d7d1e8e10bbb7e2a564f1c1864065244afcae0d4 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Sun, 18 Oct 2015 12:27:54 +0000 Subject: [PATCH] -doxygen --- src/ats/ats_api_scheduling.c | 2 +- src/include/gnunet_ats_service.h | 11 +++++++---- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/src/ats/ats_api_scheduling.c b/src/ats/ats_api_scheduling.c index c37032f35..a5dd0827c 100644 --- 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 616b96327..6a2449a7a 100644 --- 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 -- 2.25.1