* grub-core/net/http.c: Add TRANSLATORS comments.

* grub-core/normal/cmdline.c: Likewise.
	* grub-core/normal/misc.c: Likewise.
	* grub-core/partmap/msdos.c: Likewise.
	* grub-core/parttool/msdospart.c: Likewise.
	* grub-core/script/execute.c: Likewise.
	* grub-core/script/main.c: Likewise.
	* grub-core/term/terminfo.c: Likewise.
	* grub-core/video/bitmap.c: Likewise.
	* util/grub-install.in: Likewise.
	* util/grub-mkimage.c: Likewise.
	* util/grub-mklayout.c: Likewise.
	* util/grub-setup.c: Likewise.

grub-core/net/http.c

@@ -116,6 +116,8 @@ parse_line (grub_file_t file, http_data_t data, char *ptr, grub_size_t len)
 	  return GRUB_ERR_NONE;
 	default:
 	  data->err = GRUB_ERR_NET_UNKNOWN_ERROR;
+	  /* TRANSLATORS: GRUB HTTP code is pretty young. So even perfectly
+	     valid answers like 403 will trigger this very generic message.  */
 	  data->errmsg = grub_xasprintf (_("unsupported HTTP error %d: %s"),
 					 code, ptr);
 	  return GRUB_ERR_NONE;

grub-core/normal/cmdline.c

@@ -186,6 +186,9 @@ print_completion (const char *item, grub_completion_type_t type, int count)
 	  grub_puts_ (N_("Possible arguments are:"));
 	  break;
 	default:
+	  /* TRANSLATORS: this message is used if none of above matches.
+	     This shouldn't happen but please use the general term for
+	     "thing" or "object".  */
 	  grub_puts_ (N_("Possible things are:"));
 	  break;
 	}

grub-core/normal/misc.c

@@ -86,6 +86,8 @@ grub_normal_print_device_info (const char *name)
 		{
 		  grub_unixtime2datetime (tm, &datetime);
 		  grub_xputs (" ");
+		  /* TRANSLATORS: Arguments are year, month, day, hour, minute,
+		     second, day of the week (translated).  */
 		  grub_printf_ (N_("- Last modification time %d-%02d-%02d "
 			       "%02d:%02d:%02d %s"),
 			       datetime.year, datetime.month, datetime.day,

grub-core/partmap/msdos.c

@@ -42,6 +42,9 @@ struct embed_signature
 };
 
 const char message_warn[][200] = {
+  /* TRANSLATORS: MBR gap and boot track is the same thing and is the space
+     between MBR and first partitition. If your language translates well only
+     "boot track", you can just use it everywhere.  */
   [TYPE_RAID] = N_("Sector %llu is already in use by raid controller `%s';"
 		   " avoiding it.  "
 		   "Please ask the manufacturer not to store data in MBR gap"),

grub-core/parttool/msdospart.c

@@ -132,6 +132,8 @@ static grub_err_t grub_pcpart_type (const grub_device_t dev,
     }
 
   mbr.entries[index].type = type;
+  /* TRANSLATORS: In this case we're actually writing to the disk and actively
+     modifying partition type rather than just defining it.  */
   grub_printf_ (N_("Setting partition type to 0x%x\n"), type);
 
    /* Write the parttable.  */

grub-core/script/execute.c

@@ -87,6 +87,8 @@ grub_script_break (grub_command_t cmd, int argc, char *argv[])
       if (*p != '\0')
 	return grub_error (GRUB_ERR_BAD_ARGUMENT, N_("unrecognized number"));
       if (count == 0)
+	/* TRANSLATORS: 0 is a quantifier. Break can be used e.g. to break
+	   3 loops at once. But asking it to break 0 loops makes no sense. */
 	return grub_error (GRUB_ERR_BAD_ARGUMENT, N_("can't break 0 loops"));
     }
 

grub-core/script/main.c

@@ -56,6 +56,8 @@ grub_script_init (void)
 					N_("[NUM]"), N_("Continue loops"));
   cmd_shift = grub_register_command ("shift", grub_script_shift,
 				     N_("[NUM]"),
+				     /* TRANSLATORS: Positional arguments are
+					arguments $0, $1, $2, ...  */
 				     N_("Shift positional parameters."));
   cmd_setparams = grub_register_command ("setparams", grub_script_setparams,
 					 N_("[VALUE]..."),

grub-core/term/terminfo.c

@@ -600,6 +600,10 @@ print_terminfo (void)
     [GRUB_TERM_CODE_TYPE_UTF8_LOGICAL >> GRUB_TERM_CODE_TYPE_SHIFT]
     = _("UTF-8"),
     [GRUB_TERM_CODE_TYPE_UTF8_VISUAL >> GRUB_TERM_CODE_TYPE_SHIFT]
+    /* TRANSLATORS: visually ordered UTF-8 is a non-compliant encoding
+       based on UTF-8 with right-to-left languages written in reverse.
+       Used on some terminals. Normal UTF-8 is refered as
+       "logically-ordered UTF-8" by opposition.  */
     = _("visually-ordered UTF-8"),
     [GRUB_TERM_CODE_TYPE_VISUAL_GLYPHS >> GRUB_TERM_CODE_TYPE_SHIFT]
     = "Glyph descriptors",

grub-core/video/bitmap.c

@@ -204,6 +204,8 @@ grub_video_bitmap_load (struct grub_video_bitmap **bitmap,
     }
 
   return grub_error (GRUB_ERR_BAD_FILE_TYPE,
+		     /* TRANSLATORS: We're speaking about bitmap images like
+			JPEG or PNG.  */
 		     N_("bitmap file `%s' is of"
 			" unsupported format"), filename);
 }