README ====== Angus Mail 2.0.3 release ------------------------------ Welcome to the Angus Mail 2.0.3 release! This release includes versions of the Angus Mail implementation, IMAP, SMTP, and POP3 service providers, some examples, and documentation for the Jakarta Mail API. Please see the FAQ at https://eclipse-ee4j.github.io/angus-mail/FAQ JDK Version notes ----------------- The Angus Mail supports JDK 1.8 or higher. Note that we have currently tested this implementation with JDK 1.8, 11 and 17. Angus Mail requires Jakarta Activation 2.1.0 or newer. Protocols supported ------------------- This release supports the following Internet standard mail protocols: IMAP - a message Store protocol, for reading messages from a server POP3 - a message Store protocol, for reading messages from a server SMTP - a message Transport protocol, for sending messages to a server The following table lists the names of the supported protocols (as used in the Angus Mail) and their capabilities: Protocol Store or Uses Supports Name Transport? SSL? STARTTLS? ------------------------------------------------- imap Store No Yes imaps Store Yes N/A gimap Store Yes N/A pop3 Store No Yes pop3s Store Yes N/A smtp Transport No Yes smtps Transport Yes N/A See our web page at https://eclipse-ee4j.github.io/angus-mail/ for the latest information on third party protocol providers. Download -------- See the Angus Mail project page to download this release. https://eclipse-ee4j.github.io/angus-mail/ Requirements ------------ Note that the Angus Mail requires the Jakarta Activation package to be installed as well. Download the latest version of Jakarta Activation from https://eclipse-ee4j.github.io/angus-activation and install it in a suitable location. Installation ------------ UNIX/Linux ---------- 1. Download the jakarta.mail.jar file from the Angus Mail project website. https://eclipse-ee4j.github.io/angus-mail 2. Set your CLASSPATH to include the "jakarta.mail.jar" file obtained from the download, as well as the current directory. Assuming you have downloaded jakarta.mail.jar to the /u/me/download/ directory, the following would work: export CLASSPATH=$CLASSPATH:/u/me/download/jakarta.mail.jar:. (Don't forget the trailing "." for the current directory.) Include the "jakarta.activation.jar" file that you obtained from downloading Jakarta Activation. For example: export CLASSPATH=$CLASSPATH:/u/me/download/jakarta.activation.jar 3. Download the jakartamail-samples.zip file from the project website. https://github.com/eclipse-ee4j/mail/releases 4. Compile any sample program using your Java compiler. For example: javac msgshow.java 5. Run the sample program. The '-' option lists the required and optional command-line options to successfully run any sample. For example: java msgshow - lists the available options. And java msgshow -T imap -H -U -P -f INBOX 5 uses the IMAP protocol to display message number 5 from your INBOX. (Additional instructions on how to run the simple mail reader sample and servlet sample are provided in client/README.txt and servlet/README.txt, respectively.) Windows ------- 1. Download the jakarta.mail.jar file from the Jakarta Mail project website. https://eclipse-ee4j.github.io/angus-mail 2. Set your CLASSPATH to include the "jakarta.mail.jar" file obtained from the download, as well as the current directory. Assuming you have downloaded jakarta.mail.jar to the /u/me/download/ directory, the following would work: set CLASSPATH=%CLASSPATH%;c:\download\jakarta.mail.jar;. (Don't forget the trailing "." for the current directory.) Include the "jakarta.activation.jar" file that you obtained from downloading Jakarta Activation. For example: set CLASSPATH=%CLASSPATH%;c:\download\jakarta.activation.jar 3. Download the jakartamail-samples.zip file from the project website. https://github.com/eclipse-ee4j/mail/releases 4. Compile any sample program using your Java compiler. For example: javac msgshow.java 5. Run the sample program. The '-' option lists the required and optional command-line options to successfully run any sample. For example: java msgshow - lists the available options. And java msgshow -T imap -H -U -P -f INBOX 5 uses the IMAP protocol to display message number 5 from your INBOX. (Additional instructions on how to run the simple mail reader sample and servlet sample are provided in client/README.txt and servlet/README.txt, respectively.) Problems? --------- The Angus Mail FAQ at https://eclipse-ee4j.github.io/angus-mail/FAQ includes information on protocols supported, installation problems, debugging tips, etc. See the NOTES.txt file for information on how to report bugs. Enjoy! The Angus Mail Team