2004-06-08 Marcus Brinkmann <marcus@g10code.de>

* gpgme.texi (Listing Keys): Elaborate on the length restrictions
	on search patterns.
This commit is contained in:
Marcus Brinkmann 2004-06-08 17:39:40 +00:00
parent 5236702f6f
commit 99011b0b8d
2 changed files with 16 additions and 2 deletions

View File

@ -1,5 +1,8 @@
2004-06-08 Marcus Brinkmann <marcus@g10code.de> 2004-06-08 Marcus Brinkmann <marcus@g10code.de>
* gpgme.texi (Listing Keys): Elaborate on the length restrictions
on search patterns.
* gpgme.texi (Decrypt and Verify): Document the NO_DATA error * gpgme.texi (Decrypt and Verify): Document the NO_DATA error
code. code.
(Verify): Document the relationship between gpgme_op_verify_result (Verify): Document the relationship between gpgme_op_verify_result

View File

@ -2442,7 +2442,12 @@ in the list.
If @var{pattern} is @code{NULL}, all available keys are returned. If @var{pattern} is @code{NULL}, all available keys are returned.
Otherwise, @var{pattern} contains an engine specific expression that Otherwise, @var{pattern} contains an engine specific expression that
is used to limit the list to all keys matching the pattern. is used to limit the list to all keys matching the pattern. Note that
the total length of the pattern is restricted to an engine-specific
maximum (a couple of hundred characters are usually accepted). The
pattern should be used to restrict the search to a certain common name
or user, not to list many specific keys at once by listing their
fingerprints or key IDs.
If @var{secret_only} is not @code{0}, the list is restricted to secret If @var{secret_only} is not @code{0}, the list is restricted to secret
keys only. keys only.
@ -2465,7 +2470,13 @@ everything up so that subsequent invocations of
If @var{pattern} or @var{*pattern} is @code{NULL}, all available keys If @var{pattern} or @var{*pattern} is @code{NULL}, all available keys
are returned. Otherwise, @var{pattern} is a @code{NULL} terminated are returned. Otherwise, @var{pattern} is a @code{NULL} terminated
array of strings that are used to limit the list to all keys matching array of strings that are used to limit the list to all keys matching
at least one of the patterns verbatim. at least one of the patterns verbatim. Note that the total length of
all patterns is restricted to an engine-specific maximum (the exact
limit also depends on the number of patterns and amount of quoting
required, but a couple of hundred characters are usually accepted).
Patterns should be used to restrict the search to a certain common
name or user, not to list many specific keys at once by listing their
fingerprints or key IDs.
If @var{secret_only} is not @code{0}, the list is restricted to secret If @var{secret_only} is not @code{0}, the list is restricted to secret
keys only. keys only.