1 files changed, 55 insertions, 0 deletions

diff --git a/src/ui/chat.h b/src/ui/chat.h
index e28374c..626bd1d 100644
--- a/src/ui/chat.h
+++ b/src/ui/chat.h
@@ -130,31 +130,86 @@ typedef struct UI_CHAT_Handle
   UI_PICKER_Handle *picker;
 } UI_CHAT_Handle;
 
+/**
+ * Allocates and creates a new chat handle
+ * to manage a chat for a given messenger
+ * application.
+ *
+ * @param app Messenger application
+ * @return New chat handle
+ */
 UI_CHAT_Handle*
 ui_chat_new(MESSENGER_Application *app);
 
+/**
+ * Updates a given chat handle with the current
+ * state of a messenger application and the chat
+ * context the chat is representing.
+ *
+ * @param handle Chat handle
+ * @param app Messenger application
+ * @param context Chat context
+ */
 void
 ui_chat_update(UI_CHAT_Handle *handle,
                MESSENGER_Application *app,
                struct GNUNET_CHAT_Context* context);
 
+/**
+ * Frees its resources and destroys a given
+ * chat handle.
+ *
+ * @param handle Chat handle
+ */
 void
 ui_chat_delete(UI_CHAT_Handle *handle);
 
+/**
+ * Add a message handle to a given chat handle
+ * to get listed by it for a messenger
+ * application.
+ *
+ * @param handle Chat handle
+ * @param app Messenger application
+ * @param message Message handle
+ */
 void
 ui_chat_add_message(UI_CHAT_Handle *handle,
                     MESSENGER_Application *app,
                     UI_MESSAGE_Handle *message);
 
+/**
+ * Removes a message handle from a given chat
+ * handle to remove it from its list for a
+ * messenger application.
+ *
+ * @param handle Chat handle
+ * @param app Messenger application
+ * @param message Message handle
+ */
 void
 ui_chat_remove_message(UI_CHAT_Handle *handle,
                        MESSENGER_Application *app,
                        UI_MESSAGE_Handle *message);
 
+/**
+ * Add a file load entry handle to a given chat
+ * handle to get listed by it.
+ *
+ * @param handle Chat handle
+ * @param file_load File load entry handle
+ */
 void
 ui_chat_add_file_load(UI_CHAT_Handle *handle,
                       UI_FILE_LOAD_ENTRY_Handle *file_load);
 
+/**
+ * Removes a file load entry handle from a given
+ * chat handle to remove it from its list.
+ *
+ * @param handle Chat handle
+ * @param file_load File load entry handle
+ */
 void
 ui_chat_remove_file_load(UI_CHAT_Handle *handle,
                          UI_FILE_LOAD_ENTRY_Handle *file_load);