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. # Specify the Gmail user name. This is the only mandatory parameter.
remoteuser = username@gmail.com remoteuser = username@gmail.com
# Deleting a message from a Gmail folder via the IMAP interface will # WARNING: READ THIS BEFORE CONSIDERING TO CHANGE IT! Deleting a
# just remove that folder's label from the message: the message will # message from a Gmail folder via the IMAP interface will just remove
# continue to exist in the '[Gmail]/All Mail' folder. If `realdelete` # that folder's label from the message: the message will continue to
# is set to `True`, then deleted messages will really be deleted # exist in the '[Gmail]/All Mail' folder. If `realdelete` is set to
# during `offlineimap` sync, by moving them to the '[Gmail]/Trash' # `True`, then deleted messages will be moved to the '[Gmail]/Trash'
# folder. BEWARE: this will delete a messages from *all folders* it # folder. BEWARE: this will immediately delete a messages from *all
# belongs to! # 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
# See http://mail.google.com/support/bin/answer.py?answer=77657&topic=12815 # MOVE CAN CAUSE DATALOSS. DO NOT USE IT AND MOVE MAIL TO
realdelete = no # "[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 # The trash folder name may be different from [Gmail]/Trash
# for example on german googlemail, this setting should be # for example on german googlemail, this setting should be