[easytag/wip/musicbrainz-support] Added functions comments in mb_search.c and mbentityview.c

[Abhinav Jangda <abhijangda src gnome org>]

commit 9b4c0662c0b6efced9f977c3ce85949305362e3f
Author: Abhinav <abhijangda hotmail com>
Date:   Wed Jul 23 23:39:09 2014 +0530

    Added functions comments in mb_search.c and mbentityview.c

 src/mb_search.c    |   21 +++++++++++++++++++++
 src/mbentityview.c |   31 +++++++++++++++++++++++++++++++
 2 files changed, 52 insertions(+), 0 deletions(-)
---
diff --git a/src/mb_search.c b/src/mb_search.c
index 1b9f579..99bef76 100755
--- a/src/mb_search.c
+++ b/src/mb_search.c
@@ -52,6 +52,13 @@ et_mb5_search_error_quark (void)
     return g_quark_from_static_string ("et-mb5-search-error-quark");
 }
 
+/*
+ * et_mb5_recording_get_artists_names:
+ * @recording: Mb5Recording
+ *
+ * Returns: String containing all the artist names of recording
+ * Get all the artist names of recording.
+ */
 gchar *
 et_mb5_recording_get_artists_names (Mb5Recording recording)
 {
@@ -91,6 +98,13 @@ et_mb5_recording_get_artists_names (Mb5Recording recording)
     return g_string_free (artist, FALSE);
 }
 
+/*
+ * et_mb5_release_get_artists_names:
+ * @release: Mb5Release
+ *
+ * Returns: String containing all artist names of release
+ * Get all the artist names of recording.
+ */
 gchar *
 et_mb5_release_get_artists_names (Mb5Release release)
 {
@@ -130,6 +144,13 @@ et_mb5_release_get_artists_names (Mb5Release release)
     return g_string_free (album_artist, FALSE);
 }
 
+/*
+ * et_musicbrainz_search_set_server_port:
+ * @_server: Address of server
+ * @_port: Port
+ *
+ * Set a musicbrainz server address and port.
+ */
 void
 et_musicbrainz_search_set_server_port (gchar *_server, int _port)
 {
diff --git a/src/mbentityview.c b/src/mbentityview.c
index 18399a6..10886b2 100755
--- a/src/mbentityview.c
+++ b/src/mbentityview.c
@@ -874,6 +874,15 @@ tree_view_row_activated (GtkTreeView *tree_view, GtkTreePath *path,
                       FALSE);
 }
 
+/*
+ * search_in_levels:
+ * @entity_view: EtMbEntityView
+ * @child: GNode
+ * @filter_iter: Iterator of GtkTreeFilter containing parent entity
+ * @is_refresh: Whether it is a refresh operation
+ *
+ * Start Searching in Levels.
+ */
 static void
 search_in_levels (EtMbEntityView *entity_view, GNode *child,
                   GtkTreeIter *filter_iter, gboolean is_refresh)
@@ -1252,6 +1261,12 @@ et_mb_entity_view_refresh_current_level (EtMbEntityView *entity_view)
     search_in_levels (entity_view, priv->mb_tree_current_node, NULL, TRUE);
 }
 
+/*
+ * et_mb_entity_view_clear_all:
+ * @entity_view: EtMbEntityView
+ *
+ * Clear EtMbEntityView.
+ */
 void
 et_mb_entity_view_clear_all (EtMbEntityView *entity_view)
 {
@@ -1286,6 +1301,13 @@ et_mb_entity_view_finalize (GObject *object)
     G_OBJECT_CLASS (et_mb_entity_view_parent_class)->finalize(object);
 }
 
+/*
+ * et_mb_entity_view_get_current_entity:
+ * @entity_view: EtMbEntityView
+ *
+ * Returns: EtMbEntity
+ * Get current parent EtMbEntity.
+ */
 EtMbEntity *
 et_mb_entity_view_get_current_entity (EtMbEntityView *entity_view)
 {
@@ -1296,6 +1318,15 @@ et_mb_entity_view_get_current_entity (EtMbEntityView *entity_view)
     return priv->mb_tree_current_node->data;
 }
 
+/*
+ * et_mb_entity_view_get_selected_entity_list:
+ * @entity_view: EtMbEntityView
+ * @list: GList
+ *
+ * Returns: Number of elements in list.
+ *
+ * Get the list of selected EtMbEntity from EtMbEntityView
+ */
 int
 et_mb_entity_view_get_selected_entity_list (EtMbEntityView *entity_view,
                                             GList **list)