diff src/blist.h @ 10071:af06746954de

[gaim-migrate @ 11047] sf patch 1038040: Doxygen Fixes #3 This is from Jonathan Champ (royanee) Thanks! committer: Tailor Script <[e-mail]>

--- a/src/blist.h	Wed Sep 29 15:01:33 2004 +0000
+++ b/src/blist.h	Fri Oct 01 22:08:39 2004 +0000
@@ -212,13 +212,15 @@
 
 /**
  * Creates a new buddy list
+ *
+ * @return The new buddy list.
  */
 GaimBuddyList *gaim_blist_new();
 
 /**
  * Sets the main buddy list.
  *
- * @return The main buddy list.
+ * @param blist The buddy list you want to use.
  */
 void gaim_set_blist(GaimBuddyList *blist);
 
@@ -231,7 +233,6 @@
 
 /**
  * Shows the buddy list, creating a new one if necessary.
- *
  */
 void gaim_blist_show();
 
@@ -591,8 +592,8 @@
 /**
  * Finds the buddy struct given a screenname and an account
  *
+ * @param account The account this buddy belongs to
  * @param name    The buddy's screenname
- * @param account The account this buddy belongs to
  * @return        The buddy or NULL if the buddy does not exist
  */
 GaimBuddy *gaim_find_buddy(GaimAccount *account, const char *name);
@@ -600,8 +601,8 @@
 /**
  * Finds the buddy struct given a screenname, an account, and a group
  *
+ * @param account The account this buddy belongs to
  * @param name    The buddy's screenname
- * @param account The account this buddy belongs to
  * @param group   The group to look in
  * @return        The buddy or NULL if the buddy does not exist in the group
  */
@@ -611,8 +612,8 @@
 /**
  * Finds all GaimBuddy structs given a screenname and an account
  *
+ * @param account The account this buddy belongs to
  * @param name    The buddy's screenname
- * @param account The account this buddy belongs to
  *
  * @return        A GSList of buddies (which must be freed), or NULL if the buddy doesn't exist
  */