-doxygen, plus FIXME request for clarification

[oweals/gnunet.git] / src / include / gnunet_social_service.h

diff --git a/src/include/gnunet_social_service.h b/src/include/gnunet_social_service.h
index 88a52b709477c0dd4a0dbb8e6bea8b262bcb3c59..98ad8834610ca5a639979dd6cb28096eefe51ae2 100644 (file)
--- a/src/include/gnunet_social_service.h
+++ b/src/include/gnunet_social_service.h
@@ -283,7 +283,7 @@ GNUNET_SOCIAL_home_reject_entry (struct GNUNET_SOCIAL_Home *home,
  */
 void
 GNUNET_SOCIAL_nym_get_key (struct GNUNET_SOCIAL_Nym *nym,
-                           struct GNUNET_CRYPTO_EccPublicSignKey *nym_key);
+                           struct GNUNET_CRYPTO_EddsaPublicKey *nym_key);
 
 
 /**
@@ -294,7 +294,7 @@ GNUNET_SOCIAL_nym_get_key (struct GNUNET_SOCIAL_Nym *nym,
  */
 void
 GNUNET_SOCIAL_home_get_key (struct GNUNET_SOCIAL_Home *home,
-                            struct GNUNET_CRYPTO_EccPrivateKey *home_key);
+                            struct GNUNET_CRYPTO_EddsaPrivateKey *home_key);
 
 
 /**
@@ -375,12 +375,11 @@ 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.
- * @param keep_active Keep home active after last application disconnected.
  * @return Place handle for the same home, valid as long as @a home is valid;
  *         do NOT try to GNUNET_SOCIAL_place_leave() this place, it's your home!
  */
 struct GNUNET_SOCIAL_Place *
-GNUNET_SOCIAL_home_get_place (struct GNUNET_SOCIAL_Home *home, int keep_active);
+GNUNET_SOCIAL_home_get_place (struct GNUNET_SOCIAL_Home *home);
 
 
 /**
@@ -390,9 +389,10 @@ GNUNET_SOCIAL_home_get_place (struct GNUNET_SOCIAL_Home *home, int keep_active);
  * Guests will be disconnected until the home is restarted.
  *
  * @param home Home to leave.
+ * @param keep_active Keep home active after last application disconnected.
  */
 void
-GNUNET_SOCIAL_home_leave (struct GNUNET_SOCIAL_Home *home);
+GNUNET_SOCIAL_home_leave (struct GNUNET_SOCIAL_Home *home, int keep_active);
 
 /**
  * Request entry to a place (home hosted by someone else).
@@ -440,7 +440,7 @@ GNUNET_SOCIAL_place_enter (const struct GNUNET_CONFIGURATION_Handle *cfg,
 struct GNUNET_SOCIAL_Place *
 GNUNET_SOCIAL_place_enter2 (const struct GNUNET_CONFIGURATION_Handle *cfg,
                             struct GNUNET_IDENTITY_Ego *ego,
-                            struct GNUNET_CRYPTO_EccPublicSignKey *crypto_address,
+                            struct GNUNET_CRYPTO_EddsaPublicKey *crypto_address,
                             struct GNUNET_PeerIdentity *origin,
                             size_t relay_count,
                             struct GNUNET_PeerIdentity *relays,
@@ -587,7 +587,7 @@ struct GNUNET_SOCIAL_HistoryLesson;
  * @param slicer Slicer to use to process history.  Can be the same as the
  *               slicer of the place, as the HISTORIC flag allows distinguishing
  *               old messages from fresh ones.
- * @param finish_cb Function called after the last message if the history lesson
+ * @param finish_cb Function called after the last message in the history lesson
  *              is passed through the @a slicer. NULL if not needed.
  * @param finish_cb_cls Closure for @a finish_cb.
  * @return Handle to abort history lesson, never NULL (multiple lessons