[svn] GnuPG - r4831 - trunk/doc

[svn author dshaw]

Author: dshaw
Date: 2008-09-23 21:18:52 +0200 (Tue, 23 Sep 2008)
New Revision: 4831

Modified:
   trunk/doc/ChangeLog
   trunk/doc/gpg.texi
Log:
* gpg.texi (OpenPGP Key Management): Clarify setpref a bit.


Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog	2008-09-23 15:42:11 UTC (rev 4830)
+++ trunk/doc/ChangeLog	2008-09-23 19:18:52 UTC (rev 4831)
@@ -1,3 +1,7 @@
+2008-09-23  David Shaw  <dshaw at jabberwocky.com>
+
+	* gpg.texi (OpenPGP Key Management): Clarify setpref a bit.
+
 2008-08-30  Werner Koch  <wk at g10code.com>
 
 	* yat2m.c (write_th): Print a not ethat this is generated source.

Modified: trunk/doc/gpg.texi
===================================================================
--- trunk/doc/gpg.texi	2008-09-23 15:42:11 UTC (rev 4830)
+++ trunk/doc/gpg.texi	2008-09-23 19:18:52 UTC (rev 4831)
@@ -754,13 +754,24 @@
 Set the list of user ID preferences to @code{string} for all (or just
 the selected) user IDs. Calling setpref with no arguments sets the
 preference list to the default (either built-in or set via
- at option{--default-preference-list}), and calling setpref with "none" as
-the argument sets an empty preference list. Use @command{@gpgname
+ at option{--default-preference-list}), and calling setpref with "none"
+as the argument sets an empty preference list. Use @command{@gpgname
 --version} to get a list of available algorithms. 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.
 
+When setting preferences, you should list the algorithms in the order
+which you'd like to see them used by someone else when encrypting a
+message to your key.  If you don't include 3DES, it will be
+automatically added at the end.  Note that there are many factors that
+go into choosing an algorithm (for example, your key may not be the
+only recipient), and so the remote OpenPGP application being used to
+send to you may or may not follow your exact chosen order for a given
+message.  It will, however, only choose an algorithm that is present
+on the preference list of every recipient key.  See also the
+INTEROPERABILITY WITH OTHER OPENPGP PROGRAMS section below.
+
 @item keyserver
 @opindex keyedit:keyserver
 Set a preferred keyserver for the specified user ID(s). This allows