doxygen fixes

3 files changed, 22 insertions, 11 deletions

diff --git a/src/ats/gnunet-service-ats_addresses.c b/src/ats/gnunet-service-ats_addresses.c
index f32c6a7c9..245cfeff7 100644
--- a/src/ats/gnunet-service-ats_addresses.c
+++ b/src/ats/gnunet-service-ats_addresses.c
@@ -909,6 +909,13 @@ GAS_addresses_update (struct GAS_Addresses_Handle *handle,
     return;
   }
 
+  if (NULL == aa->solver_information)
+  {
+    GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Tried to update unknown address for peer `%s' `%s' session id %u\n",
+                 GNUNET_i2s (peer), plugin_name, session_id);
+    return;
+  }
+
   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                 "Received `%s' for peer `%s' address \n",
                 "ADDRESS UPDATE",
@@ -1317,7 +1324,7 @@ GAS_addresses_handle_backoff_reset (struct GAS_Addresses_Handle *handle,
  * @param cls the address handle
  * @param peer the peer
  * @param kind the ATS kind
- * @param double the new relative preference value
+ * @param pref_rel the new relative preference value
  */
 static void
 normalized_preference_changed_cb (void *cls,
@@ -1337,8 +1344,8 @@ normalized_preference_changed_cb (void *cls,
  *
  * @param cls the address handle
  * @param peer the peer
- * @param kind the ATS kind
- * @param double the new relative preference value
+ * @param type the ATS type
+ * @param prop_rel the new relative preference value
  */
 static void
 normalized_property_changed_cb (void *cls,
diff --git a/src/ats/gnunet-service-ats_normalization.c b/src/ats/gnunet-service-ats_normalization.c
index 8c0514373..86e6f1700 100644
--- a/src/ats/gnunet-service-ats_normalization.c
+++ b/src/ats/gnunet-service-ats_normalization.c
@@ -648,7 +648,8 @@ normalize_address (void *cls, const struct GNUNET_HashCode *h, void *k)
  * Normalize avg_value to a range of values between [1.0, 2.0]
  * based on min max values currently known.
  *
- * @param property p the property
+ * @param addresses the address hashmap
+ * @param p the property
  * @param address the address
  * @param avg_value the value to normalize
  */
@@ -772,13 +773,13 @@ GAS_normalization_normalize_property (struct GNUNET_CONTAINER_MultiHashMap *addr
 }
 
 
-
-
 /**
  * Start the normalization component
  *
  * @param pref_ch_cb callback to call on relative preference changing
- * @param pref_ch_cb_cls cls for the callback
+ * @param pref_ch_cb_cls cls for the preference callback
+ * @param property_ch_cb callback to call on relative property changing
+ * @param property_ch_cb_cls cls for the property callback
  */
 void
 GAS_normalization_start (GAS_Normalization_preference_changed_cb pref_ch_cb,
diff --git a/src/ats/gnunet-service-ats_normalization.h b/src/ats/gnunet-service-ats_normalization.h
index 35906be7d..3637766f5 100644
--- a/src/ats/gnunet-service-ats_normalization.h
+++ b/src/ats/gnunet-service-ats_normalization.h
@@ -85,17 +85,20 @@ GAS_normalization_normalize_property (struct GNUNET_CONTAINER_MultiHashMap *addr
                                                                                                                                                         const struct GNUNET_ATS_Information *atsi,
                                                                                                                                                         uint32_t atsi_count);
 
+
 /**
  * Start the normalization component
  *
  * @param pref_ch_cb callback to call on relative preference changing
- * @param pref_ch_cb_cls cls for the callback
+ * @param pref_ch_cb_cls cls for the preference callback
+ * @param property_ch_cb callback to call on relative property changing
+ * @param property_ch_cb_cls cls for the property callback
  */
 void
 GAS_normalization_start (GAS_Normalization_preference_changed_cb pref_ch_cb,
-                                                                                                 void *pref_ch_cb_cls,
-                                                                                                 GAS_Normalization_property_changed_cb property_ch_ch_cls,
-                                                                                                 void *property_ch_cb_cls);
+                void *pref_ch_cb_cls,
+                GAS_Normalization_property_changed_cb property_ch_cb,
+                void *property_ch_cb_cls);
 
 
 /**