Add item about GPG_ERR_CERT_REVOKED in verify status.
[gpgme.git] / NEWS
1 Noteworthy changes in version 0.9.0 (unreleased)
2 ------------------------------------------------
3
4  * The type gpgme_key_t has now a new field keylist_mode that contains
5    the keylist mode that was active at the time the key was retrieved.
6
7  * The type gpgme_decrypt_result_t has a new field "wrong_key_usage"
8    that contains a flag indicating that the key should not have been
9    used for encryption.
10
11  * Verifying a signature of a revoked key gives the correct result now
12    (GPG_ERR_CERT_REVOKED error code).
13
14 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 gpgme_key_t                     EXTENDED: New field keylist_mode.
16 gpgme_decrypt_result_t          EXTENDED: New field wrong_key_usage.
17 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
19
20 Noteworthy changes in version 0.4.7 (2004-04-29)
21 ------------------------------------------------
22
23  * Correctly initialize the fields expired, revoked, invalid, and
24    disabled in the gpgme_key_t structures.
25
26  * A bug fix: The flag wrong_key_usage of gpgme_signature_t was
27    accidently of type int instead unsigned int.
28
29  * Interface changes relative to the 0.4.5 release:
30 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31 gpgme_signature_t               CHANGED: wrong_key_usage is unsigned int now.
32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33
34 Noteworthy changes in version 0.4.6 (2004-04-06)
35 ------------------------------------------------
36
37  * Bug fixes
38
39
40 Noteworthy changes in version 0.4.5 (2004-03-07)
41 ------------------------------------------------
42
43  * GPGME is now compiled with LFS (large file support) by default.
44    This means that _all_ programs using GPGME must be compiled with
45    LFS support enabled by default.  You can do this easily with
46    autoconf, by using the AC_SYS_LARGEFILE macro.  Or you can do this
47    without autoconf by defining the preprocessor symbol
48    _FILE_OFFSET_BITS to 64 (by passing the -D_FILE_OFFSET_BITS=64 to
49    the C compiler command line, or by defining this preprocessor
50    symbol before including any system header files).  For more
51    details, read the section on LFS in the manual.
52
53    Up to now, it was undocumented that GPGME was not using LFS.
54    But the public interfaces use off_t, and file descriptors are
55    exchanged between the application and GPGME.  This was an oversight,
56    and bound to cause troubles in the future.
57
58    Writing GPGME as a dual mode library that seamlessly supports LFS
59    while keeping backwards compatibility is possible, but does not
60    solve the problem: Many applications already expect GPGME to have
61    LFS (they are compiled with off_t being a 64bit value).  This is true
62    in particular for the popular Gtk+ and Qt programs.
63
64    So, although this is an ABI (but not an API) break, we will not
65    change the library version to reflect that.  Because the interfaces
66    affected are probably not used yet in any GPGME 0.4 based
67    application, we don't expect any real failures from this change.
68    In fact, applications already using LFS will have some subtle bugs
69    fixed.
70
71    However, if you encounter an application using GPGME 0.4.x that
72    does _not_ use LFS by default (off_t is a 32bit value), _and_
73    uses at least one of the functions gpgme_data_seek,
74    gpgme_data_new_from_filepart, or a gpgme_data_seek_cb_t with
75    gpgme_data_new_from_cbs, then indeed this library will be ABI
76    incompatible with the program.  As said above, we don't believe
77    such a program exists.  If we are in error, then you have two
78    options: As a quick hack, you can configure GPGME with the
79    --disable-largefile option.  This will revert the change, and GPGME
80    will not use LFS.  However, GPGME will be incompatible with
81    programs that expect GPGME to use LFS.  All applications are
82    required to use LFS when using GPGME, so this is only good as a
83    temporary local work-around.
84
85    The other option is to change the versioning of the library and
86    recompile all applications.  We have reserved a special version of
87    the library for that, so you can do that without expecting a
88    version clash in the future.  Furthermore, everyone who does this
89    will agree on the version to use (this is important for
90    distribution makers).  Read the comment in configure.ac (before
91    LIBGPGME_LT_AGE) if you want to do this.  Please don't do this
92    blindly: As stated above, we think it is unlikely this measure is
93    needed.  Still, it is there if necessary.  If in doubt, contact us
94    and we will give our advise for your specific situation.
95
96  * New key listing mode GPGME_KEYLIST_MODE_VALIDATE for validation of
97    the listed keys.
98
99  * New interface gpgme_cancel() that can be used to cancel
100    asynchronous operations.
101
102  * Interface changes relative to the 0.4.4 release:
103 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
104 gpgme_data_seek_cb_t            CHANGED: off_t is now a largefile type.
105 gpgme_data_seek                 CHANGED: off_t is now a largefile type.
106 gpgme_data_new_from_filepart    CHANGED: off_t is now a largefile type.
107 GPGME_KEYLIST_MODE_VALIDATE     NEW
108 gpgme_cancel                    NEW
109 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
110
111 Noteworthy changes in version 0.4.4 (2004-01-12)
112 ------------------------------------------------
113
114  * The member "class" in gpgme_key_sig_t and gpgme_new_signature_t has
115    been renamed to "sig_class", to avoid clash with C++ compilers.  In
116    the C API, the old name "class" has been preserved for backwards
117    compatibility, but is deprecated.
118
119  * Interface changes relative to the 0.4.3 release:
120 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
121 gpgme_key_sig_t                 CHANGED: class deprecated, use new sig_class.
122 gpgme_new_signature_t           CHANGED: class deprecated, use new sig_class.
123 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
124
125 Noteworthy changes in version 0.4.3 (2003-10-06)
126 ------------------------------------------------
127
128  * libgpgme should not be used for threaded programs anymore.  This
129    never worked reliably in all cases, because you had to
130    be careful about the linking order and libtool wouldn't do that for
131    you automatically.  Instead, now you have to link against
132    libgpgme-pthread for applications using pthread and libgpgme-pth for
133    applications using GNU Pth.
134
135    The old code for automagically detecting the thread library is
136    still part of libgpgme, but it is DEPRECATED.
137
138  * There are new automake macros AM_PATH_GPGME_PTH and
139    AM_PATH_GPGME_PTHREAD, which support checking for thread-enabled
140    versions of GPGME.  They define GPGME_PTH_CFLAGS, GPGME_PTH_LIBS,
141    GPGME_PTHREAD_CFLAGS and GPGME_PTHREAD_LIBS respectively.  These
142    variables of course also include the configuration for the thread
143    package itself.  Alternatively, use libtool.
144
145  * gpgme_strerror_r as a thread safe variant of gpgme_strerror was
146    added.
147
148  * gpgme-config doesn't support setting the prefix or exec prefix
149    anymore.  I don't think it ever worked correctly, and it seems to
150    be pointless.
151
152  * gpgme_get_key fails with GPG_ERR_AMBIGUOUS_NAME if the key ID
153    provided was not unique, instead returning the first matching key.
154
155  * gpgme_key_t and gpgme_subkey_t have a new field, can_authenticate,
156    that indicates if the key can be used for authentication.
157
158  * gpgme_signature_t's status field is now correctly set to an error
159    with error code GPG_ERR_NO_PUBKEY if public key is not found.
160
161  * gpgme_new_signature_t's class field is now an unsigned int, rather
162    than an unsigned long (the old class field is preserved for
163    backwards compatibility).
164
165  * A new function gpgme_set_locale() is provided to allow configuring
166    the locale for the crypto backend.  This is necessary for text
167    terminals so that programs like the pinentry can be started with
168    the right locale settings for the terminal the application is running
169    on, in case the terminal has different settings than the system
170    default (for example, if it is a remote terminal).  You are highly
171    recommended to call the following functions directly after
172    gpgme_check_version:
173
174    #include <locale.h>
175
176    setlocale (LC_ALL, "");
177    gpgme_set_locale (NULL, LC_CTYPE, setlocale (LC_CTYPE, NULL));
178    gpgme_set_locale (NULL, LC_MESSAGES, setlocale (LC_MESSAGES, NULL));
179
180    GPGME can not do this for you, as setlocale is not thread safe, and
181    there is no alternative.
182
183  * The signal action for SIGPIPE is now set to SIG_IGN by
184    gpgme_check_version, instead the first time a crypto engine is
185    started (which is not well defined).
186
187  * In the output of gpgme_hash_algo_name, change RMD160 to RIPEMD160,
188    TIGER to TIGER192, CRC32-RFC1510 to CRC32RFC1510, and CRC24-RFC2440
189    to CRC24RFC2440.  For now, these strings can be used as the MIC
190    parameter for PGP/MIME (if appropriately modified).
191
192  * Interface changes relative to the 0.4.2 release:
193 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
194 gpgme_strerror_t                NEW
195 gpgme_get_key                   CHANGED: Fails correctly if key ID not unique.
196 gpgme_key_t                     EXTENDED: New field can_authenticate.
197 gpgme_subkey_t                  EXTENDED: New field can_authenticate.
198 gpgme_new_signature_t           CHANGED: New type for class field.
199 gpgme_set_locale                NEW
200 gpgme_hash_algo_name            CHANGED: Slight adjustment of algo names.
201 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
202
203 Noteworthy changes in version 0.4.2 (2003-07-30)
204 ------------------------------------------------
205
206  * Allow gpg-error to be in non-standard place when linking the test suite.
207
208  * Configure will fail now if gpg-error can not be found.
209
210  * Fixed initialized memory backed data objects for writing, which
211    caused the test program to crash (but only on Mac OS, surprisingly).
212
213  * Eliminate use of C99 constructs.
214
215  * Small improvements to the manual.
216
217
218 Noteworthy changes in version 0.4.1 (2003-06-06)
219 ------------------------------------------------
220
221  This is the release that 0.4.0 should have been.  There are many
222  interface changes, please see below for the details.  The changes are
223  sometimes the result of new functionality, but more often express a
224  paradigm shift.  Others are an overdue cleanup to get GPGME in line
225  with the GNU coding standards and to make the interface more
226  self-consistent.  Here is an overview on the changes:
227
228  All types have been renamed to conform to the GNU coding standards,
229  most of the time by keeping the whole name in lowercase and inserting
230  underscores between words.
231
232  All operations consistently only accept input parameters in their
233  invocation function, and return only an error code directly.  Further
234  information about the result of the operation has to be retrieved
235  afterwards by calling one of the result functions.  This unifies the
236  synchronous and the asynchronous interface.
237
238  The error values have been completely replaced by a more
239  sophisticated model that allows GPGME to transparently and accurately
240  report all errors from the other GnuPG components, irregardless of
241  process boundaries.  This is achieved by using the library
242  libgpg-errors, which is shared by all GnuPG components.  This library
243  is now required for GPGME.
244
245  The results of all operations are now provided by pointers to C
246  structs rather than by XML structs or in other ways.
247
248  Objects which used to be opaque (for example a key) are now pointers
249  to accessible structs, so no accessor functions are necessary.
250
251  Backward compatibility is provided where it was possible without too
252  much effort and did not collide with the overall sanitization effort.
253  However, this is only for ease of transition.  NO DEPRECATED FUNCTION
254  OR DATA TYPE IS CONSIDERED A PART OF THE API OR ABI AND WILL BE
255  DROPPED IN THE FUTURE WITHOUT CHANGING THE SONAME OF THE LIBRARY.
256  Recommendations how to replace deprecated or removed functionality
257  can be found within the description of each change.
258
259  What follows are all changes to the interface and behaviour of GPGME
260  in detail.
261
262  * If gpgme.h is included in sources compiled by GCC 3.1 or later,
263    deprecated attributes will warn about use of obsolete functions and
264    type definitions.  You can suppress these warnings by passing
265    -Wno-deprecated-declarations to the gcc command.
266
267  * The following types have been renamed.  The old types are still
268    available as aliases, but they are deprecated now:
269    Old name:            New name:
270    GpgmeCtx             gpgme_ctx_t
271    GpgmeData            gpgme_data_t
272    GpgmeError           gpgme_error_t
273    GpgmeDataEncoding    gpgme_data_encoding_t
274    GpgmeSigStat         gpgme_sig_stat_t
275    GpgmeSigMode         gpgme_sig_mode_t
276    GpgmeAttr            gpgme_attr_t
277    GpgmeValidity        gpgme_validity_t
278    GpgmeProtocol        gpgme_protocol_t
279    GpgmeKey             gpgme_key_t
280    GpgmePassphraseCb    gpgme_passphrase_cb_t
281    GpgmeProgressCb      gpgme_progress_cb_t
282    GpgmeIOCb            gpgme_io_cb_t
283    GpgmeRegisterIOCb    gpgme_register_io_cb_t
284    GpgmeRemoveIOCb      gpgme_remove_io_cb_t
285    GpgmeEventIO         gpgme_event_io_t
286    GpgmeEventIOCb       gpgme_event_io_cb_t
287    GpgmeIOCbs           gpgme_io_cbs
288    GpgmeDataReadCb      gpgme_data_read_cb_t
289    GpgmeDataWriteCb     gpgme_data_write_cb_t
290    GpgmeDataSeekCb      gpgme_data_seek_cb_t
291    GpgmeDataReleaseCb   gpgme_data_release_cb_t
292    GpgmeDataCbs         gpgme_data_cbs_t
293    GpgmeTrustItem       gpgme_trust_item_t
294    GpgmeStatusCode      gpgme_status_code_t
295
296  * gpgme_error_t is now identical to gpg_error_t, the error type
297    provided by libgpg-error.  More about using libgpg-error with GPGME
298    can be found in the manual.  All error symbols have been removed!
299
300  * All functions and types in libgpg-error have been wrapped in GPGME.
301    The new types are gpgme_err_code_t and gpgme_err_source_t.  The new
302    functions are gpgme_err_code, gpgme_err_source, gpgme_error,
303    gpgme_err_make, gpgme_error_from_errno, gpgme_err_make_from_errno,
304    gpgme_err_code_from_errno, gpgme_err_code_to_errno,
305    gpgme_strsource.
306
307  * GPGME_ATTR_IS_SECRET is not anymore representable as a string.
308
309  * GnuPG 1.2.2 is required.  The progress callback is now also invoked
310    for encrypt, sign, encrypt-sign, decrypt, verify, and
311    decrypt-verify operations.  For verify operations on detached
312    signatures, the progress callback is invoked for both the detached
313    signature and the plaintext message, though.
314
315  * gpgme_passphrase_cb_t has been changed to not provide a complete
316    description, but the UID hint, passphrase info and a flag
317    indicating if this is a repeated attempt individually, so the user
318    can compose his own description from this information.
319
320    The passphrase is not returned as a C string, but must be written
321    to a file descriptor directly.  This allows for secure passphrase
322    entries.
323
324    The return type has been changed to gpgme_error_t value.  This
325    allowed to remove the gpgme_cancel function; just return
326    the error code GPG_ERR_CANCELED in the passphrase callback directly.
327
328  * gpgme_edit_cb_t has been changed to take a file descriptor argument.
329    The user is expected to write the response to the file descriptor,
330    followed by a newline.
331
332  * The recipients interface has been removed.  Instead, you use
333    NULL-terminated lists of keys for specifying the recipients of an
334    encryption operation.  Use the new encryption flag
335    GPGME_ENCRYPT_ALWAYS_TRUST if you want to override the validity of
336    the keys (but note that in general this is not a good idea).
337
338    This change has been made to the prototypes of gpgme_op_encrypt,
339    gpgme_op_encrypt_start, gpgme_op_encrypt_sign and
340    gpgme_op_encrypt_sign_start.
341
342    The export interface has been changed to use pattern strings like
343    the keylist interface.  Thus, new functions gpgme_op_export_ext and
344    gpgme_op_export_ext_start have been added as well.  Now the
345    prototypes of gpgme_op_export_start and gpgme_op_export finally
346    make sense.
347
348  * gpgme_op_verify and gpgme_op_decrypt_verify don't return a status
349    summary anymore.  Use gpgme_get_sig_status to retrieve the individual
350    stati.
351
352  * gpgme_io_cb_t changed from a void function to a function returning
353    a gpgme_error_t value.  However, it will always return 0, so you
354    can safely ignore the return value.
355
356  * A new I/O callback event GPGME_EVENT_START has been added.  The new
357    requirement is that you must wait until this event until you are
358    allowed to call the I/O callback handlers previously registered for
359    this context operation.  Calling I/O callback functions for this
360    context operation before the start event happened is unsafe because
361    it can lead to race conditions in a multi-threaded environment.
362
363  * The idle function feature has been removed.  It was not precisely
364    defined in a multi-threaded environment and is obsoleted by the
365    user I/O callback functions.  If you still need a simple way to
366    call something while waiting on one or multiple asynchronous
367    operations to complete, don't set the HANG flag in gpgme_wait (note
368    that this will return to your program more often than the idle
369    function did).
370
371  * gpgme_wait can return NULL even if hang is true, if an error
372    occurs.  In that case *status contains the error code.
373
374  * gpgme_get_engine_info was radically changed.  Instead an XML
375    string, an info structure of the new type gpgme_engine_info_t is
376    returned.  This makes it easier and more robust to evaluate the
377    information in an application.
378
379  * The new function gpgme_get_protocol_name can be used to convert a
380    gpgme_protocol_t value into a string.
381
382  * The status of a context operation is not checked anymore.  Starting
383    a new operation will silently cancel the previous one.  Calling a
384    function that requires you to have started an operation before without
385    doing so is undefined.
386
387  * The FPR argument to gpgme_op_genkey was removed.  Instead, use the
388    gpgme_op_genkey_result function to retrieve a gpgme_genkey_result_t
389    pointer to a structure which contains the fingerprint.  This also
390    works with gpgme_op_genkey_start.  The structure also provides
391    other information about the generated keys.
392
393    So, instead:
394
395    char *fpr;
396    err = gpgme_op_genkey (ctx, NULL, NULL, &fpr); 
397    if (!err && fpr)
398      printf ("%s\n", fpr);
399
400    you should now do:
401
402    gpgme_genkey_result_t result;
403    err = gpgme_op_genkey (ctx, NULL, NULL);
404    if (!err)
405      {
406        result = gpgme_op_genkey_result (ctx);
407        if (result->fpr)
408          printf ("%s\n", result->fpr);
409      }
410
411  * The new gpgme_op_import_result function provides detailed
412    information about the result of an import operation in
413    gpgme_import_result_t and gpgme_import_status_t objects.
414    Thus, the gpgme_op_import_ext variant is deprecated.
415
416  * The new gpgme_op_sign_result function provides detailed information
417    about the result of a signing operation in gpgme_sign_result_t,
418    gpgme_invalid_key_t and gpgme_new_signature_t objects.
419
420  * The new gpgme_op_encrypt_result function provides detailed
421    information about the result of an encryption operation in
422    a GpgmeEncryptResult object.
423
424  * The new gpgme_op_decrypt_result function provides detailed
425    information about the result of a decryption operation in
426    a GpgmeDecryptResult object.
427
428  * The new gpgme_op_verify_result function provides detailed
429    information about the result of an verify operation in
430    a GpgmeVerifyResult object.  Because of this, the GPGME_SIG_STAT_*
431    values, gpgme_get_sig_status, gpgme_get_sig_ulong_attr,
432    gpgme_get_sig_string_attr and gpgme_get_sig_key are now deprecated,
433    and gpgme_get_notation is removed.
434
435  * GpgmeTrustItem objects have now directly accessible data, so the
436    gpgme_trust_item_get_string_attr and gpgme_trust_item_get_ulong_attr
437    accessor functions are deprecated.  Also, reference counting is
438    available through gpgme_trust_item_ref and gpgme_trust_item_unref
439    (the gpgme_trust_item_release alias for the latter is deprecated).
440
441  * Keys are not cached internally anymore, so the force_update argument
442    to gpgme_get_key has been removed.
443
444  * GpgmeKey objects have now directly accessible data so the
445    gpgme_key_get_string_attr, gpgme_key_get_ulong_attr,
446    gpgme_key_sig_get_string_attr and gpgme_key_sig_get_ulong_attr
447    functions are deprecated.  Also, gpgme_key_release is now
448    deprecated.  The gpgme_key_get_as_xml function has been dropped.
449
450  * Because all interfaces using attributes are deprecated, the
451    GpgmeAttr data type is also deprecated.
452
453  * The new gpgme_op_keylist_result function provides detailed
454    information about the result of a key listing operation in
455    a GpgmeKeyListResult object.
456
457  * Now that each function comes with its own result retrieval
458    interface, the generic gpgme_get_op_info interface is not useful
459    anymore and dropped.
460
461  * The type and mode of data objects is not available anymore.
462
463  * Interface changes relative to the 0.4.0 release:
464 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
465 GpgmeCtx                        DEPRECATED: Use gpgme_ctx_t.
466 GpgmeData                       DEPRECATED: Use gpgme_data_t.
467 GpgmeError                      DEPRECATED: Use gpgme_error_t.
468 GpgmeDataEncoding               DEPRECATED: Use gpgme_data_encoding_t.
469 GpgmeSigStat                    DEPRECATED: Use gpgme_sig_stat_t.
470 GpgmeSigMode                    DEPRECATED: Use gpgme_sig_mode_t.
471 GpgmeAttr                       DEPRECATED: Use gpgme_attr_t.
472 GpgmeValidity                   DEPRECATED: Use gpgme_validity_t.
473 GpgmeProtocol                   DEPRECATED: Use gpgme_protocol_t.
474 GpgmeKey                        DEPRECATED: Use gpgme_key_t.
475 GpgmePassphraseCb               DEPRECATED: Use gpgme_passphrase_cb_t.
476 GpgmeProgressCb                 DEPRECATED: Use gpgme_progress_cb_t.
477 GpgmeIOCb                       DEPRECATED: Use gpgme_io_cb_t.
478 GpgmeRegisterIOCb               DEPRECATED: Use gpgme_register_io_cb_t.
479 GpgmeRemoveIOCb                 DEPRECATED: Use gpgme_remove_io_cb_t.
480 GpgmeEventIO                    DEPRECATED: Use gpgme_event_io_t.
481 GpgmeEventIOCb                  DEPRECATED: Use gpgme_event_io_cb_t.
482 GpgmeIOCbs                      DEPRECATED: Use gpgme_io_cbs.
483 GpgmeDataReadCb                 DEPRECATED: Use gpgme_data_read_cb_t.
484 GpgmeDataWriteCb                DEPRECATED: Use gpgme_data_write_cb_t.
485 GpgmeDataSeekCb                 DEPRECATED: Use gpgme_data_seek_cb_t.
486 GpgmeDataReleaseCb              DEPRECATED: Use gpgme_data_release_cb_t.
487 GpgmeDataCbs                    DEPRECATED: Use gpgme_data_cbs_t.
488 GpgmeTrustItem                  DEPRECATED: Use gpgme_trust_item_t.
489 GpgmeStatusCode                 DEPRECATED: Use gpgme_status_code_t.
490 gpgme_ctx_t                     NEW
491 gpgme_data_t                    NEW
492 gpgme_recipients_t              NEW
493 gpgme_error_t                   NEW
494 gpgme_data_encoding_t           NEW
495 gpgme_sig_stat_t                NEW
496 gpgme_sig_mode_t                NEW
497 gpgme_attr_t                    NEW
498 gpgme_validity_t                NEW
499 gpgme_protocol_t                NEW
500 gpgme_key_t                     NEW
501 gpgme_passphrase_cb_t           NEW
502 gpgme_progress_cb_t             NEW
503 gpgme_io_cb_t                   NEW
504 gpgme_register_io_cb_t          NEW
505 gpgme_remove_io_cb_t            NEW
506 gpgme_event_io_t                NEW
507 gpgme_event_io_cb_t             NEW
508 gpgme_io_cbs                    NEW
509 gpgme_data_read_cb_t            NEW
510 gpgme_data_write_cb_t           NEW
511 gpgme_data_seek_cb_t            NEW
512 gpgme_data_release_cb_t         NEW
513 gpgme_data_cbs_t                NEW
514 gpgme_trust_item_t              NEW
515 gpgme_status_code_t             NEW
516 GPGME_{some error code}         REMOVED! Use GPG_ERR_* from libgpg-error.
517 gpgme_err_code_t                NEW
518 gpgme_err_source_t              NEW
519 gpgme_err_code                  NEW
520 gpgme_err_source                NEW
521 gpgme_error                     NEW
522 gpgme_err_make                  NEW
523 gpgme_error_from_errno          NEW
524 gpgme_err_make_from_errno       NEW
525 gpgme_err_code_from_errno       NEW
526 gpgme_err_code_to_errno         NEW
527 gpgme_strsource                 NEW
528 gpgme_io_cb_t                   CHANGED: Return type from void to GpgmeError.
529 gpgme_event_io_t                CHANGED: New event type (all numbers changed).
530 gpgme_passphrase_cb_t           CHANGED: Desc decomposed, write directly to FD.
531 gpgme_edit_cb_t                 CHANGED: Write directly to FD.
532 gpgme_key_get_string_attr       CHANGED: Don't handle GPGME_ATTR_IS_SECRET.
533 gpgme_op_verify                 CHANGED: Drop R_STAT argument.
534 gpgme_op_decrypt_verify         CHANGED: Drop R_STAT argument.
535 gpgme_wait                      CHANGED: Can return NULL even if hang is true.
536 GpgmeIdleFunc                   REMOVED
537 gpgme_register_idle             REMOVED
538 GpgmeRecipients                 REMOVED
539 gpgme_recipients_new            REMOVED
540 gpgme_recipients_release        REMOVED
541 gpgme_recipients_add_name       REMOVED
542 gpgme_recipients_add_name_with_validity REMOVED
543 gpgme_recipients_count          REMOVED
544 gpgme_recipients_enum_open      REMOVED
545 gpgme_recipients_enum_read      REMOVED
546 gpgme_recipients_enum_close     REMOVED
547 gpgme_encrypt_flags_t           NEW
548 GPGME_ENCRYPT_ALWAYS_TRUST      NEW
549 gpgme_op_encrypt                CHANGED: Recipients passed as gpgme_key_t[].
550 gpgme_op_encrypt_start          CHANGED: Recipients passed as gpgme_key_t[].
551 gpgme_op_encrypt_sign           CHANGED: Recipients passed as gpgme_key_t[].
552 gpgme_op_encrypt_sign_start     CHANGED: Recipients passed as gpgme_key_t[].
553 gpgme_op_export_start           CHANGED: User IDs passed as patterns.
554 gpgme_op_export                 CHANGED: User IDs passed as patterns.
555 gpgme_op_export_ext_start       NEW
556 gpgme_op_export_ext             NEW
557 gpgme_keylist_mode_t            NEW
558 gpgme_sigsum_t                  NEW
559 gpgme_engine_info_t             NEW
560 gpgme_get_engine_info           CHANGED: Return info structure instead XML.
561 gpgme_get_protocol_name         NEW
562 gpgme_cancel                    REMOVED: Return error in callback directly.
563 gpgme_op_genkey                 CHANGED: FPR argument dropped.
564 gpgme_op_genkey_result          NEW
565 gpgme_genkey_result_t           NEW
566 gpgme_op_import_ext             DEPRECATED: Use gpgme_op_import_result.
567 gpgme_op_import_result          NEW
568 gpgme_import_status_t           NEW
569 gpgme_import_result_t           NEW
570 gpgme_pubkey_algo_t             NEW
571 gpgme_hash_algo_t               NEW
572 gpgme_invalid_key_t             NEW
573 gpgme_new_signature_t           NEW
574 gpgme_sign_result_t             NEW
575 gpgme_op_sign_result            NEW
576 gpgme_pubkey_algo_name          NEW
577 gpgme_hash_algo_name            NEW
578 gpgme_encrypt_result_t          NEW
579 gpgme_op_encrypt_result         NEW
580 gpgme_decrypt_result_t          NEW
581 gpgme_op_decrypt_result         NEW
582 gpgme_verify_result_t           NEW
583 gpgme_op_verify_result          NEW
584 gpgme_get_notation              REMOVED: Access verify result directly instead.
585 gpgme_get_sig_key               DEPRECATED: Use gpgme_get_key with fingerprint.
586 gpgme_get_sig_ulong_attr        DEPRECATED: Use verify result directly.
587 gpgme_get_sig_string_attr       DEPRECATED: Use verify result directly.
588 GPGME_SIG_STAT_*                DEPRECATED: Use error value in sig status.
589 gpgme_get_sig_status            DEPRECATED: Use verify result directly.
590 gpgme_trust_item_t              CHANGED: Now has user accessible data members.
591 gpgme_trust_item_ref            NEW
592 gpgme_trust_item_unref          NEW
593 gpgme_trust_item_release        DEPRECATED: Use gpgme_trust_item_unref.
594 gpgme_trust_item_get_string_attr DEPRECATED
595 gpgme_trust_item_get_ulong_attr DEPRECATED
596 gpgme_get_key                   CHANGED: Removed force_update argument.
597 gpgme_sub_key_t                 NEW
598 gpgme_key_sig_t                 NEW
599 gpgme_user_id_t                 NEW
600 gpgme_key_t                     CHANGED: Now has user accessible data members.
601 gpgme_key_get_string_attr       DEPRECATED
602 gpgme_key_get_ulong_attr        DEPRECATED
603 gpgme_key_sig_get_string_attr   DEPRECATED
604 gpgme_key_sig_get_ulong_attr    DEPRECATED
605 gpgme_key_get_as_xml            REMOVED
606 gpgme_key_list_result_t         NEW
607 gpgme_op_keylist_result         NEW
608 gpgme_get_op_info               REMOVED
609 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
610
611 Noteworthy changes in version 0.4.0 (2002-12-23)
612 ------------------------------------------------
613
614  * Key generation returns the fingerprint of the generated key.
615
616  * New convenience function gpgme_get_key.
617
618  * Supports signatures of user IDs in keys via the new
619    GPGME_KEYLIST_MODE_SIGS keylist mode and the
620    gpgme_key_sig_get_string_attr and gpgme_key_sig_get_ulong_attr
621    interfaces.  The XML info about a key also includes the signatures
622    if available.
623
624  * New data object interface, which is more flexible and transparent.
625
626  * Interface changes relative to the 0.3.9 release:
627 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
628 GpgmeDataReadCb                 NEW
629 GpgmeDataWriteCb                NEW
630 GpgmeDataSeekCb                 NEW
631 GpgmeDataReleaseCb              NEW
632 GpgmeDataCbs                    NEW
633 gpgme_data_read                 CHANGED: Match read() closely.
634 gpgme_data_write                CHANGED: Match write() closely.
635 gpgme_data_seek                 NEW
636 gpgme_data_new_from_fd          NEW
637 gpgme_data_new_from_stream      NEW
638 gpgme_data_new_from_cbs         NEW
639 gpgme_data_rewind               DEPRECATED: Replaced by gpgme_data_seek().
640 gpgme_data_new_from_read_cb     DEPRECATED: Replaced by gpgme_data_from_cbs().
641 gpgme_data_get_type             REMOVED: No replacement.
642 gpgme_op_verify                 CHANGED: Take different data objects for
643                                 signed text and plain text.
644 gpgme_op_verify_start           CHANGED: See gpgme_op_verify.
645 gpgme_check_engine              REMOVED: Deprecated since 0.3.0.
646 gpgme_op_genkey                 CHANGED: New parameter FPR.
647 GPGME_KEYLIST_MODE_SIGS         NEW
648 gpgme_key_sig_get_string_attr   NEW
649 gpgme_key_sig_get_ulong_attr    NEW
650 gpgme_get_key                   NEW
651 GPGME_ATTR_SIG_CLASS            NEW
652 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
653
654 Noteworthy changes in version 0.3.15 (2003-02-18)
655 -------------------------------------------------
656
657  * The progress status is sent via the progress callbacks in
658    gpgme_op_edit.
659
660  * Bug fix for signing operations with explicit signer settings for
661    the CMS protocol.
662
663 Noteworthy changes in version 0.3.14 (2002-12-04)
664 -------------------------------------------------
665
666  * GPGME-Plug is now in its own package "cryptplug".
667
668  * Workaround for a setlocale problem.  Fixed a segv related to not
669    correctly as closed marked file descriptors.
670
671 Noteworthy changes in version 0.3.13 (2002-11-20)
672 -------------------------------------------------
673
674  * Release due to changes in gpgmeplug.
675
676 Noteworthy changes in version 0.3.12 (2002-10-15)
677 -------------------------------------------------
678
679  * Fixed some bux with key listings.  
680
681  * The development has been branched to clean up some API issues.
682    This 0.3 series will be kept for compatibility reasons; so do don't
683    expect new features.
684
685 Noteworthy changes in version 0.3.11 (2002-09-20)
686 -------------------------------------------------
687         
688  * Bug fixes.
689
690 Noteworthy changes in version 0.3.10 (2002-09-02)
691 -------------------------------------------------
692
693  * Setting the signing keys for the CMS protocol does now work.
694
695  * The signers setting is honoured by gpgme_op_edit.
696
697 Noteworthy changes in version 0.3.9 (2002-08-21)
698 ------------------------------------------------
699
700  * A spec file for creating RPMs has been added.
701
702  * An experimental interface to GnuPG's --edit-key functionality is
703    introduced, see gpgme_op_edit.
704
705  * The new gpgme_import_ext function provides a convenient access to
706    the number of processed keys.
707
708  * Interface changes relative to the 0.3.8 release:
709 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
710 GpgmeStatusCode                 NEW
711 GpgmeEditCb                     NEW
712 gpgme_op_edit_start             NEW
713 gpgme_op_edit                   NEW
714 gpgme_op_import_ext             NEW
715 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
716
717 Noteworthy changes in version 0.3.8 (2002-06-25)
718 ------------------------------------------------
719
720  * It is possible to use an outside event loop for the I/O to the
721    crypto engine by setting the I/O callbacks with gpgme_set_io_cbs.
722
723  * Interface changes relative to the 0.3.6 release:
724 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
725 GpgmeIOCb                       NEW
726 GpgmeRegisterIOCb               NEW
727 GpgmeRemoveIOCb                 NEW
728 GpgmeEventIO                    NEW
729 GpgmeEventIOCb                  NEW
730 struct GpgmeIOCbs               NEW
731 gpgme_set_io_cbs                NEW
732 gpgme_get_io_cbs                NEW
733 GPGME_ATTR_ERRTOK               NEW
734 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
735
736 Noteworthy changes in version 0.3.7 (2002-06-04)
737 ------------------------------------------------
738
739  * GPGME_ATTR_OTRUST is implemented now.
740
741  * A first step toward thread safeness has been achieved, see the
742    documentation for details.  Supported thread libraries are pthread
743    and Pth.
744
745 Noteworthy changes in version 0.3.6 (2002-05-03)
746 ------------------------------------------------
747
748  * All error output of the gpgsm backend is send to the bit bucket.
749
750  * The signature verification functions are extended.  Instead of
751    always returning GPGME_SIG_STATUS_GOOD, the functions new codes for
752    expired signatures.  2 new functions may be used to retrieve more
753    detailed information like the signature expiration time and a
754    validity information of the key without an extra key looking.
755
756  * The current passphrase callback and progress meter callback can be
757    retrieved with the new functions gpgme_get_passphrase_cb and
758    gpgme_get_progress_cb respectively.
759
760  * Interface changes relative to the 0.3.5 release:
761 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
762 gpgme_get_passphrase_cb         NEW
763 gpgme_get_progress_cb           NEW
764 GpgmeDataEncoding               NEW
765 gpgme_data_set_encoding         NEW
766 gpgme_data_get_encoding         NEW
767 GPGME_SIG_STAT_GOOD_EXP         NEW
768 GPGME_SIG_STAT_GOOD_EXPKEY      NEW
769 gpgme_op_verify                 CHANGED: Returns more status codes.
770 GPGME_ATTR_SIG_STATUS           NEW
771 gpgme_get_sig_string_attr       NEW
772 gpgme_get_sig_ulong_attr        NEW
773 gpgme_get_protocol              NEW
774 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
775
776 Noteworthy changes in version 0.3.5 (2002-04-01)
777 ------------------------------------------------
778
779  * gpgme_op_encrypt can be called with RECIPIENTS being 0.  In this
780    case, symmetric encryption is performed.  Note that this requires a
781    passphrase from the user.
782
783  * More information is returned for X.509 certificates.
784
785  * Interface changes relative to the 0.3.4 release:
786 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
787 gpgme_op_encrypt                EXTENDED: Symmetric encryption possible
788 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
789
790 Noteworthy changes in version 0.3.4 (2002-03-04)
791 ------------------------------------------------
792
793  * gpgme_op_encrypt does now fail with GPGME_Invalid_Recipients if
794    some recipients have been invalid, whereas earlier versions
795    succeeded in this case.  The plaintext is still encrypted for all valid
796    recipients, so the application might take this error as a hint that
797    the ciphertext is not usable for all requested recipients.
798    Information about invalid recipients is available with gpgme_get_op_info.
799
800  * gpgme_op_verify now allows to pass an uninitialized data object as
801    its plaintext argument to check for normal and cleartext
802    signatures.  The plaintext is then returned in the data object.
803
804  * New interfaces gpgme_set_include_certs and gpgme_get_include_certs
805    to set and get the number of certifications to include in S/MIME
806    signed messages.
807
808  * New interfaces gpgme_op_encrypt_sign and gpgme_op_encrypt_sign_start
809    to encrypt and sign a message in a combined operation.
810
811  * New interface gpgme_op_keylist_ext_start to search for multiple patterns.
812
813  * gpgme_key_get_ulong_attr supports the GPGME_ATTR_EXPIRE attribute.
814
815  * Interface changes relative to the 0.3.3 release:
816 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
817 gpgme_op_encrypt                CHANGED: Can fail with GPGME_Invalid_Recipients
818 gpgme_op_verify                 EXTENDED: Accepts uninitialized text argument
819 gpgme_key_get_ulong_attr        EXTENDED: Supports GPGME_ATTR_EXPIRE
820 gpgme_set_include_certs         NEW
821 gpgme_get_include_certs         NEW
822 gpgme_op_encrypt_sign           NEW
823 gpgme_op_encrypt_sign_start     NEW
824 gpgme_op_keylist_ext_start      NEW
825 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
826
827 Noteworthy changes in version 0.3.3 (2002-02-12)
828 ------------------------------------------------
829
830  * Fix the Makefile in jnlib.
831
832  * Fix the test suite (hopefully).  It should clean up all its state
833    with `make check' now.
834
835
836 Noteworthy changes in version 0.3.2 (2002-02-10)
837 ------------------------------------------------
838
839  * Remove erroneous dependency on libgcrypt in jnlib.
840
841
842 Noteworthy changes in version 0.3.1 (2002-02-09)
843 ------------------------------------------------
844
845  * There is a Texinfo manual documenting the API.
846
847  * The gpgme_set_keylist_mode function returns an error, and changed
848    its meaning.  It is no longer usable to select between normal and
849    fast mode (newer versions of GnuPG will always be fast), but
850    selects between local keyring, remote keyserver, or both.
851    For this, two new macros are defined, GPGME_KEYLIST_MODE_LOCAL
852    and GPGME_KEYLIST_MODE_EXTERN.  To make it possible to modify the
853    current setting, a fucntion gpgme_get_keylist_mode was added to
854    retrieve the current mode.
855
856  * gpgme_wait accepts a new argument STATUS to return the error status
857    of the operation on the context.  Its definition is closer to
858    waitpid() now than before.
859
860  * The LENGTH argument to gpgme_data_new_from_filepart changed its
861    type from off_t to the unsigned size_t.
862
863  * The R_HD argument to the GpgmePassphraseCb type changed its type
864    from void* to void**.
865
866  * New interface gpgme_op_trustlist_end() to match
867    gpgme_op_keylist_end().
868
869  * The CryptPlug modules have been renamed to gpgme-openpgp and
870    gpgme-smime, and they are installed in pkglibdir by `make install'.
871
872  * An idle function can be registered with gpgme_register_idle().
873
874  * The GpgSM backend supports key generation with gpgme_op_genkey().
875
876  * Interface changes relative to the 0.3.0 release:
877 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
878 gpgme_data_new_from_filepart    CHANGED: Type of LENGTH is size_t.
879 GpgmePassphraseCb               CHANGED: Type of R_HD is void **.
880 gpgme_wait                      CHANGED: New argument STATUS.
881 gpgme_set_keylist_mode          CHANGED: Type of return value is GpgmeError.
882                                 The function has a new meaning!
883 gpgme_get_keylist_mode          NEW
884 GPGME_KEYLIST_MODE_LOCAL        NEW
885 GPGME_KEYLIST_MODE_EXTERN       NEW
886 gpgme_op_trustlist_next         NEW
887 GpgmeIdleFunc                   NEW
888 gpgme_register_idle             NEW
889 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
890
891 Noteworthy changes in version 0.3.0 (2001-12-19)
892 ------------------------------------------------
893  
894  * New interface gpgme_set_protocol() to set the protocol and thus the
895    crypto engine to be used by the context.  Currently, the OpenPGP
896    and the CMS protocols are supported.  They are specified by the new
897    preprocessor symbols GPGME_PROTOCOL_OpenPGP and GPGME_PROTOCOL_CMS.
898    A new context uses the OpenPGP engine by default.
899
900  * gpgme_get_engine_info() returns information for all crypto engines
901    compiled into the library.  The XML format has changed.  To
902    reliably get the version of a crypto engine, the <version> tag
903    after the appropriate <protocol> tag has to be looked for.
904
905  * New interface gpgme_engine_check_version(), obsoleting
906    gpgme_check_engine().  Check the version of all engines you are
907    supporting in your software.
908
909  * GpgmeKey lists the user ids in the order as they are returned by
910    GnuPG, first the primary key with index 0, then the sub-user ids.
911
912  * New operation gpgme_op_decrypt_verify() to decrypt and verify
913    signatures simultaneously.
914
915  * The new interface gpgme_op_keylist_end() terminates a pending
916    keylist operation.  A keylist operation is also terminated when
917    gpgme_op_keylist_next() returns GPGME_EOF.
918
919  * GPGME can be compiled without GnuPG being installed (`--with-gpg=PATH'),
920    cross-compiled, or even compiled without support for GnuPG
921    (`--without-gpg').
922
923  * GPGME can be compiled with support for GpgSM (GnuPG for S/MIME,
924    `--with-gpgsm=PATH').  It is enabled by default if the `gpgsm' is found
925    in the path, but it can also be compiled without support for GpgSM
926    (`--without-gpgsm').
927
928  * CryptPlug modules for GPGME are included and can be enabled at
929    configure time (`--enable-gpgmeplug').  There is one module which
930    uses the GnuPG engine (`gpgmeplug') and one module which uses the
931    GpgSM engine (`gpgsmplug').
932
933  * Interface changes relative to the latest 0.2.x release:
934 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
935 gpgme_key_get_as_xml            CHANGED: Sub-user ids reversed in order.
936 gpgme_key_get_string_attr       CHANGED: User ids reversed in order.
937 gpgme_key_get_ulong_attr        CHANGED: User ids reversed in order.
938 gpgme_get_engine_info           CHANGED: New format, extended content.
939 gpgme_engine_check_version      NEW
940 gpgme_decrypt_verify_start      NEW
941 gpgme_decrypt_verify            NEW
942 gpgme_op_keylist_next           NEW
943 gpgme_set_protocol              NEW
944 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
945
946
947 Noteworthy changes in version 0.2.3 (2001-09-17)
948 ------------------------------------------------
949
950  * New function gpgme_get_op_info which can be used to get the micalg
951    parameter needed for MOSS.
952
953  * New functions gpgme_get_armor and gpgme_get_textmode.
954
955  * The usual bug fixes and some minor functionality improvements.
956
957  * Added a simple encryption component for MS-Windows; however the
958    build procedure might have some problems.
959
960
961 Noteworthy changes in version 0.2.2 (2001-06-12)
962 ------------------------------------------------
963  
964  * Implemented a key cache.
965
966  * Fixed a race condition under W32 and some other bug fixes.
967
968
969 Noteworthy changes in version 0.2.1 (2001-04-02)
970 ------------------------------------------------
971
972  * Changed debug output and GPGME_DEBUG variable (gpgme/debug.c)
973
974  * Handle GnuPG's new key capabilities output and support revocation
975    et al. attributes
976
977  * Made the W32 support more robust.
978
979
980  Copyright 2001, 2002, 2003, 2004 g10 Code GmbH
981
982  This file is free software; as a special exception the author gives
983  unlimited permission to copy and/or distribute it, with or without
984  modifications, as long as this notice is preserved.
985
986  This file is distributed in the hope that it will be useful, but
987  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
988  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.