home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / emer121i.zip / readme < prev    next >
Text File  |  1999-06-06  |  11KB  |  271 lines
  1.  
  2.                               Emerald Mail 1.21
  3.                               June 6, 1999
  4.  
  5.  
  6. Installation (Java installer)
  7. =============================
  8.  
  9. 1. You must have the Java Virtual Machine for your operating system
  10.    installed, preferably version 1.1.4 at least. The program WILL NOT work
  11.    with 1.0.2. In OS/2, please use version 1.1.4, build 19980319 or later.
  12.  
  13. 2. Create a temporary directory.
  14.  
  15. 3. Unzip the .zip file into that directory.
  16.  
  17.    Under OS/2 open an OS/2 command prompt, change to the temporary
  18.    directory and type the following command:
  19.  
  20.    install
  21.  
  22.    Under Windows 95/98/NT open a DOS command prompt, change to the
  23.    temporary directory and type the following command:
  24.  
  25.    setup
  26.  
  27.    If the above commands (either for OS/2 or Windows) fails, you should check the
  28.    install.cmd and setup.bat files for the correct syntax of the java command.
  29.  
  30.    Under other operating system, you should start the setup Java class in
  31.    order to install the program. This is normally done with the following
  32.    command:
  33.  
  34.    java setup
  35.  
  36.    Please refer to your Java runtime documentation to see how to run a Java class.
  37.  
  38.  
  39. Installation (Zipped package)
  40. =============================
  41.  
  42. 1. You must have the Java Virtual Machine for your operating system
  43.    installed, preferably version 1.1.4 at least. The program WILL NOT work
  44.    with 1.0.2. In OS/2, please use version 1.1.4, build 19980319 or later.
  45.  
  46. 2. Create the directory where you want to install Emerald into.
  47.  
  48. 3. Unzip the .zip file into that directory with the complete directory structure.
  49.    If you are using InfoZip's unzip program this is the default option, so you
  50.    can simply issue the following command:
  51.  
  52.    unzip emer121p.zip
  53.  
  54.    If you are using PkZip's uzip program you need to add the -d command:
  55.  
  56.    pkunzip -d emer121p.zip
  57.  
  58.  
  59. Running the program
  60. ===================
  61.  
  62. The Java installation program will extract all needed files to a choosen
  63. destination directory and creates the program's icons on the desktop if
  64. running under Windows or OS/2 operating systems. To run Emerald Mail under
  65. these OSes simply double click on the Emerald Mail icon.
  66.  
  67. If the icons fails to start Emerald you should check the properties for the
  68. icon and edit the appropriate emerald.bat or emerald2.cmd (depending on the
  69. operating system) and change the java command for the version of the runtime
  70. system you have installed.
  71.  
  72. If you have installed the zipped version, no icon is created on the desktop,
  73. but the file emerald.bar and emerald2.cmd are still present. You should use
  74. one of these commands (for Windows and OS/2 respectively) to start Emerald.
  75.  
  76. Under other operating systems, such as Linux or Unix, you should manually
  77. create a command script that starts the emerald.mailer class located inside
  78. the emerald.jar archive. To do so add the .jar file to your class path. The
  79. way in which this is done  depends on the operating system you're using.
  80. Most operating systems have a global configuration file which sets
  81. environment variables for all programs that will be running under it. You
  82. can modify the class path there, but this can have bad effects on other
  83. programs. For example, some versions of OS/2's Netscape require Java 1.0.2
  84. and cannot run with Java 1.1.4, but Emerald Mail requires 1.1.4, so  the
  85. two programs will step on each other if you try to make a global
  86. configuration that will support both of them. So the best thing to do is
  87. leave your global class path the way it is, and change it for Emerald Mail
  88. ONLY IN THE SESSION in which you're going to run Emerald Mail.
  89.  
  90. In many operating systems, an environment variable is changed, for the
  91. current session, at that session's command line, by typing a command like
  92. this:
  93.  
  94. SET CLASSPATH=D:\EMERALD\EMERALD.JAR;D:\JAVA11\LIB\CLASSES.ZIP;
  95.  
  96. You can do that (or your operating system's equivalent of it) before each
  97. time you execute the command that runs Emerald Mail. And you can create a
  98. batch file which will execute that class path command and Emerald Mail
  99. command together for you every time. Then run that batch file, or make a
  100. Desktop icon that runs it for you,  whenever you want to run the program.
  101.  
  102. Or, many Java interpreters will let you modify the class path as part of
  103. the command that starts the program. For example, the documentation for
  104. Sun's Win32 runtime environment's Java interpreter, JRE.EXE, says that it
  105. won't use the CLASSPATH environment variable at all, so you have to specify
  106. its -cp parameter in order to set your class path. (Sun's Win32 JAVA.EXE,
  107. on the other hand, uses a -classpath parameter instead of -cp like JRE.EXE
  108. does.) So the command you execute with JRE.EXE might be something like
  109. this:
  110.  
  111. JRE.EXE -cp D:\EMERALD\EMERALD.JAR;D:\JRE\BIN;D:\JRE\LIB; emerald.mailer
  112.  
  113. The -cp parameter, and the string following it up until the next space
  114. character, is what sets the class path, and the string "emerald.mailer" at
  115. the end is what tells JRE.EXE to execute the class which starts the Emerald
  116. Mail program (see below).
  117.  
  118. So, regardless of what method you use to set your class path, what you need
  119. to add to it is your copy of the Emerald Mail's emerald.jar file (not the
  120. directory which contains it, but the .jar file itself). And note that the
  121. examples given here are not examples of what your class path should look
  122. like when you're done, but merely demonstrations of how you add the .jar
  123. file to whatever it is that you already have in your class path.
  124.  
  125. You must execute the program from within the directory in which you've
  126. unzipped the .zip file. That is, the directory which contains the .jar file
  127. and the help, icons and toolbar subdirectories. If you create a Desktop
  128. object or "shortcut" to doubleclick on, in order to start the program, you
  129. must fill in the "working directory" or "default directory" field of that
  130. object, so that the directory in which the program runs will indeed be the
  131. program's own directory.
  132.  
  133. To run the program, what you do is start your Java Interpreter and tell it
  134. to execute a class named "emerald.mailer". Your Java Interpreter may be
  135. named JAVA.EXE or JRE.EXE, and there are surely other possible names for it
  136. in various operating systems. Usually, the way to tell it what class to
  137. execute is by simply specifying the class name as a parameter to the
  138. command which starts the Java Interpreter. So, for example, under OS/2, you
  139. would type this command at the command line:
  140.  
  141. JAVA emerald.mailer
  142.  
  143. Or create a Desktop object which will execute that command for you (with
  144. JAVA.EXE where the name of the executable file belongs, and emerald.mailer
  145. where the executable file's parameters belong). Again, remember to fill in
  146. the "working directory" field of the object, as well.
  147.  
  148.  
  149. Changes made in version 1.21
  150. ============================
  151.  
  152.  * The hour in the composed messages is now correctly written in the 24hours format.
  153.  
  154.  * The Message Read window can now be closed with the ESC key.
  155.  
  156.  * The v key (lowercase V) can be used to scroll down the message text, in the preview
  157.    window, by one page.
  158.  
  159.  * Added the ability to detect and decode inline uuencoded attachments.
  160.  
  161.  * When deleting messages from an IMAP folder, the messages are marked as deleted and
  162.    not physically removed from the server. Messages marked as deleted will appear with
  163.    a red icon.
  164.  
  165.  * Added the command to remove (Compact) deleted messages from an IMAP folder in the
  166.    Folder menu.
  167.  
  168.  * Added a command to undelete (mark as not to be deleted) messages in an IMAP4 folder
  169.    to the Message menu.
  170.  
  171.  * The Account menu has a new submenu named Newsgroups that is active only for News
  172.    accounts. From this submenu you can retrieve a list of newsgroups from the server
  173.    (List) or directly subscribe to known newsgroups. In this menu is also present the
  174.    command to unsubscribe from the currently selected newsgroup.
  175.  
  176.  * The filter search strings are now case insensitive.
  177.  
  178.  * The filter search strings can now specify more than one string, each separated with
  179.    a comma (,) or semicolon (;). The filter is then activated when at least one of the
  180.    search strings is matched.
  181.  
  182.  * Added and icon and a menu command for writing a new message in the Message Read
  183.    window.
  184.  
  185.  * Added the option to check one or more accounts (either POP3 or NEWS) for new mail
  186.    at each program startup. This option is located in the Receive panel of the Account
  187.    properties dialog.
  188.  
  189.  * Added a button to the Message Compose window that open a popup menu with the list
  190.    of the last 15 addresses used to send messages. The addresses that will be recorded
  191.    in this list are the one used with a reply command and all those entered manually.
  192.  
  193.  * Added an option to the folder settings for news account to delete readed messages
  194.    after a certain number of days.
  195.  
  196.  * Added the option to select the printer font to be used when printing messages
  197.    from the File -> Preferences dialog.
  198.  
  199.  * When clicking on an address in the Message Compose window, the address will be written
  200.    in the edit field for editing. Clicking on the 'Add' icon or pressing the TAB button
  201.    causes the address to replace the currently selected address in the list box.
  202.  
  203.  
  204. Changes from Version 1.10 to 1.20
  205. =================================
  206.  
  207.  * Fixed a bug that prevented the confirmation settings to be maintained
  208.    across sessions.
  209.  
  210.  * Added full newsreader capabilities.
  211.  
  212.  * The open or close state of the folders in the folders list is now
  213.    maintained across sessions. The IMAP4 accounts are all maintained
  214.    closed at program startup.
  215.  
  216.  * Added mail filters for reply-to field, header and message body.
  217.  
  218.  * Fixed some bugs in the IMAP4 code.
  219.  
  220.  
  221. Changes from Version 1.02 to 1.10
  222. =================================
  223.  
  224.  * Added IMAP support.
  225.  
  226.  * The emerald.jar file is now an uncompressed jar file. This should fix
  227.    some startup problems with recent java environments.
  228.  
  229. Changes from Version 1.02 to 1.03
  230. =================================
  231.  
  232.  * Fixed a bug when decoding long lines of quoted-printable characters.
  233.  
  234.  * Added the option to rewrap the text of outgoing messages to a 
  235.    configurable maximum line length.
  236.  
  237. Changes from Version 1.01 to 1.02
  238. =================================
  239.  
  240.  * Fixed support for international charsets.
  241.  
  242.  * Added support for clickable links in message text. E-Mail addresses will
  243.    bring up a message compose window with the to: address set to the clicked
  244.    address, www. and ftp. links will bring up the configured web browser.
  245.  
  246.  * Added support to get new mail periodically.
  247.  
  248.  * Added the option to send one message to every recipient or send one copy
  249.    of the message to each recipient.
  250.  
  251.  * Added support to skip messages larger than a configurable amount of
  252.    kbytes.
  253.  
  254.  * Added the option to specify a Reply-To address for outgoing messages.
  255.  
  256.  * Fixed some minor drawing problems.
  257.  
  258. Changes from Version 1.00 to 1.01
  259. =================================
  260.  
  261.  * Fixed a bug when reading multipart/alternative MIME messages.
  262.  
  263.  * Fixed a bug that caused a NullPointerException when composing a
  264.    message without any defined signatures on certain Java virtual
  265.    machines.
  266.  
  267.  * Fixed a bug that causes the message list to disappear on certain
  268.    Java virtual machines.
  269.  
  270.  * Fixed window sizes using JRE/JDK 1.1.7
  271.