[Emacs-diffs] /srv/bzr/emacs/trunk r105935: Clarify plstore-select-keys documentation.

[Daiki Ueno]

------------------------------------------------------------
revno: 105935
committer: Daiki Ueno <address@hidden>
branch nick: trunk
timestamp: Tue 2011-09-27 15:01:27 +0900
message:
  Clarify plstore-select-keys documentation.
  
  * plstore.el (plstore-select-keys, plstore-encrypt-to): Clarify
  documentation.
modified:
  lisp/gnus/ChangeLog
  lisp/gnus/plstore.el

=== modified file 'lisp/gnus/ChangeLog'
--- a/lisp/gnus/ChangeLog       2011-09-26 22:53:59 +0000
+++ b/lisp/gnus/ChangeLog       2011-09-27 06:01:27 +0000
@@ -1,3 +1,8 @@
+2011-09-27  Daiki Ueno  <address@hidden>
+
+       * plstore.el (plstore-select-keys, plstore-encrypt-to): Clarify
+       documentation.
+
 2011-09-26  Lars Magne Ingebrigtsen  <address@hidden>
 
        * nnimap.el (nnimap-wait-for-response): Message less (bug#9540).

=== modified file 'lisp/gnus/plstore.el'
--- a/lisp/gnus/plstore.el      2011-09-10 23:30:53 +0000
+++ b/lisp/gnus/plstore.el      2011-09-27 06:01:27 +0000
@@ -80,9 +80,10 @@
   "Control whether or not to pop up the key selection dialog.
 
 If t, always asks user to select recipients.
-If nil, query user only when `plstore-encrypt-to' is not set.
-If neither t nor nil, doesn't ask user.  In this case, symmetric
-encryption is used."
+If nil, query user only when a file's default recipients are not
+known (i.e. `plstore-encrypt-to' is not locally set in the buffer
+visiting a plstore file).
+If neither t nor nil, doesn't ask user."
   :type '(choice (const :tag "Ask always" t)
                 (const :tag "Ask when recipients are not set" nil)
                 (const :tag "Don't ask" silent))
@@ -90,7 +91,8 @@
 
 (defvar plstore-encrypt-to nil
   "*Recipient(s) used for encrypting secret entries.
-May either be a string or a list of strings.")
+May either be a string or a list of strings.  If it is nil,
+symmetric encryption will be used.")
 
 (put 'plstore-encrypt-to 'safe-local-variable
      (lambda (val)