Chapter 2. Per Folder requirements

This chapter describes all necessary settings on the IMAP folders in the Kolab storage format.

2.1. IMAP requirements

We will be using the ANNOTATEMORE proposal. If changes are made to this in the standardization process, we will incorporate these. Also, we must support IMAP namespaces. All relevant RFCs will be followed (i.e. folder name encoding is by RFC 3501).

The INBOX is the default inbox of the user. The user can not change this default. The IMAP resource folders (one for events, one for contacts etc. ) are subfolders of the INBOX, and this location can not be set by the user.

We will annotate all folders with an entry /vendor/kolab/folder-type containing the attribute value.shared set to: <type>[.<subtype>]

The <type> can be: mail, event, journal, task, note, or contact.

The <subtype> for a mail folder can be inbox, drafts, sentitems, or junkemail (this one holds spam mails). For the other <type>s, it can only be default, or not set.

For other types of folders supported by the clients, these should be prefixed with "k-" for KMail, "h-" for Horde and "o-" for Outlook, and look like for example "kolab.o-voicemail".

We will use "application/x-vnd.kolab.<type>" as the mimetype for the emails used for storage.

The annotation must be set on creation, and can not be changed. For folders created with other IMAP clients, annotations must be preserved. If a folder has no annotation, Outlook and the Toltec connector will ignore it completely. This is not an option for Kontact and Horde, so we will by default consider them to hold mail.