[GNUnet-SVN] r27779 - in gnunet/src: exit fs include mesh regex testbed

[gnunet]

Author: grothoff
Date: 2013-07-07 16:35:51 +0200 (Sun, 07 Jul 2013)
New Revision: 27779

Modified:
   gnunet/src/exit/gnunet-daemon-exit.c
   gnunet/src/fs/gnunet-service-fs_mesh.c
   gnunet/src/include/gnunet_identity_service.h
   gnunet/src/include/gnunet_multicast_service.h
   gnunet/src/include/gnunet_psyc_service.h
   gnunet/src/include/gnunet_psycstore_service.h
   gnunet/src/include/gnunet_regex_service.h
   gnunet/src/include/gnunet_social_service.h
   gnunet/src/mesh/mesh_api.c
   gnunet/src/regex/gnunet-regex-profiler.c
   gnunet/src/regex/regex_block_lib.c
   gnunet/src/regex/regex_block_lib.h
   gnunet/src/testbed/gnunet-service-testbed_peers.c
   gnunet/src/testbed/testbed_logger_api.c
Log:
-doxygen fixes

Modified: gnunet/src/exit/gnunet-daemon-exit.c
===================================================================
--- gnunet/src/exit/gnunet-daemon-exit.c        2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/exit/gnunet-daemon-exit.c        2013-07-07 14:35:51 UTC (rev 
27779)
@@ -813,7 +813,7 @@
 /**
  * Send the given packet via the mesh tunnel.
  *
- * @param mesh_tunnel destination
+ * @param s tunnel destination
  * @param tnq message to queue
  */
 static void

Modified: gnunet/src/fs/gnunet-service-fs_mesh.c
===================================================================
--- gnunet/src/fs/gnunet-service-fs_mesh.c      2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/fs/gnunet-service-fs_mesh.c      2013-07-07 14:35:51 UTC (rev 
27779)
@@ -1127,6 +1127,7 @@
  * @param socket the socket representing the mesh
  * @param initiator the identity of the peer who wants to establish a mesh
  *            with us; NULL on binding error
+ * @param port mesh port used for the incoming connection
  * @return initial tunnel context (our 'struct StreamClient')
  */
 static void *

Modified: gnunet/src/include/gnunet_identity_service.h
===================================================================
--- gnunet/src/include/gnunet_identity_service.h        2013-07-07 13:43:59 UTC 
(rev 27778)
+++ gnunet/src/include/gnunet_identity_service.h        2013-07-07 14:35:51 UTC 
(rev 27779)
@@ -154,6 +154,7 @@
  * @param service_name for which service is an identity set
  * @param pseu new default identity to be set for this service
  * @param cont function to call once the operation finished
+ * @param cont_cls closure for cont
  * @return handle to abort the operation
  */
 struct GNUNET_IDENTITY_Operation *

Modified: gnunet/src/include/gnunet_multicast_service.h
===================================================================
--- gnunet/src/include/gnunet_multicast_service.h       2013-07-07 13:43:59 UTC 
(rev 27778)
+++ gnunet/src/include/gnunet_multicast_service.h       2013-07-07 14:35:51 UTC 
(rev 27779)
@@ -405,7 +405,7 @@
 /** 
  * A response to a @e ping.
  *
- * @param ph Handle that was given for the ping.
+ * @param rh Handle that was given for the ping.
  * @param message_id Latest message ID seen by this peer for this group.
  */
 void

