From: Jonny Lamb <jonny.lamb@collabora.co.uk>
Date: Thu, 23 Apr 2009 00:28:28 +0000 (+0100)
Subject: Add documentation for EmpathyNewMessageDialog.
X-Git-Url: https://git.0d.be/?p=empathy.git;a=commitdiff_plain;h=78f1e5cec3c97700d1ebd70fc949ba1ddf4ffa6b

Add documentation for EmpathyNewMessageDialog.

Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
---

diff --git a/libempathy-gtk/empathy-new-message-dialog.c b/libempathy-gtk/empathy-new-message-dialog.c
index b1a35095..3e6e3f11 100644
--- a/libempathy-gtk/empathy-new-message-dialog.c
+++ b/libempathy-gtk/empathy-new-message-dialog.c
@@ -44,6 +44,16 @@
 #include "empathy-new-message-dialog.h"
 #include "empathy-account-chooser.h"
 
+/**
+ * SECTION:empathy-new-message-dialog
+ * @title: EmpathyNewMessageDialog
+ * @short_description: A dialog to show a new message
+ * @include: libempathy-gtk/empathy-new-message-dialog.h
+ *
+ * #EmpathyNewMessageDialog is a dialog which allows a text chat or
+ * call to be started with any contact on any enabled account.
+ */
+
 typedef struct {
 	GtkWidget *dialog;
 	GtkWidget *table_contact;
@@ -242,6 +252,14 @@ new_message_dialog_destroy_cb (GtkWidget               *widget,
 	g_free (dialog);
 }
 
+/**
+ * empathy_new_message_dialog_show:
+ * @parent: parent #GtkWindow of the dialog
+ *
+ * Create a new #EmpathyNewMessageDialog and show it.
+ *
+ * Return value: the new #EmpathyNewMessageDialog
+ */
 GtkWidget *
 empathy_new_message_dialog_show (GtkWindow *parent)
 {