
                              Emerald Mail 1.21
                              June 6, 1999


Installation (Java installer)
=============================

1. You must have the Java Virtual Machine for your operating system
   installed, preferably version 1.1.4 at least. The program WILL NOT work
   with 1.0.2. In OS/2, please use version 1.1.4, build 19980319 or later.

2. Create a temporary directory.

3. Unzip the .zip file into that directory.

   Under OS/2 open an OS/2 command prompt, change to the temporary
   directory and type the following command:

   install

   Under Windows 95/98/NT open a DOS command prompt, change to the
   temporary directory and type the following command:

   setup

   If the above commands (either for OS/2 or Windows) fails, you should check the
   install.cmd and setup.bat files for the correct syntax of the java command.

   Under other operating system, you should start the setup Java class in
   order to install the program. This is normally done with the following
   command:

   java setup

   Please refer to your Java runtime documentation to see how to run a Java class.


Installation (Zipped package)
=============================

1. You must have the Java Virtual Machine for your operating system
   installed, preferably version 1.1.4 at least. The program WILL NOT work
   with 1.0.2. In OS/2, please use version 1.1.4, build 19980319 or later.

2. Create the directory where you want to install Emerald into.

3. Unzip the .zip file into that directory with the complete directory structure.
   If you are using InfoZip's unzip program this is the default option, so you
   can simply issue the following command:

   unzip emer121p.zip

   If you are using PkZip's uzip program you need to add the -d command:

   pkunzip -d emer121p.zip


Running the program
===================

The Java installation program will extract all needed files to a choosen
destination directory and creates the program's icons on the desktop if
running under Windows or OS/2 operating systems. To run Emerald Mail under
these OSes simply double click on the Emerald Mail icon.

If the icons fails to start Emerald you should check the properties for the
icon and edit the appropriate emerald.bat or emerald2.cmd (depending on the
operating system) and change the java command for the version of the runtime
system you have installed.

If you have installed the zipped version, no icon is created on the desktop,
but the file emerald.bar and emerald2.cmd are still present. You should use
one of these commands (for Windows and OS/2 respectively) to start Emerald.

Under other operating systems, such as Linux or Unix, you should manually
create a command script that starts the emerald.mailer class located inside
the emerald.jar archive. To do so add the .jar file to your class path. The
way in which this is done  depends on the operating system you're using.
Most operating systems have a global configuration file which sets
environment variables for all programs that will be running under it. You
can modify the class path there, but this can have bad effects on other
programs. For example, some versions of OS/2's Netscape require Java 1.0.2
and cannot run with Java 1.1.4, but Emerald Mail requires 1.1.4, so  the
two programs will step on each other if you try to make a global
configuration that will support both of them. So the best thing to do is
leave your global class path the way it is, and change it for Emerald Mail
ONLY IN THE SESSION in which you're going to run Emerald Mail.

In many operating systems, an environment variable is changed, for the
current session, at that session's command line, by typing a command like
this:

SET CLASSPATH=D:\EMERALD\EMERALD.JAR;D:\JAVA11\LIB\CLASSES.ZIP;

You can do that (or your operating system's equivalent of it) before each
time you execute the command that runs Emerald Mail. And you can create a
batch file which will execute that class path command and Emerald Mail
command together for you every time. Then run that batch file, or make a
Desktop icon that runs it for you,  whenever you want to run the program.

Or, many Java interpreters will let you modify the class path as part of
the command that starts the program. For example, the documentation for
Sun's Win32 runtime environment's Java interpreter, JRE.EXE, says that it
won't use the CLASSPATH environment variable at all, so you have to specify
its -cp parameter in order to set your class path. (Sun's Win32 JAVA.EXE,
on the other hand, uses a -classpath parameter instead of -cp like JRE.EXE
does.) So the command you execute with JRE.EXE might be something like
this:

JRE.EXE -cp D:\EMERALD\EMERALD.JAR;D:\JRE\BIN;D:\JRE\LIB; emerald.mailer

The -cp parameter, and the string following it up until the next space
character, is what sets the class path, and the string "emerald.mailer" at
the end is what tells JRE.EXE to execute the class which starts the Emerald
Mail program (see below).

So, regardless of what method you use to set your class path, what you need
to add to it is your copy of the Emerald Mail's emerald.jar file (not the
directory which contains it, but the .jar file itself). And note that the
examples given here are not examples of what your class path should look
like when you're done, but merely demonstrations of how you add the .jar
file to whatever it is that you already have in your class path.

