/soc/2013/ankitkv/gobjectification: d9bcdc9a91e6: Revert changes...

Ankit Vani a at nevitus.org
Wed Jan 29 00:24:44 EST 2014


Changeset: d9bcdc9a91e621822addd499bdbdfd5799604118
Author:	 Ankit Vani <a at nevitus.org>
Date:	 2014-01-29 10:49 +0530
Branch:	 soc.2013.gobjectification.plugins
URL: https://hg.pidgin.im/soc/2013/ankitkv/gobjectification/rev/d9bcdc9a91e6

Description:

Revert changes to doc comments

diffstat:

 finch/gntaccount.h              |    4 +-
 finch/gntblist.h                |   34 +-
 finch/gntconn.h                 |    2 +-
 finch/gntconv.h                 |    8 +-
 finch/gntdebug.h                |    2 +-
 finch/gntidle.h                 |    2 +-
 finch/gntlog.h                  |    2 +-
 finch/gntmenuutil.h             |    6 +-
 finch/gntnotify.h               |    2 +-
 finch/gntplugin.h               |    8 +-
 finch/gntpounce.h               |    8 +-
 finch/gntrequest.h              |    6 +-
 finch/gntroomlist.h             |    2 +-
 finch/gntsound.h                |   10 +-
 finch/gntstatus.h               |    2 +-
 finch/gntxfer.h                 |   14 +-
 finch/libgnt/gnt-skel.h         |    4 +-
 finch/libgnt/gnt.h              |   58 +-
 finch/libgnt/gntbindable.h      |   46 +-
 finch/libgnt/gntbox.h           |   52 +-
 finch/libgnt/gntbutton.h        |    6 +-
 finch/libgnt/gntcheckbox.h      |   14 +-
 finch/libgnt/gntclipboard.h     |   10 +-
 finch/libgnt/gntcolors.h        |   18 +-
 finch/libgnt/gntcombobox.h      |   24 +-
 finch/libgnt/gntentry.h         |   52 +-
 finch/libgnt/gntfilesel.h       |   56 +-
 finch/libgnt/gntkeys.h          |   18 +-
 finch/libgnt/gntlabel.h         |   16 +-
 finch/libgnt/gntline.h          |    6 +-
 finch/libgnt/gntmenu.h          |   16 +-
 finch/libgnt/gntmenuitem.h      |   40 +-
 finch/libgnt/gntmenuitemcheck.h |   14 +-
 finch/libgnt/gntprogressbar.h   |   28 +-
 finch/libgnt/gntslider.h        |   44 +-
 finch/libgnt/gntstyle.h         |   44 +-
 finch/libgnt/gnttextview.h      |   64 +-
 finch/libgnt/gnttree.h          |  262 ++++++------
 finch/libgnt/gntutils.h         |   74 +-
 finch/libgnt/gntwidget.h        |   78 +-
 finch/libgnt/gntwindow.h        |   28 +-
 finch/libgnt/gntwm.h            |   78 +-
 finch/libgnt/gntws.h            |   42 +-
 libpurple/account.h             |  852 +++++++++++++++++----------------------
 libpurple/accountopt.h          |  142 +++---
 libpurple/accounts.h            |   28 +-
 libpurple/blistnode.h           |  126 ++--
 libpurple/blistnodetypes.h      |  170 +++---
 libpurple/buddyicon.h           |  140 +++---
 libpurple/buddylist.h           |  114 ++--
 libpurple/certificate.h         |  244 +++++-----
 libpurple/cipher.h              |  120 ++--
 libpurple/circularbuffer.h      |   38 +-
 libpurple/cmds.h                |   46 +-
 libpurple/connection.h          |  100 ++--
 libpurple/conversation.h        |  224 +++++-----
 libpurple/conversations.h       |   46 +-
 libpurple/conversationtypes.h   |  236 +++++-----
 libpurple/core.h                |   18 +-
 libpurple/dbus-server.h         |   20 +-
 libpurple/debug.h               |   44 +-
 libpurple/desktopitem.h         |   20 +-
 libpurple/dnsquery.h            |   26 +-
 libpurple/dnssrv.h              |   52 +-
 libpurple/e2ee.h                |   60 +-
 libpurple/eventloop.h           |   76 +-
 libpurple/http.h                |  326 +++++++-------
 libpurple/idle.h                |    4 +-
 libpurple/imgstore.h            |   54 +-
 libpurple/internal.h            |   48 +-
 libpurple/keyring.h             |  158 +++---
 libpurple/log.h                 |  158 +++---
 libpurple/media-gst.h           |   40 +-
 libpurple/media.h               |  194 ++++----
 libpurple/media/backend-fs2.h   |   10 +-
 libpurple/media/backend-iface.h |  119 ++---
 libpurple/media/candidate.h     |  134 ++---
 libpurple/media/codec.h         |  111 ++---
 libpurple/media/enum-types.h    |   66 +--
 libpurple/mediamanager.h        |   82 +-
 libpurple/mime.h                |   64 +-
 libpurple/nat-pmp.h             |   16 +-
 libpurple/network.h             |   78 +-
 libpurple/notify.h              |  238 +++++-----
 libpurple/ntlm.h                |   26 +-
 libpurple/pluginpref.h          |  100 ++--
 libpurple/plugins.h             |  200 ++++----
 libpurple/pounce.h              |  134 +++---
 libpurple/prefs.h               |  122 ++--
 libpurple/presence.h            |   90 ++--
 libpurple/protocol.h            |  124 ++--
 libpurple/protocols.h           |  178 ++++----
 libpurple/proxy.h               |  100 ++--
 libpurple/purple-socket.h       |   76 +-
 libpurple/request-datasheet.h   |  126 ++--
 libpurple/request.h             |  864 ++++++++++++++++++++--------------------
 libpurple/roomlist.h            |  124 ++--
 libpurple/savedstatuses.h       |  114 ++--
 libpurple/server.h              |   62 +-
 libpurple/signals.h             |  116 ++--
 libpurple/smiley.h              |   64 +-
 libpurple/sound-theme.h         |   18 +-
 libpurple/sound.h               |   14 +-
 libpurple/sslconn.h             |  106 ++--
 libpurple/status.h              |  220 +++++-----
 libpurple/stringref.h           |   34 +-
 libpurple/stun.h                |    4 +-
 libpurple/theme-loader.h        |   16 +-
 libpurple/theme-manager.h       |   20 +-
 libpurple/theme.h               |   48 +-
 libpurple/upnp.h                |   30 +-
 libpurple/util.h                |  562 +++++++++++++-------------
 libpurple/version.h.in          |    8 +-
 libpurple/whiteboard.h          |  126 ++--
 libpurple/xfer.h                |  316 +++++++-------
 libpurple/xmlnode.h             |  160 +++---
 pidgin/gtkaccount.h             |    8 +-
 pidgin/gtkblist-theme.h         |  156 +++---
 pidgin/gtkblist.h               |   66 +-
 pidgin/gtkconn.h                |    4 +-
 pidgin/gtkconv-theme.h          |   50 +-
 pidgin/gtkconv.h                |   48 +-
 pidgin/gtkdebug.h               |    4 +-
 pidgin/gtkdnd-hints.h           |   12 +-
 pidgin/gtkeventloop.h           |    2 +-
 pidgin/gtkicon-theme.h          |   12 +-
 pidgin/gtkidle.h                |    2 +-
 pidgin/gtkimhtml.h              |  296 ++++++------
 pidgin/gtklog.h                 |    2 +-
 pidgin/gtkmenutray.h            |   26 +-
 pidgin/gtknotify.h              |   18 +-
 pidgin/gtkplugin.h              |    8 +-
 pidgin/gtkpluginpref.h          |    4 +-
 pidgin/gtkpounce.h              |    8 +-
 pidgin/gtkprefs.h               |   60 +-
 pidgin/gtkprivacy.h             |    8 +-
 pidgin/gtkrequest.h             |    8 +-
 pidgin/gtkroomlist.h            |    4 +-
 pidgin/gtksavedstatuses.h       |   12 +-
 pidgin/gtksession.h             |    6 +-
 pidgin/gtksmiley.h              |   26 +-
 pidgin/gtksound.h               |   14 +-
 pidgin/gtkutils.h               |  398 +++++++++---------
 pidgin/gtkwebview.h             |  260 ++++++------
 pidgin/gtkwebviewtoolbar.h      |   20 +-
 pidgin/gtkwhiteboard.h          |    2 +-
 pidgin/gtkxfer.h                |   32 +-
 pidgin/minidialog.h             |   48 +-
 pidgin/pidginstock.h            |    2 +-
 pidgin/pidgintooltip.h          |   50 +-
 150 files changed, 5954 insertions(+), 6170 deletions(-)

