Added new sponsor.
[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 If you used Gpg4win 1.x or another program in the past, please check
31 out the migration hints in the Gpg4win Compendium's appendix.
32 http://www.gpg4win.org/doc/en/gpg4win-compendium_36.html
33
34 Please read the section "3. Known Bugs (and Workarounds)" before you
35 start working with Gpg4win.
36
37 Gpg4win supports these platforms:
38  * Operating System: Windows 2000, XP (32/64), Vista (32/64), 7 (32/64)
39  * MS Outlook: 2003, 2007
40  Note: Currently, there is no 64-bit support for GpgEX 
41  (see section 3, "Using GpgEX with Windows x64", for details)
42
43
44 2. Changes
45 ==========
46
47 Changes compared to version 2.0.4:
48
49 [The following issue numbers reference to https://issues.kolab.org/.]
50
51 - Kleopatra:
52   * Conflict dialog 
53     - Certificate selection dialog now works context-sensitive
54       (dependent on selecting sign, encrypt or sign/encrypt)
55       [kolab/issue4492]
56     - Conflicts redefined and implemented, fixed errors
57       [kolab/issue4197,4234]
58     - New configuration option for "quick mode" (Power-User-Mode) to
59       sign and encrypt
60       [kolab/issue4136])
61     - No protocol (OpenPGP or S/MIME) pre-selection dialog required -
62       replaced by new certificate selection dialog.
63       [kolab/issue4213,4235]
64   * (recursive) sign/encrypt of files and folders possible (see
65     GnuPG-Backend)
66   * Create/verify checksum by sha1sum, sha256sum, md5sum possible
67     (see GnuPG-Backend)
68   * Certificate lookup on certificate server
69     - Search for fingerprint or key-id shows new information dialog 
70       (some server requires 0x-Präfix in search string)
71       [kolab/issue4453]
72   * Certify OpenPGP certificates
73     - Fingerprint and key-id in step 1 added
74       [kolab/issue4468,4458]
75     - Key-id in step 2 added
76       [kolab/issue4460]
77   * Several minor and medium (GUI) improvements:
78     - Export of secret X.509 certificats use new default (utf8) for
79       passphrase charset
80       [kolab/issue4454]
81     - Import certificate without file type improved (content checker)
82       [kolab/issue4457]
83     - Fix certificate list in delete confirm dialog
84       [kolab/issue4459] 
85     - New context menu entry for deleting certificate added
86       [kolab/issue4450]
87     - OwnerTrust added to tooltips and certificate details
88       [kolab/issue4198]
89     - Unit (Bits) to the key strength fields in NewCertificateWizard's
90       overview page added
91       [kolab/issue4183]
92     - E-Mail-Validator allows to delete '@' Zeichen
93       [kolab/issue4189]
94     - Trust/distrust root certificates via context menu
95       (write directly $GNUPGHOME\trustlist.txt)
96       [kolab/issue4190]
97     - For developer: KDebugDialog available (installed with Kleopatra,
98       run $INSTDIR\kdebugdialog.exe)
99       [kolab/issue4318]
100     - Hierarchical certificate list: toggling (regression)
101       [kolab/issue4327]
102     - Fixed exception for decrypt/verify special S/MIME e-mail
103       [kolab/issue4179]
104   * SmartCard 
105     - Detecting smartcard: Kleopatra's systemtray icon blinks after
106       inserting X.509 card. Click starts learn card command or opens
107       nullpin dialog.
108       [kolab/issue4191]
109     - Learn card commands suppress gpgsm error dialogs.
110       [kolab/issue4126]
111   * Miscellaneous
112     - Gpg4win credits added (see 'About Gpg4win' dialog)
113     - German translations fixed
114     - Several minor and medium issues and errors were fixed
115
116 - GpgOL:
117   * Portuguese translation added
118   * updated to new libassuan2 interface and libgpg-error 1.9
119
120 - GpgEX
121   * (recursive) sign/encrypt of files and folders possible (see
122     GnuPG-Backend)
123   * Create/verify checksum by sha1sum, sha256sum, md5sum possible
124     (see GnuPG-Backend)
125   * Portuguese translation added
126   * Updated to libgpg-error 1.9
127
128 - Pinentry:
129   * Change default: switch to QT4
130     (GTK still enabled for gpg4win-light installer)
131     [kolab/issue4378]
132   * Fixed German translation for 'Cancel' cancel
133     [kolab/issue4132]
134
135 - GnuPG-Backend:
136   * NEW: (recursive) sign/encrypt of files and folders possible
137     [kolab/issue4298,4299,4300] 
138   * NEW: Create/verify checksum by sha1sum, sha256sum, md5sum
139     possible via GpgEX
140     [kolab/issue41634,294,4295,4296,4297,4321]
141   * Updated to new libassuan v2 interface
142   * Several minor and medium improvements of stability
143     [u.a.: kolab/issue4212] 
144
145 - Installer:
146   * NEW: English language version of the Gpg4win Compendium
147     (v3.0.0-beta1) added. Old novices manual removed.
148   * Installer was signed with a CodeSigning certificate of GlobalSign
149     (Publisher: "Intevation GmbH")
150   * Portuguese translation added
151
152 - Included Gpg4win components are:
153     GnuPG:          2.0.16
154     Kleopatra:      2.1.0-svn1167864 (2010-08-11)
155     GPA:            0.9.0
156     GpgOL:          1.1.2
157     GpgEX:          0.9.7
158     Claws-Mail:     3.7.6
159     Kompendium DE:  3.0.0
160     Kompendium EN:  3.0.0-beta1
161
162
163 3. Known Bugs (and Workarounds)
164 ===============================
165
166 - Using smart card with Kleopatra
167
168    The initial setting of smart cards with Kleopatra is currently not
169    yet possible. Please run the following steps one-time to use your
170    smart card with Kleopatra.
171
172    * OpenPGP card
173      Use the gpg command line tool to create a new OpenPGP certificate
174      on your card (a) or to activate your existing certificate of
175      your card (b):
176
177      (a) Create new certificate
178        - Insert card.
179        - Run "gpg --card-edit".
180        - Switch to admin modus by enter: "admin".
181        - Enter "generate" to create a new certificate.
182
183      (b) Activate existing certificate of your card
184        - Import associated (public) certificate of your card (e.g.
185          from certificate server or from a exported certificate file).
186        - Insert card.
187        - Run "gpg --card-status".
188
189    * X.509 Telesec Netkey 3 card
190      Use Kleopatra to initializing your card:
191      - Insert card.
192      - Click at the Kleopatra systemtray icon (or use the context menu of
193        the systemtray icon and run the learn card command).
194
195    After finishing these steps your OpenPGP / X.509 certificate
196    from your smart card is shown in Kleopatra under the tab
197    "My certificates" (marked with a smart card icon).
198
199    A better smart card support for Kleopatra is in process.
200
201 - Using the Outlook Plugin "GpgOL":
202
203   * You defintely should create copies of your old encrypted/signed
204     emails, e.g. in the form of PST files.
205
206   * Sending signed or encrypted messages via an Exchange based account
207     does not yet work.
208     [see https://bugs.g10code.com/gnupg/issue1102]
209
210   * Outlook2007 crashes after opening attachments of an encrypted message
211     [see https://bugs.g10code.com/gnupg/issue1110]
212
213   * Encrypted E-Mails occuring un-encrypted on the email server: It
214     can happen that parts of encrypted emails are copied to your email
215     server (IMAP or MAPI) in un-encrypted/decrypted form when creating
216     or viewing them.  Affected is the content of the email view
217     window, thus usually the so-called email body.  Attachments are
218     not affected.  Switching off the Outlook preview will lower the
219     probability of this to happen, but not eliminate the issue.
220     A solution is being worked on.
221
222 - Using GpgEX with Windows x64:
223
224    * In some cases sign/encrypt or decrypt/verify via GpgEX doesn't work 
225      correctly (Kleopatra freezed). Then you should kill Kleopatra via 
226      task manager and run the file crypto operation directly in Kleopatra
227      (see file menu).
228
229    * Problems with Windows x64:
230      GpgEX is a (32bit) plugin for the (32bit) Windows
231      Explorer and it does _not_ run in a 64bit Explorer
232      (= default for a Windows 64bit system).
233
234      Workaround: Run the 32bit Explorer to use GpgEX.
235      Click "Start" -> "Run", type the following in the box, and then
236      click OK:
237          C:\windows\syswow64\explorer.exe /separate
238      Note: Adjust the path to your x64-based version of Windows if
239      necessary. 
240      This separate command seems to be currently broken in Win7/64bit.
241      Alternatively you can use the file crypto operations of GpgEX
242      directly via the file menu of Kleopatra.
243
244
245 4. Installation
246 ===============
247
248 For installation instructions please read the new Gpg4win Compendium:
249 http://www.gpg4win.org/doc/en/gpg4win-compendium_11.html
250
251 Hints for automated installations (without user dialogs):
252 http://www.gpg4win.org/doc/en/gpg4win-compendium_35.html
253
254
255 5. Version History
256 ==================
257
258 Find below the changes as recorded in the source distribution's NEWS
259 file.  An up-to-date list of changes is also available at
260 http://www.gpg4win.org/change-history.html .
261
262 !NEWSFILE!
263
264
265 6. Version Numbers of Included Software
266 =======================================
267
268 !VERSIONINFO!
269
270
271 7. Legal notices pertaining to the individual packets
272 =====================================================
273
274 Gpg4win consist of several independent developed packages, available
275 under different license conditions.  Most of these packages however
276 are available under the GNU General Public License (GNU GPL).  Common
277 to all is that they are free to use without restrictions, may be
278 modified and that modifications may be distributed.  If the source
279 files (i.e. gpg4win-src-x.y.z.exe) are distributed along with the
280 binaries and the use of the GNU GPL has been pointed out, distribution
281 is in in all cases possible.
282
283 What follows is a list of copyright statements.
284
285 !PKG-COPYRIGHT!
286
287
288
289
290 Happy GiPiGing,
291
292   Your Gpg4win Team
293
294 ***end of file ***