From 6a69a20d6847a6a359e3b8eb289bf351fed0651a Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Mon, 9 Mar 2015 08:24:58 +0000
Subject: -doxygen and stylistic fixes

---
 src/ats/gnunet-service-ats_addresses.c             |  1 +
 src/fragmentation/fragmentation.c                  |  4 ++--
 src/rps/gnunet-service-rps_sampler.c               | 28 ++++++++++++----------
 .../gnunet-service-transport_neighbours.c          |  2 +-
 4 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/src/ats/gnunet-service-ats_addresses.c b/src/ats/gnunet-service-ats_addresses.c
index 28c474e2c..6fd345af5 100644
--- a/src/ats/gnunet-service-ats_addresses.c
+++ b/src/ats/gnunet-service-ats_addresses.c
@@ -37,6 +37,7 @@
 struct GNUNET_CONTAINER_MultiPeerMap *GSA_addresses;
 
 
+
 /**
  * Update statistic on number of addresses.
  */
diff --git a/src/fragmentation/fragmentation.c b/src/fragmentation/fragmentation.c
index ca5ca2ac9..9f4a91447 100644
--- a/src/fragmentation/fragmentation.c
+++ b/src/fragmentation/fragmentation.c
@@ -90,7 +90,7 @@ struct GNUNET_FRAGMENT_Context
   uint64_t acks;
 
   /**
-   * Bitfield with all possible bits for 'acks' (used to mask the
+   * Bitfield with all possible bits for @e acks (used to mask the
    * ack we get back).
    */
   uint64_t acks_mask;
@@ -121,7 +121,7 @@ struct GNUNET_FRAGMENT_Context
   unsigned int num_transmissions;
 
   /**
-   * #GNUNET_YES if we called @e proc and are now waiting for #GNUNET_FRAGMENT_transmission_done()
+   * #GNUNET_YES if we called @e proc and are now waiting for #GNUNET_FRAGMENT_context_transmission_done()
    */
   int8_t proc_busy;
 
diff --git a/src/rps/gnunet-service-rps_sampler.c b/src/rps/gnunet-service-rps_sampler.c
index 0cbfc901b..ba6d6cbb1 100644
--- a/src/rps/gnunet-service-rps_sampler.c
+++ b/src/rps/gnunet-service-rps_sampler.c
@@ -171,12 +171,18 @@ typedef void
         const struct GNUNET_PeerIdentity *id);
 
 /**
- * Closure to #RPS_sampler_get_rand_peer()
+ * Closure for #sampler_get_rand_peer()
  */
 struct GetPeerCls
 {
-  /** DLL */
+  /**
+   * DLL
+   */
   struct GetPeerCls *next;
+
+  /**
+   * DLL
+   */
   struct GetPeerCls *prev;
 
   /**
@@ -195,7 +201,7 @@ struct GetPeerCls
   RPS_sampler_rand_peer_ready_cont cont;
 
   /**
-   * The closure to the callback
+   * The closure to the callback @e cont
    */
   void *cont_cls;
 
@@ -234,8 +240,8 @@ static uint32_t client_get_index;
 
 
 /** FIXME document */
-struct GetPeerCls *gpc_head;
-struct GetPeerCls *gpc_tail;
+static struct GetPeerCls *gpc_head;
+static struct GetPeerCls *gpc_tail;
 
 
 /**
@@ -244,13 +250,11 @@ struct GetPeerCls *gpc_tail;
  * Checks whether all n peers are available. If they are,
  * give those back.
  */
-  void
+static void
 check_n_peers_ready (void *cls,
     const struct GNUNET_PeerIdentity *id)
 {
-  struct NRandPeersReadyCls *n_peers_cls;
-
-  n_peers_cls = (struct NRandPeersReadyCls *) cls;
+  struct NRandPeersReadyCls *n_peers_cls = cls;
 
   n_peers_cls->cur_num_peers++;
   LOG (GNUNET_ERROR_TYPE_DEBUG,
@@ -320,7 +324,7 @@ RPS_sampler_elem_create (void)
  * Input an PeerID into the given sampler element.
  *
  * @param sampler the sampler the @a s_elem belongs to.
- *                Needed to know the 
+ *                Needed to know the
  */
 static void
 RPS_sampler_elem_next (struct RPS_SamplerElement *s_elem,
@@ -562,7 +566,7 @@ RPS_sampler_reinitialise_by_value (struct RPS_Sampler *sampler,
 static void
 sampler_get_rand_peer2 (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 {
-  struct GetPeerCls *gpc = (struct GetPeerCls *) cls;
+  struct GetPeerCls *gpc = cls;
   uint32_t r_index;
 
   gpc->get_peer_task = NULL;
@@ -603,7 +607,7 @@ sampler_get_rand_peer2 (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc
 static void
 sampler_get_rand_peer (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 {
-  struct GetPeerCls *gpc = (struct GetPeerCls *) cls;
+  struct GetPeerCls *gpc = cls;
   struct GNUNET_PeerIdentity tmp_id;
   unsigned int empty_flag;
   struct RPS_SamplerElement *s_elem;
diff --git a/src/transport/gnunet-service-transport_neighbours.c b/src/transport/gnunet-service-transport_neighbours.c
index 76f8a9984..d7ec1e195 100644
--- a/src/transport/gnunet-service-transport_neighbours.c
+++ b/src/transport/gnunet-service-transport_neighbours.c
@@ -391,7 +391,7 @@ struct NeighbourMapEntry
   /**
    * Time where we should cut the connection (timeout) if we don't
    * make progress in the state machine (or get a KEEPALIVE_RESPONSE
-   * if we are in #S_CONNECTED).
+   * if we are in #GNUNET_TRANSPORT_PS_CONNECTED).
    */
   struct GNUNET_TIME_Absolute timeout;
 
-- 
cgit v1.2.3