[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r27458 - gnunet/src/include
|
From: |
gnunet |
|
Subject: |
[GNUnet-SVN] r27458 - gnunet/src/include |
|
Date: |
Mon, 17 Jun 2013 13:13:41 +0200 |
Author: tg
Date: 2013-06-17 13:13:40 +0200 (Mon, 17 Jun 2013)
New Revision: 27458
Modified:
gnunet/src/include/gnunet_social_service.h
Log:
social api docs
Modified: gnunet/src/include/gnunet_social_service.h
===================================================================
--- gnunet/src/include/gnunet_social_service.h 2013-06-17 11:13:38 UTC (rev
27457)
+++ gnunet/src/include/gnunet_social_service.h 2013-06-17 11:13:40 UTC (rev
27458)
@@ -18,9 +18,9 @@
Boston, MA 02111-1307, USA.
*/
-/**
+/**
* @file include/gnunet_social_service.h
- * @brief Social service; implements social functionality using the PSYC
service
+ * @brief Social service; implements social functionality using the PSYC
service.
* @author tg
* @author Christian Grothoff
*/
@@ -40,51 +40,51 @@
#include "gnunet_multicast_service.h"
-/**
+/**
* Version number of GNUnet Social API.
*/
#define GNUNET_SOCIAL_VERSION 0x00000000
+/**
+ * Handle for our own presence in the network (we can of course have
+ * alter-egos).
+ */
+struct GNUNET_SOCIAL_Ego;
-/**
+/**
+ * Handle for another user (who is likely pseudonymous) in the network.
+ */
+struct GNUNET_SOCIAL_Nym;
+
+/**
* Handle for a place where social interactions happen.
*/
struct GNUNET_SOCIAL_Place;
-/**
+/**
* Handle for a place that one of our egos hosts.
*/
struct GNUNET_SOCIAL_Home;
-/**
- * Handle for our own presence in the network (we can of course have
- * alter-egos).
- */
-struct GNUNET_SOCIAL_Ego;
-
-/**
- * Handle for another user (who is likely pseudonymous) in the network.
- */
-struct GNUNET_SOCIAL_Nym;
-
-/**
+/**
* Handle to an implementation of try-and-slice.
*/
struct GNUNET_SOCIAL_Slicer;
-/**
+/**
* Method called from SOCIAL upon receiving a message indicating a call
- * to a 'method'.
+ * to a 'method'.
*
- * @param cls closure
- * @param full_method_name original method name from PSYC (may be more
- * specific than the registered method name due to try-and-slice
matching)
- * @param message_id unique message counter for this message;
+ * @param cls Closure.
+ * @param full_method_name Original method name from PSYC (may be more
+ * specific than the registered method name due to try-and-slice
matching).
+
+ * @param message_id Unique message counter for this message
* (unique only in combination with the given sender for
- * this channel)
- * @param data_off byte offset of 'data' in the overall data of the method
- * @param data_size number of bytes in 'data';
+ * this channel).
+ * @param data_off Byte offset of 'data' in the overall data of the method.
+ * @param data_size Number of bytes in 'data'.
* @param data data stream given to the method (might not be zero-terminated
* if data is binary)
* @param frag fragmentation status for the data
@@ -98,22 +98,26 @@
enum GNUNET_PSYC_FragmentStatus frag);
-/**
+/**
* Create a try-and-slice instance.
*
- * @return try-and-slice construct
+ * @return A new try-and-slice construct.
*/
struct GNUNET_SOCIAL_Slicer *
GNUNET_SOCIAL_slicer_create (void);
-/**
+/**
* Add a method to the try-and-slice instance.
*
- * @param slicer try-and-slice instance to extend
- * @param method_name name of the given method, use empty string for default
- * @param method method to invoke
- * @param method_cls closure for method
+ * A slicer processes messages and calls methods that match a message. A match
+ * happens whenever the method name of a message starts with the method_name
+ * parameter given here.
+ *
+ * @param slicer The try-and-slice instance to extend.
+ * @param method_name Name of the given method, use empty string for default.
+ * @param method Method to invoke.
+ * @param method_cls Closure for method.
*/
void
GNUNET_SOCIAL_slicer_add (struct GNUNET_SOCIAL_Slicer *slicer,
@@ -121,8 +125,9 @@
GNUNET_SOCIAL_Method method,
void *method_cls);
+/* FIXME: No slicer_remove for now, is it needed? */
-/**
+/**
* Destroy a given try-and-slice instance.
*
* @param slicer slicer to destroy
@@ -131,11 +136,12 @@
GNUNET_SOCIAL_slicer_destroy (struct GNUNET_SOCIAL_Slicer *slicer);
-/**
- * Create an ego using the private key from the given
- * file. If the file does not exist, a fresh key is
- * created.
+/**
+ * Create an ego.
*
+ * Create an ego using the private key from the given file. If the file does
+ * not exist, a fresh key is created.
+ *
* @param keyfile name of the file with the private key for the ego,
* NULL for ephemeral egos
* @return handle to the ego, NULL on error
@@ -144,7 +150,7 @@
GNUNET_SOCIAL_ego_create (const char *keyfile);
-/**
+/**
* Destroy a handle to an ego.
*
* @param ego ego to destroy
@@ -153,19 +159,20 @@
GNUNET_SOCIAL_ego_destroy (struct GNUNET_SOCIAL_Ego *ego);
-/**
- * Function called asking for nym to be admitted to the room. Should
- * call either 'GNUNET_SOCIAL_home_admit' or
- * 'GNUNET_SOCIAL_home_reject_entry' (possibly asynchronously). If
- * this owner cannot decide, it is fine to call neither function, in
- * which case hopefully some other owner of the home exists that will
- * make the decision. The 'nym' reference remains valid until the
- * 'GNUNET_SOCIAL_FarewellCallback' is invoked for it.
+/**
+ * Function called asking for nym to be admitted to the place.
*
- * @param cls closure
- * @param nym handle for the user who wants to join
- * @param join_msg_size number of bytes in 'join_msg'
- * @param join_msg payload given on join
+ * Should call either 'GNUNET_SOCIAL_home_admit' or
+ * 'GNUNET_SOCIAL_home_reject_entry' (possibly asynchronously). If this owner
+ * cannot decide, it is fine to call neither function, in which case hopefully
+ * some other owner of the home exists that will make the decision. The 'nym'
+ * reference remains valid until the 'GNUNET_SOCIAL_FarewellCallback' is
invoked
+ * for it.
+ *
+ * @param cls Closure.
+ * @param nym Handle for the user who wants to join.
+ * @param join_msg_size Number of bytes in 'join_msg'.
+ * @param join_msg Payload given on join (e.g. a password).
*/
typedef void (*GNUNET_SOCIAL_AnswerDoorCallback)(void *cls,
struct GNUNET_SOCIAL_Nym *nym,
@@ -173,32 +180,37 @@
const void *join_msg);
-/**
- * Function called when a 'nym' leaves the room. This is
- * also called if the 'nym' was never given permission to
- * enter (i.e. the 'nym' stopped asking to get in).
+/**
+ * Function called when a 'nym' leaves the place.
+ *
+ * This is also called if the 'nym' was never given permission to enter
+ * (i.e. the 'nym' stopped asking to get in).
*
- * @param cls closure
- * @param nym handle for the user who left
+ * @param cls Closure.
+ * @param nym Handle for the user who left.
*/
typedef void (*GNUNET_SOCIAL_FarewellCallback)(void *cls,
struct GNUNET_SOCIAL_Nym *nym);
-/**
- * Create a new home to host guests (nyms).
+/**
+ * Enter a home where guests (nyms) can be hosted.
*
- * @param cfg configuration to contact the social service
- * @param home_keyfile file with the private key for the home,
- * created if the file does not exist;
- * pass NULL for ephemeral homes
- * @param join_policy what is our policy for allowing people in?
- * @param ego owner of the home (host)
- * @param slicer slicer to handle guests talking
- * @param listener_cb function to handle new nyms that want to join
- * @param farewell_cb function to handle departing nyms
- * @param cls closure for 'listener_cb' and 'farewell_cb'
- * @return handle for a new home
+ * A home is created upon first entering, and exists until
+ * 'GNUNET_SOCIAL_home_destroy' is called. It can also be left temporarily
using
+ * 'GNUNET_SOCIAL_home_leave'.
+ *
+ * @param cfg Configuration to contact the social service.
+ * @param home_keyfile File with the private key for the home,
+ * created if the file does not exist;
+ * pass NULL for ephemeral homes.
+ * @param join_policy What is our policy for allowing people in?
+ * @param ego Owner of the home (host).
+ * @param slicer Slicer to handle guests talking.
+ * @param listener_cb Function to handle new nyms that want to join.
+ * @param farewell_cb Function to handle departing nyms.
+ * @param cls Closure for 'listener_cb' and 'farewell_cb'.
+ * @return Handle for a new home.
*/
struct GNUNET_SOCIAL_Home *
GNUNET_SOCIAL_home_enter (const struct GNUNET_CONFIGURATION_Handle *cfg,
@@ -211,39 +223,45 @@
void *cls);
-/**
- * Admit 'nym' to the 'home'. 'nym' will remain valid until either
- * the home is destroyed or 'nym' leaves.
+/**
+ * Admit 'nym' to the 'home'.
*
- * @param home home to allow 'nym' to join
- * @param nym handle for the entity that wants to join
+ * The 'nym' reference will remain valid until either the home is destroyed or
+ * 'nym' leaves.
+ *
+ * @param home Home to allow 'nym' to join.
+ * @param nym Handle for the entity that wants to join.
*/
void
GNUNET_SOCIAL_home_admit (struct GNUNET_SOCIAL_Home *home,
struct GNUNET_SOCIAL_Nym *nym);
-/**
- * Throw 'nym' out of the 'home'. 'nym' will remain valid
- * until the 'GNUNET_SOCIAL_FarewellCallback' is invoked, which
- * should be very soon after this call.
+/**
+ * Throw 'nym' out of the 'home'.
*
- * @param home home to allow 'nym' to join
- * @param nym handle for the entity that wants to join
+ * The 'nym' reference will remain valid until the
+ * 'GNUNET_SOCIAL_FarewellCallback' is invoked,
+ * which should be very soon after this call.
+ *
+ * @param home Home to eject nym from.
+ * @param nym Handle for the entity to be ejected.
*/
void
-GNUNET_SOCIAL_home_evict (struct GNUNET_SOCIAL_Home *home,
- struct GNUNET_SOCIAL_Nym *nym);
+GNUNET_SOCIAL_home_eject (struct GNUNET_SOCIAL_Home *home,
+ struct GNUNET_SOCIAL_Nym *nym);
-/**
+/**
* Refuse 'nym' entry into the 'home'.
*
- * @param home home to disallow 'nym' to join
- * @param nym handle for the entity that wanted to join
- * @param method method name to invoke on caller
- * @param message_size number of bytes in 'message' for method
- * @param message rejection message to send back
+ * @param home Home to disallow 'nym' to join.
+ * @param nym Handle for the entity that wanted to join.
+ * @param method Method name to invoke on caller.
+ * @param message_size Number of bytes in 'message' for method.
+ * @param message Rejection message to send back.
+ *
+ * FIXME: allow setting variables as well for the message
*/
void
GNUNET_SOCIAL_home_reject_entry (struct GNUNET_SOCIAL_Home *home,
@@ -253,41 +271,42 @@
const void *message);
-/**
- * Get the identity of a user (suitable, for example, to be used
- * with 'GNUNET_NAMESTORE_zone_to_name').
+/**
+ * Get the identity of a user.
*
- * @param nym pseydonym to map to a cryptographic identifier
- * @param identity set to the identity of the nym (short hash of the public
key)
+ * Suitable, for example, to be used with 'GNUNET_NAMESTORE_zone_to_name'.
+ *
+ * @param nym Pseudonym to map to a cryptographic identifier.
+ * @param identity Set to the identity of the nym (short hash of the public
key).
*/
void
GNUNET_SOCIAL_nym_get_identity (struct GNUNET_SOCIAL_Nym *nym,
struct GNUNET_CRYPTO_ShortHashCode *identity);
-/**
+/**
* Obtain the (cryptographic, binary) address for the home.
*
- * @param home home to get the (public) address from
- * @param crypto_address address suitable for storing in GADS,
- * i.e. in 'HEX.place' or within the respective GADS record type
("PLACE")
+ * @param home Home to get the (public) address from.
+ * @param crypto_address Address suitable for storing in GADS, i.e. in
+ * 'HEX.place' or within the respective GADS record type ("PLACE")
*/
void
GNUNET_SOCIAL_home_get_address (struct GNUNET_SOCIAL_Home *home,
struct GNUNET_HashCode *crypto_address);
-/**
- * (re)decorate the home by changing objects in it. If
- * the operation is 'GNUNET_PSYC_SOT_SET_VARIABLE' then
- * the decoration only applies to the next announcement
- * by the home owner.
+/**
+ * (Re)decorate the home by changing objects in it.
*
- * @param home the home to decorate
- * @param operation operation to perform on the object
- * @param object_name name of the object to modify
- * @param object_value_size size of the given 'object_value'
- * @param object_value value to use for the modification
+ * If the operation is 'GNUNET_PSYC_SOT_SET_VARIABLE' then the decoration only
+ * applies to the next announcement by the home owner.
+ *
+ * @param home The home to decorate.
+ * @param operation Operation to perform on the object.
+ * @param object_name Name of the object to modify.
+ * @param object_value_size Size of the given 'object_value'.
+ * @param object_value Value to use for the modification.
*/
void
GNUNET_SOCIAL_home_decorate (struct GNUNET_SOCIAL_Home *home,
@@ -297,81 +316,85 @@
const void *object_value);
-/**
+/**
* Handle for an announcement request.
*/
struct GNUNET_SOCIAL_Announcement;
-/**
- * This function allows the home owner to send a message to all
- * nyms that are present in the home.
+/**
+ * Send a message to all nyms that are present in the home.
*
- * @param home home to address the announcement to
- * @param full_method_name method to use for the announcement
- * @param notify function to call to get the payload of the announcement
- * @param notify_cls closure for 'notify'
- * @return NULL on error (announcement already in progress?)
+ * This function is restricted to the home owner. Nyms can
+ *
+ * @param home Home to address the announcement to.
+ * @param full_method_name Method to use for the announcement.
+ * @param notify Function to call to get the payload of the announcement.
+ * @param notify_cls Closure for 'notify'.
+ * @return NULL on error (announcement already in progress?).
*/
struct GNUNET_SOCIAL_Announcement *
-GNUNET_SOCIAL_place_announce (struct GNUNET_SOCIAL_Home *home,
- const char *full_method_name,
- GNUNET_PSYC_OriginReadyNotify notify,
- void *notify_cls);
+GNUNET_SOCIAL_home_announce (struct GNUNET_SOCIAL_Home *home,
+ const char *full_method_name,
+ GNUNET_PSYC_OriginReadyNotify notify,
+ void *notify_cls);
-/**
+/**
* Cancel announcement.
*
- * @param a the announcement to cancel
+ * @param a The announcement to cancel.
*/
void
-GNUNET_SOCIAL_place_announce_cancel (struct GNUNET_SOCIAL_Announcement *a);
+GNUNET_SOCIAL_home_announce_cancel (struct GNUNET_SOCIAL_Announcement *a);
-/**
+/**
* Convert our home to a place so we can access it via the place API.
*
- * @param home handle for the home
- * @return place handle for the same home, valid as long as 'home' is valid;
- * do NOT try to 'GNUNET_SOCIAL_place_leave' this place, it's your
home!
+ * @param home Handle for the home.
+ * @return Place handle for the same home, valid as long as 'home' is valid;
+ * do NOT try to 'GNUNET_SOCIAL_place_leave' this place, it's your
home!m
*/
struct GNUNET_SOCIAL_Place *
GNUNET_SOCIAL_home_to_place (struct GNUNET_SOCIAL_Home *home);
-/**
+/**
* Leave a home, visitors can stay.
*
- * @param home home to leave (handle becomes invalid).
+ * After leaving, handling of incoming messages are left to other clients of
the
+ * social service, and stops after the last client exits.
+ *
+ * @param home Home to leave (handle becomes invalid).
*/
void
GNUNET_SOCIAL_home_leave (struct GNUNET_SOCIAL_Home *home);
-/**
- * Destroy a home, all guests will be evicted.
+/**
+ * Destroy a home, all guests will be ejected.
*
- * @param home home to destroy
+ * @param home Home to destroy.
*/
void
GNUNET_SOCIAL_home_destroy (struct GNUNET_SOCIAL_Home *home);
-/**
+/**
* Join a place (home hosted by someone else).
*
- * @param cfg configuration to contact the social service
- * @param ego owner of the home (host)
- * @param address address of the place to join (GADS name, i.e.
'room.friend.gads'),
+ * @param cfg Configuration to contact the social service.
+ * @param ego Owner of the home (host).
+ * @param address Address of the place to join (GADS name, i.e.
'room.friend.gads'),
* if the name has the form 'HEX.place', GADS is not
* used and HEX is assumed to be the hash of the public
* key already; 'HEX.zkey' however would refer to
* the 'PLACE' record in the GADS zone with the public key
* 'HEX'.
- * @param join_msg_size number of bytes in 'join_msg'
- * @param join_msg message to give to the join callback
- * @return NULL on errors, otherwise handle to the place
+ * @param join_msg_size Number of bytes in 'join_msg'.
+ * @param join_msg Message to give to the join callback.
+ * @return NULL on errors, otherwise handle to the place.
*/
struct GNUNET_SOCIAL_Place *
GNUNET_SOCIAL_place_join (const struct GNUNET_CONFIGURATION_Handle *cfg,
@@ -382,18 +405,17 @@
const void *join_msg);
-/**
- *
- */
struct GNUNET_SOCIAL_WatchHandle;
-/**
+/**
+ * Watch a place for changed objects.
+ *
+ * @param place Place to watch.
+ * @param object_filter Object prefix to match. if
+ * @param state_cb
+ * @param state_cb_cls
*
- *
- * @param
- * @param
- * @param
- * @param
+ * @return
*/
struct GNUNET_SOCIAL_WatchHandle *
GNUNET_SOCIAL_place_watch (struct GNUNET_SOCIAL_Place *place,
@@ -402,23 +424,20 @@
void *state_cb_cls);
-/**
- *
- *
- * @param
- */
void
GNUNET_SOCIAL_place_watch_cancel (struct GNUNET_SOCIAL_WatchHandle *wh);
-/**
- *
- */
struct GNUNET_SOCIAL_LookHandle;
-/**
+/**
* Look at all objects in the place.
*
+ * @param place The place to look its objects at.
+ * @param state_cb Function to call for each object found.
+ * @param state_cb_cls Closure for callback function.
+ *
+ * @return Handle that can be used to stop looking at objects.
*/
struct GNUNET_SOCIAL_LookHandle *
GNUNET_SOCIAL_place_look (struct GNUNET_SOCIAL_Place *place,
@@ -426,9 +445,15 @@
void *state_cb_cls);
-/**
+/**
* Look at matching objects in the place.
*
+ * @param place The place to look its objects at.
+ * @param object_filter Only look at objects with names beginning with this
filter value.
+ * @param state_cb Function to call for each object found.
+ * @param state_cb_cls Closure for callback function.
+ *
+ * @return Handle that can be used to stop looking at objects.
*/
struct GNUNET_SOCIAL_LookHandle *
GNUNET_SOCIAL_place_look_for (struct GNUNET_SOCIAL_Place *place,
@@ -437,23 +462,21 @@
void *state_cb_cls);
-/**
- *
- *
- * @param lh
+/**
+ * Stop looking at objects.
*/
void
GNUNET_SOCIAL_place_look_cancel (struct GNUNET_SOCIAL_LookHandle *lh);
-/**
+/**
* Look at a particular object in the place.
*
- * @param place
- * @param object_name
- * @param value_size set to the size of the returned value
- * @return NULL if there is no such object at this place
+ * @param place The place to look the object at.
+ * @param object_name Full name of the object.
+ * @param value_size Set to the size of the returned value.
+ * @return NULL if there is no such object at this place.
*/
const void *
GNUNET_SOCIAL_place_look_at (struct GNUNET_SOCIAL_Place *place,
@@ -461,13 +484,16 @@
size_t *value_size);
-/**
+/**
* Frame the (next) talk by setting some variables for it.
*
- * @param place
- * @param variable_name
- * @param value_size number of bytes in 'value'
- * @param value
+ * FIXME: use a TalkFrame struct instead that can be passed to
+ * place_talk, nym_talk and home_reject_entry.
+ *
+ * @param place Place to talk in.
+ * @param variable_name Name of variable to set.
+ * @param value_size Number of bytes in 'value'.
+ * @param value Value of variable.
*/
void
GNUNET_SOCIAL_place_frame_talk (struct GNUNET_SOCIAL_Place *place,
@@ -476,21 +502,21 @@
const void *value);
-/**
- *
+/**
+ * A talk request.
*/
struct GNUNET_SOCIAL_TalkRequest;
-/**
+/**
* Talk to the host of the place.
*
- * @param place place at which we want to talk to the host
- * @param method_name method to invoke on the host
- * @param cb function to use to get the payload for the method
- * @param cb_cls closure for 'cb'
+ * @param place Place where we want to talk to the host.
+ * @param method_name Method to invoke on the host.
+ * @param cb Function to use to get the payload for the method.
+ * @param cb_cls Closure for 'cb'.
* @return NULL if we are already trying to talk to the host,
- * otherwise handle to cancel the request
+ * otherwise handle to cancel the request.
*/
struct GNUNET_SOCIAL_TalkRequest *
GNUNET_SOCIAL_place_talk (struct GNUNET_SOCIAL_Place *place,
@@ -498,31 +524,52 @@
GNUNET_PSYC_OriginReadyNotify cb,
void *cb_cls);
+/**
+ * Talk to a nym.
+ *
+ * FIXME: look up nym in GADS and talk to its place.
+ *
+ * @param nym Nym we want to talk to.
+ * @param method_name Method to invoke on the nym.
+ * @param cb Function to use to get the payload for the method.
+ * @param cb_cls Closure for 'cb'.
+ * @return NULL if we are already trying to talk to the host,
+ * otherwise handle to cancel the request.
+ */
+struct GNUNET_SOCIAL_TalkRequest *
+GNUNET_SOCIAL_nym_talk (struct GNUNET_SOCIAL_Nym *nym,
+ const char *method_name,
+ GNUNET_PSYC_OriginReadyNotify cb,
+ void *cb_cls);
-/**
- *
+
+/**
+ * Cancel talking to the host of the place.
*
- * @param tr
+ * @param tr Talk request to cancel.
*/
void
GNUNET_SOCIAL_place_talk_cancel (struct GNUNET_SOCIAL_TalkRequest *tr);
-/**
- *
+/**
+ * A history lesson.
*/
struct GNUNET_SOCIAL_HistoryLesson;
-/**
+/**
+ * Learn about the history of a place.
*
+ * Sends messages through the given slicer function where
+ * start_message_id <= message_id <= end_message_id.
*
- * @param place place we want to learn more about
- * @param start_message_id first historic message we are interested in
- * @param end_message_id last historic message we are interested in (inclusive)
- * @param slicer slicer to use to process history
- * @return handle to abort history lesson, never NULL (multiple lesssons
- * at the same time are allowed)
+ * @param place Place we want to learn more about.
+ * @param start_message_id First historic message we are interested in.
+ * @param end_message_id Last historic message we are interested in
(inclusive).
+ * @param slicer Slicer to use to process history.
+ * @return Handle to abort history lesson, never NULL (multiple lessons
+ * at the same time are allowed).
*/
struct GNUNET_SOCIAL_HistoryLesson *
GNUNET_SOCIAL_place_get_history (struct GNUNET_SOCIAL_Place *place,
@@ -531,26 +578,28 @@
struct GNUNET_SOCIAL_Slicer *slicer);
-/**
- * Stop processing messages from the history lesson. Must also be
- * called explicitly after all of the requested messages have been
+/**
+ * Stop processing messages from the history lesson.
+ *
+ * Must also be called explicitly after all of the requested messages have been
* received.
*
- * @param hist history lesson to cancel
+ * @param hist History lesson to cancel.
*/
void
GNUNET_SOCIAL_place_get_history_cancel (struct GNUNET_SOCIAL_HistoryLesson
*hist);
-/**
- * Leave a place (destroys the place handle). Can either move our
- * user into an 'away' state (in which we continue to record ongoing
- * conversations and state changes if our peer is running), or
- * leave the place entirely and stop following the conversation.
+/**
+ * Leave a place (destroys the place handle).
+ *
+ * Can either move our user into an 'away' state (in which we continue to
record
+ * ongoing conversations and state changes if our peer is running), or leave
the
+ * place entirely and stop following the conversation.
*
- * @param place place to leave
+ * @param place Place to leave.
* @param keep_following GNUNET_YES to ask the social service to continue
- * to follow the conversation, GNUNET_NO to fully leave the place
+ * to follow the conversation, GNUNET_NO to fully leave the place.
*/
void
GNUNET_SOCIAL_place_leave (struct GNUNET_SOCIAL_Place *place,
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r27458 - gnunet/src/include,
gnunet <=