diff src/protocols/qq/group_opt.c @ 14021:ef8490f9e823

[gaim-migrate @ 16618] Replaced all C++-style comments with C-style ones. Cleaned up some comments and implemented a more consistent formatting scheme. committer: Tailor Script <[e-mail]>

--- a/src/protocols/qq/group_opt.c	Wed Aug 02 13:37:13 2006 +0000
+++ b/src/protocols/qq/group_opt.c	Wed Aug 02 15:35:36 2006 +0000
@@ -20,28 +20,25 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
-// START OF FILE
-/*****************************************************************************/
-#include "debug.h"		// gaim_debug
-#include "notify.h"		// gaim_notify_info
-#include "request.h"		// gaim_request_input
+#include "debug.h"
+#include "notify.h"
+#include "request.h"
 
-#include "utils.h"		// uid_to_gaim_name
-#include "packet_parse.h"	// create_packet_b
-#include "buddy_info.h"		// qq_send_packet_get_info
-#include "char_conv.h"		// utf8_to_qq
-//#include "group_admindlg.h"	// qq_group_detail_window_show
-#include "group_find.h"		// qq_group_find_by_internal_group_id
-#include "group_hash.h"		// qq_group_refresh
-#include "group_info.h"		// qq_send_cmd_group_get_group_info
-#include "group_join.h"		// qq_send_cmd_group_auth
-#include "group_network.h"	// qq_send_group_cmd
+#include "buddy_info.h"
+#include "char_conv.h"
+/*#include "group_admindlg.h"	*/
+#include "group_find.h"
+#include "group_hash.h"
+#include "group_info.h"
+#include "group_join.h"
+#include "group_network.h"
 #include "group_opt.h"
+#include "packet_parse.h"
 #include "qq.h"
+#include "utils.h"
 
-/*****************************************************************************/
-// This implement quick sort algorithm (low->high)
-static void _quick_sort(gint * numbers, gint left, gint right)
+/* This implement quick sort algorithm (low->high) */
+static void _quick_sort(gint *numbers, gint left, gint right)
 {
 	gint pivot, l_hold, r_hold;
 
@@ -54,14 +51,14 @@
 		if (left != right) {
 			numbers[left] = numbers[right];
 			left++;
-		}		// if
+		}
 		while ((numbers[left] <= pivot) && (left < right))
 			left++;
 		if (left != right) {
 			numbers[right] = numbers[left];
 			right--;
-		}		// if
-	}			// while
+		}
+	}
 	numbers[left] = pivot;
 	pivot = left;
 	left = l_hold;
@@ -70,19 +67,18 @@
 		_quick_sort(numbers, left, pivot - 1);
 	if (right > pivot)
 		_quick_sort(numbers, pivot + 1, right);
-}				// _quick_sort
+}
 
-/*****************************************************************************/
-static void _sort(guint32 * list)
+static void _sort(guint32 *list)
 {
 	gint i;
 	for (i = 0; list[i] < 0xffffffff; i++) {;
 	}
 	_quick_sort(list, 0, i - 1);
-}				// _sort
+}
 
-/*****************************************************************************/
-static void _qq_group_member_opt(GaimConnection * gc, qq_group * group, gint operation, guint32 * members) {
+static void _qq_group_member_opt(GaimConnection *gc, qq_group *group, gint operation, guint32 *members)
+{
 	guint8 *data, *cursor;
 	gint i, count, data_len;
 	g_return_if_fail(gc != NULL && group != NULL && members != NULL);
@@ -99,17 +95,15 @@
 	for (i = 0; i < count; i++)
 		create_packet_dw(data, &cursor, members[i]);
 	qq_send_group_cmd(gc, group, data, data_len);
-}				// _qq_group_member_opt
+}
 
-/*****************************************************************************/
-static void _qq_group_do_nothing_with_struct(group_member_opt * g)
+static void _qq_group_do_nothing_with_struct(group_member_opt *g)
 {
 	if (g != NULL)
 		g_free(g);
-}				// _qq_group_do_nothing_with_struct
+}
 
-/*****************************************************************************/
-static void _qq_group_reject_application_real(group_member_opt * g, gchar * msg_utf8)
+static void _qq_group_reject_application_real(group_member_opt *g, gchar *msg_utf8)
 {
 	qq_group *group;
 	g_return_if_fail(g != NULL && g->gc != NULL && g->internal_group_id > 0 && g->member > 0);
@@ -117,24 +111,21 @@
 	g_return_if_fail(group != NULL);
 	qq_send_cmd_group_auth(g->gc, group, QQ_GROUP_AUTH_REQUEST_REJECT, g->member, msg_utf8);
 	g_free(g);
-}				// _qq_group_reject_application_real
+}
 
