[dconf-editor] More translators comments.



commit 664e6ae1e3e347e16fd921a3759153af4988b9f6
Author: Arnaud Bonatti <arnaud bonatti gmail com>
Date:   Thu Jan 3 05:52:34 2019 +0100

    More translators comments.

 editor/about-list.vala                   |   9 +-
 editor/base-headerbar.ui                 |   8 +-
 editor/base-headerbar.vala               |   6 ++
 editor/bookmarks-list.vala               |   6 +-
 editor/bookmarks.ui                      |   5 ++
 editor/bookmarks.vala                    |  12 +--
 editor/browser-headerbar.vala            |   3 +
 editor/browser-view.vala                 |  17 +++-
 editor/ca.desrt.dconf-editor.gschema.xml | 137 +++++++++++++++++++++++++++++--
 editor/dconf-editor.vala                 |  13 ++-
 editor/dconf-headerbar.vala              |   3 +
 editor/dconf-window.vala                 |   5 +-
 editor/delayed-setting-view.ui           |   2 -
 editor/help-overlay.ui                   |   4 +-
 editor/modifications-list.vala           |   6 +-
 editor/modifications-revealer.ui         |   1 +
 editor/pathentry.ui                      |   8 +-
 editor/pathwidget.ui                     |  14 +---
 editor/registry-info.ui                  |   7 ++
 editor/registry-info.vala                |  12 ++-
 editor/registry-list.vala                |  16 +++-
 editor/short-pathbar.ui                  |   2 +
 22 files changed, 240 insertions(+), 56 deletions(-)
---
diff --git a/editor/about-list.vala b/editor/about-list.vala
index 4c519cd..47dbf90 100644
--- a/editor/about-list.vala
+++ b/editor/about-list.vala
@@ -26,8 +26,10 @@ private class AboutList : OverlayedList
         main_list_box.selection_mode = SelectionMode.NONE;
         get_style_context ().add_class ("about-list");
 
-        /* Translators: on really small windows, the about dialog is replaced by an in-window view; here are 
the two buttons that have the same role as the stack switcher in the usual about dialog */
-        first_mode_name = _("About"); second_mode_name = _("Credits");
+        /* Translators: on really small windows, the about dialog is replaced by an in-window view; here is 
the label of one of two buttons that have the same role as the stack switcher in the usual about dialog, the 
second is "Credits" */
+        first_mode_name = _("About");
+        /* Translators: on really small windows, the about dialog is replaced by an in-window view; here is 
the label of one of two buttons that have the same role as the stack switcher in the usual about dialog, the 
first is "About" */
+        second_mode_name = _("Credits");
         change_editability (true);
 
         show_apropos (ref main_list_store);
@@ -91,7 +93,8 @@ private class AboutList : OverlayedList
                                                                      AboutDialogInfos.website_label));
         main_list_store.append (new AboutListItem.from_label        (AboutDialogInfos.copyright, 
"small-label"));
 
-        if (AboutDialogInfos.license_type != License.GPL_3_0)   // TODO support all licenses type
+        // TODO support all licenses type
+        if (AboutDialogInfos.license_type != License.GPL_3_0)
             assert_not_reached ();
 
         /* Translators: on really small windows, the about dialog is replaced by an in-window view; here is 
the label of the link to the GPL license; TODO better text, as in the usual about dialog */
diff --git a/editor/base-headerbar.ui b/editor/base-headerbar.ui
index 6dc17fb..14e66fc 100644
--- a/editor/base-headerbar.ui
+++ b/editor/base-headerbar.ui
@@ -92,14 +92,16 @@
         </style>
         <child internal-child="accessible">
           <object class="AtkObject">
-            <property name="AtkObject::accessible-name" translatable="yes">Actions</property> <!-- TODO 1/3 
Informations -->
-            <property name="AtkObject::accessible-description" translatable="yes">Current view 
actions</property> <!-- TODO 2/3 About the current view -->
+            <!-- Translators: accessible name of the hamburger menu -->
+            <property name="AtkObject::accessible-name" translatable="yes">Actions</property>
+            <!-- Translators: accessible description of the hamburger menu -->
+            <property name="AtkObject::accessible-description" translatable="yes">Current view 
actions</property>
           </object>
         </child>
         <child>
           <object class="GtkImage">
             <property name="visible">True</property>
-            <property name="icon-name">open-menu-symbolic</property> <!-- TODO 3/3 
dialog-information-symbolic -->
+            <property name="icon-name">open-menu-symbolic</property>
             <property name="icon-size">1</property>
           </object>
         </child>
diff --git a/editor/base-headerbar.vala b/editor/base-headerbar.vala
index b0cf1b0..dfb2493 100644
--- a/editor/base-headerbar.vala
+++ b/editor/base-headerbar.vala
@@ -103,8 +103,11 @@ private class BaseHeaderBar : NightTimeAwareHeaderBar, AdaptativeWidget
     {
         // FIXME is used also for hiding keyboard shortcuts in small window
         if (has_keyboard_shortcuts)
+        {
+
             /* Translators: usual menu entry of the hamburger menu*/
             section.append (_("Keyboard Shortcuts"), "win.show-help-overlay");
+        }
     }
 
     private static inline void append_about_entry (string about_action_label, ref GLib.Menu section)
@@ -260,6 +263,9 @@ private class BaseHeaderBar : NightTimeAwareHeaderBar, AdaptativeWidget
         _this.set_default_widgets_states (/* show go_back_button      */ true,
                                           /* show ltr_left_separator  */ false,
                                           /* title_label text or null */
+
+
+
                                           /* Translators: on really small windows, the about dialog is 
replaced by an in-window view; here is the name of the view, displayed in the headerbar */
                                                                          _("About"),
                                           /* show info_button         */ false,
diff --git a/editor/bookmarks-list.vala b/editor/bookmarks-list.vala
index 9bcf12a..96d4968 100644
--- a/editor/bookmarks-list.vala
+++ b/editor/bookmarks-list.vala
@@ -32,8 +32,10 @@ private class BookmarksList : OverlayedList
         placeholder_text = _("Bookmarks will\nbe added here");
         add_placeholder ();
 
-        /* Translators: labels of the two buttons of the bookmarks list, to switch between using the 
bookmarks and editing the list */
-        first_mode_name = _("Use"); second_mode_name = _("Edit");
+        /* Translators: label of one of the two buttons of the bookmarks list, to switch between using the 
bookmarks and editing the list; the second is "Edit" */
+        first_mode_name = _("Use");
+        /* Translators: label of one of the two buttons of the bookmarks list, to switch between using the 
bookmarks and editing the list; the first is "Use" */
+        second_mode_name = _("Edit");
     }
 
     internal BookmarksList (bool needs_shadows, bool big_placeholder, string edit_mode_action_prefix, string 
schema_path)
diff --git a/editor/bookmarks.ui b/editor/bookmarks.ui
index 2b351e0..a1954cb 100644
--- a/editor/bookmarks.ui
+++ b/editor/bookmarks.ui
@@ -49,7 +49,9 @@
                     <property name="action-target">('',byte 255)</property>
                     <child internal-child="accessible">
                       <object class="AtkObject">
