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