-/*****************************************************************************/
-void qq_group_search_application_with_struct(group_member_opt * g)
+void qq_group_search_application_with_struct(group_member_opt *g)
 {
 	g_return_if_fail(g != NULL && g->gc != NULL && g->member > 0);
 
-	qq_send_packet_get_info(g->gc, g->member, TRUE);	// we wanna see window
+	qq_send_packet_get_info(g->gc, g->member, TRUE);	/* we wanna see window */
 	gaim_request_action
 	    (g->gc, NULL, _("Do you wanna approve the request?"), "", 2, g,
 	     2, _("Reject"),
 	     G_CALLBACK(qq_group_reject_application_with_struct),
 	     _("Approve"), G_CALLBACK(qq_group_approve_application_with_struct));
-
-}				// qq_group_search_application_with_struct
+}
 
-/*****************************************************************************/
-void qq_group_reject_application_with_struct(group_member_opt * g)
+void qq_group_reject_application_with_struct(group_member_opt *g)
 {
 	gchar *msg1, *msg2;
 	g_return_if_fail(g != NULL && g->gc != NULL && g->member > 0);
@@ -150,11 +141,9 @@
 
 	g_free(msg1);
 	g_free(msg2);
-
-}				// qq_group_do_nothing_with_struct
+}
 
-/*****************************************************************************/
-void qq_group_approve_application_with_struct(group_member_opt * g)
+void qq_group_approve_application_with_struct(group_member_opt *g)
 {
 	qq_group *group;
 	g_return_if_fail(g != NULL && g->gc != NULL && g->internal_group_id > 0 && g->member > 0);
@@ -163,10 +152,10 @@
 	qq_send_cmd_group_auth(g->gc, group, QQ_GROUP_AUTH_REQUEST_APPROVE, g->member, "");
 	qq_group_find_or_add_member(g->gc, group, g->member);
 	g_free(g);
-}				// qq_group_add_member_with_gc_and_uid
+}
 
-/*****************************************************************************/
-void qq_group_modify_members(GaimConnection * gc, qq_group * group, guint32 * new_members) {
+void qq_group_modify_members(GaimConnection *gc, qq_group *group, guint32 *new_members)
+{
 	guint32 *old_members, *del_members, *add_members;
 	qq_buddy *q_bud;
 	qq_data *qd;
@@ -182,32 +171,32 @@
 	del_members = g_newa(guint32, QQ_QUN_MEMBER_MAX);
 	add_members = g_newa(guint32, QQ_QUN_MEMBER_MAX);
 
-	// construct the old member list
+	/* construct the old member list */
 	list = group->members;
 	while (list != NULL) {
 		q_bud = (qq_buddy *) list->data;
 		if (q_bud != NULL)
 			old_members[i++] = q_bud->uid;
 		list = list->next;
-	}			// while
-	old_members[i] = 0xffffffff;	// this is the end
+	}
+	old_members[i] = 0xffffffff;	/* this is the end */
 
-	// sort to speed up making del_members and add_members list
+	/* sort to speed up making del_members and add_members list */
 	_sort(old_members);
 	_sort(new_members);
 
 	for (old = 0, new = 0; old_members[old] < 0xffffffff || new_members[new] < 0xffffffff;) {
-		if (old_members[old] > new_members[new])
+		if (old_members[old] > new_members[new]) {
 			add_members[add++] = new_members[new++];
-		else if (old_members[old] < new_members[new])
+		} else if (old_members[old] < new_members[new]) {
 			del_members[del++] = old_members[old++];
-		else {
+		} else {
 			if (old_members[old] < 0xffffffff)
 				old++;
 			if (new_members[new] < 0xffffffff)
 				new++;
-		}		// if old_members, new_members
-	}			// for old,new
+		}
+	}
 	del_members[del] = add_members[add] = 0xffffffff;
 
 	for (i = 0; i < del; i++)
@@ -219,11 +208,10 @@
 		_qq_group_member_opt(gc, group, QQ_GROUP_MEMBER_DEL, del_members);
 	if (add > 0)
 		_qq_group_member_opt(gc, group, QQ_GROUP_MEMBER_ADD, add_members);
-
-}				// qq_group_modify_members
+}
 
-/*****************************************************************************/
-void qq_group_process_modify_members_reply(guint8 * data, guint8 ** cursor, gint len, GaimConnection * gc) {
+void qq_group_process_modify_members_reply(guint8 *data, guint8 **cursor, gint len, GaimConnection *gc)
+{
 	guint32 internal_group_id;
 	qq_group *group;
 	g_return_if_fail(data != NULL && gc != NULL);
@@ -231,18 +219,17 @@
 	read_packet_dw(data, cursor, len, &internal_group_id);
 	g_return_if_fail(internal_group_id > 0);
 
-	// we should have its info locally
+	/* we should have its info locally */
 	group = qq_group_find_by_internal_group_id(gc, internal_group_id);
 	g_return_if_fail(group != NULL);
 
 	gaim_debug(GAIM_DEBUG_INFO, "QQ", "Succeed in modify members for Qun %d\n", group->external_group_id);
 
 	gaim_notify_info(gc, _("QQ Qun Operation"), _("You have successfully modify Qun member"), NULL);
-
-}				// qq_group_process_modify_members_reply
+}
 
 /*****************************************************************************/
