fixing doxygen

5 files changed, 14 insertions, 11 deletions

diff --git a/src/ats/gnunet-ats-solver-eval.c b/src/ats/gnunet-ats-solver-eval.c
index d21529f22..fbcd14a9c 100644
--- a/src/ats/gnunet-ats-solver-eval.c
+++ b/src/ats/gnunet-ats-solver-eval.c
@@ -1062,6 +1062,7 @@ find_active_address (struct TestPeer *p)
  * @param period duration of a period of generation (~ 1/frequency)
  * @param frequency how long to generate property
  * @param kind ATS preference to generate
+ * @param feedback_frequency how often to give feedback
  * @return the preference generator
  */
 struct PreferenceGenerator *
diff --git a/src/ats/gnunet-service-ats_normalization.c b/src/ats/gnunet-service-ats_normalization.c
index 0423db673..17edf282d 100644
--- a/src/ats/gnunet-service-ats_normalization.c
+++ b/src/ats/gnunet-service-ats_normalization.c
@@ -202,8 +202,10 @@ static GNUNET_SCHEDULER_TaskIdentifier aging_task;
 
 /**
  * Update a peer
+ *
  * @param id peer id
  * @param kind the kind
+ * @param rp the relative peer struct
  * @return the new relative preference
  */
 static void
@@ -448,7 +450,8 @@ preference_aging (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
  */
 void
 GAS_normalization_normalize_preference (void *client,
-    const struct GNUNET_PeerIdentity *peer, enum GNUNET_ATS_PreferenceKind kind,
+    const struct GNUNET_PeerIdentity *peer,
+    enum GNUNET_ATS_PreferenceKind kind,
     float score_abs)
 {
   struct PreferenceClient *c_cur;
diff --git a/src/ats/gnunet-service-ats_normalization.h b/src/ats/gnunet-service-ats_normalization.h
index a82d66f46..bba0ab304 100644
--- a/src/ats/gnunet-service-ats_normalization.h
+++ b/src/ats/gnunet-service-ats_normalization.h
@@ -87,16 +87,16 @@ GAS_normalization_get_preferences_by_client (const void *client,
 /**
  * Normalize an updated preference value
  *
- * @param src the client with this preference
+ * @param client the client with this preference
  * @param peer the peer to change the preference for
  * @param kind the kind to change the preference
  * @param score_abs the normalized score
  */
 void
-GAS_normalization_normalize_preference (void *src,
-                                        const struct GNUNET_PeerIdentity *peer,
-                                        enum GNUNET_ATS_PreferenceKind kind,
-                                        float score_abs);
+GAS_normalization_normalize_preference (void *client,
+                                        const struct GNUNET_PeerIdentity *peer,
+                                        enum GNUNET_ATS_PreferenceKind kind,
+                                        float score_abs);
 
 /**
  * Update and normalize a atsi performance information
diff --git a/src/ats/gnunet-service-ats_performance.c b/src/ats/gnunet-service-ats_performance.c
index 16b6404d6..ac2509455 100644
--- a/src/ats/gnunet-service-ats_performance.c
+++ b/src/ats/gnunet-service-ats_performance.c
@@ -260,7 +260,7 @@ GAS_performance_notify_all_clients (const struct GNUNET_PeerIdentity *peer,
 /**
  * Iterator for called from #GAS_addresses_get_peer_info()
  *
- * @param p_it_cls closure with the `struct PerformanceClient *`
+ * @param cls closure with the `struct PerformanceClient *`
  * @param id the peer id
  * @param plugin_name plugin name
  * @param plugin_addr address
@@ -422,12 +422,12 @@ transmit_req_addr (struct AddressIteration *ai,
 /**
  * Iterator for #GAS_addresses_get_peer_info()
  *
- * @param p_it_cls closure with our `struct AddressIteration *`
+ * @param cls closure with our `struct AddressIteration *`
  * @param id the peer id
  * @param plugin_name plugin name
  * @param plugin_addr address
  * @param plugin_addr_len length of @a plugin_addr
- * @param address_active is address actively used
+ * @param active is address actively used
  * @param atsi ats performance information
  * @param atsi_count number of ats performance elements in @a atsi
  * @param bandwidth_out current outbound bandwidth assigned to address
diff --git a/src/ats/plugin_ats_proportional.c b/src/ats/plugin_ats_proportional.c
index 5fc065cba..744602eb8 100644
--- a/src/ats/plugin_ats_proportional.c
+++ b/src/ats/plugin_ats_proportional.c
@@ -1122,7 +1122,6 @@ propagate_bandwidth (struct GAS_PROPORTIONAL_Handle *s,
  *
  * @param s the solver handle
  * @param n the network, can be NULL for all network
- * @param address_except do not notify for this address
  */
 static void
 distribute_bandwidth_in_network (struct GAS_PROPORTIONAL_Handle *s,
@@ -1927,7 +1926,7 @@ GAS_proportional_address_add (void *solver,
 /**
  * Function invoked when the plugin is loaded.
  *
- * @param cls[in,out] the `struct GNUNET_ATS_PluginEnvironment *` to use;
+ * @param[in,out] cls the `struct GNUNET_ATS_PluginEnvironment *` to use;
  *            modified to return the API functions (ugh).
  * @return the `struct GAS_PROPORTIONAL_Handle` to pass as a closure
  */