Modified: gnunet/src/include/gnunet_psyc_service.h
===================================================================
--- gnunet/src/include/gnunet_psyc_service.h    2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/include/gnunet_psyc_service.h    2013-07-07 14:35:51 UTC (rev 
27779)
@@ -48,7 +48,7 @@
  *   and variables must fit into memory and cannot be streamed
  *   (thus, no passing of 4 GB of data in a variable; 
  *   once we implement this, we might want to create a
- *   #define for the maximum size of a variable).
+ *   @c #define for the maximum size of a variable).
  * - PSYC defines standard variables, methods, etc.  This
  *   library deliberately abstracts over all of these; a
  *   higher-level API should combine the naming system (GADS)

Modified: gnunet/src/include/gnunet_psycstore_service.h
===================================================================
--- gnunet/src/include/gnunet_psycstore_service.h       2013-07-07 13:43:59 UTC 
(rev 27778)
+++ gnunet/src/include/gnunet_psycstore_service.h       2013-07-07 14:35:51 UTC 
(rev 27779)
@@ -138,7 +138,7 @@
  *
  * @param h Handle for the PSYCstore.
  * @param channel_id The channel the message belongs to.
- * @param message_id Message ID to store.
+ * @param message Message to store.
  * @param ccb Callback to call with the result of the operation.
  * @param ccb_cls Closure for the callback.
  * 

Modified: gnunet/src/include/gnunet_regex_service.h
===================================================================
--- gnunet/src/include/gnunet_regex_service.h   2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/include/gnunet_regex_service.h   2013-07-07 14:35:51 UTC (rev 
27779)
@@ -61,7 +61,6 @@
  * that.
  * 
  * @param cfg configuration to use
- * @param id ID to announce as provider of regex. Own ID in most cases.
  * @param regex Regular expression to announce.
  * @param refresh_delay after what delay should the announcement be repeated?
  * @param compression How many characters per edge can we squeeze?

Modified: gnunet/src/include/gnunet_social_service.h
===================================================================
--- gnunet/src/include/gnunet_social_service.h  2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/include/gnunet_social_service.h  2013-07-07 14:35:51 UTC (rev 
27779)
@@ -392,6 +392,7 @@
  *        key already; 'HEX.zkey' however would refer to
  *        the 'PLACE' record in the GADS zone with the public key
  *        'HEX'.
+ * @param slicer slicer to use to process messages from this place
  * @param join_msg_size Number of bytes in @a join_msg.
  * @param join_msg Message to give to the join callback.
  * @return NULL on errors, otherwise handle to the place.

Modified: gnunet/src/mesh/mesh_api.c
===================================================================
--- gnunet/src/mesh/mesh_api.c  2013-07-07 13:43:59 UTC (rev 27778)
+++ gnunet/src/mesh/mesh_api.c  2013-07-07 14:35:51 UTC (rev 27779)
@@ -603,7 +603,6 @@
 /**
  * Send an ack on the tunnel to confirm the processing of a message.
  * 
- * @param h Mesh handle.
  * @param t Tunnel on which to send the ACK.
  */
 static void

Modified: gnunet/src/regex/gnunet-regex-profiler.c
===================================================================
--- gnunet/src/regex/gnunet-regex-profiler.c    2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/regex/gnunet-regex-profiler.c    2013-07-07 14:35:51 UTC (rev 
27779)
@@ -1098,7 +1098,7 @@
  *
  * @param cls NULL
  * @param num_peers_ number of peers in 'peers'
- * @param peers handle to peers run in the testbed.  NULL upon timeout (see
+ * @param testbed_peers handle to peers run in the testbed.  NULL upon timeout 
(see
  *          GNUNET_TESTBED_test_run()).
  * @param links_succeeded the number of overlay link connection attempts that
  *          succeeded

Modified: gnunet/src/regex/regex_block_lib.c
===================================================================
--- gnunet/src/regex/regex_block_lib.c  2013-07-07 13:43:59 UTC (rev 27778)
+++ gnunet/src/regex/regex_block_lib.c  2013-07-07 14:35:51 UTC (rev 27779)
@@ -244,7 +244,7 @@
  *
  * @param block block to get the key from
  * @param block_len number of bytes in block
- * @param query where to store the key
+ * @param key where to store the key
  * @return GNUNET_OK on success, GNUNET_SYSERR if the block is malformed
  */
 int

Modified: gnunet/src/regex/regex_block_lib.h
===================================================================
--- gnunet/src/regex/regex_block_lib.h  2013-07-07 13:43:59 UTC (rev 27778)
+++ gnunet/src/regex/regex_block_lib.h  2013-07-07 14:35:51 UTC (rev 27779)
@@ -143,7 +143,7 @@
  *
  * @param block block to get the key from
  * @param block_len number of bytes in block
- * @param query where to store the key
+ * @param key where to store the key
  * @return GNUNET_OK on success, GNUNET_SYSERR if the block is malformed
  */
 int

Modified: gnunet/src/testbed/gnunet-service-testbed_peers.c
===================================================================
--- gnunet/src/testbed/gnunet-service-testbed_peers.c   2013-07-07 13:43:59 UTC 
(rev 27778)
+++ gnunet/src/testbed/gnunet-service-testbed_peers.c   2013-07-07 14:35:51 UTC 
(rev 27779)
@@ -774,7 +774,7 @@
  * Callback to inform whether the peer is running or stopped.
  *
  * @param cls the closure given to GNUNET_TESTING_peer_stop_async()
- * @param peer the respective peer whose status is being reported
+ * @param p the respective peer whose status is being reported
  * @param success GNUNET_YES if the peer is stopped; GNUNET_SYSERR upon any
  *          error
  */

Modified: gnunet/src/testbed/testbed_logger_api.c
===================================================================
--- gnunet/src/testbed/testbed_logger_api.c     2013-07-07 13:43:59 UTC (rev 
27778)
+++ gnunet/src/testbed/testbed_logger_api.c     2013-07-07 14:35:51 UTC (rev 
27779)
@@ -152,8 +152,7 @@
 /**
  * Cancels the flush timeout task
  *
- * @param 
- * @return 
+ * @param h handle to the logger
  */
 static void
 cancel_timeout_flush (struct GNUNET_TESTBED_LOGGER_Handle *h)