Updating gnupg to version 2.2.0
[gpg4win.git] / doc / README.en.txt
index b0ab893..467d1cf 100644 (file)
@@ -27,18 +27,14 @@ The Gpg4win Compendium describes the installation and use of Gpg4win.
 After installation it is available in the Gpg4win start menu or online:
 http://www.gpg4win.org/doc/en/gpg4win-compendium.html
 
-If you used Gpg4win 1.x or another program in the past, please check
-out the migration hints in the Gpg4win Compendium's appendix.
-http://www.gpg4win.org/doc/en/gpg4win-compendium_36.html
-
-Please read the section "3. Known Bugs (and Workarounds)" before you
-start working with Gpg4win.
+Please read the section "3. Known Bugs (and Workarounds)" of this
+README before you start working with Gpg4win.
 
 Gpg4win supports these platforms:
 
-  * Operating System: Windows XP (32/64), Vista (32/64), 7 (32/64)
+  * Operating System: Windows XP and later Versions (for all: 32/64 bit)
 
-  * MS Outlook: 2003, 2007
+  * MS Outlook: 2003, 2007, 2010, 2013, 2016 (2010 and later also in 64bit)
 
 
 2. Changes
@@ -50,92 +46,136 @@ Included Gpg4win components in Version !VERSION! are:
 
 
 New in Gpg4win Version !VERSION! (!BUILD_ISODATE!)
--------------------------------------------------
+-----------------------------------------
+
+- GnuPG is now of the modern 2.1 variant. See:
+  https://www.gnupg.org/faq/whats-new-in-2.1.html
+  for more information about this.
+
+- GpgOL is now also supported for 64bit Outlook.
+
+- GpgOL for Outlook 2010 and later now uses toggle buttons
+  to let you select Encypt and Sign. The operations are done
+  when the mail is sent, including all attachments,
+  using a standard format (MIME).
+
+- GpgOL for Outlook 2010 and later now automatically decrypts mails
+  again.
+
+- All 68 KDE translations for Kleopatra are now included in Gpg4win.
+
+- Kleopatra uses an updated icon theme.
+
+- Kleopatra now shows the used curve in for ECC keys under technical
+  details.
+
+- Kleopatra has been updated to a new set of base libraries.
+
+- Binaries are now all installed in a bin subdirectory. DBus
+  and kbuildsycoa are no longer required. This fixes the startup issues
+  of Kleopatra some users were facing.
+
+- After importing a secret key in Kleopatra you will be asked to directly
+  mark it as your own key. (Ownertrust)
+
+- Kleopatra now allows you to create ECC keys in the Advanced Settings
+  during Key generation.
+
+- Kleopatras file menu now also offers to encrypt Folders.
+
+- Kleopatra has a new option to print a secret key through the paperkey tool.
+
+- GPA and Kleopatra are now registred for OpenPGP and S/MIME related file extensions.
+
+- The file encryption dialog in Kleopatra has been redesigned to reduce steps and
+  improve user experience.
+
+- Kleopatra automatically detects the type of an input file and automatically starts
+  the corresponding action (e.g. decrypt).
+
+- Symmetric (password only) encryption is now accessible through Kleopatra and can
+  be combined with public-key encryption.
+
+- Pinentry now enables you to inspect the typed passphrase.
+
+- Kleopatra now supports OpenPGP Smartcards management.
+
+- GpgOL for Outlook 2010 and later has a new interface to show
+  the signature / encryption state inside of Outlook.
+
+- GnuPG now supports https and uses the https sks-keyserver pool
+  by default.
+
+- GpgOL now supports sending and receiving HTML Mails
+
+- Kleopatra now supports to directly import missing certificates
+  when verifying a file.
+
+- Kleopatra has improved file verification messages.
+
+- Many bugfixes and minor improvements.
 
-- Kleopatra:
-  * Updated to Kleopatra 2.1.1 (from KDE 4.10.3).
-  * Fixed bugs in none latin environments.
-  * Several minor and medium improvements of stability.
 
-- Qt:
-  * Updated to 4.8.4 (from Qt 4.4.0) with a lot of
-    improvements in Kleopatra UI.
-  * Improved support for Windows7 and Windows8.
+3. Additional Notes
+===================
+- General
 
-- GnuPG-Backend:
-  * Updated to gnupg 2.0.20.
-  * Updated most included packages to recent versions (e.g. gpgme,
-    dirmngr, libassuan, libgcrypt, libgpg-error, libksba, pinentry,
-    libpng and much more - see 'packages.current' file in Gpg4win git
-    repository).
-  * Fixed a long standing bug in GPGME which led to spurious Kleopatra
-    hangs.
+  * For 3.0 we plan to offer a quick switch to a more automatic mode that
+    will set the gnupg options:
 
