Index: README.txt
===================================================================
RCS file: README.txt
diff -N README.txt
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ README.txt	17 Aug 2003 08:37:56 -0000
@@ -0,0 +1,60 @@
+JavaMail Specification 1.4
+==========================
+
+These classes are based on the JavaMail Specification taken from J2EE 1.4 API
+documentation and on the JavaMail 1.3 specification PDF.
+
+The classes represent the JavaMail API and contain implementations of the 
+classes found in the javax.mail packages. In order to function correctly,
+these classes require:
+
+o The Java Activation Framework (JAF) in javax.activation
+o Java 2 (Java 1.2 or later)
+o Implementations of the JavaMail providers to deal with pop/imap/etc.
+  (You may use this with the geronimo-mail implementation or write your own)
+
+This contains no JavaDoc: see 
+  http://java.sun.com/products/javamail/
+  http://java.sun.com/j2ee/1.4/docs/api/
+
+for more information on how to use JavaMail to send messages.
+
+Configuration
+-------------
+
+The JavaMail spec defines the following configuration files:
+
+javamail.providers [Defines which classes are used to map to protocols]
+javamail.address.map [Defines which message types (rfc822, news) map to protocols]
+
+They need to be in the CLASSPATH (or in a Jar) in a directory /META-INF/
+e.g. c:\mymail\META-INF\javamail.providers
+
+Providers
+---------
+Provides a protocol, along with its implementation and whether it is a store
+or a transport (subclass of javax.mail.Store or javax.mail.Transport)
+
+protocol=smtp;type=transport;class=org.me.MySMTPTransport;vendor=Me Inc;version=1.0
+protocol=imap;type=store;class=org.me.MyIMAPStore;vendor=Me Inc;version=1.0
+
+Address Map
+-----------
+
+Contains entries in 'name=value' format:
+rfc822=smtp
+news=nntp
+
+Default
+=======
+
+To ensure that other files can be extended at a later stage, the JavaMail
+spec defines three locations for these files:
+
+$JAVA_HOME\lib\javamail.properties
+META-INF\javamail.properties
+META-INF\javamail.default.properties
+
+The files are located in that order and overwrite whatever the previous
+version contained, so if 'smtp' is defined in javamail.properties and
+javamail.default.properties, it will use the one from javamail.default.properties
\ No newline at end of file