GpgFrontend/gpgme
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
* 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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/ChangeLog
View File

@ -1,5 +1,8 @@
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
code.
(Verify): Document the relationship between gpgme_op_verify_result

15
doc/gpgme.texi
View File

@ -2442,7 +2442,12 @@ in the list.
If @var{pattern} is @code{NULL}, all available keys are returned.
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
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
are returned. Otherwise, @var{pattern} is a @code{NULL} terminated
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
keys only.