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

	* gpgme.texi (Listing Keys): Elaborate on the length restrictions
	on search patterns.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index d21275e405f6de546fb5ccf8bc3d981578fffd2c..7b780bf18549e7549fdd48dfd1b19bb368d238cc 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -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

diff --git a/doc/gpgme.texi b/doc/gpgme.texi
index c1f9e61c58e340d1b60b004fb0acf7a20147407c..76388b67ef91875b19854958b8af67d0b6f56c6f 100644 (file)
--- 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.