2003-04-25 Marcus Brinkmann <marcus@g10code.de>

[gpgme.git] / NEWS

diff --git a/NEWS b/NEWS
index 331123c..409181c 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -36,6 +36,43 @@ Noteworthy changes in version 0.4.1 (unreleased)
  * The new function gpgme_get_protocol_name can be used to convert a
    GpgmeProtocol value into a string.
 
  * The new function gpgme_get_protocol_name can be used to convert a
    GpgmeProtocol value into a string.
 

+ * The GpgmePassphraseCb type now returns a GpgmeError value, and
+   returns the password string in a new parameter.  The gpgme_cancel
+   function has been removed, just return GPGME_Canceled in the
+   passphrase callback directly.
+
+ * The status of a context operation is not checked anymore, so the
+   errors GPGME_Busy and GPGME_No_Request can not occur anymore.
+
+ * For clarity and better reusability, the error codes
+   GPGME_No_Recipients, GPGME_Invalid_Recipient and
+   GPGME_No_Passphrase have been renamed to GPGME_No_UserID,
+   GPGME_Invalid_UserID and GPGME_Bad_Passphrase resp.
+
+ * The FPR argument to gpgme_op_genkey was removed.  Instead, use the
+   gpgme_op_genkey_result function to retrieve a GpgmeGenKeyResult
+   pointer to a structure which contains the fingerprint.  This also
+   works with gpgme_op_genkey.  The structure also provides other
+   information about the generated keys.
+
+   So, instead:
+
+   char *fpr;
+   err = gpgme_op_genkey (ctx, NULL, NULL, &fpr); 
+   if (!err && fpr)
+     printf ("%s\n", fpr);
+
+   you should now do:
+
+   GpgmeGenKeyResult result;
+   err = gpgme_op_genkey (ctx, NULL, NULL);
+   if (!err)
+     {
+       result = gpgme_op_genkey_result (ctx);
+       if (result->fpr)
+         printf ("%s\n", result->fpr);
+     }
+

  * Interface changes relative to the 0.4.0 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GpgmeIOCb                      CHANGED: Return type from void to GpgmeError.
  * Interface changes relative to the 0.4.0 release:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 GpgmeIOCb                      CHANGED: Return type from void to GpgmeError.


@@ -49,6 +86,19 @@ gpgme_register_idle             REMOVED
 GpgmeEngineInfo                        NEW
 gpgme_get_engine_info          CHANGED: Return info structure instead XML.
 gpgme_get_protocol_name                NEW
 GpgmeEngineInfo                        NEW
 gpgme_get_engine_info          CHANGED: Return info structure instead XML.
 gpgme_get_protocol_name                NEW

+GpgmePassphraseCb              CHANGED: Return error value, new argument.
+gpgme_cancel                   REMOVED: Return error in callback directly.
+GPGME_Busy                     DEPRECATED: Not in use.
+GPGME_No_Request               DEPRECATED: Not in use.
+GPGME_No_Recipients            DEPRECATED: Use GPGME_No_UserID.
+GPGME_No_UserID                        NEW
+GPGME_Invalid_Recipient                DEPRECATED: Use GPGME_Invalid_UserID.
+GPGME_Invalid_UserID           NEW
+GPGME_No_Passphrase            DEPRECATED: Use GPGME_Bad_Passphrase.
+GPGME_Bad_Passphrase           NEW
+gpgme_op_genkey                        CHANGED: FPR argument dropped.
+gpgme_op_genkey_result         NEW
+GpgmeGenKeyResult              NEW

 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Noteworthy changes in version 0.4.0 (2002-12-23)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Noteworthy changes in version 0.4.0 (2002-12-23)


@@ -94,6 +144,15 @@ gpgme_get_key                       NEW
 GPGME_ATTR_SIG_CLASS           NEW
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 GPGME_ATTR_SIG_CLASS           NEW
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

+Noteworthy changes in version 0.3.15 (2003-02-18)
+-------------------------------------------------
+
+ * The progress status is sent via the progress callbacks in
+   gpgme_op_edit.
+
+ * Bug fix for signing operations with explicit signer settings for
+   the CMS protocol.
+

 Noteworthy changes in version 0.3.14 (2002-12-04)
 -------------------------------------------------
 
 Noteworthy changes in version 0.3.14 (2002-12-04)
 -------------------------------------------------