AntMail v.0.7.3 What is Antmail? It is a mail client for retrieving mail messages from a POP mail server. It also allows you to manage these messages and create and send new messages, as well as import mail from an external mail drop. Antmail is FREEWARE, however donations are willingly accepted, adresses of people providing donation support in different areas of the world are located in 'SUPPORT.TXT'. Also anyone who contributes the suggested amount will switch over to being registered whenever Antmail becomes Shareware. And it will of course encourage me to do even more work to Antmail. Alot of work has been done on Antmail up to this point but there are still a few bugs here and there. Alot more still needs to be done to it, but I think it has reached a point where it is of use to most users. Antmail has been tested by a large number of ruthless, cruel and sadastic people that I have been lucky to call my beta testers. It's been put through it's paces on almost all the major AES's (TOS's 1.0 - 4.4, Magic, Geneva(NeoDesk), MultiTOS, XaAES) and various memory configurations. It's not perfect on every configuration yet, but it's getting there. So for the countless users who will never have to experience some of the old GUI glitches under the replacements AES's, I want to thank my beta testers again. Contents of ZIP ANT_MAIL/ ANT_MAIL.PRG - The program. ANT_MAIL.RSC - New resource. ANTMAIL.TXT - This pitiful doc file. HISTORY.TXT - Brief account of the lives of Antmail Beta's SUPPORT.TXT - Info on how to support Antmail and addresses of people providing support. --------------------- Docs for Antmail. Installing Antmail: Place Ant_mail.prg and ant_mail.rsc in the same folder. This could be anywhere. However I would suggest giving it a seperate folder. One copy of Ant_mail can function for multiple people or for multiple sites. Between my wife and I, we have 3 different mail accounts that we manage from the same copy of Ant_mail. The way antmail, knows what it's supposed to do, is through it's settings files (ie. DEFAULT.SET). Before you can use antmail, you will need to edit your settings. More information on what all the items in the settings can be found below. Once you have finished editing all your settings, choose save settings from the menu. Give you settings a name, that will associate it with whoever's account it is, or the site it's getting mail from. Or you can call it whatever you like, antmail doesn't care. Now if you are the sole or primary user of antmail, choose "Save preferences". This will tell antmail to load your settings when it boots. Creating a Mail folder. If you have multiple accounts or multiple people it is recommended to create a seperate folder for each account. This can be done through the menu item "Create New User Folder ..." under the menu title "Extras". This will bring up the fileselector (item selector), all you need to do is go to the path you want the folder created in and type in the folder name. Antmail will then create the necessary folders for it's operation. To use this folder, you then need to go into the "User Settings" dialog and select it as your mail folder. Managing multipe accounts: Create a settings file for each account. Save each in a way that will differentiate it from the others. Then when you want to get the mail from that account, select "load settings" from the menu. Then choose the .SET file that matches the account you want. Not saving your password: In some circumstances (work, dorm, etc), you may not want to leave you password laying around in a file on the machine for others prying eyes. In these circumstances when you edit your settings, select 'No' on the save password question. In the future when Antmail loads this settings file, it will prompt you for a password. Compatibility: Antmail is compatible with STiK or GLUESTIK for Networking. GLUESTIK is a small program that parses STIK calls into MiNT Net calls. GLUESTIK is the creation of Scott Bingham. It hasn't been released as of the moment, but it works well with Antmail. Antmail is compatible with the POP3 mail protocol for receiving mail and the SMTP protocol for Sending mail. Antmail will also import mail from external SMTP servers such as NOS or SENDMAIL (MintNet). Antmail is also Multitasking compatible. In a multitasking enviroment you can view, reply to, or create multiple messages at the same time. Mail Interaction. Items in the Mail menu: Check Mail - Logs in, checks for mail, if mail found lists mail, runs the listed mail dialog. This allows you to select individual messages for retrieval or deletion. 'Get all' button works like get mail below except skips relogin. I probably will never make this a non-modal dialog. Since leaving yourself logged into the mail server is a good way to get the sys admin mad at you. When you are in this dialog you can click on the box below 'RETR' to retrieve the message and/or 'DELE' to delete the message. You need not retrieve a message to delete it off the server and you need not delete a message just because you retrieve it. I use this myself to read work related mail but not delete it so that I can keep a copy at work. Get Mail - Logs in, checks for mail, if mail found gets messages, checks "leave mail on server" flag if it is not set to 'YES' it deletes all the messages. Send Mail - Starts a dialog. Enter name of person to send mail to, subject (optional), and select the message text with the select file to send button. This message can either be a standard text message or a previously uuencoded binary file. Transmitting binary files unencoded through mail does not work. Click on 'Send' to send mail. New Message - Uses external viewer defined under Program settings. Enter name of person to send mail to, subject (optional) the select edit to continue. When in the editor, it will open or create a file called "tmp.msg" (or "tmp.# in a multitasking system) in your mail folder. When you have finished editing your mail save it back to this name. Do not change the name or Antmail won't be able to find it. Send Queue Now: This sends all the messages in your OUTGOING mail folder. At the moment once an error is encountered in the mail transaction, no further transactions are possible. I'm working on this but time was getting short for getting the release out. After you leave your editor, Antmail will prompt you to choose 'Send', 'Queue' or 'Cancel'. 'Send' attempts to send your message immediately. 'Queue' will put the message into your 'OUTGOING' mail folder to be sent later. 'Cancel' aborts sending the mail, the message will still be stored as tmp.* until you create or view another message. If for some reason Antmail can't transfer the message. (like your provider just knocked you offline) Antmail will prompt you again for Send, Queue or Cancel. You can then either attempt to send it again or Queue it for later. If Antmail does connect and transfer the message, then it deletes the "tmp.msg". Notes: - Check mail only looks at the first 100 messages on you mail server. I only know of one person who keeps that much mail on the server. ;) - Always save your edited message you create to the name it was when you started it. If you don't save it or change it's name, Antmail will send it the way it was when you first saw it in the editor. - At the top of a New message you will see a "To:" line and a "Subject:" line. It is suggested that you leave these lines alone. You can edit them to change the address or subject however do not insert any extra lines or Antmail will get confused. - Antmail is limited to one recipient of a message at the moment. I will expand this later as well as including CC (carbon copy) and BCC (blind carbon copy). I know this is a pretty severe limitation to some, but you did want to get to use Antmail before June didn't you ;) - What's "mail to dan". This is a quick and easy way for you to send me bug reports or words of encouragement. I don't know if it will remain, but it is handy. When you click on this box, it will fill the 'Mail TO' line with my email address. ----------------------------------- Looking at mail in your IN.BOX: and what do all those buttons mean? You can either press 'F1' or select the menu item. This will open up a non modal dialog box displaying the first 10 messages in your IN.BOX. The UP and DOWN arrows will go through pages of 10 of your messages. The items in the inbox listing go in the order as follows: message status (right now this is the default off the server) RO means you have already read it once. message size in Kilobytes message subject message author message date - View will view a selected message - Reply will reply to a message - Forward will forward a message - Export will save a message out to a new file - Move will move a message to a different mail box (disabled now) - Delete will delete a message from a mailbox - Up arrow = previous page - Down arrow = next page Looking at mail in your OUT Queue: and what do all those buttons mean? You can either press 'F10' or select the menu item. This will open up a non modal dialog box displaying the first 10 messages in your OUTGOING mail folder. The UP and DOWN arrows will page between pages of ten. The items in the OUT Queue listing go in the order as follows: message size in Kilobytes message to: (The recipient of this message) message Subject message date - View will view a selected message - Export will save a message out to a new file - Move will move a message to a different mail box (disabled now) - Send Now will send the selected message immediately ignoring the rest of the Queue. - Delete will delete a message from the Queue - Up arrow = previous page - Down arrow = next page Non-Modal dialog box features: Clicking on the fuller button will cause it to window shade. ie. it will turn into only the title bar, which will also be reduced in size. Clicking on the fuller again returns the window to it's previous state. Settings what are they? A settings file contains all your personal data and preferences. Such as your username or your mail path. Each user or account should have their own settings file. This will save you a massive amount of editing every time you want to retrieve mail from an account. This also stores such things as your external viewer, so that multiple users can choose different editors. So what are the settings: User settings: Username: your username on the system you are getting mail from Password: your password on the mail server. Usually the same as your slip password. Might vary though. Save Password: Simply whether you want your password to be automatically loaded when you launch antmail. Yes: saves password. No: doesn't save password. You will be prompted for a password at program launch or settings being loaded. Email address: Your email address ex. me@mysite.com Your Real Name: Just that. Your real name. Reply-to: This is used if you want your return mail to be sent to a different address then the one you are mailing from. Uses for this could be to send work mail from home that you want to retrieve at work. ex. myaddress@here.com reply-to: myaddress@there.edu Set mail folder...: Use Fileselector to choose a folder for your mail to be kept in. Multiple users should not use the same mail folder. Use of the same mail folder by multiple users, will mean that they will have no way to diferentiate their mail. Set SIG file...: Use the file selector to choose a file to be used as your SIG file. You need not set a SIG file. Antmail doesn't care what your SIG file is but there are conventions on USENET for what a SIG file should consist of. If you don't care about conventions remember that this will be put on all your mail, so you will have to store it in Queue'd messages and send it whenever you send a piece of mail. Server settings: POP Server: The name of the server you want to get your mail from. SMTP Server: The name of the server through which you send your mail. This can be different from your POP server and need not be at your ISP at all. However you will want to find one that is near you on the net, or you will suffer from serious lags in all mail transactions. Leave Mail on Server: Yes: Doesn't delete mail in 'Get Mail' or 'Check Mail'-'Get All' No: Automatically deletes mail from server in above cases. Program settings: Use verbose listings in Check mail: Yes: Gets author info and size and subject line. No: Doesn't get any of this info. You only get the size. Warning Verbose listings can dramatically increase your online time. Select external editor: Use the fileselector to choose a text viewer/editor for use when creating and viewing Mail messages. Use Slow Disk I/O: Yes: slows down your through put, but may be necessary on some sytems. No: Has no slow downs, but may cause problems. (On my Falcon, I have had no problems that could be attributed to this) Other items in Config menu: Open Settings: Opens a settings file. Alows use of program by multiple users, or for users with multiple accounts. Save Settings: Saves a settings file to disk. You will want to do this once you have edited them all. Save preferences: This saves which settings file will be opened at program launch. Items in the Extras menu: Nicknames: Yes it's disabled. It's not working yet. Sorry. Create New User folder...: Useful for automatically creating a new set of folders. Very handy and suggested for people just setting up Antmail. Import NOS mail drop...: Use this to import messages from NOS (Oasis) select the *.EML file and Antmail will process all the messages into the IN.BOX. This can also be used with any system that stores all the messages completely without editing them. You can even use this with "sendmail" under MiNT, however you will have to import the messages one at a time. *NOTE* Antmail does not process these messages for the external application. If you do not delete these messages manually or through the external program they will imported again the next time you import the mail drop. ******************************** Problem Solving ******************************** Problem: I can't Queue any messages? Possible cause: Your Mailpath is not set correctly. This can be caused by some alternate Fileselectors like Freedom. Solution: Try setting your mailpath again in User Settings. With Freedom select the folder name and press Ok, under the normal fileselector go into the folder and don't select anything and press Ok. Problem: I need to edit a message in my Out Queue, but Antmail doesn't have a button there for edit. Solution: Just select View and when done editing save the file back out to the name it was when you opened it. Problem: I've edited my message, but when I try to save it asks if I should overwrite "TMP.MSG". Solution: Your editor is just asking if you want to replace the old TMP.MSG. You do. Just click on OK, or Save or Overwrite. Which ever your editor requires. Problem: I was trying to get my mail but it was real slow, so I pressed the "Esc" key. Then it gave me a problem alert. Solution: Don't press the "Esc" key. ;) Actually the "Esc" key is only useful if you don't mind aborting the currect action. Sometimes mail servers are extremely slow, if you press the "Esc" key you are canceling the action on your end. Unfortunately there is no easy way to do this for the server end. So the results can be nasty. If you are just in the "listing" of messages, you just won't get any more info on the rest of the messages. If however you are retrieving you will end up getting the messages wrong. You're only hope then is to hit "Esc" again and close out the connection to the server. However you will have to wait around 10 minutes before the server force logs you out so that you can relogin. Problem: I got my mail and I couldn't access the menu bar after I got the "Mail transactions complete" dialog. I pressed 'Esc' and got a TCP close message on the screen. But now I can't get back onto the server. Solution: The mail server never got you logged out. You need to wait 10 minutes for it to force log you out, before you can get back into it. However if you are done with your operations and don't want to wait you can force close the connection with 'Esc'. Problem: I can't send any mail. It always tells me "Server not receiving". Solution: Check with your ISP (provider). It's possible that your mail server is not at the address you have set in Antmail. If this fails and your ISP uses a version of POP for sending mail, then just grab another nearby SMTP server. This may take some asking, but it's possible. /********************************/ Well let me know what gives you problems. Also if you have anything you think is a priority to get done let me know. You have a nice button in 'New Message' (Send mail to Dan) so use it. Dan Ackerman baldrick@terminator.rs.itd.umich.edu ackerman.29@osu.edu