* DETAILS: Document "uat".

* gpg.sgml: Document --personal-{compress|digest|compress}-preferences,
--group, and add comments to --expert.

3 files changed, 51 insertions, 10 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 06638f9a1..1832da00a 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,11 @@
+2002-06-21  David Shaw  <[email protected]>
+
+	* DETAILS: Document "uat".
+
+	* gpg.sgml: Document
+	--personal-{compress|digest|compress}-preferences, --group, and
+	add comments to --expert.
+
 2002-06-17  Werner Koch  <[email protected]>
 
 	* gpg.sgml: Grammar fix.
diff --git a/doc/DETAILS b/doc/DETAILS
index 6120fc61f..9170d5b93 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -29,6 +29,7 @@ record.
 	    sec = secret key
 	    ssb = secret subkey (secondary key)
 	    uid = user id (only field 10 is used).
+	    uat = user attribute (same as user id except for field 10).
             sig = signature
             rev = revocation signature
 	    fpr = fingerprint: (fingerprint is in field 10)
@@ -65,7 +66,9 @@ record.
 	    information may follow in some future versions.
 10. Field:  User-ID.  The value is quoted like a C string to avoid
 	    control characters (the colon is quoted "\x3a").
-            This is not used with --fixed-list-mode in gpg. 
+            This is not used with --fixed-list-mode in gpg.
+            A UAT record puts the attribute subpacket count here, a
+	    space, and then the total attribute subpacket size.
             In gpgsm the issuer name comes here
             An FPR record stores the fingerprint here.
             The fingerprint of an revocation key is stored here.
diff --git a/doc/gpg.sgml b/doc/gpg.sgml
index 59d9c9edf..145ad7c52 100644
--- a/doc/gpg.sgml
+++ b/doc/gpg.sgml
@@ -1,5 +1,5 @@
 <!-- gpg.sgml - the man page for GnuPG
-    Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
+    Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
 
     This file is part of GnuPG.
 
@@ -1928,9 +1928,11 @@ Resets the --ask-cert-expire option.
 <listitem><para>
 Allow the user to do certain nonsensical or "silly" things like
 signing an expired or revoked key, or certain potentially incompatible
-things like generating deprecated key types.  In general, this option
-is for experts only.  If you don't fully understand the implications
-of what it allows you to do, leave this off.
+things like generating deprecated key types.  This also disables
+certain warning messages about potentially incompatible actions.  As
+the name implies, this option is for experts only.  If you don't fully
+understand the implications of what it allows you to do, leave this
+off.
 </para></listitem></varlistentry
 
 <varlistentry>
@@ -1975,6 +1977,15 @@ Experimental use only.
 </para></listitem></varlistentry>
 
 <varlistentry>
+<term>--group &ParmNameValue;</term>
+<listitem><para>
+Sets up a name group, which is similar to aliases in email programs.
+Any time the group name is a receipient (-r or --recipient), it will
+be expanded to the values specified.  Note there is only one level of
+expansion - you cannot make an group that points to another group.
+</para></listitem></varlistentry>
+
+<varlistentry>
 <term>--preserve-permissions</term>
 <listitem><para>
 Don't change the permissions of a secret keyring back to user
@@ -1982,16 +1993,35 @@ read/write only.  Use this option only if you really know what you are doing.
 </para></listitem></varlistentry>
 
 <varlistentry>
-<term>--personal-preference-list &ParmString</term>
+<term>--personal-cipher-preferences &ParmString;</term>
 <listitem><para>
-Set the list of personal preferences to &ParmString;, this list should
-be a string similar to the one printed by the command "pref" in the
-edit menu.  This allows the user to factor in their own preferred
+Set the list of personal cipher preferences to &ParmString;, this list
+should be a string similar to the one printed by the command "pref" in
+the edit menu.  This allows the user to factor in their own preferred
+algorithms when algorithms are chosen via recipient key preferences.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>--personal-digest-preferences &ParmString;</term>
+<listitem><para>
+Set the list of personal digest preferences to &ParmString;, this list
+should be a string similar to the one printed by the command "pref" in
+the edit menu.  This allows the user to factor in their own preferred
 algorithms when algorithms are chosen via recipient key preferences.
 </para></listitem></varlistentry>
 
 <varlistentry>
-<term>--default-preference-list &ParmString</term>
+<term>--personal-compress-preferences &ParmString;</term>
+<listitem><para>
+Set the list of personal compression preferences to &ParmString;, this
+list should be a string similar to the one printed by the command
+"pref" in the edit menu.  This allows the user to factor in their own
+preferred algorithms when algorithms are chosen via recipient key
+preferences.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>--default-preference-list &ParmString;</term>
 <listitem><para>
 Set the list of default preferences to &ParmString;, this list should
 be a string similar to the one printed by the command "pref" in the