Added some slight explanations.

svn path=/trunk/; revision=856

3 files changed, 64 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index e8bb233bd7..072fd79250 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+1999-04-19  bertrand <Bertrand.Guiheneuf@inria.fr>
+
+	* camel/README: added some (few) explanations.
+
 1999-04-18  bertrand <Bertrand.Guiheneuf@inria.fr>
 
 	* camel/camel-store.[ch]: started implementation
diff --git a/README b/README
index e69de29bb2..9b4f6c7ca8 100644
--- a/README
+++ b/README
@@ -0,0 +1,3 @@
+This is the future gnome mailer.
+
+See camel/README for details about the mail library.
\ No newline at end of file
diff --git a/camel/README b/camel/README
new file mode 100644
index 0000000000..44f93fa6d8
--- /dev/null
+++ b/camel/README
@@ -0,0 +1,57 @@
+
+                                   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.
+
+....
+...
+
+