[gnome-power-manager] trivial: Add a few translator comments to gnome-power-statistics

[Richard Hughes <rhughes src gnome org>]

commit f32411a768d07936dc9e11af03b230cac41fbf64
Author: Richard Hughes <richard hughsie com>
Date:   Mon Apr 26 10:00:15 2010 +0100

    trivial: Add a few translator comments to gnome-power-statistics

 src/gpm-statistics.c |   40 ++++++++++++++++++++++++++++++++++------
 1 files changed, 34 insertions(+), 6 deletions(-)
---
diff --git a/src/gpm-statistics.c b/src/gpm-statistics.c
index 623d8c1..0ab7a9e 100644
--- a/src/gpm-statistics.c
+++ b/src/gpm-statistics.c
@@ -97,9 +97,11 @@ enum {
 #define GPM_HISTORY_DAY_VALUE			24*60*60
 #define GPM_HISTORY_WEEK_VALUE			7*24*60*60
 
+/* TRANSLATORS: what we've observed about the device */
 #define GPM_STATS_CHARGE_DATA_TEXT		_("Charge profile")
-#define GPM_STATS_CHARGE_ACCURACY_TEXT		_("Charge accuracy")
 #define GPM_STATS_DISCHARGE_DATA_TEXT		_("Discharge profile")
+/* TRANSLATORS: how accurately we can predict the time remaining of the battery */
+#define GPM_STATS_CHARGE_ACCURACY_TEXT		_("Charge accuracy")
 #define GPM_STATS_DISCHARGE_ACCURACY_TEXT	_("Discharge accuracy")
 
 #define GPM_STATS_CHARGE_DATA_VALUE		"charge-data"
@@ -396,6 +398,7 @@ gpm_stats_update_info_page_details (UpDevice *device)
 
 	/* remove prefix */
 	device_path = gpm_stats_get_printable_device_path (device);
+	/* TRANSLATORS: the device ID of the current device, e.g. "battery0" */
 	gpm_stats_add_info_data (_("Device"), device_path);
 	g_free (device_path);
 
@@ -406,26 +409,42 @@ gpm_stats_update_info_page_details (UpDevice *device)
 		gpm_stats_add_info_data (_("Model"), model);
 	if (serial != NULL && serial[0] != '\0')
 		gpm_stats_add_info_data (_("Serial number"), serial);
+
+	/* TRANSLATORS: a boolean attribute that means if the device is supplying the
+	 * main power for the computer. For instance, an AC adapter or laptop battery
+	 * would be TRUE,  but a mobile phone or mouse taking power is FALSE */
 	gpm_stats_add_info_data (_("Supply"), gpm_stats_bool_to_string (power_supply));
 
 	refreshed = (int) (time (NULL) - update_time);
 	text = g_strdup_printf (ngettext ("%d second", "%d seconds", refreshed), refreshed);
+
+	/* TRANSLATORS: when the device was last updated with new data. It's
+	* usually a few seconds when a device is discharging or charging. */
 	gpm_stats_add_info_data (_("Refreshed"), text);
 	g_free (text);
 
 	if (kind == UP_DEVICE_KIND_BATTERY ||
 	    kind == UP_DEVICE_KIND_MOUSE ||
 	    kind == UP_DEVICE_KIND_KEYBOARD ||
-	    kind == UP_DEVICE_KIND_UPS)
+	    kind == UP_DEVICE_KIND_UPS) {
+		/* TRANSLATORS: Present is whether the device is currently attached
+		 * to the computer, as some devices (e.g. laptop batteries) can
+		 * be removed, but still observed as devices on the system */
 		gpm_stats_add_info_data (_("Present"), gpm_stats_bool_to_string (is_present));
+	}
 	if (kind == UP_DEVICE_KIND_BATTERY ||
 	    kind == UP_DEVICE_KIND_MOUSE ||
-	    kind == UP_DEVICE_KIND_KEYBOARD)
+	    kind == UP_DEVICE_KIND_KEYBOARD) {
+		/* TRANSLATORS: If the device can be recharged, e.g. lithium
+		 * batteries rather than alkaline ones */
 		gpm_stats_add_info_data (_("Rechargeable"), gpm_stats_bool_to_string (is_rechargeable));
+	}
 	if (kind == UP_DEVICE_KIND_BATTERY ||
 	    kind == UP_DEVICE_KIND_MOUSE ||
-	    kind == UP_DEVICE_KIND_KEYBOARD)
+	    kind == UP_DEVICE_KIND_KEYBOARD) {
+		/* TRANSLATORS: The state of the device, e.g. "Changing" or "Fully charged" */
 		gpm_stats_add_info_data (_("State"), gpm_device_state_to_localised_string (state));
+	}
 	if (kind == UP_DEVICE_KIND_BATTERY) {
 		text = g_strdup_printf ("%.1f Wh", energy);
 		gpm_stats_add_info_data (_("Energy"), text);
@@ -443,6 +462,7 @@ gpm_stats_update_info_page_details (UpDevice *device)
 	if (kind == UP_DEVICE_KIND_BATTERY ||
 	    kind == UP_DEVICE_KIND_MONITOR) {
 		text = g_strdup_printf ("%.1f W", energy_rate);
+		/* TRANSLATORS: the rate of discharge for the device */
 		gpm_stats_add_info_data (_("Rate"), text);
 		g_free (text);
 	}
@@ -471,18 +491,26 @@ gpm_stats_update_info_page_details (UpDevice *device)
 	    kind == UP_DEVICE_KIND_KEYBOARD ||
 	    kind == UP_DEVICE_KIND_UPS) {
 		text = g_strdup_printf ("%.1f%%", percentage);
+		/* TRANSLATORS: the amount of charge the cell contains */
 		gpm_stats_add_info_data (_("Percentage"), text);
 		g_free (text);
 	}
 	if (kind == UP_DEVICE_KIND_BATTERY) {
 		text = g_strdup_printf ("%.1f%%", capacity);
+		/* TRANSLATORS: the capacity of the device, which is basically a measure
+		 * of how full it can get, relative to the design capacity */
 		gpm_stats_add_info_data (_("Capacity"), text);
 		g_free (text);
 	}
-	if (kind == UP_DEVICE_KIND_BATTERY)
+	if (kind == UP_DEVICE_KIND_BATTERY) {
+		/* TRANSLATORS: the type of battery, e.g. lithium or nikel metal hydroxide */
 		gpm_stats_add_info_data (_("Technology"), gpm_device_technology_to_localised_string (technology));
-	if (kind == UP_DEVICE_KIND_LINE_POWER)
+	}
+	if (kind == UP_DEVICE_KIND_LINE_POWER) {
+		/* TRANSLATORS: this is when the device is plugged in, typically
+		 * only shown for the ac adaptor device */
 		gpm_stats_add_info_data (_("Online"), gpm_stats_bool_to_string (online));
+	}
 
 	g_free (vendor);
 	g_free (serial);