[gnome-documents] Add some translator comments

[Cosimo Cecchi <cosimoc src gnome org>]

commit ce1b1fdbbe01b64ed9755bc63ea2b10f7a7aa2d1
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Wed Mar 20 15:36:23 2013 -0400

    Add some translator comments
    
    https://bugzilla.gnome.org/show_bug.cgi?id=696217

 src/documents.js              |    3 +++
 src/lib/gd-places-bookmarks.c |    3 +++
 src/search.js                 |   10 +++++-----
 3 files changed, 11 insertions(+), 5 deletions(-)
---
diff --git a/src/documents.js b/src/documents.js
index 7ab145d..2d6ed16 100644
--- a/src/documents.js
+++ b/src/documents.js
@@ -605,6 +605,9 @@ const LocalDocument = new Lang.Class({
 
         let file = Gio.File.new_for_uri(this.uri);
         if (file.has_parent(Application.application.gettingStartedLocation)) {
+            // Translators: Documents ships a "Getting Started with Documents"
+            // tutorial PDF. The "GNOME" string below is displayed as the author name
+            // of that document, and doesn't normally need to be translated.
             this.author = _("GNOME");
             this.name = this.title = _("Getting Started with Documents");
         }
diff --git a/src/lib/gd-places-bookmarks.c b/src/lib/gd-places-bookmarks.c
index 03870ba..c2697d8 100644
--- a/src/lib/gd-places-bookmarks.c
+++ b/src/lib/gd-places-bookmarks.c
@@ -306,6 +306,9 @@ load_bookmark_model (GdPlacesBookmarks *self,
                 }
 
                 if (markup == NULL) {
+                        /* Translators: %s is the number of the page, already formatted
+                         * as a string, for example "Page 5".
+                         */
                         markup = g_strdup_printf (_("Page %s"), label);
                 }
 
diff --git a/src/search.js b/src/search.js
index 17ba02f..a8e9e89 100644
--- a/src/search.js
+++ b/src/search.js
@@ -112,19 +112,19 @@ const SearchCategoryManager = new Lang.Class({
         this.parent(_("Category"), context);
 
         let category, recent;
-        // Translators: this refers to new and recent documents
         recent = new SearchCategory({ id: SearchCategoryStock.ALL,
+        // Translators: this refers to new and recent documents
                                       name: _("All"),
                                       icon: '' });
         this.addItem(recent);
 
-        // Translators: this refers to favorite documents
         category = new SearchCategory({ id: SearchCategoryStock.FAVORITES,
+        // Translators: this refers to favorite documents
                                         name: _("Favorites"),
                                         icon: 'emblem-favorite-symbolic' });
         this.addItem(category);
-        // Translators: this refers to shared documents
         category = new SearchCategory({ id: SearchCategoryStock.SHARED,
+        // Translators: this refers to shared documents
                                         name: _("Shared with you"),
                                         icon: 'emblem-shared-symbolic' });
         this.addItem(category);
@@ -405,14 +405,14 @@ const SourceManager = new Lang.Class({
     _init: function(context) {
         this.parent(_("Sources"), context);
 
-        // Translators: this refers to documents
         let source = new Source({ id: SourceStock.ALL,
+        // Translators: this refers to documents
                                   name: _("All"),
                                   builtin: true });
         this.addItem(source);
 
-        // Translators: this refers to local documents
         source = new Source({ id: SourceStock.LOCAL,
+        // Translators: this refers to local documents
                               name: _("Local"),
                               builtin: true });
         this.addItem(source);