Just thought I'd mention that I probably won't be answering mails very actively this week while I'm in San Antonio (and I was kind of busy last week too). Hopefully I'll get back to answering/bugfixing next week.. I also started writing developers documentation to http://wiki.dovecot.org/Design. Comments welcome. Some things I had planned next: - istream internals - lib-storage API docs - ..?
Timo Sirainen wrote:> Just thought I'd mention that I probably won't be answering mails very actively this week while I'm in San Antonio (and I was kind of busy last week too). Hopefully I'll get back to answering/bugfixing next week.. > > I also started writing developers documentation to http://wiki.dovecot.org/Design. Comments welcome. Some things I had planned next: > > - istream internals > - lib-storage API docs > - ..? >Excellent opportunity to post a similar message of my own. I'm quite suddenly involved in a civil rental dispute, resulting in a summary procedure (lawsuit) next week. This means that I'll be busy handling this for the moment. Regards, Stephan.
While you're in the neighborhood you should vist College Station and Austin. --David. On Tue, 1 Dec 2009 17:39:55 -0600 Timo Sirainen <tss at iki.fi> wrote:> Just thought I'd mention that I probably won't be answering mails very actively this week while I'm in San Antonio (and I was kind of busy last week too). Hopefully I'll get back to answering/bugfixing next week.. > > I also started writing developers documentation to http://wiki.dovecot.org/Design. Comments welcome. Some things I had planned next: > > - istream internals > - lib-storage API docs > - ..? > >-- David Brown <david at davidwbrown.name>
On Tue, Dec 01, 2009 at 05:39:55PM -0600, Timo Sirainen wrote:> Just thought I'd mention that I probably won't be answering mails very actively this week while I'm in San Antonio (and I was kind of busy last week too). Hopefully I'll get back to answering/bugfixing next week.. > > I also started writing developers documentation to http://wiki.dovecot.org/Design. Comments welcome. Some things I had planned next: > > - istream internals > - lib-storage API docs > - ..?Hello Timo, Just an idea talking about writing documentation : When I looked at the authentication code (using LDAP) back in the 1.1 version, it took me some time to understand the function call cascading, especially with the "callback"/"context" mechanism which I found clever but hard to follow. I came to the understanding (hope I was right) that you were using some kind of layered architecture, which went something like this : "low level" < ldap_request level < passdb_ldap_request level < auth_request level < auth_request_handler level < auth_client_connection level < "high level" where : . passdb_ldap_request == passwd checking . auth_request == parameters (user, password, state) and internal management of the request . auth_request_handler == building of the answer of the request . auth_client_connecion == sending to the authentication client (imap-login) ... . callback : a pointer in a lower level to a function in an higher level . context : what links "objects" of those layers eachother I was thinking that, if my understanding is correct, some overview from you of such an architecture would be of great help for those who want to understand the code. Thanks. -- Thomas Hummel | Institut Pasteur <hummel at pasteur.fr> | P?le informatique - syst?mes et r?seau
On Ter, 2009-12-01 at 17:39 -0600, Timo Sirainen wrote:> > I also started writing developers documentation to http://wiki.dovecot.org/Design. Comments welcome. Some things I had planned next: > > - istream internals > - lib-storage API docs > - ..? >Great stuff. Many thanks. -- Jose Celestino SAPO.pt::Systems http://www.sapo.pt --------------------------------------------------------------------- * Progress (n.): The process through which Usenet has evolved from smart people in front of dumb terminals to dumb people in front of smart terminals. -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: <http://dovecot.org/pipermail/dovecot/attachments/20091202/cdb6201f/attachment-0002.bin>
On Dec 1, 2009, at 6:39 PM, Timo Sirainen wrote:> Just thought I'd mention that I probably won't be answering mails > very actively this week while I'm in San Antonio (and I was kind of > busy last week too). Hopefully I'll get back to answering/bugfixing > next week..Have a good trip!> I also started writing developers documentation to http:// > wiki.dovecot.org/Design. Comments welcome. Some things I had > planned next: > > - istream internals > - lib-storage API docs > - ..?This is great news, thanks! One thing in particular that I'd like to see is something on writing plugins. I have several ideas of plugins I'd like to write but have hesitated to get started due to not wanting to basically dig through tons of source to figure out how to interface to Dovecot's internals. -Dave -- Dave McGuire Port Charlotte, FL