From a01a08f9e1e3a93df57edff679d529a1b4da6890 Mon Sep 17 00:00:00 2001 From: David Shaw Date: Tue, 26 Aug 2003 00:32:58 +0000 Subject: [PATCH] * gpg.sgml: Document --list-options (show-photos, show-policy-url, show-notation, show-keyring) and --verify-options (show-photos, show-policy-url, show-notation). Deprecate --show-photos, --show-policy-url, --show-notation, and --show-keyring. --- doc/ChangeLog | 11 ++++-- doc/gpg.sgml | 97 ++++++++++++++++++++++++++++++++++++++++++++------- 2 files changed, 94 insertions(+), 14 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 05366c345..b8a85ed72 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2003-08-25 David Shaw + + * gpg.sgml: Document --list-options (show-photos, show-policy-url, + show-notation, show-keyring) and --verify-options (show-photos, + show-policy-url, show-notation). Deprecate --show-photos, + --show-policy-url, --show-notation, and --show-keyring. + 2003-07-10 David Shaw * DETAILS: Document the --attribute-fd data. @@ -7,8 +14,8 @@ the homedir. Add pointer in --ignore-time-conflict to see --ignore-valid from, and vice versa. Warning not to try and parse --list-keys in scripts. Document the signature flags - (1-3/L/R/P/N/X), Document expandos %g and %p. Note the default - --personal-digest-preferences are "H2". + (1-3/L/R/P/N/X/T), Document expandos %g and %p. Note the default + --personal-digest-preferences are SHA-1. 2003-05-26 David Shaw diff --git a/doc/gpg.sgml b/doc/gpg.sgml index 928a7a504..cd5de6313 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -1218,20 +1218,92 @@ Include designated revoker information that was marked as + +--list-options parameters + +This is a space or comma delimited string that gives options used when +listing keys and signatures (that is, --list-keys, --list-sigs, +--list-public-keys, and --list-secret-keys). Options can be prepended +with a `no-' to give the opposite meaning. The options are: + + + +show-photos + +Causes --list-keys, --list-sigs, --list-public-keys, and +--list-secret-keys to display any photo IDs attached to the key. +Defaults to no. See also --photo-viewer. + + + +show-policy-url + +Show policy URLs in the --list-sigs or --check-sigs listings. +Defaults to no. + + + +show-notation + +Show signature notations in the --list-sigs or --check-sigs listings. +Defaults to no. + + + +show-keyring + +Display the keyring name at the head of key listings to show which +keyring a given key resides on. Defaults to no. + + + + + + +--verify-options parameters + +This is a space or comma delimited string that gives options used when +verifying signatures. Options can be prepended with a `no-' to give +the opposite meaning. The options are: + + + +show-photos + +Display any photo IDs present on the key that issued the signature. +Defaults to no. See also --photo-viewer. + + + +show-policy-url + +Show policy URLs in the signature being verified. Defaults to no. + + + +show-notation + +Show signature notations in the signature being verified. Defaults to +no. + + + + + --show-photos --no-show-photos Causes --list-keys, --list-sigs, --list-public-keys, --list-secret-keys, and verifying a signature to also display the -photo ID attached to the key, if any. See also --photo-viewer. ---no-show-photos disables this option. +photo ID attached to the key, if any. See also --photo-viewer. These +options are deprecated. Use `--list-options [no-]show-photos' and/or +`--verify-options [no-]show-photos' instead. --photo-viewer &ParmString; - This is the command line that should be run to view a photo ID. "%i" will be expanded to a filename containing the photo. "%I" does the same, except the file will not be deleted once the viewer exits. @@ -1258,10 +1330,9 @@ variable. --show-keyring -Causes --list-keys, --list-public-keys, and --list-secret-keys to -display the name of the keyring a given key resides on. This is only -useful when you're listing a specific key or set of keys. It has no -effect when listing all keys. +Display the keyring name at the head of key listings to show which +keyring a given key resides on. This option is deprecated: use +`--list-options [no-]show-keyring' instead. @@ -1517,8 +1588,9 @@ making the signature, and "%%" results in a single "%". %k, %K, and --no-show-notation Show signature notations in the --list-sigs or --check-sigs listings -as well as when verifying a signature with a notation in it. ---no-show-notation disables this option. +as well as when verifying a signature with a notation in it. These +options are deprecated. Use `--list-options [no-]show-notation' +and/or `--verify-options [no-]show-notation' instead. @@ -1541,8 +1613,9 @@ The same %-expandos used for notation data are available here as well. --no-show-policy-url Show policy URLs in the --list-sigs or --check-sigs listings as well -as when verifying a signature with a policy URL in it. ---no-show-policy-url disables this option. +as when verifying a signature with a policy URL in it. These options +are deprecated. Use `--list-options [no-]show-policy-url' and/or +`--verify-options [no-]show-policy-url' instead. @@ -2295,7 +2368,7 @@ the edit menu. This allows the user to factor in their own preferred algorithms when algorithms are chosen via recipient key preferences. The most highly ranked digest algorithm in this list is algo used when signing without encryption (e.g. --clearsign or --sign). The default -value is "H2" indicating SHA-1. +value is SHA-1.