proposed clarification for folders.sgml
martin.konold at erfrakon.de
Tue Jul 26 15:48:50 CEST 2005
Am Dienstag 26 Juli 2005 14:31 schrieb David Faure:
> > user. There are exactly
> > +one default resource folder of each type which means
> > +one default calendar, one default contact folder, one default folder for
> > notes,
> > +a single default folder for tasks and last but not least one default
> > folder for a journal.</para>
> An unnumbered list would be easier to read than " A,B,C,D and least but not
> least E" (a phrase that doesn't really make sense here).
I agree though I don't know how to do this with docbook properly.
> s/All folder/All folders/
> > -<para>For other types of folders supported by the clients, these
> > +<para>There MUST NOT be two folders of a single type haveing the default
> > subtype. E.g. it
> > +is forbidden to have two folders of the type calendar with the subtype
> > default within one Kolab
> > +mailbox.</para>
> You mean within one Kolab account, no?
Yes. Technically a Kolab account consists of a IMAP mailbox. I changed the
wording to Kolab account now.
> > +<para>For other client specific non standardized types of folders
> s/client specific/client-specific/
> should be removed, if it's client-specific it's obviously supported by the
> clients ;)
> > Clients can rely upon
> > +unaltered annotations as long as the UIDVALIDITY of the folder is not
> > changed.
> ?!?!?!? If you can't change the annotation, you can't change it. Ever.
> Unrelated to UIDVALIDITY.
I am attaching the new poposal. Please note my comment about folder names.
RCS file: /kolabrepository/doc/kolab-formats/folders.sgml,v
retrieving revision 1.7
diff -u -r1.7 folders.sgml
--- folders.sgml 7 Oct 2004 16:07:30 -0000 1.7
+++ folders.sgml 26 Jul 2005 13:47:43 -0000
@@ -11,11 +11,22 @@
(i.e. folder name encoding is by RFC 3501).</para>
<para>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.</para>
+change this default. The account specific personal IMAP resource folders
+are subfolders of the INBOX, and this location cannot be set by the user.
+There is exactly one default resource folder for each type which means
+<para>one default calendar folder</para>
+<para>one default contact folder</para>
+<para>one default notes folder</para>
+<para>one default task folder</para>
+<para>one default journal folder</para>
+<para>The actual names of the folder as stored on the IMAP folder don't
matter. E.g. it does
+not matter if the default calendar is called Calendar or Kalendar as long as
exactly one default
+calendar folder does exist as a direct subfolder of the INBOX folder.
-<para>We will annotate all folders with an entry /vendor/kolab/folder-type
+<para>All folders MUST be annotated with an entry /vendor/kolab/folder-type
containing the attribute value.shared set to: <!
[CDATA[ <type>[.<subtype>] ]]>
@@ -26,20 +37,24 @@
or junkemail (this one holds spam mails). For the other <type>s, it
can only be default, or not set.</para>
-<para>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".</para>
+<para>There MUST NOT be two folders of a single type having the default
subtype. E.g. it
+is forbidden to have two folders of the type calendar with the subtype
default within one Kolab
+<para>For other client-specific non standardized types of folders, these
+MUST be prefixed with "k-" for KMail, "h-" for Horde, "o-" for Outlook with
+Toltec Connector and "ok-" for Outlook with the KONSEC Konnektor. E.g.
-<para>We will use "application/x-vnd.kolab.<type>" as the
-mimetype for the emails used for storage.</para>
+<para>The mimetype of the messages stored on the Kolab server is
-<para>The annotation must be set on creation, and can not be
-changed. For folders created with other IMAP clients, annotations must
+<para>All annotation MUST be set during the initial creation of a folder and
cannot be altered afterwards.
+Clients are allowed to rely upon this requirement.
+<para>For folders created with non Kolab 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
+the Toltec connector will ignore it completely.
+Kontact, Horde and other Kolab clients MUST assume that folders without
+a type set are email folders.</para>
Erlewein, Frank, Konold & Partner - Beratende Ingenieure und Physiker
More information about the format