summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDavid Shaw <dshaw@jabberwocky.com>2002-07-25 22:25:59 +0200
committerDavid Shaw <dshaw@jabberwocky.com>2002-07-25 22:25:59 +0200
commit52b1efab848f2ab4491ef88b15deed2cb65abdc7 (patch)
tree9049a32c5aa4e56e94b5efe366f88a686f71a324 /doc
parent* exec.c, export.c, import.c, keyedit.c, keyserver.c, misc.c: "Warning" -> (diff)
downloadgnupg2-52b1efab848f2ab4491ef88b15deed2cb65abdc7.tar.xz
gnupg2-52b1efab848f2ab4491ef88b15deed2cb65abdc7.zip
* 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.
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog8
-rw-r--r--doc/gpg.sgml28
2 files changed, 27 insertions, 9 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index c52c1a0a9..0cea43a9a 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -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".
diff --git a/doc/gpg.sgml b/doc/gpg.sgml
index 99c0421c8..892591058 100644
--- a/doc/gpg.sgml
+++ b/doc/gpg.sgml
@@ -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>