Mercurial > pidgin3 / file diff

--- a/pidgin/gtksmiley.h	Sun Feb 02 16:24:04 2014 +0530
+++ b/pidgin/gtksmiley.h	Sun Feb 02 16:55:09 2014 +0530
@@ -34,31 +34,39 @@
 G_BEGIN_DECLS
 
 /**
+ * pidgin_smiley_add_to_list:
+ * @smiley:	The smiley to be added.
+ *
  * Add a PurpleSmiley to the GtkWebViewSmiley's list to be able to use it
  * in pidgin
- *
- * @smiley:	The smiley to be added.
  */
 void pidgin_smiley_add_to_list(PurpleSmiley *smiley);
 
 /**
- * Delete a PurpleSmiley from the GtkWebViewSmiley's list
+ * pidgin_smiley_del_from_list:
+ * @smiley:	The smiley to be deleted.
  *
- * @smiley:	The smiley to be deleted.
+ * Delete a PurpleSmiley from the GtkWebViewSmiley's list
  */
 void pidgin_smiley_del_from_list(PurpleSmiley *smiley);
 
 /**
+ * pidgin_smileys_init:
+ *
  * Load the GtkWebViewSmiley list
  */
 void pidgin_smileys_init(void);
 
 /**
+ * pidgin_smileys_uninit:
+ *
  * Uninit the GtkWebViewSmiley list
  */
 void pidgin_smileys_uninit(void);
 
 /**
+ * pidgin_smileys_get_all:
+ *
  * Returns a GSList with the GtkWebViewSmiley of each custom smiley
  *
  * Returns: (transfer none): A GtkWebViewSmiley list
@@ -69,44 +77,51 @@
  * Smiley Manager
  *****************************************************************************/
 /**
+ * pidgin_smiley_manager_show:
+ *
  * Displays the Smiley Manager Window
  */
 void pidgin_smiley_manager_show(void);
 
 /**
- * Shows an editor for a smiley.
- *
+ * pidgin_smiley_edit:
  * @widget: The parent widget to be linked or %NULL
  * @smiley: The PurpleSmiley to be edited, or %NULL for a new smiley
- * Returns: The smiley add dialog
+ *
+ * Shows an editor for a smiley.
  *
  * @see pidgin_smiley_editor_set_shortcut
  * @see pidgin_smiley_editor_set_image
+ *
+ * Returns: The smiley add dialog
  */
 PidginSmiley *pidgin_smiley_edit(GtkWidget *widget, PurpleSmiley *smiley);
 
 /**
- * Set the shortcut in a smiley add dialog
- *
+ * pidgin_smiley_editor_set_shortcut:
  * @editor: A smiley editor dialog (created by pidgin_smiley_edit)
  * @shortcut: The shortcut to set
+ *
+ * Set the shortcut in a smiley add dialog
  */
 void pidgin_smiley_editor_set_shortcut(PidginSmiley *editor, const gchar *shortcut);
 
 /**
- * Set the image in a smiley add dialog
- *
+ * pidgin_smiley_editor_set_image:
  * @editor: A smiley editor dialog
  * @image: A GdkPixbuf image
+ *
+ * Set the image in a smiley add dialog
  */
 void pidgin_smiley_editor_set_image(PidginSmiley *editor, GdkPixbuf *image);
 
 /**
- * Sets the image data in a smiley add dialog
- *
+ * pidgin_smiley_editor_set_data:
  * @editor: A smiley editor dialog
  * @data: A pointer to smiley's data
  * @datasize: The size of smiley's data
+ *
+ * Sets the image data in a smiley add dialog
  */
 void pidgin_smiley_editor_set_data(PidginSmiley *editor, gpointer data, gsize datasize);