gpgscm: Add types for special objects.
[gnupg.git] / doc / specify-user-id.texi
index 0b615b6..c49edad 100644 (file)
@@ -6,7 +6,7 @@ are only valid for @command{gpg} others are only good for
 
 @itemize @bullet
 
-@item By key Id. 
+@item By key Id.
 This format is deduced from the length of the string and its content or
 @code{0x} prefix. The key Id of an X.509 certificate are the low 64 bits
 of its SHA-1 fingerprint.  The use of key Ids is just a shortcut, for
@@ -59,16 +59,17 @@ avoids any ambiguities in case that there are duplicated key IDs.
 @end cartouche
 
 @noindent
-(@command{gpgsm} also accepts colons between each pair of hexadecimal
+@command{gpgsm} also accepts colons between each pair of hexadecimal
 digits because this is the de-facto standard on how to present X.509
-fingerprints.)
+fingerprints.  @command{gpg} also allows the use of the space
+separated SHA-1 fingerprint as printed by the key listing commands.
 
 @item By exact match on OpenPGP user ID.
 This is denoted by a leading equal sign. It does not make sense for
 X.509 certificates.
 
 @cartouche
-@example 
+@example
 =Heinrich Heine <heinrichh@@uni-duesseldorf.de>
 @end example
 @end cartouche
@@ -84,14 +85,14 @@ with left and right angles.
 @end cartouche
 
 
-@item By word match.
-All words must match exactly (not case sensitive) but can appear in any
-order in the user ID or a subjects name.  Words are any sequences of
-letters, digits, the underscore and all characters with bit 7 set.
+@item By partial match on an email address.
+This is indicated by prefixing the search string with an @code{@@}.
+This uses a substring search but considers only the mail address
+(i.e. inside the angle brackets).
 
 @cartouche
 @example
-+Heinrich Heine duesseldorf
+@@heinrichh
 @end example
 @end cartouche
 
@@ -121,8 +122,8 @@ This should return the Root cert of the issuer.  See note above.
 
 
 @item By exact match on serial number and issuer's DN.
-This is indicated by a hash mark, followed by the hexadecmal
-representation of the serial number, the followed by a slash and the
+This is indicated by a hash mark, followed by the hexadecimal
+representation of the serial number, then followed by a slash and the
 RFC-2253 encoded DN of the issuer. See note above.
 
 @cartouche
@@ -155,8 +156,12 @@ Heine
 @end example
 @end cartouche
 
-@end itemize
+@item . and + prefixes
+These prefixes are reserved for looking up mails anchored at the end
+and for a word search mode.  They are not yet implemented and using
+them is undefined.
 
+@end itemize
 
 Please note that we have reused the hash mark identifier which was used
 in old GnuPG versions to indicate the so called local-id.  It is not