From: Kevin McCarthy <kevin@8t8.us>
Date: Fri, 26 Jul 2019 23:27:04 +0000 (-0700)
Subject: Add L10N translation message comments
X-Git-Tag: 2019-10-25~97^2~32
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5a8bf555afa887bcd4e012bad90d27639c3678d5;p=neomutt

Add L10N translation message comments

Co-authored-by: Richard Russon <rich@flatcap.org>
---

diff --git a/autocrypt/autocrypt.c b/autocrypt/autocrypt.c
index 0216bdea2..42cf5d457 100644
--- a/autocrypt/autocrypt.c
+++ b/autocrypt/autocrypt.c
@@ -51,11 +51,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?"), C_AutocryptDir);
   if (mutt_yesorno(mutt_b2s(prompt), MUTT_YES) == MUTT_YES)
   {
     if (mutt_file_mkdir(C_AutocryptDir, S_IRWXU) < 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."), C_AutocryptDir, strerror(errno));
       rv = -1;
     }
@@ -122,6 +131,11 @@ 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(&al, _("Autocrypt account address: "), 0) != 0)
       goto cleanup;
 
@@ -130,7 +144,8 @@ int mutt_autocrypt_account_init(void)
     {
       /* 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"));
       done = false;
diff --git a/autocrypt/autocrypt_db.c b/autocrypt/autocrypt_db.c
index 2e628ef0d..5fd728164 100644
--- a/autocrypt/autocrypt_db.c
+++ b/autocrypt/autocrypt_db.c
@@ -44,6 +44,10 @@ static int autocrypt_db_create(const char *db_path)
   if (sqlite3_open_v2(db_path, &AutocryptDB,
                       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);
     return -1;
   }
diff --git a/autocrypt/autocrypt_gpgme.c b/autocrypt/autocrypt_gpgme.c
index f8c33be3a..32ad6b191 100644
--- a/autocrypt/autocrypt_gpgme.c
+++ b/autocrypt/autocrypt_gpgme.c
@@ -135,6 +135,10 @@ int mutt_autocrypt_gpgme_create_key(struct Address *addr, struct Buffer *keyid,
                            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));
     goto cleanup;
   }
diff --git a/compose.c b/compose.c
index 79caa1056..10b60fb83 100644
--- a/compose.c
+++ b/compose.c
@@ -330,7 +330,7 @@ static void autocrypt_compose_menu(struct Email *e)
      The letter corresponding to the compose menu autocrypt prompt
      (e)ncrypt, (c)lear, (a)utomatic
    */
-  const char *letters = "eca";
+  const char *letters = _("eca");
 
   int choice = mutt_multi_choice(prompt, letters);
   switch (choice)