27dada799c9c4887a8ce8df91c6eeb572075ac06
[gnupg.git] / announce.txt
1 To: gnupg-announce@gnupg.org, info-gnu@gnu.org
2 Mail-Followup-To: gnupg-users@gnupg.org
3
4
5 Hello!
6
7 We are pleased to announce the availability of a new stable GnuPG-2
8 release:  Version 2.0.21.
9
10 The GNU Privacy Guard (GnuPG) is GNU's tool for secure communication
11 and data storage.  It can be used to encrypt data, create digital
12 signatures, help authenticating using Secure Shell and to provide a
13 framework for public key cryptography.  It includes an advanced key
14 management facility and is compliant with the OpenPGP and S/MIME
15 standards.
16
17 GnuPG-2 has a different architecture than GnuPG-1 (e.g. 1.4.14) in
18 that it splits up functionality into several modules.  However, both
19 versions may be installed alongside without any conflict.  In fact,
20 the gpg version from GnuPG-1 is able to make use of the gpg-agent as
21 included in GnuPG-2 and allows for seamless passphrase caching.  The
22 advantage of GnuPG-1 is its smaller size and the lack of dependency on
23 other modules at run and build time.  We will keep maintaining GnuPG-1
24 versions because they are very useful for small systems and for server
25 based applications requiring only OpenPGP support.
26
27 GnuPG is distributed under the terms of the GNU General Public License
28 (GPLv3+).  GnuPG-2 works best on GNU/Linux and *BSD systems but is
29 also available for other Unices, Microsoft Windows and Mac OS X.
30
31
32 What's New in 2.0.21
33 ====================
34
35  * gpg-agent: By default the users are now asked via the Pinentry
36    whether they trust an X.509 root key.  To prohibit interactive
37    marking of such keys, the new option --no-allow-mark-trusted may
38    be used.
39
40  * gpg-agent: The command KEYINFO has options to add info from
41    sshcontrol.
42
43  * The included ssh agent does now support ECDSA keys.
44
45  * The new option --enable-putty-support allows gpg-agent to act on
46    Windows as a Pageant replacement with full smartcard support.
47
48  * Support installation as portable application under Windows.
49
50
51 Getting the Software
52 ====================
53
54 Please follow the instructions found at http://www.gnupg.org/download/
55 or read on:
56
57 GnuPG 2.0.21 may be downloaded from one of the GnuPG mirror sites or
58 direct from ftp://ftp.gnupg.org/gcrypt/gnupg/ .  The list of mirrors
59 can be found at http://www.gnupg.org/mirrors.html .  Note, that GnuPG
60 is not available at ftp.gnu.org.
61
62 On the FTP server and its mirrors you should find the following files
63 in the gnupg/ directory:
64
65   gnupg-2.0.21.tar.bz2 (4200k)
66   gnupg-2.0.21.tar.bz2.sig
67
68       GnuPG source compressed using BZIP2 and OpenPGP signature.
69
70   gnupg-2.0.20-2.0.21.diff.bz2 (39k)
71
72       A patch file to upgrade a 2.0.20 GnuPG source tree.  This patch
73       does not include updates of the language files.
74
75 Note, that we don't distribute gzip compressed tarballs for GnuPG-2.
76
77
78 Checking the Integrity
79 ======================
80
81 In order to check that the version of GnuPG which you are going to
82 install is an original and unmodified one, you can do it in one of
83 the following ways:
84
85  * If you already have a trusted version of GnuPG installed, you
86    can simply check the supplied signature.  For example to check the
87    signature of the file gnupg-2.0.21.tar.bz2 you would use this command:
88
89      gpg --verify gnupg-2.0.21.tar.bz2.sig
90
91    This checks whether the signature file matches the source file.
92    You should see a message indicating that the signature is good and
93    made by that signing key.  Make sure that you have the right key,
94    either by checking the fingerprint of that key with other sources
95    or by checking that the key has been signed by a trustworthy other
96    key.  Note, that you can retrieve the signing key using the command
97
98      finger wk ,at' g10code.com
99
100    or using a keyserver like
101
102      gpg --keyserver keys.gnupg.net --recv-key 4F25E3B6
103
104    The distribution key 4F25E3B6 is signed by the well known key
105    1E42B367.
106
107    NEVER USE A GNUPG VERSION YOU JUST DOWNLOADED TO CHECK THE
108    INTEGRITY OF THE SOURCE - USE AN EXISTING GNUPG INSTALLATION!
109
110  * If you are not able to use an old version of GnuPG, you have to verify
111    the SHA-1 checksum.  Assuming you downloaded the file
112    gnupg-2.0.21.tar.bz2, you would run the sha1sum command like this:
113
114      sha1sum gnupg-2.0.21.tar.bz2
115
116    and check that the output matches the first line from the
117    following list:
118
119 5ba8cce72eb4fd1a3ac1a282d25d7c7b90d3bf26  gnupg-2.0.21.tar.bz2
120 cd94a6267088eeff4735641b1fc832a1e6770ba3  gnupg-2.0.20-2.0.21.diff.bz2
121
122
123 Documentation
124 =============
125
126 The file gnupg.info has the complete user manual of the system.
127 Separate man pages are included as well; however they have not all the
128 details available in the manual.  It is also possible to read the
129 complete manual online in HTML format at
130
131   http://www.gnupg.org/documentation/manuals/gnupg/
132
133 or in Portable Document Format at
134
135   http://www.gnupg.org/documentation/manuals/gnupg.pdf .
136
137 The chapters on gpg-agent, gpg and gpgsm include information on how
138 to set up the whole thing.  You may also want search the GnuPG mailing
139 list archives or ask on the gnupg-users mailing lists for advise on
140 how to solve problems.  Many of the new features are around for
141 several years and thus enough public knowledge is already available.
142
143 Almost all mail clients support GnuPG-2.  Mutt users may want to use
144 the configure option "--enable-gpgme" during build time and put a "set
145 use_crypt_gpgme" in ~/.muttrc to enable S/MIME support along with the
146 reworked OpenPGP support.
147
148
149 Support
150 =======
151
152 Please consult the archive of the gnupg-users mailing list before
153 reporting a bug <http://gnupg.org/documentation/mailing-lists.html>.
154 We suggest to send bug reports for a new release to this list in favor
155 of filing a bug at <http://bugs.gnupg.org>.  We also have a dedicated
156 service directory at:
157
158   http://www.gnupg.org/service.html
159
160 The driving force behind the development of GnuPG is the company of
161 its principal author, Werner Koch.  Maintenance and improvement of
162 GnuPG and related software takes up most of their resources.  To allow
163 him to continue this work he kindly asks to either purchase a support
164 contract, engage g10 Code for custom enhancements, or to donate money:
165
166   http://g10code.com/gnupg-donation.html
167
168
169 Thanks
170 ======
171
172 We have to thank all the people who helped with this release, be it
173 testing, coding, translating, suggesting, auditing, administering the
174 servers, spreading the word, or answering questions on the mailing
175 lists.
176
177
178 Happy Hacking,
179
180   The GnuPG Team