RELEASE-NOTES.txt

                         Commons Email Package
                              Version 1.2
                             Release Notes

INTRODUCTION:
-------------

Commons Email aims to provide a API for sending email. It builds on the JavaMail
API with the aim of presenting a simplified API which is easy for developers who
are not mail experts to use. It is a compact component with a small number of
classes.

The Commons Email website is the source for the most recent information,
downloads, reports, and bug status:

http://commons.apache.org/email/

This is a maintenance release which fixes several bugs present in the 1.1
release and adds a number of small enhancements requested by
users. All current users are encouraged to upgrade.

CHANGES FROM 1.1:
-----------------

== Compatibility ==

* Java 1.4 or later is now required. Earlier versions are no longer
  supported by Sun.

* JavaMail 1.4 or later and JavaBeans Activation Framework 1.1 or later are now
  required.

== New Features ==

* Email.setFrom and Email.addTo are using Email.charset to properly encode 
  the name.
  
* SimpleEmail#setMsg() with UTF-8 content honors correct charset in header 
  and does encode the content correctly now.
  
* Created additional methods to support timeouts.

* Create an overridable method in Email.java to create the MimeMessage instance.

* Add getTo and getReplyTo to Email class. 

== Fixed Bugs ==

* If setHostName() has not been called, getHostName() tries to return
  this.session.getProperty(MAIL_HOST). If mail session has not been
  created yet, this will throw a NullPointerException. Now getHostName()
  checks that this.session is not null before trying to access it. 

* Provide better diagnostics when attaching  documents fail. 

* When mail authentication is required and no username/password is supplied
  than the provided mail session is used. If a username/password is found
  the implementation creates a new mail session and a DefaultAuthenticator
  as convinence implementation. 

* Using Kenneth's implementation of HtmlEmail.buildMimeMessage() to fix a
  couple of HtmlEmail layout issues. Also thanks to Martin Lau and Morten
  Hattesen for providing in-depth analysis of the problem. 

* During regression tests write out the generated MimeMessage instead of
  WiserEmail.toString(). 


REQUIREMENTS:

J2SE environments
-----------------

Commons Email requires JavaMail 1.4 or later. The Sun implementation
is available at:

http://java.sun.com/products/javamail/

However, the Apache Geronimo project (http://geronimo.apache.org)
provides a J2EE-certified implementation of the JavaMail 1.4
specification licensed under the Apache Software License.  

Commons Email also requires the JavaBeans Activation Framework unless
you are runnning on Java SE 6 or later. The Sun implementation is available
at:

http://java.sun.com/javase/technologies/desktop/javabeans/jaf/

Apache Geronimo likewise provides an implementation under the Apache
Software License.

Commons Email has been tested with JDK 1.4, 1.5 and 1.6

J2EE environments
-----------------

Commons Email is compatible with all certified Java Enterprise Edition
5 implementations; no further dependencies are required. 

Java 2 Enterprise Edition 1.4 users must ensure that the versions of
JavaMail and JAF indicated above are available to their applications;
the J2EE 1.4 specification only requires earlier versions.

Earlier versions of J2EE are not supported.