From 0a275b9532a8de3be445dfc3b78e5d3bdb61199b Mon Sep 17 00:00:00 2001 From: Sebastian Spaeth Date: Sun, 8 Jan 2012 01:06:56 +0100 Subject: [PATCH] Add scary warnings about "realdelete" option WARNING: I consider the Gmail "realdelete" option as harmful with the potential for DATALOSS. Add scary warnings to offlineimap.conf. See the analysis at http://article.gmane.org/gmane.mail.imap.offlineimap.general/5265 Deleting a message from a Gmail folder via the IMAP interface will just remove that folder's label from the message: the message will continue to exist in the '[Gmail]/All Mail' folder. If `realdelete` is set to `True`, then deleted messages will be moved to the '[Gmail]/Trash' folder. BEWARE: this will immediately delete a messages from *all folders* it belongs to! AS OFFLINEIMAP IMPLEMENTS FOLDER MOVES AS 1) AN ADD and 2) A DELETE (the order can vary), THIS MEANS THAT A FOLDER MOVE CAN CAUSE DATALOSS. DO NOT USE IT AND MOVE MAIL TO "[Gmail]/Trash" TO DELETE MAIL FROM "[Gmail]/All Mail"! We will need to discuss whether to completely disable that feature. Signed-off-by: Sebastian Spaeth --- offlineimap.conf | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/offlineimap.conf b/offlineimap.conf index 71ea2f7..c7f7d9d 100644 --- a/offlineimap.conf +++ b/offlineimap.conf @@ -546,16 +546,20 @@ type = Gmail # Specify the Gmail user name. This is the only mandatory parameter. remoteuser = username@gmail.com -# Deleting a message from a Gmail folder via the IMAP interface will -# just remove that folder's label from the message: the message will -# continue to exist in the '[Gmail]/All Mail' folder. If `realdelete` -# is set to `True`, then deleted messages will really be deleted -# during `offlineimap` sync, by moving them to the '[Gmail]/Trash' -# folder. BEWARE: this will delete a messages from *all folders* it -# belongs to! -# -# See http://mail.google.com/support/bin/answer.py?answer=77657&topic=12815 -realdelete = no +# WARNING: READ THIS BEFORE CONSIDERING TO CHANGE IT! Deleting a +# message from a Gmail folder via the IMAP interface will just remove +# that folder's label from the message: the message will continue to +# exist in the '[Gmail]/All Mail' folder. If `realdelete` is set to +# `True`, then deleted messages will be moved to the '[Gmail]/Trash' +# folder. BEWARE: this will immediately delete a messages from *all +# folders* it belongs to! AS OFFLINEIMAP IMPLEMENTS FOLDER MOVES AS 1) +# AN ADD and 2) A DELETE (the order can vary), THIS MEANS THAT A FOLDER +# MOVE CAN CAUSE DATALOSS. DO NOT USE IT AND MOVE MAIL TO +# "[Gmail]/Trash" TO DELETE MAIL FROM "[Gmail]/All Mail"! See the +# analysis at +# http://article.gmane.org/gmane.mail.imap.offlineimap.general/5265 See +# http://mail.google.com/support/bin/answer.py?answer=77657&topic=12815 +# realdelete = no !!!READ ABOVE BEFORE USING # The trash folder name may be different from [Gmail]/Trash # for example on german googlemail, this setting should be