-- GPA:
-  * Updated to GPA 0.9.4.
+        auto-key-locate wkd
+        auto-key-retrieve
+        trust-model tofu+pgp
 
-- Installer:
-  * Migrated the installer to the i686-w64-mingw32 toolchain.
-  * Improved of the build system.
+    As this is not properly handled everywhere (especially Kleopatra's
+    file verification dialog) this is not yet default or easily accessible.
 
-- Claws-Mail:
-  * Updated Claws Mail to 3.9.1 - see http://www.claws-mail.org .
+    You can add it manually to your gpg.conf. The trust-model is fully
+    supported by GpgOL.
 
+- Kleopatra
 
-3. Known Bugs (and Workarounds)
-===============================
+  * Netkey cards are not yet supported by the new Manage Smartcard view.
 
-- Using smart card with Kleopatra
+- GpgOL
 
-   The initial setting of smart cards with Kleopatra is currently not
-   yet possible. Please run the following steps one-time to use your
-   smart card with Kleopatra.
+  * It is not possible to modify mails (e.g. moving / flagging the mail)
+    while they are shown decrypted.
+    To workaround this unselect the crypto mail and then make changes
+    through the right click context menu or move it with drag and drop.
 
-   * OpenPGP card
-     Use the gpg command line tool to create a new OpenPGP certificate
-     on your card (a) or to activate your existing certificate of
-     your card (b):
+  * Crypto mails forwarded as attachment are not properly handled.
 
-     (a) Create new certificate
-       - Insert card.
-       - Run "gpg --card-edit".
-       - Switch to admin modus by enter: "admin".
-       - Enter "generate" to create a new certificate.
+  * The certificate selection dialog sometimes opens in the background and
+    needs an overhaul.
 
-     (b) Activate existing certificate of your card
-       - Import associated (public) certificate of your card (e.g.
-         from certificate server or from a exported certificate file).
-       - Insert card.
-       - Run "gpg --card-status".
+  * Localization is incomplete
 
-   * X.509 Telesec Netkey 3 card
-     Use Kleopatra to initializing your card:
-     - Insert card.
-     - Click at the Kleopatra systemtray icon (or use the context menu of
-       the systemtray icon and run the learn card command).
 
-   After finishing these steps your OpenPGP / X.509 certificate
-   from your smart card is shown in Kleopatra under the tab
-   "My certificates" (marked with a smart card icon).
+- GpgOL for Outlook 2003 and 2007 (deprecated):
 
-- Using the Outlook Plugin "GpgOL":
+  Outlook 2003 and 2007 support is deprecated and may be removed in a
+  future version.
 
   * You defintely should create copies of your old encrypted/signed
-    emails, e.g. in the form of PST files.
+    emails before installing GpgOL, e.g. in the form of PST files.
 
-  * Sending signed or encrypted messages via an Exchange based account
+  * For Outlook 2003/2007 only:
+    Sending signed or encrypted messages via an Exchange based account
     does not yet work.
     [see https://bugs.g10code.com/gnupg/issue1102]
-    (Please note: Using SMTP with GpgOL and Exchange seems to be work.)
+    (Please note, using SMTP with GpgOL and Exchange seems to be work.
+    Or use GpgOL with Outlook 2010 or later.)
 
-  * Encrypted E-Mails occuring un-encrypted on the email server: It
+  * For Outlook 2003/2007 only:
+    Encrypted E-Mails occuring un-encrypted on the email server: It
     can happen that parts of encrypted emails are copied to your email
     server (IMAP or MAPI) in un-encrypted/decrypted form when creating
     or viewing them.  Affected is the content of the email view
     window, thus usually the so-called email body.  Attachments are
     not affected.  Switching off the Outlook preview will lower the
     probability of this to happen, but not eliminate the issue.
-    A solution is being worked on.
+    Or use GpgOL with Outlook 2010/2013.
 
 
 4. Installation
@@ -151,9 +191,9 @@ http://www.gpg4win.org/doc/en/gpg4win-compendium_35.html
 5. Version History
 ==================
 
-Find below the changes as recorded in the source distribution's NEWS
-file.  An up-to-date list of changes is also available at
-http://www.gpg4win.org/change-history.html .
+Listed below are the changes as recorded in the source distribution's
+NEWS file. An up-to-date list of changes is also available at:
+http://www.gpg4win.org/change-history.html
 
 !NEWSFILE!