From 0d54a60df2d5efd285069b7d1fa5c745bd2fca10 Mon Sep 17 00:00:00 2001
From: Jente Hidskes <hjdskes@gmail.com>
Date: Tue, 22 Aug 2017 16:47:39 +0200
Subject: [PATCH] Add context where needed for translators

---
 data/ui/ResolutionRow.ui   | 2 +-
 data/ui/ResolutionsPage.ui | 4 ++--
 piper/buttondialog.py      | 2 ++
 piper/buttonspage.py       | 2 ++
 piper/ratbagd.py           | 6 ++++++
 piper/window.py            | 1 +
 6 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/data/ui/ResolutionRow.ui b/data/ui/ResolutionRow.ui
index ac62264..0019ab2 100644
--- a/data/ui/ResolutionRow.ui
+++ b/data/ui/ResolutionRow.ui
@@ -62,7 +62,7 @@
               <object class="GtkLabel" id="active_label">
                 <property name="can_focus">False</property>
                 <property name="halign">end</property>
-                <property name="label" translatable="yes">Active</property>
+                <property name="label" translatable="yes" comments="Translators: this is used to indicate the active resolution.">Active</property>
                 <property name="justify">right</property>
                 <property name="track_visited_links">False</property>
               </object>
diff --git a/data/ui/ResolutionsPage.ui b/data/ui/ResolutionsPage.ui
index 5e91c60..d251a53 100644
--- a/data/ui/ResolutionsPage.ui
+++ b/data/ui/ResolutionsPage.ui
@@ -40,7 +40,7 @@
                         <property name="visible">True</property>
                         <property name="can_focus">False</property>
                         <property name="halign">end</property>
-                        <property name="label" translatable="yes">Report rate</property>
+                        <property name="label" translatable="yes" comments="Translators: the rate at which the device reports movement.">Report rate</property>
                         <property name="justify">right</property>
                         <property name="track_visited_links">False</property>
                         <style>
@@ -122,7 +122,7 @@
               <object class="GtkLabel">
                 <property name="visible">True</property>
                 <property name="can_focus">False</property>
-                <property name="label" translatable="yes">Sensitivity</property>
+                <property name="label" translatable="yes" comments="Translators: the sensitivity of the device's sensor.">Sensitivity</property>
                 <property name="track_visited_links">False</property>
                 <attributes>
                   <attribute name="weight" value="bold"/>
diff --git a/piper/buttondialog.py b/piper/buttondialog.py
index 403a669..e9d5bb0 100644
--- a/piper/buttondialog.py
+++ b/piper/buttondialog.py
@@ -140,6 +140,7 @@ class ButtonDialog(Gtk.Dialog):
         i = 0
         for button in buttons:
             key, name = self._get_button_name_and_description(button)
+            # Translators: section header for mapping one button's click to another.
             row = ButtonRow(name, _("Button mapping"), RatbagdButton.ACTION_TYPE_BUTTON, button.index + 1)
             self.listbox.insert(row, i)
             if self._action_type == RatbagdButton.ACTION_TYPE_BUTTON and button.index + 1 == self._button.mapping:
@@ -148,6 +149,7 @@ class ButtonDialog(Gtk.Dialog):
         for key, name in RatbagdButton.SPECIAL_DESCRIPTION.items():
             if name == "Unknown":
                 continue
+            # Translators: section header for assigning special functions to buttons.
             row = ButtonRow(_(name), _("Special mapping"), RatbagdButton.ACTION_TYPE_SPECIAL, key)
             self.listbox.insert(row, i)
             if self._action_type == RatbagdButton.ACTION_TYPE_SPECIAL and key == self._mapping:
diff --git a/piper/buttonspage.py b/piper/buttonspage.py
index 20627fa..2d98497 100644
--- a/piper/buttonspage.py
+++ b/piper/buttonspage.py
@@ -85,8 +85,10 @@ class ButtonsPage(Gtk.Box):
         elif action_type == RatbagdButton.ACTION_TYPE_MACRO:
             label = _("Macro: {}").format(str(ratbagd_button.macro))
         elif action_type == RatbagdButton.ACTION_TYPE_NONE:
+            # Translators: the button is turned disabled, e.g. off.
             label = _("Disabled")
         else:
+            # Translators: the button has an unknown function.
             label = _("Unknown")
         optionbutton.set_label(label)
 
diff --git a/piper/ratbagd.py b/piper/ratbagd.py
index 2b05402..dec31cc 100644
--- a/piper/ratbagd.py
+++ b/piper/ratbagd.py
@@ -755,6 +755,7 @@ class RatbagdMacro(GObject.Object):
 
     def __str__(self):
         if not self._macro:
+            # Translators: this is used when there is no macro to preview.
             return _("None")
 
         keys = []
@@ -828,9 +829,14 @@ class RatbagdLed(_RatbagdDBus):
     MODE_BREATHING = 3
 
     LED_DESCRIPTION = {
+        # Translators: the LED is off.
         MODE_OFF: N_("Off"),
+        # Translators: the LED has a single, solid color.
         MODE_ON: N_("Solid"),
+        # Translators: the LED is cycling between red, green and blue.
         MODE_CYCLE: N_("Cycle"),
+        # Translators: the LED's is pulsating a single color on different
+        # brightnesses.
         MODE_BREATHING: N_("Breathing"),
     }
 
diff --git a/piper/window.py b/piper/window.py
index 85ff4fc..2bf60b0 100644
--- a/piper/window.py
+++ b/piper/window.py
@@ -48,6 +48,7 @@ class Window(Gtk.ApplicationWindow):
         self._add_perspective(ErrorPerspective(), ratbag)
         if ratbag is None:
             self._present_error_perspective(_("Cannot connect to ratbagd"),
+                                            # Translators: "it" here is ratbagd.
                                             _("Please make sure it is running"))
             return