Update NEWS and README's
[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 - GnuPG is now of the modern 2.1 variant. See:
52   https://www.gnupg.org/faq/whats-new-in-2.1.html
53   for more information about this.
54
55 - GpgOL is now also supported for 64bit Outlook.
56
57 - GpgOL for Outlook 2010 and later now uses toggle buttons
58   to let you select Encypt and Sign. The operations are done
59   when the mail is sent, including all attachments,
60   using a standard format (MIME).
61
62 - GpgOL for Outlook 2010 and later now automatically decrypts mails
63   again.
64
65 - All 68 KDE translations for Kleopatra are now included in Gpg4win.
66
67 - Kleopatra uses an updated icon theme.
68
69 - Kleopatra now shows the used curve in for ECC keys under technical
70   details.
71
72 - Kleopatra has been updated to a new set of base libraries.
73
74 - Binaries are now all installed in a bin subdirectory. DBus
75   and kbuildsycoa are no longer required. This fixes the startup issues
76   of Kleopatra some users were facing.
77
78 - After importing a secret key in Kleopatra you will be asked to directly
79   mark it as your own key. (Ownertrust)
80
81 - Kleopatra now allows you to create ECC keys in the Advanced Settings
82   during Key generation.
83
84 - Kleopatras file menu now also offers to encrypt Folders.
85
86 - Kleopatra has a new option to print a secret key through the paperkey tool.
87
88 - GPA and Kleopatra are now registred for OpenPGP and S/MIME related file extensions.
89
90 - The file encryption dialog in Kleopatra has been redesigned to reduce steps and
91   improve user experience.
92
93 - Kleopatra automatically detects the type of an input file and automatically starts
94   the corresponding action (e.g. decrypt).
95
96 - Symmetric (password only) encryption is now accessible through Kleopatra and can
97   be combined with public-key encryption.
98
99 - Pinentry now enables you to inspect the typed passphrase.
100
101 - Kleopatra now supports OpenPGP Smartcards management.
102
103 - GpgOL for Outlook 2010 and later has a new interface to show
104   the signature / encryption state inside of Outlook.
105
106 - GnuPG now supports https and uses the https sks-keyserver pool
107   by default.
108
109 - GpgOL now supports sending and receiving HTML Mails
110
111 - Kleopatra now supports to directly import missing certificates
112   when verifying a file.
113
114 - Kleopatra has improved file verification messages.
115
116 - Many bugfixes and minor improvements.
117
118
119 3. Additional Notes
120 ===================
121 - General
122
123   * For 3.0 we plan to offer a quick switch to a more automatic mode that
124     will set the gnupg options:
125
126         auto-key-locate wkd
127         auto-key-retrieve
128         trust-model tofu+pgp
129
130     As this is not properly handled everywhere (especially Kleopatra's
131     file verification dialog) this is not yet default or easily accessible.
132
133     You can add it manually to your gpg.conf. The trust-model is fully
134     supported by GpgOL.
135
136 - Kleopatra
137
138   * Netkey cards are not yet supported by the new Manage Smartcard view.
139
140 - GpgOL
141
142   * It is not possible to modify mails (e.g. moving / flagging the mail)
143     while they are shown decrypted.
144     To workaround this unselect the crypto mail and then make changes
145     through the right click context menu or move it with drag and drop.
146
147   * Crypto mails forwarded as attachment are not properly handled.
148
149   * The certificate selection dialog sometimes opens in the background and
150     needs an overhaul.
151
152   * Localization is incomplete
153
154
155 - GpgOL for Outlook 2003 and 2007 (deprecated):
156
157   Outlook 2003 and 2007 support is deprecated and may be removed in a
158   future version.
159
160   * You defintely should create copies of your old encrypted/signed
161     emails before installing GpgOL, e.g. in the form of PST files.
162
163   * For Outlook 2003/2007 only:
164     Sending signed or encrypted messages via an Exchange based account
165     does not yet work.
166     [see https://bugs.g10code.com/gnupg/issue1102]
167     (Please note, using SMTP with GpgOL and Exchange seems to be work.
168     Or use GpgOL with Outlook 2010 or later.)
169
170   * For Outlook 2003/2007 only:
171     Encrypted E-Mails occuring un-encrypted on the email server: It
172     can happen that parts of encrypted emails are copied to your email
173     server (IMAP or MAPI) in un-encrypted/decrypted form when creating
174     or viewing them.  Affected is the content of the email view
175     window, thus usually the so-called email body.  Attachments are
176     not affected.  Switching off the Outlook preview will lower the
177     probability of this to happen, but not eliminate the issue.
178     Or use GpgOL with Outlook 2010/2013.
179
180
181 4. Installation
182 ===============
183
184 For installation instructions please read the new Gpg4win Compendium:
185 http://www.gpg4win.org/doc/en/gpg4win-compendium_11.html
186
187 Hints for automated installations (without user dialogs):
188 http://www.gpg4win.org/doc/en/gpg4win-compendium_35.html
189
190
191 5. Version History
192 ==================
193
194 Listed below are the changes as recorded in the source distribution's
195 NEWS file. An up-to-date list of changes is also available at:
196 http://www.gpg4win.org/change-history.html
197
198 !NEWSFILE!
199
200
201 6. Version Numbers of Included Software
202 =======================================
203
204 !VERSIONINFO!
205
206
207 7. Legal notices pertaining to the individual packets
208 =====================================================
209
210 Gpg4win consist of several independent developed packages, available
211 under different license conditions.  Most of these packages however
212 are available under the GNU General Public License (GNU GPL).  Common
213 to all is that they are free to use without restrictions, may be
214 modified and that modifications may be distributed.  If the source
215 files (i.e. gpg4win-src-x.y.z.exe) are distributed along with the
216 binaries and the use of the GNU GPL has been pointed out, distribution
217 is in in all cases possible.
218
219 What follows is a list of copyright statements.
220
221 !PKG-COPYRIGHT!
222
223
224
225
226 Happy GiPiGing,
227
228   Your Gpg4win Team
229
230
231 ***end of file ***