--- trunk/doc/gpgoe.texi 2006/03/27 10:06:54 8 +++ trunk/doc/gpgoe.texi 2006/04/11 19:05:05 17 @@ -5,6 +5,12 @@ This file describes the GPGOE functions and the integration in the Outlook Express mailer. +This file is free under the terms of the GNU General Public License v2. + +Copyright (C) 2006 Timo Schulz + +@settitle GPGOE - the GnuPG plug-in for Outlook Express + @section Requirements for GPGOE First you need to have a working GnuPG installtion on the machine you @@ -43,6 +49,9 @@ If you want to use S/MIME again, just unload the plugin (quit gpgoeinit.exe). +@strong{It is very important to close Outlook Express before you +unload the plug-in} + @section How to use the plug-in @subsection Encrypt a message @@ -63,6 +72,13 @@ was correct, the plugin will sign the message and store it in the outbox. +@subsection Sign and Encrypt a message +To sign and encrypt a message, you have to check both toolbar +buttons ("Sign" and "Encrypt"). The procedure is the same as +in encrypt-only when one or more email addresses couldn't be +mapped. Then the default key is used to sign the plaintext +before it is encrypted with the selected recipients. + @subsection Decrypt and/or verify a message If you received an OpenPGP message, you can just double-click the message to open it. The plug-in will figure out if it is @@ -75,14 +91,32 @@ will figure out the message status and will take the needed steps. If the message is neither signed nor encrypted, no action is performed. +@subsection Reply to an encrypted message +Newer versions of the plug-in provide a feature to decrypt the +message before the text is used in the reply mail. As a result, +the reply message will contain the plain text instead of the encrypted +GPG armored message. +This feature is automatically used whenever the user clicks on "Reply" +or "Reply All" in the Outlook main window. But only in the case, the +mail is actually encrypted. Optionally the plug-in will ask for a +key passphrase. + @section Additional information and limitations of the GPGOE plug-in @itemize @bullet @item +If you manually installed GPG and GPGoe, please make sure that +you installed GPG at a standard place or create at least the gpgBinary +registry entry. This is not needed if you use an automatic installer +like GPG4WIN or GnuPT. + +@item Due to the fact the plug-in uses the clipboard for data transfer, the clipboard itself can be only of limited use to copy/paste messages -into the mailer window or elsewhere. +into the mailer window or elsewhere. Newer versions of the plug-in +save the original clipboard text before encryption/signing and the +ext is restored after the GPG operation ends. @item The current version of the plug-in will NOT encrypt any attachments @@ -96,15 +130,19 @@ @item Even so the plug-in supports native line endings, which means you -can properly exchange mails with Linux or MAC users, it is likely -that there are problems with the charset. +can properly exchange mails with Linux or Apple users, it is likely +that there are problems with the charset. Newer versions of the +plug-in try to handle UTF8 encoding correctly but even so it cannot +be 100% assured that the receiver can handle the text in all cases. @item If you want to import keys or attach keys to a mail, you have to use an external key manager. WinPT is recommend in this case. It contains features to send public keys to mail recipients and also to export keys via the clipboard so you can easily paste the key -into the text body of the message. +into the text body of the message. The current version of the +plug-in automatically uses WinPT for key import if the program +is available and running. @item Currently signing can be only done with the default signing key.