Minor comment fiddling.

Fri, 06 Dec 2013 00:10:21 -0800

author
Mark Doliner <mark@kingant.net>
date
Fri, 06 Dec 2013 00:10:21 -0800
changeset 35097
0d6a2ff4f776
parent 35096
5c2d69863fa0
child 35098
905d15638e6c

Minor comment fiddling.

These "TODO" comments are really intended for us, where as the
/** doc style */ comments are intended for 3rd party devs. So
move the TODOs into a separate comment.

libpurple/connection.c file | annotate | diff | comparison | revisions
libpurple/roomlist.c file | annotate | diff | comparison | revisions
libpurple/whiteboard.c file | annotate | diff | comparison | revisions
libpurple/xfer.c file | annotate | diff | comparison | revisions
--- a/libpurple/connection.c	Fri Dec 06 00:04:30 2013 -0800
+++ b/libpurple/connection.c	Fri Dec 06 00:10:21 2013 -0800
@@ -65,9 +65,9 @@
 
 	GSList *active_chats;         /**< A list of active chats
 	                                  (#PurpleChatConversation structs). */
-	void *proto_data;             /**< Protocol-specific data.            
-	                                  TODO Remove this, and use
-	                                       protocol-specific subclasses  */
+
+	/* TODO Remove this and use protocol-specific subclasses. */
+	void *proto_data;             /**< Protocol-specific data.           */
 
 	char *display_name;           /**< How you appear to other people.   */
 	guint keepalive;              /**< Keep-alive.                       */
--- a/libpurple/roomlist.c	Fri Dec 06 00:04:30 2013 -0800
+++ b/libpurple/roomlist.c	Fri Dec 06 00:10:21 2013 -0800
@@ -46,9 +46,9 @@
 	GList *fields;           /**< The fields.                       */
 	GList *rooms;            /**< The list of rooms.                */
 	gboolean in_progress;    /**< The listing is in progress.       */
-	gpointer proto_data;     /** Protocol private data.
-	                             TODO Remove this, and use
-	                                  protocol-specific subclasses  */
+
+	/* TODO Remove this and use protocol-specific subclasses. */
+	gpointer proto_data;     /** Protocol private data.             */
 };
 
 /**
--- a/libpurple/whiteboard.c	Fri Dec 06 00:04:30 2013 -0800
+++ b/libpurple/whiteboard.c	Fri Dec 06 00:10:21 2013 -0800
@@ -40,9 +40,9 @@
 	PurpleAccount *account;         /**< Account associated with this session */
 	char *who;                      /**< Name of the remote user              */
 
-	void *proto_data;               /**< Protocol specific data
-	                                     TODO Remove this, and use
-	                                          protocol-specific subclasses    */
+	/* TODO Remove this and use protocol-specific subclasses. */
+	void *proto_data;               /**< Protocol specific data               */
+
 	PurpleWhiteboardPrplOps *prpl_ops; /**< Protocol-plugin operations        */
 
 	GList *draw_list;               /**< List of drawing elements/deltas to
--- a/libpurple/xfer.c	Fri Dec 06 00:04:30 2013 -0800
+++ b/libpurple/xfer.c	Fri Dec 06 00:10:21 2013 -0800
@@ -100,9 +100,8 @@
 
 	PurpleXferUiOps *ui_ops;     /**< UI-specific operations.             */
 
-	void *proto_data;            /**< prpl-specific data.
-	                                  TODO Remove this, and use
-	                                       protocol-specific subclasses   */
+	/* TODO Remove this and use protocol-specific subclasses. */
+	void *proto_data;            /**< prpl-specific data.                 */
 
 	/*
 	 * Used to moderate the file transfer when either the read/write ui_ops are

mercurial