From efa986b0980058ca74199006beb7e71ba92faee5 Mon Sep 17 00:00:00 2001 From: David Shaw Date: Mon, 25 Nov 2002 14:32:40 +0000 Subject: [PATCH] * gpg.sgml: Document --sig-policy-url, --cert-policy-url, --sig-notation, --cert-notation. Clarify --show-notation and --show-policy-url that policy URLs and notations can be used in data signatures as well. Add note about '@' being a required character in notation names. --- doc/ChangeLog | 8 ++++++++ doc/gpg.sgml | 41 +++++++++++++++++++++++++---------------- 2 files changed, 33 insertions(+), 16 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index cc3c62a5b..79f4249a2 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,11 @@ +2002-11-25 David Shaw + + * gpg.sgml: Document --sig-policy-url, --cert-policy-url, + --sig-notation, --cert-notation. Clarify --show-notation and + --show-policy-url that policy URLs and notations can be used in + data signatures as well. Add note about '@' being a required + character in notation names. + 2002-11-21 David Shaw * gpg.sgml: Add an interoperability section. diff --git a/doc/gpg.sgml b/doc/gpg.sgml index 205764f07..6df69d1ff 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -1401,50 +1401,59 @@ signatures. Use this to overwrite a previous +--sig-notation &ParmNameValue; +--cert-notation &ParmNameValue; -N, --notation-data &ParmNameValue; Put the name value pair into the signature as notation data. -&ParmName; must consist only of alphanumeric characters, digits -or the underscore; the first character must not be a digit. -&ParmValue; may be any printable string; it will be encoded in UTF8, -so you should check that your --charset is set correctly. -If you prefix &ParmName; with an exclamation mark, the notation -data will be flagged as critical (rfc2440:5.2.3.15). +&ParmName; must consist only of printable characters or spaces, and +must contain a '@' character. This is to help prevent pollution of +the IETF reserved notation namespace. The --expert flag overrides the +'@' check. &ParmValue; may be any printable string; it will be +encoded in UTF8, so you should check that your --charset is set +correctly. If you prefix &ParmName; with an exclamation mark, the +notation data will be flagged as critical (rfc2440:5.2.3.15). +--sig-notation sets a notation for data signatures. --cert-notation +sets a notation for key signatures (certifications). --notation-data +sets both. --show-notation -Show key signature notations in the --list-sigs or --check-sigs -listings. +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 -Do not show key signature notations in the --list-sigs or --check-sigs -listings. +Do not show signature notations. +--sig-policy-url &ParmString; +--cert-policy-url &ParmString; --set-policy-url &ParmString; -Use &ParmString; as Policy URL for signatures (rfc2440:5.2.3.19). -If you prefix it with an exclamation mark, the policy URL -packet will be flagged as critical. +Use &ParmString; as Policy URL for signatures (rfc2440:5.2.3.19). If +you prefix it with an exclamation mark, the policy URL packet will be +flagged as critical. --sig-policy-url sets a a policy url for data +signatures. --cert-policy-url sets a policy url for key signatures +(certifications). -set-policy-url sets both. --show-policy-url -Show any policy URLs set in the --list-sigs or --check-sigs listings. +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 -Do not show any policy URLs set in the --list-sigs or --check-sigs -listings. +Do not show policy URLs.