diffs (truncated from 30332 to 300 lines):

diff --git a/finch/gntaccount.h b/finch/gntaccount.h
--- a/finch/gntaccount.h
+++ b/finch/gntaccount.h
@@ -36,7 +36,7 @@
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleAccountUiOps structure populated with the appropriate functions.
+ * @return The PurpleAccountUiOps structure populated with the appropriate functions.
  */
 PurpleAccountUiOps *finch_accounts_get_ui_ops(void);
 
@@ -58,7 +58,7 @@ void finch_accounts_show_all(void);
 /**
  * Show the edit dialog for an account.
  *
- * @account:  The account to edit, or %NULL to create a new account.
+ * @param account  The account to edit, or @c NULL to create a new account.
  */
 void finch_account_dialog_show(PurpleAccount *account);
 
diff --git a/finch/gntblist.h b/finch/gntblist.h
--- a/finch/gntblist.h
+++ b/finch/gntblist.h
@@ -55,7 +55,7 @@ typedef struct
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleBlistUiOps structure populated with the appropriate functions.
+ * @return The PurpleBlistUiOps structure populated with the appropriate functions.
  */
 PurpleBlistUiOps * finch_blist_get_ui_ops(void);
 
@@ -78,9 +78,9 @@ void finch_blist_show(void);
  * Get the position of the buddy list.
  *
  * @param x The x-coordinate is set here if not @ NULL.
