* keygen.c (do_generate_keypair): Write the auth key to the card
[gnupg.git] / NEWS
1 Noteworthy changes in version 1.4.1
2 ------------------------------------------------
3
4     * New --rfc2440-text option which controls how text is handled in
5       signatures.  This is in response to some problems seen with
6       certain PGP/MIME mail clients and GnuPG version 1.4.0.  More
7       details about this are available at
8       <http://lists.gnupg.org/pipermail/gnupg-users/2005-January/024408.html>
9
10     * New "import-unusable-sigs" and "export-unusable-sigs" tags for
11       --import-options and --export-options.  These are on by
12       default, and cause GnuPG to not import or export key signatures
13       that are not usable (e.g. expired signatures).
14
15     * New experimental HTTP, HTTPS, FTP, and FTPS keyserver helper
16       that uses the cURL library <http://curl.haxx.se> to retrieve
17       keys.  This is disabled by default, but may be enabled with the
18       configure option --with-libcurl.  Without this option, the
19       existing HTTP code is used for HTTP, and HTTPS, FTP, and FTPS
20       are not supported.
21
22     * When running a --card-status or --card-edit and a public key is
23       available, missing secret key stubs will be created on the fly.
24       Details of the key are listed too.
25
26     * [W32] The algorithm for the default home directory changed:
27       First we look at the environment variable GNUPGHOME, if this one
28       is not set, we check whether the registry entry
29       {HKCU,HKLM}\Software\GNU\GnuPG:HomeDir has been set. If this
30       fails we use a GnuPG directory below the standard application
31       data directory (APPDATA) of the current user. Only in the case
32       that this directory cannot be determined, the old default of
33       c:\gnupg will be used.  The option --homedir still overrides all
34       of them.
35
36     * [W32] The locale selection under Windows changed. You need to
37       enter the locale in the registry at HKCU\Software\GNU\GnuPG:Lang. 
38       For German you would use "de".  If it is not set, GnupG falls
39       back to HKLM.  The languages files "*.mo" are expected in a
40       directory named "gnupg.nls" below the installation directory;
41       that directory must be stored in the registry at the same key as
42       above with the name "Install Directory".
43
44
45 Noteworthy changes in version 1.4.0 (2004-12-16)
46 ------------------------------------------------
47
48     * See the file doc/highlights-1.4.txt for an overview of all
49       changes in respect to the 1.2 series.
50
51
52 Noteworthy changes in version 1.3.93 (2004-12-14)
53 -------------------------------------------------
54
55     * Ask the user to repeat a changed PIN.
56
57     * Switched to automake 1.9.  Minor big fixes.
58
59     
60 Noteworthy changes in version 1.3.92 (2004-10-28)
61 -------------------------------------------------
62     
63     * Added Russian man page. Thanks to Pawel I. Shajdo.
64
65     * libiconv is now used to support other character sets other than
66       UTF-8, Latin-1,-2 and KOI8-2.  The W32 version will only work
67       correctly when iconv.dll is installed on the system.  A binary
68       version is available at all GNU mirror sites under libiconv.
69      
70     * gettext for Windows has been simplified.  The MO files are now
71       distributed UTF-8 encoded and gpg translates on the fly.
72
73
74 Noteworthy changes in version 1.3.91 (2004-10-15)
75 -------------------------------------------------
76
77     * A new configure option --enable-selinux-support disallows
78       processing of confidential files used by gpg (e.g. secring.gpg).
79       This helps writing ACLs for the SELinux kernel.
80
81     * Support for fetching keys via finger has been added.  This is
82       useful for setting a preferred keyserver URL like
83       "finger:wk@g10code.com".
84
85     * Timeout support has been added to the keyserver helpers.  This
86       allows users to set an upper limit on how long to wait for the
87       keyserver before giving up.
88
89     * New "direct" trust model where users can set key validity
90       directly if they do not want to participate in the web of trust.
91
92     * Minor bug fixes, code and string cleanups.
93
94
95 Noteworthy changes in version 1.3.90 (2004-10-01)
96 -------------------------------------------------
97
98     * Readline support at all prompts is now available if the systems
99       provides a readline library.  The build time option
100       --without-readline may be used to disable this feature.
101
102     * Support for the OpenPGP smartcard is now enabled by default.
103       Use the option --disable-card-support to build without support
104       for smartcards. 
105
106     * New command "addcardkey" in the key edit menu to add subkeys to
107       a smartcard. New command "keytocard" to transfer a key to a smartcard.
108       The serial number of the card is show in secret key listings.
109
110     * -K may now be used as an alias for --list-secret-keys.      
111
112     * HTTP Basic authentication is now supported for all HKP and HTTP
113       keyserver functions, either through a proxy or via direct
114       access.
115
116
117 Noteworthy changes in version 1.3.6 (2004-05-22)
118 ------------------------------------------------
119
120     * New --keyid-format option that selects short (99242560), long
121       (DB698D7199242560), 0xshort (0x99242560), or 0xlong
122       (0xDB698D7199242560) keyid displays.  This lets users tune the
123       display to what they prefer.
124
125     * The --list-options and --verify-options option
126       "show-long-keyids" has been removed since --keyid-format
127       obviates the need for them.
128
129     * Support for the old quasi-1991 partial length encoding has been
130       removed.
131
132     * The --export-all and --export-options include-non-rfc options
133       have been removed as superfluous since nonstandard V3 Elgamal
134       sign+encrypt keys have been removed.
135
136     * Preferred keyserver support has been added.  Users may set a
137       preferred keyserver via the --edit-key command "keyserver".  If
138       the --keyserver-option honor-keyserver-url is set (and it is by
139       default), then the preferred keyserver is used when refreshing
140       that key.
141
142     * The --sig-keyserver-url option can be used to inform signature
143       recipients where the signing key can be downloaded.  When
144       verifying the signature, if the signing key is not present, and
145       the keyserver options honor-keyserver-url and auto-key-retrieve
146       are set, this URL will be used to retrieve the key.
147
148     * Support for fetching keys via HTTP has been added.  This is
149       mainly useful for setting a preferred keyserver URL like
150       "http://www.jabberwocky.com/key.asc".
151
152     * New --ask-cert-level/--no-ask-cert-level option to turn on and
153       off the prompt for signature level when signing a key.  Defaults
154       to off.
155
156     * New --gpgconf-list command for internal use by the gpgconf
157       utility from gnupg 1.9.x.
158
159
160 Noteworthy changes in version 1.3.5 (2004-02-26)
161 ------------------------------------------------
162
163     * New --min-cert-level option to disregard key signatures that are
164       under a specified level.  Defaults to 2 (i.e. discard 0x11
165       signatures).
166
167     * New --max-output option to limit the amount of plaintext output
168       generated by GnuPG.  This option can be used by programs which
169       call GnuPG to process messages that may result in plaintext
170       larger than the calling program is prepared to handle.  This is
171       sometimes called a "Decompression Bomb".
172
173     * New --list-config command for frontends and other programs that
174       call GnuPG.  See doc/DETAILS for the specifics of this.
175
176     * Some performance improvements with large keyrings.  See the
177       build time option --enable-key-cache=SIZE in the README file for
178       details.
179
180     * Some portability fixes for the OpenBSD/i386, HPPA, and AIX
181       platforms.
182
183     * New keyserver-option "http-proxy" to specify which proxy to use
184       in the config file without using environment variables.
185
186     * Added support for storing, retrieving, and searching for keys in
187       LDAP servers.  Note that this is different than the "LDAP
188       keyserver" which was already (and remains) supported.
189
190     * Added support for TLS and LDAPS session encryption for LDAP.
191
192     * --show-session-key/--override-session-key now works with
193       --symmetric messages.
194
195     * The configure options --enable-rsa and --disable-rsa can now be
196       used to enable or disable the RSA algorithm.  This can be useful
197       for embedded use where space is tight.  --enable-minimal
198       includes --disable-rsa.  RSA is enabled by default.
199
200     * The last support for Elgamal sign+encrypt keys has been removed.
201
202
203 Noteworthy changes in version 1.3.4 (2003-11-27)
204 ------------------------------------------------
205
206     * Added support for BZIP2 compression.  This should be considered
207       experimental, and is only available if the libbzip2 library
208       <http://sources.redhat.com/bzip2/> is installed.
209
210     * Added the ability to handle messages that can be decrypted with
211       either a passphrase or a secret key.  These messages may be
212       generated with --symmetric --encrypt or --symmetric --sign
213       --encrypt.
214
215     * The config file search has been enhanced to try for less
216       specific filename matches before giving up.  For example,
217       version 1.3.4 will try for gpg.conf-1.3.4, gpg.conf-1.3, and
218       gpg.conf-1 before falling back to the regular gpg.conf file.
219
220     * Fixed a format string bug in the HKP keyserver handler.
221
222     * Support for Elgamal sign+encrypt keys has been removed.  Old
223       signatures may still be verified, and existing encrypted
224       messages may still be decrypted, but no new signatures may be
225       issued by, and no new messages will be encrypted to, these keys.
226
227
228 Noteworthy changes in version 1.3.3 (2003-10-10)
229 ------------------------------------------------
230
231     * Basic support for the OpenPGP card.  New commands --card-status,
232       --card-edit, --change-pin and the configuration options
233       --reader-port, --ctapi-driver, --pcsc-driver, and --disable-ccid.
234
235     * Full (read/write) support for the SHA-256 hash has been added.
236
237     * Support for the TIGER/192 hash has been dropped.  This should
238       not be interpreted as a statement as to the strength of
239       TIGER/192 - rather, the upcoming revision to the OpenPGP
240       standard removes support for several unused (or mostly unused)
241       hashes.
242
243     * Revoked or expired user IDs are now skipped when selecting keys
244       for encryption.  Specifying a key by the key ID overrides this
245       check and allows the selection of any key.
246
247     * Note that --no-mangle-dos-filenames is now the default.  If you
248       are upgrading from a 1.2.x version of GnuPG, and are running a
249       very old version of Windows that has the 8.3 filename limit, you
250       may need to change this.
251
252     * Multiple "Comment:" lines in armored output are now allowed.
253
254     * New --list-options option.  This option takes a list of
255       arguments that allows the user to customize exactly what key
256       listings (including the --edit-key listing) look like, enabling
257       or disabling things such as photo display, policy URL, preferred
258       keyserver URL, or notation display, long or short keyIDs,
259       calculated validity for each user ID, etc.  See the manual for
260       the complete list of list-options.
261
262     * New --verify-options option.  This option takes a list of
263       arguments that allows the user to customize exactly what happens
264       during signature verification, enabling or disabling things such
265       as photo display, policy URL, preferred keyserver URL, or
266       notation display, long or short keyIDs, calculated validity for
267       each user ID, etc.  See the manual for the complete list of
268       verify-options.
269
270     * New --sig-keyserver-url to embed a "where to get my key"
271       subpacket into a signature.
272
273     * The options --show-photos, --show-policy-url, --show-notation,
274       and --show-keyring are all deprecated in favor of those
275       arguments to --list-options and --verify-options.  The new
276       method is more flexible since a user can specify (for example)
277       showing photos during sig verification, but not in key listings.
278
279     * The complete fingerprint of the key that made a given key
280       certification is now available in the --with-colons output.  For
281       technical reasons, this is only available when running with
282       --no-sig-cache set.  See doc/DETAILS for the specifics of this.
283
284     * IPv6 support for HKP keyserver access.  IPv6 for LDAP keyserver
285       access is also supported, but is dependent on the LDAP library
286       used.
287
288     * To simplify running both the stable (1.2.x) and development
289       (1.3.x) versions of GnuPG, the development version will try to
290       load the options file gpg.conf-VERSION (e.g. gpg.conf-1.3.3 for
291       this release) before falling back to the regular gpg.conf file.
292
293     * Two new %-expandos for use in notation and policy URLs.  "%g"
294       expands to the fingerprint of the key making the signature
295       (which might be a subkey), and "%p" expands to the fingerprint
296       of the primary key that owns the key making the signature.
297  
298     * New "tru" record in --with-colons --list-keys listings.  It
299       shows the status of the trust database that was used to
300       calculate the key validity in the listings.  See doc/DETAILS for
301       the specifics of this.
302  
303     * New REVKEYSIG status tag for --status-fd.  It indicates a valid
304       signature that was issued by a revoked key.  See doc/DETAILS for
305       the specifics of this.
306
307     * A number of portability changes to make building GnuPG on
308       less-common platforms easier.
309
310
311 Noteworthy changes in version 1.3.2 (2003-05-27)
312 ------------------------------------------------
313
314     * New "--gnupg" option (set by default) that disables --openpgp,
315       and the various --pgpX emulation options.  This replaces
316       --no-openpgp, and --no-pgpX, and also means that GnuPG has
317       finally grown a --gnupg option to make GnuPG act like GnuPG.
318
319     * A bug in key validation has been fixed.  This bug only affects
320       keys with more than one user ID (photo IDs do not count here),
321       and results in all user IDs on a given key being treated with
322       the validity of the most-valid user ID on that key.
323
324     * Notation names that do not contain a '@' are no longer allowed
325       unless --expert is set.  This is to help prevent pollution of
326       the (as yet unused) IETF notation namespace.
327
328     * Multiple trust models are now supported via the --trust-model
329       option.  The options are "pgp" (web-of-trust plus trust
330       signatures), "classic" (web-of-trust only), and "always"
331       (identical to the --always-trust option).
332
333     * The --personal-{cipher|digest|compression}-preferences are now
334       consulted to get default algorithms before resorting to the
335       last-ditch defaults of --s2k-cipher-algo, SHA1, and ZIP
336       respectively.  This allows a user to set algorithms to use in a
337       safe manner so they are used when legal to do so, without
338       forcing them on for all messages.
339
340     * New --primary-keyring option to designate the keyring that the
341       user wants new keys imported into.
342
343     * --s2k-digest-algo is now used for all password mangling.
344       Earlier versions used both --s2k-digest-algo and --digest-algo
345       for passphrase mangling.
346
347     * Handling of --hidden-recipient or --throw-keyid messages is now
348       easier - the user only needs to give their passphrase once, and
349       GnuPG will try it against all of the available secret keys.
350
351     * Care is taken to prevent compiler optimization from removing
352       memory wiping code.
353
354     * New option --no-mangle-dos-filenames so that filenames are not
355       truncated in the W32 version.
356
357     * A "convert-from-106" script has been added.  This is a simple
358       script that automates the conversion from a 1.0.6 or earlier
359       version of GnuPG to a 1.0.7 or later version.
360
361     * Disabled keys are now skipped when selecting keys for
362       encryption.  If you are using the --with-colons key listings to
363       detect disabled keys, please see doc/DETAILS for a minor format
364       change in this release.
365
366     * Minor trustdb changes to make the trust calculations match
367       common usage.
368
369     * New command "revuid" in the --edit-key menu to revoke a user ID.
370       This is a simpler interface to the old method (which still
371       works) of revoking the user ID self-signature.
372
373     * Status VALIDSIG does now also print the primary key's
374       fingerprint, as well as the signature version, pubkey algorithm,
375       hash algorithm, and signature class.
376
377     * Add read-only support for the SHA-256 hash, and optional
378       read-only support for the SHA-384 and SHA-512 hashes.
379
380     * New option --enable-progress-filter for use with frontends.
381
382     * DNS SRV records are used in HKP keyserver lookups to allow
383       administrators to load balance and select keyserver ports
384       automatically.  This is as specified in
385       draft-shaw-openpgp-hkp-00.txt.
386
387     * When using the "keyid!" syntax during a key export, only that
388       specified key is exported.  If the key in question is a subkey,
389       the primary key plus only that subkey is exported.
390
391     * configure --disable-xxx options to disable individual algorithms
392       at build time.  This can be used to build a smaller gpg binary
393       for embedded uses where space is tight.  See the README file for
394       the algorithms that can be used with this option, or use
395       --enable-minimal to build the smallest gpg possible (disables
396       all optional algorithms, disables keyserver access, and disables
397       photo IDs).
398
399     * The keyserver no-modify flag on a key can now be displayed and
400       modified.
401
402     * Note that the TIGER/192 digest algorithm is in the process of
403       being dropped from the OpenPGP standard.  While this release of
404       GnuPG still contains it, it is disabled by default.  To ensure
405       you will still be able to use your messages with future versions
406       of GnuPG and other OpenPGP programs, please do not use this
407       algorithm.
408
409
410 Noteworthy changes in version 1.3.1 (2002-11-12)
411 ------------------------------------------------
412
413     * Trust signature support.  This is based on the Maurer trust
414       model where a user can specify the trust level along with the
415       signature with multiple levels so users can delegate
416       certification ability to other users, possibly restricted by a
417       regular expression on the user ID.  Note that full trust
418       signature support requires a regular expression parsing library.
419       The regexp code from glibc 2.3.1 is included for those platforms
420       that don't have working regexp functions available.  The
421       configure option --disable-regex may be used to disable any
422       regular expression code, which will make GnuPG ignore any trust
423       signature with a regular expression included.
424
425     * Two new commands --hidden-recipient (-R) and --hidden-encrypt-to
426       encrypt to a user, but hide the identity of that user.  This is
427       the same functionality as --throw-keyid, but can be used on a
428       per-user basis.
429
430     * Full algorithm names (e.g. "3DES", "SHA1", "ZIP") can now be
431       used interchangeably with the short algorithm names (e.g. "S2",
432       "H2", "Z1") anywhere algorithm names are used in GnuPG.
433
434
435 Noteworthy changes in version 1.3.0 (2002-10-18)
436 ------------------------------------------------
437
438     * The last piece of internal keyserver support has been removed,
439       and now all keyserver access is done via the keyserver plugins.
440       There is also a newer keyserver protocol used between GnuPG and
441       the plugins, so plugins from earlier versions of GnuPG may not
442       work properly.
443
444     * The HKP keyserver plugin supports the new machine-readable key
445       listing format for those keyservers that provide it.
446
447     * When using a HKP keyserver with multiple DNS records (such as
448       wwwkeys.pgp.net which has the addresses of multiple servers
449       around the world), try all records until one succeeds.  Note
450       that it depends on the LDAP library used whether the LDAP
451       keyserver plugin does this as well.
452
453     * The library dependencies for OpenLDAP seem to change fairly
454       frequently, and GnuPG's configure script cannot guess all the
455       combinations.  Use ./configure LDAPLIBS="-L libdir -l libs" to
456       override the script and use the libraries selected.
457
458     * Secret keys generated with --export-secret-subkeys are now
459       indicated in key listings with a '#' after the "sec", and in
460       --with-colons listings by showing no capabilities (no lowercase
461       characters).
462
463     * --trusted-key has been un-obsoleted, as it is useful for adding
464       ultimately trusted keys from the config file.  It is identical
465       to using --edit and "trust" to change a key to ultimately
466       trusted.
467
468     * Translations other than de are no longer distributed with the
469       development branch.  This is due to the frequent text changes
470       during development, which cause the translations to rapidly go
471       out of date.
472
473
474 Noteworthy changes in version 1.1.92 (2002-09-11)
475 -------------------------------------------------
476
477     * [IMPORTANT] The default configuration file is now
478       ~/.gnupg/gpg.conf.  If an old ~/.gnupg/options is found it will
479       still be used.  This change is required to have a more
480       consistent naming scheme with forthcoming tools.
481
482     * The use of MDCs have increased.  A MDC will be used if the
483       recipients directly request it, if the recipients have AES,
484       AES192, AES256, or TWOFISH in their cipher preferences, or if
485       the chosen cipher has a blocksize not equal to 64 bits
486       (currently this is also AES, AES192, AES256, and TWOFISH).
487
488     * GnuPG will no longer automatically disable compression when
489       processing an already-compressed file unless a MDC is being
490       used.  This is to give the message a certain amount of
491       resistance to the chosen-ciphertext attack while communicating
492       with other programs (most commonly PGP earlier than version 7.x)
493       that do not support MDCs.
494
495     * The option --interactive now has the desired effect when
496       importing keys.
497
498     * The file permission and ownership checks on files have been
499       clarified.  Specifically, the homedir (usually ~/.gnupg) is
500       checked to protect everything within it.  If the user specifies
501       keyrings outside this homedir, they are presumed to be shared
502       keyrings and therefore *not* checked.  Configuration files
503       specified with the --options option and the IDEA cipher
504       extension specified with --load-extension are checked, along
505       with their enclosing directories.
506
507     * The configure option --with-static-rnd=auto allows to build gpg
508       with all available entropy gathering modules included.  At
509       runtime the best usable one will be selected from the list
510       linux, egd, unix.  This is also the default for systems lacking
511       a /dev/random device.
512
513     * The default character set is now taken from the current locale;
514       it can still be overridden by the --charset option.  Using the
515       option -vvv shows the used character set.
516
517     * [REMOVED] --emulate-checksum-bug and --emulate-3des-s2k-bug have
518       been removed.
519
520
521 Noteworthy changes in version 1.1.91 (2002-08-04)
522 -------------------------------------------------
523
524     * All modules are now linked statically; the --load-extension
525       option is in general not useful anymore.  The only exception is
526       to specify the deprecated idea cipher.
527
528     * The IDEA plugin has changed.  Previous versions of the IDEA
529       plugin will no longer work with GnuPG.  However, the current
530       version of the plugin will work with earlier GnuPG versions.
531
532     * When using --batch with one of the --delete-key commands, the
533       key must be specified by fingerprint.  See the man page for
534       details.
535
536     * There are now various ways to restrict the ability GnuPG has to
537       exec external programs (for the keyserver helpers or photo ID
538       viewers).  Read the README file for the complete list.
539
540     * New export option to leave off attribute packets (photo IDs)
541       during export.  This is useful when exporting to HKP keyservers
542       which do not understand attribute packets.
543
544     * New import option to repair during import the HKP keyserver
545       mangling multiple subkeys bug.  Note that this cannot completely
546       repair the damaged key as some crucial data is removed by the
547       keyserver, but it does at least give you back one subkey.  This
548       is on by default for keyserver --recv-keys, and off by default
549       for regular --import.
550
551     * The keyserver helper programs now live in
552       /usr/[local/]libexec/gnupg by default.  If you are upgrading
553       from 1.0.7, you might want to delete your old copies in
554       /usr/[local/]bin.  If you use an OS that does not use libexec
555       for whatever reason, use configure --libexecdir=/usr/local/lib
556       to place the keyserver helpers there.
557
558     * The LDAP keyserver handler now works properly with very old
559       (version 1) LDAP keyservers.
560
561
562 Noteworthy changes in version 1.1.90 (2002-07-01)
563 -------------------------------------------------
564
565     * New commands: --personal-cipher-preferences,
566       --personal-digest-preferences, and
567       --personal-compress-preferences allow the user to specify which
568       algorithms are to be preferred.  Note that this does not permit
569       using an algorithm that is not present in the recipient's
570       preferences (which would violate the OpenPGP standard).  This
571       just allows sorting the preferences differently.
572
573     * New "group" command to refer to several keys with one name.
574
575     * A warning is issued if the user forces the use of an algorithm
576       that is not listed in the recipient's preferences.
577
578     * Full revocation key (aka "designated revoker") support.
579
580     * The preferred hash algorithms on a key are consulted when
581       encrypting a signed message to that key.  Note that this is
582       disabled by default by a SHA1 preference in
583       --personal-digest-preferences.
584
585     * --cert-digest-algo allows the user to specify the hash algorithm
586       to use when signing a key rather than the default SHA1 (or MD5
587       for PGP2 keys).  Do not use this feature unless you fully
588       understand the implications of this.
589
590     * --pgp7 mode automatically sets all necessary options to ensure
591       that the resulting message will be usable by a user of PGP 7.x.
592
593     * New --attribute-fd command for frontends and scripts to get the
594       contents of attribute packets (i.e. photos)
595
596     * In expert mode, the user can now re-sign a v3 key with a v4
597       self-signature.  This does not change the v3 key into a v4 key,
598       but it does allow the user to use preferences, primary ID flags,
599       etc.
600
601     * Significantly improved photo ID support on non-unixlike
602       platforms.
603
604     * The version number has jumped ahead to 1.1.90 to skip over the
605       old version 1.1 and to get ready for the upcoming 1.2.
606
607     * ElGamal sign and encrypt is not anymore allowed in the key
608       generation dialog unless in expert mode.  RSA sign and encrypt
609       has been added with the same restrictions.
610
611     * [W32] Keyserver access does work with Windows NT.
612
613
614 Noteworthy changes in version 1.0.7 (2002-04-29)
615 ------------------------------------------------
616
617     * Secret keys are now stored and exported in a new format which
618       uses SHA-1 for integrity checks.  This format renders the
619       Rosa/Klima attack useless.  Other OpenPGP implementations might
620       not yet support this, so the option --simple-sk-checksum creates
621       the old vulnerable format.
622
623     * The default cipher algorithm for encryption is now CAST5,
624       default hash algorithm is SHA-1.  This will give us better
625       interoperability with other OpenPGP implementations.
626
627     * Symmetric encrypted messages now use a fixed file size if
628       possible.  This is a tradeoff: it breaks PGP 5, but fixes PGP 2,
629       6, and 7.  Note this was only an issue with RFC-1991 style
630       symmetric messages.
631
632     * Photographic user ID support.  This uses an external program to
633       view the images.
634
635     * Enhanced keyserver support via keyserver "plugins".  GnuPG comes
636       with plugins for the NAI LDAP keyserver as well as the HKP email
637       keyserver.  It retains internal support for the HKP HTTP
638       keyserver.
639
640     * Nonrevocable signatures are now supported.  If a user signs a
641       key nonrevocably, this signature cannot be taken back so be
642       careful!
643
644     * Multiple signature classes are usable when signing a key to
645       specify how carefully the key information (fingerprint, photo
646       ID, etc) was checked.
647
648     * --pgp2 mode automatically sets all necessary options to ensure
649       that the resulting message will be usable by a user of PGP 2.x.
650
651     * --pgp6 mode automatically sets all necessary options to ensure
652       that the resulting message will be usable by a user of PGP 6.x.
653
654     * Signatures may now be given an expiration date.  When signing a
655       key with an expiration date, the user is prompted whether they
656       want their signature to expire at the same time.
657
658     * Revocation keys (designated revokers) are now supported if
659       present.  There is currently no way to designate new keys as
660       designated revokers.
661
662     * Permissions on the .gnupg directory and its files are checked
663       for safety.
664
665     * --expert mode enables certain silly things such as signing a
666       revoked user id, expired key, or revoked key.
667
668     * Some fixes to build cleanly under Cygwin32.
669
670     * New tool gpgsplit to split OpenPGP data formats into packets.
671
672     * New option --preserve-permissions.
673
674     * Subkeys created in the future are not used for encryption or
675       signing unless the new option --ignore-valid-from is used.
676
677     * Revoked user-IDs are not listed unless signatures are listed too
678       or we are in verbose mode.
679
680     * There is no default comment string with ascii armors anymore
681       except for revocation certificates and --enarmor mode.
682
683     * The command "primary" in the edit menu can be used to change the
684       primary UID, "setpref" and "updpref" can be used to change the
685       preferences.
686
687     * Fixed the preference handling; since 1.0.5 they were erroneously
688       matched against against the latest user ID and not the given one.
689
690     * RSA key generation.
691
692     * Merged Stefan's patches for RISC OS in.  See comments in
693       scripts/build-riscos. 
694
695     * It is now possible to sign and conventional encrypt a message (-cs).
696
697     * The MDC feature flag is supported and can be set by using
698       the "updpref" edit command.
699
700     * The status messages GOODSIG and BADSIG are now returning the primary
701       UID, encoded using %XX escaping (but with spaces left as spaces,
702       so that it should not break too much)
703
704     * Support for GDBM based keyrings has been removed.
705
706     * The entire keyring management has been revamped.
707
708     * The way signature stati are store has changed so that v3
709       signatures can be supported. To increase the speed of many
710       operations for existing keyrings you can use the new
711       --rebuild-keydb-caches command.
712
713     * The entire key validation process (trustdb) has been revamped.
714       See the man page entries for --update-trustdb, --check-trustdb
715       and --no-auto-check-trustdb.
716
717     * --trusted-keys is again obsolete, --edit can be used to set the
718       ownertrust of any key to ultimately trusted.
719
720     * A subkey is never used to sign keys.
721
722     * Read only keyrings are now handled as expected.
723
724
725 Noteworthy changes in version 1.0.6 (2001-05-29)
726 ------------------------------------------------
727
728     * Security fix for a format string bug in the tty code.
729
730     * Fixed format string bugs in all PO files. 
731
732     * Removed Russian translation due to too many bugs.  The FTP
733       server has an unofficial but better translation in the contrib
734       directory.
735
736     * Fixed expire time calculation and keyserver access.
737
738     * The usual set of minor bug fixes and enhancements.
739
740     * non-writable keyrings are now correctly handled.
741
742
743 Noteworthy changes in version 1.0.5 (2001-04-29)
744 ------------------------------------------------
745
746     * WARNING: The semantics of --verify have changed to address a
747       problem with detached signature detection. --verify now ignores
748       signed material given on stdin unless this is requested by using
749       a "-" as the name for the file with the signed material.  Please
750       check all your detached signature handling applications and make
751       sure that they don't pipe the signed material to stdin without
752       using a filename together with "-" on the the command line.
753
754     * WARNING: Corrected hash calculation for input data larger than
755       512M - it was just wrong, so you might notice bad signature in
756       some very big files.  It may be wise to keep an old copy of
757       GnuPG around.
758
759     * Secret keys are no longer imported unless you use the new option
760       --allow-secret-key-import.  This is a kludge and future versions will
761       handle it in another way.
762
763     * New command "showpref" in the --edit-key menu to show an easier
764       to understand preference listing.
765
766     * There is now the notation of a primary user ID.  For example, it
767       is printed with a signature verification as the first user ID;
768       revoked user IDs are not printed there anymore.  In general the
769       primary user ID is the one with the latest self-signature.
770
771     * New --charset=utf-8 to bypass all internal conversions.
772
773     * Large File Support (LFS) is now working.
774
775     * New options: --ignore-crc-error, --no-sig-create-check, 
776       --no-sig-cache, --fixed_list_mode, --no-expensive-trust-checks,
777       --enable-special-filenames and --use-agent.  See man page.
778
779     * New command --pipemode, which can be used to run gpg as a
780       co-process.  Currently only the verification of detached
781       signatures are working.  See doc/DETAILS.
782
783     * Keyserver support for the W32 version.
784
785     * Rewritten key selection code so that GnuPG can better cope with
786       multiple subkeys, expire dates and so.  The drawback is that it
787       is slower.
788
789     * A whole lot of bug fixes.
790
791     * The verification status of self-signatures are now cached. To
792       increase the speed of key list operations for existing keys you
793       can do the following in your GnuPG homedir (~/.gnupg):
794          cp pubring.gpg pubring.gpg.save && gpg --export-all >x && \
795          rm pubring.gpg && gpg --import x
796       Only v4 keys (i.e not the old RSA keys) benefit from this caching.
797
798     * New translations: Estonian, Turkish.
799
800
801 Noteworthy changes in version 1.0.4 (2000-10-17)
802 ------------------------------------------------
803
804     * Fixed a serious bug which could lead to false signature verification
805       results when more than one signature is fed to gpg.  This is the
806       primary reason for releasing this version.
807
808     * New utility gpgv which is a stripped down version of gpg to
809       be used to verify signatures against a list of trusted keys.
810
811     * Rijndael (AES) is now supported and listed with top preference.
812
813     * --with-colons now works with --print-md[s].
814
815 Noteworthy changes in version 1.0.3 (2000-09-18)
816 ------------------------------------------------
817
818     * Fixed problems with piping to/from other MS-Windows software
819
820     * Expiration time of the primary key can be changed again.
821
822     * Revoked user IDs are now marked in the output of --list-key
823
824     * New options --show-session-key and --override-session-key
825       to help the British folks to somewhat minimize the danger
826       of this Orwellian RIP bill.
827
828     * New options --merge-only and --try-all-secrets.
829
830     * New configuration option --with-egd-socket.
831
832     * The --trusted-key option is back after it left us with 0.9.5
833      
834     * RSA is supported. Key generation does not yet work but will come
835       soon. 
836     
837     * CAST5 and SHA-1 are now the default algorithms to protect the key
838       and for symmetric-only encryption. This should solve a couple
839       of compatibility problems because the old algorithms are optional
840       according to RFC2440
841
842     * Twofish and MDC enhanced encryption is now used.  PGP 7 supports 
843       this.  Older versions of GnuPG don't support it, so they should be
844       upgraded to at least 1.0.2
845       
846
847 Noteworthy changes in version 1.0.2 (2000-07-12)
848 ----------------------------------------------
849
850     * Fixed expiration handling of encryption keys.
851
852     * Add an experimental feature to do unattended key generation.
853
854     * The user is now asked for the reason of revocation as required
855       by the new OpenPGP draft.
856
857     * There is a ~/.gnupg/random_seed file now which saves the
858       state of the internal RNG and increases system performance
859       somewhat.  This way the full entropy source is only used in
860       cases were it is really required.
861       Use the option --no-random-seed-file to disable this feature.
862
863     * New options --ignore-time-conflict and --lock-never.
864
865     * Some fixes for the W32 version.
866
867     * The entropy.dll is not anymore used by the W32 version but replaced
868       by code derived from Cryptlib.
869
870     * Encryption is now much faster: About 2 times for 1k bit keys
871       and 8 times for 4k keys.
872
873     * New encryption keys are generated in a way which allows a much
874       faster decryption.
875
876     * New command --export-secret-subkeys which outputs the
877       the _primary_ key with it's secret parts deleted.  This is
878       useful for automated decryption/signature creation as it
879       allows to keep the real secret primary key offline and
880       thereby protecting the key certificates and allowing to
881       create revocations for the subkeys.  See the FAQ for a
882       procedure to install such secret keys.
883
884     * Keygeneration now writes to the first writeable keyring or
885       as default to the one in the homedirectory.  Prior versions
886       ignored all --keyring options.
887
888     * New option --command-fd to take user input from a file descriptor;
889       to be used with --status-fd by software which uses GnuPG as a backend.
890
891     * There is a new status PROGRESS which is used to show progress during
892       key generation.
893
894     * Support for the new MDC encryption packets.  To create them either
895       --force-mdc must be use or cipher algorithm with a blocksize other
896       than 64 bits is to be used.  --openpgp currently disables MDC packets
897       entirely.  This option should not yet be used.
898
899     * New option --no-auto-key-retrieve to disable retrieving of
900       a missing public key from a keyserver, when a keyserver has been set.
901
902     * Danish translation
903
904 Noteworthy changes in version 1.0.1 (1999-12-16)
905 -----------------------------------
906
907     * New command --verify-files.  New option --fast-list-mode.
908
909     * $http_proxy is now used when --honor-http-proxy is set.
910
911     * Fixed some minor bugs and the problem with conventional encrypted
912       packets which did use the gpg v3 partial length headers.
913
914     * Add Indonesian and Portugese translations.
915
916     * Fixed a bug with symmetric-only encryption using the non-default 3DES.
917       The option --emulate-3des-s2k-bug may be used to decrypt documents
918       which have been encrypted this way; this should be done immediately
919       as this workaround will be remove in 1.1
920
921     * Can now handle (but not display) PGP's photo IDs. I don't know the
922       format of that packet but after stripping a few bytes from the start
923       it looks like a JPEG (at least my test data).  Handling of this
924       package is required because otherwise it would mix up the
925       self signatures and you can't import those keys.
926
927     * Passing non-ascii user IDs on the commandline should now work in all
928       cases.
929
930     * New keys are now generated with an additional preference to Blowfish.
931
932     * Removed the GNU Privacy Handbook from the distribution as it will go
933       into a separate one.
934
935
936 Noteworthy changes in version 1.0.0 (1999-09-07)
937 -----------------------------------
938
939     * Add a very preliminary version of the GNU Privacy Handbook to
940       the distribution (lynx doc/gph/index.html).
941
942     * Changed the version number to GnuPG 2001 ;-)
943
944
945 Noteworthy changes in version 0.9.11
946 ------------------------------------
947
948     * UTF-8 strings are now correctly printed (if --charset is set correctly).
949       Output of --with-colons remains C-style escaped UTF-8.
950
951     * Workaround for a problem with PGP 5 detached signature in textmode.
952
953     * Fixed a problem when importing new subkeys (duplicated signatures).
954
955 Noteworthy changes in version 0.9.10
956 ------------------------------------
957
958     * Some strange new options to help pgpgpg
959
960     * Cleaned up the dox a bit.
961
962
963 Noteworthy changes in version 0.9.9
964 -----------------------------------
965
966     * New options --[no-]utf8-strings.
967
968     * New edit-menu commands "enable" and "disable" for entire keys.
969
970     * You will be asked for a filename if gpg cannot deduce one.
971
972     * Changes to support libtool which is needed for the development
973       of libgcrypt.
974
975     * New script tools/lspgpot to help transferring assigned
976       trustvalues from PGP to GnuPG.
977
978     * New commands --lsign-key and made --sign-key a shortcut for --edit
979       and sign.
980
981     * New options (#122--126 ;-) --[no-]default-recipient[-self],
982       --disable-{cipher,pubkey}-algo. See the man page.
983
984     * Enhanced info output in case of multiple recipients and fixed exit code.
985
986     * New option --allow-non-selfsigned-uid to work around a problem with
987       the German IN way of separating signing and encryption keys.
988
989
990 Noteworthy changes in version 0.9.8
991 -----------------------------------
992
993     * New subcommand "delsig" in the edit menu.
994
995     * The name of the output file is not anymore the one which is
996       embedded in the processed message, but the used filename with
997       the extension stripped.  To revert to the old behaviour you can
998       use the option --use-embedded-filename.
999
1000     * Another hack to cope with pgp2 generated detached signatures.
1001
1002     * latin-2 character set works (--charset=iso-8859-2).
1003
1004     * New option --with-key-data to list the public key parameters.
1005       New option -N to insert notations and a --set-policy-url.
1006       A couple of other options to allow reseting of options.
1007
1008     * Better support for HPUX.
1009
1010
1011 Noteworthy changes in version 0.9.7
1012 -----------------------------------
1013
1014     * Add some work arounds for a bugs in pgp 2 which led to bad signatures
1015       when used with canonical texts in some cases.
1016
1017     * Enhanced some status outputs.
1018
1019 Noteworthy changes in version 0.9.6
1020 -----------------------------------
1021
1022     * Twofish is now statically linked by default. The experimental 128 bit
1023       version is now disabled.  Full support will be available as soon as
1024       the OpenPGP WG has decided on an interpretation of rfc2440.
1025
1026     * Dropped support for the ancient Blowfish160 which is not OpenPGP.
1027
1028     * Merged gpgm and gpg into one binary.
1029
1030     * Add "revsig" and "revkey" commands to the edit menu.  It is now
1031       possible to revoke signature and subkeys.
1032
1033
1034 Noteworthy changes in version 0.9.5
1035 -----------------------------------
1036
1037     * New command "lsign" in the keyedit menu to create non-exportable
1038       signatures.  Removed --trusted-keys option.
1039
1040     * A bunch of changes to the key validation code.
1041
1042     * --list-trust-path now has an optional --with-colons format.
1043
1044     * New command --recv-keys to import keys from an keyserver.
1045
1046
1047 Noteworthy changes in version 0.9.4
1048 -----------------------------------
1049
1050     * New configure option --enable-static-rnd=[egd|linux|unix|none]
1051       to select a random gathering module for static linking.
1052
1053     * The original text is now verbatim copied to a cleartext signed message.
1054
1055     * Bugfixes but there are still a couple of bugs.
1056
1057
1058 Noteworthy changes in version 0.9.3
1059 -----------------------------------
1060
1061     * Changed the internal design of getkey which now allows a
1062       efficient lookup of multiple keys and add a word match mode.
1063
1064     * New options --[no-]encrypt-to.
1065
1066     * Some changes to the configure stuff.  Switched to automake 1.4.
1067       Removed intl/ from CVS, autogen.sh now uses gettextize.
1068
1069     * Preferences now include Twofish. Removed preference to Blowfish with
1070       a special hack to suppress the "not listed in preferences" warning;
1071       this is to allow us to switch completely to Twofish in the near future.
1072
1073     * Changed the locking stuff.
1074
1075     * Print all user ids of a good signature.
1076
1077
1078 Noteworthy changes in version 0.9.2
1079 -----------------------------------
1080
1081     * add some additional time warp checks.
1082
1083     * Option --keyserver and command --send-keys to utilize HKP servers.
1084
1085     * Upgraded to zlib 1.1.3 and fixed an inflate bug
1086
1087     * More cleanup on the cleartext signatures.
1088
1089
1090 Noteworthy changes in version 0.9.1
1091 -----------------------------------
1092
1093     * Polish language support.
1094
1095     * When querying the passphrase, the key ID of the primary key is
1096       displayed along with the one of the used secondary key.
1097
1098     * Fixed a bug occurring when decrypting pgp 5 encrypted messages,
1099       fixed an infinite loop bug in the 3DES code and in the code
1100       which looks for trusted signatures.
1101
1102     * Fixed a bug in the mpi library which caused signatures not to
1103       compare okay.
1104
1105     * Rewrote the handling of cleartext signatures; the code is now
1106       better maintainable (I hope so).
1107
1108     * New status output VALIDSIG only for valid signatures together
1109       with the fingerprint of the signer's key.
1110
1111
1112 Noteworthy changes in version 0.9.0
1113 -----------------------------------
1114
1115     * --export does now only exports rfc2440 compatible keys; the
1116       old behaviour is available with --export-all.
1117       Generation of v3 ElGamal (sign and encrypt) keys is not longer
1118       supported.
1119
1120     * Fixed the uncompress bug.
1121
1122     * Rewrote the rndunix module. There are two environment variables
1123       used for debugging now: GNUPG_RNDUNIX_DBG give the file to write
1124       debugging information (use "-" for stdout) and if GNUPG_RNDUNIX_DBGALL
1125       is set, all programs which are only tried are also printed.
1126
1127     * New option --escape-from-lines to "dash-escape" "From " lines to
1128       prevent mailers to change them to ">From ".  This is not enabled by
1129       default because it is not in compliance with rfc2440 - however, you
1130       should turn it on.
1131
1132
1133 Noteworthy changes in version 0.4.5
1134 -----------------------------------
1135
1136     * The keyrings and the trustdb is now locked, so that
1137       other GnuPG processes won't damage these files.  You
1138       may want to put the option --lock-once into your options file.
1139
1140     * The latest self-signatures are now used; this enables --import
1141       to see updated preferences etc.
1142
1143     * Import of subkeys should now work.
1144
1145     * Random gathering modules may now be loaded as extensions. Add
1146       such a module for most Unices but it is very experimental!
1147
1148     * Brazilian language support.
1149
1150
1151 Noteworthy changes in version 0.4.4
1152 -----------------------------------
1153
1154     * Fixed the way the key expiration time is stored. If you have
1155       an expiration time on your key you should fix it with --edit-key
1156       and the command "expire".  I apologize for this inconvenience.
1157
1158     * Add option --charset to support "koi8-r" encoding of user ids.
1159       (Not yet tested).
1160
1161     * Preferences should now work again. You should run
1162       "gpgm --check-trustdb \*" to rebuild all preferences.
1163
1164     * Checking of certificates should now work but this needs a lot
1165       of testing.  Key validation values are now cached in the
1166       trustdb; they should be recalculated as needed, but you may
1167       use --check-trustdb or --update-trustdb to do this.
1168
1169     * Spanish translation by Urko Lusa.
1170
1171     * Patch files are from now on signed.  See the man page
1172       for the new option --not-dash-escaped.
1173
1174     * New syntax: --edit-key <userID> [<commands>]
1175       If you run it without --batch the commands are executed and then
1176       you are put into normal mode unless you use "quit" or "save" as
1177       one of the commands.  When in batch mode, the program quits after
1178       the last command, so you have to use "save" if you did some changes.
1179       It does not yet work completely, but may be used to list so the
1180       keys etc.
1181
1182
1183 Noteworthy changes in version 0.4.3
1184 -----------------------------------
1185
1186     * Fixed the gettext configure bug.
1187
1188     * Kludge for RSA keys: keyid and length of a RSA key are
1189       correctly reported, but you get an error if you try to use
1190       this key (If you do not have the non-US version).
1191
1192     * Experimental support for keyrings stored in a GDBM database.
1193       This is *much* faster than a standard keyring.  You will notice
1194       that the import gets slower with time; the reason is that all
1195       new keys are used to verify signatures of previous inserted
1196       keys.  Use "--keyring gnupg-gdbm:<name-of-gdbm-file>".  This is
1197       not (yet) supported for secret keys.
1198
1199     * A Russian language file in the distribution (alternatives are in
1200       the contrib directory of the FTP servers)
1201
1202     * commandline option processing now works as expected for GNU programs
1203       with the exception that you can't mix options and normal arguments.
1204
1205     * Now --list-key lists all matching keys.  This is needed in some
1206       other places too.
1207
1208
1209 Noteworthy changes in version 0.4.2
1210 -----------------------------------
1211
1212     * This is only a snapshot: There are still a few bugs.
1213
1214     * Fixed this huge memory leak.
1215
1216     * Redesigned the trust database:  You should run "gpgm --check-trustdb".
1217       New command --update-trustdb, which adds new key from the public
1218       keyring into your trustdb
1219
1220     * Fixed a bug in the armor code, leading to invalid packet errors.
1221       (a workaround for this was to use --no-armor).  The shorten line
1222       length (64 instead of 72) fixes a problem with pgp5 and keyservers.
1223
1224     * comment packets are not anymore generated. "--export" filters
1225       them out.  One Exception:  The comment packets in a secret keyring
1226       are still used because they carry the factorization of the public
1227       prime product.
1228
1229     * --import now only looks for KEYBLOCK headers, so you can now simply
1230       remove the "- " in front of such a header if someone accidently signed
1231       such a message or the keyblock is part of a cleartext signed message.
1232
1233     * --with-colons now lists the key expiration time and not anymore
1234       the valid period.
1235
1236     * Some keyblocks created with old releases have a wrong sequence
1237       of packets, so that the keyservers don't accept these keys.
1238       Simply using "--edit-key" fixes the problem.
1239
1240     * New option --force-v3-sigs to generate signed messages which are
1241       compatible to PGP 5.
1242
1243     * Add some code to support DLD (for non ELF systems) - but this is
1244       not tested because my BSD box is currently broken.
1245
1246     * New command "expire" in the edit-key menu.
1247
1248
1249
1250 Noteworthy changes in version 0.4.1
1251 -----------------------------------
1252     * A secondary key is used when the primary key is specified but cannot
1253       be used for the operation (if it is a sign-only key).
1254
1255     * GNUPG can now handle concatenated armored messages:  There is still a
1256       bug if different kinds of messages are mixed.
1257
1258     * Iterated+Salted passphrases now work.  If want to be sure that PGP5
1259       is able to handle them you may want to use the options
1260         "--s2k-mode 3 --s2k-cipher-algo cast5 --s2k-digest-algo sha1"
1261       when changing a passphrase.
1262
1263     * doc/OpenPGP talks about OpenPGP compliance, doc/HACKING gives
1264       a few hints about the internal structure.
1265
1266     * Checked gnupg against the August 1998 draft (07) and I believe
1267       it is in compliance with this document (except for one point).
1268
1269     * Fixed some bugs in the import merging code and rewrote some
1270       code for the trustdb.
1271
1272
1273 Noteworthy changes in version 0.4.0
1274 -----------------------------------
1275     * Triple DES is now supported.  Michael Roth did this piece of
1276       needed work.  We have now all the coded needed to be OpenPGP
1277       compliant.
1278
1279     * Added a simple rpm spec file (see INSTALL).
1280
1281     * detached and armored signatures are now using "PGP SIGNATURE",
1282       except when --rfc1991 is used.
1283
1284     * All times which are not in the yyyy-mm-dd format are now printed
1285       in local time.
1286
1287
1288 Noteworthy changes in version 0.3.5
1289 -----------------------------------
1290     * New option --throw-keyid to create anonymous enciphered messages.
1291       If gpg detects such a message it tires all available secret keys
1292       in turn so decode it.  This is a gnupg extension and not in OpenPGP
1293       but it has been discussed there and afaik some products use this
1294       scheme too (Suggested by Nimrod Zimmerman).
1295
1296     * Fixed a bug with 5 byte length headers.
1297
1298     * --delete-[secret-]key is now also available in gpgm.
1299
1300     * cleartext signatures are not anymore converted to LF only.
1301
1302     * Fixed a trustdb problem.  Run "gpgm --check-trustdb" to fix old
1303       trust dbs.
1304
1305     * Building in another directory should now work.
1306
1307     * Weak key detection mechanism (Niklas Hernaeus).
1308
1309
1310 Noteworthy changes in version 0.3.4
1311 -----------------------------------
1312     * New options --comment and --set-filename; see g10/OPTIONS
1313
1314     * yes/no, y/n localized.
1315
1316     * Fixed some bugs.
1317
1318 Noteworthy changes in version 0.3.3
1319 -----------------------------------
1320     * IMPORTANT: I found yet another bug in the way the secret keys
1321       are encrypted - I did it the way pgp 2.x did it, but OpenPGP
1322       and pgp 5.x specify another (in some aspects simpler) method.
1323       To convert your secret keys you have to do this:
1324         1. Build the new release but don't install it and keep
1325            a copy of the old program.
1326         2. Disable the network, make sure that you are the only
1327            user, be sure that there are no Trojan horses etc ....
1328         3. Use your old gpg (version 0.3.[12]) and set the
1329            passphrases of ALL your secret keys to empty!
1330            (gpg --change-passphrase your-user-id).
1331         4. Save your ownertrusts (see the next point)
1332         5. rm ~/.gnupg/trustdb.gpg
1333         6. install the new version of gpg (0.3.3)
1334         7. For every secret key call "gpg --edit-key your-user-id",
1335            enter "passwd" at the prompt, follow the instructions and
1336            change your password back, enter "save" to store it.
1337         8. Restore the ownertrust (see next point).
1338
1339     * The format of the trust database has changed; you must delete
1340       the old one, so gnupg can create a new one.
1341       IMPORTANT: Use version 0.3.[12] to save your assigned ownertrusts
1342       ("gpgm --list-ownertrust >saved-trust"); then build this new version
1343       and restore the ownertrust with this new version
1344       ("gpgm --import-ownertrust saved-trust").  Please note that
1345       --list-ownertrust has been renamed to --export-ownertrust in this
1346       release and it does now only export defined ownertrusts.
1347
1348     * The command --edit-key now provides a commandline driven menu
1349       which can be used for various tasks.  --sign-key is only an
1350       an alias to --edit-key and maybe removed in future: use the
1351       command "sign" of this new menu - you can select which user ids
1352       you want to sign.
1353
1354     * Alternate user ids can now be created an signed.
1355
1356     * Owner trust values can now be changed with --edit-key (trust)
1357
1358     * GNUPG can now run as a coprocess; this enables sophisticated
1359       frontends.  tools/shmtest.c is a simple sample implementation.
1360       This needs some more work: all tty_xxx() are to be replaced
1361       by cpr_xxx() and some changes in the display logics is needed.
1362
1363     * Removed options --gen-prime and --gen-random.
1364
1365     * Removed option --add-key; use --edit-key instead.
1366
1367     * Removed option --change-passphrase; use --edit-key instead.
1368
1369     * Signatures are now checked even if the output file could not
1370       be created. Command "--verify" tries to find the detached data.
1371
1372     * gpg now disables core dumps.
1373
1374     * compress and symmetric cipher preferences are now used.
1375       Because there is no 3DES yet, this is replaced by Blowfish.
1376
1377     * We have added the Twofish as an experimental cipher algorithm.
1378       Many thanks to Matthew Skala for doing this work.
1379       Twofish is the AES submission from Schneier et al.; see
1380       "www.counterpane.com/twofish.html" for more information.
1381
1382     * Started with a help system: If you enter a question mark at some
1383       prompt; you should get a specific help for this prompt.
1384
1385     * There is no more backup copy of the secret keyring.
1386
1387     * A lot of new bugs. I think this release is not as stable as
1388       the previous one.
1389
1390
1391 Noteworthy changes in version 0.3.2
1392 -----------------------------------
1393     * Fixed some bugs when using --textmode (-seat)
1394
1395     * Now displays the trust status of a positive verified message.
1396
1397     * Keyrings are now scanned in the sequence they are added with
1398       --[secret-]keyring.  Note that the default keyring is implicitly
1399       added as the very first one unless --no-default-keyring is used.
1400
1401     * Fixed setuid and dlopen bug.
1402
1403 Noteworthy changes in version 0.3.1
1404 -----------------------------------
1405     * Partial headers are now written in the OpenPGP format if
1406       a key in a v4 packet is used.
1407
1408     * Removed some unused options, removed the gnupg.sig stuff.
1409
1410     * Key lookup by name now returns a key which can be used for
1411       the desired action.
1412
1413     * New options --list-ownertrust (gpgm) to make a backup copy
1414       of the ownertrust values you assigned.
1415
1416     * clear signature headers are now in compliance with OpenPGP.
1417
1418 Noteworthy changes in version 0.3.0
1419 -----------------------------------
1420
1421     * New option --emulate-checksum-bug.  If your passphrase does not
1422       work anymore, use this option and --change-passphrase to rewrite
1423       your passphrase.
1424
1425     * More complete v4 key support: Preferences and expiration time
1426       is set into the self signature.
1427
1428     * Key generation defaults to DSA/ElGamal keys, so that new keys are
1429       interoperable with pgp5
1430
1431     * DSA key generation is faster and key generation does not anymore
1432       remove entropy from the random generator (the primes are public
1433       parameters, so there is really no need for a cryptographic secure
1434       prime number generator which we had used).
1435
1436     * A complete new structure for representing the key parameters.
1437
1438     * Removed most public key knowledge into the cipher library.
1439
1440     * Support for dynamic loading of new algorithms.
1441
1442     * Moved tiger to an extension module.
1443
1444
1445 Noteworthy changes in version 0.2.19
1446 ------------------------------------
1447
1448     * Replaced /dev/urandom in checks with new tool mk-tdata.
1449
1450     * Some assembler file cleanups; some more functions for the Alpha.
1451
1452     * Tiger has now the OpenPGP assigned number 6.  Because the OID has
1453       changed, old signatures using this algorithm can't be verified.
1454
1455     * gnupg now encrypts the compressed packed and not any longer in the
1456       reverse order; anyway it can decrypt both versions. Thanks to Tom
1457       for telling me this (not security related) bug.
1458
1459     * --add-key works and you are now able to generate subkeys.
1460
1461     * It is now possible to generate ElGamal keys in v4 packets to create
1462       valid OpenPGP keys.
1463
1464     * Some new features for better integration into MUAs.
1465
1466
1467 Noteworthy changes in version 0.2.18
1468 ------------------------------------
1469
1470     * Splitted cipher/random.c, add new option "--disable-dev-random"
1471       to configure to support the development of a random source for
1472       other systems. Prepared sourcefiles rand-unix.c, rand-w32.c
1473       and rand-dummy.c (which is used to allow compilation on systems
1474       without a random source).
1475
1476     * Fixed a small bug in the key generation (it was possible that 48 bits
1477       of a key were not taken from the random pool)
1478
1479     * Add key generation for DSA and v4 signatures.
1480
1481     * Add a function trap_unaligned(), so that a SIGBUS is issued on
1482       Alphas and not the slow emulation code is used. And success: rmd160
1483       raised a SIGBUS.
1484
1485     * Enhanced the formatting facility of argparse and changed the use of
1486       \r,\v to @ because gettext does not like it.
1487
1488     * New option "--compress-algo 1" to allow the creation of compressed
1489       messages which are readable by PGP and "--print-md" (gpgm) to make
1490       speed measurement easier.
1491
1492
1493 Noteworthy changes in version 0.2.17
1494 ------------------------------------
1495
1496     * Comment packets are now of private type 61.
1497
1498     * Passphrase code still used a 160 bit blowfish key, added a
1499       silly workaround. Please change your passphrase again - sorry.
1500
1501     * Conventional encryption now uses a type 3 packet to describe the
1502       used algorithms.
1503
1504     * The new algorithm number for Blowfish is 20, 16 is still used for
1505       encryption only; for signing it is only used when it is in a v3 packet,
1506       so that GNUPG keys are still valid.
1507
1508
1509 Noteworthy changes in version 0.2.16
1510 ------------------------------------
1511
1512     * Add experimental support for the TIGER/192 message digest algorithm.
1513       (But there is only a dummy ASN OID).
1514
1515     * Standard cipher is now Blowfish with 128 bit key in OpenPGP's CFB
1516       mode. I renamed the old cipher to Blowfish160. Because the OpenPGP
1517       group refused to assign me a number for Blowfish160, I have to
1518       drop support for this in the future. You should use
1519       "--change-passphrase" to recode your current passphrase with 128
1520       bit Blowfish.
1521
1522
1523 Noteworthy changes in version 0.2.15
1524 ------------------------------------
1525
1526     * Fixed a bug with the old checksum calculation for secret keys.
1527       If you run the program without --batch, a warning does inform
1528       you if your secret key needs to be converted; simply use
1529       --change-passphrase to recalculate the checksum. Please do this
1530       soon, as the compatible mode will be removed sometime in the future.
1531
1532     * CAST5 works (using the PGP's special CFB mode).
1533
1534     * Again somewhat more PGP 5 compatible.
1535
1536     * Some new test cases
1537
1538 Noteworthy changes in version 0.2.14
1539 ------------------------------------
1540
1541     * Changed the internal handling of keyrings.
1542
1543     * Add support to list PGP 5 keyrings with subkeys
1544
1545     * Timestamps of signatures are now verified.
1546
1547     * A expiration time can now be specified during key generation.
1548
1549     * Some speedups for Blowfish and SHA-1, rewrote SHA-1 transform.
1550       Reduced the amount of random bytes needed for key generation in
1551       some cases.
1552
1553
1554 Noteworthy changes in version 0.2.13
1555 ------------------------------------
1556
1557     * Verify of DSA signatures works.
1558
1559     * Re-implemented the slower random number generator.
1560
1561
1562 Noteworthy changes in version 0.2.12
1563 ------------------------------------
1564
1565     * --delete-key checks that there is no secret key. The new
1566       option --delete-secret-key maybe used to delete a secret key.
1567
1568     * "-kv" now works as expected. Options "--list-{keys,sigs]"
1569       and "--check-sigs" are now working.
1570
1571     * New options "--verify" and "--decrypt" to better support integration
1572       into MUAs (partly done for Mutt).
1573
1574     * New option "--with-colons" to make parsing of key lists easier.
1575
1576 Noteworthy changes in version 0.2.11
1577 ------------------------------------
1578
1579     * GPG now asks for a recipient's name if option "-r" is not used.
1580
1581     * If there is no good trust path, the program asks whether to use
1582       the public keys anyway.
1583
1584     * "--delete-key" works for public keys. What semantics shall I use
1585       when there is a secret key too? Delete the secret key or leave him
1586       and auto-regenerate the public key, next time the secret key is used?
1587
1588 Noteworthy changes in version 0.2.10
1589 ------------------------------------
1590
1591     * Code for the alpha is much faster (about 20 times); the data
1592       was misaligned and the kernel traps this, so nearly all time
1593       was used by system to trap the misalignments and to write
1594       syslog messages. Shame on me and thanks to Ralph for
1595       pointing me at this while drinking some beer yesterday.
1596
1597     * Changed some configure options and add an option
1598       --disable-m-guard to remove the memory checking code
1599       and to compile everything with optimization on.
1600
1601     * New environment variable GNUPGHOME, which can be used to set
1602       another homedir than ~/.gnupg.  Changed default homedir for
1603       Windoze version to c:/gnupg.
1604
1605     * Fixed detached signatures; detached PGP signatures caused a SEGV.
1606
1607     * The Windoze version works (as usual w/o a strong RNG).
1608
1609
1610 Noteworthy changes in version 0.2.9
1611 -----------------------------------
1612
1613     * Fixed FreeBSD bug.
1614
1615     * Added a simple man page.
1616
1617     * Switched to automake1.2f and a newer gettext.
1618
1619 Noteworthy changes in version 0.2.8
1620 -----------------------------------
1621
1622     * Changed the name to GNUPG, the binaries are called gpg and gpgm.
1623       You must rename rename the directory "~/.g10" to ~/.gnupg/, rename
1624       {pub,sec}ring.g10 to {pub,sec}ring.gpg, trustdb.g10 to trustdb.gpg
1625       and g10.sig to gnupg.sig.
1626
1627     * New or changed passphrases are now salted.
1628
1629
1630 Noteworthy changes in version 0.2.7
1631 -----------------------------------
1632
1633     * New command "gen-revoke" to create a key revocation certificate.
1634
1635     * New option "homedir" to set the homedir (which defaults to "~/.g10").
1636       This directory is created if it does not exists (only the last
1637       part of the name and not the complete hierarchy)
1638
1639     * Command "import" works. (Try: "finger gcrypt@ftp.guug.de|g10 --import")
1640
1641     * New commands "dearmor/enarmor" for g10maint.  These are mainly
1642       used for internal test purposes.
1643
1644     * Option --version now conforming to the GNU standards and lists
1645       the available ciphers, message digests and public key algorithms.
1646
1647     * Assembler code for m68k (not tested).
1648
1649     * "make check" works.
1650
1651 Noteworthy changes in version 0.2.6
1652 -----------------------------------
1653
1654     * Option "--export" works.
1655
1656
1657 Noteworthy changes in version 0.2.5
1658 -----------------------------------
1659
1660     * Added zlib for systems which don't have it.
1661       Use "./configure --with-zlib" to link with the static version.
1662
1663     * Generalized some more functions and rewrote the encoding of
1664       message digests into MPIs.
1665
1666     * Enhanced the checkit script
1667
1668
1669 Noteworthy changes in version 0.2.4
1670 -----------------------------------
1671
1672     * nearly doubled the speed of the ElGamal signature verification.
1673
1674     * backup copies of keyrings are created.
1675
1676     * assembler stuff for Pentium; gives about 15% better performance.
1677
1678     * fixed a lot of bugs.
1679
1680
1681 Noteworthy changes in version 0.2.3
1682 -----------------------------------
1683
1684     * Found a bug in the calculation of ELG fingerprints. This is now
1685       fixed, but all existing fingerprints and keyids for ELG keys
1686       are not any more valid.
1687
1688     * armor should now work; including clear signed text.
1689
1690     * moved some options to the new program g10maint
1691
1692     * It's now 64 bit clean and runs fine on an alpha--linux.
1693
1694     * Key generation is much faster now.  I fixed this by using not
1695       so strong random number for the primes (this was a bug because the
1696       ElGamal primes are public parameters and it does not make sense
1697       to generate them from strong random).  The real secret is the x value
1698       which is still generated from strong (okay: /dev/random) random bits.
1699
1700     * added option "--status-fd": see g10/OPTIONS
1701
1702     * We have secure memory on systems which support mlock().
1703       It is not complete yet, because we do not have signal handler
1704       which does a cleanup in very case.
1705       We should also check the ulimit for the user in the case
1706       that the admin does not have set a limit on locked pages.
1707
1708     * started with internationalization support.
1709
1710     * The logic to handle the web of trust is now implemented. It is
1711       has some bugs; but I'm going to change the algorithm anyway.
1712       It works by calculating the trustlevel on the fly.  It may ask
1713       you to provide trust parameters if the calculated trust probability
1714       is too low.  I will write a paper which discusses this new approach.
1715
1716     * a couple of changes to the configure script.
1717
1718     * New option "--quick-random" which uses a much quicker random
1719       number generator.  Keys generated while this option is in effect
1720       are flags with "INSECURE!" in the user-id.  This is a development
1721       only option.
1722
1723     * Read support for new version packets (OpenPGP).
1724
1725     * Comment packets are now of correct OpenPGP type 16. Old comment
1726       packets written by G10 are detected because they always start with
1727       a hash which is an invalid version byte.
1728
1729     * The string "(INSECURE!)" is appended to a new user-id if this
1730       is generated on a system without a good random number generator.
1731
1732
1733 Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004,
1734           2005 Free Software Foundation, Inc.
1735
1736 This file is free software; as a special exception the author gives
1737 unlimited permission to copy and/or distribute it, with or without
1738 modifications, as long as this notice is preserved.
1739
1740 This file is distributed in the hope that it will be useful, but
1741 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
1742 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.