/[gpgoe]/trunk/doc/gpgoe.texi
ViewVC logotype

Diff of /trunk/doc/gpgoe.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 6 by twoaday, Sun Mar 26 10:39:09 2006 UTC revision 20 by twoaday, Fri Feb 9 10:13:18 2007 UTC
# Line 5  Line 5 
5  This file describes the GPGOE functions and the integration  This file describes the GPGOE functions and the integration
6  in the Outlook Express mailer.  in the Outlook Express mailer.
7    
8    This file is free under the terms of the GNU General Public License v2.
9    
10    Copyright (C) 2006 Timo Schulz
11    
12    @settitle GPGOE - the GnuPG plug-in for Outlook Express
13    
14  @section Requirements for GPGOE  @section Requirements for GPGOE
15    
16  First you need to have a working GnuPG installtion on the machine you  First you need to have a working GnuPG installtion on the machine you
# Line 16  step manually. Line 22  step manually.
22  You need at least Windows 2000/XP and at least Outlook Express 6.0  You need at least Windows 2000/XP and at least Outlook Express 6.0
23  or higher. The plug-in will not work with earlier versions of Express.  or higher. The plug-in will not work with earlier versions of Express.
24    
25    @subsection Installation on Vista
26    
27    Because of the nature of the plugin, it contains a lot of tricks
28    for the Express integration, it cannot be guranteed, that it works
29    on Vista in general or the Outlook Express version that comes
30    with Vista. Feedback on the use with Vista is welcome but the
31    adjustment, if possible at all will take a lot of time.
32    
33  @section Installation of the Plug-in  @section Installation of the Plug-in
34    
# Line 43  can either use S/MIME or OpenPGP but nev Line 56  can either use S/MIME or OpenPGP but nev
56  If you want to use S/MIME again, just unload the plugin (quit  If you want to use S/MIME again, just unload the plugin (quit
57  gpgoeinit.exe).  gpgoeinit.exe).
58    
59    @strong{It is very important to close Outlook Express before you
60    unload the plug-in}
61    
62  @section How to use the plug-in  @section How to use the plug-in
63    
64  @subsection Encrypt a message  @subsection Encrypt a message
# Line 63  your passphrase for this key. If you ent Line 79  your passphrase for this key. If you ent
79  was correct, the plugin will sign the message and store it in  was correct, the plugin will sign the message and store it in
80  the outbox.  the outbox.
81    
82    @subsection Sign and Encrypt a message
83    To sign and encrypt a message, you have to check both toolbar
84    buttons ("Sign" and "Encrypt"). The procedure is the same as
85    in encrypt-only when one or more email addresses couldn't be
86    mapped. Then the default key is used to sign the plaintext
87    before it is encrypted with the selected recipients.
88    
89  @subsection Decrypt and/or verify a message  @subsection Decrypt and/or verify a message
90  If you received an OpenPGP message, you can just double-click  If you received an OpenPGP message, you can just double-click
91  the message to open it. The plug-in will figure out if it is  the message to open it. The plug-in will figure out if it is
# Line 75  jump to the next message or to go back t Line 98  jump to the next message or to go back t
98  will figure out the message status and will take the needed steps.  will figure out the message status and will take the needed steps.
99  If the message is neither signed nor encrypted, no action is performed.  If the message is neither signed nor encrypted, no action is performed.
100    
101    @subsection Reply to an encrypted message
102    Newer versions of the plug-in provide a feature to decrypt the
103    message before the text is used in the reply mail. As a result,
104    the reply message will contain the plain text instead of the encrypted
105    GPG armored message.
106    This feature is automatically used whenever the user clicks on "Reply"
107    or "Reply All" in the Outlook main window. But only in the case, the
108    mail is actually encrypted. Optionally the plug-in will ask for a
109    key passphrase.
110    
111  @section Additional information and limitations of the GPGOE plug-in  @section Additional information and limitations of the GPGOE plug-in
112    
113  @itemize @bullet  @itemize @bullet
114    
115  @item  @item
116    If you manually installed GPG and GPGoe, please make sure that
117    you installed GPG at a standard place or create at least the gpgBinary
118    registry entry. This is not needed if you use an automatic installer
119    like GPG4WIN.
120    
121    @item
122    Due to the fact the plug-in uses the clipboard for data transfer,
123    the clipboard itself can be only of limited use to copy/paste messages
124    into the mailer window or elsewhere. Newer versions of the plug-in
125    save the original clipboard text before encryption/signing and the
126    text is restored after the GPG operation ends.
127    
128    @item
129  The current version of the plug-in will NOT encrypt any attachments  The current version of the plug-in will NOT encrypt any attachments
130  which are attached to the message. You either need to encrypt them  which are attached to the message. You either need to encrypt them
131  before or send them in cleartext. For the file encryption it is  before or send them in cleartext. For the file encryption it is
# Line 91  decrypt the saved file. Line 137  decrypt the saved file.
137    
138  @item  @item
139  Even so the plug-in supports native line endings, which means you  Even so the plug-in supports native line endings, which means you
140  can properly exchange mails with Linux or MAC users, it is likely  can properly exchange mails with Linux or Apple users, it is likely
141  that there are problems with the charset.  that there are problems with the charset. Newer versions of the
142    plug-in try to handle UTF8 encoding correctly but even so it cannot
143    be 100% assured that the receiver can handle the text in all cases.
144    
145  @item  @item
146  If you want to import keys or attach keys to a mail, you have to  If you want to import keys or attach keys to a mail, you have to
147  use an external key manager. WinPT is recommend in this case. It  use an external key manager. WinPT is recommend in this case. It
148  contains features to send public keys to mail recipients and also  contains features to send public keys to mail recipients and also
149  to export keys via the clipboard so you can easily paste the key  to export keys via the clipboard so you can easily paste the key
150  into the text body of the message.  into the text body of the message. The current version of the
151    plug-in automatically uses WinPT for key import if the program
152    is available and running.
153    
154  @item  @item
155  Currently signing can be only done with the default signing key.  Currently signing can be only done with the default signing key.
Legend:
Removed from v.6  
changed lines
  Added in v.20
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26