NEWS

   1 Noteworthy changes in version 0.4.1 (unreleased)
   2 ------------------------------------------------
   3
   4  * If gpgme.h is included in sources compiled by GCC 3.1 or later,
   5    deprecated attributes will warn about use of obsolete functions and
   6    typedefs.  The use of obsolete error values will appear as the use
   7    of an obsolete type _gpgme_deprecated_error_t.  You can suppress
   8    these warnings by passing -Wno-deprecated-declarations to the gcc
   9    command.
  10
  11  * The following types have been renamed.  The old types are still
  12    available as aliases, but they are deprecated now:
  13    Old name:            New name:
  14    GpgmeCtx             gpgme_ctx_t
  15    GpgmeData            gpgme_data_t
  16    GpgmeRecipients      gpgme_recipients_t
  17    GpgmeError           gpgme_error_t
  18    GpgmeDataEncoding    gpgme_data_encoding_t
  19    GpgmeSigStat         gpgme_sig_stat_t
  20    GpgmeSigMode         gpgme_sig_mode_t
  21    GpgmeAttr            gpgme_attr_t
  22    GpgmeValidity        gpgme_validity_t
  23    GpgmeProtocol        gpgme_protocol_t
  24    GpgmeKey             gpgme_key_t
  25    GpgmePassphraseCb    gpgme_passphrase_cb_t
  26    GpgmeProgressCb      gpgme_progress_cb_t
  27    GpgmeIOCb            gpgme_io_cb_t
  28    GpgmeRegisterIOCb    gpgme_register_io_cb_t
  29    GpgmeRemoveIOCb      gpgme_remove_io_cb_t
  30    GpgmeEventIO         gpgme_event_io_t
  31    GpgmeEventIOCb       gpgme_event_io_cb_t
  32    GpgmeIOCbs           gpgme_io_cbs
  33    GpgmeDataReadCb      gpgme_data_read_cb_t
  34    GpgmeDataWriteCb     gpgme_data_write_cb_t
  35    GpgmeDataSeekCb      gpgme_data_seek_cb_t
  36    GpgmeDataReleaseCb   gpgme_data_release_cb_t
  37    GpgmeDataCbs         gpgme_data_cbs_t
  38    GpgmeTrustItem       gpgme_trust_item_t
  39    GpgmeStatusCode      gpgme_status_code_t
  40
  41  * GPGME_ATTR_IS_SECRET is not anymore representable as a string.
  42
  43  * GnuPG 1.2.2 is required.  The progress callback is now also invoked
  44    for encrypt, sign, encrypt-sign, decrypt, verify, and
  45    decrypt-verify operations.  For verify operations on detached
  46    signatures, the progress callback is invoked for both the detached
  47    signature and the plaintext message, though.
  48
  49  * gpgme_op_verify and gpgme_op_decrypt_verify don't return a status
  50    summary anymore.  Use gpgme_get_sig_status to retrieve the individual
  51    stati.
  52
  53  * gpgme_io_cb_t changed from a void function to a function returning
  54    a gpgme_error_t value.  However, it will always return 0, so you
  55    can safely ignore the return value.
  56
  57  * A new I/O callback event GPGME_EVENT_START has been added.  The new
  58    requirement is that you must wait until this event until you are
  59    allowed to call the I/O callback handlers previously registered for
  60    this context operation.  Calling I/O callback functions for this
  61    context operation before the start event happened is unsafe because
  62    it can lead to race conditions in a multi-threaded environment.
  63
  64  * The idle function feature has been removed.  It was not precisely
  65    defined in a multi-threaded environment and is obsoleted by the
  66    user I/O callback functions.  If you still need a simple way to
  67    call something while waiting on one or multiple asynchronous
  68    operations to complete, don't set the HANG flag in gpgme_wait (note
  69    that this will return to your program more often than the idle
  70    function did).
  71
  72  * gpgme_wait can return NULL even if hang is true, if an error
  73    occurs.  In that case *status contains the error code.
  74
  75  * gpgme_get_engine_info was radically changed.  Instead an XML
  76    string, an info structure of the new type gpgme_engine_info_t is
  77    returned.  This makes it easier and more robust to evaluate the
  78    information in an application.
  79
  80  * The new function gpgme_get_protocol_name can be used to convert a
  81    gpgme_protocol_t value into a string.
  82
  83  * The gpgme_passphrase_cb_t type now returns a gpgme_error_t value,
  84    and returns the password string in a new parameter.  The
  85    gpgme_cancel function has been removed, just return GPGME_Canceled
  86    in the passphrase callback directly.
  87
  88  * The status of a context operation is not checked anymore, so the
  89    errors GPGME_Busy and GPGME_No_Request can not occur anymore.
  90
  91  * For clarity and better reusability, the error codes
  92    GPGME_No_Recipients, GPGME_Invalid_Recipient and
  93    GPGME_No_Passphrase have been renamed to GPGME_No_UserID,
  94    GPGME_Invalid_UserID and GPGME_Bad_Passphrase resp.
  95
  96  * The FPR argument to gpgme_op_genkey was removed.  Instead, use the
  97    gpgme_op_genkey_result function to retrieve a gpgme_genkey_result_t
  98    pointer to a structure which contains the fingerprint.  This also
  99    works with gpgme_op_genkey_start.  The structure also provides
 100    other information about the generated keys.
 101
 102    So, instead:
 103
 104    char *fpr;
 105    err = gpgme_op_genkey (ctx, NULL, NULL, &fpr);
 106    if (!err && fpr)
 107      printf ("%s\n", fpr);
 108
 109    you should now do:
 110
 111    gpgme_genkey_result_t result;
 112    err = gpgme_op_genkey (ctx, NULL, NULL);
 113    if (!err)
 114      {
 115        result = gpgme_op_genkey_result (ctx);
 116        if (result->fpr)
 117          printf ("%s\n", result->fpr);
 118      }
 119
 120  * The new gpgme_op_import_result function provides detailed
 121    information about the result of an import operation in
 122    gpgme_import_result_t and gpgme_import_status_t objects.
 123    Thus, the gpgme_op_import_ext variant is deprecated.
 124
 125  * The new gpgme_op_sign_result function provides detailed information
 126    about the result of a signing operation in gpgme_sign_result_t,
 127    gpgme_invalid_user_id_t and gpgme_new_signature_t objects.
 128
 129  * The new gpgme_op_encrypt_result function provides detailed
 130    information about the result of an encryption operation in
 131    a GpgmeEncryptResult object.
 132
 133  * The new gpgme_op_decrypt_result function provides detailed
 134    information about the result of a decryption operation in
 135    a GpgmeDecryptResult object.
 136
 137  * The new gpgme_op_verify_result function provides detailed
 138    information about the result of an verify operation in
 139    a GpgmeVerifyResult object.  Because of this, the GPGME_SIG_STAT_*
 140    values, gpgme_get_sig_status, gpgme_get_sig_ulong_attr,
 141    gpgme_get_sig_string_attr and gpgme_get_sig_key are now deprecated,
 142    and gpgme_get_notation is removed.
 143
 144  * GpgmeTrustItem objects have now directly accessible data, so the
 145    gpgme_trust_item_get_string_attr and gpgme_trust_item_get_ulong_attr
 146    accessor functions are deprecated.  Also, reference counting is
 147    available through gpgme_trust_item_ref and gpgme_trust_item_unref
 148    (the gpgme_trust_item_release alias for the latter is deprecated).
 149
 150  * Keys are not cached internally anymore, so the force_update argument
 151    to gpgme_get_key has been removed.
 152
 153  * GpgmeKey objects have now directly accessible data so the
 154    gpgme_key_get_string_attr, gpgme_key_get_ulong_attr,
 155    gpgme_key_sig_get_string_attr and gpgme_key_sig_get_ulong_attr
 156    functions are deprecated.  Also, gpgme_key_release is now
 157    deprecated.  The gpgme_key_get_as_xml function has been dropped.
 158
 159  * Because all interfaces using attributes are deprecated, the
 160    GpgmeAttr data type is also deprecated.
 161
 162  * The new gpgme_op_keylist_result function provides detailed
 163    information about the result of a key listing operation in
 164    a GpgmeKeyListResult object.
 165
 166  * Now that each function comes with its own result retrieval
 167    interface, the generic gpgme_get_op_info interface is not useful
 168    anymore and dropped.
 169
 170  * The error values GPGME_Invalid_Type and GPGME_Invalid_Mode can not
 171    occur anymore and are thus deprecated.
 172
 173  * Interface changes relative to the 0.4.0 release:
 174 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 175 GpgmeCtx                        DEPRECATED: Use gpgme_ctx_t.
 176 GpgmeData                       DEPRECATED: Use gpgme_data_t.
 177 GpgmeRecipients                 DEPRECATED: Use gpgme_recipients_t.
 178 GpgmeError                      DEPRECATED: Use gpgme_error_t.
 179 GpgmeDataEncoding               DEPRECATED: Use gpgme_data_encoding_t.
 180 GpgmeSigStat                    DEPRECATED: Use gpgme_sig_stat_t.
 181 GpgmeSigMode                    DEPRECATED: Use gpgme_sig_mode_t.
 182 GpgmeAttr                       DEPRECATED: Use gpgme_attr_t.
 183 GpgmeValidity                   DEPRECATED: Use gpgme_validity_t.
 184 GpgmeProtocol                   DEPRECATED: Use gpgme_protocol_t.
 185 GpgmeKey                        DEPRECATED: Use gpgme_key_t.
 186 GpgmePassphraseCb               DEPRECATED: Use gpgme_passphrase_cb_t.
 187 GpgmeProgressCb                 DEPRECATED: Use gpgme_progress_cb_t.
 188 GpgmeIOCb                       DEPRECATED: Use gpgme_io_cb_t.
 189 GpgmeRegisterIOCb               DEPRECATED: Use gpgme_register_io_cb_t.
 190 GpgmeRemoveIOCb                 DEPRECATED: Use gpgme_remove_io_cb_t.
 191 GpgmeEventIO                    DEPRECATED: Use gpgme_event_io_t.
 192 GpgmeEventIOCb                  DEPRECATED: Use gpgme_event_io_cb_t.
 193 GpgmeIOCbs                      DEPRECATED: Use gpgme_io_cbs.
 194 GpgmeDataReadCb                 DEPRECATED: Use gpgme_data_read_cb_t.
 195 GpgmeDataWriteCb                DEPRECATED: Use gpgme_data_write_cb_t.
 196 GpgmeDataSeekCb                 DEPRECATED: Use gpgme_data_seek_cb_t.
 197 GpgmeDataReleaseCb              DEPRECATED: Use gpgme_data_release_cb_t.
 198 GpgmeDataCbs                    DEPRECATED: Use gpgme_data_cbs_t.
 199 GpgmeTrustItem                  DEPRECATED: Use gpgme_trust_item_t.
 200 GpgmeStatusCode                 DEPRECATED: Use gpgme_status_code_t.
 201 gpgme_ctx_t                     NEW
 202 gpgme_data_t                    NEW
 203 gpgme_recipients_t              NEW
 204 gpgme_error_t                   NEW
 205 gpgme_data_encoding_t           NEW
 206 gpgme_sig_stat_t                NEW
 207 gpgme_sig_mode_t                NEW
 208 gpgme_attr_t                    NEW
 209 gpgme_validity_t                NEW
 210 gpgme_protocol_t                NEW
 211 gpgme_key_t                     NEW
 212 gpgme_passphrase_cb_t           NEW
 213 gpgme_progress_cb_t             NEW
 214 gpgme_io_cb_t                   NEW
 215 gpgme_register_io_cb_t          NEW
 216 gpgme_remove_io_cb_t            NEW
 217 gpgme_event_io_t                NEW
 218 gpgme_event_io_cb_t             NEW
 219 gpgme_io_cbs                    NEW
 220 gpgme_data_read_cb_t            NEW
 221 gpgme_data_write_cb_t           NEW
 222 gpgme_data_seek_cb_t            NEW
 223 gpgme_data_release_cb_t         NEW
 224 gpgme_data_cbs_t                NEW
 225 gpgme_trust_item_t              NEW
 226 gpgme_status_code_t             NEW
 227 gpgme_io_cb_t                   CHANGED: Return type from void to GpgmeError.
 228 gpgme_event_io_t                CHANGED: New event type (all numbers changed).
 229 gpgme_key_get_string_attr       CHANGED: Don't handle GPGME_ATTR_IS_SECRET.
 230 gpgme_op_verify                 CHANGED: Drop R_STAT argument.
 231 gpgme_op_decrypt_verify         CHANGED: Drop R_STAT argument.
 232 gpgme_wait                      CHANGED: Can return NULL even if hang is true.
 233 GpgmeIdleFunc                   REMOVED
 234 gpgme_register_idle             REMOVED
 235 gpgme_engine_info_t             NEW
 236 gpgme_get_engine_info           CHANGED: Return info structure instead XML.
 237 gpgme_get_protocol_name         NEW
 238 GpgmePassphraseCb               CHANGED: Return error value, new argument.
 239 gpgme_cancel                    REMOVED: Return error in callback directly.
 240 GPGME_Busy                      DEPRECATED: Not in use.
 241 GPGME_No_Request                DEPRECATED: Not in use.
 242 GPGME_No_Recipients             DEPRECATED: Use GPGME_No_UserID.
 243 GPGME_No_UserID                 NEW
 244 GPGME_Invalid_Recipient         DEPRECATED: Use GPGME_Invalid_UserID.
 245 GPGME_Invalid_UserID            NEW
 246 GPGME_No_Passphrase             DEPRECATED: Use GPGME_Bad_Passphrase.
 247 GPGME_Bad_Passphrase            NEW
 248 gpgme_op_genkey                 CHANGED: FPR argument dropped.
 249 gpgme_op_genkey_result          NEW
 250 gpgme_genkey_result_t           NEW
 251 gpgme_op_import_ext             DEPRECATED: Use gpgme_op_import_result.
 252 gpgme_op_import_result          NEW
 253 gpgme_import_status_t           NEW
 254 gpgme_import_result_t           NEW
 255 gpgme_pubkey_algo_t             NEW
 256 gpgme_hash_algo_t               NEW
 257 gpgme_invalid_user_id_t         NEW
 258 gpgme_new_signature_t           NEW
 259 gpgme_sign_result_t             NEW
 260 gpgme_op_sign_result            NEW
 261 gpgme_pubkey_algo_name          NEW
 262 gpgme_hash_algo_name            NEW
 263 gpgme_encrypt_result_t          NEW
 264 gpgme_op_encrypt_result         NEW
 265 gpgme_decrypt_result_t          NEW
 266 gpgme_op_decrypt_result         NEW
 267 gpgme_verify_result_t           NEW
 268 gpgme_op_verify_result          NEW
 269 gpgme_get_notation              REMOVED: Access verify result directly instead.
 270 gpgme_get_sig_key               DEPRECATED: Use gpgme_get_key with fingerprint.
 271 gpgme_get_sig_ulong_attr        DEPRECATED: Use verify result directly.
 272 gpgme_get_sig_string_attr       DEPRECATED: Use verify result directly.
 273 GPGME_SIG_STAT_*                DEPRECATED: Use error value in sig status.
 274 gpgme_get_sig_status            DEPRECATED: Use verify result directly.
 275 gpgme_trust_item_t              CHANGED: Now has user accessible data members.
 276 gpgme_trust_item_ref            NEW
 277 gpgme_trust_item_unref          NEW
 278 gpgme_trust_item_release        DEPRECATED: Use gpgme_trust_item_unref.
 279 gpgme_trust_item_get_string_attr DEPRECATED
 280 gpgme_trust_item_get_ulong_attr DEPRECATED
 281 gpgme_get_key                   CHANGED: Removed force_update argument.
 282 gpgme_sub_key_t                 NEW
 283 gpgme_key_sig_t                 NEW
 284 gpgme_user_id_t                 NEW
 285 gpgme_key_t                     CHANGED: Now has user accessible data members.
 286 gpgme_key_get_string_attr       DEPRECATED
 287 gpgme_key_get_ulong_attr        DEPRECATED
 288 gpgme_key_sig_get_string_attr   DEPRECATED
 289 gpgme_key_sig_get_ulong_attr    DEPRECATED
 290 gpgme_key_get_as_xml            REMOVED
 291 gpgme_key_list_result_t         NEW
 292 gpgme_op_keylist_result         NEW
 293 gpgme_get_op_info               REMOVED
 294 GPGME_Invalid_Type              DEPRECATED
 295 GPGME_Invalid_Mode              DEPRECATED
 296 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 297
 298 Noteworthy changes in version 0.4.0 (2002-12-23)
 299 ------------------------------------------------
 300
 301  * Key generation returns the fingerprint of the generated key.
 302
 303  * New convenience function gpgme_get_key.
 304
 305  * Supports signatures of user IDs in keys via the new
 306    GPGME_KEYLIST_MODE_SIGS keylist mode and the
 307    gpgme_key_sig_get_string_attr and gpgme_key_sig_get_ulong_attr
 308    interfaces.  The XML info about a key also includes the signatures
 309    if available.
 310
 311  * New data object interface, which is more flexible and transparent.
 312
 313  * Interface changes relative to the 0.3.9 release:
 314 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 315 GpgmeDataReadCb                 NEW
 316 GpgmeDataWriteCb                NEW
 317 GpgmeDataSeekCb                 NEW
 318 GpgmeDataReleaseCb              NEW
 319 GpgmeDataCbs                    NEW
 320 gpgme_data_read                 CHANGED: Match read() closely.
 321 gpgme_data_write                CHANGED: Match write() closely.
 322 gpgme_data_seek                 NEW
 323 gpgme_data_new_from_fd          NEW
 324 gpgme_data_new_from_stream      NEW
 325 gpgme_data_new_from_cbs         NEW
 326 gpgme_data_rewind               DEPRECATED: Replaced by gpgme_data_seek().
 327 gpgme_data_new_from_read_cb     DEPRECATED: Replaced by gpgme_data_from_cbs().
 328 gpgme_data_get_type             REMOVED: No replacement.
 329 gpgme_op_verify                 CHANGED: Take different data objects for
 330                                 signed text and plain text.
 331 gpgme_op_verify_start           CHANGED: See gpgme_op_verify.
 332 gpgme_check_engine              REMOVED: Deprecated since 0.3.0.
 333 gpgme_op_genkey                 CHANGED: New parameter FPR.
 334 GPGME_KEYLIST_MODE_SIGS         NEW
 335 gpgme_key_sig_get_string_attr   NEW
 336 gpgme_key_sig_get_ulong_attr    NEW
 337 gpgme_get_key                   NEW
 338 GPGME_ATTR_SIG_CLASS            NEW
 339 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 340
 341 Noteworthy changes in version 0.3.15 (2003-02-18)
 342 -------------------------------------------------
 343
 344  * The progress status is sent via the progress callbacks in
 345    gpgme_op_edit.
 346
 347  * Bug fix for signing operations with explicit signer settings for
 348    the CMS protocol.
 349
 350 Noteworthy changes in version 0.3.14 (2002-12-04)
 351 -------------------------------------------------
 352
 353  * GPGME-Plug is now in its own package "cryptplug".
 354
 355  * Workaround for a setlocale problem.  Fixed a segv related to not
 356    correctly as closed marked file descriptors.
 357
 358 Noteworthy changes in version 0.3.13 (2002-11-20)
 359 -------------------------------------------------
 360
 361  * Release due to changes in gpgmeplug.
 362
 363 Noteworthy changes in version 0.3.12 (2002-10-15)
 364 -------------------------------------------------
 365
 366  * Fixed some bux with key listings.
 367
 368  * The development has been branched to clean up some API issues.
 369    This 0.3 series will be kept for compatibility reasons; so do don't
 370    expect new features.
 371
 372 Noteworthy changes in version 0.3.11 (2002-09-20)
 373 -------------------------------------------------
 374
 375  * Bug fixes.
 376
 377 Noteworthy changes in version 0.3.10 (2002-09-02)
 378 -------------------------------------------------
 379
 380  * Setting the signing keys for the CMS protocol does now work.
 381
 382  * The signers setting is honoured by gpgme_op_edit.
 383
 384 Noteworthy changes in version 0.3.9 (2002-08-21)
 385 ------------------------------------------------
 386
 387  * A spec file for creating RPMs has been added.
 388
 389  * An experimental interface to GnuPG's --edit-key functionality is
 390    introduced, see gpgme_op_edit.
 391
 392  * The new gpgme_import_ext function provides a convenient access to
 393    the number of processed keys.
 394
 395  * Interface changes relative to the 0.3.8 release:
 396 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 397 GpgmeStatusCode                 NEW
 398 GpgmeEditCb                     NEW
 399 gpgme_op_edit_start             NEW
 400 gpgme_op_edit                   NEW
 401 gpgme_op_import_ext             NEW
 402 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 403
 404 Noteworthy changes in version 0.3.8 (2002-06-25)
 405 ------------------------------------------------
 406
 407  * It is possible to use an outside event loop for the I/O to the
 408    crypto engine by setting the I/O callbacks with gpgme_set_io_cbs.
 409
 410  * Interface changes relative to the 0.3.6 release:
 411 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 412 GpgmeIOCb                       NEW
 413 GpgmeRegisterIOCb               NEW
 414 GpgmeRemoveIOCb                 NEW
 415 GpgmeEventIO                    NEW
 416 GpgmeEventIOCb                  NEW
 417 struct GpgmeIOCbs               NEW
 418 gpgme_set_io_cbs                NEW
 419 gpgme_get_io_cbs                NEW
 420 GPGME_ATTR_ERRTOK               NEW
 421 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 422
 423 Noteworthy changes in version 0.3.7 (2002-06-04)
 424 ------------------------------------------------
 425
 426  * GPGME_ATTR_OTRUST is implemented now.
 427
 428  * A first step toward thread safeness has been achieved, see the
 429    documentation for details.  Supported thread libraries are pthread
 430    and Pth.
 431
 432 Noteworthy changes in version 0.3.6 (2002-05-03)
 433 ------------------------------------------------
 434
 435  * All error output of the gpgsm backend is send to the bit bucket.
 436
 437  * The signature verification functions are extended.  Instead of
 438    always returning GPGME_SIG_STATUS_GOOD, the functions new codes for
 439    expired signatures.  2 new functions may be used to retrieve more
 440    detailed information like the signature expiration time and a
 441    validity information of the key without an extra key looking.
 442
 443  * The current passphrase callback and progress meter callback can be
 444    retrieved with the new functions gpgme_get_passphrase_cb and
 445    gpgme_get_progress_cb respectively.
 446
 447  * Interface changes relative to the 0.3.5 release:
 448 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 449 gpgme_get_passphrase_cb         NEW
 450 gpgme_get_progress_cb           NEW
 451 GpgmeDataEncoding               NEW
 452 gpgme_data_set_encoding         NEW
 453 gpgme_data_get_encoding         NEW
 454 GPGME_SIG_STAT_GOOD_EXP         NEW
 455 GPGME_SIG_STAT_GOOD_EXPKEY      NEW
 456 gpgme_op_verify                 CHANGED: Returns more status codes.
 457 GPGME_ATTR_SIG_STATUS           NEW
 458 gpgme_get_sig_string_attr       NEW
 459 gpgme_get_sig_ulong_attr        NEW
 460 gpgme_get_protocol              NEW
 461 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 462
 463 Noteworthy changes in version 0.3.5 (2002-04-01)
 464 ------------------------------------------------
 465
 466  * gpgme_op_encrypt can be called with RECIPIENTS being 0.  In this
 467    case, symmetric encryption is performed.  Note that this requires a
 468    passphrase from the user.
 469
 470  * More information is returned for X.509 certificates.
 471
 472  * Interface changes relative to the 0.3.4 release:
 473 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 474 gpgme_op_encrypt                EXTENDED: Symmetric encryption possible
 475 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 476
 477 Noteworthy changes in version 0.3.4 (2002-03-04)
 478 ------------------------------------------------
 479
 480  * gpgme_op_encrypt does now fail with GPGME_Invalid_Recipients if
 481    some recipients have been invalid, whereas earlier versions
 482    succeeded in this case.  The plaintext is still encrypted for all valid
 483    recipients, so the application might take this error as a hint that
 484    the ciphertext is not usable for all requested recipients.
 485    Information about invalid recipients is available with gpgme_get_op_info.
 486
 487  * gpgme_op_verify now allows to pass an uninitialized data object as
 488    its plaintext argument to check for normal and cleartext
 489    signatures.  The plaintext is then returned in the data object.
 490
 491  * New interfaces gpgme_set_include_certs and gpgme_get_include_certs
 492    to set and get the number of certifications to include in S/MIME
 493    signed messages.
 494
 495  * New interfaces gpgme_op_encrypt_sign and gpgme_op_encrypt_sign_start
 496    to encrypt and sign a message in a combined operation.
 497
 498  * New interface gpgme_op_keylist_ext_start to search for multiple patterns.
 499
 500  * gpgme_key_get_ulong_attr supports the GPGME_ATTR_EXPIRE attribute.
 501
 502  * Interface changes relative to the 0.3.3 release:
 503 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 504 gpgme_op_encrypt                CHANGED: Can fail with GPGME_Invalid_Recipients
 505 gpgme_op_verify                 EXTENDED: Accepts uninitialized text argument
 506 gpgme_key_get_ulong_attr        EXTENDED: Supports GPGME_ATTR_EXPIRE
 507 gpgme_set_include_certs         NEW
 508 gpgme_get_include_certs         NEW
 509 gpgme_op_encrypt_sign           NEW
 510 gpgme_op_encrypt_sign_start     NEW
 511 gpgme_op_keylist_ext_start      NEW
 512 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 513
 514 Noteworthy changes in version 0.3.3 (2002-02-12)
 515 ------------------------------------------------
 516
 517  * Fix the Makefile in jnlib.
 518
 519  * Fix the test suite (hopefully).  It should clean up all its state
 520    with `make check' now.
 521
 522
 523 Noteworthy changes in version 0.3.2 (2002-02-10)
 524 ------------------------------------------------
 525
 526  * Remove erroneous dependency on libgcrypt in jnlib.
 527
 528
 529 Noteworthy changes in version 0.3.1 (2002-02-09)
 530 ------------------------------------------------
 531
 532  * There is a Texinfo manual documenting the API.
 533
 534  * The gpgme_set_keylist_mode function returns an error, and changed
 535    its meaning.  It is no longer usable to select between normal and
 536    fast mode (newer versions of GnuPG will always be fast), but
 537    selects between local keyring, remote keyserver, or both.
 538    For this, two new macros are defined, GPGME_KEYLIST_MODE_LOCAL
 539    and GPGME_KEYLIST_MODE_EXTERN.  To make it possible to modify the
 540    current setting, a fucntion gpgme_get_keylist_mode was added to
 541    retrieve the current mode.
 542
 543  * gpgme_wait accepts a new argument STATUS to return the error status
 544    of the operation on the context.  Its definition is closer to
 545    waitpid() now than before.
 546
 547  * The LENGTH argument to gpgme_data_new_from_filepart changed its
 548    type from off_t to the unsigned size_t.
 549
 550  * The R_HD argument to the GpgmePassphraseCb type changed its type
 551    from void* to void**.
 552
 553  * New interface gpgme_op_trustlist_end() to match
 554    gpgme_op_keylist_end().
 555
 556  * The CryptPlug modules have been renamed to gpgme-openpgp and
 557    gpgme-smime, and they are installed in pkglibdir by `make install'.
 558
 559  * An idle function can be registered with gpgme_register_idle().
 560
 561  * The GpgSM backend supports key generation with gpgme_op_genkey().
 562
 563  * Interface changes relative to the 0.3.0 release:
 564 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 565 gpgme_data_new_from_filepart    CHANGED: Type of LENGTH is size_t.
 566 GpgmePassphraseCb               CHANGED: Type of R_HD is void **.
 567 gpgme_wait                      CHANGED: New argument STATUS.
 568 gpgme_set_keylist_mode          CHANGED: Type of return value is GpgmeError.
 569                                 The function has a new meaning!
 570 gpgme_get_keylist_mode          NEW
 571 GPGME_KEYLIST_MODE_LOCAL        NEW
 572 GPGME_KEYLIST_MODE_EXTERN       NEW
 573 gpgme_op_trustlist_next         NEW
 574 GpgmeIdleFunc                   NEW
 575 gpgme_register_idle             NEW
 576 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 577
 578 Noteworthy changes in version 0.3.0 (2001-12-19)
 579 ------------------------------------------------
 580
 581  * New interface gpgme_set_protocol() to set the protocol and thus the
 582    crypto engine to be used by the context.  Currently, the OpenPGP
 583    and the CMS protocols are supported.  They are specified by the new
 584    preprocessor symbols GPGME_PROTOCOL_OpenPGP and GPGME_PROTOCOL_CMS.
 585    A new context uses the OpenPGP engine by default.
 586
 587  * gpgme_get_engine_info() returns information for all crypto engines
 588    compiled into the library.  The XML format has changed.  To
 589    reliably get the version of a crypto engine, the <version> tag
 590    after the appropriate <protocol> tag has to be looked for.
 591
 592  * New interface gpgme_engine_check_version(), obsoleting
 593    gpgme_check_engine().  Check the version of all engines you are
 594    supporting in your software.
 595
 596  * GpgmeKey lists the user ids in the order as they are returned by
 597    GnuPG, first the primary key with index 0, then the sub-user ids.
 598
 599  * New operation gpgme_op_decrypt_verify() to decrypt and verify
 600    signatures simultaneously.
 601
 602  * The new interface gpgme_op_keylist_end() terminates a pending
 603    keylist operation.  A keylist operation is also terminated when
 604    gpgme_op_keylist_next() returns GPGME_EOF.
 605
 606  * GPGME can be compiled without GnuPG being installed (`--with-gpg=PATH'),
 607    cross-compiled, or even compiled without support for GnuPG
 608    (`--without-gpg').
 609
 610  * GPGME can be compiled with support for GpgSM (GnuPG for S/MIME,
 611    `--with-gpgsm=PATH').  It is enabled by default if the `gpgsm' is found
 612    in the path, but it can also be compiled without support for GpgSM
 613    (`--without-gpgsm').
 614
 615  * CryptPlug modules for GPGME are included and can be enabled at
 616    configure time (`--enable-gpgmeplug').  There is one module which
 617    uses the GnuPG engine (`gpgmeplug') and one module which uses the
 618    GpgSM engine (`gpgsmplug').
 619
 620  * Interface changes relative to the latest 0.2.x release:
 621 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 622 gpgme_key_get_as_xml            CHANGED: Sub-user ids reversed in order.
 623 gpgme_key_get_string_attr       CHANGED: User ids reversed in order.
 624 gpgme_key_get_ulong_attr        CHANGED: User ids reversed in order.
 625 gpgme_get_engine_info           CHANGED: New format, extended content.
 626 gpgme_engine_check_version      NEW
 627 gpgme_decrypt_verify_start      NEW
 628 gpgme_decrypt_verify            NEW
 629 gpgme_op_keylist_next           NEW
 630 gpgme_set_protocol              NEW
 631 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 632
 633
 634 Noteworthy changes in version 0.2.3 (2001-09-17)
 635 ------------------------------------------------
 636
 637  * New function gpgme_get_op_info which can be used to get the micalg
 638    parameter needed for MOSS.
 639
 640  * New functions gpgme_get_armor and gpgme_get_textmode.
 641
 642  * The usual bug fixes and some minor functionality improvements.
 643
 644  * Added a simple encryption component for MS-Windows; however the
 645    build procedure might have some problems.
 646
 647
 648 Noteworthy changes in version 0.2.2 (2001-06-12)
 649 ------------------------------------------------
 650
 651  * Implemented a key cache.
 652
 653  * Fixed a race condition under W32 and some other bug fixes.
 654
 655
 656 Noteworthy changes in version 0.2.1 (2001-04-02)
 657 ------------------------------------------------
 658
 659  * Changed debug output and GPGME_DEBUG variable (gpgme/debug.c)
 660
 661  * Handle GnuPG's new key capabilities output and support revocation
 662    et al. attributes
 663
 664  * Made the W32 support more robust.
 665
 666
 667  Copyright 2001, 2002 g10 Code GmbH
 668
 669  This file is free software; as a special exception the author gives
 670  unlimited permission to copy and/or distribute it, with or without
 671  modifications, as long as this notice is preserved.
 672
 673  This file is distributed in the hope that it will be useful, but
 674  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
 675  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.