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