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 <Sebastian@SSpaeth.de>
This commit is contained in:
Sebastian Spaeth 2012-01-08 01:06:56 +01:00
parent 15b4a7a5b9
commit 0a275b9532

View File

@ -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