update documentation for $pgp_getkeys_command to note that %r is replaced with the...

closes #1208

diff --git a/init.h b/init.h
index 75da9bf58ae6c658484be63b4c1eabece415c794..62c6b57ab6727f4610b9380e823d6f7b7582a7a2 100644 (file)
--- a/init.h
+++ b/init.h
@@ -1789,9 +1789,11 @@ struct option_t MuttVars[] = {
   { "pgp_getkeys_command",     DT_STR, R_NONE, UL &PgpGetkeysCommand, 0},
   /*
   ** .pp
-  ** This command is invoked whenever mutt will need public key information.
-  ** Of the sequences supported by $$pgp_decode_command, %r is the only
-  ** \fCprintf(3)\fP-like sequence used with this format.
+  ** This command is invoked whenever Mutt needs to fetch the public key associated with
+  ** an email address.  Of the sequences supported by $$pgp_decode_command, %r is
+  ** the only \fCprintf(3)\fP-like sequence used with this format.  Note that
+  ** in this case, %r expands to the email address, not the public key ID (the key ID is
+  ** unknown, which is why Mutt is invoking this command).
   ** (PGP only)
   */
   { "pgp_good_sign",   DT_RX,  R_NONE, UL &PgpGoodSign, 0 },