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