[Emacs-diffs] master fd6f4bf: nnimap.el: support additional expunge options

[Lars Ingebrigtsen]

branch: master
commit fd6f4bf648c5a4417eb591a8c54b87c7c60de154
Author: Nikolaus Rath <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    nnimap.el: support additional expunge options
    
    * lisp/gnus/nnimap.el (nnimap-close-group)
    (nnimap-request-expire-articles, nnimap-delete-article)
    (nnimap-request-scan): Add new 'never, 'immediate, and 'on-exit
    settings for nnimap-expunge (bug#20670).
---
 doc/misc/gnus.texi  | 16 +++++++++--
 etc/NEWS            | 10 +++++++
 lisp/gnus/nnimap.el | 80 +++++++++++++++++++++++++++++------------------------
 3 files changed, 67 insertions(+), 39 deletions(-)

diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index d8a257b..15b1085 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -14305,9 +14305,19 @@ specific login method to be used, you can set this 
variable to either
 @code{plain} or @code{cram-md5}.
 
 @item nnimap-expunge
-If non-@code{nil}, expunge articles after deleting them.  This is always done
-if the server supports UID EXPUNGE, but it's not done by default on
-servers that doesn't support that command.
+When to expunge deleted messages.  If @code{never}, deleted articles
+are marked with the IMAP @code{\\Delete} flag but not automatically
+expunged. If @code{immediately}, deleted articles are immediately expunged
+(this requires the server to support the UID EXPUNGE command). If
+@code{on-exit}, deleted articles are flagged, and all flagged articles are
+expunged when the group is closed.
+
+For backwards compatibility, this variable may also be set to t
+or nil. If the server supports UID EXPUNGE, both t and nil are
+equivalent to @code{immediately}. If the server does not support UID
+EXPUNGE nil is equivalent to @code{never}, while t will immediately
+expunge ALL articles that are currently flagged as deleted
+(i.e., potentially not only the article that was just deleted).
 
 @item nnimap-streaming
 Virtually all @acronym{IMAP} server support fast streaming of data.
diff --git a/etc/NEWS b/etc/NEWS
index afeb387..9735a55 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1044,6 +1044,16 @@ Of course it will still find it if you have it in 
'~/.ecompleterc'.
 ** Gnus
 
 +++
+** The Gnus user variable 'nnimap-expunge' supports three new values:
+'never' for never expunging messages, 'immediately' for immediately
+expunging deleted messages, and 'on-exit' to expunge deleted articles
+when exiting the group's summary buffer. Setting 'nnimap-expunge' to
+'nil' or 't' is still supported but not recommended, since it may
+result in Gnus expunging all messages that have been flagged as
+deleted by any IMAP client (rather than just those that have been
+deleted by Gnus).
+
++++
 *** New option 'gnus-use-atomic-windows' makes Gnus window layouts
 atomic.  See the "Atomic Windows" section of the Elisp manual for
 details.
diff --git a/lisp/gnus/nnimap.el b/lisp/gnus/nnimap.el
index 363e418..345667b 100644
--- a/lisp/gnus/nnimap.el
+++ b/lisp/gnus/nnimap.el
@@ -102,10 +102,21 @@ Uses the same syntax as `nnmail-split-methods'.")
 Possible choices are nil (use default methods), `anonymous',
 `login', `plain' and `cram-md5'.")
 
-(defvoo nnimap-expunge t
-  "If non-nil, expunge articles after deleting them.
-This is always done if the server supports UID EXPUNGE, but it's
-not done by default on servers that doesn't support that command.")
+(defvoo nnimap-expunge 'on-exit
+  "When to expunge deleted messages.
+If 'never, deleted articles are marked with the IMAP \\Delete
+flag but not automatically expunged. If 'immediately, deleted
+articles are immediately expunged (this requires the server to
+support the UID EXPUNGE command). If 'on-exit, deleted articles
+are flagged, and all flagged articles are expunged when the
+group is closed.
+
+For backwards compatibility, this variable may also be set to t
+or nil. If the server supports UID EXPUNGE, both t and nil are
+equivalent to 'immediately. If the server does not support UID
+EXPUNGE nil is equivalent to 'never, while t will immediately
+expunge ALL articles that are currently flagged as deleted
+(i.e., potentially not only the article that was just deleted).")
 
 (defvoo nnimap-streaming t
   "If non-nil, try to use streaming commands with IMAP servers.
@@ -944,8 +955,11 @@ textual parts.")
              articles)))
     (nreverse articles)))
 