+                        <!-- Translators: accessible name of the switch for bookmarking current path in the 
bookmarks popover -->
                         <property name="AtkObject::accessible-name" translatable="yes">Location 
bookmarked</property>
+                        <!-- Translators: accessible description of the switch for bookmarking current path 
in the bookmarks popover -->
                         <property name="AtkObject::accessible-description" translatable="yes">Toggle to 
bookmark this location</property>
                       </object>
                     </child>
@@ -74,6 +76,7 @@
               <object class="GtkLabel">
                 <property name="visible">True</property>
                 <property name="halign">center</property>
+                <!-- Translators: text that might appear in the bookmarks popover in place of the switch and 
its label -->
                 <property name="label" translatable="yes">The bookmarks list is not editable.</property>
                 <style>
                   <class name="italic-label"/>
@@ -108,7 +111,9 @@
     </style> -->
     <child internal-child="accessible">
       <object class="AtkObject">
+        <!-- Translators: accessible name of the button for opening the bookmarks popover -->
         <property name="AtkObject::accessible-name" translatable="yes">Bookmarks</property>
+        <!-- Translators: accessible description of the button for opening the bookmarks popover -->
         <property name="AtkObject::accessible-description" translatable="yes">Manage your 
bookmarks</property>
       </object>
     </child>
diff --git a/editor/bookmarks.vala b/editor/bookmarks.vala
index b8b5b3c..d931151 100644
--- a/editor/bookmarks.vala
+++ b/editor/bookmarks.vala
@@ -392,12 +392,6 @@ private class Bookmarks : MenuButton
     * * Bookmarks management
     \*/
 
-    /* Translators: label of the switch in the bookmarks popover, when searching */
-    private const string bookmark_this_search_text = _("Bookmark this Search");
-
-    /* Translators: label of the switch in the bookmarks popover, when browsing */
-    private const string bookmark_this_location_text = _("Bookmark this Location");
-
     private static void update_switch_label (ViewType old_type, ViewType new_type, ref Label switch_label)
     {
         if (new_type == ViewType.SEARCH && old_type != ViewType.SEARCH)
@@ -406,6 +400,12 @@ private class Bookmarks : MenuButton
             switch_label.label = bookmark_this_location_text;
     }
 
