JavaMail Specification 1.5
==========================

These classes are based on the JavaMailTM API Design Specification Version 1.5 which can be found here:
o https://javamail.java.net/nonav/docs/JavaMail-1.5.pdf
o http://download.oracle.com/otn-pub/jcp/java_mail-1_5-mrel2-spec/javamail-1.5.0-javadocs.zip

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) 1.1 (or newer) in javax.activation unless you are using Java SE 6 or newer
o J2SE 5.0/JDK 1.5 or newer
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 
  https://java.net/projects/javamail/pages/Home
  http://docs.oracle.com/javaee/7/api/

for more information on how to use JavaMail to send messages.

JAF 1.1.1 is currently the newest version.  Note that JAF 1.1
is included in JDK 1.6 and JAF 1.1.1 is included in JDK 1.6.0_10 and
later.

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