NEWS

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