# HG changeset patch
# User Paul Aurich <paul@darkrain42.org>
# Date 1229897543 0
# Node ID a4d6e2c1e73bd365ee92f9c511969a259d944ee0
# Parent  071414f413a4628a9af7e826db7ed4125d7083ab
Update the comment for add_buddy in prpl.h to note it may be called to mean 'request authorization'

diff -r 071414f413a4 -r a4d6e2c1e73b libpurple/prpl.h
--- a/libpurple/prpl.h	Sun Dec 21 22:11:46 2008 +0000
+++ b/libpurple/prpl.h	Sun Dec 21 22:12:23 2008 +0000
@@ -294,6 +294,14 @@
 	void (*set_idle)(PurpleConnection *, int idletime);
 	void (*change_passwd)(PurpleConnection *, const char *old_pass,
 						  const char *new_pass);
+	/**
+	 * Add a buddy to a group on the server.
+	 *
+	 * This PRPL function may be called in situations in which the buddy is
+	 * already in the specified group. If the protocol supports
+	 * authorization and the user is not already authorized to see the
+	 * status of \a buddy, \a add_buddy should request authorization.
+	 */
 	void (*add_buddy)(PurpleConnection *, PurpleBuddy *buddy, PurpleGroup *group);
 	void (*add_buddies)(PurpleConnection *, GList *buddies, GList *groups);
 	void (*remove_buddy)(PurpleConnection *, PurpleBuddy *buddy, PurpleGroup *group);