From 5514f5cfd32fd787d7799c6c264dfde931e6e21d Mon Sep 17 00:00:00 2001
From: TAKAHASHI Tamotsu <ttakah@lapis.plala.or.jp>
Date: Sun, 18 Nov 2018 10:05:30 -0800
Subject: [PATCH] Add L10N comments to several unclear messages

Updating Japanese translation, I found that some of the updated messages
were a little hard to understand without reading the code.

Add comments to some messages I nearly translated in a wrong way.
---
 mutt_account.c       | 5 +++++
 ncrypt/crypt_gpgme.c | 3 +++
 ncrypt/pgp.c         | 6 ++++++
 recvcmd.c            | 3 +++
 4 files changed, 17 insertions(+)

diff --git a/mutt_account.c b/mutt_account.c
index 41d0a09bd..3302b5ed9 100644
--- a/mutt_account.c
+++ b/mutt_account.c
@@ -375,6 +375,11 @@ char *mutt_account_getoauthbearer(struct ConnAccount *account)
 
   if (!cmd)
   {
+    /* L10N: You will see this error message if (1) you have "oauthbearer" in
+       one of your $*_authenticators and (2) you do not have the corresponding
+       $*_oauth_refresh_command defined. So the message does not mean "None of
+       your $*_oauth_refresh_command's are defined."
+     */
     mutt_error(_("No OAUTH refresh command defined"));
     return NULL;
   }
diff --git a/ncrypt/crypt_gpgme.c b/ncrypt/crypt_gpgme.c
index dd825b83f..5f91fe121 100644
--- a/ncrypt/crypt_gpgme.c
+++ b/ncrypt/crypt_gpgme.c
@@ -1538,6 +1538,9 @@ static void print_smime_keyinfo(const char *msg, gpgme_signature_t sig,
     }
     else
     {
+      /* L10N: You will see this message in place of "KeyID "
+         if the S/MIME key has no ID. This is quite an error.
+       */
       state_puts(_("no signature fingerprint available"), s);
     }
     state_puts("\n", s);
diff --git a/ncrypt/pgp.c b/ncrypt/pgp.c
index 7cc6ac07f..4eb05ee7f 100644
--- a/ncrypt/pgp.c
+++ b/ncrypt/pgp.c
@@ -727,7 +727,13 @@ int pgp_class_application_handler(struct Body *m, struct State *s)
           if (could_not_decrypt || (decrypt_okay_rc <= -3))
             mutt_error(_("Could not decrypt PGP message"));
           else if (decrypt_okay_rc < 0)
+          {
+            /* L10N: You will see this error message if (1) you are decrypting
+               (not encrypting) something and (2) it is a plaintext. So the
+               message does not mean "You failed to encrypt the message."
+            */
             mutt_error(_("PGP message was not encrypted"));
+          }
           else
             mutt_message(_("PGP message successfully decrypted"));
         }
diff --git a/recvcmd.c b/recvcmd.c
index b5b503f11..a7d357d4e 100644
--- a/recvcmd.c
+++ b/recvcmd.c
@@ -1049,6 +1049,9 @@ void mutt_attach_mail_sender(FILE *fp, struct Email *e, struct AttachCtx *actx,
 {
   if (!check_all_msg(actx, cur, 0))
   {
+    /* L10N: You will see this error message if you invoke <compose-to-sender>
+       when you are on a normal attachment.
+     */
     mutt_error(_("You may only compose to sender with message/rfc822 parts"));
     return;
   }
-- 
2.40.0