[gnome-games] Add translators comment to several translatable strings



commit 1e0e69d52b4a686b302d9618958527ed81b3ec96
Author: Thibault Martin <mail thibaultmart in>
Date:   Sun Apr 5 11:13:17 2020 +0200

    Add translators comment to several translatable strings

 data/ui/empty-collection.ui                      |  4 ++--
 data/ui/shortcuts-window.ui                      | 20 ++++++++++----------
 plugins/nintendo-ds/src/nintendo-ds-layout.vala  | 20 ++++++++++++++++++++
 src/ui/application-window.vala                   |  4 ++++
 src/ui/keyboard-mapper.vala                      |  4 ++++
 src/ui/preferences-page-platforms-retro-row.vala |  8 ++++++--
 src/ui/preferences-page-video.vala               |  3 +++
 src/ui/snapshots-list.vala                       |  3 +++
 8 files changed, 52 insertions(+), 14 deletions(-)
---
diff --git a/data/ui/empty-collection.ui b/data/ui/empty-collection.ui
index 27ba7611..d1dd5071 100644
--- a/data/ui/empty-collection.ui
+++ b/data/ui/empty-collection.ui
@@ -20,7 +20,7 @@
     <child>
       <object class="GtkLabel" id="label">
         <property name="visible">True</property>
-        <property name="label" translatable="yes">No games found</property>
+        <property name="label" translatable="yes" comments="Translators: This is displayed when the games 
library is empty.">No games found</property>
         <property name="justify">center</property>
         <property name="wrap">True</property>
         <style>
@@ -35,7 +35,7 @@
     <child>
       <object class="GtkLabel" id="empty-state-label">
         <property name="visible">True</property>
-        <property name="label" translatable="yes">Install games or add directories containing games to your 
search sources.</property>
+        <property name="label" translatable="yes" comments="Translators: This is displayed when the games 
library is empty.">Install games or add directories containing games to your search sources.</property>
         <property name="justify">left</property>
         <property name="wrap">true</property>
         <style>
diff --git a/data/ui/shortcuts-window.ui b/data/ui/shortcuts-window.ui
index 60f3b043..9f10db9c 100644
--- a/data/ui/shortcuts-window.ui
+++ b/data/ui/shortcuts-window.ui
@@ -166,35 +166,35 @@
         <property name="visible">True</property>
         <child>
           <object class="GtkShortcutsGroup">
-            <property name="title" translatable="yes">Screen Layout</property>
+            <property name="title" translatable="yes" comments="Translators: This is displayed in the 
shortcuts window. This corresponds to the screens layout for the Nintendo DS.">Screen Layout</property>
             <property name="visible">True</property>
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Vertical</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the layout for the Nintendo DS emulator. This setting means the two screens are stacked one on 
top of the other">Vertical</property>
                 <property name="accelerator">&lt;alt&gt;1</property>
               </object>
             </child>
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Side by side</property>
-                <property name="subtitle" translatable="yes" context="shortcut window">Bottom to the 
right</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the layout for the Nintendo DS emulator. This setting means the two screens are displayed side 
by side">Side by side</property>
+                <property name="subtitle" translatable="yes" context="shortcut window" 
comments="Translators: This describes the layout for the Nintendo DS emulator when the two screens are 
displayed side by side and not one on top of the other. The bottom screen is displayed to the right of the 
top screen.">Bottom to the right</property>
                 <property name="accelerator">&lt;alt&gt;2</property>
               </object>
             </child>
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Side by side</property>
-                <property name="subtitle" translatable="yes" context="shortcut window">Bottom to the 
left</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the Nintendo DS screens layout, side by side">Side by side</property>
+                <property name="subtitle" translatable="yes" context="shortcut window" 
comments="Translators: This describes the layout for the Nintendo DS emulator when the two screens are 
displayed side by side and not one on top of the other. The bottom screen is displayed to the left of the top 
screen">Bottom to the left</property>
                 <property name="accelerator">&lt;alt&gt;3</property>
               </object>
             </child>
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Single screen</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the layout for the Nintendo DS emulator. This setting means only one screen is displayed at 
once. The screen displayed can then be changed in-game">Single screen</property>
                 <property name="accelerator">&lt;alt&gt;4</property>
               </object>
             </child>
