[gthumb] edit_metadata: added some comments to make the code clearer

[Paolo Bacchilega <paobac src gnome org>]

commit 1a17a63ce17452d65050e406bb2e9c2cd17339a9
Author: Paolo Bacchilega <paobac src gnome org>
Date:   Sun Jan 29 10:01:39 2012 +0100

    edit_metadata: added some comments to make the code clearer

 extensions/edit_metadata/gth-edit-general-page.c |   19 +++++++++++++++++++
 1 files changed, 19 insertions(+), 0 deletions(-)
---
diff --git a/extensions/edit_metadata/gth-edit-general-page.c b/extensions/edit_metadata/gth-edit-general-page.c
index 2468e1e..3c1e429 100644
--- a/extensions/edit_metadata/gth-edit-general-page.c
+++ b/extensions/edit_metadata/gth-edit-general-page.c
@@ -75,9 +75,13 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 
 	self = GTH_EDIT_GENERAL_PAGE (base);
 
+	/* get the metadata common to the seleted files */
+
 	_g_object_unref (self->priv->info);
 	self->priv->info = gth_file_data_list_get_common_info (file_list, "general::description,general::title,general::location,general::datetime,general::tags,general::rating");
 
+	/* description */
+
 	buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (GET_WIDGET ("note_text")));
 	metadata = (GthMetadata *) g_file_info_get_attribute_object (self->priv->info, "general::description");
 	if (metadata != NULL) {
@@ -90,18 +94,24 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 	else
 		gtk_text_buffer_set_text (buffer, "", -1);
 
+	/* title */
+
 	metadata = (GthMetadata *) g_file_info_get_attribute_object (self->priv->info, "general::title");
 	if (metadata != NULL)
 		gtk_entry_set_text (GTK_ENTRY (GET_WIDGET ("title_entry")), gth_metadata_get_formatted (metadata));
 	else
 		gtk_entry_set_text (GTK_ENTRY (GET_WIDGET ("title_entry")), "");
 
+	/* location */
+
 	metadata = (GthMetadata *) g_file_info_get_attribute_object (self->priv->info, "general::location");
 	if (metadata != NULL)
 		gtk_entry_set_text (GTK_ENTRY (GET_WIDGET ("place_entry")), gth_metadata_get_formatted (metadata));
 	else
 		gtk_entry_set_text (GTK_ENTRY (GET_WIDGET ("place_entry")), "");
 
+	/* date */
+
 	metadata = (GthMetadata *) g_file_info_get_attribute_object (self->priv->info, "general::datetime");
 	if (metadata != NULL) {
 		gtk_combo_box_set_active (GTK_COMBO_BOX (self->priv->date_combobox), FOLLOWING_DATE);
@@ -117,6 +127,8 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 		gth_time_selector_set_exif_date (GTH_TIME_SELECTOR (self->priv->date_selector), "");
 	}
 
+	/* tags */
+
 	tags = (GthStringList *) g_file_info_get_attribute_object (self->priv->info, "general::tags");
 	if (tags != NULL) {
 		char *value;
@@ -129,6 +141,8 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 	else
 		gth_tags_entry_set_tags_from_text (GTH_TAGS_ENTRY (self->priv->tags_entry), NULL);
 
+	/* rating */
+
 	metadata = (GthMetadata *) g_file_info_get_attribute_object (self->priv->info, "general::rating");
 	if (metadata != NULL) {
 		int v;
@@ -141,6 +155,9 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 
 	gtk_widget_grab_focus (GET_WIDGET ("note_text"));
 
+	/* set a widget insensitive if there is no way to save the relative
+	 * metadata */
+
 	no_provider = TRUE;
 
 	if (file_list == NULL) {
@@ -187,6 +204,8 @@ gth_edit_general_page_real_set_file_list (GthEditCommentPage *base,
 		no_provider = FALSE;
 	_g_object_unref (provider);
 
+	/* hide the whole page if no metadata can be saved */
+
 	if (no_provider)
 		gtk_widget_hide (GTK_WIDGET (self));
 	else