diff options
| -rw-r--r-- | doc/ChangeLog | 8 | ||||
| -rw-r--r-- | doc/gpg.sgml | 41 |
2 files changed, 33 insertions, 16 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index f24a93b4f..0e1ca2427 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,11 @@ +2002-11-25 David Shaw <[email protected]> + + * 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 <[email protected]> * gpg.sgml: Add an interoperability section. diff --git a/doc/gpg.sgml b/doc/gpg.sgml index 45600ee2f..99ec3639e 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -1436,50 +1436,59 @@ signatures. Use this to overwrite a previous <varlistentry> +<term>--sig-notation &ParmNameValue;</term> +<term>--cert-notation &ParmNameValue;</term> <term>-N, --notation-data &ParmNameValue;</term> <listitem><para> 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. </para></listitem></varlistentry> <varlistentry> <term>--show-notation</term> <listitem><para> -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. </para></listitem></varlistentry> <varlistentry> <term>--no-show-notation</term> <listitem><para> -Do not show key signature notations in the --list-sigs or --check-sigs -listings. +Do not show signature notations. </para></listitem></varlistentry> <varlistentry> +<term>--sig-policy-url &ParmString;</term> +<term>--cert-policy-url &ParmString;</term> <term>--set-policy-url &ParmString;</term> <listitem><para> -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. </para></listitem></varlistentry> <varlistentry> <term>--show-policy-url</term> <listitem><para> -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. </para></listitem></varlistentry> <varlistentry> <term>--no-show-policy-url</term> <listitem><para> -Do not show any policy URLs set in the --list-sigs or --check-sigs -listings. +Do not show policy URLs. </para></listitem></varlistentry> <varlistentry> |