changeset 10233:e8d62dc363c5

[gaim-migrate @ 11368] Doxygenation updates from me. committer: Tailor Script <[e-mail]>

--- a/src/desktopitem.h	Mon Nov 22 04:59:40 2004 +0000
+++ b/src/desktopitem.h	Mon Nov 22 05:10:00 2004 +0000
@@ -1,5 +1,5 @@
 /**
- * @file gaim-desktop-item.h Functions for managing .desktop files
+ * @file desktopitem.h Functions for managing .desktop files
  * @ingroup core
  *
  * Gaim is the legal property of its developers, whose names are too numerous

--- a/src/gtkrequest.c	Mon Nov 22 04:59:40 2004 +0000
+++ b/src/gtkrequest.c	Mon Nov 22 05:10:00 2004 +0000
@@ -435,7 +435,7 @@
 	GtkWidget *radio = NULL;
 	char *label_text;
 	char *radio_text;
-	
+
 	data            = g_new0(GaimGtkRequestData, 1);
 	data->type      = GAIM_REQUEST_ACTION;
 	data->user_data = user_data;
@@ -454,7 +454,7 @@
 
 	gtk_dialog_add_button(GTK_DIALOG(dialog),
 			      text_to_stock(cancel_text), 0);
-	
+
 	gtk_dialog_add_button(GTK_DIALOG(dialog),
 			      text_to_stock(ok_text), 1);
 
@@ -481,14 +481,14 @@
 	/* Vertical box */
 	vbox = gtk_vbox_new(FALSE, 12);
 	gtk_box_pack_start(GTK_BOX(hbox), vbox, FALSE, FALSE, 0);
-	
+
 	/* Descriptive label */
 	label_text = g_strdup_printf((primary ? "<span weight=\"bold\" size=\"larger\">"
 				      "%s</span>%s%s" : "%s%s%s"),
 				     (primary ? primary : ""),
 				     ((primary && secondary) ? "\n\n" : ""),
 				     (secondary ? secondary : ""));
-	
+
 	label = gtk_label_new(NULL);
 
 	gtk_label_set_markup(GTK_LABEL(label), label_text);
@@ -497,7 +497,7 @@
 	gtk_box_pack_start(GTK_BOX(vbox), label, TRUE, TRUE, 0);
 
 	g_free(label_text);
-	
+
 	vbox2 = gtk_vbox_new(FALSE, 6);
 	gtk_box_pack_start(GTK_BOX(vbox), vbox2, FALSE, FALSE, 0);
 	while ((radio_text = va_arg(args, char*))) {
@@ -508,7 +508,7 @@
 		       if (resp == default_value)
 			       gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(radio), TRUE);
 	}
-	 
+
 	g_object_set_data(G_OBJECT(dialog), "radio", radio);
 
 	/* Show everything. */

--- a/src/gtkutils.h	Mon Nov 22 04:59:40 2004 +0000
+++ b/src/gtkutils.h	Mon Nov 22 05:10:00 2004 +0000
@@ -361,7 +361,7 @@
  * Manages drag'n'drop of files.
  *
  * @param sd GtkSelectionData for managing drag'n'drop
- * @param gc Connection to be used (may be NULL if conv is not NULL)
+ * @param account Account to be used (may be NULL if conv is not NULL)
  * @param who Buddy name (may be NULL if conv is not NULL)
  */
 void gaim_dnd_file_manage(GtkSelectionData *sd, GaimAccount *account, const char *who);

--- a/src/request.h	Mon Nov 22 04:59:40 2004 +0000
+++ b/src/request.h	Mon Nov 22 05:10:00 2004 +0000
@@ -1107,8 +1107,8 @@
  * @param cancel_text   The text for the cancel button.
  * @param cancel_cb     The callback for the cancel button.
  * @param user_data     The data to pass to the callback.
- * @param choice_count  The number of choices.
- * @param ...           The choices.
+ * @param ...           The choices.  This argument list should be
+ *                      terminated with a NULL parameter.
  *
  * @return A UI-specific handle.
  */
@@ -1132,8 +1132,8 @@
  * @param cancel_text   The text for the cancel button.
  * @param cancel_cb     The callback for the cancel button.
  * @param user_data     The data to pass to the callback.
- * @param choice_count  The number of choices.
- * @param choices       The choices.
+ * @param choices       The choices.  This argument list should be
+ *                      terminated with a NULL parameter.
  *
  * @return A UI-specific handle.
  */