[libgdata] Bug 581706 – translation issues

[Philip Withnall <pwithnall src gnome org>]

commit 91d50308d1f8152b9fb4e4f613bbd9a95f442b99
Author: Philip Withnall <philip tecnocode co uk>
Date:   Thu May 7 18:52:51 2009 +0100

    Bug 581706 â?? translation issues
    
    Added some translator comments and improved a few strings a little.
---
 gdata/gdata-parser.c                              |    3 +++
 gdata/gdata-service.c                             |    7 ++++---
 gdata/services/calendar/gdata-calendar-calendar.c |    3 +++
 gdata/services/calendar/gdata-calendar-service.c  |    2 +-
 gdata/services/youtube/gdata-youtube-service.c    |    6 +++---
 5 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/gdata/gdata-parser.c b/gdata/gdata-parser.c
index 7c5f960..4721310 100644
--- a/gdata/gdata-parser.c
+++ b/gdata/gdata-parser.c
@@ -45,6 +45,9 @@ gdata_parser_error_required_content_missing (const gchar *element_name, GError *
 gboolean
 gdata_parser_error_not_iso8601_format (const gchar *element_name, const gchar *parent_element_name, const gchar *actual_value, GError **error)
 {
+	/* Translators: the first parameter is the name of an XML element, the second parameter is the name of
+	 * another XML element which is owned by (possessive) the first parameter, and the third parameter is
+	 * the erroneous value (which was not in ISO8601 format). */
 	g_set_error (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_PROTOCOL_ERROR,
 		     _("A <%s>'s <%s> element (\"%s\") was not in ISO8601 format."),
 		     parent_element_name, element_name, actual_value);
diff --git a/gdata/gdata-service.c b/gdata/gdata-service.c
index 9a93fcb..077290a 100644
--- a/gdata/gdata-service.c
+++ b/gdata/gdata-service.c
@@ -564,6 +564,7 @@ authenticate (GDataService *self, const gchar *username, const gchar *password,
 			g_free (captcha_uri);
 
 			if (new_captcha_answer == NULL || *new_captcha_answer == '\0') {
+				/* Translators: see http://en.wikipedia.org/wiki/CAPTCHA for information about CAPTCHAs */
 				g_set_error_literal (error, GDATA_AUTHENTICATION_ERROR, GDATA_AUTHENTICATION_ERROR_CAPTCHA_REQUIRED,
 						     _("A CAPTCHA must be filled out to log in."));
 				goto login_error;
@@ -1052,7 +1053,7 @@ gdata_service_insert_entry (GDataService *self, const gchar *upload_uri, GDataEn
 		/* Error */
 		/* TODO: Handle errors more specifically, making sure to set authenticated where appropriate */
 		g_set_error (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_WITH_INSERTION,
-			     _("TODO: error code %u when inserting"), status);
+			     _("error code %u when inserting"), status);
 		g_object_unref (message);
 		return NULL;
 	}
@@ -1138,7 +1139,7 @@ gdata_service_update_entry (GDataService *self, GDataEntry *entry, GCancellable
 		/* Error */
 		/* TODO: Handle errors more specifically, making sure to set authenticated where appropriate */
 		g_set_error (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_WITH_UPDATE,
-			     _("TODO: error code %u when updating"), status);
+			     _("error code %u when updating"), status);
 		g_object_unref (message);
 		return NULL;
 	}
@@ -1213,7 +1214,7 @@ gdata_service_delete_entry (GDataService *self, GDataEntry *entry, GCancellable
 		/* Error */
 		/* TODO: Handle errors more specifically, making sure to set authenticated where appropriate */
 		g_set_error (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_WITH_DELETION,
-			     _("TODO: error code %u when deleting"), status);
+			     _("error code %u when deleting"), status);
 		return FALSE;
 	}
 
diff --git a/gdata/services/calendar/gdata-calendar-calendar.c b/gdata/services/calendar/gdata-calendar-calendar.c
index db436ba..5112963 100644
--- a/gdata/services/calendar/gdata-calendar-calendar.c
+++ b/gdata/services/calendar/gdata-calendar-calendar.c
@@ -324,6 +324,9 @@ parse_xml (GDataEntry *entry, xmlDoc *doc, xmlNode *node, GError **error)
 			return gdata_parser_error_required_property_missing ("gCal:color", "value", error);
 		if (gdata_color_from_hexadecimal ((gchar*) value, &colour) == FALSE) {
 			/* Error */
+			/* Translators: the first parameter is the name of an XML element, the second parameter is the name of
+			 * another XML element which is owned by (possessive) the first parameter, and the third parameter is
+			 * the erroneous value (which was not in hexadecimal RGB format). */
 			g_set_error (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_PROTOCOL_ERROR,
 				     _("A <%s>'s <%s> element (\"%s\") was not in hexadecimal RGB format."),
 				     "entry", "gCal:color", value);
diff --git a/gdata/services/calendar/gdata-calendar-service.c b/gdata/services/calendar/gdata-calendar-service.c
index 6c720aa..668c6c2 100644
--- a/gdata/services/calendar/gdata-calendar-service.c
+++ b/gdata/services/calendar/gdata-calendar-service.c
@@ -244,7 +244,7 @@ gdata_calendar_service_query_events (GDataCalendarService *self, GDataCalendarCa
 	if (uri == NULL) {
 		/* Erroring out is probably the safest thing to do */
 		g_set_error_literal (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_PROTOCOL_ERROR,
-				     _("The calendar didn't have a content source."));
+				     _("The calendar did not have a content source."));
 		return NULL;
 	}
 
diff --git a/gdata/services/youtube/gdata-youtube-service.c b/gdata/services/youtube/gdata-youtube-service.c
index b075f77..4fb865f 100644
--- a/gdata/services/youtube/gdata-youtube-service.c
+++ b/gdata/services/youtube/gdata-youtube-service.c
@@ -316,7 +316,7 @@ parse_error_response (GDataService *self, guint status, const gchar *reason_phra
 						     _("You have made too many API calls recently. Please wait a few minutes and try again."));
 				} else if (xmlStrcmp (code, (xmlChar*) "too_many_entries") == 0) {
 					g_set_error (error, GDATA_YOUTUBE_SERVICE_ERROR, GDATA_YOUTUBE_SERVICE_ERROR_ENTRY_QUOTA_EXCEEDED,
-						     _("You have exceeded your entry quota with the entry \"%s\"."
+						     _("You have exceeded your entry quota with the entry \"%s\". "
 						       "Please delete some entries and try again."), location);
 				} else {
 					/* Protocol error */
@@ -537,7 +537,7 @@ gdata_youtube_service_query_related (GDataYouTubeService *self, GDataYouTubeVide
 	if (related_link == NULL) {
 		/* Erroring out is probably the safest thing to do */
 		g_set_error_literal (error, GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_PROTOCOL_ERROR,
-				     _("The video didn't have a related videos <link>."));
+				     _("The video did not have a related videos <link>."));
 		return NULL;
 	}
 
@@ -578,7 +578,7 @@ gdata_youtube_service_query_related_async (GDataYouTubeService *self, GDataYouTu
 		/* Erroring out is probably the safest thing to do */
 		g_simple_async_report_error_in_idle (G_OBJECT (self), callback, user_data,
 						     GDATA_SERVICE_ERROR, GDATA_SERVICE_ERROR_PROTOCOL_ERROR,
-						     _("The video didn't have a related videos <link>."));
+						     _("The video did not have a related videos <link>."));
 		return;
 	}