-(deffoo nnimap-close-group (_group &optional _server)
-  t)
+(deffoo nnimap-close-group (_group &optional server)
+  (when (eq nnimap-expunge 'on-exit)
+    (nnoo-change-server 'nnimap server nil)
+    (with-current-buffer (nnimap-buffer)
+      (nnimap-command "EXPUNGE"))))
 
 (deffoo nnimap-request-move-article (article group server accept-form
                                             &optional _last
@@ -990,8 +1004,7 @@ textual parts.")
     articles)
    ((and force
         (eq nnmail-expiry-target 'delete))
-    (unless (nnimap-delete-article (gnus-compress-sequence articles))
-      (nnheader-message 7 "Article marked for deletion, but not expunged."))
+    (nnimap-delete-article (gnus-compress-sequence articles))
     nil)
    (t
     (let ((deletable-articles
@@ -1111,20 +1124,33 @@ If LIMIT, first try to limit the search to the N last 
articles."
               (nnimap-find-article-by-message-id group server 
message-id))))))))
 
 (defun nnimap-delete-article (articles)
+  "Delete ARTICLES."
   (with-current-buffer (nnimap-buffer)
     (nnimap-command "UID STORE %s +FLAGS.SILENT (\\Deleted)"
                    (nnimap-article-ranges articles))
     (cond
+     ((eq nnimap-expunge 'immediately)
+      (if (nnimap-capability "UIDPLUS")
+         (nnimap-command "UID EXPUNGE %s"
+                         (nnimap-article-ranges articles))
+       (nnheader-message
+        3 (concat "nnimap-expunge set to 'immediately, but "
+                  "server doesn't support UIDPLUS"))
+       nil))
+
+     ((memq nnimap-expunge '(on-exit never)) nil)
+
      ((nnimap-capability "UIDPLUS")
       (nnimap-command "UID EXPUNGE %s"
-                     (nnimap-article-ranges articles))
-      t)
+                     (nnimap-article-ranges articles)))
+
      (nnimap-expunge
-      (nnimap-command "EXPUNGE")
-      t)
-     (t (gnus-message 7 (concat "nnimap: nnimap-expunge is not set and the "
-                                "server doesn't support UIDPLUS, so we won't "
-                                "delete this article now"))))))
+      (nnimap-command "EXPUNGE"))
+
+     (t
+      (nnheader-message
+       7 "Article marked for deletion, but not expunged.")
+      nil))))
 
 (deffoo nnimap-request-scan (&optional group server)
   (when (and (nnimap-change-group nil server)
@@ -2149,27 +2175,9 @@ Return the server's response to the SELECT or EXAMINE 
command."
              (nnimap-wait-for-response (caar sequences))
              ;; And then mark the successful copy actions as deleted,
              ;; and possibly expunge them.
-             (nnimap-mark-and-expunge-incoming
-              (nnimap-parse-copied-articles sequences)))
-            (nnimap-mark-and-expunge-incoming junk-articles)))))))
-
-(defun nnimap-mark-and-expunge-incoming (range)
-  (when range
-    (setq range (nnimap-article-ranges range))
-    (erase-buffer)
-    (let ((sequence
-          (nnimap-send-command
-           "UID STORE %s +FLAGS.SILENT (\\Deleted)" range)))
-      (cond
-       ;; If the server supports it, we now delete the message we have
-       ;; just copied over.
-       ((nnimap-capability "UIDPLUS")
-       (setq sequence (nnimap-send-command "UID EXPUNGE %s" range)))
-       ;; If it doesn't support UID EXPUNGE, then we only expunge if the
-       ;; user has configured it.
-       (nnimap-expunge
-       (setq sequence (nnimap-send-command "EXPUNGE"))))
-      (nnimap-wait-for-response sequence))))
+              (nnimap-delete-article
+               (nnimap-parse-copied-articles sequences)))
+            (nnimap-delete-article junk-articles)))))))
 
 (defun nnimap-parse-copied-articles (sequences)
   (let (sequence copied range)