[gnome-software] trivial: More translator comments

[Richard Hughes <rhughes src gnome org>]

commit fc12954fb979acdecab29f0e20b76a2eecddab34
Author: Rafal Luzynski <digitalfreak lingonborough com>
Date:   Tue Feb 23 03:07:43 2016 +0100

    trivial: More translator comments
    
    Make sure that everybody understands the word "Review" correctly
    in different contexts.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=761976
    
    Signed-off-by: Richard Hughes <richard hughsie com>

 src/gs-review-dialog.ui |    4 ++--
 src/gs-review-row.ui    |    2 +-
 src/gs-shell-details.ui |    4 ++--
 src/gs-update-monitor.c |    6 +++++-
 4 files changed, 10 insertions(+), 6 deletions(-)
---
diff --git a/src/gs-review-dialog.ui b/src/gs-review-dialog.ui
index 7e90f00..1d7c7dc 100644
--- a/src/gs-review-dialog.ui
+++ b/src/gs-review-dialog.ui
@@ -8,7 +8,7 @@
       <action-widget response="ok">post_button</action-widget>
     </action-widgets>
     <property name="can_focus">False</property>
-    <property name="title" translatable="yes">Post Review</property>
+    <property name="title" translatable="yes" comments="Translators: Title of the dialog box where the users 
can write and publish their opinions about the apps.">Post Review</property>
     <property name="modal">True</property>
     <property name="default_width">600</property>
     <property name="default_height">300</property>
@@ -32,7 +32,7 @@
         </child>
         <child>
           <object class="GtkButton" id="post_button">
-            <property name="label" translatable="yes">_Post</property>
+            <property name="label" translatable="yes" comments="Translators: A button to publish the user's 
opinion about the app.">_Post</property>
             <property name="visible">True</property>
             <property name="can_focus">True</property>
             <property name="receives_default">True</property>
diff --git a/src/gs-review-row.ui b/src/gs-review-row.ui
index bfd0438..b018f91 100644
--- a/src/gs-review-row.ui
+++ b/src/gs-review-row.ui
@@ -102,7 +102,7 @@
               <object class="GtkLabel">
                 <property name="visible">True</property>
                 <property name="can_focus">False</property>
-                <property name="label" translatable="yes">Was this review useful to you?</property>
+                <property name="label" translatable="yes" comments="Translators: Users can express their 
opinions about other users' opinions about the apps.">Was this review useful to you?</property>
                 <style>
                   <class name="dim-label"/>
                 </style>
diff --git a/src/gs-shell-details.ui b/src/gs-shell-details.ui
index 97b7f67..3e12360 100644
--- a/src/gs-shell-details.ui
+++ b/src/gs-shell-details.ui
@@ -1176,7 +1176,7 @@
                             <property name="valign">start</property>
                             <property name="hexpand">True</property>
                             <property name="xalign">0</property>
-                            <property name="label" translatable="yes">Reviews</property>
+                            <property name="label" translatable="yes" comments="Translators: Header of the 
section with other users' opinions about the app.">Reviews</property>
                             <style>
                               <class name="application-reviews-title"/>
                             </style>
@@ -1192,7 +1192,7 @@
                         <child>
                           <object class="GtkButton" id="button_review">
                             <property name="use_underline">True</property>
-                            <property name="label" translatable="yes">_Write a Review</property>
+                            <property name="label" translatable="yes" comments="Translators: Button opening 
a dialog where the users can write and publish their opinions about the apps.">_Write a Review</property>
                             <property name="can_focus">True</property>
                             <property name="receives_default">False</property>
                             <property name="halign">start</property>
diff --git a/src/gs-update-monitor.c b/src/gs-update-monitor.c
index 638619d..14dee09 100644
--- a/src/gs-update-monitor.c
+++ b/src/gs-update-monitor.c
@@ -458,7 +458,11 @@ get_updates_historical_cb (GObject *object, GAsyncResult *res, gpointer data)
 
        notification = g_notification_new (title);
        g_notification_set_body (notification, message);
-       /* TRANSLATORS: to look at the updates that were installed */
+       /* TRANSLATORS: Button to look at the updates that were installed.
+        * Note that it has nothing to do with the application reviews, the
+        * users can't express their opinions here. In some languages
+        * "Review (evaluate) something" is a different translation than
+        * "Review (browse) something." */
        g_notification_add_button_with_target (notification, C_("updates", "Review"), "app.set-mode", "s", 
"updated");
        g_notification_set_default_action_and_target (notification, "app.set-mode", "s", "updated");
        g_application_send_notification (monitor->application, "offline-updates", notification);