From 18388f93abb064b2bcd1010242b47eb696dabf6d Mon Sep 17 00:00:00 2001 From: Werner Koch Date: Mon, 15 Jan 2024 11:12:29 +0100 Subject: [PATCH] doc: Add a deprecated warning to gpgme_op_delete. --- doc/gpgme.texi | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/gpgme.texi b/doc/gpgme.texi index f5104f20..36b775a1 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -5377,16 +5377,19 @@ operation was started successfully, and @code{GPG_ERR_INV_VALUE} if @var{ctx} or @var{key} is not a valid pointer. @end deftypefun -The following functions allow only to use one particular flag. +The following functions allow only to use one particular flag. Their +use is thus deprecated. @deftypefun gpgme_error_t gpgme_op_delete (@w{gpgme_ctx_t @var{ctx}}, @w{const gpgme_key_t @var{key}}, @w{int @var{allow_secret}}) Similar to @code{gpgme_op_delete_ext}, but only the flag -@code{GPGME_DELETE_ALLOW_SECRET} can be provided. +@code{GPGME_DELETE_ALLOW_SECRET} can be provided. Actually all true +values are mapped to this flag. @end deftypefun @deftypefun gpgme_error_t gpgme_op_delete_start (@w{gpgme_ctx_t @var{ctx}}, @w{const gpgme_key_t @var{key}}, @w{int @var{allow_secret}}) Similar to @code{gpgme_op_delete_ext_start}, but only the flag -@code{GPGME_DELETE_ALLOW_SECRET} can be provided. +@code{GPGME_DELETE_ALLOW_SECRET} can be provided. Actually all true +values are mapped to this flag. @end deftypefun