doc/
[gpgme.git] / doc / ChangeLog
index 316fac1c7c08ee1174229004bed99cd6fccf39e5..11cc544b5f51126a6a251f75b45d742be4f188a4 100644 (file)
@@ -1,3 +1,417 @@
+2003-09-14  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Locale): New section.
+       (Multi Threading): Set locale in example.
+
+2003-09-13  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Error Strings): Add gpgme_strerror_r.
+
+2003-09-13  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Multi Threading): Update documentation.
+
+2003-09-03  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Header): We don't use the assuan namespace anymore.
+       Document new thread options.
+
+2003-08-14  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Creating a Signature): Change type of member class
+       to unsigned int.
+
+2003-08-04  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Verify): Get error code from SIG->status in the code
+       for gpgme_get_sig_status.
+
+2003-07-31  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Key Management): Add can_authenticate flag.
+
+       * gpgme.texi (Listing Keys): Document GPG_ERR_AMBIGUOUS_NAME for
+       gpgme_get_key.
+
+2003-07-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * Makefile.am (EXTRA_DIST): Remove variable.
+
+       * gpgme.texi (Encrypting a Plaintext): Bad passphrase is only
+       possible with symmetric encryption, change the wording to reflect
+       that.
+
+       * gpgme.texi (Creating a Signature): Document
+       GPG_ERR_UNUSABLE_SECKEY.
+
+       * gpgme.texi (Encrypting a Plaintext): Mention encrypt and sign
+       operations in result function.
+       (Creating a Signature): Likewise.
+
+2003-07-23  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Key Listing Mode): Remove word duplication.
+       (Listing Keys): Remove mentioning of force argument.
+       (Verify): Don't mention r_stat.  Fix some typos.
+       (Decrypt and Verify): Correct info how to get the result.  Don't
+       mention r_stat.
+       (Manipulating Data Buffers): Fix documentation of return value.
+       (Listing Keys): Update examples.
+       (Decrypt): Result might also be available when operation failed.
+       (Verify): Result might also be available when operation failed.
+       All spotted by Stéphane Corthésy.
+
+2003-07-22  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Error Sources): Fix cut and paste error.
+
+2003-07-09  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Key Management): Clarify difference between can_sign
+       and can_certify.
+       (Information About Keys): Likewise for GPGME_ATTR_CAN_SIGN and
+       GPGME_ATTR_CAN_CERTIFY.
+
+2003-07-08  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Progress Meter Callback): Change return type of
+       gpgme_progress_cb_t to void.
+
+2003-06-22  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi: Add 2003 to copyright notice.
+
+       * gpgme.texi (Header): Fix name space documentation on
+       libgpg-error.
+
+2003-06-22  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Multi Threading): Remove reference to
+       gpgme_recipients_t.
+
+2003-06-06  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Crypto Operations): Rename gpgme_invalid_user_id_t
+       to gpgme_invalid_key_t.
+
+2003-06-06  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi: Change error codes to GPG_ERR_* variants.
+       (Error Handling): Rewritten.
+
+2003-05-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Exporting Keys): Change and document prototypes.
+       Add new gpgme_op_export_ext and gpgme_op_export_ext_start
+       variants.
+       (Selecting Recipients): Section removed.
+       (Encrypting a Plaintext): Change prototypes and document the
+       changes.
+
+2003-05-28  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Exporting Keys): Change argument type from
+       gpgme_recipient_t to gpgme_user_id_t.
+       (Encrypting a Plaintext): Likewise.
+       (Selecting Recipients): Rewritten.
+
+2003-05-27  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Protocol Selection): Do not use @acronym in @node
+       because that breaks texi2dvi.
+
+       * gpgme.texi (Passphrase Callback): Document new prototype.
+
+2003-05-18  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Header): Remove Gpgme as namespace prefix.  Add
+       _GPGME to namespace prefix.
+       * gpgme.texi (Multi Threading): Add note about link order.
+
+2003-05-04  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Listing Keys): Document what happens if key is not
+       found.
+
+       * gpgme.texi (Importing Keys): Fix cut and paste error.
+
+2003-04-30  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Encrypting a Plaintext): Remove reference to
+       gpgme_get_op_info.
+       (Detailed Results): Subsection removed.
+
+       * gpgme.texi (Key Listing Mode): Add GPGME_KEYLIST_MODE_SIGS.
+       (Manipulating Keys): Add obsoleteness note.
+       (Key Signatures): Likewise.
+       (Information About Keys): Likewise.
+       (Key Management): Add new data types GpgmeSubkey, GpgmeKeySig,
+       GpgmeUserID, and all the information about GpgmeKey.
+
+2003-04-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Listing Keys): Remove force_update argument from
+       gpgme_get_key.
+
+       * gpgme.texi (Trust Item Management): Add data members of
+       GpgmeTrustItem type.
+       (Information About Trust Items): Add note about obsoleteness.
+       (Manipulating Trust Items): Add gpgme_trust_item_ref and
+       gpgme_trust_item_unref.
+
+2003-04-28  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Verify): Rewritten to take into account new and
+       deprecated functions and data types.
+
+       * gpgme.texi (Decrypt): Descript gpgme_op_decrypt_result and
+       GpgmeDecryptResult.
+
+2003-04-27  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Encrypting a Plaintext): Add info about
+       GpgmeEncryptResult and gpgme_op_encrypt_result.
+
+       * gpgme.texi (Creating a Signature): Add info about
+       GpgmeNewSignature, GpgmeSignResult and gpgme_op_sign_result.
+       (Crypto Operations): Add GpgmeInvalidUserID.
+       (Algorithms): New chapter.
+
+       * gpgme.texi (Deleting Keys): Document
+       GPGME_Ambiguous_Specification.
+       (Error Values): Remove GPGME_Invalid_Type and GPGME_Invalid_Mode.
+       Add GPGME_Unknown_Reason, GPGME_Not_Found,
+       GPGME_Ambiguous_Specification, GPGME_Wrong_Key_Usage,
+       GPGME_Key_Revoked, GPGME_Key_Expired, GPGME_No_CRL_Known,
+       GPGME_CRL_Too_Old, GPGME_Policy_Mismatch, GPGME_No_Secret_Key,
+       GPGME_Key_Not_Trusted, GPGME_Issuer_Missing, GPGME_Chain_Too_Long,
+       GPGME_Unsupported_Algorithm, GPGME_Sig_Expired,
+       GPGME_Bad_Signature, GPGME_No_Public_Key.
+
+2003-04-25  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Importing Keys): Change GPGME_IMPORT_PRIVATE to
+       GPGME_IMPORT_SECRET.
+
+       * gpgme.texi (Importing Keys): Remove note about gpgme_get_op_info.
+       (Detailed Results): Remove note about import.
+
+       * gpgme.texi (Importing Keys): Add documentation for
+       GpgmeImportStatus, GpgmeImportResult and gpgme_op_import_result.
+
+       * gpgme.texi (Generating Keys): Fix documentation of public and
+       secret arguments.
+
+2003-04-24  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Generating Keys): Document changed gpgme_op_genkey
+       and new gpgme_op_genkey_result function.  Document
+       GpgmeGenKeyResult data type.
+
+       * gpgme.texi (Error Values): Rename GPGME_No_Passphrase to
+       GPGME_Bad_Passphrase.
+       * gpgme.texi (Decrypt): Likewise.
+       (Decrypt and Verify): Likewise.
+       (Creating a Signature): Likewise.
+       (Encrypting a Plaintext): Likewise.
+
+       * gpgme.texi (Error Values): Rename GPGME_No_Recipients to
+       GPGME_No_UserID and GPGME_Invalid_Recipient to
+       GPGME_Invalid_UserID.
+       (Encrypting a Plaintext): Likewise.
+
+       * gpgme.texi (Error Values): Remove GPGME_Busy and GPGME_No_Request.
+       (Listing Keys): Likewise.
+       (Listing Trust Items): Likewise.
+
+2003-02-06  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Cancelling an Operation): Removed.
+       (Passphrase Callback): Document new type for GpgmePassphraseCb.
+
+2003-01-30  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Engine Information): Rename member part to
+       file_name.
+
+       * gpgme.texi (Protocols and Engines): Document
+       gpgme_get_protocol_name.
+
+       * gpgme.texi (Engine Information): Rewritten.
+
+2003-01-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (I/O Callback Interface): Document new even
+       GPGME_EVENT_START.
+       (Waiting For Completion): Document new possible return values.
+       (I/O Callback Interface): Document return type of GpgmeIOCb.
+
+2003-01-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Hooking Up Into Idle Time): Section removed.
+
+2002-12-24  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Verify): Drop R_STAT argument in gpgme_op_verify.
+       * gpgme.texi (Decrypt and Verify): Likewise for
+       gpgme_op_decrypt_verify.
+
+2002-12-23  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Information About Keys): Document that
+       GPGME_ATTR_IS_SECRET is not representable as a string anymore.
+
+2002-12-22  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Key Signatures): New section.
+       (Listing Keys): Add gpgme_get_key.
+
+2002-12-06  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Memory Based Data Buffers): New subsection.
+       (File Based Data Buffers): Likewise.
+       (Callback Based Data Buffers): Likewise.
+       (Manipulating Data Buffers): Update interfaces.  Add
+       gpgme_data_seek.
+       * gpgme.texi (Engine Version Check): Remove gpgme_check_engine.
+       
+2002-11-21  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Verify): Document the new interface.
+
+2002-11-19  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Generating Keys): Document new argument to
+       gpgme_op_genkey.
+
+2002-11-05  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Verify): Fix prototype of gpgme_get_sig_key.
+       Reported by Miguel Coca <e970095@zipi.fi.upm.es>.
+
+2002-08-30  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Selecting Signers): Fix reference count.
+
+2002-08-21  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Header): Document name space.
+
+2002-08-20  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Importing Keys): Document gpgme_op_import_ext.
+
+       * gpgme.texi (Importing Keys): Undocument EOF.
+
+2002-08-14  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Information About Keys): Changed GPGME_ATTR_TYPE.
+
+2002-07-25  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Deleting Keys): Say that secret keys might not be
+       deleted.
+
+2002-07-25  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Information About Keys): Document (badly) the new
+       key attributes.
+
+       * gpgme.texi (Manipulating Data Buffers): Mention that backend
+       tries to detect encoding automatically.
+
+2002-07-03  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Run Control): Update this section.
+       (Waiting For Completion): Likewise for this subsection.
+       (Cancelling an Operation): Likewise for this subsection.
+       (Using External Event Loops): New subsection with several
+       subsubsections.
+
+2002-06-28  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Multi Threading): Remove item about the need to
+       synchronize anything against gpgme_wait (except gpgme_wait
+       itself).
+
+2002-06-27  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Information About Keys): Fix documentation for IDX.
+       (Information About Trust Items): Likewise.
+
+2002-06-26  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Importing Keys): Document the return value -1 of
+       gpgme_op_import.
+
+2002-06-20  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Verify): Explain the new whatidx variable.
+
+2002-06-10  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Verify): Document attribute GPGME_ATTR_ERRTOK.
+
+2002-06-04  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Multi Threading): Document new autodetection.
+
+2002-06-04  Marcus Brinkmann  <marcus@g10code.de>
+
+       * Makefile.am (DISTCLEANFILES): New variable.
+
+2002-05-26  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi: Some typographical correctons throughout.
+
+2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Using Automake): New section.
+
+2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Multi Threading): Escape { and }.
+
+2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Overview): Replace note about thread-safeness.
+       (Multi Threading): New section.
+
+2002-05-03  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Manipulating Data Buffers): Changed some data types
+       to void*.
+       (Protocol Selection): Added gpgme_get_protocol.
+       (Verify): Updated to include the new attribute fucntions and
+       status codes.
+
+2002-04-27  Werner Koch  <wk@gnupg.org>
+
+       * gpgme.texi (Manipulating Data Buffers): New type GpgmeDataEncoding.
+
+2002-04-23  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Passphrase Callback): Document that either return
+       argument can be NULL.
+       (Progress Meter Callback): Likewise.
+
+2002-04-22  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Passphrase Callback): Fix small typo.  Document the
+       new function gpgme_get_passphrase_cb.
+       (Progress Meter Callback): Document the new function
+       gpgme_get_progress_cb.
+
+2002-04-16  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Creating a Signature): Fix function name.  Reported
+       by Wichert Ackerman <wichert@debian.org>.
+
+2002-03-29  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (direntry): End index entry with a full stop.
+       Patch submitted by Jose Carlos Garcia Sogo <jsogo@debian.org>.
+       
 2002-03-17  Marcus Brinkmann  <marcus@g10code.de>
 
        * gpgme.texi (Detailed Results): Fix syntax error in last change.
        * fdl.texi: Likewise.
        * Makefile.am (info_TEXINFOS): New variable.
        (gpgme_TEXINFOS): Likewise.
+
+ Copyright 2002 g10 Code GmbH
+
+ This file is free software; as a special exception the author gives
+ unlimited permission to copy and/or distribute it, with or without
+ modifications, as long as this notice is preserved.
+
+ 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.