Files
evolution/camel
Miguel de Icaza d53eea370b Add the unicode libraries as well.
2000-02-14  Miguel de Icaza  <miguel@gnu.org>

	* camel/providers/mbox/Makefile.am (libcamelmbox_la_LIBADD): Add
	the unicode libraries as well.

	* camel/camel-provider.c (camel_provider_register_as_module): Add
	error reporting here.  Desire to use Solaris increases.  Hair loss
	in the last two hours: 5,400.

	* camel/providers/mbox/camel-mbox-provider.c
	(camel_mbox_get_provider): Renamed function.

	* camel/camel.h: All include files use camel/ now here.

	* camel/providers/mbox/Makefile.am: Drop all the dynamism from
	Camel, and make this a standard library.

	* configure.in: set the UNICODE_LIBS variable here.
2000-02-14  Miguel de Icaza  <miguel@gnu.org>

	* folder-browser.c (folder_browser_load_folder): New routine,
	loads a camel folder.
	(folder_browser_set_uri): redo.

	* session.c: new file.  Implements SessionStores to keep track of
	a Session/Store tuple.

svn path=/trunk/; revision=1783
2000-02-15 17:28:34 +00:00
..
2000-02-15 17:28:34 +00:00

                                   CAMEL
     

			A generic Messaging Library


                                   ----
				

Introduction:
-------------

Camel will be a generic messaging library. It will evntually support 
the standard messaging system for receiving and sending messages.
It aims at being the backend for the future gnome-mailer system.

The name "camel" stands for ... nothing. Open area of developpement there.
You know, that "bazaar" thing. Maybe could we organize a big contest on
gnome-list to find the best signification :)

Camel draws heacily from JavaMail and the IMAP4rev1 RFC.
people wanting to hack on a provider are recommended to read the JavaMail
API specification but CMC and MAPI are of interest too.

Please, before starting anything, wait for me to finish the abstract classes.
Some parts are not definitive yet.

 
Organization:
-------------

The library is roughly a set of abstract classes, some kind of generic 
"interfaces" (idl interfaces, not java interfaces ). 

Particular implementations are called providers.

Here are the basic objects:

* CamelService : an abstract class representing an access to a server.
Handles the connection and authentication to any server.

* CamelStore (CamelService): A hierarchy  of folders on a server.

* CamelFolder : An object containing messages. A folder is always associated
to a store.

* CamelMessage : An object contained in folders. Is defined by a set of 
attribute and a content. (Attributes are generally: The date it was received,
the sender address, .....) 

* CamelTransport (CamelService): A way to send messages.

....
...