introducing GNUNET_UNUSED macro instead of hard-coding gcc attribute all over the place; also some further documentation fixes

5 files changed, 21 insertions, 7 deletions

diff --git a/src/transport/gnunet-service-transport_neighbours.c b/src/transport/gnunet-service-transport_neighbours.c
index 95efe44a1..6f1aa7431 100644
--- a/src/transport/gnunet-service-transport_neighbours.c
+++ b/src/transport/gnunet-service-transport_neighbours.c
@@ -1136,6 +1136,7 @@ static void send_outbound_quota (const struct GNUNET_PeerIdentity *target, struc
  * ATS to not use this address anymore (until it is re-validated).
  *
  * @param cls the 'struct GNUNET_HELLO_Address' of the address that was tried
+ * @param target peer to send the message to
  * @param success GNUNET_OK on success
  */
 static void
@@ -1190,11 +1191,13 @@ send_connect_continuation (void *cls, const struct GNUNET_PeerIdentity *target,
   GNUNET_free (cc);
 }
 
+
 /**
  * We tried to switch addresses with an peer already connected. If it failed,
  * we should tell ATS to not use this address anymore (until it is re-validated).
  *
  * @param cls the 'struct NeighbourMapEntry'
+ * @param target peer to send the message to
  * @param success GNUNET_OK on success
  */
 static void
@@ -1291,12 +1294,14 @@ send_switch_address_continuation (void *cls,
   GNUNET_free (cc);
 }
 
+
 /**
  * We tried to send a SESSION_CONNECT message to another peer.  If this
  * succeeded, we change the state.  If it failed, we should tell
  * ATS to not use this address anymore (until it is re-validated).
  *
  * @param cls the 'struct NeighbourMapEntry'
+ * @param target peer to send the message to
  * @param success GNUNET_OK on success
  */
 static void
@@ -1351,6 +1356,7 @@ send_connect_ack_continuation (void *cls,
   GNUNET_free (cc);
 }
 
+
 /**
  * For an existing neighbour record, set the active connection to
  * the given address.
@@ -1971,6 +1977,8 @@ GST_neighbours_keepalive (const struct GNUNET_PeerIdentity *neighbour)
  * to this peer
  *
  * @param neighbour neighbour to keep alive
+ * @param ats performance data
+ * @param ats_count number of entries in ats
  */
 void
 GST_neighbours_keepalive_response (const struct GNUNET_PeerIdentity *neighbour,
diff --git a/src/transport/gnunet-service-transport_neighbours.h b/src/transport/gnunet-service-transport_neighbours.h
index 7a79d5113..31777343d 100644
--- a/src/transport/gnunet-service-transport_neighbours.h
+++ b/src/transport/gnunet-service-transport_neighbours.h
@@ -129,6 +129,8 @@ GST_neighbours_keepalive (const struct GNUNET_PeerIdentity *neighbour);
  * to this peer
  *
  * @param neighbour neighbour to keep alive
+ * @param ats performance data
+ * @param ats_count number of entries in ats
  */
 void
 GST_neighbours_keepalive_response (const struct GNUNET_PeerIdentity *neighbour,
diff --git a/src/transport/gnunet-transport-wlan-helper.c b/src/transport/gnunet-transport-wlan-helper.c
index 7be72482b..53e0efedd 100644
--- a/src/transport/gnunet-transport-wlan-helper.c
+++ b/src/transport/gnunet-transport-wlan-helper.c
@@ -543,16 +543,17 @@ ieee80211_radiotap_iterator_init (struct ieee80211_radiotap_iterator
 
 
 /**
- * ieee80211_radiotap_iterator_next - return next radiotap parser iterator arg
- * @iterator: radiotap_iterator to move to next arg (if any)
- *
- * Returns: next present arg index on success or negative if no more or error
+ * @brief ieee80211_radiotap_iterator_next - return next radiotap parser iterator arg 
  *
  * This function returns the next radiotap arg index (IEEE80211_RADIOTAP_...)
  * and sets iterator->this_arg to point to the payload for the arg.  It takes
  * care of alignment handling and extended present fields.  interator->this_arg
  * can be changed by the caller.  The args pointed to are in little-endian
  * format.
+ *
+ * @param iterator: radiotap_iterator to move to next arg (if any)
+ *
+ * @return next present arg index on success or negative if no more or error
  */
 static int
 ieee80211_radiotap_iterator_next (struct ieee80211_radiotap_iterator
diff --git a/src/transport/gnunet-transport.c b/src/transport/gnunet-transport.c
index 4d2912c34..4c9e8566c 100644
--- a/src/transport/gnunet-transport.c
+++ b/src/transport/gnunet-transport.c
@@ -437,7 +437,10 @@ notify_receive (void *cls, const struct GNUNET_PeerIdentity *peer,
  * Function to call with a human-readable format of an address
  *
  * @param cls closure
- * @param address NULL on error, otherwise 0-terminated printable UTF-8 string
+ * @param peer identity of the peer
+ * @param transport name of the plugin
+ * @param addr binary address
+ * @param addrlen number of bytes in addr
  */
 static void
 process_address (void *cls, const struct GNUNET_PeerIdentity *peer,
diff --git a/src/transport/plugin_transport_sat_constants.h b/src/transport/plugin_transport_sat_constants.h
index bd64c5d2b..b8202817f 100644
--- a/src/transport/plugin_transport_sat_constants.h
+++ b/src/transport/plugin_transport_sat_constants.h
@@ -1,6 +1,6 @@
 /*
      This file is part of GNUnet
-     (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors)
+     (C) 2011 Christian Grothoff (and other contributing authors)
 
      GNUnet is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file transport/plugin_transport_sat_send.h
+ * @file transport/plugin_transport_sat_constants.h
  * @brief header for transport plugin for satellite for send operations
  * @author Christian Rupp
  */