You must execute the program from within the directory in which you've
unzipped the .zip file. That is, the directory which contains the .jar file
and the help, icons and toolbar subdirectories. If you create a Desktop
object or "shortcut" to doubleclick on, in order to start the program, you
must fill in the "working directory" or "default directory" field of that
object, so that the directory in which the program runs will indeed be the
program's own directory.

To run the program, what you do is start your Java Interpreter and tell it
to execute a class named "emerald.mailer". Your Java Interpreter may be
named JAVA.EXE or JRE.EXE, and there are surely other possible names for it
in various operating systems. Usually, the way to tell it what class to
execute is by simply specifying the class name as a parameter to the
command which starts the Java Interpreter. So, for example, under OS/2, you
would type this command at the command line:

JAVA emerald.mailer

Or create a Desktop object which will execute that command for you (with
JAVA.EXE where the name of the executable file belongs, and emerald.mailer
where the executable file's parameters belong). Again, remember to fill in
the "working directory" field of the object, as well.


Changes made in version 1.21
============================

 * The hour in the composed messages is now correctly written in the 24hours format.

 * The Message Read window can now be closed with the ESC key.

 * The v key (lowercase V) can be used to scroll down the message text, in the preview
   window, by one page.

 * Added the ability to detect and decode inline uuencoded attachments.

 * When deleting messages from an IMAP folder, the messages are marked as deleted and
   not physically removed from the server. Messages marked as deleted will appear with
   a red icon.

 * Added the command to remove (Compact) deleted messages from an IMAP folder in the
   Folder menu.

 * Added a command to undelete (mark as not to be deleted) messages in an IMAP4 folder
   to the Message menu.

 * The Account menu has a new submenu named Newsgroups that is active only for News
   accounts. From this submenu you can retrieve a list of newsgroups from the server
   (List) or directly subscribe to known newsgroups. In this menu is also present the
   command to unsubscribe from the currently selected newsgroup.

 * The filter search strings are now case insensitive.

 * The filter search strings can now specify more than one string, each separated with
   a comma (,) or semicolon (;). The filter is then activated when at least one of the
   search strings is matched.

 * Added and icon and a menu command for writing a new message in the Message Read
   window.

 * Added the option to check one or more accounts (either POP3 or NEWS) for new mail
   at each program startup. This option is located in the Receive panel of the Account
   properties dialog.

 * Added a button to the Message Compose window that open a popup menu with the list
   of the last 15 addresses used to send messages. The addresses that will be recorded
   in this list are the one used with a reply command and all those entered manually.

 * Added an option to the folder settings for news account to delete readed messages
   after a certain number of days.

 * Added the option to select the printer font to be used when printing messages
   from the File -> Preferences dialog.

 * When clicking on an address in the Message Compose window, the address will be written
   in the edit field for editing. Clicking on the 'Add' icon or pressing the TAB button
   causes the address to replace the currently selected address in the list box.


Changes from Version 1.10 to 1.20
=================================

 * Fixed a bug that prevented the confirmation settings to be maintained
   across sessions.

 * Added full newsreader capabilities.

 * The open or close state of the folders in the folders list is now
   maintained across sessions. The IMAP4 accounts are all maintained
   closed at program startup.

 * Added mail filters for reply-to field, header and message body.

 * Fixed some bugs in the IMAP4 code.


Changes from Version 1.02 to 1.10
=================================

 * Added IMAP support.

 * The emerald.jar file is now an uncompressed jar file. This should fix
   some startup problems with recent java environments.

Changes from Version 1.02 to 1.03
=================================

 * Fixed a bug when decoding long lines of quoted-printable characters.

 * Added the option to rewrap the text of outgoing messages to a 
   configurable maximum line length.

Changes from Version 1.01 to 1.02
=================================

 * Fixed support for international charsets.

 * Added support for clickable links in message text. E-Mail addresses will
   bring up a message compose window with the to: address set to the clicked
   address, www. and ftp. links will bring up the configured web browser.

 * Added support to get new mail periodically.

 * Added the option to send one message to every recipient or send one copy
   of the message to each recipient.

 * Added support to skip messages larger than a configurable amount of
   kbytes.

 * Added the option to specify a Reply-To address for outgoing messages.

 * Fixed some minor drawing problems.

Changes from Version 1.00 to 1.01
=================================

 * Fixed a bug when reading multipart/alternative MIME messages.

 * Fixed a bug that caused a NullPointerException when composing a
   message without any defined signatures on certain Java virtual
   machines.

 * Fixed a bug that causes the message list to disappear on certain
   Java virtual machines.

 * Fixed window sizes using JRE/JDK 1.1.7
