AEMAIL.README (July 1, 1997) Contained in this archive is version 1.20 of AEMail, an Internet Mail User Agent (Client), which can be used to retrieve mail fron a POP Server and send mail to a SMTP server. It requires a TCP/IP stack that is compatable with AmiTCP, and AmigaDOS 2.1 or later. AEMail has been successfully tested with TCP/IP stacks used by AmiTCP, TermiteTCP, and Miami. AEMail can also be used as a "MailTo" agent in WWW browsers, such as Voyager and AWeb, which allow the user to specify such an agent for composing and sending email. This version significantly changes the way messages are composed. It will allow both the creation of quoted-printable and BASE64 message bodies for transmitting 8-bit message text. It also removes the restriction on the use of CED as your editor. The new version also uses a redesigned command tool bar (in color and smaller!) and folder tool bar and implements cursor control of listview displays and drag selection for users of AmigaDOS 3.0 and above. A complete list of enhancements and the bugs corrected with this version is given at the end of his file. -------------------------------------------------------------------------- WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING -------------------------------------------------------------------------- When you send your first message with any new version AEMail, a special "Notification" message will be sent to me. Besides the normal header information, the body of this message will contain the following information (obtained from your configuration file): Your email address Your Real Name Your POP3 Server name Your SMTP Server name Your SMTP Domain Name Your editor call The version of the Exec (OS) that you are using Your Display ID (from the screen mode setting) Your Overscan Type (from the screen mode setting) Base configuration file name Currently active configuration file name Mail directory This information is provided to help me determine and debug problems with AEMail. Future versions may contain more or less information as the need arises. Most of the Internet information is public information and can be obtained from your service provider. I WILL KEEP THIS INFORMATION IN STRICT CONFIDENCE. IF YOU DO NOT WANT THIS INFORMATION DIVULGED TO ME, DO NOT USE AEMAIL! ----------------- I am including this warning because of concerns expressed to me by some people. -------------------------------------------------------------------------- WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING -------------------------------------------------------------------------- Later versions of AEMail are planned which will provide: AREXX Support Filtering incoming messages to specified folders Asynchronous retrieval of messages from a POP server Asynchronous sending of messages to the SMTP server Even faster message display routines with several added features including saving portions of the message to the clipboard and transferring embedded email addresses to the address book. Built in message editor Other features suggested by users AEMAIL is copyright (c) 1996, 1997 by John F. Zacharias, all rights reserved. This version is NOW Shareware. A shareware fee of $30 is requested for AEMail. The shareware fee (US Funds only) should be sent to: John Zacharias 10004 Vanguard Drive Sacramento, CA 95827 USA You must include your Real Name and email address with your remittance. A handy form has been provided in the file "registration.form" which you can print out and use for this purpose. If you have more than one email address with more than one AEMail_Mail directory, please include ALL these addresses on the "registration.form". Your registration will be acknowledged by email that must be received by AEMail version 1.15 or higher. For the un-registered "Freeware" version, permission is given to to test and evaluate the program in return for feedback on the use of the program and reporting of any bugs encountered. This archive contains the following: The AEMAIL executable The Install_AEMail install script for installing AEMail. This AEMAIL.README file AEMAIL documentation in the file AEMail.doc (for printing) AEMail documentation in AmigaGuide format in the file AEMail.guide StartNet and StopNet scripts for Miami A sample mailcap file to be used with AmigaDos 3.0 or above Registration form. Before attempting to use AEMail you should read the documentation in AEMail.guide AND the INSTALL.TXT file. After the install process the default tool for the AEMail.guide file will be MultiView if you are running under 3.0 or later, or AmigaGuide if you are running under 2.1. AEMAIL, version 1.20, release date: 07/01/97 Version 1.20 is the first version of AEMail that provides certain features only to registered users (those paying the shareware fee). These features (not available to unregisterd users) are: Ability to use multiple signature files. Ability to add user defined headers to a message. Ability to shrink or expand group entries in Address Book displays. Enhanced speed on message displays. Password protection for separate configurations. For those of you that have used AEMail 1.15, you will notice that for un-registered users, the display speed for messages will return to what it was prior to release 1.15. As payment for receiving and using the un-registered BETA version of AEMAIL, I would like any bugs, comments, or suggestions reported to me. You can send me email at jzachar@calweb.com A entry will be automatically added to your address book with a nickname of AEMAIL which can be used for routing email to me. I would also like reports of bugs, any comments, or suggestions reported by registered users. I would appreciate any suggestions that you have for improving AEMAIL. I will not guarantee that I will accept all suggestions or that I will necessarily implement them in the next release; however, I do take each suggestion seriously. In the past I have implemented a number of suggestions made by my testers. I will attempt to respond to each suggestion that is made. In making suggestions keep in mind some of the restraints that I have placed on AEMAIL: (1) The program should be able to be run on any version of AmigaDos 2.1 or greater, and (2) with the exception of a TCP/IP compatible with AmiTCP (AmiTCP, TermiteTCP or Miami), AEMAIL should not require any extension to your system that does not come with a standard AmigaDOS release. This effectively rules out MUI. Using an editor of your choice meets this criteria since you can use the standard AmigaDOS editors, ED or MEMACS, which come with the standard Amiga systems. Reports of bugs or inconsistancies in the documentation are also appreciated. When reporting bugs or making suggestions, please be as complete as possible in describing the circumstances that brought about the problem or how the suggestion could be implemented. If you give this program to anyone else to use and evaluate, please include the complete archive including the readme and documentation files and make clear to them that this is a un-registered prelimary version of the program. An automatic notification procedure has been provided which will automatically send me an email message the first time any mail is sent from AEMAIL. This message will also be sent any time the user upgrades to a new version or re-installs AEMail. When I recieve the notification message your email address is placed in a database for informing you of updates. If you do not want to be so informed, send me email to that effect and your name will be removed from the database. THE FUTURE This version of AEMail is version 1.20, and is the thirteenth BETA release. At this point it is still under evaluation and several planned enhancements are yet to be completed. The un-registered "Freeware" version can be distributed to any and all BBS's provided the entire archive is kept intact. I have my own "home page" where the latest version can be obtained. The URL for my home page is http://www.calweb.com/~jzachar New major releases will also be posted to AmiNet. However, my home page may contain special "interum" or "test" releases that may not be posted to AmiNet. As a user of the program you will receive update notices via email. When certain features such as: AREXX Background retrieval and sending of mail. Directing retrieval of mail to selected folders. are implemented, a number of these features may be disabled until the shareware fee is paid. However, once the shareware fee is paid, it will be recognized as being paid by future version provided that there is no increase in the shareware fee. -John Zacharias July 1, 1997 jzachar@calweb.com http://www.calweb.com/~jzachar VERSION HISTORY Version 1.20 Released July 1, 1997. Major enhancements and corrections in this release are: For registered users you can use password protection to access AEMail. This is particularly useful for multiple user configurations. The command tool bar as been re-designed and re-arranged. The icons are now in color and several new ones have been added including: Display Previous Folder's Message List Display Current Folder's Message List Display Next Folder's Message List Start TCP/IP Network Connection Terminate TCP/IP Network Connection The folder icon bar has been re-designed and made smaller. Since the vertical and horizontal size of each folder icon depends on the font used, the font and size for the folder bar can be user defined. The Compose Message window has been completely revised. It now allows message text to be encoded with printed-quotable and BASE64 encoding. Also, when calling your editor, the compose window is re-activated when you save and quit from the editor. Only the body of the message appears in the editor window. This change makes the use of any editor that relenquishes control (such as CygnusEd (CED)) usable without any special considerations. You can save messages from the Compose Message window in either the PENDING or QUEUED folders or you can immediately send them. The Address Book when called from the Compose Message window will normally have only the Group header without the members of the group shown. For registered users, you will be able to expand the group names, however. Also, the Address Book, when called from the Compose window, will not have the data entry fields for adding addresses to the Address Book (although there is an option to call the complete Address Book). For registered users, when you directly call the Address Book, you will be able to "shrink" the Groups to show only the Group header. For registered users, different signature files are possible. For registered users, additional user headers can be defined. Attachments can use "quoted-printable" encoding. When composing messages that are stored in the PENDING or QUEUED folders the system will "remember" previous attachments and additional headers that were added. When editing messages, the message that is edited will be completely removed from the PENDING or QUEUED folder rather than marked deleted. For all major list views, you can use the cursor keys to move the lists up or down. For users of AmigaDOS 3.0 or above, "drag select" has been implemented for the Message list. You can "select" multiple messages by holding the left mouse button down and dragging it over several messages. The messages counts that are shown in the folder icons will have deleted messages subtracted out. Several new menu items have been added including the ability to "hide" deleted messages and to show only unread messages. You can also force a reply to a message to the "From:" address even if there is a "Reply-To:" address. If you print a message, it will be marked as "un-read" the same as if you displayed it. If you are reading a message when you receive additional messages, delete a message, or print a message, the display will remain on the message and not switch to the message list. A &(to) parameter has been added to the "Quote Header" for quoted replies. Corrected a problem where (fwd) was not recognized at the end of the subject line. AEMail will now recognize the (fwd) at either the beginning or end of the line. Compose now also places the (fwd) correctly at the end of the subject line. Other minor corrections have been made. Version 1.15 Released April 5, 1997. Major corrections to this release are: The message display routines have been speeded up considerably. As a result of this, the restriction which prevented text attachments from being "shown" in the message window if they exceeded 5000 characters has been lifted. Further increases in message display speed will be implemented in future releases. Foreign character sets requiring 8-bit display are now correctly shown and sent provided your provider can handle 8-bit encoding. Other encoding methods, such as "quoted-printable" on output, are not handled as yet. They will be handled in a future version. When messages are marked for deletion, the on-disk configuration file is NOT updated. This greatly speeds up the deletion marking process. The downside of this is that, if the system crashes or your system is turned off before AEMail terminates, these messages will not be deleted or remain marked for deletion when AEMail is re-loaded. Daylight Saving Time was only being calculated correctly for the United States. The United Kngdom and Europe use "Summer Time" which starts one week before DST in the United States (last Sunday in March rather than the first Sunday in April). This has been corrected. By using a special AEMail tz environmental variable you can now specify time zone increments in half hours and with names longer than 3 characters (up to 9 characters for both Standard Time and Daylight Savings/Summer Time). In versions prior to 1.15, whenever you sent your first email (and, as a result, sent the registration message), the ABOUT window would indicate you were "** REGISTERED **. This is no longer true. The "** REGISTERED **" designation will only occur when your shareware fee is acknowledged. The Installation script has been modified so that it no longer copies the sys:rexxc directory to C:. Instead, an assign statement has been added which adds the assignment of SYS:REXXC to C:. Version 1.14 Released March 20, 1997. Minor correction release. Fixed Installation script (Install_AEMail). It would not properly install AEMail if AEMail had not been installed previously. Insured that the Mail directory and the Mailcap directories ended with either ':' or '/'. If the definitions did not, an '/' was appended to the path definitions. Corrected a problem where the Mailcap directory was being used instead of the Mail directory hor the .header file (this was not apparent in the Mail directory and the Mailcap directory were the same). Corrected a problem where the .header file was being read before the configuration file. This again probably would not have been an apparent problem. Corrected a problem with the "Remove DELETED Msgs" menu item in which selecting [CANCEL] would go ahead and delete the messages anyway. [CANCEL] will now exit without deleting any messages. Corrected a problem when AEMail was called from the shell. The "config=" parameter was not working properly. It now works correctly. Version 1.13 Released March 10, 1997. AEMail now allows for multiple configuration files. The "Project/Configuration" menu item now has five sub-items: "Open", "Edit", "Save", "Save As" and "Restore Default" The old "Save Settings" and "Restore Settings" menu items have been removed. A "Save As" button has been added to the Configuration screen. To accomodate multiple configurations, the "Mail Directory" has been removed from the "Paths" Configuration page. It is still available as a Tool Type, however. A CONFIG= Tool Type has been added to allow AEMail to start up with a specified configuration file. Miami Start Net and Stop Net scripts have been provided. A special CygnusEd script has been provided to properly use CygnusEd (CED) as your editor. If a message file is missing, AEMail no longer terminates if you try to access that file. A busy pointer has been added to a number of processes. When AEMail terminates and you don't want to check for mail, AEMail no longer attempts to access your POP server. This can result in a requester, however, that states you are online, even when you are not. Duplicate hot key menu calls have been eliminated. The Install script has been modified to provide for the added configuration items. "text/*" and "message/*" have been added to the mailcap file using MultiView (3.x users only). This allows you to view long text attachments that are not "SHOWN" (see Version 1.12 enhancement). Other minor corrections have been made. Version 1.12 Released February 15, 1997. This version was a special version without updated documentation or install script. It was not uploaded to AmiNet. It featured the following corrections and enhancements: The configuration screens have been totally revamped. Some new items have been added and others re-named or moved to other configuration 'pages'. The heading for the "Required" screen has been changed to "Identity" to more clearly indicate its purpose and the buttons to call the various configuration 'pages' have been moved to the top of the screen. When you select a configuration page, the button for that page will "light" up and stay "lit" while you are on that page. A From: (your email address), Reply To: and Organization item has been added to the "Identity" page. New Tool Types have also been added to correspond to these items. The "Mail Directory:" item has been moved to the "PATHS" page and "Edit Call:" to the "GENERAL" parameter page. The TCP Logging File process has been changed to provide additional menu control over the logging file. A new menu sub-group called "TCP Logging File" has been added under the "TCP/IP" menu group. This sub-group has three menu sub-items called "Active", "Purge", and "Display/Edit...". A new checkmarked item is added under the "TCP Logging File:" item in the PATHS page of the configuration screen called "TCP Logging active on AEMail startup". Under the Folders menu group, an item called "Remove DELETED Msgs" has been added. This will IMMEDIATELY delete ALL messages marked for deletion in the current active folder. A new menu item has been added under the "Messages" menu group called "Edit...". When you reply to a message, the compose message routine will first try to send the reply to any "Reply-To:" address that was in the message you are replying to. If the "Reply-To" header was not present, it will then send the reply to the "From:" header address. The same applies to transferring addresses to the address book. If you want to transfer the address from a message you are reading (by clicking on the address book icon), it will first try to transfer the address in the "Reply-To: header. If that is not present, it will use the "From:" header address. YOU CAN FORCE it to use the "From:" header address by pressing the SHIFT key when you click on the Address Book. There was a limitation (or bug) in the address book routine which limited the number of addresses you could store in a group to 255. This limitation has been lifted. You can now store up to 32,000 addresses in a group. The address book screen has been modified to include a check mark item for group addresses to send only the group header in any message sent to a group rather than the email addresses of each member of the group. When sending a message to a group, the messages will be sent in groups of 50. This is to allow for limitations in some SMTP servers that will not allow a message to be sent to more then a difinitive number of recipients. Most SMTP servers should be able to handle 50 recipients at a time. A busy pointer is now being displayed while a message is being read into the viewer. You can not scroll the message display while this busy indicator is being displayed. Attachments that are text attachments are generally shown in the message window itself with "SHOWN" indicated for the attachment in the Attachment requester. The behaviour of AEMail has been changed for messages with attachments exceeding 5000 bytes. Now, with such messages, the text attachment will not be shown, but you would be able to save it with the attachment requester. The buttons to call up file requesters have been changed from "DIR" to "REQ". Other minor corrections have been made including the recognition of additional UUencoding formats. Version 1.11 Released October 14, 1996. This version corrects some minor bugs as follows: Corrected the installation script which incorrectly identified the "Amitcp:bin" directory. Corrected bug that did not allow files in the file requester for the "stopnet" script in the Configuration screen. Implemented the 9 character NickName for the address book that was suppose to be implemented in Version 1.10. Made minor revisions in the printout formats for message lists and the address book. Corrected the display of dates in the mm/dd/yy format when the year was beyond 2000. Version 1.10 Released September 29, 1996. The following bugs have been corrected (includes bugs corrected with Versions 1.04 a, b, and c.): Corrected bug caused by multiple line SMTP responses. This would result in a "hang" when trying to send messages. Prevents a GURU (8000005 - Divide-By-Zero error) from occuring when AEMail was unable to determine the size of a message that was being retrieved from the POP Server. Corrected a bug in which not enough memory was being allocated for error message requester displays. This caused a GURU after the error message was displayed. When a group address book entry had an actual UserID rather than a Nickname for one of it's addresses, the entire group was not sent. A guru or freeze occurred when reading certain messages. These messages had an incomplete Content-Type: header. Some requester windows had overlapping fields when a large Screen Text font was used. If you tried to change your .signature file after you composed a message, you could not save your .signature file (the .signature file was left open). If you composed a message without an ending Carriage Return and you added attachments, the attachments were not correctly recognized. AEMail now forces a Carriage Return before attachments are added to the file. Headers were not being printed when you printed a message. Did not properly decode quoted-printable Content-Transfer- Encoding. Times from 12 noon to 1 PM and from 12 midnight to 1 AM were incorrectly displayed. Changed from 0:xx PM to 12:xx PM and from 0:xx AM to 12:xx AM. Changed install script so that it does not require AmiTCP: assign or TermiteTCP environmental variable at the Novice level. If the AmiTCP: assign is not present, AEMail will be installed in a AEMAIL directory on your largest disk partition. Also corrected some problems with install script. Did not save default "Save Attachment Path" in AEMail.cnfg file. Version 1.04c Limited release on September 11, 1996. Corrected bug caused by multiple line SMTP responses. Version 1.04b Limited release on September 4, 1996. Corrected divide-by-zero error with progress indicator. Version 1.04a Limited release on September 2, 1996. Added the time zone capability and corrected a number of bugs. Version 1.03 Released August 28, 1996 Corrects bug in which clicking on a folder after the folder strip was slid to the side selected the wrong folder. This occurred when more folders were present than could fit on the display. The correction of this bug was considered important enough to immediately release this version. Corrected a bug when messages that were not read were transferred to another folder. The number of unread messages on the folder strip was incorrect. Also, if you delete a message that was unread, it will reduce the unread count for that folder (the total message count still includes messages marked for deletion). If you undelete a message that was never read, the unread count will increase. Version 1.02 Released August 25, 1996 Major bug found and corrected! When sending email there was a problem with parsing the email addresses of the recipients of the message which could cause the system to freeze or guru. Made minor changes to accomodate TCP/IP stacks other than AmiTCP, but which are compatable with AmiTCP. Tested with TermiteTCP and Miami. Added arguments when invoking AEMail from the shell. This was to allow AEMail to be used as a "mailto" agent with several Amiga web browsers. Tested with Voyager and AWeb. Consult AmigaGuide (MultiView) document for how to implement this feature. Set default editor to C:ed. Made changes to install script to create an easier installation. Corrected bug when Text Attachments had lines longer than 100 characters. Changed Start Net and Stop Net menu items to provide for starting and stopping the network connection when your TCP/IP does not provide an automatic way to start or stop the Internet connection (signing onto your provider). See the AmigaGuide (MultiView) document on the TCP/IP parameters of the Configuration screen on how this function works. (some of the above changes were in the 1.01 release) Version 1.01 Released August 5, 1996 Limited release incorporating some changes for TermiteTCP. Version 1.0 Released July 24, 1996. First BETA release. This is the first public version of AEMAIL released at the Sacramento Amiga Computer Club meeting. The release includes the complete AEMAIL package including an installation script and documentation in AmigaGuide (MultiView) format. Version 0.06 Released July 8, 1996. Last ALPHA release. Implemented expanded configuration windows. Added feature in which AEMAIL periodically checks for mail on your POP Server. Added the "Iconify AEMAIL" feature and the menu item that supports it. Version 0.05 Released June 18, 1996 Added UUENCODED attachment support. Added "Change Password" capability to main "Configure" window. Added requirement that minimum configuration data be entered prior to starting AEMAIL. Added QUEUED message check at program startup and when StartNet script is executed. Added POP message and QUEUED message check at program termination. Version 0.04 Released June 2, 1996 Added the "About" menu item. Added the delete folder menu item. Implemented the printing of messages with your preferences printer. Added "Progress" Windows to both the Send Message and Receive message processes. AEMAIL now automatically recognizes whether it is connected to your Internet provider on program startup. A Tool Type was added (AUTOCONNECT=YES) which automatically executes the StartNet script at program startup. Added check to automatically to see if any messages are currently available on your POP server at program startup or when the StartNet script is executed. Version 0.03 Released on May 21, 1996 Added the "Startnet" and "Stopnet" menu items under a new "AmiTCP" menu and added the Tool Types to specify the calls for the STARTNET and STOPNET scripts. Added the Configuration screen activated by the "Configuration" menu item under the PROJECT menu. Version 0.02 Released on April 20, 1996. Added MIME support for attachments. Version 0.01 Released on March 20, 1996. First ALPHA version. This initial version could handle sending and retrieving text messages only; no attachment capability was present. Certain features were not yet available and configuration was by Tool Types only.