Mercurial > pidgin3 / file diff

--- a/libpurple/stun.h	Sat Feb 01 02:32:30 2014 +0530
+++ b/libpurple/stun.h	Sat Feb 01 17:27:24 2014 +0530
@@ -33,9 +33,13 @@
 
 typedef struct _PurpleStunNatDiscovery PurpleStunNatDiscovery;
 
+/**
+ * PurpleStunStatus:
+ * @PURPLE_STUN_STATUS_UNKNOWN: no STUN server reachable
+ */
 typedef enum {
 	PURPLE_STUN_STATUS_UNDISCOVERED = -1,
-	PURPLE_STUN_STATUS_UNKNOWN, /* no STUN server reachable */
+	PURPLE_STUN_STATUS_UNKNOWN,
 	PURPLE_STUN_STATUS_DISCOVERING,
 	PURPLE_STUN_STATUS_DISCOVERED
 } PurpleStunStatus;
@@ -62,14 +66,15 @@
 G_BEGIN_DECLS
 
 /**
+ * purple_stun_discover:
+ * @cb: The callback to call when the STUN discovery is finished if the
+ *           discovery would block.  If the discovery is done, this is NOT
+ *           called.
+ *
  * Starts a NAT discovery. It returns a PurpleStunNatDiscovery if the discovery
  * is already done. Otherwise the callback is called when the discovery is over
  * and NULL is returned.
  *
- * @cb: The callback to call when the STUN discovery is finished if the
- *           discovery would block.  If the discovery is done, this is NOT
- *           called.
- *
  * Returns: a PurpleStunNatDiscovery which includes the public IP and the type
  *         of NAT or NULL is discovery would block
  */