* 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.
This commit is contained in:
David Shaw 2002-11-25 14:34:08 +00:00
parent 1289ab78e1
commit 6122c65b61
2 changed files with 33 additions and 16 deletions

View File

@ -1,3 +1,11 @@
2002-11-25 David Shaw <dshaw@jabberwocky.com>
* 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 <dshaw@jabberwocky.com>
* gpg.sgml: Add an interoperability section.

View File

@ -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>