* gpg.sgml: Clarify the differences between "pref" and "showpref". Note in
authorDavid Shaw <dshaw@jabberwocky.com>
Thu, 25 Jul 2002 20:25:59 +0000 (20:25 +0000)
committerDavid Shaw <dshaw@jabberwocky.com>
Thu, 25 Jul 2002 20:25:59 +0000 (20:25 +0000)
"setpref" that a list of available algorithms can be printed with "gpg -v
--version".  Note in "updpref" that we don't select keys via attribute
uids, so preferences there will be ignored.

doc/ChangeLog
doc/gpg.sgml

index c52c1a0..0cea43a 100644 (file)
@@ -1,3 +1,11 @@
+2002-07-25  David Shaw  <dshaw@jabberwocky.com>
+
+       * gpg.sgml: Clarify the differences between "pref" and "showpref".
+       Note in "setpref" that a list of available algorithms can be
+       printed with "gpg -v --version".  Note in "updpref" that we don't
+       select keys via attribute uids, so preferences there will be
+       ignored.
+
 2002-07-01  David Shaw  <dshaw@jabberwocky.com>
 
        * gpg.sgml: Clarify "group".
index 99c0421..8925910 100644 (file)
@@ -397,27 +397,37 @@ id.</para></listitem></varlistentry>
     <varlistentry>
     <term>pref</term>
     <listitem><para>
-List preferences.</para></listitem></varlistentry>
+List preferences from the selected user ID.  This shows the actual
+preferences, without including any implied preferences.
+</para></listitem></varlistentry>
     <varlistentry>
     <term>showpref</term>
     <listitem><para>
-More verbose preferences listing.</para></listitem></varlistentry>
+More verbose preferences listing for the selected user ID.  This shows
+the preferences in effect by including the implied preferences of
+3DES (cipher), SHA-1 (digest), and Uncompressed (compression) if they
+are not already included in the preference list.
+</para></listitem></varlistentry>
     <varlistentry>
     <term>setpref &ParmString;</term>
     <listitem><para>
-Set the list of user ID preferences to &ParmString;, this should be 
-a string similar to the one printed by "pref".  Using an empty string
-will set the default preference string, using "none" will set the 
-preferences to nil.  Only available algorithms are allowed.  This
-command just initializes an internal list and does not change anything
-unless another command which changes the self-signatures is used.
+Set the list of user ID preferences to &ParmString;, this should be a
+string similar to the one printed by "pref".  Using an empty string
+will set the default preference string, using "none" will set the
+preferences to nil.  Use "gpg -v --version" to get a list of available
+algorithms.  This command just initializes an internal list and does
+not change anything unless another command (such as "updpref") which
+changes the self-signatures is used.
 </para></listitem></varlistentry>
     <varlistentry>
     <term>updpref</term>
     <listitem><para>
 Change the preferences of all user IDs (or just of the selected ones
 to the current list of preferences.  The timestamp of all affected
-self-signatures fill be advanced by one second.
+self-signatures will be advanced by one second.  Note that while you
+can change the preferences on an attribute user ID (aka "photo ID"),
+GnuPG does not select keys via attribute user IDs so these preferences
+will not be used by GnuPG.
 </para></listitem></varlistentry>
     <varlistentry>
     <term>toggle</term>