- * @param y The y-coordinate is set here if not %NULL.
+ * @param y The y-coordinate is set here if not @c NULL.
  *
- * Returns: Returns %TRUE if the values were set, %FALSE otherwise.
+ * @return Returns @c TRUE if the values were set, @c FALSE otherwise.
  */
 gboolean finch_blist_get_position(int *x, int *y);
 
@@ -95,64 +95,64 @@ void finch_blist_set_position(int x, int
 /**
  * Get the size of the buddy list.
  *
- * @width:  The width is set here if not @ NULL.
- * @height: The height is set here if not %NULL.
+ * @param width  The width is set here if not @ NULL.
+ * @param height The height is set here if not @c NULL.
  *
- * Returns: Returns %TRUE if the values were set, %FALSE otherwise.
+ * @return Returns @c TRUE if the values were set, @c FALSE otherwise.
  */
 gboolean finch_blist_get_size(int *width, int *height);
 
 /**
  * Set the size of the buddy list.
  *
- * @width:  The width of the buddy list.
- * @height: The height of the buddy list.
+ * @param width  The width of the buddy list.
+ * @param height The height of the buddy list.
  */
 void finch_blist_set_size(int width, int height);
 
 /**
  * Get information about a user. Show immediate feedback.
  *
- * @conn:   The connection to get information fro
- * @name:   The user to get information about.
+ * @param conn   The connection to get information fro
+ * @param name   The user to get information about.
  *
- * Returns:  Returns the ui-handle for the userinfo notification.
+ * @return  Returns the ui-handle for the userinfo notification.
  */
 gpointer finch_retrieve_user_info(PurpleConnection *conn, const char *name);
 
 /**
  * Get the tree list of the buddy list.
- * Returns:  The GntTree widget.
+ * @return  The GntTree widget.
  */
 GntTree * finch_blist_get_tree(void);
 
 /**
  * Add an alternate buddy list manager.
  *
- * @manager:   The alternate buddylist manager.
+ * @param manager   The alternate buddylist manager.
  */
 void finch_blist_install_manager(const FinchBlistManager *manager);
 
 /**
  * Remove an alternate buddy list manager.
  *
- * @manager:   The buddy list manager to remove.
+ * @param manager   The buddy list manager to remove.
  */
 void finch_blist_uninstall_manager(const FinchBlistManager *manager);
 
 /**
  * Find a buddy list manager.
  *
- * @id:   The identifier for the desired buddy list manager.
+ * @param id   The identifier for the desired buddy list manager.
  *
- * Returns:  The manager with the requested identifier, if available. %NULL otherwise.
+ * @return  The manager with the requested identifier, if available. @c NULL otherwise.
  */
 FinchBlistManager * finch_blist_manager_find(const char *id);
 
 /**
  * Request the active buddy list manager to add a node.
  *
- * @node:  The node to add
+ * @param node  The node to add
  */
 void finch_blist_manager_add_node(PurpleBlistNode *node);
 
diff --git a/finch/gntconn.h b/finch/gntconn.h
--- a/finch/gntconn.h
+++ b/finch/gntconn.h
@@ -36,7 +36,7 @@
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleConnectionUiOps structure populated with the appropriate functions.
+ * @return The PurpleConnectionUiOps structure populated with the appropriate functions.
  */
 PurpleConnectionUiOps *finch_connections_get_ui_ops(void);
 
diff --git a/finch/gntconv.h b/finch/gntconv.h
--- a/finch/gntconv.h
+++ b/finch/gntconv.h
@@ -85,7 +85,7 @@ struct _FinchConvIm
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleConversationUiOps populated with the appropriate functions.
+ * @return The PurpleConversationUiOps populated with the appropriate functions.
  */
 PurpleConversationUiOps *finch_conv_get_ui_ops(void);
 
@@ -102,15 +102,15 @@ void finch_conversation_uninit(void);
 /**
  * Set a conversation as active in a contactized conversation
  *
- * @conv: The conversation to make active.
+ * @param conv The conversation to make active.
  */
 void finch_conversation_set_active(PurpleConversation *conv);
 
 /**
  * Sets the information widget for the conversation window.
  *
- * @conv:   The conversation.
- * @widget: The widget containing the information. If %NULL,
+ * @param conv   The conversation.
+ * @param widget The widget containing the information. If @c NULL,
  *               the current information widget is removed.
  */
 void finch_conversation_set_info_widget(PurpleConversation *conv, GntWidget *widget);
diff --git a/finch/gntdebug.h b/finch/gntdebug.h
--- a/finch/gntdebug.h
+++ b/finch/gntdebug.h
@@ -36,7 +36,7 @@
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleDebugUiOps structure populated with the appropriate functions.
+ * @return The PurpleDebugUiOps structure populated with the appropriate functions.
  */
 PurpleDebugUiOps *finch_debug_get_ui_ops(void);
 
diff --git a/finch/gntidle.h b/finch/gntidle.h
--- a/finch/gntidle.h
+++ b/finch/gntidle.h
@@ -36,7 +36,7 @@
 /**
  * Returns the GNT idle UI ops.
  *
- * Returns: The UI operations structure.
+ * @return The UI operations structure.
  */
 PurpleIdleUiOps *finch_idle_get_ui_ops(void);
 
diff --git a/finch/gntlog.h b/finch/gntlog.h
--- a/finch/gntlog.h
+++ b/finch/gntlog.h
@@ -68,7 +68,7 @@ void finch_log_init(void);
 /**
  * Returns the GNT log subsystem handle.
  *
- * Returns: The GNT log subsystem handle.
+ * @return The GNT log subsystem handle.
  */
 void *finch_log_get_handle(void);
 
diff --git a/finch/gntmenuutil.h b/finch/gntmenuutil.h
--- a/finch/gntmenuutil.h
+++ b/finch/gntmenuutil.h
@@ -37,9 +37,9 @@
 /**
  * Add a PurpleMenuAction to a GntMenu.
  *
- * @menu:   the GntMenu to add to
- * @action: the PurpleMenuAction to add
- * @ctx:    the callback context, passed as the first argument to
+ * @param menu   the GntMenu to add to
+ * @param action the PurpleMenuAction to add
+ * @param ctx    the callback context, passed as the first argument to
  *               the PurpleMenuAction's PurpleCallback function.
  */
 void gnt_append_menu_action(GntMenu *menu, PurpleMenuAction *action, gpointer ctx);
diff --git a/finch/gntnotify.h b/finch/gntnotify.h
--- a/finch/gntnotify.h
+++ b/finch/gntnotify.h
@@ -36,7 +36,7 @@
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleNotifyUiOps structure populated with the appropriate functions.
+ * @return The PurpleNotifyUiOps structure populated with the appropriate functions.
  */
 PurpleNotifyUiOps *finch_notify_get_ui_ops(void);
 
diff --git a/finch/gntplugin.h b/finch/gntplugin.h
--- a/finch/gntplugin.h
+++ b/finch/gntplugin.h
@@ -91,11 +91,11 @@ GType finch_plugin_info_get_type(void);
  * which should be a callback that returns a GntWidget for the plugin's
  * preferences (see FinchPluginPrefFrameCb).
  *
- * @first_property:  The first property name
- * @...:  The value of the first property, followed optionally by more
- *             name/value pairs, followed by %NULL
+ * @param first_property  The first property name
+ * @param ...  The value of the first property, followed optionally by more
+ *             name/value pairs, followed by @c NULL
  *
- * Returns: A new #FinchPluginInfo instance.
+ * @return A new #FinchPluginInfo instance.
  *
  * @see purple_plugin_info_new()
  */
diff --git a/finch/gntpounce.h b/finch/gntpounce.h
--- a/finch/gntpounce.h
+++ b/finch/gntpounce.h
@@ -31,9 +31,9 @@
 /**
  * Displays a New Buddy Pounce or Edit Buddy Pounce dialog.
  *
- * @account:    The optional account to use.
- * @name:       The optional name to pounce on.
- * @cur_pounce: The current buddy pounce, if editing an existing one.
+ * @param account    The optional account to use.
+ * @param name       The optional name to pounce on.
+ * @param cur_pounce The current buddy pounce, if editing an existing one.
  */
 void finch_pounce_editor_show(PurpleAccount *account, const char *name,
 								PurplePounce *cur_pounce);
@@ -51,7 +51,7 @@ void finch_pounces_manager_hide(void);
 /**
  * Returns the gtkpounces handle
  *
- * Returns: The handle to the GTK+ pounces system
+ * @return The handle to the GTK+ pounces system
  */
 void *finch_pounces_get_handle(void);
 
diff --git a/finch/gntrequest.h b/finch/gntrequest.h
--- a/finch/gntrequest.h
+++ b/finch/gntrequest.h
@@ -37,7 +37,7 @@
 /**
  * Get the ui-functions.
  *
- * Returns: The PurpleRequestUiOps structure populated with the appropriate functions.
+ * @return The PurpleRequestUiOps structure populated with the appropriate functions.
  */
 PurpleRequestUiOps *finch_request_get_ui_ops(void);
 
@@ -60,9 +60,9 @@ void finch_request_save_in_prefs(gpointe
 /**
  * Create a widget field for a request-field.
  *
- * @field:   The request field.
+ * @param field   The request field.
  *
- * Returns: A GntWidget for the request field.
+ * @return A GntWidget for the request field.
  */
 GntWidget *finch_request_field_get_widget(PurpleRequestField *field);
 /*@}*/
diff --git a/finch/gntroomlist.h b/finch/gntroomlist.h



More information about the Commits mailing list