-void qq_group_modify_info(GaimConnection * gc, qq_group * group)
+void qq_group_modify_info(GaimConnection *gc, qq_group *group)
 {
 	gint data_len, data_written;
 	guint8 *data, *cursor;
@@ -261,17 +248,17 @@
 	data = g_newa(guint8, data_len);
 	cursor = data;
 	data_written = 0;
-	// 000-000
+	/* 000-000 */
 	data_written += create_packet_b(data, &cursor, QQ_GROUP_CMD_MODIFY_GROUP_INFO);
-	// 001-004
+	/* 001-004 */
 	data_written += create_packet_dw(data, &cursor, group->internal_group_id);
-	// 005-005
+	/* 005-005 */
 	data_written += create_packet_b(data, &cursor, 0x01);
-	// 006-006
+	/* 006-006 */
 	data_written += create_packet_b(data, &cursor, group->auth_type);
-	// 007-008
+	/* 007-008 */
 	data_written += create_packet_w(data, &cursor, 0x0000);
-	// 009-010
+	/* 009-010 */
 	data_written += create_packet_w(data, &cursor, group->group_category);
 
 	data_written += create_packet_b(data, &cursor, strlen(group_name));
@@ -291,11 +278,10 @@
 			   data_len, data_written);
 	else
 		qq_send_group_cmd(gc, group, data, data_len);
-
-}				// qq_group_modify_info
+}
 
-/*****************************************************************************/
-void qq_group_process_modify_info_reply(guint8 * data, guint8 ** cursor, gint len, GaimConnection * gc) {
+void qq_group_process_modify_info_reply(guint8 *data, guint8 **cursor, gint len, GaimConnection *gc)
+{
 	guint32 internal_group_id;
 	qq_group *group;
 	g_return_if_fail(data != NULL && gc != NULL);
@@ -303,7 +289,7 @@
 	read_packet_dw(data, cursor, len, &internal_group_id);
 	g_return_if_fail(internal_group_id > 0);
 
-	// we should have its info locally
+	/* we should have its info locally */
 	group = qq_group_find_by_internal_group_id(gc, internal_group_id);
 	g_return_if_fail(group != NULL);
 
@@ -311,12 +297,10 @@
 	qq_group_refresh(gc, group);
 
 	gaim_notify_info(gc, _("QQ Qun Operation"), _("You have successfully modify Qun information"), NULL);
-
-}				// qq_group_process_modify_info_reply
+}
 
-/*****************************************************************************/
-// we create a very simple group first, and then let the user to modify
-void qq_group_create_with_name(GaimConnection * gc, const gchar * name)
+/* we create a very simple group first, and then let the user to modify */
+void qq_group_create_with_name(GaimConnection *gc, const gchar *name)
 {
 	gint data_len, data_written;
 	guint8 *data, *cursor;
@@ -329,24 +313,24 @@
 	cursor = data;
 
 	data_written = 0;
-	// we create the simpleset group, only group name is given
-	// 000
+	/* we create the simpleset group, only group name is given */
+	/* 000 */
 	data_written += create_packet_b(data, &cursor, QQ_GROUP_CMD_CREATE_GROUP);
-	// 001
+	/* 001 */
 	data_written += create_packet_b(data, &cursor, QQ_GROUP_TYPE_PERMANENT);
-	// 002
+	/* 002 */
 	data_written += create_packet_b(data, &cursor, QQ_GROUP_AUTH_TYPE_NEED_AUTH);
-	// 003-004
+	/* 003-004 */
 	data_written += create_packet_w(data, &cursor, 0x0000);
-	// 005-006
+	/* 005-006 */
 	data_written += create_packet_w(data, &cursor, 0x0003);
-	// 007
+	/* 007 */
 	data_written += create_packet_b(data, &cursor, strlen(name));
 	data_written += create_packet_data(data, &cursor, (gchar *) name, strlen(name));
 	data_written += create_packet_w(data, &cursor, 0x0000);
-	data_written += create_packet_b(data, &cursor, 0x00);	// no group notice
-	data_written += create_packet_b(data, &cursor, 0x00);	// no group desc
-	data_written += create_packet_dw(data, &cursor, qd->uid);	// I am member of coz
+	data_written += create_packet_b(data, &cursor, 0x00);	/* no group notice */
+	data_written += create_packet_b(data, &cursor, 0x00);	/* no group desc */
+	data_written += create_packet_dw(data, &cursor, qd->uid);	/* I am member of coz */
 
 	if (data_written != data_len)
 		gaim_debug(GAIM_DEBUG_ERROR, "QQ",
@@ -354,11 +338,9 @@
 			   data_len, data_written);
 	else
 		qq_send_group_cmd(gc, NULL, data, data_len);
-
-}				// qq_group_create_with_name
+}
 
