doxygen fixes

6 files changed, 19 insertions, 8 deletions

diff --git a/src/ats/gnunet-service-ats-solver_mlp.c b/src/ats/gnunet-service-ats-solver_mlp.c
index d7762d430..43c62df0a 100644
--- a/src/ats/gnunet-service-ats-solver_mlp.c
+++ b/src/ats/gnunet-service-ats-solver_mlp.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file ats/gnunet-service-ats_addresses_mlp.c
+ * @file ats/gnunet-service-ats-solver_mlp.c
  * @brief ats mlp problem solver
  * @author Matthias Wachs
  * @author Christian Grothoff
@@ -1630,6 +1630,8 @@ GAS_mlp_done (void *solver)
  * @param dest_length array length for quota arrays
  * @param bw_changed_cb callback for changed bandwidth amounts
  * @param bw_changed_cb_cls cls for callback
+ * @param get_preference callback to get relative preferences for a peer
+ * @param get_preference_cls cls for callback to get relative preferences
  * @return struct GAS_MLP_Handle on success, NULL on fail
  */
 void *
diff --git a/src/ats/gnunet-service-ats-solver_mlp.h b/src/ats/gnunet-service-ats-solver_mlp.h
index e7464ca96..ab9c59257 100644
--- a/src/ats/gnunet-service-ats-solver_mlp.h
+++ b/src/ats/gnunet-service-ats-solver_mlp.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file ats/gnunet-service-ats_addresses_mlp.h
+ * @file ats/gnunet-service-ats-solver_mlp.h
  * @brief ats MLP problem solver
  * @author Matthias Wachs
  * @author Christian Grothoff
@@ -345,7 +345,7 @@ GAS_mlp_solve_problem (void *solver, struct GNUNET_CONTAINER_MultiHashMap * addr
 /**
  * Init the MLP problem solving component
  *
- * @param cfg configuration handle
+ * @param cfg the GNUNET_CONFIGURATION_Handle handle
  * @param stats the GNUNET_STATISTICS handle
  * @param network array of GNUNET_ATS_NetworkType with length dest_length
  * @param out_dest array of outbound quotas
@@ -353,6 +353,8 @@ GAS_mlp_solve_problem (void *solver, struct GNUNET_CONTAINER_MultiHashMap * addr
  * @param dest_length array length for quota arrays
  * @param bw_changed_cb callback for changed bandwidth amounts
  * @param bw_changed_cb_cls cls for callback
+ * @param get_preference callback to get relative preferences for a peer
+ * @param get_preference_cls cls for callback to get relative preferences
  * @return struct GAS_MLP_Handle on success, NULL on fail
  */
 void *
diff --git a/src/ats/gnunet-service-ats-solver_proportional.c b/src/ats/gnunet-service-ats-solver_proportional.c
index 30a3b060d..51246f152 100644
--- a/src/ats/gnunet-service-ats-solver_proportional.c
+++ b/src/ats/gnunet-service-ats-solver_proportional.c
@@ -1225,6 +1225,8 @@ GAS_proportional_address_add (void *solver,
  * @param dest_length array length for quota arrays
  * @param bw_changed_cb callback for changed bandwidth amounts
  * @param bw_changed_cb_cls cls for callback
+ * @param get_preference callback to get relative preferences for a peer
+ * @param get_preference_cls cls for callback to get relative preferences
  * @return handle for the solver on success, NULL on fail
  */
 void *
diff --git a/src/ats/gnunet-service-ats-solver_proportional.h b/src/ats/gnunet-service-ats-solver_proportional.h
index 960580b3d..fda47cc93 100644
--- a/src/ats/gnunet-service-ats-solver_proportional.h
+++ b/src/ats/gnunet-service-ats-solver_proportional.h
@@ -73,6 +73,8 @@ GAS_proportional_address_change_preference (void *solver,
  * @param dest_length array length for quota arrays
  * @param bw_changed_cb callback for changed bandwidth amounts
  * @param bw_changed_cb_cls cls for callback
+ * @param get_preference callback to get relative preferences for a peer
+ * @param get_preference_cls cls for callback to get relative preferences
  * @return handle for the solver on success, NULL on fail
  */
 void *
diff --git a/src/ats/gnunet-service-ats_normalization.c b/src/ats/gnunet-service-ats_normalization.c
index f5dd6f1db..129aa1dd5 100644
--- a/src/ats/gnunet-service-ats_normalization.c
+++ b/src/ats/gnunet-service-ats_normalization.c
@@ -169,7 +169,8 @@ static struct PeerRelative defvalues;
 /**
  * Update a peer
  * @param id peer id
- * @pram kind the kind
+ * @param kind the kind
+ * @return the new relative preference
  */
 static double
 update_peers (struct GNUNET_PeerIdentity *id,
@@ -307,8 +308,10 @@ recalculate_rel_preferences (struct PreferenceClient *c,
 
 /**
  * Update the absolute preference value for a peer
- * @param id peer id
- * @param kind the kind
+ * @param c the client
+ * @param p the peer
+ * @param kind the preference kind
+ * @param score_abs the absolute value
  * @return the new relative preference value
  */
 static double
@@ -489,7 +492,7 @@ GAS_normalization_get_preferences (const struct GNUNET_PeerIdentity *id)
  * Start the normalization component
  *
  * @param pref_ch_cb callback to call on relative preference changing
- * @param ref_ch_cb_cls cls for the callback
+ * @param pref_ch_cb_cls cls for the 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 dbd68ee95..37e694dd7 100644
--- a/src/ats/gnunet-service-ats_normalization.h
+++ b/src/ats/gnunet-service-ats_normalization.h
@@ -68,7 +68,7 @@ GAS_normalization_change_preference (void *src,
  * Start the normalization component
  *
  * @param pref_ch_cb callback to call on relative preference changing
- * @param ref_ch_cb_cls cls for the callback
+ * @param pref_ch_cb_cls cls for the callback
  */
 void
 GAS_normalization_start (GAS_Normalization_preference_changed_cb pref_ch_cb, void *pref_ch_cb_cls);