Re: Partial message retrieval, the design

[Philip Van Hoof <spam pvanhoof be>]

The API documentation has been updated

On Thu, 2007-01-04 at 14:15 +0100, Philip Van Hoof wrote:
> The new API for partial message retrieval, however .. not yet the
> Camel-Lite implementation, has been committed in Subversion.
> 
> The API is exactly like on the UML of the wiki trac page. Please pass me
> comments and thoughts if you see things different (else will the API be
> the way the API is now).
> 
> On Wed, 2007-01-03 at 18:40 +0100, Philip Van Hoof wrote:
> > 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