@@ -207,14 +207,14 @@
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Show top 
screen</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the shortcut for showing the top screen, when the Nintendo DS emulator is single screen 
mode.">Show top screen</property>
                 <property name="accelerator">Page_Up</property>
               </object>
             </child>
             <child>
               <object class="GtkShortcutsShortcut">
                 <property name="visible">True</property>
-                <property name="title" translatable="yes" context="shortcut window">Show bottom 
screen</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the shortcut for showing the bottom screen, when the Nintendo DS emulator is single screen 
mode.">Show bottom screen</property>
                 <property name="accelerator">Page_Down</property>
               </object>
             </child>
@@ -223,7 +223,7 @@
                 <property name="visible">True</property>
                 <property name="shortcut-type">gesture</property>
                 <property name="icon">stick_icon</property>
-                <property name="title" translatable="yes" context="shortcut window">Toggle screen</property>
+                <property name="title" translatable="yes" context="shortcut window" comments="Translators: 
This describes the shortcut for toggling whether the top or bottom screen is displayed, when the Nintendo DS 
emulator is single screen mode.">Toggle screen</property>
                 <property name="subtitle" translatable="yes" context="shortcut window">Press right analog 
stick</property>
               </object>
             </child>
diff --git a/plugins/nintendo-ds/src/nintendo-ds-layout.vala b/plugins/nintendo-ds/src/nintendo-ds-layout.vala
index 5dc902c8..a63f9356 100644
--- a/plugins/nintendo-ds/src/nintendo-ds-layout.vala
+++ b/plugins/nintendo-ds/src/nintendo-ds-layout.vala
@@ -47,15 +47,27 @@ public enum Games.NintendoDsLayout {
        public string get_title () {
                switch (this) {
                case TOP_BOTTOM:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator. This setting means the two screens are stacked one on
+                        * top of the other */
                        return _("Vertical");
 
                case LEFT_RIGHT:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator. This setting means the two screens are displayed side
+                        * by side */
                        return _("Side by side");
 
                case RIGHT_LEFT:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator. This setting means the two screens are displayed side
+                        * by side */
                        return _("Side by side");
 
                case QUICK_SWITCH:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator. This setting means only one screen is displayed at
+                        * once. The screen displayed can then be changed in-game. */
                        return _("Single screen");
 
                default:
@@ -66,9 +78,17 @@ public enum Games.NintendoDsLayout {
        public string? get_subtitle () {
                switch (this) {
                case LEFT_RIGHT:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator when the two screens are displayed side by side and not
+                        * one on top of the other. The bottom screen is displayed to the
+                        * right of the top screen. */
                        return _("Bottom to the right");
 
                case RIGHT_LEFT:
+                       /* Translators: This describes the layout for the Nintendo DS
+                        * emulator when the two screens are displayed side by side and not
+                        * one on top of the other. The bottom screen is displayed to the
+                        * left of the top screen. */
                        return _("Bottom to the left");
 
                case TOP_BOTTOM:
diff --git a/src/ui/application-window.vala b/src/ui/application-window.vala
index a10aeed8..aa61feb7 100644
--- a/src/ui/application-window.vala
+++ b/src/ui/application-window.vala
@@ -274,6 +274,8 @@ private class Games.ApplicationWindow : Gtk.ApplicationWindow {
                        return;
 
                Gtk.ApplicationInhibitFlags new_flags = (inhibit_flags | flags);
+               /* Translators: This is displayed if the user tries to log out of his
+                * GNOME session, shutdown, or reboot while Games is running */
                uint new_cookie = application.inhibit (this, new_flags, _("Playing a game"));
 
                if (inhibit_cookie != 0)
@@ -291,6 +293,8 @@ private class Games.ApplicationWindow : Gtk.ApplicationWindow {
                uint new_cookie = 0;
 
                if ((bool) new_flags)
+                       /* Translators: This is displayed if the user tries to log out of his
+                        * GNOME session, shutdown, or reboot while Games is running */
                        new_cookie = application.inhibit (this, new_flags, _("Playing a game"));
 
                if (inhibit_cookie != 0)
diff --git a/src/ui/keyboard-mapper.vala b/src/ui/keyboard-mapper.vala
index 8606ef85..74bd0a1d 100644
--- a/src/ui/keyboard-mapper.vala
+++ b/src/ui/keyboard-mapper.vala
@@ -24,6 +24,10 @@ private class Games.KeyboardMapper : Gtk.Bin {
        }
 
        construct {
+               /* translators: This message is displayed at the bottom of the window
+                * when the user maps keyboard keys to controller buttons. To see it,
+                * click on the hamburger menu, click on preferences > controllers >
+                * keyboard, and click on the "configure" button */
                info_message = _("Press suitable key on your keyboard");
        }
 
diff --git a/src/ui/preferences-page-platforms-retro-row.vala 
b/src/ui/preferences-page-platforms-retro-row.vala
index 91997eec..52ebe035 100644
--- a/src/ui/preferences-page-platforms-retro-row.vala
+++ b/src/ui/preferences-page-platforms-retro-row.vala
@@ -42,7 +42,9 @@ private class Games.PreferencesPagePlatformsRetroRow : PreferencesPagePlatformsR
                var preferred_core = core_manager.get_preferred_core (platform);
 
                if (preferred_core == null)
-                       /* Translators: No core available for this platform */
+                       /* Translators: This is displayed under the platform name when no
+                        * core is available for this platform. To see this message, click
+                        * on the hamburger menu, click on Preferences, then on Platforms */
                        core_label.label = _("None");
                else {
                        try {
@@ -50,7 +52,9 @@ private class Games.PreferencesPagePlatformsRetroRow : PreferencesPagePlatformsR
                        }
                        catch (Error e) {
                                critical (e.message);
-                               /* Translators: No core available for this platform */
+                       /* Translators: This is displayed under the platform name when no
+                        * core is available for this platform. To see this message, click
+                        * on the hamburger menu, click on Preferences, then on Platforms */
                                core_label.label = _("None");
                        }
                }
diff --git a/src/ui/preferences-page-video.vala b/src/ui/preferences-page-video.vala
index 5a096588..70e0df2d 100644
--- a/src/ui/preferences-page-video.vala
+++ b/src/ui/preferences-page-video.vala
@@ -19,6 +19,9 @@ private class Games.PreferencesPageVideo : PreferencesPage {
        }
 
        // same as video-filters in gschema
+       /* Translators: These values are video filters applied to the screen. Smooth
+        * tries to smoothen the pixels, sharp displays the pixels square, and CRT
+        * emulates an old TV */
        private string[] filter_display_names = { _("Smooth"), _("Sharp"), _("CRT") };
        private string[] filter_names = { "smooth", "sharp", "crt" };
        [GtkChild]
diff --git a/src/ui/snapshots-list.vala b/src/ui/snapshots-list.vala
index 7d27e305..76fdf7a5 100644
--- a/src/ui/snapshots-list.vala
+++ b/src/ui/snapshots-list.vala
@@ -185,6 +185,9 @@ private class Games.SnapshotsList : Gtk.Box {
                if (entry_text == _("Autosave") || entry_text == "") {
                        rename_entry.get_style_context ().add_class ("error");
                        rename_popover_btn.sensitive = false;
+                       /* Translators: This message is shown to the user if he tried to rename
+                        * his snapshot either with an empty string, or with the name of the
+                        * autosave */
                        rename_error_label.label = _("Invalid name");
 
                        return false;


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]