Finish an imcomplete doc comment and clean up the wording on another

Fri, 10 May 2019 18:51:25 -0500

author
Gary Kramlich <grim@reaperworld.com>
date
Fri, 10 May 2019 18:51:25 -0500
changeset 39596
17d54aaad818
parent 39595
0c9f3c4f1afb
child 39597
bd90a84a84a4

Finish an imcomplete doc comment and clean up the wording on another

libpurple/protocol.h file | annotate | diff | comparison | revisions
--- a/libpurple/protocol.h	Fri May 10 18:45:10 2019 -0500
+++ b/libpurple/protocol.h	Fri May 10 18:51:25 2019 -0500
@@ -857,9 +857,11 @@
  * purple_protocol_client_iface_tooltip_text:
  * @protocol: The #PurpleProtocol instance.
  * @buddy: The #PurpleBuddy instance.
- * @user_info:
- * @full:
+ * @user_info: The #PurpleNotifyUserInfo instance.
+ * @full: Whether or not additional info should be added.
  *
+ * Asks @protocol to update @user_info for @buddy.  If @full is %TRUE then
+ * more detailed information will added.
  */
 void purple_protocol_client_iface_tooltip_text(PurpleProtocol *protocol,
 		PurpleBuddy *buddy, PurpleNotifyUserInfo *user_info, gboolean full);
@@ -1019,8 +1021,8 @@
  * @protocol: The #PurpleProtocol instance.
  * @connection: The #PurpleConnection instance.
  *
- * Returns the list of #PurpleProtocolChatEntry's that should be used to join
- * a multi user chat.
+ * Gets the list of #PurpleProtocolChatEntry's that are required to join a
+ * multi user chat.
  *
  * Returns: (transfer full) (element-type PurpleProtocolChatEntry): The list
  *          of #PurpleProtocolChatEntry's that are used to join a chat.

mercurial