Variable: pop3-leave-mail-on-server

pop3-leave-mail-on-server is a customizable variable defined in pop3.el.gz.

Value

nil

Documentation

Non-nil if the mail is to be left on the POP server after fetching.

Mails once fetched will never be fetched again by the UIDL control.

If this is neither nil nor a number, all mails will be left on the server. If this is a number, leave mails on the server for this many days since you first checked new mails. If this is nil, mails will be deleted on the server right after fetching.

Gnus users should use the :leave keyword in a mail source to direct the behavior per server, rather than directly modifying this value.

Note that POP servers maintain no state information between sessions, so what the client believes is there and what is actually there may not match up. If they do not, then you may get duplicate mails or the whole thing can fall apart and leave you with a corrupt mailbox.

This variable was added, or its default value changed, in Emacs 24.4.

Source Code

;; Defined in /usr/src/emacs/lisp/net/pop3.el.gz
(defcustom pop3-leave-mail-on-server nil
  "Non-nil if the mail is to be left on the POP server after fetching.
Mails once fetched will never be fetched again by the UIDL control.

If this is neither nil nor a number, all mails will be left on the
server.  If this is a number, leave mails on the server for this many
days since you first checked new mails.  If this is nil, mails will be
deleted on the server right after fetching.

Gnus users should use the `:leave' keyword in a mail source to direct
the behavior per server, rather than directly modifying this value.

Note that POP servers maintain no state information between sessions,
so what the client believes is there and what is actually there may
not match up.  If they do not, then you may get duplicate mails or
the whole thing can fall apart and leave you with a corrupt mailbox."
  :version "24.4"
  :type '(choice (const :tag "Don't leave mails" nil)
		 (const :tag "Leave all mails" t)
		 (number :tag "Leave mails for this many days" :value 14))
  :group 'pop3)