mirror of
https://github.com/chatmail/core.git
synced 2026-04-17 21:46:35 +03:00
Update "How messages are deleted" documentation
"IMAP folder and UID information" is no longer stored in the `msgs` table since creation of the `imap` table. As a result `msgs` table entries do not contain UID information in the first place. This commit updates documentation to reflect this change and also points to `prune_tombstones()` procedure which actually deletes `msgs` rows.
This commit is contained in:
@@ -36,15 +36,21 @@
|
|||||||
//!
|
//!
|
||||||
//! ## How messages are deleted
|
//! ## How messages are deleted
|
||||||
//!
|
//!
|
||||||
//! When the message is deleted locally, its contents is removed and
|
//! When Delta Chat deletes the message locally, it moves the message
|
||||||
//! it is moved to the trash chat. This database entry is then used to
|
//! to the trash chat and removes actual message contents. Messages in
|
||||||
//! track the Message-ID and corresponding IMAP folder and UID until
|
//! the trash chat are called "tombstones" and track the Message-ID to
|
||||||
//! the message is deleted from the server. Vice versa, when device
|
//! prevent accidental redownloading of the message from the server,
|
||||||
//! deletes the message from the server, it removes IMAP folder and
|
//! e.g. in case of UID validity change.
|
||||||
//! UID information, but keeps the message contents. When database
|
//!
|
||||||
//! entry is both moved to trash chat and does not contain UID
|
//! Vice versa, when Delta Chat deletes the message from the server,
|
||||||
//! information, it is deleted from the database, leaving no trace of
|
//! it removes IMAP folder and UID row from the `imap` table, but
|
||||||
//! the message.
|
//! keeps the message in the `msgs` table.
|
||||||
|
//!
|
||||||
|
//! Delta Chat eventually removes tombstones from the `msgs` table,
|
||||||
|
//! leaving no trace of the message, when it thinks there are no more
|
||||||
|
//! copies of the message stored on the server, i.e. when there is no
|
||||||
|
//! corresponding `imap` table entry. This is done in the
|
||||||
|
//! `prune_tombstones()` procedure during housekeeping.
|
||||||
//!
|
//!
|
||||||
//! ## When messages are deleted
|
//! ## When messages are deleted
|
||||||
//!
|
//!
|
||||||
|
|||||||
Reference in New Issue
Block a user