libpurple/xfer.c

branch
gtkdoc-conversion
changeset 35466
e259e75f1c6f
parent 35454
cf2a24d01503
child 35489
e1452d2416ed
child 37072
b4d3e353c563
--- a/libpurple/xfer.c	Wed Feb 05 23:04:27 2014 +0530
+++ b/libpurple/xfer.c	Thu Feb 06 03:04:43 2014 +0530
@@ -39,48 +39,47 @@
 #define PURPLE_XFER_GET_PRIVATE(obj) \
 	(G_TYPE_INSTANCE_GET_PRIVATE((obj), PURPLE_TYPE_XFER, PurpleXferPrivate))
 
-/** @copydoc _PurpleXferPrivate */
 typedef struct _PurpleXferPrivate  PurpleXferPrivate;
 
 static PurpleXferUiOps *xfer_ui_ops = NULL;
 static GList *xfers;
 
-/** Private data for a file transfer */
+/* Private data for a file transfer */
 struct _PurpleXferPrivate {
-	PurpleXferType type;         /**< The type of transfer.               */
-
-	PurpleAccount *account;      /**< The account.                        */
-
-	char *who;                   /**< The person on the other end of the
-	                                  transfer.                           */
-
-	char *message;               /**< A message sent with the request     */
-	char *filename;              /**< The name sent over the network.     */
-	char *local_filename;        /**< The name on the local hard drive.   */
-	goffset size;                /**< The size of the file.               */
-
-	FILE *dest_fp;               /**< The destination file pointer.       */
-
-	char *remote_ip;             /**< The remote IP address.              */
-	guint16 local_port;          /**< The local port.                     */
-	guint16 remote_port;         /**< The remote port.                    */
-
-	int fd;                      /**< The socket file descriptor.         */
-	int watcher;                 /**< Watcher.                            */
-
-	goffset bytes_sent;          /**< The number of bytes sent.           */
-	goffset bytes_remaining;     /**< The number of bytes remaining.      */
-	time_t start_time;           /**< When the transfer of data began.    */
-	time_t end_time;             /**< When the transfer of data ended.    */
-
-	size_t current_buffer_size;  /**< This gradually increases for fast
-	                                   network connections.               */
-
-	PurpleXferStatus status;     /**< File Transfer's status.             */
-
-	/** I/O operations, which should be set by the prpl using
-	 *  purple_xfer_set_init_fnc() and friends.  Setting #init is
-	 *  mandatory; all others are optional.
+	PurpleXferType type;         /* The type of transfer.               */
+
+	PurpleAccount *account;      /* The account.                        */
+
+	char *who;                   /* The person on the other end of the
+	                                transfer.                           */
+
+	char *message;               /* A message sent with the request     */
+	char *filename;              /* The name sent over the network.     */
+	char *local_filename;        /* The name on the local hard drive.   */
+	goffset size;                /* The size of the file.               */
+
+	FILE *dest_fp;               /* The destination file pointer.       */
+
+	char *remote_ip;             /* The remote IP address.              */
+	guint16 local_port;          /* The local port.                     */
+	guint16 remote_port;         /* The remote port.                    */
+
+	int fd;                      /* The socket file descriptor.         */
+	int watcher;                 /* Watcher.                            */
+
+	goffset bytes_sent;          /* The number of bytes sent.           */
+	goffset bytes_remaining;     /* The number of bytes remaining.      */
+	time_t start_time;           /* When the transfer of data began.    */
+	time_t end_time;             /* When the transfer of data ended.    */
+
+	size_t current_buffer_size;  /* This gradually increases for fast
+	                                 network connections.               */
+
+	PurpleXferStatus status;     /* File Transfer's status.             */
+
+	/* I/O operations, which should be set by the prpl using
+	 * purple_xfer_set_init_fnc() and friends.  Setting #init is
+	 * mandatory; all others are optional.
 	 */
 	struct
 	{
@@ -95,10 +94,10 @@
 		void (*ack)(PurpleXfer *xfer, const guchar *buffer, size_t size);
 	} ops;
 
-	PurpleXferUiOps *ui_ops;     /**< UI-specific operations.             */
+	PurpleXferUiOps *ui_ops;     /* UI-specific operations.             */
 
 	/* TODO Remove this and use protocol-specific subclasses. */
-	void *proto_data;            /**< prpl-specific data.                 */
+	void *proto_data;            /* prpl-specific data.                 */
 
 	/*
 	 * Used to moderate the file transfer when either the read/write ui_ops are
@@ -114,7 +113,7 @@
 	/* TODO: Should really use a PurpleCircBuffer for this. */
 	GByteArray *buffer;
 
-	gpointer thumbnail_data;     /**< thumbnail image */
+	gpointer thumbnail_data;     /* thumbnail image */
 	gsize thumbnail_size;
 	gchar *thumbnail_mimetype;
 };

mercurial