Skip to content

LocalMessages

Jump to bottom
cketti edited this page Aug 22, 2012 · 1 revision

Local messages

In this document a "local message" is defined as a message that is only available in K-9 Mail, i.e. it is not linked to a message on the server (remote store). Most of the time local messages in K-9 Mail have a local UID (a string starting with "K9LOCAL:").

How to end up with a local message

  • When copying/moving a message to another folder the message gets a local UID in the target folder
  • POP3: We don't support copying/moving
  • IMAP: Once the command on the server succeeded (and the server supports UIDPLUS) we replace the local UID with the new UID in that folder (i.e. it's no longer a local message). If the server doesn't support UIDPLUS the local message is deleted during the next folder sync and the message copied by the remote command is downloaded. If "Sync server deletions" is unchecked, we keep the local message and additionally download the copied/moved message.
  • WebDAV: TODO
  • When deleting a message with a delete policy != DELETE_POLICY_ON_DELETE and a Trash folder != -NONE-
  • POP3: All messages in the trash folder are local messages
  • IMAP: We currently treat this like moving a message without actually sending a command to the server (see above).
  • WebDAV: TODO
  • Unchecking "Sync server deletions" and deleting a message that was downloaded to K-9 Mail from the server
  • POP3/IMAP: The message will be retained as-is, i.e. it doesn't get a local UID. The sync code just doesn't delete messages it couldn't find on the server.
  • WebDAV: TODO

Problems with local messages

  • There is no way to upload a local message to the server
  • There is no way to copy/move a local message to another folder
  • If delete policy != DELETE_POLICY_ON_DELETE and a Trash folder is set, there is no way to undelete a message. The user sees the (local) message in the Trash folder but it's not linked to the original message in any way.
  • There is no visual indicator for local messages
  • TODO

Suggested improvements

Clone this wiki locally