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