[GNUnet-SVN] r28775 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2013-08-22 08:31:52 +0200 (Thu, 22 Aug 2013)
New Revision: 28775

Modified:
   gnunet/src/include/gnunet_multicast_service.h
Log:
-doxygen fixes

Modified: gnunet/src/include/gnunet_multicast_service.h
===================================================================
--- gnunet/src/include/gnunet_multicast_service.h       2013-08-22 06:28:34 UTC 
(rev 28774)
+++ gnunet/src/include/gnunet_multicast_service.h       2013-08-22 06:31:52 UTC 
(rev 28775)
@@ -263,7 +263,7 @@
  * Handle that identifies a join request.
  *
  * Used to match calls to #GNUNET_MULTICAST_JoinCallback to the
- * corresponding calls to GNUNET_MULTICAST_join_decision().
+ * corresponding calls to #GNUNET_MULTICAST_join_decision().
  */
 struct GNUNET_MULTICAST_JoinHandle;
 
@@ -707,17 +707,17 @@
  * @param member Membership handle.
  * @param fragment_id ID of a message fragment that this client would like to
           see replayed.
- * @param flags Additional flags for the replay request.  It is used & defined
- *        by the replay callback.
- * @param message_cb Function to be called for the replayed message.
- * @param message_cb_cls Closure for @a message_cb.
+ * @param flags Additional flags for the replay request.  It is used and 
defined
+ *        by the replay callback.  FIXME: which replay callback? FIXME: use 
enum?
+ *        FIXME: why not pass reply cb here?
  * @return Replay request handle, NULL on error.
  */
 struct GNUNET_MULTICAST_MemberReplayHandle *
 GNUNET_MULTICAST_member_replay_fragment (struct GNUNET_MULTICAST_Member 
*member,
                                          uint64_t fragment_id,
-                                         uint64_t flags)
+                                         uint64_t flags);
 
+
 /** 
  * Request a message fr to be replayed.
  *
@@ -763,7 +763,7 @@
  * Disconnects from all group members and invalidates the @a member handle.
  *
  * An application-dependent part message can be transmitted beforehand using
- * GNUNET_MULTICAST_member_to_origin())
+ * #GNUNET_MULTICAST_member_to_origin())
  *
  * @param member Membership handle.
  */
@@ -773,6 +773,11 @@
 
 /**
  * Function called to provide data for a transmission from a member to the 
origin.
+ *
+ * @param cls closure
+ * @param data_size number of bytes available in @a data
+ * @param data where to copy data for transmission
+ * @return number of bytes copied to data
  */
 typedef int
 (*GNUNET_MULTICAST_MemberTransmitNotify)(void *cls,