Add 64bit version of GpgOL
[gpg4win.git] / doc / README.en.txt
1 ;; README.en.txt                               -*- coding: latin-1; -*-
2 ;; This is the README installed with Gpg4win. Lines with a ; in the first
3 ;; column are considered a comment and not included in the actually
4 ;; installed version.  Certain keywords are replaced by the Makefile;
5 ;; those words are enclosed by exclamation marks.
6
7                    English README file for Gpg4win
8                    ===============================
9 !BETA-WARNING!
10 This is Gpg4win, version !VERSION! (!BUILD_ISODATE!).
11
12 Content:
13
14      1. Important Notes
15      2. Changes
16      3. Known Bugs (and Workarounds)
17      4. Installation
18      5. Version History
19      6. Version Numbers of Included Software
20      7. Legal Notices
21
22
23 1. Important Notes
24 ==================
25
26 The Gpg4win Compendium describes the installation and use of Gpg4win.
27 After installation it is available in the Gpg4win start menu or online:
28 http://www.gpg4win.org/doc/en/gpg4win-compendium.html
29
30 Please read the section "3. Known Bugs (and Workarounds)" of this
31 README before you start working with Gpg4win.
32
33 Gpg4win supports these platforms:
34
35   * Operating System: Windows XP and later Versions (for all: 32/64 bit)
36
37   * MS Outlook: 2003, 2007, 2010, 2013, 2016 (2010 and later also in 64bit)
38
39
40 2. Changes
41 ==========
42
43 Included Gpg4win components in Version !VERSION! are:
44
45 !COMPONENTS!
46
47
48 New in Gpg4win Version !VERSION! (!BUILD_ISODATE!)
49 -----------------------------------------
50
51 - GpgOL now supports reading PGP/MIME and S/MIME mails, the standard
52   format for Crypto Mails as sent by Thunderbird/Enigmail, GPGMail
53   or KMail. For details see: https://wiki.gnupg.org/GpgOL/MIMESupport
54
55 - GpgOL now supports Outlook 2016.
56
57 - AES-NI Instructions for faster encryption and decryption with AES
58   are now supported. (GnuPG Bug #1919)
59
60 - The decrypt/verify window of GpgOL no longer moves and resizes
61   erratically. (KDE Bug #355140)
62
63 - Bulk import of more then a hundred keys no longer fails when Kleopatra
64   is running. (GnuPG Bug #2135)
65
66 - French and Chinese localisation has been added to the installer,
67   GpgEX and GpgOL. Thanks to Oliver Serve and Mingye Wang.
68
69 - Several apparently random crashes in GpgOL have been fixed
70   (GnuPG Bug #1837)
71
72 - GpgOL now handles attachments in  PGP/MIME and S/MIME mails with non ASCII
73   characters in the filename correctly.
74
75 - A vulnerability in the Gpg4win-installer has been fixed. See:
76   [security advisory 2015-11-25] for details.
77
78
79 3. Known Bugs (and Workarounds)
80 ===============================
81
82 - Using smart cards with Kleopatra:
83
84    * OpenPGP card
85      The initial setting of a smart card with Kleopatra is not yet
86      possible. Please run the following steps once to use your smart
87      card with Kleopatra.
88      Use the gpg command line tool to create a new OpenPGP certificate
89      on your card (a) or to activate your existing certificate of
90      your card (b):
91
92      (a) Create new certificate
93        - Insert card.
94        - Run "gpg --card-edit".
95        - Switch to admin modus by enter: "admin".
96        - Enter "generate" to create a new certificate.
97
98      (b) Activate existing certificate of your card
99        - Import associated (public) certificate of your card (e.g.
100          from certificate server or from a exported certificate file).
101        - Insert card.
102        - Run "gpg --card-status".
103
104    * X.509 Telesec Netkey 3 card
105      Use Kleopatra to initialize your card:
106      - Insert card.
107      - Click on the flashing Kleopatra system tray icon (or use the 
108        context menu "smart card" of the system tray icon and run the 
109        "learn card" command directly).
110
111    After finishing these steps your OpenPGP / X.509 certificate from your
112    smart card is shown in Kleopatra under the tab "My certificates" 
113    (marked with a smart card icon).
114
115 - Using the Outlook Plugin "GpgOL":
116
117   * You defintely should create copies of your old encrypted/signed
118     emails before installing GpgOL, e.g. in the form of PST files.
119
120   * For Outlook 2003/2007 only:
121     Sending signed or encrypted messages via an Exchange based account
122     does not yet work.
123     [see https://bugs.g10code.com/gnupg/issue1102]
124     (Please note, using SMTP with GpgOL and Exchange seems to be work.
125     Or use GpgOL with Outlook 2010/2013.)
126
127   * For Outlook 2003/2007 only:
128     Encrypted E-Mails occuring un-encrypted on the email server: It
129     can happen that parts of encrypted emails are copied to your email
130     server (IMAP or MAPI) in un-encrypted/decrypted form when creating
131     or viewing them.  Affected is the content of the email view
132     window, thus usually the so-called email body.  Attachments are
133     not affected.  Switching off the Outlook preview will lower the
134     probability of this to happen, but not eliminate the issue.
135     Or use GpgOL with Outlook 2010/2013.
136
137
138 4. Installation
139 ===============
140
141 For installation instructions please read the new Gpg4win Compendium:
142 http://www.gpg4win.org/doc/en/gpg4win-compendium_11.html
143
144 Hints for automated installations (without user dialogs):
145 http://www.gpg4win.org/doc/en/gpg4win-compendium_35.html
146
147
148 5. Version History
149 ==================
150
151 Listed below are the changes as recorded in the source distribution's
152 NEWS file. An up-to-date list of changes is also available at:
153 http://www.gpg4win.org/change-history.html
154
155 !NEWSFILE!
156
157
158 6. Version Numbers of Included Software
159 =======================================
160
161 !VERSIONINFO!
162
163
164 7. Legal notices pertaining to the individual packets
165 =====================================================
166
167 Gpg4win consist of several independent developed packages, available
168 under different license conditions.  Most of these packages however
169 are available under the GNU General Public License (GNU GPL).  Common
170 to all is that they are free to use without restrictions, may be
171 modified and that modifications may be distributed.  If the source
172 files (i.e. gpg4win-src-x.y.z.exe) are distributed along with the
173 binaries and the use of the GNU GPL has been pointed out, distribution
174 is in in all cases possible.
175
176 What follows is a list of copyright statements.
177
178 !PKG-COPYRIGHT!
179
180
181
182
183 Happy GiPiGing,
184
185   Your Gpg4win Team
186
187
188 ***end of file ***