+    /* Translators: label of the switch in the bookmarks popover, when searching */
+    private const string bookmark_this_search_text = _("Bookmark this Search");
+
+    /* Translators: label of the switch in the bookmarks popover, when browsing */
+    private const string bookmark_this_location_text = _("Bookmark this Location");
+
     private void update_icon_and_switch (Variant bookmarks_variant)
     {
         Variant variant = new Variant ("(sy)", current_path, ViewType.to_byte (current_type));
diff --git a/editor/browser-headerbar.vala b/editor/browser-headerbar.vala
index 9fb4c9a..b75ae2c 100644
--- a/editor/browser-headerbar.vala
+++ b/editor/browser-headerbar.vala
@@ -189,6 +189,9 @@ private abstract class BrowserHeaderBar : BaseHeaderBar, AdaptativeWidget
         real_this.set_default_widgets_states (/* show go_back_button      */ true,
                                               /* show ltr_left_separator  */ false,
                                               /* title_label text or null */
+
+
+
                                               /* Translators: on really small windows, name of the view when 
showing a folder properties, displayed in the headerbar */
                                                                              _("Properties"),
                                               /* show info_button         */ false,
diff --git a/editor/browser-view.vala b/editor/browser-view.vala
index 2c046f6..a4c890b 100644
--- a/editor/browser-view.vala
+++ b/editor/browser-view.vala
@@ -80,14 +80,23 @@ private class BrowserView : BaseView, AdaptativeWidget
         install_action_entries ();
 
         info_bar = new BrowserInfoBar ();
-        /* Translators: text and button of an infobar to sort again the keys list ("refresh" only, no 
"reload") */
-        info_bar.add_label ("soft-reload-folder", _("Sort preferences have changed. Do you want to refresh 
the view?"), _("Refresh"), "bro.refresh-folder");
+        /* Translators: text of an infobar to sort again the keys list ("refresh" only, no "reload") */
+        info_bar.add_label ("soft-reload-folder", _("Sort preferences have changed. Do you want to refresh 
the view?"),
+
+        /* Translators: button of an infobar to sort again the keys list ("refresh" only, no "reload") */
+                                                  _("Refresh"), "bro.refresh-folder");
 
         /* Translators: text of an infobar to reload the keys list because of a new key (for example) */
-        info_bar.add_label ("hard-reload-folder", _("This folder content has changed. Do you want to reload 
the view?"), _("Reload"), "browser.reload-folder");
+        info_bar.add_label ("hard-reload-folder", _("This folder content has changed. Do you want to reload 
the view?"),
+
+        /* Translators: button of an infobar to reload the keys list because of a new key (for example) */
+                                                  _("Reload"), "browser.reload-folder");
 
         /* Translators: text of an infobar to reload the key properties because something has changed */
-        info_bar.add_label ("hard-reload-object", _("This key’s properties have changed. Do you want to 
reload the view?"), _("Reload"), "browser.reload-object");
+        info_bar.add_label ("hard-reload-object", _("This key’s properties have changed. Do you want to 
reload the view?"),
+
+        /* Translators: button of an infobar to reload the key properties because something has changed */
+                                                  _("Reload"), "browser.reload-object");
         // TODO use the same for key removing?
 
         info_bar.show ();
diff --git a/editor/ca.desrt.dconf-editor.gschema.xml b/editor/ca.desrt.dconf-editor.gschema.xml
index 668d782..5c1f1c5 100644
--- a/editor/ca.desrt.dconf-editor.gschema.xml
+++ b/editor/ca.desrt.dconf-editor.gschema.xml
@@ -99,109 +99,149 @@
     <key name="window-width" type="i">
       <default>800</default>
       <range min="630"/>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/window-width' -->
       <summary>The width of the window</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/window-width' -->
       <description>The width of the main window in pixels.</description>
     </key>
     <key name="window-height" type="i">
       <default>600</default>
       <range min="420"/>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/window-height' 
-->
       <summary>The height of the window</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/window-height' -->
       <description>The height of the main window in pixels.</description>
     </key>
     <key name="window-is-maximized" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/window-is-maximized' -->
       <summary>A flag to enable maximized mode</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/window-is-maximized' -->
       <description>A flag to enable maximized mode</description>
     </key>
     <key name="restore-view" type="b">
       <default>true</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/restore-view' -->
       <summary>A flag to restore the last view</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/restore-view' -->
       <description>If “true”, Dconf Editor tries at launch to navigate to the path described in the 
“saved-view” key.</description>
     </key>
     <key name="saved-pathbar-path" type="s">
       <default>'/'</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/saved-pathbar-path' -->
       <summary>A path to restore the pathbar state</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/saved-pathbar-path' -->
       <description>If the “restore-view” key is set to “true”, and if the path requested at startup is a 
parent path of this one, Dconf Editor tries to restore the pathbar state at this path.</description>
     </key>
     <key name="saved-view" type="s">
       <default>'/'</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/saved-view' -->
       <summary>A path to restore the last view</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/saved-view' 
-->
       <description>If the “restore-view” key is set to “true”, Dconf Editor tries at launch to navigate to 
this path.</description>
     </key>
     <key name="show-warning" type="b">
       <default>true</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/show-warning' -->
       <summary>Show initial warning</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/show-warning' -->
       <description>If “true”, Dconf Editor opens a popup when launched reminding the user to be 
careful.</description>
     </key>
     <key name="small-keys-list-rows" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/small-keys-list-rows' -->
       <summary>A flag to enable small rows for keys list</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/small-keys-list-rows' -->
       <description>If “true”, the keys list use smaller rows.</description>
     </key>
     <key name="behaviour" enum="ca.desrt.dconf-editor.Behaviour">
       <default>'always-confirm-implicit'</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/behaviour' -->
       <summary>Change the behaviour of a key value change request</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/behaviour' 
-->
       <description>The “unsafe” value is discouraged: for keys that have a non-special-cased type, it 
updates the key value each time something changes in the entry, so including intermediate states. The “safe” 
value asks for confirmation in these cases, but allows instant changes for booleans and nullable booleans, 
enums and flags. The “always-confirm-implicit” and “always-confirm-explicit” values always asks for 
confirmation, but the first applies the change if you change path whereas the second dismiss it. The 
“always-delay” value adds each change in delay mode, allowing to apply multiple keys at once.</description>
     </key>
     <key name="sort-case-sensitive" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/sort-case-sensitive' -->
       <summary>A flag to sort keys list case-sensitively</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/sort-case-sensitive' -->
       <description>GSettings doesn’t allow keys to use upper-case in their names, but installation paths of 
schemas can. If “true”, the keys list is sorted case-sensitively, with in usual order upper-case folders 
first.</description>
     </key>
     <key type="b" name="mouse-use-extra-buttons">
       <default>true</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-use-extra-buttons' -->
       <summary>Use “Back” and “Forward” mouse button events</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-use-extra-buttons' -->
       <description>For users with mice that have buttons for “Forward” and “Back”, this key will determine 
if any action is taken inside of a browser window when either is pressed.</description>
     </key>
     <key type="i" name="mouse-back-button">
       <default>8</default>
       <range min="6" max="14"/>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-back-buttons' -->
       <summary>Mouse button to activate the “Back” command in browser window</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-back-buttons' -->
       <description>For users with mice that have buttons for “Forward” and “Back”, this key will set which 
button activates the “Back” command in a browser window. Possible values range between 6 and 14.</description>
     </key>
     <key type="i" name="mouse-forward-button">
       <default>9</default>
       <range min="6" max="14"/>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-forward-buttons' -->
       <summary>Mouse button to activate the “Forward” command in browser window</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/mouse-forward-buttons' -->
       <description>For users with mice that have buttons for “Forward” and “Back”, this key will set which 
button activates the “Forward” command in a browser window. Possible values range between 6 and 
14.</description>
     </key>
     <key type="b" name="refresh-settings-schema-source">
       <default>true</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/refresh-settings-schema-source' -->
       <summary>A flag to check for added or removed schemas</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/refresh-settings-schema-source' -->
       <description>Dconf Editor can monitor if schemas are added or removed from the multiple possible 
locations. That’s done by checking every three seconds if the schemas list has changed. As this way to do is 
suboptimal, this function can be disabled by setting this flag to “false”. Note that this option will be 
removed when a better way to do things is found.</description>
     </key>
     <key name="relocatable-schemas-enabled-mappings" 
flags="ca.desrt.dconf-editor.RelocatableSchemasEnabledMappings">
       <default>['User', 'Built-in', 'Internal', 'Startup']</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/relocatable-schemas-enabled-mappings' -->
       <summary>Enabled relocatable schema mapping facilities</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/relocatable-schemas-enabled-mappings' -->
       <description>Flags for the relocatable schemas mapping facilities. “User” enables mappings defined by 
the “relocatable-schemas-user-paths” key; “Built-in” enables well-known mappings hardcoded into Dconf Editor; 
“Internal” is reserved for Dconf Editor own mappings; “Startup” is for mapping a relocatable schema from the 
command-line.</description>
     </key>
     <key name="relocatable-schemas-user-paths" type="a{ss}">
       
<default>{'ca.desrt.dconf-editor.Demo.Relocatable':'/ca/desrt/dconf-editor/Demo/relocatable/'}</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/relocatable-schemas-user-paths' -->
       <summary>Mapping of paths to manually associated schemas</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/relocatable-schemas-user-paths' -->
       <description>A dictionary that maps schema IDs with path specifications. It is used to allow the user 
to associate a relocatable schema to certain paths. Path specifications may contain wildcards in the form of 
empty segments (e.g. /ca/desrt/dconf-editor//), defining possibly multiple paths. The same schema ID may be 
associated with multiple path specifications.</description>
     </key>
     <key name="use-shortpaths" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/use-shortpaths' 
-->
       <summary>A flag for skipping unnecessary subfolders</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/use-shortpaths' -->
       <description>When a folder only contains one subfolder and no keys, Dconf Editor can jump to that 
subfolder directly. This flag enables that behaviour.</description>
     </key>
   </schema>
   <schema id="ca.desrt.dconf-editor.NightLight">
     <key name="automatic-night-mode" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/automatic-night-mode' -->
       <summary>Follow system night light</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/automatic-night-mode' -->
       <description>Use GNOME night light setting to activate night-mode.</description>
     </key>
   </schema>
   <schema id="ca.desrt.dconf-editor.Bookmarks">
     <key name="bookmarks" type="as">
       <default>[]</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/bookmarks' -->
       <summary>A list of bookmarked paths</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor /ca/desrt/dconf-editor/bookmarks' 
-->
       <description>Contains all paths bookmarked by the user as an array of strings.</description>
     </key>
     <key name="small-bookmarks-rows" type="b">
       <default>false</default>
+      <!-- Translators: summary of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/small-bookmarks-rows' -->
       <summary>A flag to enable small rows for bookmarks list</summary>
+      <!-- Translators: description of a settings key, see 'dconf-editor 
/ca/desrt/dconf-editor/small-bookmarks-rows' -->
       <description>If “true”, the bookmarks list use smaller rows.</description>
     </key>
   </schema>
@@ -227,151 +267,208 @@
     <child schema="ca.desrt.dconf-editor.Demo.Conflict2" name="conflict2"/>
     <key name="boolean" type="b">
       <default>true</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/boolean' -->
       <summary>A boolean, type ‘b’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/boolean' -->
       <description>Booleans can only take two values, “true” or “false”.</description>
     </key>
     <key name="boolean-nullable" type="mb">
       <default>nothing</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/boolean-nullable' -->
       <summary>A nullable boolean, type ‘mb’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/boolean-nullable' -->
       <description>GSettings allows nullable types, that are similar to other types but could take a 
“nothing” value. A nullable boolean can only take three values, “true”, “false” and “nothing”.</description>
     </key>
     <key name="byte" type="y">
       <default>66</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/byte' -->
       <summary>A byte (unsigned), type ‘y’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/byte' -->
       <description>A byte value is an integer between 0 and 255. It may be used to pass around 
characters.</description>
     </key>
     <key name="bytestring" type="ay">
       <default>[72, 101, 108, 108, 108]</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/bytestring' -->
       <summary>A bytestring, type ‘ay’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/bytestring' 
-->
       <description>The bytestring type is commonly used to pass around strings that may not be valid utf8. 
In that case, the convention is that the nul terminator character should be included as the last character in 
the array.</description>
     </key>
     <key name="bytestring-array" type="aay">
       <default>[[72, 101, 108, 108, 108], [87, 111, 114, 108, 100], [33]]</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/bytestring-array' -->
       <summary>A bytestring array, type ‘aay’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/bytestring-array' -->
       <description>This is the type of an array of bytestrings. The bytestring type is commonly used to pass 
around strings that may not be valid utf8.</description>
     </key>
     <key name="dbus-handle" type="h">
       <default>0</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dbus-handle' -->
       <summary>A D-Bus handle type, type ‘h’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-handle' -->
       <description>The handle type is a 32-bit signed integer value that is, by convention, used as an index 
into an array of file descriptors that are sent alongside a D-Bus message.&#xA;&#xA;If you are not 
interacting with D-Bus, then there is no reason to make use of this type.</description>
     </key>
     <key name="dbus-object-path" type="o">
       <default>'/ca/desrt/dconf_editor'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-object-path' -->
       <summary>A D-Bus object path, type ‘o’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-object-path' -->
       <description>An object path is used to identify D-Bus objects at a given destination on the 
bus.&#xA;&#xA;If you are not interacting with D-Bus, then there is no reason to make use of this 
type.</description>
     </key>
     <key name="dbus-object-path-array" type="ao">
       <default>['/ca/desrt/dconf_editor/menus/appmenu', '/ca/desrt/dconf_editor/window/1']</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-object-path-array' -->
       <summary>A D-Bus object path array, type ‘ao’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-object-path-array' -->
       <description>An object path array could contain any number of object paths (including none: 
“[]”).&#xA;&#xA;If you are not interacting with D-Bus, then there is no reason to make use of this 
type.</description>
     </key>
     <key name="dbus-signature" type="g">
       <default>'ii'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dbus-signature' 
-->
       <summary>A D-Bus signature, type ‘g’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/dbus-signature' -->
       <description>A D-Bus signature is a string used as type signature for a D-Bus method or 
message.&#xA;&#xA;If you are not interacting with D-Bus, then there is no reason to make use of this 
type.</description>
     </key>
     <key name="dict-entry" type="{ss}">
       <default>{'color', 'red'}</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dict-entry' -->
       <summary>A dictionary entry of type ‘{ss}’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dict-entry' 
-->
       <description>A dictionary maps values of a basic type to another value (of any type). A dictionary 
entry is one such mapping.</description>
     </key>
     <key name="dictionary" type="a{sv}">
       <default>{'title': &#60;'Example'&#62;, 'character': &#60;uint32 56&#62;, 'bold': 
&#60;true&#62;}</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dictionary' -->
       <summary>A “vardict”, type ‘a{sv}’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/dictionary' 
-->
       <description>A dictionary maps values of a basic type to another value (of any type). One simple use 
case is to map strings to variants.</description>
     </key>
     <key name="double" type="d">
       <default>3.1415926535897933</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/double' -->
       <summary>A double, type ‘d’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/double' -->
       <description>A double value could represent any real number.</description>
     </key>
     <key name="enumeration" enum="ca.desrt.dconf-editor.DemoEnum">
       <default>'White'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/enumeration' -->
       <summary>A 5-choices enumeration</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/enumeration' -->
       <description>Enumerations could be done either with the “enum” attribute, or with a “choices” 
tag.</description>
     </key>
-    <key name="integer-16-signed" type="n">
-      <default>-32768</default>
-      <summary>A short integer, type ‘n’</summary>
-      <description>A 16-bit signed integer. See also the “integer-16-unsigned” key.</description>
-    </key>
     <key name="flags" flags="ca.desrt.dconf-editor.DemoFlags">
       <default>["Blue", "White", "Red"]</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/flags' -->
       <summary>Flags: choose-colors-you-love</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/flags' -->
       <description>Flags could be set by the “enum” attribute.</description>
     </key>
+    <key name="integer-16-signed" type="n">
+      <default>-32768</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-16-signed' -->
+      <summary>A short integer, type ‘n’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-16-signed' -->
+      <description>A 16-bit signed integer. See also the “integer-16-unsigned” key.</description>
+    </key>
     <key name="integer-16-unsigned" type="q">
       <default>65535</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-16-unsigned' -->
       <summary>An unsigned short integer, type ‘q’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-16-unsigned' -->
       <description>A 16-bit unsigned integer. See also the “integer-16-signed” key.</description>
     </key>
     <key name="integer-32-signed" type="i">
       <default>-2147483648</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-32-signed' -->
       <summary>An usual integer, type ‘i’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-32-signed' -->
       <description>A 32-bit signed integer. See also the “integer-32-unsigned” key.</description>
     </key>
     <key name="integer-32-unsigned" type="u">
       <default>4294967295</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-32-unsigned' -->
       <summary>An unsigned usual integer, type ‘u’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-32-unsigned' -->
       <description>A 32-bit unsigned integer. See also the “integer-32-signed” key.</description>
     </key>
     <key name="integer-64-signed" type="x">
       <default>-9223372036854775808</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-64-signed' -->
       <summary>A long integer, type ‘x’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-64-signed' -->
       <description>A 64-bit signed integer. See also the “integer-64-unsigned” key.</description>
     </key>
     <key name="integer-64-unsigned" type="t">
       <default>18446744073709551615</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-64-unsigned' -->
       <summary>An unsigned long integer, type ‘t’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/integer-64-unsigned' -->
       <description>A 64-bit unsigned integer. See also the “integer-64-signed” key.</description>
     </key>
     <!-- TODO add a nullable-(unsigned-)integer -->
     <key name="number-with-range" type="i">
       <default>3</default>
       <range min="-2" max="10"/>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/number-with-range' -->
       <summary>A number with range</summary>
-      <description>Every numeral setting (integers and unsigned integers of every type, plus doubles) could 
be limited to a custom range of values. For example, this integer could only take a value between -2 and 
10.</description> <!-- handle do not accept range -->
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/number-with-range' -->
+      <description>Every numeral setting (integers and unsigned integers of every type, plus doubles) could 
be limited to a custom range of values. For example, this integer could only take a value between -2 and 
10.</description> <!-- handle do not accept range; TODO mention bytes -->
     </key>
     <key name="pair-of-integers" type="(ii)">
       <default>(800, 600)</default>
-      <!-- Translators: do not forget the parenthesis, they are meaningful. -->
+      <!-- Translators: do not forget the parenthesis, they are meaningful; summary of a demo key, see 
'dconf-editor /ca/desrt/dconf-editor/Demo/pair-of-integers' -->
       <summary>A custom type, here ‘(ii)’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/pair-of-integers' -->
       <description>Dconf Editor lets you edit any settings type supported by GSettings, falling back on a 
string entry when it doesn’t have a better way to do. Here is a tuple of two 32-bit signed 
integers.</description>
     </key>
     <key name="string" type="s">
       <default>'Lorem ipsum dolor sit amet, consectetur adipiscing elit.'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/string' -->
       <summary>A string, type ‘s’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/string' -->
       <description>The string type could accept any utf8 string. Note that an empty string “''” is not the 
same as NULL (nothing); see also the “string-nullable” key.</description>
     </key>
     <key name="string-array" type="as">
       <default>['orange', 'banana', 'pear']</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/string-array' 
-->
       <summary>A string array, type ‘as’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/string-array' -->
       <description>A string array contains any number of strings of whatever length. It may be an empty 
array, “[]”.</description>
     </key>
     <key name="string-nullable" type="ms">
       <default>nothing</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/string-nullable' -->
       <summary>A nullable string, type ‘ms’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/string-nullable' -->
       <description>GSettings allows nullable types, that are similar to other types but could take a 
“nothing” value. A nullable string can take any string as value, including the empty string “''”, or can be 
NULL (nothing).</description>
     </key>
     <key name="variant" type="v">
       <default>&#60;@mmb just nothing&#62;</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/variant' -->
       <summary>A variant, type ‘v’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/variant' -->
       <description>Variants could be stored inside variants, and consequently as a GSettings type. Their 
representation use the XML brackets (‘&#60;’ and ‘&#62;’ characters, in a gschema file “&amp;#60;” and 
“&amp;#62;” respectively), with a parsable representation of their content inside. If unclear, the type can 
be given in the value with a prefix annotation like “@x” (where “x” is the type string) or “int64”. See 
https://developer.gnome.org/glib/stable/gvariant-text.html for complete documentation.</description>
     </key>
     <key name="weird-enum" enum="ca.desrt.dconf-editor.DemoWeirdEnum">
       <default>'only-choice'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/weird-enum' -->
       <summary>A 1-choice enumeration</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/weird-enum' 
-->
       <description>An enumeration could contain only one item, but that’s probably an error. Dconf Editor 
warns you in that case.</description>
     </key>
     <key name="weird-range" type="i">
       <default>5</default>
       <range min="5" max="5"/>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/weird-range' -->
       <summary>A 1-choice integer value</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/weird-range' -->
       <description>A range could limit an integer key to only allow one value, but that’s probably an error. 
Dconf Editor warns you in that case.</description>
     </key>
     <key name="weird-triv" type="()">
       <default>()</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/weird-triv' -->
       <summary>The empty tuple, type and value “()”</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor /ca/desrt/dconf-editor/Demo/weird-triv' 
-->
       <description>There’s an empty tuple type (called sometimes “triv”) that is a tuple with no content, 
and can only take “()” as value.</description>
     </key>
   </schema>
@@ -382,72 +479,98 @@
   <schema id="ca.desrt.dconf-editor.Demo.Relocatable">
     <key name="boolean" type="b">
       <default>false</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/boolean' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <summary>A boolean, type ‘b’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/boolean' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <description>An usual boolean value, defined by a relocatable schema.</description>
     </key>
     <key name="integer" type="i">
       <default>4</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/integer' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <summary>An usual integer, type ‘i’</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/integer' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <description>A 32-bit signed integer, defined by a relocatable schema.</description>
     </key>
     <key name="flags" flags="ca.desrt.dconf-editor.DemoFlags">
       <default>["Blue", "White", "Red"]</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/flags' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <summary>Flags: choose-colors-you-love</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/relocatable/flags' (with default /ca/desrt/dconf-editor/relocatable-* settings) 
-->
       <description>Flags could be set by the “enum” attribute.</description>
     </key>
   </schema>
   <schema id="ca.desrt.dconf-editor.Demo.Conflict1" path="/ca/desrt/dconf-editor/Demo/Conflict/">
     <key name="a-non-conflicting-key" type="b">
       <default>true</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
a-non-conflicting-key' -->
       <summary>A normal non-conflicting key from Conflict1</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
a-non-conflicting-key' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. 
Non-conflicting keys should have no issues.</description>
     </key>
     <key name="default-value-conflict" type="i">
       <default>1</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
default-value-conflict' -->
       <summary>Conflicting key defaulting to “1” that should give an error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
default-value-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different default value.</description>
     </key>
     <key name="range-conflict" type="u">
       <default>0</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
range-conflict' -->
       <summary>Conflicting key with no range that should give an error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
range-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different range.</description>
     </key>
     <key name="type-conflict" type="s">
       <default>'test'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
type-conflict' -->
       <summary>A (simple) string conflicting key that should give a error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
type-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different type.</description>
     </key>
     <key name="warning-similar" type="b">
       <default>true</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
warning-similar' -->
       <summary>Conflicting key from Conflict1 that should give a warning</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict1 
warning-similar' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It can be 
edited, since the types are compatible, but it is still an issue.</description>
     </key>
   </schema>
   <schema id="ca.desrt.dconf-editor.Demo.Conflict2" path="/ca/desrt/dconf-editor/Demo/Conflict/">
     <key name="another-non-conflicting-key" type="b">
       <default>true</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
another-non-conflicting-key' -->
       <summary>A normal non-conflicting key from Conflict2</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
another-non-conflicting-key' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. 
Non-conflicting keys should have no issues.</description>
     </key>
     <key name="default-value-conflict" type="i">
       <default>2</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
default-value-conflict' -->
       <summary>Conflicting key defaulting to “2” that should give an error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
default-value-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different default value.</description>
     </key>
     <key name="range-conflict" type="u">
       <default>0</default>
       <range min="0" max="5"/>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
range-conflict' -->
       <summary>Conflicting key with range 0~5 that should give an error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
range-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different range.</description>
     </key>
     <key name="type-conflict" type="ms">
       <default>'test'</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
type-conflict' -->
       <summary>A nullable-string conflicting key that should give an error</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
type-conflict' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It 
shouldn’t be editable as a key mapped to the same path has a different type.</description>
     </key>
     <key name="warning-similar" type="b">
       <default>true</default>
+      <!-- Translators: summary of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
warning-similar' -->
       <summary>Conflicting key from Conflict2 that should give a warning</summary>
+      <!-- Translators: description of a demo key, see 'dconf-editor ca.desrt.dconf-editor.Demo.Conflict2 
warning-similar' -->
       <description>This key is a test for multiple schemas in the same path with conflicting keys. It can be 
edited, since the types are compatible, but it is still an issue.</description>
     </key>
   </schema>
diff --git a/editor/dconf-editor.vala b/editor/dconf-editor.vala
index 2af9dca..069d495 100644
--- a/editor/dconf-editor.vala
+++ b/editor/dconf-editor.vala
@@ -188,7 +188,10 @@ private class ConfigurationEditor : Gtk.Application
 
         set_option_context_parameter_string ("[ PATH | [FIXED_SCHEMA|RELOC_SCHEMA:PATH] [KEY] ]");
         /* Translators: command-line argument description, see 'dconf-editor --help'; try to put that string 
in 80 characters or less, if possible. */
-        set_option_context_summary (_("Graphical interface for editing other applications settings.") + 
"\n\n" + _("Uses the gsettings API of the glib library, and other ways."));
+        set_option_context_summary (_("Graphical interface for editing other applications settings.")
+                                  + "\n\n"
+        /* Translators: command-line argument description, see 'dconf-editor --help'; try to put that string 
in 80 characters or less, if possible. */
+                                  + _("Uses the gsettings API of the glib library, and other ways."));
 
         /* Translators: command-line header description, see 'dconf-editor --help' */
         set_option_context_description (_("Arguments description:") +
@@ -196,26 +199,31 @@ private class ConfigurationEditor : Gtk.Application
 "\n  PATH" +
 /* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("a folder path or a key path") +
+/* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("example: “/org/gnome/” or “/ca/desrt/dconf-editor/Demo/boolean”") +
 
 "\n  FIXED_SCHEMA" +
 /* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("the name of a schema with fixed path") +
+/* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("example: “ca.desrt.dconf-editor.Settings”") +
 
 "\n  RELOC_SCHEMA" +
 /* Translators: command-line argument description, see 'dconf-editor --help'; no need to put your 
translation of "relocatable" between quotation marks, that's done in English to highlight why the option is 
called "RELOC_SCHEMA" */
 "\n    " + _("the name of a “relocatable” schema, without fixed path") +
+/* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("see list with the “--list-relocatable-schemas” option") +
 
 "\n  MAPPING" +
 /* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("the path where to map the relocatable schema") +
+/* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("example: “ca.desrt.dconf-editor.Bookmarks:/ca/desrt/dconf-editor/”") +
 
 "\n  KEY" +
 /* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("the name of a key from the schema") +
+/* Translators: command-line argument description, see 'dconf-editor --help' */
 "\n    " + _("example: “bookmarks”") +
 "\n");
 
@@ -548,9 +556,10 @@ private class ConfigurationEditor : Gtk.Application
     * * Copy action
     \*/
 
+    private uint notification_number = 0;
+
     /* Translators: notification header, try ctrl-c while in the keys list */
     private Notification notification = new Notification (_("Copied to clipboard"));
-    private uint notification_number = 0;
 
     private void copy_cb (SimpleAction action, Variant? gvariant)
         requires (gvariant != null)
diff --git a/editor/dconf-headerbar.vala b/editor/dconf-headerbar.vala
index 5bbfde8..0c1968b 100644
--- a/editor/dconf-headerbar.vala
+++ b/editor/dconf-headerbar.vala
@@ -180,6 +180,9 @@ private class DConfHeaderBar : BrowserHeaderBar, AdaptativeWidget
         _this.set_default_widgets_states (/* show go_back_button      */ true,
                                           /* show ltr_left_separator  */ false,
                                           /* title_label text or null */
+
+
+
                                           /* Translators: on really small windows, the bookmarks popover is 
replaced by an in-window view; here is the name of the view, displayed in the headerbar */
                                                                          _("Bookmarks"),
                                           /* show info_button         */ false,
diff --git a/editor/dconf-window.vala b/editor/dconf-window.vala
index 8e54fb9..e83077b 100644
--- a/editor/dconf-window.vala
+++ b/editor/dconf-window.vala
@@ -344,14 +344,13 @@ private class DConfWindow : BrowserWindow
         /* Translators: initial "use at your own risk" dialog, the button label */
         dialog.add_buttons (_("I’ll be careful."), ResponseType.ACCEPT);
 
-        // TODO don't show box if the user explicitely said she wanted to see the dialog next time?
         Box box = (Box) dialog.get_message_area ();
         /* Translators: initial "use at your own risk" dialog, the checkbox label */
         CheckButton checkbutton = new CheckButton.with_label (_("Show this dialog next time."));
         checkbutton.visible = true;
         checkbutton.active = true;
         checkbutton.margin_top = 5;
-        box.add (checkbutton);
+        box.add (checkbutton);  // TODO don't show box if the user explicitely said she wanted to see the 
dialog next time?
 
         ulong dialog_response_handler = dialog.response.connect (() => { if (!checkbutton.active) 
settings.set_boolean ("show-warning", false); });
         dialog.run ();
@@ -1061,8 +1060,8 @@ private class DConfWindow : BrowserWindow
     private void notify_object_deleted (SimpleAction action, Variant? path_variant)
         requires (path_variant != null)
     {
-        string full_name;
         uint16 unused;  // GAction parameter type switch is a little touchy, see pathbar.vala
+        string full_name;
         ((!) path_variant).@get ("(sq)", out full_name, out unused);
 
         /* Translators: notification text, when the requested key has been removed; the %s is the key path */
diff --git a/editor/delayed-setting-view.ui b/editor/delayed-setting-view.ui
index 652acd7..2560b62 100644
--- a/editor/delayed-setting-view.ui
+++ b/editor/delayed-setting-view.ui
@@ -79,7 +79,6 @@
                 <property name="visible">True</property>
                 <property name="halign">start</property>
                 <property name="hexpand">True</property>
-                <property name="label" translatable="yes">Default value</property>
                 <style>
                   <class name="bold-label"/>
                 </style>
@@ -125,7 +124,6 @@
                 <property name="visible">True</property>
                 <property name="halign">start</property>
                 <property name="hexpand">True</property>
-                <property name="label" translatable="yes">Default value</property>
                 <style>
                   <class name="bold-label"/>
                 </style>
diff --git a/editor/help-overlay.ui b/editor/help-overlay.ui
index 38e0733..62eed26 100644
--- a/editor/help-overlay.ui
+++ b/editor/help-overlay.ui
@@ -247,7 +247,7 @@
           <object class="GtkShortcutsGroup">
             <property name="visible">True</property>
             <property name="title" translatable="yes" context="shortcut window">Quit</property>
-            <!-- TODO missing "discard and quit", as <alt>F4 has a different behaviour when a dialog is 
opened (and is WM-specific) -->
+            <!-- TODO rething "discard and quit", as <alt>F4 has a different behaviour when a dialog is 
opened, and is WM-specific -->
             <child>
               <object class="GtkShortcutsShortcut"> <!-- TODO doesn't quit if a dialog is opened -->
                 <property name="visible">True</property>
@@ -263,7 +263,7 @@
               </object>
             </child>
             <child>
-              <object class="GtkShortcutsShortcut"> <!-- TODO doesn't quit if a dialog is opened -->
+              <object class="GtkShortcutsShortcut"> <!-- TODO doesn't quit if a dialog is opened, but closes 
the dialog -->
                 <property name="visible">True</property>
                 <property name="title" translatable="yes" context="shortcut window">Dismiss pending changes 
and quit</property>
                 <property name="accelerator">&lt;Alt&gt;F4</property>
diff --git a/editor/modifications-list.vala b/editor/modifications-list.vala
index d647384..95fe306 100644
--- a/editor/modifications-list.vala
+++ b/editor/modifications-list.vala
@@ -28,8 +28,10 @@ private class ModificationsList : OverlayedList
         placeholder_text = _("Delayed mode is on\nbut\nno pending changes");
         add_placeholder ();
 
-        /* Translators: labels of the two buttons of the list of pending modifications, to switch between 
applying changes to the whole list and selecting some items for more advanced things (not displayed 
currently, but this change is wanted) */
-        first_mode_name = _("Rule all"); second_mode_name = _("Select");
+        /* Translators: label of one of the two buttons of the list of pending modifications, to switch 
between applying changes to the whole list and selecting some items for more advanced things (not displayed 
currently, but this change is wanted); the second is "Select" */
+        first_mode_name = _("Rule all");
+        /* Translators: label of one of the two buttons of the list of pending modifications, to switch 
between applying changes to the whole list and selecting some items for more advanced things (not displayed 
currently, but this change is wanted); the first is "Rule all" */
+        second_mode_name = _("Select");
 
         main_list_box.set_header_func (delayed_setting_row_update_header);
     }
diff --git a/editor/modifications-revealer.ui b/editor/modifications-revealer.ui
index 72ee5e6..a14297b 100644
--- a/editor/modifications-revealer.ui
+++ b/editor/modifications-revealer.ui
@@ -66,6 +66,7 @@
         <child>
           <object class="GtkModelButton" id="apply_button">
             <property name="visible">True</property>
+            <!-- Translators: when there are pending changes, label of the "apply" button in the bottom bar, 
on large windows-->
             <property name="text" translatable="yes">Apply</property>
             <property name="centered">True</property>
             <property name="iconic">True</property>
diff --git a/editor/pathentry.ui b/editor/pathentry.ui
index 0be0a5d..76d10cf 100644
--- a/editor/pathentry.ui
+++ b/editor/pathentry.ui
@@ -39,8 +39,10 @@
         </style>
         <child internal-child="accessible">
           <object class="AtkObject">
-            <property name="AtkObject::accessible-name" translatable="yes">Refresh</property>
-            <property name="AtkObject::accessible-description" translatable="yes">Refresh search 
results</property>
+            <!-- Translators: accessible name of the "close" button that is linked with the search entry on 
small windows -->
+            <property name="AtkObject::accessible-name" translatable="yes">Close search</property>
+            <!-- Translators: accessible description of the "close" button that is linked with the search 
entry on small windows -->
+            <property name="AtkObject::accessible-description" translatable="yes">Close search 
results</property>
           </object>
         </child>
         <child>
@@ -61,7 +63,9 @@
         </style>
         <child internal-child="accessible">
           <object class="AtkObject">
+            <!-- Translators: accessible name of the "refresh" button that is linked with the search entry 
on large windows -->
             <property name="AtkObject::accessible-name" translatable="yes">Refresh</property>
+            <!-- Translators: accessible description of the "refresh" button that is linked with the search 
entry on large windows -->
             <property name="AtkObject::accessible-description" translatable="yes">Refresh search 
results</property>
           </object>
         </child>
diff --git a/editor/pathwidget.ui b/editor/pathwidget.ui
index b54ba70..32896a5 100644
--- a/editor/pathwidget.ui
+++ b/editor/pathwidget.ui
@@ -17,11 +17,6 @@
             <signal name="search-changed" handler="search_changed_cb"/>
             <signal name="search-stopped" handler="search_stopped_cb"/>
           </object>
-          <packing>
-            <!-- property name="icon-name">document-edit-symbolic</property>    TODO document-edit-symbolic 
? -->
-            <property name="title" translatable="yes">Edit path</property> <!-- TODO reuse translation... 
1/2 -->
-            <!-- property name="name">entry</property -->
-          </packing>
         </child>
         <child>
           <object class="GtkGrid" id="pathbar_grid">
@@ -47,18 +42,15 @@
                 </style>
                 <child internal-child="accessible">
                   <object class="AtkObject">
+                    <!-- Translators: accessible name of the enter-search button displayed in small-size 
windows -->
                     <property name="AtkObject::accessible-name" translatable="yes">Search</property>
+                    <!-- Translators: accessible description of the enter-search button displayed in 
small-size windows -->
                     <property name="AtkObject::accessible-description" translatable="yes">Search 
keys</property>
                   </object>
                 </child>
               </object>
             </child>
           </object>
-          <packing>
-            <!-- property name="icon-name">folder-visiting-symbolic</property -->
-            <property name="title" translatable="yes">Browse keys</property> <!-- TODO reuse translation... 
2/2 -->
-            <!-- property name="name">pathbar</property -->
-          </packing>
         </child>
       </object>
     </child>
@@ -76,7 +68,9 @@
         </style>
         <child internal-child="accessible">
           <object class="AtkObject">
+            <!-- Translators: accessible name of the search togglebutton displayed in usual-size windows -->
             <property name="AtkObject::accessible-name" translatable="yes">Search</property>
+            <!-- Translators: accessible description of the search togglebutton displayed in usual-size 
windows -->
             <property name="AtkObject::accessible-description" translatable="yes">Search keys</property>
           </object>
         </child>
diff --git a/editor/registry-info.ui b/editor/registry-info.ui
index 40f1bbc..d59cd67 100644
--- a/editor/registry-info.ui
+++ b/editor/registry-info.ui
@@ -29,6 +29,7 @@
                         <property name="xalign">0.5</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/Conflict/warning-similar' -->
                         <property name="label" translatable="yes">This key is defined and used by more than 
one schema. This could lead to problems. Edit value at your own risk.</property>
                       </object>
                     </child>
@@ -66,6 +67,7 @@
                         <property name="xalign">0.5</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/Conflict/type-conflict' -->
                         <property name="label" translatable="yes">This key is incompatibly defined and used 
by more than one schema. It is impossible to work with its value in a meaningful way.</property>
                       </object>
                     </child>
@@ -103,12 +105,14 @@
                         <property name="xalign">0</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, when a key is not defined by a schema 
-->
                         <property name="label" translatable="yes">No schema available. A schema is what 
describes the use of a key, and Dconf Editor can’t find one associated with this key. If the application that 
was using this key has been uninstalled, or if this key is obsolete, you may want to erase it.</property>
                       </object>
                     </child>
                     <child>
                       <object class="GtkButton" id="erase_button">
                         <property name="visible">True</property>
+                        <!-- Translators: label of the action button of an infobar, when a key is not 
defined by a schema -->
                         <property name="label" translatable="yes">Erase key</property>
                         <property name="action-name">view.delay-erase</property>
                         <property name="action-target">''</property>
@@ -148,6 +152,7 @@
                         <property name="xalign">0.5</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/weird-enum' -->
                         <property name="label" translatable="yes">This enumeration offers only one choice. 
That’s probably an error of the application that installed this schema. If possible, please open a bug about 
it.</property>
                       </object>
                     </child>
@@ -158,6 +163,7 @@
                         <property name="xalign">0.5</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/weird-range' -->
                         <property name="label" translatable="yes">This integer key can only take one value. 
That’s probably an error of the application that installed this schema. If possible, please open a bug about 
it.</property>
                       </object>
                     </child>
@@ -168,6 +174,7 @@
                         <property name="xalign">0.5</property>
                         <property name="max-width-chars">40</property>
                         <property name="wrap">True</property>
+                        <!-- Translators: warning text of an infobar, see 'dconf-editor 
/ca/desrt/dconf-editor/Demo/weird-triv' -->
                         <property name="label" translatable="yes">This key has a special “empty tuple” type. 
That’s probably an error of the application that installed this schema. If possible, please open a bug about 
it.</property>
                       </object>
                     </child>
diff --git a/editor/registry-info.vala b/editor/registry-info.vala
index 8ca08de..3523a2e 100644
--- a/editor/registry-info.vala
+++ b/editor/registry-info.vala
@@ -35,8 +35,6 @@ private class RegistryInfo : Grid, BrowsableView
     [CCode (notify = false)] internal ModificationsHandler modifications_handler { private get; set; }
 
     private uint current_key_info_hash = 0;
-    [CCode (notify = false)] internal string full_name   { get; private set; default = ""; }
-    [CCode (notify = false)] internal uint16 context_id  { get; private set; default = 
ModelUtils.undefined_context_id; }
 
     /*\
     * * Cleaning
@@ -65,6 +63,9 @@ private class RegistryInfo : Grid, BrowsableView
     * * Populating
     \*/
 
+    [CCode (notify = false)] internal string full_name   { internal get; private set; default = ""; }
+    [CCode (notify = false)] internal uint16 context_id  { internal get; private set; default = 
ModelUtils.undefined_context_id; }
+
     /* Translators: field description when displaying folder properties; name of the folder */
     private const string          NAME_FIELD_DESCRIPTION = _("Name");
 
@@ -244,9 +245,11 @@ private class RegistryInfo : Grid, BrowsableView
             {
                 range_type_is_range = ((RangeType) range_type) == RangeType.RANGE;
                 add_row_from_label (FORCED_RANGE_FIELD_DESCRIPTION,
+                /* Translators: field content when displaying key properties; "Yes" if the key has a range 
set, "No" if not */
+                                                                                    range_type_is_range ? 
_("Yes")
 
-                /* Translators: field content when displaying key properties; "yes" if the key has a range 
set, "no" if not */
-                                                                                    range_type_is_range ? 
_("Yes") : _("No"));
+                /* Translators: field content when displaying key properties; "Yes" if the key has a range 
set, "No" if not */
+                                                                                                        : 
_("No"));
             }
         }
 
@@ -558,6 +561,7 @@ private class RegistryInfo : Grid, BrowsableView
         //    key.planned_value = key.value;
         SignalHandler.unblock (key_editor_child, value_has_changed_handler);
     }
+
     /*\
     * * Rows creation
     \*/
diff --git a/editor/registry-list.vala b/editor/registry-list.vala
index edef7c1..33a0c6b 100644
--- a/editor/registry-list.vala
+++ b/editor/registry-list.vala
@@ -511,8 +511,12 @@ private abstract class RegistryList : Grid, BrowsableView, AdaptativeWidget
             else if (key_conflict == KeyConflict.HARD)
             {
                 row.get_style_context ().add_class ("hard-conflict");
-                /* Translators: two strings with the same meaning, one used on large windows, one on small 
windows; means that the key has (at least) one other key defined by a different schema but at the same path 
and with the same name */
-                row.update_label (_("conflicting keys"), true, _("conflict"), true);
+                /* Translators: means that the key has (at least) one other key defined by a different 
schema but at the same path and with the same name; used on large windows ("conflict" is used on small 
windows) */
+                row.update_label (_("conflicting keys"), true,
+
+                /* Translators: means that the key has (at least) one other key defined by a different 
schema but at the same path and with the same name; used on small windows ("conflicting keys" is used on 
large windows) */
+                                  _("conflict"), true);
+
                 if (type_code == "b")
                     row.use_switch (false);
             }
@@ -619,8 +623,12 @@ private abstract class RegistryList : Grid, BrowsableView, AdaptativeWidget
     {
         if (key_value == null)
         {
-            /* Translators: two strings with the same meaning, one used on large windows, one on small 
windows; means that the key has been erased */
-            row.update_label (_("key erased"), true, _("erased"), true);
+            /* Translators: means that the key has been erased; used on large windows ("erased" is used on 
small windows) */
+            row.update_label (_("key erased"), true,
+
+            /* Translators: means that the key has been erased; used on small windows ("key erased" is used 
on large windows) */
+                              _("erased"), true);
+
             if (type_string == "b")
                 row.use_switch (false);
         }
diff --git a/editor/short-pathbar.ui b/editor/short-pathbar.ui
index 0d1e8f5..8c079b3 100644
--- a/editor/short-pathbar.ui
+++ b/editor/short-pathbar.ui
@@ -19,7 +19,9 @@
         </child>
         <!-- child internal-child="accessible">
           <object class="AtkObject">
+            < Translators: ... >
             <property name="AtkObject::accessible-name" translatable="yes">Search</property>
+            < Translators: ... >
             <property name="AtkObject::accessible-description" translatable="yes">Search keys</property>
           </object>
         </child -->


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