pidgin: a9e9c575: Hide PurpleAttentionType struct and remo...

[qulogic at pidgin.im]

----------------------------------------------------------------------
Revision: a9e9c57562b09436a7773ba28cfe9af3a6de1430
Parent:   147161fa8aec87626d636e36927a9db89cc06a3b
Author:   qulogic at pidgin.im
Date:     09/01/11 23:38:52
Branch:   im.pidgin.pidgin
URL: http://d.pidgin.im/viewmtn/revision/info/a9e9c57562b09436a7773ba28cfe9af3a6de1430

Changelog: 

Hide PurpleAttentionType struct and remove attention @since tags.

Changes against parent 147161fa8aec87626d636e36927a9db89cc06a3b

  patched  ChangeLog.API
  patched  libpurple/prpl.c
  patched  libpurple/prpl.h

-------------- next part --------------
============================================================
--- libpurple/prpl.c	3fe7a8aa8d3ecfdc96d639823a86c3be483e2305
+++ libpurple/prpl.c	1f3856aaf74f2bff0066dc1101d3ace537c40a9e
@@ -32,6 +32,20 @@
 /**************************************************************************/
 /** @name Attention Type API                                              */
 /**************************************************************************/
+
+/** Represents "nudges" and "buzzes" that you may send to a buddy to attract
+ *  their attention (or vice-versa).
+ */
+struct _PurpleAttentionType
+{
+	const char *name;                  /**< Shown in GUI elements */
+	const char *incoming_description;  /**< Shown when sent */
+	const char *outgoing_description;  /**< Shown when receied */
+	const char *icon_name;             /**< Icon to display (optional) */
+	const char *unlocalized_name;      /**< Unlocalized name for UIs needing it */
+};
+
+
 PurpleAttentionType *
 purple_attention_type_new(const char *ulname, const char *name,
 						const char *inc_desc, const char *out_desc)
============================================================
--- libpurple/prpl.h	00ddff21fbb760369b95f999cb7ead428862bfb2
+++ libpurple/prpl.h	a57aa67f9d929d077f1adb697092ec1d78afe758
@@ -111,23 +111,6 @@ struct proto_chat_entry {
 	gboolean secret;         /**< True if the entry is secret (password) */
 };
 
-/** Represents "nudges" and "buzzes" that you may send to a buddy to attract
- *  their attention (or vice-versa).
- */
-struct _PurpleAttentionType
-{
-	const char *name;                  /**< Shown in GUI elements */
-	const char *incoming_description;  /**< Shown when sent */
-	const char *outgoing_description;  /**< Shown when receied */
-	const char *icon_name;             /**< Icon to display (optional) */
-	const char *unlocalized_name;      /**< Unlocalized name for UIs needing it */
-
-	/* Reserved fields for future purposes */
-	gpointer _reserved2;
-	gpointer _reserved3;
-	gpointer _reserved4;
-};
-
 /**
  * Protocol options
  *
@@ -680,8 +663,8 @@ extern "C" {
  *             should be the same string as @a ulname, with localization.
  * @param inc_desc A localized description shown when the event is received.
  * @param out_desc A localized description shown when the event is sent.
+ *
  * @return A pointer to the new object.
- * @since 2.4.0
  */
 PurpleAttentionType *purple_attention_type_new(const char *ulname, const char *name,
 								const char *inc_desc, const char *out_desc);
@@ -693,7 +676,6 @@ PurpleAttentionType *purple_attention_ty
  * @param name The localized name that will be displayed by UIs. This should be
  *             the same string given as the unlocalized name, but with
  *             localization.
- * @since 2.4.0
  */
 void purple_attention_type_set_name(PurpleAttentionType *type, const char *name);
 
@@ -703,7 +685,6 @@ void purple_attention_type_set_name(Purp
  *
  * @param type The attention type.
  * @param desc The localized description for incoming events.
- * @since 2.4.0
  */
 void purple_attention_type_set_incoming_desc(PurpleAttentionType *type, const char *desc);
 
@@ -713,7 +694,6 @@ void purple_attention_type_set_incoming_
  *
  * @param type The attention type.
  * @param desc The localized description for outgoing events.
- * @since 2.4.0
  */
 void purple_attention_type_set_outgoing_desc(PurpleAttentionType *type, const char *desc);
 
@@ -723,7 +703,6 @@ void purple_attention_type_set_outgoing_
  * @param type The attention type.
  * @param name The icon's name.
  * @note Icons are optional for attention events.
- * @since 2.4.0
  */
 void purple_attention_type_set_icon_name(PurpleAttentionType *type, const char *name);
 
@@ -734,7 +713,6 @@ void purple_attention_type_set_icon_name
  * @param type The attention type.
  * @param ulname The unlocalized name.  This should be the same string given as
  *               the localized name, but without localization.
- * @since 2.4.0
  */
 void purple_attention_type_set_unlocalized_name(PurpleAttentionType *type, const char *ulname);
 
@@ -742,8 +720,8 @@ void purple_attention_type_set_unlocaliz
  * Get the attention type's name as displayed by the UI.
  *
  * @param type The attention type.
+ *
  * @return The name.
- * @since 2.4.0
  */
 const char *purple_attention_type_get_name(const PurpleAttentionType *type);
 
@@ -752,7 +730,6 @@ const char *purple_attention_type_get_na
  *
  * @param type The attention type.
  * @return The description.
- * @since 2.4.0
  */
 const char *purple_attention_type_get_incoming_desc(const PurpleAttentionType *type);
 
@@ -761,7 +738,6 @@ const char *purple_attention_type_get_in
  *
  * @param type The attention type.
  * @return The description.
- * @since 2.4.0
  */
 const char *purple_attention_type_get_outgoing_desc(const PurpleAttentionType *type);
 
@@ -771,7 +747,6 @@ const char *purple_attention_type_get_ou
  * @param type The attention type.
  * @return The icon name or @c NULL if unset/empty.
  * @note Icons are optional for attention events.
- * @since 2.4.0
  */
 const char *purple_attention_type_get_icon_name(const PurpleAttentionType *type);
 
@@ -780,7 +755,6 @@ const char *purple_attention_type_get_ic
  *
  * @param type The attention type
  * @return The unlocalized name.
- * @since 2.4.0
  */
 const char *purple_attention_type_get_unlocalized_name(const PurpleAttentionType *type);
 
============================================================
--- ChangeLog.API	13ad8c574c1916bf5b72b35cbedb704ca79e71ca
+++ ChangeLog.API	56f8ef39af2592f4e590909bc4c52697d6c49298
@@ -120,6 +120,7 @@ version 3.0.0 (??/??/????):
 		* serv_got_attention
 		* serv_send_attention
 		* struct _GtkIMHtmlFontDetail
+		* struct _PurpleAttentionType
 		* struct _PurpleMenuAction
 		* struct _PurplePounce
 		* struct _PurpleProxyInfo