pidgin: 0df672d1: Clean the API documentation in preparati...
andrew.victor at mxit.com
andrew.victor at mxit.com
Sun Sep 25 15:00:52 EDT 2011
----------------------------------------------------------------------
Revision: 0df672d13b5e116b2ab4c1ecea3f3646d497a64a
Parent: 4e865b10122889b3e50c3d15bb512428239cb1d2
Author: andrew.victor at mxit.com
Date: 09/25/11 14:56:58
Branch: im.pidgin.pidgin
URL: http://d.pidgin.im/viewmtn/revision/info/0df672d13b5e116b2ab4c1ecea3f3646d497a64a
Changelog:
Clean the API documentation in preparation for 3.0.0 by removing all the old @since tags.
Changes against parent 4e865b10122889b3e50c3d15bb512428239cb1d2
patched doc/account-signals.dox
patched doc/blist-signals.dox
patched doc/connection-signals.dox
patched doc/conversation-signals.dox
patched doc/gtkconv-signals.dox
patched doc/notify-signals.dox
patched finch/gntaccount.h
patched finch/gntblist.h
patched finch/gntrequest.h
patched finch/gntsound.h
patched libpurple/account.h
patched libpurple/blist.h
patched libpurple/certificate.h
patched libpurple/cmds.h
patched libpurple/connection.h
patched libpurple/conversation.h
patched libpurple/core.h
patched libpurple/dbus-server.h
patched libpurple/debug.h
patched libpurple/eventloop.h
patched libpurple/ft.h
patched libpurple/log.h
patched libpurple/media/backend-fs2.h
patched libpurple/media/backend-iface.h
patched libpurple/media/candidate.h
patched libpurple/media/codec.h
patched libpurple/media/enum-types.h
patched libpurple/media-gst.h
patched libpurple/media.h
patched libpurple/mediamanager.h
patched libpurple/network.h
patched libpurple/notify.h
patched libpurple/plugin.h
patched libpurple/pounce.h
patched libpurple/prefs.h
patched libpurple/proxy.h
patched libpurple/prpl.h
patched libpurple/purple.h.in
patched libpurple/request.h
patched libpurple/roomlist.h
patched libpurple/smiley.h
patched libpurple/sslconn.h
patched libpurple/version.h.in
patched pidgin/gtkblist.h
patched pidgin/gtkconv.h
patched pidgin/gtkimhtml.c
patched pidgin/gtkimhtml.h
patched pidgin/gtkimhtmltoolbar.h
patched pidgin/gtkprefs.h
patched pidgin/gtksmiley.c
patched pidgin/gtksmiley.h
patched pidgin/gtksound.h
patched pidgin/gtkthemes.h
patched pidgin/gtkutils.h
patched pidgin/pidgintooltip.h
-------------- next part --------------
============================================================
--- libpurple/proxy.h 225d58e9ed990d6f8a29f2e297898a800cc83fb3
+++ libpurple/proxy.h 8accbffb37e646594884b153827cd44da9cc905b
@@ -182,7 +182,6 @@ PurpleProxyInfo *purple_global_proxy_get
* Set purple's global proxy information.
*
* @param info The proxy information.
- * @since 2.6.0
*/
void purple_global_proxy_set_info(PurpleProxyInfo *info);
============================================================
--- libpurple/prpl.h 6fca2ef4eeac9000d7a369c481848870e2bcd3aa
+++ libpurple/prpl.h c4fa00ba5df1000f637df6e40b8d764dd2436b94
@@ -186,14 +186,12 @@ typedef enum
/**
* Indicates that slash commands are native to this protocol.
* Used as a hint that unknown commands should not be sent as messages.
- * @since 2.1.0
*/
OPT_PROTO_SLASH_COMMANDS_NATIVE = 0x00000400,
/**
* Indicates that this protocol supports sending a user-supplied message
* along with an invitation.
- * @since 2.8.0
*/
OPT_PROTO_INVITE_MESSAGE = 0x00000800
@@ -571,7 +569,6 @@ struct _PurplePluginProtocolInfo
/**
* Returns an array of "PurpleMood"s, with the last one having
* "mood" set to @c NULL.
- * @since 2.7.0
*/
PurpleMood *(*get_moods)(PurpleAccount *account);
@@ -591,7 +588,6 @@ struct _PurplePluginProtocolInfo
* @param failure_cb Callback to be called if setting the public alias
* fails
* @see purple_account_set_public_alias
- * @since 2.7.0
*/
void (*set_public_alias)(PurpleConnection *gc, const char *alias,
PurpleSetPublicAliasSuccessCallback success_cb,
@@ -608,7 +604,6 @@ struct _PurplePluginProtocolInfo
* @param failure_cb Callback to be called if the prpl is unable to
* retrieve the alias
* @see purple_account_get_public_alias
- * @since 2.7.0
*/
void (*get_public_alias)(PurpleConnection *gc,
PurpleGetPublicAliasSuccessCallback success_cb,
@@ -792,7 +787,6 @@ void purple_prpl_got_account_status(Purp
* @param account The account.
*
* @see account-actions-changed
- * @since 2.6.0
*/
void purple_prpl_got_account_actions(PurpleAccount *account);
@@ -883,8 +877,6 @@ GList *purple_prpl_get_statuses(PurpleAc
*
* Note that you can't send arbitrary PurpleAttentionType's, because there is
* only a fixed set of attention commands.
- *
- * @since 2.5.0
*/
void purple_prpl_send_attention(PurpleConnection *gc, const char *who, guint type_code);
@@ -895,8 +887,6 @@ void purple_prpl_send_attention(PurpleCo
* @param who Who requested your attention.
* @param type_code An index into the prpl's attention_types list determining the type
* of the attention request command to send.
- *
- * @since 2.5.0
*/
void purple_prpl_got_attention(PurpleConnection *gc, const char *who, guint type_code);
@@ -908,8 +898,6 @@ void purple_prpl_got_attention(PurpleCon
* @param who Who requested your attention.
* @param type_code An index into the prpl's attention_types list determining the type
* of the attention request command to send.
- *
- * @since 2.5.0
*/
void purple_prpl_got_attention_in_chat(PurpleConnection *gc, int id, const char *who, guint type_code);
@@ -944,7 +932,6 @@ gboolean purple_prpl_initiate_media(Purp
*
* @param account The account the user is on.
* @param who The name of the contact for which capabilities have been received.
- * @since 2.7.0
*/
void purple_prpl_got_media_caps(PurpleAccount *account, const char *who);
============================================================
--- pidgin/gtkimhtml.c 7f48dca667aa765d4c428ebf8554db811452a8e9
+++ pidgin/gtkimhtml.c 8582542bb005869a469c102865df4937898cbaab
@@ -3979,8 +3979,6 @@ animate_image_cb(gpointer data)
* @param id The id to associate with the image.
*
* @return A new IM/HTML Scalable object with an image.
- *
- * @since 2.1.0
*/
/*
* TODO: All this animation code could be combined much better with
============================================================
--- pidgin/gtkimhtml.h e556ff88ccfcdf77c592839183a90c09ec42cf9a
+++ pidgin/gtkimhtml.h 3f9fdaf82449f461aababab5acdcc786b48bc408
@@ -58,9 +58,6 @@ typedef struct _GtkIMHtmlFuncs GtkIMHtm
typedef struct _GtkIMHtmlHr GtkIMHtmlHr;
typedef struct _GtkIMHtmlFuncs GtkIMHtmlFuncs;
-/**
- * @since 2.6.0
- */
typedef struct _GtkIMHtmlLink GtkIMHtmlLink;
typedef enum {
@@ -78,7 +75,7 @@ typedef enum {
GTK_IMHTML_SMILEY = 1 << 11,
GTK_IMHTML_LINKDESC = 1 << 12,
GTK_IMHTML_STRIKE = 1 << 13,
- /** Show custom smileys when appropriate. @since 2.5.0 */
+ /** Show custom smileys when appropriate. */
GTK_IMHTML_CUSTOM_SMILEY = 1 << 14,
GTK_IMHTML_ALL = -1
} GtkIMHtmlButtons;
@@ -166,8 +163,8 @@ struct _GtkIMHtmlSmiley {
GSList *anchors;
GtkIMHtmlSmileyFlags flags;
GtkIMHtml *imhtml;
- gpointer data; /** @since 2.6.0 */
- gsize datasize; /** @since 2.6.0 */
+ gpointer data;
+ gsize datasize;
};
struct _GtkIMHtmlScalable {
@@ -766,8 +763,6 @@ char *gtk_imhtml_get_text(GtkIMHtml *imh
*
* @param imhtml The GTK+ IM/HTML.
* @param flags The connection flag which describes the allowed types of formatting.
- *
- * @since 2.1.0
*/
void gtk_imhtml_setup_entry(GtkIMHtml *imhtml, PurpleConnectionFlags flags);
@@ -780,7 +775,6 @@ void gtk_imhtml_setup_entry(GtkIMHtml *i
* @param flags The smiley flags
*
* @return The newly created smiley
- * @since 2.5.0
*/
GtkIMHtmlSmiley *gtk_imhtml_smiley_create(const char *file, const char *shortcut, gboolean hide,
GtkIMHtmlSmileyFlags flags);
@@ -789,8 +783,6 @@ GtkIMHtmlSmiley *gtk_imhtml_smiley_creat
* Reload the image data for the smiley.
*
* @param smiley The smiley to reload
- *
- * @since 2.5.0
*/
void gtk_imhtml_smiley_reload(GtkIMHtmlSmiley *smiley);
@@ -798,8 +790,6 @@ void gtk_imhtml_smiley_reload(GtkIMHtmlS
* Destroy a GtkIMHtmlSmiley.
*
* @param smiley The smiley to destroy
- *
- * @since 2.5.0
*/
void gtk_imhtml_smiley_destroy(GtkIMHtmlSmiley *smiley);
@@ -818,8 +808,6 @@ void gtk_imhtml_smiley_destroy(GtkIMHtml
* successfully, @c FALSE otherwise.
*
* @return @c TRUE if the protocol was successfully registered (or unregistered, when \a activate is @c NULL)
- *
- * @since 2.6.0
*/
gboolean gtk_imhtml_class_register_protocol(const char *name,
gboolean (*activate)(GtkIMHtml *imhtml, GtkIMHtmlLink *link),
@@ -831,8 +819,6 @@ gboolean gtk_imhtml_class_register_proto
* @param link The GtkIMHtmlLink object sent to the callback functions
*
* @return The URL
- *
- * @since 2.6.0
*/
const char *gtk_imhtml_link_get_url(GtkIMHtmlLink *link);
@@ -842,8 +828,6 @@ const char *gtk_imhtml_link_get_url(GtkI
* @param link The GtkIMHtmlLink object sent to the callback functions
*
* @return The GtkTextTag object, or @c NULL
- *
- * @since 2.6.0
*/
const GtkTextTag *gtk_imhtml_link_get_text_tag(GtkIMHtmlLink *link);
@@ -854,8 +838,6 @@ const GtkTextTag *gtk_imhtml_link_get_te
* @param link The GtkIMHtmlLink object sent to the callback functions
*
* @return @c TRUE if 'url-clicked' signal was emitted, @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean gtk_imhtml_link_activate(GtkIMHtmlLink *link);
============================================================
--- libpurple/core.h a97aec8abae23b87c688a59c430035017d6a8600
+++ libpurple/core.h 2bdddafcdbb28a23fad8695496d96d5b08686fbb
@@ -163,8 +163,6 @@ PurpleCoreUiOps *purple_core_get_ui_ops(
*
* @return @c TRUE if this is the first instance of libpurple running;
* @c FALSE if there is another instance running.
- *
- * @since 2.1.0
*/
gboolean purple_core_ensure_single_instance(void);
@@ -196,8 +194,6 @@ gboolean purple_core_ensure_single_insta
* @return A GHashTable with strings for keys and values. This
* hash table must not be freed and should not be modified.
*
- * @since 2.1.0
- *
*/
GHashTable* purple_core_get_ui_info(void);
============================================================
--- libpurple/conversation.h 84779eb6a135b3b1e53d88a9013d8a6b645bd130
+++ libpurple/conversation.h 5cb6a364b3c3fca8a9ce02f5545041b8f8be0c8f
@@ -125,7 +125,7 @@ typedef enum
PURPLE_MESSAGE_IMAGES = 0x1000, /**< Message contains images */
PURPLE_MESSAGE_NOTIFY = 0x2000, /**< Message is a notification */
PURPLE_MESSAGE_NO_LINKIFY = 0x4000, /**< Message should not be auto-
- linkified @since 2.1.0 */
+ linkified */
PURPLE_MESSAGE_INVISIBLE = 0x8000 /**< Message should not be displayed */
} PurpleMessageFlags;
@@ -140,7 +140,7 @@ typedef enum
PURPLE_CBFLAGS_OP = 0x0004, /**< Channel Op or Moderator */
PURPLE_CBFLAGS_FOUNDER = 0x0008, /**< Channel Founder */
PURPLE_CBFLAGS_TYPING = 0x0010, /**< Currently typing */
- PURPLE_CBFLAGS_AWAY = 0x0020 /**< Currently away. @since 2.8.0 */
+ PURPLE_CBFLAGS_AWAY = 0x0020 /**< Currently away. */
} PurpleConvChatBuddyFlags;
@@ -281,9 +281,7 @@ struct _PurpleConvChat
char *nick; /**< Your nick in this chat. */
gboolean left; /**< We left the chat and kept the window open */
- GHashTable *users; /**< Hash table of the users in the room.
- * @since 2.9.0
- */
+ GHashTable *users; /**< Hash table of the users in the room. */
};
/**
@@ -328,8 +326,6 @@ struct _PurpleConvChatBuddy
/**
* Description of a conversation message
- *
- * @since 2.2.0
*/
struct _PurpleConvMessage
{
@@ -337,8 +333,8 @@ struct _PurpleConvMessage
char *what;
PurpleMessageFlags flags;
time_t when;
- PurpleConversation *conv; /**< @since 2.3.0 */
- char *alias; /**< @since 2.3.0 */
+ PurpleConversation *conv;
+ char *alias;
};
/**
@@ -758,8 +754,6 @@ void purple_conversation_foreach(void (*
* @return A GList of PurpleConvMessage's. The must not modify the list or the data within.
* The list contains the newest message at the beginning, and the oldest message at
* the end.
- *
- * @since 2.2.0
*/
GList *purple_conversation_get_message_history(PurpleConversation *conv);
@@ -767,8 +761,6 @@ GList *purple_conversation_get_message_h
* Clear the message history of a conversation.
*
* @param conv The conversation
- *
- * @since 2.2.0
*/
void purple_conversation_clear_message_history(PurpleConversation *conv);
@@ -778,8 +770,6 @@ void purple_conversation_clear_message_h
* @param msg A PurpleConvMessage
*
* @return The name of the sender of the message
- *
- * @since 2.2.0
*/
const char *purple_conversation_message_get_sender(PurpleConvMessage *msg);
@@ -789,8 +779,6 @@ const char *purple_conversation_message_
* @param msg A PurpleConvMessage
*
* @return The name of the sender of the message
- *
- * @since 2.2.0
*/
const char *purple_conversation_message_get_message(PurpleConvMessage *msg);
@@ -800,8 +788,6 @@ const char *purple_conversation_message_
* @param msg A PurpleConvMessage
*
* @return The message flags
- *
- * @since 2.2.0
*/
PurpleMessageFlags purple_conversation_message_get_flags(PurpleConvMessage *msg);
@@ -811,8 +797,6 @@ PurpleMessageFlags purple_conversation_m
* @param msg A PurpleConvMessage
*
* @return The timestamp of the message
- *
- * @since 2.2.0
*/
time_t purple_conversation_message_get_timestamp(PurpleConvMessage *msg);
@@ -1379,8 +1363,6 @@ void purple_conv_chat_left(PurpleConvCha
* @param message The message to send with the invitation.
* @param confirm Prompt before sending the invitation. The user is always
* prompted if either \a user or \a message is @c NULL.
- *
- * @since 2.6.0
*/
void purple_conv_chat_invite_user(PurpleConvChat *chat, const char *user,
const char *message, gboolean confirm);
@@ -1440,8 +1422,6 @@ void purple_conv_chat_cb_destroy(PurpleC
* @return A list of PurpleMenuAction items, harvested by the
* chat-extended-menu signal. The list and the menuaction
* items should be freed by the caller.
- *
- * @since 2.1.0
*/
GList * purple_conversation_get_extended_menu(PurpleConversation *conv);
@@ -1455,8 +1435,6 @@ GList * purple_conversation_get_extended
* message, if not @c NULL. It must be freed by the caller with g_free().
*
* @return @c TRUE if the command was executed successfully, @c FALSE otherwise.
- *
- * @since 2.1.0
*/
gboolean purple_conversation_do_command(PurpleConversation *conv, const gchar *cmdline, const gchar *markup, gchar **error);
============================================================
--- pidgin/gtkconv.h 770f8553da65a89ad578903abd7f0732c250aec6
+++ pidgin/gtkconv.h 892208c55c7aa9f5ee2ba2087b93b0ac9174c7d2
@@ -51,7 +51,7 @@ enum {
CHAT_USERS_FLAGS_COLUMN,
CHAT_USERS_COLOR_COLUMN,
CHAT_USERS_WEIGHT_COLUMN,
- CHAT_USERS_ICON_STOCK_COLUMN, /** @since 2.6.0 */
+ CHAT_USERS_ICON_STOCK_COLUMN,
CHAT_USERS_COLUMNS
};
@@ -144,8 +144,6 @@ struct _PidginConversation
/**
* Quick Find.
- *
- * @since 2.7.0
*/
struct {
GtkWidget *entry;
@@ -233,8 +231,6 @@ void pidgin_conv_present_conversation(Pu
* @param conv The conversation.
*
* @return Wheter Pidgin UI was successfully attached.
- *
- * @since 2.2.0
*/
gboolean pidgin_conv_attach_to_conversation(PurpleConversation *conv);
============================================================
--- pidgin/gtkutils.h 9064b2a0f8e364f5899f62ed8f12fee05471f5ea
+++ pidgin/gtkutils.h 619e6cf7ebfe6cf43fdd22ce4421c5fa7b5c49a5
@@ -137,7 +137,6 @@ GtkWidget *pidgin_create_webview(gboolea
* @param image A button image.
*
* @return A GtkButton created from the image.
- * @since 2.7.0
*/
GtkWidget *pidgin_create_small_button(GtkWidget *image);
@@ -148,8 +147,6 @@ GtkWidget *pidgin_create_small_button(Gt
* @param border_width The window's desired border width
* @param role A string indicating what the window is responsible for doing, or @c NULL
* @param resizable Whether the window should be resizable (@c TRUE) or not (@c FALSE)
- *
- * @since 2.1.0
*/
GtkWidget *pidgin_create_window(const char *title, guint border_width, const char *role, gboolean resizable);
@@ -160,8 +157,6 @@ GtkWidget *pidgin_create_window(const ch
* @param border_width The window's desired border width
* @param role A string indicating what the window is responsible for doing, or @c NULL
* @param resizable Whether the window should be resizable (@c TRUE) or not (@c FALSE)
- *
- * @since 2.4.0
*/
GtkWidget *pidgin_create_dialog(const char *title, guint border_width, const char *role, gboolean resizable);
@@ -171,8 +166,6 @@ GtkWidget *pidgin_create_dialog(const ch
* @param dialog The dialog window
* @param homogeneous TRUE if all children are to be given equal space allotments.
* @param spacing the number of pixels to place by default between children
- *
- * @since 2.4.0
*/
GtkWidget *pidgin_dialog_get_vbox_with_properties(GtkDialog *dialog, gboolean homogeneous, gint spacing);
@@ -180,8 +173,6 @@ GtkWidget *pidgin_dialog_get_vbox_with_p
* Retrieves the main content box (vbox) from a pidgin dialog window
*
* @param dialog The dialog window
- *
- * @since 2.4.0
*/
GtkWidget *pidgin_dialog_get_vbox(GtkDialog *dialog);
@@ -194,7 +185,6 @@ GtkWidget *pidgin_dialog_get_vbox(GtkDia
* @param callbackdata The user data for the callback function
*
* @return The created button.
- * @since 2.4.0
*/
GtkWidget *pidgin_dialog_add_button(GtkDialog *dialog, const char *label,
GCallback callback, gpointer callbackdata);
@@ -203,8 +193,6 @@ GtkWidget *pidgin_dialog_add_button(GtkD
* Retrieves the action area (button box) from a pidgin dialog window
*
* @param dialog The dialog window
- *
- * @since 2.4.0
*/
GtkWidget *pidgin_dialog_get_action_area(GtkDialog *dialog);
@@ -438,8 +426,6 @@ void pidgin_load_accels(void);
*
* @param conn The connection to get information from.
* @param name The user to get information about.
- *
- * @since 2.1.0
*/
void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name);
@@ -449,8 +435,6 @@ void pidgin_retrieve_user_info(PurpleCon
* @param conn The connection to get information from.
* @param name The user to get information about.
* @param chatid The chat id.
- *
- * @since 2.1.0
*/
void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid);
@@ -489,8 +473,6 @@ void pidgin_set_accessible_label(GtkWidg
*
* @param w The widget that we want to label.
* @param l A GtkLabel that we want to use as the label for the widget.
- *
- * @since 2.2.0
*/
void pidgin_set_accessible_relations(GtkWidget *w, GtkWidget *l);
@@ -505,8 +487,6 @@ void pidgin_set_accessible_relations(Gtk
* where the menu shall be drawn. This is an output parameter.
* @param push_in This is an output parameter?
* @param data Not used by this particular position function.
- *
- * @since 2.1.0
*/
void pidgin_menu_position_func_helper(GtkMenu *menu, gint *x, gint *y,
gboolean *push_in, gpointer data);
@@ -578,8 +558,6 @@ GdkPixbuf * pidgin_create_status_icon(Pu
* @param prim The status primitive
*
* @return The stock-id
- *
- * @since 2.6.0
*/
const char *pidgin_stock_id_from_status_primitive(PurpleStatusPrimitive prim);
@@ -589,8 +567,6 @@ const char *pidgin_stock_id_from_status_
* @param presence The presence.
*
* @return The stock-id
- *
- * @since 2.6.0
*/
const char *pidgin_stock_id_from_presence(PurplePresence *presence);
@@ -758,8 +734,6 @@ const char *pidgin_get_dim_grey_string(G
*
* @return A newly created text GtkComboBox containing a GtkEntry
* child.
- *
- * @since 2.2.0
*/
GtkWidget *pidgin_text_combo_box_entry_new(const char *default_item, GList *items);
@@ -769,8 +743,6 @@ GtkWidget *pidgin_text_combo_box_entry_n
* @param widget The simple text GtkComboBoxEntry equivalent widget
*
* @return The text in the widget's entry. It must not be freed
- *
- * @since 2.2.0
*/
const char *pidgin_text_combo_box_entry_get_text(GtkWidget *widget);
@@ -779,8 +751,6 @@ const char *pidgin_text_combo_box_entry_
*
* @param widget The simple text GtkComboBoxEntry equivalent widget
* @param text The text to set
- *
- * @since 2.2.0
*/
void pidgin_text_combo_box_entry_set_text(GtkWidget *widget, const char *text);
@@ -790,8 +760,6 @@ void pidgin_text_combo_box_entry_set_tex
* @param window The window to make transient.
*
* @return Whether the window was made transient or not.
- *
- * @since 2.4.0
*/
gboolean pidgin_auto_parent_window(GtkWidget *window);
@@ -806,7 +774,6 @@ gboolean pidgin_auto_parent_window(GtkWi
* @param p_label Place to store a pointer to the GtkLabel, or @c NULL if you don't care.
*
* @return A GtkHBox already added to the GtkVBox containing the GtkLabel and the GtkWidget.
- * @since 2.4.0
*/
GtkWidget *pidgin_add_widget_to_vbox(GtkBox *vbox, const char *widget_label, GtkSizeGroup *sg, GtkWidget *widget, gboolean expand, GtkWidget **p_label);
@@ -818,8 +785,6 @@ GtkWidget *pidgin_add_widget_to_vbox(Gtk
*
* @return A GdkPixbuf created from the image data, or NULL if
* there was an error parsing the data.
- *
- * @since 2.9.0
*/
GdkPixbuf *pidgin_pixbuf_from_data(const guchar *buf, gsize count);
@@ -831,8 +796,6 @@ GdkPixbuf *pidgin_pixbuf_from_data(const
*
* @return A GdkPixbufAnimation created from the image data, or NULL if
* there was an error parsing the data.
- *
- * @since 2.9.0
*/
GdkPixbufAnimation *pidgin_pixbuf_anim_from_data(const guchar *buf, gsize count);
@@ -842,8 +805,6 @@ GdkPixbufAnimation *pidgin_pixbuf_anim_f
* @param image A PurpleStoredImage.
*
* @return A GdkPixbuf created from the stored image.
- *
- * @since 2.5.0
*/
GdkPixbuf *pidgin_pixbuf_from_imgstore(PurpleStoredImage *image);
@@ -867,8 +828,6 @@ GdkPixbuf *pidgin_pixbuf_from_imgstore(P
*
* @return The GdkPixbuf if successful. Otherwise NULL is returned and
* a warning is logged.
- *
- * @since 2.9.0
*/
GdkPixbuf *pidgin_pixbuf_new_from_file(const char *filename);
@@ -894,8 +853,6 @@ GdkPixbuf *pidgin_pixbuf_new_from_file(c
*
* @return The GdkPixbuf if successful. Otherwise NULL is returned and
* a warning is logged.
- *
- * @since 2.9.0
*/
GdkPixbuf *pidgin_pixbuf_new_from_file_at_size(const char *filename, int width, int height);
@@ -922,8 +879,6 @@ GdkPixbuf *pidgin_pixbuf_new_from_file_a
*
* @return The GdkPixbuf if successful. Otherwise NULL is returned and
* a warning is logged.
- *
- * @since 2.9.0
*/
GdkPixbuf *pidgin_pixbuf_new_from_file_at_scale(const char *filename, int width, int height, gboolean preserve_aspect_ratio);
@@ -935,22 +890,16 @@ GdkPixbuf *pidgin_pixbuf_new_from_file_a
* @param shadow_type Shadow type
* @param width Desired widget width, or -1 for default
* @param height Desired widget height, or -1 for default
- *
- * @since 2.8.0
*/
GtkWidget *pidgin_make_scrollable(GtkWidget *child, GtkPolicyType hscrollbar_policy, GtkPolicyType vscrollbar_policy, GtkShadowType shadow_type, int width, int height);
/**
* Initialize some utility functions.
- *
- * @since 2.6.0
*/
void pidgin_utils_init(void);
/**
* Uninitialize some utility functions.
- *
- * @since 2.6.0
*/
void pidgin_utils_uninit(void);
============================================================
--- libpurple/ft.h a158b4b6945b672b033a6241416f8f9581deec2c
+++ libpurple/ft.h 5a83b3faa9ae716af1908b3b7d924fd608a1972b
@@ -87,7 +87,6 @@ typedef struct
*
* @return size if the write was successful, or a value between 0 and
* size on error.
- * @since 2.6.0
*/
gssize (*ui_write)(PurpleXfer *xfer, const guchar *buffer, gssize size);
@@ -102,7 +101,6 @@ typedef struct
* @returns The amount of data in the buffer, 0 if nothing is available,
* and a negative value if an error occurred and the transfer
* should be cancelled (libpurple will cancel).
- * @since 2.6.0
*/
gssize (*ui_read)(PurpleXfer *xfer, guchar **buffer, gssize size);
@@ -115,8 +113,6 @@ typedef struct
* @param xfer The file transfer structure
* @param buffer A pointer to the beginning of the unwritten data.
* @param size The amount of unwritten data.
- *
- * @since 2.6.0
*/
void (*data_not_sent)(PurpleXfer *xfer, const guchar *buffer, gsize size);
@@ -307,8 +303,6 @@ PurpleAccount *purple_xfer_get_account(c
* @param xfer The file transfer.
*
* @return The name of the remote user.
- *
- * @since 2.1.0
*/
const char *purple_xfer_get_remote_user(const PurpleXfer *xfer);
@@ -429,7 +423,6 @@ unsigned int purple_xfer_get_remote_port
* @param xfer The file transfer.
*
* @return The time when the transfer started.
- * @since 2.4.0
*/
time_t purple_xfer_get_start_time(const PurpleXfer *xfer);
@@ -439,7 +432,6 @@ time_t purple_xfer_get_start_time(const
* @param xfer The file transfer.
*
* @return The time when the transfer ended.
- * @since 2.4.0
*/
time_t purple_xfer_get_end_time(const PurpleXfer *xfer);
@@ -727,8 +719,6 @@ void purple_xfer_conversation_write(Purp
* read/write/data_not_sent UI ops.
*
* @param xfer The file transfer which is ready.
- *
- * @since 2.6.0
*/
void purple_xfer_ui_ready(PurpleXfer *xfer);
@@ -738,8 +728,6 @@ void purple_xfer_ui_ready(PurpleXfer *xf
* ops and cannot/does not provide a raw fd to the core.
*
* @param xfer The file transfer which is ready.
- *
- * @since 2.6.0
*/
void purple_xfer_prpl_ready(PurpleXfer *xfer);
@@ -750,7 +738,6 @@ void purple_xfer_prpl_ready(PurpleXfer *
* @param len If not @c NULL, the length of the thumbnail data returned
* will be set in the location pointed to by this.
* @return The thumbnail data, or NULL if there is no thumbnail
- * @since 2.7.0
*/
gconstpointer purple_xfer_get_thumbnail(const PurpleXfer *xfer, gsize *len);
@@ -759,7 +746,6 @@ gconstpointer purple_xfer_get_thumbnail(
*
* @param xfer The file transfer to get the mimetype for
* @return The mimetype of the thumbnail, or @c NULL if not thumbnail is set
- * @since 2.7.0
*/
const gchar *purple_xfer_get_thumbnail_mimetype(const PurpleXfer *xfer);
@@ -771,7 +757,6 @@ const gchar *purple_xfer_get_thumbnail_m
* @param thumbnail A pointer to the thumbnail data, this will be copied
* @param size The size in bytes of the passed in thumbnail data
* @param mimetype The mimetype of the generated thumbnail
- * @since 2.7.0
*/
void purple_xfer_set_thumbnail(PurpleXfer *xfer, gconstpointer thumbnail,
gsize size, const gchar *mimetype);
@@ -783,7 +768,6 @@ void purple_xfer_set_thumbnail(PurpleXfe
* @param xfer The file transfer to create a thumbnail for
* @param formats A comma-separated list of mimetypes for image formats
* the protocols can use for thumbnails.
- * @since 2.7.0
*/
void purple_xfer_prepare_thumbnail(PurpleXfer *xfer, const gchar *formats);
@@ -792,8 +776,6 @@ void purple_xfer_prepare_thumbnail(Purpl
*
* @param xfer The file transfer.
* @param proto_data The protocol data to set for the file transfer.
- *
- * @since 3.0.0
*/
void purple_xfer_set_protocol_data(PurpleXfer *xfer, gpointer proto_data);
@@ -803,8 +785,6 @@ void purple_xfer_set_protocol_data(Purpl
* @param xfer The file transfer.
*
* @return The protocol data for the file transfer.
- *
- * @since 3.0.0
*/
gpointer purple_xfer_get_protocol_data(const PurpleXfer *xfer);
============================================================
--- libpurple/pounce.h bf16dfc0ef59c54d518a139469a94d3b0b2f1877
+++ libpurple/pounce.h 499a5d7ebe4a1be6ddd418e8d20368c21a347cb2
@@ -101,8 +101,6 @@ void purple_pounce_destroy_all_by_accoun
* Destroys all buddy pounces for a buddy
*
* @param buddy The buddy whose pounces are to be removed
- *
- * @since 2.8.0
*/
void purple_pounce_destroy_all_by_buddy(PurpleBuddy *buddy);
@@ -334,7 +332,6 @@ GList *purple_pounces_get_all(void);
*
* @return The list of buddy pounces. The list should be freed by
* the caller when it's no longer used.
- * @since 2.1.0
*/
GList *purple_pounces_get_all_for_ui(const char *ui);
============================================================
--- libpurple/plugin.h ba494a191bb74a7d418e34562f1382165182c00c
+++ libpurple/plugin.h 9490a14a777df5db74357039be3e45edff1e8324
@@ -317,8 +317,6 @@ gboolean purple_plugin_unload(PurplePlug
* startup" by excluding said plugins from the list of plugins to save. The
* UI needs to call purple_plugins_save_loaded() after calling this for it
* to have any effect.
- *
- * @since 2.3.0
*/
void purple_plugin_disable(PurplePlugin *plugin);
@@ -515,8 +513,6 @@ void purple_plugins_add_search_path(cons
* Returns a list of plugin search paths.
*
* @constreturn A list of searched paths.
- *
- * @since 2.6.0
*/
GList *purple_plugins_get_search_paths(void);
============================================================
--- libpurple/debug.h 3ba4c16eaf446f6ff5b933318195e8c12ea17ea7
+++ libpurple/debug.h 953d02706b77c840054be3a7dd86d68be9f98925
@@ -161,8 +161,6 @@ gboolean purple_debug_is_enabled(void);
* plugins.
*
* @param verbose TRUE to enable verbose debugging or FALSE to disable it.
- *
- * @since 2.6.0
*/
void purple_debug_set_verbose(gboolean verbose);
@@ -170,8 +168,6 @@ void purple_debug_set_verbose(gboolean v
* Check if verbose logging is enabled.
*
* @return TRUE if verbose debugging is enabled, FALSE if it is not.
- *
- * @since 2.6.0
*/
gboolean purple_debug_is_verbose(void);
@@ -183,8 +179,6 @@ gboolean purple_debug_is_verbose(void);
* @param unsafe TRUE to enable debug logging of messages that could
* potentially contain passwords and other sensitive information.
* FALSE to disable it.
- *
- * @since 2.6.0
*/
void purple_debug_set_unsafe(gboolean unsafe);
@@ -194,8 +188,6 @@ void purple_debug_set_unsafe(gboolean un
* @return TRUE if the debug logging of all messages is enabled, FALSE
* if messages that could potentially contain passwords and other
* sensitive information are not logged.
- *
- * @since 2.6.0
*/
gboolean purple_debug_is_unsafe(void);
============================================================
--- libpurple/blist.h 90d906af8a794fc2ad283bd50184e6335801c838
+++ libpurple/blist.h 111ff10b88666876e5c2407e406f07ef9ce6f631
@@ -75,9 +75,6 @@ typedef enum
} PurpleBlistNodeFlags;
-/**
- * @since 2.6.0
- */
#define PURPLE_BLIST_NODE(obj) ((PurpleBlistNode *)(obj))
#define PURPLE_BLIST_NODE_HAS_FLAG(b, f) (purple_blist_node_get_flags((PurpleBlistNode*)(b)) & (f))
@@ -86,24 +83,12 @@ typedef enum
#define PURPLE_BLIST_NODE_NAME(n) (purple_blist_node_get_type(n) == PURPLE_BLIST_CHAT_NODE ? purple_chat_get_name((PurpleChat*)n) : \
purple_blist_node_get_type(n) == PURPLE_BLIST_BUDDY_NODE ? purple_buddy_get_name((PurpleBuddy*)n) : NULL)
-/**
- * @since 2.6.0
- */
#define PURPLE_GROUP(obj) ((PurpleGroup *)(obj))
-/**
- * @since 2.6.0
- */
#define PURPLE_CONTACT(obj) ((PurpleContact *)(obj))
-/**
- * @since 2.6.0
- */
#define PURPLE_BUDDY(obj) ((PurpleBuddy *)(obj))
-/**
- * @since 2.6.0
- */
#define PURPLE_CHAT(obj) ((PurpleChat *)(obj))
#include "account.h"
@@ -226,8 +211,6 @@ struct _PurpleBlistUiOps
* previous libpurple versions.
*
* @param node The node which has been modified.
- *
- * @since 2.6.0.
*/
void (*save_node)(PurpleBlistNode *node);
@@ -241,7 +224,6 @@ struct _PurpleBlistUiOps
* previous libpurple versions.
*
* @param node The node which has been modified.
- * @since 2.6.0.
*/
void (*remove_node)(PurpleBlistNode *node);
@@ -256,7 +238,6 @@ struct _PurpleBlistUiOps
*
* @param account The account whose data to save. If NULL, save all data
* for all accounts.
- * @since 2.6.0.
*/
void (*save_account)(PurpleAccount *account);
@@ -311,7 +292,6 @@ PurpleBlistNode *purple_blist_get_root(v
* freeing the list.
*
* @see purple_find_buddies
- * @since 2.6.0
*/
GSList *purple_blist_get_buddies(void);
@@ -319,8 +299,6 @@ GSList *purple_blist_get_buddies(void);
* Returns the UI data for the list.
*
* @return The UI data for the list.
- *
- * @since 2.6.0
*/
gpointer purple_blist_get_ui_data(void);
@@ -328,8 +306,6 @@ gpointer purple_blist_get_ui_data(void);
* Sets the UI data for the list.
*
* @param ui_data The UI data for the list.
- *
- * @since 2.6.0
*/
void purple_blist_set_ui_data(gpointer ui_data);
@@ -352,7 +328,7 @@ PurpleBlistNode *purple_blist_node_next(
*
* @param node A node.
* @return The parent node.
- * @since 2.4.0
+ *
* @see purple_blist_node_get_first_child
* @see purple_blist_node_get_sibling_next
* @see purple_blist_node_get_sibling_prev
@@ -365,7 +341,7 @@ PurpleBlistNode *purple_blist_node_get_p
*
* @param node A node.
* @return The child node.
- * @since 2.4.0
+ *
* @see purple_blist_node_get_parent
* @see purple_blist_node_get_sibling_next
* @see purple_blist_node_get_sibling_prev
@@ -378,7 +354,7 @@ PurpleBlistNode *purple_blist_node_get_f
*
* @param node A node.
* @return The sibling node.
- * @since 2.4.0
+ *
* @see purple_blist_node_get_parent
* @see purple_blist_node_get_first_child
* @see purple_blist_node_get_sibling_prev
@@ -391,7 +367,7 @@ PurpleBlistNode *purple_blist_node_get_s
*
* @param node A node.
* @return The sibling node.
- * @since 2.4.0
+ *
* @see purple_blist_node_get_parent
* @see purple_blist_node_get_first_child
* @see purple_blist_node_get_sibling_next
@@ -404,7 +380,6 @@ PurpleBlistNode *purple_blist_node_get_s
*
* @param node The node.
* @return The UI data.
- * @since 2.6.0
*/
gpointer purple_blist_node_get_ui_data(const PurpleBlistNode *node);
@@ -413,8 +388,6 @@ gpointer purple_blist_node_get_ui_data(c
*
* @param node The node.
* @param ui_data The UI data.
- *
- * @since 2.6.0
*/
void purple_blist_node_set_ui_data(PurpleBlistNode *node, gpointer ui_data);
@@ -611,7 +584,6 @@ PurpleBuddyIcon *purple_buddy_get_icon(c
* @return The protocol data.
*
* @see purple_buddy_set_protocol_data()
- * @since 2.6.0
*/
gpointer purple_buddy_get_protocol_data(const PurpleBuddy *buddy);
@@ -624,7 +596,6 @@ gpointer purple_buddy_get_protocol_data(
* @param data The data.
*
* @see purple_buddy_get_protocol_data()
- * @since 2.6.0
*/
void purple_buddy_set_protocol_data(PurpleBuddy *buddy, gpointer data);
@@ -651,8 +622,6 @@ PurplePresence *purple_buddy_get_presenc
*
* @param buddy The buddy.
* @return The media caps.
- *
- * @since 2.7.0
*/
PurpleMediaCaps purple_buddy_get_media_caps(const PurpleBuddy *buddy);
@@ -727,8 +696,6 @@ void purple_contact_destroy(PurpleContac
*
* @param contact The contact
* @return The group
- *
- * @since 2.7.0
*/
PurpleGroup *purple_contact_get_group(const PurpleContact *contact);
@@ -867,8 +834,6 @@ const char *purple_buddy_get_alias(Purpl
*
* @param buddy The buddy
* @return The local alias for the buddy
- *
- * @since 2.6.0
*/
const char *purple_buddy_get_local_buddy_alias(PurpleBuddy *buddy);
@@ -944,8 +909,6 @@ PurpleGroup *purple_chat_get_group(Purpl
* @param chat The chat.
*
* @return The account the chat belongs to.
- *
- * @since 2.4.0
*/
PurpleAccount *purple_chat_get_account(PurpleChat *chat);
@@ -955,8 +918,6 @@ PurpleAccount *purple_chat_get_account(P
* @param chat The chat.
*
* @constreturn The hashtable.
- *
- * @since 2.4.0
*/
GHashTable *purple_chat_get_components(PurpleChat *chat);
@@ -1174,8 +1135,6 @@ PurpleBlistNodeFlags purple_blist_node_g
* @param node The node.
*
* @return The type of the node.
- *
- * @since 2.1.0
*/
PurpleBlistNodeType purple_blist_node_get_type(PurpleBlistNode *node);
============================================================
--- pidgin/gtkblist.h 6374e8cb81e381c62c890c135aa9dbba92b3cdff
+++ pidgin/gtkblist.h 9bb46628cbc7031cf54c78c2138b7d578bf51c72
@@ -250,8 +250,6 @@ void pidgin_blist_add_alert(GtkWidget *w
* Sets the current theme for Pidgin to use
*
* @param theme the new theme to use
- *
- * @since 2.6.0
*/
void pidgin_blist_set_theme(PidginBlistTheme *theme);
@@ -259,8 +257,6 @@ void pidgin_blist_set_theme(PidginBlistT
* Gets Pidgin's current buddy list theme
*
* @returns the current theme
- *
- * @since 2.6.0
*/
PidginBlistTheme *pidgin_blist_get_theme(void);
@@ -382,8 +378,6 @@ void pidgin_blist_set_headline(const cha
* @param selected Whether this buddy is selected. If TRUE, the markup will not change the color.
* @param aliased TRUE to return the appropriate alias of this buddy, FALSE to return its username and status information
* @return The markup for this buddy
- *
- * @since 2.1.0
*/
gchar *pidgin_blist_get_name_markup(PurpleBuddy *buddy, gboolean selected, gboolean aliased);
@@ -395,15 +389,11 @@ gchar *pidgin_blist_get_name_markup(Purp
*
* @param node The buddy list node to show a tooltip for
* @param widget The widget to draw the tooltip on
- *
- * @since 2.1.0
*/
void pidgin_blist_draw_tooltip(PurpleBlistNode *node, GtkWidget *widget);
/**
* Destroys the current (if any) Buddy List tooltip
- *
- * @since 2.1.0
*/
void pidgin_blist_tooltip_destroy(void);
============================================================
--- libpurple/notify.h 2202552eca8a9d951f3984068b36c668835cbad2
+++ libpurple/notify.h 3d479c8dbbc3c0f8c74d41112014c1ce79900bc4
@@ -550,7 +550,6 @@ void purple_notify_user_info_add_section
* Prepend a section break. A UI might display this as a horizontal line.
*
* @param user_info The PurpleNotifyUserInfo
- * @since 2.5.0
*/
void purple_notify_user_info_prepend_section_break(PurpleNotifyUserInfo *user_info);
@@ -569,7 +568,6 @@ void purple_notify_user_info_add_section
*
* @param user_info The PurpleNotifyUserInfo
* @param label The name of the section
- * @since 2.5.0
*/
void purple_notify_user_info_prepend_section_header(PurpleNotifyUserInfo *user_info, const char *label);
============================================================
--- libpurple/prefs.h e1b30d339896a98a86013a11095fad0c46f76137
+++ libpurple/prefs.h 96616faf790ad983d3cdb7d8cd49cd776f51bbc7
@@ -317,8 +317,6 @@ GList *purple_prefs_get_path_list(const
* @return A list of newly allocated strings denoting the names of the children.
* Returns @c NULL if there are no children or if pref doesn't exist.
* The caller must free all the strings and the list.
- *
- * @since 2.1.0
*/
GList *purple_prefs_get_children_names(const char *name);
============================================================
--- libpurple/request.h 27f58da773740312a15e76501c341cb29b24061c
+++ libpurple/request.h 7470e8c9ba6e2ec79dbb946ad68d5b4740d827eb
@@ -477,8 +477,6 @@ PurpleRequestFieldType purple_request_fi
* @param field The field.
*
* @return The UI data.
- *
- * @since 2.6.0
*/
PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);
@@ -542,8 +540,6 @@ gboolean purple_request_field_is_require
* @param field The field.
*
* @return The UI data.
- *
- * @since 2.6.0
*/
gpointer purple_request_field_get_ui_data(const PurpleRequestField *field);
@@ -554,8 +550,6 @@ gpointer purple_request_field_get_ui_dat
* @param ui_data The UI data.
*
* @return The UI data.
- *
- * @since 2.6.0
*/
void purple_request_field_set_ui_data(PurpleRequestField *field,
gpointer ui_data);
@@ -1336,8 +1330,7 @@ void *purple_request_action_varg(void *h
/**
* Version of purple_request_action() supplying an image for the UI to
- * optionally display as an icon in the dialog; see its documentation
- * @since 2.7.0
+ * optionally display as an icon in the dialog; see its documentation.
*/
void *purple_request_action_with_icon(void *handle, const char *title,
const char *primary, const char *secondary, int default_action,
@@ -1348,7 +1341,6 @@ void *purple_request_action_with_icon(vo
/**
* <tt>va_list</tt> version of purple_request_action_with_icon();
* see its documentation.
- * @since 2.7.0
*/
void *purple_request_action_with_icon_varg(void *handle, const char *title,
const char *primary, const char *secondary, int default_action,
============================================================
--- pidgin/gtkprefs.h cac6ac04ebbc3df8f2be657e35427b6498c8692c
+++ pidgin/gtkprefs.h 06dae34edc2dfc557810f5c2ac1add220a10a363
@@ -92,8 +92,6 @@ GtkWidget *pidgin_prefs_labeled_entry(Gt
* @return An hbox containing both the label and the entry. Can be used to set
* the widgets to sensitive or insensitive based on the value of a
* checkbox.
- *
- * @since 2.6.0
*/
GtkWidget *pidgin_prefs_labeled_password(GtkWidget *page, const gchar *title,
const char *key, GtkSizeGroup *sg);
============================================================
--- libpurple/account.h d89189563a5998f977b8462e57120c69ca9711da
+++ libpurple/account.h d2bb54fe562db62b43bceca3761901b5af98d648
@@ -433,8 +433,6 @@ void purple_account_set_proxy_info(Purpl
*
* @param account The account.
* @param privacy_type The privacy type.
- *
- * @since 2.7.0
*/
void purple_account_set_privacy_type(PurpleAccount *account, PurplePrivacyType privacy_type);
@@ -491,8 +489,6 @@ void purple_account_set_status_list(Purp
* is successfully set on the server (or NULL).
* @param failure_cb A callback which will be called if the alias
* is not successfully set on the server (or NULL).
- *
- * @since 2.7.0
*/
void purple_account_set_public_alias(PurpleAccount *account,
const char *alias, PurpleSetPublicAliasSuccessCallback success_cb,
@@ -506,7 +502,6 @@ void purple_account_set_public_alias(Pur
* @param success_cb A callback which will be called with the alias
* @param failure_cb A callback which will be called if the prpl is
* unable to retrieve the server-side alias.
- * @since 2.7.0
*/
void purple_account_get_public_alias(PurpleAccount *account,
PurpleGetPublicAliasSuccessCallback success_cb,
@@ -542,8 +537,6 @@ void purple_account_clear_settings(Purpl
*
* @param account The account.
* @param setting The setting to remove.
- *
- * @since 2.6.0
*/
void purple_account_remove_setting(PurpleAccount *account, const char *setting);
@@ -717,8 +710,6 @@ PurpleConnection *purple_account_get_con
* @param account The account.
*
* @return The name to display.
- *
- * @since 2.7.0
*/
const gchar *purple_account_get_name_for_display(const PurpleAccount *account);
@@ -767,8 +758,6 @@ PurpleProxyInfo *purple_account_get_prox
* @param account The account.
*
* @return The privacy type.
- *
- * @since 2.7.0
*/
PurplePrivacyType purple_account_get_privacy_type(const PurpleAccount *account);
============================================================
--- libpurple/connection.h 242c18e89d872e8927facb836351a32d05c99780
+++ libpurple/connection.h ac25032dc0b6da6c405620e546f15c5ee74ba197
@@ -59,8 +59,6 @@ typedef enum
/**
* Possible errors that can cause a connection to be closed.
- *
- * @since 2.3.0
*/
typedef enum
{
@@ -216,8 +214,6 @@ typedef struct
* @param text a localized message describing the disconnection
* in more detail to the user.
* @see #purple_connection_error
- *
- * @since 2.3.0
*/
void (*report_disconnect)(PurpleConnection *gc,
PurpleConnectionError reason,
@@ -305,8 +301,6 @@ void purple_connection_set_display_name(
*
* @param connection The PurpleConnection.
* @param proto_data The protocol data to set for the connection.
- *
- * @since 2.6.0
*/
void purple_connection_set_protocol_data(PurpleConnection *connection, void *proto_data);
@@ -342,8 +336,6 @@ PurpleAccount *purple_connection_get_acc
* @param gc The connection.
*
* @return The protocol plugin.
- *
- * @since 2.4.0
*/
PurplePlugin * purple_connection_get_prpl(const PurpleConnection *gc);
@@ -371,8 +363,6 @@ const char *purple_connection_get_displa
* @param connection The PurpleConnection.
*
* @return The protocol data for the connection.
- *
- * @since 2.6.0
*/
void *purple_connection_get_protocol_data(const PurpleConnection *connection);
@@ -404,8 +394,6 @@ void purple_connection_notice(PurpleConn
* @param gc the connection which is closing.
* @param reason why the connection is closing.
* @param description a non- at c NULL localized description of the error.
- *
- * @since 2.3.0
*/
void
purple_connection_error(PurpleConnection *gc,
@@ -416,8 +404,6 @@ purple_connection_error(PurpleConnection
* Closes a connection due to an SSL error; this is basically a shortcut to
* turning the #PurpleSslErrorType into a #PurpleConnectionError and a
* human-readable string and then calling purple_connection_error().
- *
- * @since 2.3.0
*/
void
purple_connection_ssl_error (PurpleConnection *gc,
@@ -440,8 +426,6 @@ purple_connection_ssl_error (PurpleConne
*
* @return @c TRUE if the account should not be automatically reconnected, and
* @c FALSE otherwise.
- *
- * @since 2.3.0
*/
gboolean
purple_connection_error_is_fatal (PurpleConnectionError reason);
============================================================
--- pidgin/gtksound.h 132519f653121f18564d7dea38ef78c7f21a800a
+++ pidgin/gtksound.h 73e09bda8431971dbabb94604df39a2c10f066c4
@@ -67,8 +67,6 @@ void *pidgin_sound_get_handle(void);
* Returns true Pidgin is using customized sounds
*
* @return TRUE if non default sounds are used.
- *
- * @since 2.6.0
*/
gboolean pidgin_sound_is_customized(void);
============================================================
--- libpurple/log.h fdae3f0adc203739096c27e7d4bb6fc140b28591
+++ libpurple/log.h 0edac1da98c11c1936b7948a963507e6f378ea91
@@ -301,8 +301,6 @@ int purple_log_get_total_size(PurpleLogT
* @param name The name of the log
* @param account The account
* @return The activity score
- *
- * @since 2.6.0
*/
int purple_log_get_activity_score(PurpleLogType type, const char *name, PurpleAccount *account);
============================================================
--- doc/account-signals.dox fbbda66b6dee3f472ede95693a40404d5d6bcad1
+++ doc/account-signals.dox 074cb3dd1ce0d28c25719a45fe8b0ca4d2842e5c
@@ -34,7 +34,6 @@ void (*account_created)(PurpleAccount *a
@signaldesc
Emitted when an account is created by calling purple_account_new.
@param account The account.
- @since 2.6.0
@endsignaldef
@signaldef account-destroying
@@ -44,7 +43,6 @@ void (*account_destroying)(PurpleAccount
@signaldesc
Emitted when an account is about to be destroyed.
@param account The account.
- @since 2.6.0
@endsignaldef
@signaldef account-added
@@ -156,7 +154,6 @@ int (*account_authorization_requested)(P
@return Less than zero to deny the request without prompting, greater
than zero if the request should be granted. If zero is returned,
then the user will be prompted with the request.
- @since 2.3.0
@endsignaldef
@signaldef account-authorization-requested-with-message
@@ -173,7 +170,6 @@ int (*account_authorization_requested)(P
get informed, PURPLE_ACCOUNT_RESPONSE_ACCEPT if the request should be
granted. If PURPLE_ACCOUNT_RESPONSE_PASS is returned, then the user
will be prompted with the request.
- @since 2.8.0
@endsignaldef
@signaldef account-authorization-denied
@@ -184,7 +180,6 @@ void (*account_authorization_denied)(Pur
Emitted when the authorization request for a buddy is denied.
@param account The account.
@param user The name of the user requesting authorization.
- @since 2.3.0
@endsignaldef
@signaldef account-authorization-granted
@@ -195,7 +190,6 @@ void (*account_authorization_granted)(Pu
Emitted when the authorization request for a buddy is granted.
@param account The account.
@param user The name of the user requesting authorization.
- @since 2.3.0
@endsignaldef
@signaldef account-error-changed
@@ -214,7 +208,6 @@ void (*account_error_changed)(PurpleAcco
pointer just after the next time this signal is emitted
for this @a account.
@see purple_account_get_current_error()
- @since 2.3.0
@endsignaldef
@signaldef account-signed-on
@@ -224,7 +217,6 @@ void (*signed_on)(PurpleAccount *account
@signaldesc
Emitted when an account has signed on.
@param account The account that has signed on.
- @since 2.7.0
@endsignaldef
@signaldef account-signed-off
@@ -234,7 +226,6 @@ void (*signed_off)(PurpleAccount *accoun
@signaldesc
Emitted when an account has signed off.
@param account The account that has signed off.
- @since 2.7.0
@endsignaldef
@signaldef account-connection-error
@@ -246,7 +237,6 @@ void (*connection_error)(PurpleAccount *
@param account The account on which the error has occurred
@param err The error that occurred
@param desc A description of the error, giving more information.
- @since 2.7.0
@endsignaldef
*/
// vim: syntax=c.doxygen tw=75 et
============================================================
--- doc/blist-signals.dox f6065f770272546198653176d1131ad3b2feb96d
+++ doc/blist-signals.dox 135607c97a84768314c026bc2510386ca658920f
@@ -136,7 +136,6 @@ void (*buddy_caps_changed)(PurpleBuddy *
@param buddy The buddy
@param newcaps
@param oldcaps
- @since 2.7.0
@endsignaldef
@signaldef ui-caps-changed
@@ -147,7 +146,6 @@ void (*ui_caps_changed)(PurpleMediaCaps
Emitted when updating the media capabilities of the UI.
@param newcaps
@param oldcaps
- @since 2.7.0
@endsignaldef
*/
============================================================
--- doc/conversation-signals.dox a5115551dcbf617a6d099b0ea4ce1916a28be613
+++ doc/conversation-signals.dox 4b5f34703686f30f0c9398fe62f1d8e043ff2ec5
@@ -149,7 +149,6 @@ void (*blocked_im_msg)(PurpleAccount *ac
@param message The message that was blocked.
@param flags The IM message flags.
@param when The time the message was sent.
- @since 2.5.0
@endsignaldef
@signaldef writing-chat-msg
@@ -436,7 +435,6 @@ void (*chat_invite_blocked)(PurpleAccoun
@param name The name of the chat invited to.
@param message The invitation message sent.
@param data Hashtable containing data about the invited chat.
- @since 2.5.0
@endsignaldef
@signaldef chat-joined
@@ -477,7 +475,6 @@ void (*conversation_extended_menu)(Purpl
conversation.
@param conv The conversation.
@param list A pointer to the list of actions.
- @since 2.1.0
@endsignaldef
@signaldef cleared-message-history
@@ -487,7 +484,6 @@ void (*cleared_message_history)(PurpleCo
@signaldesc
Emitted when the conversation history is cleared.
@param conv The conversation.
- @since 2.8.0
@endsignaldef
@signaldef sent-attention
@@ -501,7 +497,6 @@ void (*got_attention)(PurpleAccount *acc
@param who The name of the person receiving the attention
@param conv The conversation
@param type The attention type (an index starting at 0)
- @since 2.7.0
@endsignaldef
@signaldef got-attention
@@ -515,7 +510,6 @@ void (*got_attention)(PurpleAccount *acc
@param who The name of the person sending the attention
@param conv The conversation
@param type The attention type (an index starting at 0)
- @since 2.7.0
@endsignaldef
*/
// vim: syntax=c.doxygen tw=75 et
============================================================
--- doc/connection-signals.dox 203161c89cc32f7a2393c75b3281202e9fa80e2a
+++ doc/connection-signals.dox 2a46e279d035eb69077efaa667447f836cb5ae3b
@@ -44,7 +44,6 @@ gboolean (*autojoin)(PurpleConnection *g
@return @c TRUE if the signal was handled or @c FALSE otherwise. In
practice, the return value is irrelevant, as it really only
exists so plugins can block the UI's autojoin.
- @since 2.7.0
@endsignaldef
@signaldef signing-off
============================================================
--- libpurple/sslconn.h 1f19333438ae15b6a678e343a57702fa9b37ffe5
+++ libpurple/sslconn.h cc5210a131c86bd8dc61876fbaaaa19da735b001
@@ -203,7 +203,6 @@ PurpleSslConnection *purple_ssl_connect(
* @param data User-defined data.
*
* @return The SSL connection handle.
- * @since 2.6.0
*/
PurpleSslConnection *purple_ssl_connect_with_ssl_cn(PurpleAccount *account, const char *host,
int port, PurpleSslInputFunction func,
@@ -222,8 +221,6 @@ PurpleSslConnection *purple_ssl_connect_
* @param data User-defined data.
*
* @return The SSL connection handle.
- *
- * @since 2.2.0
*/
PurpleSslConnection *purple_ssl_connect_with_host_fd(PurpleAccount *account, int fd,
PurpleSslInputFunction func,
@@ -278,8 +275,6 @@ size_t purple_ssl_write(PurpleSslConnect
*
* @return The peer certificate chain, in the order of certificate, issuer,
* issuer's issuer, etc. @a NULL if no certificates have been provided,
- *
- * @since 2.2.0
*/
GList * purple_ssl_get_peer_certificates(PurpleSslConnection *gsc);
============================================================
--- libpurple/roomlist.h 64882aa3e70354ea78dae2d5fb9ef745535403bb
+++ libpurple/roomlist.h a9488ea8f08ee5985cab0edb2deb6998c16cea13
@@ -217,7 +217,6 @@ void purple_roomlist_expand_category(Pur
*
* @param roomlist The roomlist, which must not be @c NULL.
* @constreturn A list of fields
- * @since 2.4.0
*/
GList *purple_roomlist_get_fields(PurpleRoomlist *roomlist);
@@ -299,7 +298,6 @@ void purple_roomlist_room_join(PurpleRoo
* Get the type of a room.
* @param room The room, which must not be @c NULL.
* @return The type of the room.
- * @since 2.4.0
*/
PurpleRoomlistRoomType purple_roomlist_room_get_type(PurpleRoomlistRoom *room);
@@ -307,7 +305,6 @@ PurpleRoomlistRoomType purple_roomlist_r
* Get the name of a room.
* @param room The room, which must not be @c NULL.
* @return The name of the room.
- * @since 2.4.0
*/
const char * purple_roomlist_room_get_name(PurpleRoomlistRoom *room);
@@ -315,7 +312,6 @@ const char * purple_roomlist_room_get_na
* Get the parent of a room.
* @param room The room, which must not be @c NULL.
* @return The parent of the room, which can be @c NULL.
- * @since 2.4.0
*/
PurpleRoomlistRoom * purple_roomlist_room_get_parent(PurpleRoomlistRoom *room);
@@ -341,7 +337,6 @@ void purple_roomlist_room_set_expanded_o
*
* @param room The room, which must not be @c NULL.
* @constreturn A list of fields
- * @since 2.4.0
*/
GList * purple_roomlist_room_get_fields(PurpleRoomlistRoom *room);
@@ -373,7 +368,6 @@ PurpleRoomlistField *purple_roomlist_fie
* @param field A PurpleRoomlistField, which must not be @c NULL.
*
* @return The type of the field.
- * @since 2.4.0
*/
PurpleRoomlistFieldType purple_roomlist_field_get_type(PurpleRoomlistField *field);
@@ -383,7 +377,6 @@ PurpleRoomlistFieldType purple_roomlist_
* @param field A PurpleRoomlistField, which must not be @c NULL.
*
* @return The label of the field.
- * @since 2.4.0
*/
const char * purple_roomlist_field_get_label(PurpleRoomlistField *field);
@@ -392,7 +385,6 @@ const char * purple_roomlist_field_get_l
* @param field A PurpleRoomlistField, which must not be @c NULL.
*
* @return @c TRUE if the field is hidden, @c FALSE otherwise.
- * @since 2.4.0
*/
gboolean purple_roomlist_field_get_hidden(PurpleRoomlistField *field);
============================================================
--- libpurple/network.h 90f2147481ed4bf41825c7bcfd271d875482e8f9
+++ libpurple/network.h 4d5b843e10702d86e4effc4c4d52a9226927396f
@@ -92,7 +92,6 @@ const char *purple_network_get_local_sys
*
* @note The caller must free this list. If libpurple was built with
* support for it, this function also enumerates IPv6 addresses.
- * @since 2.7.0
*
* @return A list of local IP addresses.
*/
@@ -240,8 +239,6 @@ gboolean purple_network_is_available(voi
* This is what backs the --force-online command line argument in Pidgin,
* for example. This is useful for offline testing, especially when
* combined with nullprpl.
- *
- * @since 2.6.0
*/
void purple_network_force_online(void);
@@ -257,7 +254,6 @@ void *purple_network_get_handle(void);
* Will result in a DNS query being executed asynchronous
*
* @param stun_server The host name of the STUN server to set
- * @since 2.6.0
*/
void purple_network_set_stun_server(const gchar *stun_server);
@@ -265,7 +261,6 @@ void purple_network_set_stun_server(cons
* Get the IP address of the STUN server as a string representation
*
* @return the IP address
- * @since 2.6.0
*/
const gchar *purple_network_get_stun_ip(void);
@@ -274,7 +269,6 @@ const gchar *purple_network_get_stun_ip(
* Will result in a DNS query being executed asynchronous
*
* @param turn_server The host name of the TURN server to set
- * @since 2.6.0
*/
void purple_network_set_turn_server(const gchar *turn_server);
@@ -282,7 +276,6 @@ void purple_network_set_turn_server(cons
* Get the IP address of the TURN server as a string representation
*
* @return the IP address
- * @since 2.6.0
*/
const gchar *purple_network_get_turn_ip(void);
@@ -290,7 +283,6 @@ const gchar *purple_network_get_turn_ip(
* Remove a port mapping (UPnP or NAT-PMP) associated with listening socket
*
* @param fd Socket to remove the port mapping for
- * @since 2.6.0
*/
void purple_network_remove_port_mapping(gint fd);
@@ -309,7 +301,6 @@ void purple_network_remove_port_mapping(
* The caller is responsible for freeing this.
* @returns 0 on success, -1 if the out is NULL, or an error code
* that currently corresponds to the Idna_rc enum in libidn.
- * @since 2.6.0
*/
int purple_network_convert_idn_to_ascii(const gchar *in, gchar **out);
============================================================
--- libpurple/eventloop.h 89501d488af90d218670a6e62fd7bd772eac717e
+++ libpurple/eventloop.h b02d72c5ce4fa2064c69891ee6faa57803890256
@@ -145,7 +145,6 @@ struct _PurpleEventLoopUiOps
* #timeout_add.
*
* @see purple_timeout_add_seconds()
- * @since 2.1.0
**/
guint (*timeout_add_seconds)(guint interval, GSourceFunc function,
gpointer data);
@@ -192,8 +191,6 @@ guint purple_timeout_add(guint interval,
* @param data data to pass to @a function.
* @return A handle to the timer which can be passed to
* purple_timeout_remove() to remove the timer.
- *
- * @since 2.1.0
*/
guint purple_timeout_add_seconds(guint interval, GSourceFunc function, gpointer data);
============================================================
--- pidgin/gtkimhtmltoolbar.h 11ef362f1c0b737bfdc12bc8daa20f6892446647
+++ pidgin/gtkimhtmltoolbar.h 9c2d607fe8b91cfc264123f86d311a171b776ead
@@ -90,9 +90,6 @@ void gtk_imhtmltoolbar_associate_smileys
void gtk_imhtmltoolbar_attach (GtkIMHtmlToolbar *toolbar, GtkWidget *imhtml);
void gtk_imhtmltoolbar_associate_smileys (GtkIMHtmlToolbar *toolbar, const char *proto_id);
-/**
- * @since 2.7.0
- */
void gtk_imhtmltoolbar_switch_active_conversation(GtkIMHtmlToolbar *toolbar,
PurpleConversation *conv);
============================================================
--- doc/gtkconv-signals.dox c8a35f342ee12c2b6fb030994e50cd91ed9589ce
+++ doc/gtkconv-signals.dox 070f58f56bc9cfbac75757da732406ac3e477cef
@@ -129,7 +129,6 @@ void (*conversation_hiding)(PidginConver
@signaldesc
Emitted immediately before an existing conversation is hidden.
@param gtkconv The PidginConversation
- @since 2.2.0
@endsignaldef
@signaldef conversation-displayed
@@ -139,7 +138,6 @@ void (*conversation_displayed)(PidginCon
@signaldesc
Emitted right after the Pidgin UI is attached to a new or a hidden conversation.
@param gtkconv The PidginConversation
- @since 2.2.0
@endsignaldef
*/
============================================================
--- libpurple/cmds.h bec0c741e6c534d1614e835d6994c387e967eedc
+++ libpurple/cmds.h 0a8d713282bfe229eb7754bd3ed095ccbd49a707
@@ -225,19 +225,16 @@ GList *purple_cmd_help(PurpleConversatio
/**
* Get the handle for the commands API
* @return The handle
- * @since 2.5.0
*/
gpointer purple_cmds_get_handle(void);
/**
* Initialize the commands subsystem.
- * @since 2.5.0
*/
void purple_cmds_init(void);
/**
* Uninitialize the commands subsystem.
- * @since 2.5.0
*/
void purple_cmds_uninit(void);
============================================================
--- libpurple/version.h.in 7efcc324b64b08cc6b78b4f7bdaea90cef660a8c
+++ libpurple/version.h.in 2ff700ee399bd0310242e081259e87690ac93827
@@ -56,8 +56,6 @@ const char *purple_version_check(guint r
* The major version of the running libpurple. Contrast with
* #PURPLE_MAJOR_VERSION, which expands at compile time to the major version of
* libpurple being compiled against.
- *
- * @since 2.4.0
*/
extern const guint purple_major_version;
@@ -65,8 +63,6 @@ extern const guint purple_major_version;
* The minor version of the running libpurple. Contrast with
* #PURPLE_MINOR_VERSION, which expands at compile time to the minor version of
* libpurple being compiled against.
- *
- * @since 2.4.0
*/
extern const guint purple_minor_version;
@@ -75,8 +71,6 @@ extern const guint purple_minor_version;
* The micro version of the running libpurple. Contrast with
* #PURPLE_MICRO_VERSION, which expands at compile time to the micro version of
* libpurple being compiled against.
- *
- * @since 2.4.0
*/
extern const guint purple_micro_version;
============================================================
--- libpurple/dbus-server.h b3d30a7bc5ae8a2c2d5e00747d74c0337592bad4
+++ libpurple/dbus-server.h a9cde0bb516c150b2edd122ee8639f668e7a6788
@@ -173,8 +173,6 @@ void *purple_dbus_get_handle(void);
/**
* Determines whether this instance owns the DBus service name
- *
- * @since 2.1.0
*/
gboolean purple_dbus_is_owner(void);
============================================================
--- pidgin/gtkthemes.h 3bd41f3a18dc25e924ea4cfd5c7b0b1c0d6b1726
+++ pidgin/gtkthemes.h d1facc025da4f4aa42008582aa76ceabea37f855
@@ -52,18 +52,12 @@ void pidgin_themes_smiley_themeize(GtkWi
void pidgin_themes_smiley_themeize(GtkWidget *);
-/**
- * @since 2.5.0
- */
void pidgin_themes_smiley_themeize_custom(GtkWidget *);
void pidgin_themes_smiley_theme_probe(void);
void pidgin_themes_load_smiley_theme(const char *file, gboolean load);
-/**
- * @since 2.1.0
- */
void pidgin_themes_remove_smiley_theme(const char *file);
GSList *pidgin_themes_get_proto_smileys(const char *id);
============================================================
--- doc/notify-signals.dox 56b19fdb4449654a44a21a4994d3931d5282be65
+++ doc/notify-signals.dox d554f2e8a4bcf2cab4e2d22b0aac3e61b2d7c42a
@@ -35,7 +35,6 @@ void (*displaying_email_notification)(co
@param from Who the email is from.
@param to Who the email is to.
@param url A url to view the email.
- @since 2.1.0
@endsignaldef
@signaldef displaying-emails-notification
@@ -53,7 +52,6 @@ void (*displaying_emails_notification)(c
@param tos Who the emails are to.
@param urls The urls to view the emails.
@param count Number of emails being notified of.
- @since 2.1.0
@endsignaldef
*/
============================================================
--- finch/gntblist.h 955404668c012274fdffb147e3903a6b2658bf2b
+++ finch/gntblist.h 22ef3c254006e1fdd5c565bdb9f492e062cd148b
@@ -115,15 +115,12 @@ void finch_blist_set_size(int width, int
* @param name The user to get information about.
*
* @return Returns the ui-handle for the userinfo notification.
- *
- * @since 2.1.0
*/
gpointer finch_retrieve_user_info(PurpleConnection *conn, const char *name);
/**
* Get the tree list of the buddy list.
* @return The GntTree widget.
- * @since 2.4.0
*/
GntTree * finch_blist_get_tree(void);
@@ -131,7 +128,6 @@ GntTree * finch_blist_get_tree(void);
* Add an alternate buddy list manager.
*
* @param manager The alternate buddylist manager.
- * @since 2.4.0
*/
void finch_blist_install_manager(const FinchBlistManager *manager);
@@ -139,7 +135,6 @@ void finch_blist_install_manager(const F
* Remove an alternate buddy list manager.
*
* @param manager The buddy list manager to remove.
- * @since 2.4.0
*/
void finch_blist_uninstall_manager(const FinchBlistManager *manager);
@@ -149,7 +144,6 @@ void finch_blist_uninstall_manager(const
* @param id The identifier for the desired buddy list manager.
*
* @return The manager with the requested identifier, if available. @c NULL otherwise.
- * @since 2.4.0
*/
FinchBlistManager * finch_blist_manager_find(const char *id);
@@ -157,7 +151,6 @@ FinchBlistManager * finch_blist_manager_
* Request the active buddy list manager to add a node.
*
* @param node The node to add
- * @since 2.4.0
*/
void finch_blist_manager_add_node(PurpleBlistNode *node);
============================================================
--- finch/gntaccount.h e4a988b3aab6dc666a5066f10a6b7f21cd243d30
+++ finch/gntaccount.h cea3bf330eabc9bca6ed71a42e91866648bbaf37
@@ -59,8 +59,6 @@ void finch_accounts_show_all(void);
* Show the edit dialog for an account.
*
* @param account The account to edit, or @c NULL to create a new account.
- *
- * @since 2.2.0
*/
void finch_account_dialog_show(PurpleAccount *account);
============================================================
--- finch/gntrequest.h 01f5edc69f49e248c5f4a35aff0960b31f6b5c20
+++ finch/gntrequest.h 04b61e34de7757f08e3314d3fc5dbed2c2f8c7f7
@@ -63,7 +63,6 @@ void finch_request_save_in_prefs(gpointe
* @param field The request field.
*
* @return A GntWidget for the request field.
- * @since 2.4.0
*/
GntWidget *finch_request_field_get_widget(PurpleRequestField *field);
/*@}*/
============================================================
--- libpurple/certificate.h ff97a04181b9f176e386fcd65c5e31e7b33bee4a
+++ libpurple/certificate.h dbabc811a5eebadde1308f263fbdaa6855920c58
@@ -2,7 +2,6 @@
* @file certificate.h Public-Key Certificate API
* @ingroup core
* @see @ref certificate-signals
- * @since 2.2.0
*/
/*
============================================================
--- finch/gntsound.h 7d3300e8cab7cee5e69fa501b56e380a1128df8e
+++ finch/gntsound.h 9abfe9f3d48afe3e40d461187867a68f9f7765e4
@@ -37,8 +37,6 @@
* Get the name of the active sound profile.
*
* @return The name of the profile
- *
- * @since 2.1.0
*/
const char *finch_sound_get_active_profile(void);
@@ -46,8 +44,6 @@ const char *finch_sound_get_active_profi
* Set the active profile. If the profile doesn't exist, nothing is changed.
*
* @param name The name of the profile
- *
- * @since 2.1.0
*/
void finch_sound_set_active_profile(const char *name);
@@ -56,8 +52,6 @@ void finch_sound_set_active_profile(cons
*
* @return A list of strings denoting sound profile names.
* Caller must free the list (but not the data).
- *
- * @since 2.1.0
*/
GList *finch_sound_get_profiles(void);
@@ -66,8 +60,6 @@ GList *finch_sound_get_profiles(void);
*
* @return Returns FALSE if preference is set to 'No sound', or if volume is
* set to zero.
- *
- * @since 2.2.0
*/
gboolean finch_sound_is_enabled(void);
@@ -75,15 +67,11 @@ gboolean finch_sound_is_enabled(void);
* Gets GNT sound UI ops.
*
* @return The UI operations structure.
- *
- * @since 2.1.0
*/
PurpleSoundUiOps *finch_sound_get_ui_ops(void);
/**
* Show the sound settings dialog.
- *
- * @since 2.1.0
*/
void finch_sounds_show_all(void);
============================================================
--- libpurple/media.h 446b57c35eaabf153e8b0ac42e01a3fbe83b0c45
+++ libpurple/media.h 0916e8525a5d2247daab3763459179a7e78ca2fb
@@ -57,8 +57,6 @@ extern "C" {
* Gets the media class's GType
*
* @return The media class's GType.
- *
- * @since 2.6.0
*/
GType purple_media_get_type(void);
@@ -68,8 +66,6 @@ GType purple_media_get_type(void);
* @param media The media session from which to retrieve session IDs.
*
* @return GList of session IDs. The caller must free the list.
- *
- * @since 2.6.0
*/
GList *purple_media_get_session_ids(PurpleMedia *media);
@@ -79,8 +75,6 @@ GList *purple_media_get_session_ids(Purp
* @param media The media session to retrieve the account from.
*
* @return The account retrieved.
- *
- * @since 2.6.0
*/
PurpleAccount *purple_media_get_account(PurpleMedia *media);
@@ -90,8 +84,6 @@ PurpleAccount *purple_media_get_account(
* @param media The media session to retrieve the prpl data from.
*
* @return The prpl data retrieved.
- *
- * @since 2.6.0
*/
gpointer purple_media_get_prpl_data(PurpleMedia *media);
@@ -100,8 +92,6 @@ gpointer purple_media_get_prpl_data(Purp
*
* @param media The media session to set the prpl data on.
* @param prpl_data The data to set on the media session.
- *
- * @since 2.6.0
*/
void purple_media_set_prpl_data(PurpleMedia *media, gpointer prpl_data);
@@ -111,8 +101,6 @@ void purple_media_set_prpl_data(PurpleMe
* @param media The media object to set the state on.
* @param error The format of the error message to send in the signal.
* @param ... The arguments to plug into the format.
- *
- * @since 2.6.0
*/
void purple_media_error(PurpleMedia *media, const gchar *error, ...);
@@ -122,8 +110,6 @@ void purple_media_error(PurpleMedia *med
* @param media The media object with which to end streams.
* @param session_id The session to end streams on.
* @param participant The participant to end streams with.
- *
- * @since 2.6.0
*/
void purple_media_end(PurpleMedia *media, const gchar *session_id,
const gchar *participant);
@@ -136,8 +122,6 @@ void purple_media_end(PurpleMedia *media
* @param session_id The id of the session of the stream being signaled.
* @param participant The participant of the stream being signaled.
* @param local TRUE if the info originated locally, FALSE if on the remote end.
- *
- * @since 2.6.0
*/
void purple_media_stream_info(PurpleMedia *media, PurpleMediaInfoType type,
const gchar *session_id, const gchar *participant,
@@ -158,8 +142,6 @@ void purple_media_stream_info(PurpleMedi
* @param media The media object to set the parameters on.
* @param num_params The number of parameters to pass
* @param params Array of @c GParameter to pass
- *
- * @since 2.8.0
*/
void purple_media_set_params(PurpleMedia *media,
guint num_params, GParameter *params);
@@ -172,8 +154,6 @@ void purple_media_set_params(PurpleMedia
* @param media The media object
*
* @return NULL-terminated array of names of supported parameters.
- *
- * @since 2.8.0
*/
const gchar **purple_media_get_available_params(PurpleMedia *media);
@@ -184,8 +164,6 @@ const gchar **purple_media_get_available
* @param param name of parameter
*
* @return @c TRUE if backend recognizes the parameter, @c FALSE otherwise.
- *
- * @since 2.8.0
*/
gboolean purple_media_param_is_supported(PurpleMedia *media, const gchar *param);
@@ -205,8 +183,6 @@ gboolean purple_media_param_is_supported
* @param params The parameters to pass to Farsight.
*
* @return @c TRUE The stream was added successfully, @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_add_stream(PurpleMedia *media, const gchar *sess_id,
const gchar *who, PurpleMediaSessionType type,
@@ -220,8 +196,6 @@ gboolean purple_media_add_stream(PurpleM
* @param sess_id The session id of the session to get the type from.
*
* @return The retreived session type.
- *
- * @since 2.6.0
*/
PurpleMediaSessionType purple_media_get_session_type(PurpleMedia *media, const gchar *sess_id);
@@ -231,8 +205,6 @@ PurpleMediaSessionType purple_media_get_
* @param media The media object to get the manager instance from.
*
* @return The PurpleMediaManager instance retrieved.
- *
- * @since 2.6.0
*/
struct _PurpleMediaManager *purple_media_get_manager(PurpleMedia *media);
@@ -243,8 +215,6 @@ struct _PurpleMediaManager *purple_media
* @param sess_id The session id of the session to get the codecs from.
*
* @return The retreieved codecs.
- *
- * @since 2.6.0
*/
GList *purple_media_get_codecs(PurpleMedia *media, const gchar *sess_id);
@@ -255,8 +225,6 @@ GList *purple_media_get_codecs(PurpleMed
* @param sess_id The session id of the session find the stream in.
* @param participant The name of the remote user to add the candidates for.
* @param remote_candidates The remote candidates to add.
- *
- * @since 2.6.0
*/
void purple_media_add_remote_candidates(PurpleMedia *media,
const gchar *sess_id,
@@ -269,8 +237,6 @@ void purple_media_add_remote_candidates(
* @param media The media object to find the session in.
* @param sess_id The session id of the session to find the stream in.
* @param participant The name of the remote user to get the candidates from.
- *
- * @since 2.6.0
*/
GList *purple_media_get_local_candidates(PurpleMedia *media,
const gchar *sess_id,
@@ -285,8 +251,6 @@ GList *purple_media_get_local_candidates
* from.
*
* @return The active candidates retrieved.
- *
- * @since 2.8.0
*/
GList *purple_media_get_active_local_candidates(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
@@ -300,8 +264,6 @@ GList *purple_media_get_active_local_can
* from.
*
* @return The remote candidates retrieved.
- *
- * @since 2.8.0
*/
GList *purple_media_get_active_remote_candidates(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
@@ -315,8 +277,6 @@ GList *purple_media_get_active_remote_ca
* @param codecs The list of remote codecs to set.
*
* @return @c TRUE The codecs were set successfully, or @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_set_remote_codecs(PurpleMedia *media, const gchar *sess_id,
const gchar *participant, GList *codecs);
@@ -329,8 +289,6 @@ gboolean purple_media_set_remote_codecs(
* @param participant The remote user to check for.
*
* @return @c TRUE All streams for the given session_id/participant combination have candidates prepared, @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_candidates_prepared(PurpleMedia *media,
const gchar *session_id, const gchar *participant);
@@ -343,8 +301,6 @@ gboolean purple_media_candidates_prepare
* @param codec The codec to set the session to stream.
*
* @return @c TRUE The codec was successfully changed, or @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_set_send_codec(PurpleMedia *media, const gchar *sess_id, PurpleMediaCodec *codec);
@@ -355,8 +311,6 @@ gboolean purple_media_set_send_codec(Pur
* @param sess_id The session id of the session to check.
*
* @return @c TRUE The codecs are ready, or @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_codecs_ready(PurpleMedia *media, const gchar *sess_id);
@@ -368,8 +322,6 @@ gboolean purple_media_codecs_ready(Purpl
* @param participant The participant of the stream to check.
*
* @return TRUE if the local user is the stream's initator, else FALSE.
- *
- * @since 2.6.0
*/
gboolean purple_media_is_initiator(PurpleMedia *media,
const gchar *sess_id, const gchar *participant);
@@ -382,8 +334,6 @@ gboolean purple_media_is_initiator(Purpl
* @param participant The participant to check.
*
* @return @c TRUE The selected streams have been accepted, or @c FALSE otherwise.
- *
- * @since 2.6.0
*/
gboolean purple_media_accepted(PurpleMedia *media, const gchar *sess_id,
const gchar *participant);
@@ -394,8 +344,6 @@ gboolean purple_media_accepted(PurpleMed
* @param media The media object the sessions are in.
* @param session_id The session to select (if any).
* @param level The level to set the volume to.
- *
- * @since 2.6.0
*/
void purple_media_set_input_volume(PurpleMedia *media, const gchar *session_id, double level);
@@ -406,8 +354,6 @@ void purple_media_set_input_volume(Purpl
* @param session_id The session to limit the streams to (if any).
* @param participant The participant to limit the streams to (if any).
* @param level The level to set the volume to.
- *
- * @since 2.6.0
*/
void purple_media_set_output_volume(PurpleMedia *media, const gchar *session_id,
const gchar *participant, double level);
@@ -421,8 +367,6 @@ void purple_media_set_output_volume(Purp
* @param window_id The window id use for embedding the video in.
*
* @return An id to reference the output window.
- *
- * @since 2.6.0
*/
gulong purple_media_set_output_window(PurpleMedia *media,
const gchar *session_id, const gchar *participant,
@@ -432,8 +376,6 @@ gulong purple_media_set_output_window(Pu
* Removes all output windows from a given media session.
*
* @param media The instance to remove all output windows from.
- *
- * @since 2.6.0
*/
void purple_media_remove_output_windows(PurpleMedia *media);
============================================================
--- libpurple/mediamanager.h dbc11bf0e2a89793ecbecaa713acd3d4ffaea9e1
+++ libpurple/mediamanager.h 0a60e6949deb5ed3ecf5a0925b83cc9b172ebd13
@@ -60,8 +60,6 @@ extern "C" {
* Gets the media manager's GType.
*
* @return The media manager's GType.
- *
- * @since 2.6.0
*/
GType purple_media_manager_get_type(void);
@@ -69,8 +67,6 @@ GType purple_media_manager_get_type(void
* Gets the "global" media manager object. It's created if it doesn't already exist.
*
* @return The "global" instance of the media manager object.
- *
- * @since 2.6.0
*/
PurpleMediaManager *purple_media_manager_get(void);
@@ -84,8 +80,6 @@ PurpleMediaManager *purple_media_manager
* @param initiator TRUE if the local user is the initiator of this media call, FALSE otherwise.
*
* @return A newly created media session.
- *
- * @since 2.6.0
*/
PurpleMedia *purple_media_manager_create_media(PurpleMediaManager *manager,
PurpleAccount *account,
@@ -99,8 +93,6 @@ PurpleMedia *purple_media_manager_create
* @param manager The media manager to get all of the sessions from.
*
* @return A list of all the media sessions.
- *
- * @since 2.6.0
*/
GList *purple_media_manager_get_media(PurpleMediaManager *manager);
@@ -111,8 +103,6 @@ GList *purple_media_manager_get_media(Pu
* @param account The account the sessions are on.
*
* @return A list of the media sessions on the given account.
- *
- * @since 2.6.0
*/
GList *purple_media_manager_get_media_by_account(
PurpleMediaManager *manager, PurpleAccount *account);
@@ -122,8 +112,6 @@ GList *purple_media_manager_get_media_by
*
* @param manager The media manager to remove the media session from.
* @param media The media session to remove.
- *
- * @since 2.6.0
*/
void
purple_media_manager_remove_media(PurpleMediaManager *manager,
@@ -140,8 +128,6 @@ purple_media_manager_remove_media(Purple
* @param participant The participant the output windows are registered with.
*
* @return TRUE if it succeeded, FALSE if it failed.
- *
- * @since 2.6.0
*/
gboolean purple_media_manager_create_output_window(
PurpleMediaManager *manager, PurpleMedia *media,
@@ -157,8 +143,6 @@ gboolean purple_media_manager_create_out
* @param window_id The window ID to embed the video in.
*
* @return A unique ID to the registered output window, 0 if it failed.
- *
- * @since 2.6.0
*/
gulong purple_media_manager_set_output_window(PurpleMediaManager *manager,
PurpleMedia *media, const gchar *session_id,
@@ -171,8 +155,6 @@ gulong purple_media_manager_set_output_w
* @param output_window_id The ID of the output window.
*
* @return TRUE if it found the output window and was successful, else FALSE.
- *
- * @since 2.6.0
*/
gboolean purple_media_manager_remove_output_window(
PurpleMediaManager *manager, gulong output_window_id);
@@ -184,8 +166,6 @@ gboolean purple_media_manager_remove_out
* @param media The media instance the output windows were registered for.
* @param session_id The session the output windows were registered for.
* @param participant The participant the output windows were registered for.
- *
- * @since 2.6.0
*/
void purple_media_manager_remove_output_windows(
PurpleMediaManager *manager, PurpleMedia *media,
@@ -196,8 +176,6 @@ void purple_media_manager_remove_output_
*
* @param manager The manager to set the caps on.
* @param caps The caps to set.
- *
- * @since 2.6.0
*/
void purple_media_manager_set_ui_caps(PurpleMediaManager *manager,
PurpleMediaCaps caps);
@@ -208,8 +186,6 @@ void purple_media_manager_set_ui_caps(Pu
* @param manager The manager to get caps from.
*
* @return caps The caps retrieved.
- *
- * @since 2.6.0
*/
PurpleMediaCaps purple_media_manager_get_ui_caps(PurpleMediaManager *manager);
@@ -218,8 +194,6 @@ PurpleMediaCaps purple_media_manager_get
*
* @param manager The manager to set the caps on.
* @param backend_type The media backend type to use.
- *
- * @since 2.7.0
*/
void purple_media_manager_set_backend_type(PurpleMediaManager *manager,
GType backend_type);
@@ -230,8 +204,6 @@ void purple_media_manager_set_backend_ty
* @param manager The manager to get the media backend type from.
*
* @return The type of media backend type media objects will use.
- *
- * @since 2.7.0
*/
GType purple_media_manager_get_backend_type(PurpleMediaManager *manager);
============================================================
--- libpurple/purple.h.in 5fa4dbee8684be3ea40b66dc3a3695979a2b967e
+++ libpurple/purple.h.in ac688dd051b90c18b5b50184a15cc81ab5b067a3
@@ -6,7 +6,6 @@
* include any other libpurple files.
*
* @ingroup core libpurple
- * @since 2.3.0
*/
/* purple
============================================================
--- pidgin/pidgintooltip.h 3848e49f3e0492c1fa7863d756b506db6045b263
+++ pidgin/pidgintooltip.h 180f1bf22356c60435f0999091dc5fc47367d071
@@ -36,7 +36,6 @@
* @param h The value of this should be set to the desired height of the tooltip window.
*
* @return @c TRUE if the tooltip was created correctly, @c FALSE otherwise.
- * @since 2.4.0
*/
typedef gboolean (*PidginTooltipCreateForTree)(GtkWidget *tipwindow,
GtkTreePath *path, gpointer userdata, int *w, int *h);
@@ -48,7 +47,6 @@ typedef gboolean (*PidginTooltipCreateFo
* @param h The value of this should be set to the desired height of the tooltip window.
*
* @return @c TRUE if the tooltip was created correctly, @c FALSE otherwise.
- * @since 2.4.0
*/
typedef gboolean (*PidginTooltipCreate)(GtkWidget *tipwindow,
gpointer userdata, int *w, int *h);
@@ -58,7 +56,6 @@ typedef gboolean (*PidginTooltipCreate)(
* @param userdata The userdata set during pidgin_tooltip_setup_for_treeview or pidgin_tooltip_show.
*
* @return @c TRUE if the tooltip was painted correctly, @c FALSE otherwise.
- * @since 2.4.0
*/
typedef gboolean (*PidginTooltipPaint)(GtkWidget *tipwindow, gpointer userdata);
@@ -71,7 +68,6 @@ typedef gboolean (*PidginTooltipPaint)(G
* @param paint_cb Callback function to paint the tooltip
*
* @return @c TRUE if the tooltip callbacks were setup correctly.
- * @since 2.4.0
*/
gboolean pidgin_tooltip_setup_for_treeview(GtkWidget *tree, gpointer userdata,
PidginTooltipCreateForTree create_cb, PidginTooltipPaint paint_cb);
@@ -85,14 +81,12 @@ gboolean pidgin_tooltip_setup_for_treevi
* @param paint_cb Callback function to paint the tooltip
*
* @return @c TRUE if the tooltip callbacks were setup correctly.
- * @since 2.4.0
*/
gboolean pidgin_tooltip_setup_for_widget(GtkWidget *widget, gpointer userdata,
PidginTooltipCreate create_cb, PidginTooltipPaint paint_cb);
/**
* Destroy the tooltip.
- * @since 2.4.0
*/
void pidgin_tooltip_destroy(void);
@@ -103,8 +97,6 @@ void pidgin_tooltip_destroy(void);
* @param userdata The userdata to send to the callback functions
* @param create_cb Callback function to create the tooltip from the GtkTreePath
* @param paint_cb Callback function to paint the tooltip
- *
- * @since 2.4.0
*/
void pidgin_tooltip_show(GtkWidget *widget, gpointer userdata,
PidginTooltipCreate create_cb, PidginTooltipPaint paint_cb);
============================================================
--- libpurple/smiley.h 2f37c7d0c8c3ceecc9980095592c58e01e93f093
+++ libpurple/smiley.h aed301f685799b3255c89bdde291c2545065af0d
@@ -1,7 +1,6 @@
/**
* @file smiley.h Smiley API
* @ingroup core
- * @since 2.5.0
*/
/* purple
============================================================
--- pidgin/gtksmiley.c 3abe4ba004fe89d76b6d8177f72047f8c6d0da25
+++ pidgin/gtksmiley.c 2ac2e46e2106abc9c009d83a3d4a3c4d5c6dc70c
@@ -47,9 +47,9 @@ struct _PidginSmiley
GtkWidget *smiley_image;
gchar *filename;
GdkPixbuf *custom_pixbuf;
- gpointer data; /** @since 2.6.0 */
- gsize datasize; /** @since 2.6.0 */
- gint entry_len; /** @since 2.6.0 */
+ gpointer data;
+ gsize datasize;
+ gint entry_len;
};
typedef struct
============================================================
--- pidgin/gtksmiley.h a733b639804437d392214410941f0ccf96064c7d
+++ pidgin/gtksmiley.h cef7b37434fbb6898210da12aa7295b5f790660f
@@ -1,7 +1,6 @@
/**
* @file gtksmiley.h GTK+ Custom Smiley API
* @ingroup pidgin
- * @since 2.5.0
*/
/* pidgin
@@ -106,8 +105,6 @@ void pidgin_smiley_editor_set_image(Pidg
* @param editor A smiley editor dialog
* @param data A pointer to smiley's data
* @param datasize The size of smiley's data
- *
- * @since 2.6.0
*/
void pidgin_smiley_editor_set_data(PidginSmiley *editor, gpointer data, gsize datasize);
============================================================
--- libpurple/media-gst.h 4b2ed89f2709e7a9b4a4852f8a6cbdb878eabf35
+++ libpurple/media-gst.h e550602d051b926df7f5560baf307c88190fc972
@@ -81,8 +81,6 @@ extern "C" {
* Gets the element type's GType.
*
* @return The element type's GType.
- *
- * @since 2.6.0
*/
GType purple_media_element_type_get_type(void);
@@ -90,8 +88,6 @@ GType purple_media_element_type_get_type
* Gets the element info's GType.
*
* @return The element info's GType.
- *
- * @since 2.6.0
*/
GType purple_media_element_info_get_type(void);
@@ -102,8 +98,6 @@ GType purple_media_element_info_get_type
* @param sess_id The session id of the session to get the source from.
*
* @return The source retrieved.
- *
- * @since 2.6.0
*/
GstElement *purple_media_get_src(PurpleMedia *media, const gchar *sess_id);
@@ -115,8 +109,6 @@ GstElement *purple_media_get_src(PurpleM
* @param participant Optionally, the participant of the stream to get the tee from.
*
* @return The GstTee element from the chosen session/stream.
- *
- * @since 2.6.0
*/
GstElement *purple_media_get_tee(PurpleMedia *media,
const gchar *session_id, const gchar *participant);
@@ -128,8 +120,6 @@ GstElement *purple_media_get_tee(PurpleM
* @param manager The media manager to get the pipeline from.
*
* @return The pipeline.
- *
- * @since 2.6.0
*/
GstElement *purple_media_manager_get_pipeline(PurpleMediaManager *manager);
@@ -141,8 +131,6 @@ GstElement *purple_media_manager_get_pip
* @param media The media call this element is requested for.
* @param session_id The id of the session this element is requested for or NULL.
* @param participant The remote user this element is requested for or NULL.
- *
- * @since 2.6.0
*/
GstElement *purple_media_manager_get_element(PurpleMediaManager *manager,
PurpleMediaSessionType type, PurpleMedia *media,
@@ -167,8 +155,6 @@ PurpleMediaElementInfo *purple_media_man
*
* @param manager The media manager to set the media formats.
* @param caps Set of allowed media formats.
- *
- * @since 2.8.0
*/
void purple_media_manager_set_video_caps(PurpleMediaManager *manager,
GstCaps *caps);
@@ -179,8 +165,6 @@ void purple_media_manager_set_video_caps
* @param manager The media manager to get the media formats from.
*
* @return @c GstCaps limiting the video source's formats.
- *
- * @since 2.8.0
*/
GstCaps *purple_media_manager_get_video_caps(PurpleMediaManager *manager);
============================================================
--- libpurple/media/enum-types.h 47956e4afc314aa1048ee606584fcf8553c533c6
+++ libpurple/media/enum-types.h cecc79c5c5857a990308fe2a867d3b5c3325ac58
@@ -107,8 +107,6 @@ typedef enum {
* Gets the media candidate type's GType
*
* @return The media candidate type's GType.
- *
- * @since 2.6.0
*/
GType purple_media_candidate_type_get_type(void);
@@ -116,8 +114,6 @@ GType purple_media_candidate_type_get_ty
* Gets the type of the media caps flags
*
* @return The media caps flags' GType
- *
- * @since 2.7.0
*/
GType purple_media_caps_get_type(void);
@@ -125,8 +121,6 @@ GType purple_media_caps_get_type(void);
* Gets the type of the info type enum
*
* @return The info type enum's GType
- *
- * @since 2.6.0
*/
GType purple_media_info_type_get_type(void);
@@ -134,8 +128,6 @@ GType purple_media_info_type_get_type(vo
* Gets the media network protocol's GType
*
* @return The media network protocol's GType.
- *
- * @since 2.6.0
*/
GType purple_media_network_protocol_get_type(void);
@@ -143,8 +135,6 @@ GType purple_media_network_protocol_get_
* Gets the media session type's GType
*
* @return The media session type's GType.
- *
- * @since 2.6.0
*/
GType purple_media_session_type_get_type(void);
@@ -152,8 +142,6 @@ GType purple_media_session_type_get_type
* Gets the type of the state-changed enum
*
* @return The state-changed enum's GType
- *
- * @since 2.6.0
*/
GType purple_media_state_changed_get_type(void);
============================================================
--- libpurple/media/candidate.h 8d363729421aaf9390ee97b26a30a104dde785b1
+++ libpurple/media/candidate.h dab1c98a357167d690809894283a8194316b8c49
@@ -47,8 +47,6 @@ typedef struct _PurpleMediaCandidate Pur
* Gets the type of the media candidate structure.
*
* @return The media canditate's GType
- *
- * @since 2.6.0
*/
GType purple_media_candidate_get_type(void);
@@ -63,8 +61,6 @@ GType purple_media_candidate_get_type(vo
* @param port The network port.
*
* @return The newly created PurpleMediaCandidate instance.
- *
- * @since 2.6.0
*/
PurpleMediaCandidate *purple_media_candidate_new(
const gchar *foundation, guint component_id,
@@ -78,8 +74,6 @@ PurpleMediaCandidate *purple_media_candi
* @param candidate The candidate to copy.
*
* @return The copy of the PurpleMediaCandidate.
- *
- * @since 2.7.0
*/
PurpleMediaCandidate *purple_media_candidate_copy(
PurpleMediaCandidate *candidate);
@@ -90,8 +84,6 @@ PurpleMediaCandidate *purple_media_candi
* @param candidates The list of candidates to be copied.
*
* @return The copy of the GList.
- *
- * @since 2.6.0
*/
GList *purple_media_candidate_list_copy(GList *candidates);
@@ -99,8 +91,6 @@ GList *purple_media_candidate_list_copy(
* Frees a GList of PurpleMediaCandidate and its contents.
*
* @param candidates The list of candidates to be freed.
- *
- * @since 2.6.0
*/
void purple_media_candidate_list_free(GList *candidates);
@@ -110,8 +100,6 @@ void purple_media_candidate_list_free(GL
* @param candidate The candidate to get the foundation from.
*
* @return The foundation.
- *
- * @since 2.6.0
*/
gchar *purple_media_candidate_get_foundation(PurpleMediaCandidate *candidate);
@@ -121,8 +109,6 @@ gchar *purple_media_candidate_get_founda
* @param candidate The candidate to get the compnent id from.
*
* @return The component id.
- *
- * @since 2.6.0
*/
guint purple_media_candidate_get_component_id(PurpleMediaCandidate *candidate);
@@ -132,8 +118,6 @@ guint purple_media_candidate_get_compone
* @param candidate The candidate to get the IP address from.
*
* @return The IP address.
- *
- * @since 2.6.0
*/
gchar *purple_media_candidate_get_ip(PurpleMediaCandidate *candidate);
@@ -143,8 +127,6 @@ gchar *purple_media_candidate_get_ip(Pur
* @param candidate The candidate to get the port from.
*
* @return The port.
- *
- * @since 2.6.0
*/
guint16 purple_media_candidate_get_port(PurpleMediaCandidate *candidate);
@@ -156,8 +138,6 @@ guint16 purple_media_candidate_get_port(
* @param candidate The candidate to get the base IP address from.
*
* @return The base IP address.
- *
- * @since 2.6.0
*/
gchar *purple_media_candidate_get_base_ip(PurpleMediaCandidate *candidate);
@@ -169,8 +149,6 @@ gchar *purple_media_candidate_get_base_i
* @param candidate The candidate to get the base port.
*
* @return The base port.
- *
- * @since 2.6.0
*/
guint16 purple_media_candidate_get_base_port(PurpleMediaCandidate *candidate);
@@ -180,8 +158,6 @@ guint16 purple_media_candidate_get_base_
* @param candidate The candidate to get the protocol from.
*
* @return The protocol.
- *
- * @since 2.6.0
*/
PurpleMediaNetworkProtocol purple_media_candidate_get_protocol(
PurpleMediaCandidate *candidate);
@@ -192,8 +168,6 @@ PurpleMediaNetworkProtocol purple_media_
* @param candidate The candidate to get the priority from.
*
* @return The priority.
- *
- * @since 2.6.0
*/
guint32 purple_media_candidate_get_priority(PurpleMediaCandidate *candidate);
@@ -203,8 +177,6 @@ guint32 purple_media_candidate_get_prior
* @param candidate The candidate to get the candidate type from.
*
* @return The candidate type.
- *
- * @since 2.6.0
*/
PurpleMediaCandidateType purple_media_candidate_get_candidate_type(
PurpleMediaCandidate *candidate);
@@ -217,8 +189,6 @@ PurpleMediaCandidateType purple_media_ca
* @param The candidate to get the username from.
*
* @return The username.
- *
- * @since 2.6.0
*/
gchar *purple_media_candidate_get_username(PurpleMediaCandidate *candidate);
@@ -230,8 +200,6 @@ gchar *purple_media_candidate_get_userna
* @param The candidate to get the password from.
*
* @return The password.
- *
- * @since 2.6.0
*/
gchar *purple_media_candidate_get_password(PurpleMediaCandidate *candidate);
@@ -241,8 +209,6 @@ gchar *purple_media_candidate_get_passwo
* @param The candidate to get the TTL from.
*
* @return The TTL.
- *
- * @since 2.6.0
*/
guint purple_media_candidate_get_ttl(PurpleMediaCandidate *candidate);
============================================================
--- libpurple/media/codec.h 333c5528dde3a1cc8ca9bebad5b8dd6f918ba110
+++ libpurple/media/codec.h 6af8bba48647c0bbf374be64ddecc6dfca5d1dbd
@@ -50,8 +50,6 @@ G_BEGIN_DECLS
* Gets the type of the media codec structure.
*
* @return The media codec's GType
- *
- * @since 2.6.0
*/
GType purple_media_codec_get_type(void);
@@ -64,8 +62,6 @@ GType purple_media_codec_get_type(void);
* @param clock_rate The clock rate this codec encodes at, if applicable.
*
* @return The newly created PurpleMediaCodec.
- *
- * @since 2.6.0
*/
PurpleMediaCodec *purple_media_codec_new(int id, const char *encoding_name,
PurpleMediaSessionType media_type, guint clock_rate);
@@ -76,8 +72,6 @@ PurpleMediaCodec *purple_media_codec_new
* @param The codec to get the id from.
*
* @return The codec id.
- *
- * @since 2.6.0
*/
guint purple_media_codec_get_id(PurpleMediaCodec *codec);
@@ -87,8 +81,6 @@ guint purple_media_codec_get_id(PurpleMe
* @param The codec to get the encoding name from.
*
* @return The encoding name.
- *
- * @since 2.6.0
*/
gchar *purple_media_codec_get_encoding_name(PurpleMediaCodec *codec);
@@ -98,8 +90,6 @@ gchar *purple_media_codec_get_encoding_n
* @param The codec to get the clock rate from.
*
* @return The clock rate.
- *
- * @since 2.6.0
*/
guint purple_media_codec_get_clock_rate(PurpleMediaCodec *codec);
@@ -109,8 +99,6 @@ guint purple_media_codec_get_clock_rate(
* @param The codec to get the number of channels from.
*
* @return The number of channels.
- *
- * @since 2.6.0
*/
guint purple_media_codec_get_channels(PurpleMediaCodec *codec);
@@ -123,8 +111,6 @@ guint purple_media_codec_get_channels(Pu
*
* @return The list of optional parameters. The list is owned by the codec and
* should not be freed.
- *
- * @since 2.6.0
*/
GList *purple_media_codec_get_optional_parameters(PurpleMediaCodec *codec);
@@ -134,8 +120,6 @@ GList *purple_media_codec_get_optional_p
* @param codec The codec to add the parameter to.
* @param name The name of the parameter to add.
* @param value The value of the parameter to add.
- *
- * @since 2.6.0
*/
void purple_media_codec_add_optional_parameter(PurpleMediaCodec *codec,
const gchar *name, const gchar *value);
@@ -145,8 +129,6 @@ void purple_media_codec_add_optional_par
*
* @param codec The codec to remove the parameter from.
* @param param A pointer to the parameter to remove.
- *
- * @since 2.6.0
*/
void purple_media_codec_remove_optional_parameter(PurpleMediaCodec *codec,
PurpleKeyValuePair *param);
@@ -159,8 +141,6 @@ void purple_media_codec_remove_optional_
* @param value The value to search for or NULL.
*
* @return The value found or NULL.
- *
- * @since 2.6.0
*/
PurpleKeyValuePair *purple_media_codec_get_optional_parameter(
PurpleMediaCodec *codec, const gchar *name,
@@ -172,8 +152,6 @@ PurpleKeyValuePair *purple_media_codec_g
* @param codec The codec to copy.
*
* @return The copy of the codec.
- *
- * @since 2.7.0
*/
PurpleMediaCodec *purple_media_codec_copy(PurpleMediaCodec *codec);
@@ -183,8 +161,6 @@ PurpleMediaCodec *purple_media_codec_cop
* @param codecs The list of codecs to be copied.
*
* @return The copy of the GList.
- *
- * @since 2.6.0
*/
GList *purple_media_codec_list_copy(GList *codecs);
@@ -192,8 +168,6 @@ GList *purple_media_codec_list_copy(GLis
* Frees a GList of PurpleMediaCodec and its contents.
*
* @param codecs The list of codecs to be freed.
- *
- * @since 2.6.0
*/
void purple_media_codec_list_free(GList *codecs);
@@ -203,8 +177,6 @@ void purple_media_codec_list_free(GList
* @param codec The codec to create the string of.
*
* @return The new string representation.
- *
- * @since 2.6.0
*/
gchar *purple_media_codec_to_string(const PurpleMediaCodec *codec);
============================================================
--- libpurple/media/backend-iface.h 320648565c761b97a84fb95fec1c0d8bd97a59a1
+++ libpurple/media/backend-iface.h 0c72ba7c6ba757326960002e99fa2bad72d3f321
@@ -77,8 +77,6 @@ struct _PurpleMediaBackendIface
* Gets the media backend's GType.
*
* @return The media backend's GType.
- *
- * @since 2.7.0
*/
GType purple_media_backend_get_type(void);
@@ -95,8 +93,6 @@ GType purple_media_backend_get_type(void
* @param params The additional parameters to pass when creating the stream.
*
* @return True if the stream was successfully created, othewise False.
- *
- * @since 2.7.0
*/
gboolean purple_media_backend_add_stream(PurpleMediaBackend *self,
const gchar *sess_id, const gchar *who,
@@ -111,8 +107,6 @@ gboolean purple_media_backend_add_stream
* @param sess_id The session id associated with the stream.
* @param participant The participant associated with the stream.
* @param remote_candidates The list of remote candidates to add.
- *
- * @since 2.7.0
*/
void purple_media_backend_add_remote_candidates(PurpleMediaBackend *self,
const gchar *sess_id, const gchar *participant,
@@ -128,8 +122,6 @@ void purple_media_backend_add_remote_can
* @param sess_id The session id of the session to check.
*
* @return True if the codecs are ready, otherwise False.
- *
- * @since 2.7.0
*/
gboolean purple_media_backend_codecs_ready(PurpleMediaBackend *self,
const gchar *sess_id);
@@ -144,8 +136,6 @@ gboolean purple_media_backend_codecs_rea
* @param sess_id The session id of the session to use.
*
* @return The codec intersection list.
- *
- * @since 2.7.0
*/
GList *purple_media_backend_get_codecs(PurpleMediaBackend *self,
const gchar *sess_id);
@@ -158,8 +148,6 @@ GList *purple_media_backend_get_codecs(P
* @param particilant The participant associated with the stream.
*
* @return The list of local candidates.
- *
- * @since 2.7.0
*/
GList *purple_media_backend_get_local_candidates(PurpleMediaBackend *self,
const gchar *sess_id, const gchar *participant);
@@ -173,8 +161,6 @@ GList *purple_media_backend_get_local_ca
* @param codecs The list of remote codecs to set.
*
* @return True if the remote codecs were set successfully, otherwise False.
- *
- * @since 2.7.0
*/
gboolean purple_media_backend_set_remote_codecs(PurpleMediaBackend *self,
const gchar *sess_id, const gchar *participant,
@@ -188,8 +174,6 @@ gboolean purple_media_backend_set_remote
* @param codec The codec to set.
*
* @return True if set successfully, otherwise False.
- *
- * @since 2.7.0
*/
gboolean purple_media_backend_set_send_codec(PurpleMediaBackend *self,
const gchar *sess_id, PurpleMediaCodec *codec);
@@ -200,8 +184,6 @@ gboolean purple_media_backend_set_send_c
* @param self The media backend to set the parameters on.
* @param num_params The number of parameters to pass to backend
* @param params Array of @c GParameter to pass to backend
- *
- * @since 2.8.0
*/
void purple_media_backend_set_params(PurpleMediaBackend *self,
guint num_params, GParameter *params);
@@ -214,8 +196,6 @@ void purple_media_backend_set_params(Pur
* @param self The media backend
*
* @return NULL-terminated array of names of supported parameters.
- *
- * @since 2.8.0
*/
const gchar **purple_media_backend_get_available_params(PurpleMediaBackend *self);
============================================================
--- libpurple/media/backend-fs2.h d0c98270d331a2386413bdc2057c6dac0da72c28
+++ libpurple/media/backend-fs2.h 571ff96b62bc7db5985c26cded288faa31cb5bf6
@@ -50,8 +50,6 @@ typedef struct _PurpleMediaBackendFs2 Pu
* Gets the type of the Farsight 2 media backend object.
*
* @return The Farsight 2 media backend's GType
- *
- * @since 2.7.0
*/
GType purple_media_backend_fs2_get_type(void);
More information about the Commits
mailing list