Commit ed943db7 authored by Lars Ingebrigtsen's avatar Lars Ingebrigtsen

Document the OpenPGP header

* doc/misc/message.texi (Using the OpenPGP Header): Document the
OpenPGP header (bug#39964).
parent b799cc27
Pipeline #6306 failed with stage
in 16 minutes and 43 seconds
......@@ -1042,6 +1042,7 @@ and/or encrypted messages as explained in the following.
* Signing and encryption:: Signing and encrypting commands.
* Using S/MIME:: Using S/MIME
* Using OpenPGP:: Using OpenPGP
* OpenPGP Header:: Adding OpenPGP headers to messages.
* Passphrase caching:: How to cache passphrases
* PGP Compatibility:: Compatibility with older implementations
* Encrypt-to-self:: Reading your own encrypted messages
......@@ -1251,6 +1252,28 @@ according to two different standards, namely @acronym{PGP} or
@code{mml-default-sign-method} determine which variant to prefer,
@acronym{PGP/MIME} by default.
@node OpenPGP Header
@subsection OpenPGP Header
The @samp{OpenPGP} header can be used to provide information about the
sender's OpenPGP key. This is a formalisation and modernisation of
the non-standard @samp{X-PGP-Key} (etc.) headers that have been in use
for a long time. For more details, see
@uref{https://tools.ietf.org/html/draft-josefsson-openpgp-mailnews-header}.
@vindex message-openpgp-header
To use this in Message, say:
@lisp
(add-hook 'message-send-hook 'messasge-add-openpgp-header)
@end lisp
Then customize the @code{message-openpgp-header} variable according to
your PGP setup. The variable is a list of the key ID, the key URL or
ASCII armoured, and the protection preference, one of
@samp{"unprotected"}, @samp{"sign"}, @samp{"encrypt"} or
@samp{"signencrypt"}.
@node Passphrase caching
@subsection Passphrase caching
......
......@@ -246,6 +246,7 @@ not.
** Message
+++
*** Message now supports the OpenPGP header.
To generate these headers, add the new function
'messasge-add-openpgp-header' to 'message-send-hook'. The header will
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment