From: Kevin McCarthy <kevin@8t8.us>
Date: Fri, 26 Jul 2019 23:27:04 +0000 (-0700)
Subject: Add L10N translation message comments.
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0d94a3dc611064dd87a3488f9db60c8d580075e4;p=mutt

Add L10N translation message comments.
---

diff --git a/autocrypt/autocrypt.c b/autocrypt/autocrypt.c
index ed3c1024..e19a7adc 100644
--- a/autocrypt/autocrypt.c
+++ b/autocrypt/autocrypt.c
@@ -46,11 +46,20 @@ static int autocrypt_dir_init (int can_create)
     return -1;
 
   prompt = mutt_buffer_pool_get ();
+  /* L10N:
+     %s is a directory.  Mutt is looking for a directory it needs
+     for some reason (e.g. autocrypt, header cache, bcache), but it
+     doesn't exist.  The prompt is asking whether to create the directory
+  */
   mutt_buffer_printf (prompt, _("%s does not exist. Create it?"), AutocryptDir);
   if (mutt_yesorno (mutt_b2s (prompt), MUTT_YES) == MUTT_YES)
   {
     if (mutt_mkdir (AutocryptDir, 0700) < 0)
     {
+      /* L10N:
+         mkdir() on the directory %s failed.  The second %s is the
+         error message returned by libc
+      */
       mutt_error ( _("Can't create %s: %s."), AutocryptDir, strerror (errno));
       mutt_sleep (0);
       rv = -1;
@@ -116,13 +125,19 @@ int mutt_autocrypt_account_init (void)
 
   do
   {
+    /* L10N:
+       Autocrypt is asking for the email address to use for the
+       autocrypt account.  This will generate a key and add a record
+       to the database for use in autocrypt operations.
+    */
     if (mutt_edit_address (&addr, _("Autocrypt account address: "), 0))
       goto cleanup;
     if (!addr || !addr->mailbox || addr->next)
     {
       /* L10N:
          Autocrypt prompts for an account email address, and requires
-         a single address.
+         a single address.  This is shown if they entered something invalid,
+         nothing, or more than one address for some reason.
       */
       mutt_error (_("Please enter a single email address"));
       mutt_sleep (2);
diff --git a/autocrypt/autocrypt_db.c b/autocrypt/autocrypt_db.c
index fa463fbe..d8a397bd 100644
--- a/autocrypt/autocrypt_db.c
+++ b/autocrypt/autocrypt_db.c
@@ -41,6 +41,10 @@ static int autocrypt_db_create (const char *db_path)
                        SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE,
                        NULL) != SQLITE_OK)
   {
+    /* L10N:
+       %s is the path to the database.  For some reason sqlite3 failed
+       to open that database file.
+    */
     mutt_error (_("Unable to open autocrypt database %s"), db_path);
     mutt_sleep (0);
     return -1;
diff --git a/autocrypt/autocrypt_gpgme.c b/autocrypt/autocrypt_gpgme.c
index 84bb9ffc..a95339e9 100644
--- a/autocrypt/autocrypt_gpgme.c
+++ b/autocrypt/autocrypt_gpgme.c
@@ -137,6 +137,10 @@ int mutt_autocrypt_gpgme_create_key (ADDRESS *addr, BUFFER *keyid, BUFFER *keyda
                             GPGME_CREATE_NOPASSWD | GPGME_CREATE_FORCE | GPGME_CREATE_NOEXPIRE);
   if (err)
   {
+    /* L10N:
+       GPGME was unable to generate a key for some reason.
+       %s is the error message returned by GPGME.
+    */
     mutt_error (_("Error creating autocrypt key: %s\n"), gpgme_strerror (err));
     sleep (2);
     goto cleanup;
diff --git a/compose.c b/compose.c
index 6c3a3b39..05ae4c19 100644
--- a/compose.c
+++ b/compose.c
@@ -251,7 +251,7 @@ static void autocrypt_compose_menu (HEADER *msg)
      The letter corresponding to the compose menu autocrypt prompt
      (e)ncrypt, (c)lear, (a)utomatic
    */
-  letters = "eca";
+  letters = _("eca");
 
   choice = mutt_multi_choice (prompt, letters);
   switch (choice)