Type Definition melib::backends::notmuch::bindings::notmuch_message_tags_to_maildir_flags

type notmuch_message_tags_to_maildir_flags = unsafe extern "C" fn(message: *mut notmuch_message_t) -> notmuch_status_t;

Rename message filename(s) to encode tags as maildir flags.

Specifically, for each filename corresponding to this message:

If the filename is not in a maildir directory, do nothing. (A maildir directory is determined as a directory named "new" or "cur".) Similarly, if the filename has invalid maildir info, (repeated or outof-ASCII-order flag characters after ":2,"), then do nothing.

If the filename is in a maildir directory, rename the file so that its filename ends with the sequence ":2," followed by zero or more of the following single-character flags (in ASCII order):

• flag 'D' iff the message has the "draft" tag
• flag 'F' iff the message has the "flagged" tag
• flag 'P' iff the message has the "passed" tag
• flag 'R' iff the message has the "replied" tag
• flag 'S' iff the message does not have the "unread" tag

Any existing flags unmentioned in the list above will be preserved in the renaming.

Also, if this filename is in a directory named "new", rename it to be within the neighboring directory named "cur".

A client can ensure that maildir filename flags remain synchronized with notmuch database tags by calling this function after changing tags, (after calls to notmuch_message_add_tag, notmuch_message_remove_tag, or notmuch_message_freeze/ notmuch_message_thaw). See also notmuch_message_maildir_flags_to_tags for synchronizing maildir flag changes back to tags.