diff options
| author | Marcus Brinkmann <[email protected]> | 2004-06-08 17:39:40 +0000 |
|---|---|---|
| committer | Marcus Brinkmann <[email protected]> | 2004-06-08 17:39:40 +0000 |
| commit | 99011b0b8dc74ae288ff4454463afee1ebc8e98b (patch) | |
| tree | aa04efb574b9dc0e56d9db8cded701bffb252ad3 | |
| parent | 2004-06-08 Marcus Brinkmann <[email protected]> (diff) | |
| download | gpgme-99011b0b8dc74ae288ff4454463afee1ebc8e98b.tar.gz gpgme-99011b0b8dc74ae288ff4454463afee1ebc8e98b.zip | |
2004-06-08 Marcus Brinkmann <[email protected]>
* gpgme.texi (Listing Keys): Elaborate on the length restrictions
on search patterns.
| -rw-r--r-- | doc/ChangeLog | 3 | ||||
| -rw-r--r-- | doc/gpgme.texi | 15 |
2 files changed, 16 insertions, 2 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index d21275e4..7b780bf1 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,5 +1,8 @@ 2004-06-08 Marcus Brinkmann <[email protected]> + * 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 diff --git a/doc/gpgme.texi b/doc/gpgme.texi index c1f9e61c..76388b67 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -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. |