Partial message retrieval, the design

[Philip Van Hoof <spam pvanhoof be>]

Hi folks,

This is a first design of the upcoming partial message retrieval feature

  o. http://tinymail.org/trac/tinymail/wiki/PartialMessageRetrieval

Two new documentation pages have been added. These are about the
camel-lite internals. The first is going to be important when
implementing the camel-lite part of the partial message retrieval
feature (which is not really shown in the design, as that part will have
to blend in the existing camel infrastructure).

  o. http://tinymail.org/trac/tinymail/wiki/CamelImapMessageCache
  o. http://tinymail.org/trac/tinymail/wiki/CamelFolderSummaryMmap

In short will the camel-lite API, camel_folder_get_message, be changed
to have an extra bool "full" to its parameters. If that bool is FALSE
then it will only fetch the body of the E-mail from the service. Else it
will retrieve the entire message content (including all attachments and
other mime parts). Or ... at least that is the idea.

At the tinymail part no API will be changed, only added. The API that
will be added is tny_folder_set/get_msg_receive_strategy. Two types will
also be added in libtinymail-camel (but check the wiki page for more
information, as decisions might change things .. whereas this E-mail
can't change once I press the Send button).

Comments, thoughts and everything in between (except brick throwing at
my head) is very welcome. If somebody is interested in cooperating or
co-developing this feature, please don't hesitate to contact me or write
about your ideas and intentions on this mailing list.


-- 
Philip Van Hoof, software developer
home: me at pvanhoof dot be 
gnome: pvanhoof at gnome dot org 
http://www.pvanhoof.be/blog