/pidgin/main: 20db2a5799da: doc fixes for stun

Changeset: 20db2a5799da16b5be26593349e0959ba5873dc2
Author:	 Gary Kramlich <[email protected]>
Date:	 2016-08-28 17:13 -0500
Branch:	 default
URL: https://hg.pidgin.im/pidgin/main/rev/20db2a5799da

Description:

doc fixes for stun

diffstat:

 libpurple/stun.h |  31 +++++++++++++++++++++++++++----
 1 files changed, 27 insertions(+), 4 deletions(-)

diffs (69 lines):

diff --git a/libpurple/stun.h b/libpurple/stun.h
--- a/libpurple/stun.h
+++ b/libpurple/stun.h
@@ -28,9 +28,9 @@
  * @title: STUN API
  */
 
-/**************************************************************************/
-/* STUN API                                                               */
-/**************************************************************************/
+/******************************************************************************
+ * STUN API
+ *****************************************************************************/
 
 typedef struct _PurpleStunNatDiscovery PurpleStunNatDiscovery;
 
@@ -40,6 +40,8 @@ typedef struct _PurpleStunNatDiscovery P
  * @PURPLE_STUN_STATUS_UNKNOWN: No STUN server reachable
  * @PURPLE_STUN_STATUS_DISCOVERING: The request has been sent to the server
  * @PURPLE_STUN_STATUS_DISCOVERED: The server has responded
+ *
+ * The status of a #PurpleStunNatDiscovery
  */
 typedef enum {
 	PURPLE_STUN_STATUS_UNDISCOVERED = -1,
@@ -48,6 +50,17 @@ typedef enum {
 	PURPLE_STUN_STATUS_DISCOVERED
 } PurpleStunStatus;
 
+/**
+ * PurpleStunNatType:
+ * @PURPLE_STUN_NAT_TYPE_PUBLIC_IP: No NAT
+ * @PURPLE_STUN_NAT_TYPE_UNKNOWN_NAT: NAT is unknown
+ * @PURPLE_STUN_NAT_TYPE_FULL_CONE: NAT is a full cone
+ * @PURPLE_STUN_NAT_TYPE_RESTRICTED_CONE: NAT is a restricted cone
+ * @PURPLE_STUN_NAT_TYPE_PORT_RESTRICTED_CONE: NAT is a port restricted cone
+ * @PURPLE_STUN_NAT_TYPE_SYMMETRIC: NAT is symmetric
+ *
+ * The type of NAT that was discovered.
+ */
 typedef enum {
 	PURPLE_STUN_NAT_TYPE_PUBLIC_IP,
 	PURPLE_STUN_NAT_TYPE_UNKNOWN_NAT,
@@ -57,6 +70,16 @@ typedef enum {
 	PURPLE_STUN_NAT_TYPE_SYMMETRIC
 } PurpleStunNatType;
 
+/**
+ * PurpleStunNatDiscovery:
+ * @status: The #PurpleStunStatus
+ * @type: The #PurpleStunNatType
+ * @publicip: The public ip
+ * @servername: The name of the stun server
+ * @lookup_time: The time when the lookup occurred.
+ *
+ * A data type representing a STUN lookup.
+ */
 struct _PurpleStunNatDiscovery {
 	PurpleStunStatus status;
 	PurpleStunNatType type;
@@ -79,7 +102,7 @@ G_BEGIN_DECLS
  * is already done. Otherwise the callback is called when the discovery is over
  * and NULL is returned.
  *
- * Returns: a PurpleStunNatDiscovery which includes the public IP and the type
+ * Returns: a #PurpleStunNatDiscovery which includes the public IP and the type
  *         of NAT or NULL is discovery would block
  */
 PurpleStunNatDiscovery *purple_stun_discover(PurpleStunCallback cb);

_______________________________________________
Commits mailing list
[email protected]
https://pidgin.im/cgi-bin/mailman/listinfo/commits