More about the new version.

diff --git a/NEWS b/NEWS
index dcf2a5525f7cb00e7e2e904737f77104ae8058df..5f5b02fec8f490a144a943b46e2e48f5c0c65cc1 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,19 @@
 
+ * New interface gpgme_set_protocol() to set the protocol and thus the
+   crypto engine to be used by the context.  Currently, the OpenPGP
+   and the CMS protocols are supported.  They are specified by the new
+   preprocessor symbols GPGME_PROTOCOL_OpenPGP and GPGME_PROTOCOL_CMS.
+   A new context uses the OpenPGP engine by default.
+
+ * gpgme_get_engine_info() returns information for all crypto engines
+   compiled into the library.  The XML format has changed.  To
+   reliably get the version of a crypto engine, the <version> tag
+   after the appropriate <protocol> tag has to be looked for.
+
+ * New interface gpgme_engine_check_version(), obsoleting
+   gpgme_check_engine().  Check the version of all engines you are
+   supporting in your software.
+
  * GpgmeKey lists the user ids in the order as they are returned by
    GnuPG, first the primary key with index 0, then the sub-user ids.
 
@@ -19,6 +34,18 @@
    uses the GnuPG engine (`gpgmeplug') and one module which uses the
    GpgSM engine (`gpgsmplug').
 
+* Interface changes relative to the latest 0.2.x release:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+gpgme_key_get_as_xml           CHANGED: Sub-user ids reversed in order.
+gpgme_key_get_string_attr      CHANGED: User ids reversed in order.
+gpgme_key_get_ulong_attr       CHANGED: User ids reversed in order.
+gpgme_get_engine_info          CHANGED: New format, extended content.
+gpgme_engine_check_version     NEW
+gpgme_decrypt_verify_start     NEW
+gpgme_decrypt_verify           NEW
+gpgme_set_protocol             NEW
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 
 Noteworthy changes in version 0.2.3 (2001-09-17)
 ------------------------------------------------
@@ -62,4 +89,3 @@ Noteworthy changes in version 0.2.1 (2001-04-02)
  This file is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-