-/*****************************************************************************/
-static void qq_group_setup_with_gc_and_uid(gc_and_uid * g)
+static void qq_group_setup_with_gc_and_uid(gc_and_uid *g)
 {
 	qq_group *group;
 	g_return_if_fail(g != NULL && g->gc != NULL && g->uid > 0);
@@ -366,13 +348,13 @@
 	group = qq_group_find_by_internal_group_id(g->gc, g->uid);
 	g_return_if_fail(group != NULL);
 
-	//XXX insert UI code here
-	//qq_group_detail_window_show(g->gc, group);
+	/* XXX insert UI code here */
+	/* qq_group_detail_window_show(g->gc, group); */
 	g_free(g);
-}				// qq_group_setup_with_gc_and_uid
+}
 
-/*****************************************************************************/
-void qq_group_process_create_group_reply(guint8 * data, guint8 ** cursor, gint len, GaimConnection * gc) {
+void qq_group_process_create_group_reply(guint8 *data, guint8 **cursor, gint len, GaimConnection *gc)
+{
 	guint32 internal_group_id, external_group_id;
 	qq_group *group;
 	gc_and_uid *g;
@@ -407,12 +389,10 @@
 			    1, g, 2, _("Setup"),
 			    G_CALLBACK(qq_group_setup_with_gc_and_uid),
 			    _("Cancel"), G_CALLBACK(qq_do_nothing_with_gc_and_uid));
-
-}				// qq_group_process_modify_info_reply
+}
 
-/*****************************************************************************/
-// we have to activate group after creation, otherwise the group can not be searched
-void qq_group_activate_group(GaimConnection * gc, guint32 internal_group_id)
+/* we have to activate group after creation, otherwise the group can not be searched */
+void qq_group_activate_group(GaimConnection *gc, guint32 internal_group_id)
 {
 	gint data_len, data_written;
 	guint8 *data, *cursor;
@@ -423,10 +403,10 @@
 	cursor = data;
 
 	data_written = 0;
-	// we create the simpleset group, only group name is given
-	// 000
+	/* we create the simplest group, only group name is given */
+	/* 000 */
 	data_written += create_packet_b(data, &cursor, QQ_GROUP_CMD_ACTIVATE_GROUP);
-	// 001-005
+	/* 001-005 */
 	data_written += create_packet_dw(data, &cursor, internal_group_id);
 
 	if (data_written != data_len)
@@ -435,11 +415,10 @@
 			   data_len, data_written);
 	else
 		qq_send_group_cmd(gc, NULL, data, data_len);
-
-}				// qq_group_activate_group
+}
 
-/*****************************************************************************/
-void qq_group_process_activate_group_reply(guint8 * data, guint8 ** cursor, gint len, GaimConnection * gc) {
+void qq_group_process_activate_group_reply(guint8 *data, guint8 **cursor, gint len, GaimConnection *gc)
+{
 	guint32 internal_group_id;
 	qq_group *group;
 	g_return_if_fail(data != NULL && gc != NULL);
@@ -447,16 +426,14 @@
 	read_packet_dw(data, cursor, len, &internal_group_id);
 	g_return_if_fail(internal_group_id > 0);
 
-	// we should have its info locally
+	/* we should have its info locally */
 	group = qq_group_find_by_internal_group_id(gc, internal_group_id);
 	g_return_if_fail(group != NULL);
 
 	gaim_debug(GAIM_DEBUG_INFO, "QQ", "Succeed in activate Qun %d\n", group->external_group_id);
-
-}				// qq_group_process_activate_group_reply
+}
 
-/*****************************************************************************/
-void qq_group_manage_group(GaimConnection * gc, GHashTable * data)
+void qq_group_manage_group(GaimConnection *gc, GHashTable *data)
 {
 	gchar *internal_group_id_ptr;
 	guint32 internal_group_id;
@@ -471,11 +448,6 @@
 	group = qq_group_find_by_internal_group_id(gc, internal_group_id);
 	g_return_if_fail(group != NULL);
 
-	//XXX insert UI code here
-	//qq_group_detail_window_show(gc, group);
-
-}				// qq_group_manage_members
-
-
-/*****************************************************************************/
-// END OF FILE
+	/* XXX insert UI code here */
+	/* qq_group_detail_window_show(gc, group); */
+}