/pidgin/main: fc083eca73a2: Comments: pidgin custom smileys manager

[Tomasz Wasilczyk]

Changeset: fc083eca73a20bc33bd67ab7765648d4bff8ae27
Author:	 Tomasz Wasilczyk <twasilczyk at pidgin.im>
Date:	 2014-04-05 20:50 +0200
Branch:	 default
URL: https://hg.pidgin.im/pidgin/main/rev/fc083eca73a2

Description:

Comments: pidgin custom smileys manager

diffstat:

 pidgin/gtksmiley-manager.h |  16 ++++++++++++++--
 1 files changed, 14 insertions(+), 2 deletions(-)

diffs (36 lines):

diff --git a/pidgin/gtksmiley-manager.h b/pidgin/gtksmiley-manager.h
--- a/pidgin/gtksmiley-manager.h
+++ b/pidgin/gtksmiley-manager.h
@@ -16,18 +16,30 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
  */
 
 #ifndef _PIDGIN_SMILEY_MANAGER_H_
 #define _PIDGIN_SMILEY_MANAGER_H_
+/**
+ * SECTION:gtksmiley-manager
+ * @include:gtksmiley-manager.h
+ * @section_id: pidgin-smiley-manager
+ * @short_description: a UI for user-defined smileys management
+ * @title: Custom smileys manager
+ *
+ * This module provides a GTK+ UI that allows the user adding and removing
+ * custom smileys. See libpurple-smiley-custom section (TODO: how to link this
+ * to libpurple's docs?).
+ */
 
 G_BEGIN_DECLS
 
 /**
  * pidgin_smiley_manager_show:
  *
- * Displays the Smiley Manager Window
+ * Creates and shows the smiley manager window, or requests focus for it,
+ * if it's already opened.
  */
 void pidgin_smiley_manager_show(void);