From 984d611a438768f07b27a5af8202d9f7739be1ab Mon Sep 17 00:00:00 2001 From: Marcus Brinkmann Date: Tue, 29 Apr 2003 22:24:37 +0000 Subject: doc/ 2003-04-29 Marcus Brinkmann * gpgme.texi (Listing Keys): Remove force_update argument from gpgme_get_key. gpgme/ 2003-04-29 Marcus Brinkmann * gpgme.h (gpgme_get_key): Remove force_update argument. * key-cache.c: File removed. * Makefile.am (libgpgme_la_SOURCES): Remove key-cache.c. * ops.h (_gpgme_key_cache_add, _gpgme_key_cache_get): Remove prototypes. * keylist.c (_gpgme_op_keylist_event_cb): Don't call _gpgme_key_cache_add. (gpgme_get_key): New function. * verify.c (gpgme_get_sig_key): Remove last argument to gpgme_get_key invocation. --- doc/ChangeLog | 3 +++ doc/gpgme.texi | 14 ++++++-------- 2 files changed, 9 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index a7430878..6d69fa7a 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,5 +1,8 @@ 2003-04-29 Marcus Brinkmann + * 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. diff --git a/doc/gpgme.texi b/doc/gpgme.texi index 838a262b..6ba91632 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -1917,15 +1917,13 @@ if (err) In a simple program, for which a blocking operation is acceptable, the following function can be used to retrieve a single key. -@deftypefun GpgmeError gpgme_get_key (@w{GpgmeCtx @var{ctx}}, @w{const char *@var{fpr}}, @w{GpgmeKey *@var{r_key}}, @w{int @var{secret}}, @w{int @var{force_update}}) +@deftypefun GpgmeError gpgme_get_key (@w{GpgmeCtx @var{ctx}}, @w{const char *@var{fpr}}, @w{GpgmeKey *@var{r_key}}, @w{int @var{secret}}) The function @code{gpgme_get_key} gets the key with the fingerprint -(or key ID) @var{fpr} from the key cache or from the crypto backend -and return it in @var{r_key}. If @var{force_update} is true, force a -refresh of the key from the crypto backend and replace the key in the -cache, if any. If @var{secret} is true, get the secret key. - -If the @code{GPGME_KEYLIST_MODE_SIGS} mode is active, the key will be -retrieved with the key signatures (and updated if necessary). +(or key ID) @var{fpr} from the crypto backend and return it in +@var{r_key}. If @var{force_update} is true, force a refresh of the +key from the crypto backend and replace the key in the cache, if any. +If @var{secret} is true, get the secret key. The currently active +keylist mode is used to retrieve the key. The function returns @code{GPGME_Invalid_Value} if @var{ctx} or @var{r_key} is not a valid pointer, @code{GPGME_Invalid_Key} if -- cgit v1.2.3